Alachisoft NCache 4.1 - Online Documentation

Create Cache

 
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
 
Copyright © 2005-2012 Alachisoft. All rights reserved.