servercacheoption
View or set dynamic branch caching options to control the size of the Surround SCM Server cache, which can help reduce memory or performance issues.
Mainline branches are always cached when the Surround SCM Server starts. By default, baseline, snapshot, and workspace branches are set to Cache on Demand, which means they are cached when users perform actions that access a branch. When the Surround SCM Server starts, the most recently used Cache on Demand, or dynamic, branches as of the last server shutdown are cached. If these branch types are changed to Always Cache, they are always loaded when the server starts.
As additional branches are created, the cache may become too large, which can cause memory issues and slow server startup times. If this happens, you can adjust the caching server options to reduce the number of cached dynamic branches and set inactivity timeout limits for unloading inactive dynamic branches or changing inactive branches to Cache on Demand.
sscm servercacheoption [-rNumberOfBranches] [-tNumberOfMinutes] [-mNumberOfBranches] [-fNumberOfDays|-f-] [-h] [-y[Username:Password|+|=]] [-zSCMServerAddr:PortNum|zPath] [+u]
Option | Description |
---|---|
-f | Force 'Cache On Demand' attribute if inactive for specified number of days. Use -f- to disable this feature. |
-h | Display online help for the command. |
-m | Maximum number of branches to keep in cache. |
-r | Minimum number of most recently used branches to keep in cache. |
-t | Number of minutes an inactive branch remains in cache. |
-y | Enter a Surround SCM username and password if you do not want to use the default value. To use single sign-on, enter -y+. If you use an identity provider to authenticate, the provider web page opens if you have not yet authenticated. Authenticate with the provider and then return to the CLI. |
-z | Enter the Surround SCM Server host computer address and port number if you do not want to use the default value. IPv6 addresses must be in square brackets. If you received a server settings file from your Surround SCM administrator, enter the path to the XML file instead of entering the server connection information. |
+u | Display output in Unicode (Windows only). Output cannot be sent to a file. If output is enabled for all commands, enter +u- to disable it for this command. |