Product | Command Type |
---|---|
ClearCase | cleartool subcommand |
ClearCase LT | cleartool subcommand |
Attache | command |
Platform |
---|
UNIX |
Windows |
Specify the cache size for a single view:
Specify the cache size for a host:
Specify the site-wide view cache size:
ClearCase and Attache dynamic views-Specify MVFS cache sizes:
The setcache command sets view cache sizes. Although both dynamic and snapshot views use caches, cache size is more significant for a dynamic view than for a snapshot view.
The dynamic view caches consist mostly of data retrieved from the VOB and enable the view_server to respond faster to RPCs from client machines. When a view_server process is started, it chooses its cache size from the first of the following sources to yield a value:
The dynamic view's cache size, which is set with mkview -cachesize or setcache -view -cachesize and stored in the file view-storage-dir/.view (on the -cache line)
The view_server host's default cache size, which is set with setcache -view -host and stored as a decimal number in the file /var/adm/atria/config/view_cache_size (UNIX) or ccase-home-dir\var\config\view_cache_size (Windows)
The site-wide cache default, which is set with setcache -view -site or setsite and stored in the site config registry
The default value: 500 KB on 32-bit platforms, 1 MB on 64-bit platforms
NOTE: If your view uses the host value or the site-wide value and that value is changed, your view's cache size does not change until you invoke setcache -view -default or restart the view_server (with endview -server or a reboot).
The dynamic view cache size is allocated among the individual caches. When specifying a cache size, keep the following guidelines in mind:
The value cannot be smaller than 50 KB for 32-bit platforms or 100 KB for 64-bit platforms.
Do not specify a value larger than the amount of physical memory on the server host that you want to dedicate to this view.
Values greater than approximately 4 MB do not help much in most cases.
Verify your changes by using getcache to check the hit rates and utilization percentages periodically to see whether they have improved.
A host's MVFS caches are used to optimize file-system performance:
The directory name cache accelerates name translation. This cache is partitioned into three areas, each of which can be tuned with one of the setcache -mvfs options:
Directory files (-dirdnc)
Nondirectory files (-regdnc)
Names not found (ENOENT) (-noentdnc)
NOTE: If processes are actively using the directory name cache, you may see the following error message when trying to resize it:
cleartool: Error: Operation "view_mfs_set_cache_sizes" failed: Device busy.
Ask users to stop using ClearCase actively (that is, keep their view contexts, but stop manipulating files) and enter the setcache command again.
The attribute cache accelerates access to file metadata (for example, by the stat and access system calls, which are frequently called during make or clearmake operations). The -vobfree option sets the size of the attribute cache for VOB and view-private files that are not currently open.
The cleartext cache accelerates the open system call for files in a VOB and view-private files. The -cvpfree option sets the size of this cache. This cache is never larger than the size of the attribute cache.
The RPC handles cache accelerates RPCs to the dynamic view. The -rpchandles option sets the size of this cache; the value ought to be the maximum simultaneous number of RPCs expected from your host. If this value is too small, the getcache -mvfs command recommends that you adjust its size.
Values set with setcache -mvfs are reset when you reboot your machine. To change the values permanently, see the Administrator's Guide.
For more information on optimizing performance, see the chapters on performance tuning in the Administrator's Guide.
UNIX:
For setcache -view, you must be root on the view_server host or the view owner.
For setcache -view -host and setcache -mvfs, you must be root.
Windows:
For setcache -view, you must be the view owner.
For setcache -view -host, you must have create/delete/write permissions on the file ccase-home-dir\var\config\view_cache_size.
For setcache -mvfs, you must be local administrator or a member of the Administrators group.
For setcache -view -site, you must know the registry password
Mastership: (Replicated VOBs) No mastership restrictions.
SPECIFYING THE CACHE INFORMATION TO CHANGE. Default: None.
SETTING THE CACHE SIZE. Default: None.
SPECIFYING THE VIEW. Default: None.
SPECIFYING THE REGISTRY PASSWORD. Default: When you set the site-wide view cache size with -view -site, setcache prompts you for the registry password.
SPECIFYING MVFS PARAMETERS (NOT APPLICABLE TO SNAPSHOT VIEWS). Default: None. You must specify at least one option. cnt must be an integer value; see the Administrator's Guide for information on default and suggested values and instructions on setting the values permanently.
The UNIX examples in this section are written for use in csh. If you use another shell, you may need to use different quoting and escaping conventions.
The Windows examples that include wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.
In cleartool single-command mode, cmd-context represents the UNIX shell or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.
Change the cache size for view smg_test.
cmd-context setcache -view -cachesize 800k smg_test
The new view server cache limits are:
Lookup cache: 78624 bytes
Readdir cache: 327680 bytes
File stats cache: 137592 bytes
Object cache: 275184 bytes
Total cache size: 819200 bytes
Set the site-wide cache size.
cmd-context setcache -view -site -cachesize 2m
Registry password: <enter registry password><ENTER>
...
Set the number of RPC handles cached by the MVFS to 10 (dynamic views).
cmd-context setcache -mvfs -rpchandles 10
getcache, mvfscache, setsite, Administrator's Guide
Feedback on the documentation in this site? We welcome any comments!
Copyright © 2001 by Rational Software Corporation. All rights reserved. |