The createcache utility allows you to register a new cache on a server.
createcache cache-id [option[...]]
Argument
|
Description
|
cache-id
|
Specifies a id of the cache to be registered on the server.
|
Option
|
Description
|
/s server-name
|
Specifies a server name where the NCache service is running. The default is the local machine.
|
/p port
|
Specifies the port if the server channel is not using the default port. The default TCP port is 8250.
|
/size cache-size
|
Specifies the size(MB) of the cache to be created. The default size is 250 MB
|
/evict-policy
/e eviction-policy
|
Specifies the eviction policy for cache items. Cached items will be
cleaned from the cache according to the specified policy if the cache
reaches its limit. The default eviction policy is Priority.
|
/ratio
/r eviction-ratio
|
Specifies the eviction ratio(Percentage) for cache items. Cached items will be
cleaned from the cache according to the specified ratio if the cache
reaches its limit. The default eviction ratio is 5%.
|
/interval
/i clean-interval
|
Specifies the time interval(seconds) after which cache eviction is called. The default interval is 15 seconds.
|
/topology
/t topology-name
|
Specifies the topology in case of clustered cache. The default topology is local-cache.
|
/cluster-port
/c port of cluster
|
Specifies the port of the server, at which server listens. The default port is 8250.
|
/def-priority
/d default-priority
|
Specifies the default priority in case of priority based eviction policy. The default priority is Normal.
|
/uid user-id
|
user-id is required when security is enabled on Cache Server. user-id must be the active directory user-id prefixed with the domain name.
|
/pwd password
|
Specifies password to authorize the user, when security is enabled on Cache Server, for starting NCache. This password must be the same as the active directory user password.
|
/nologo
|
Suppresses the display of logo banner.
|
/?
|
Displays command syntax and options for the utility.
|
Remarks
The system, where you use createcache utility, must have NCache service installed and running. By default, createcache utility tries to start the service if it is not running, but if it fails to do so, you must start the service manually. To start the service on a system, you must have access rights.
Examples
The following command creates a cache 'theCache' on the local machine.
createcache theCache
The following command creates a cache 'theCache' on a server 'theServer'.
createcache theCache /s theServer
The following command creates a cache 'theCache' on a server 'theServer' having following details, cache-size '250 MB', eviction-policy 'lru', eviction ratio '5%', clean-interval '30sec', topology 'mirror'.
createcache theCache /s theServer /size 250 /e lru /r 5 /i 30 /t mirror
The following command displays the command syntax and options for the utility. Logo banner is displayed as a part.
createcache /?
The following command displays the command syntax and options for the utility suppressing the display of the logo banner.
createcache /? /nologo
See Also