ca_config(8) CLIX ca_config(8)
NAME
ca_config - Activates and configures the Cache File System (CAFS)
SYNOPSIS
/bin/ca_config -f config_file | -p partition [-cijm?] [-r] [-F FORCE]
[-d num] [-h num] [-l filename] [-n num] [-q num] [-s num] [-w num]
[-y num]
FLAGS
-c Parses the specified configuration file for syntax errors. This
flag must be used with the -f flag, which specifies the
configuration file to be checked. The cache file system is not
activated when this flag is used.
-d num Indicates the number of daemons to create. The default number is
5. The minimum number of daemons is 3. The configuration file
keyword for this flag is DAEMONS, which takes a numeric value.
-f config_file
Specifies the configuration file. The default file location is
/etc/ca_config_file.
-F FORCE
Forces an initialization of CAFS, even if CAFS has modified data in
the cache partitions. The -F FORCE flag should only be used when
the modified data in the cache partitions is not needed. There is
no recovery from the use of the -F FORCE option. Under normal
situations INIT=yes will reinitialize the cache. If there is
modified data in the cache, INIT=yes will fail to prevent the user
from accidentally destroying the modified data. The -F FORCE flag
forces CAFS to ignore the fact that there is modified data within
the cache. After you issue the -F FORCE option, there is a warning
message that is displayed and requires a YES or NO response. The
YES response must be keyed in upper-case letters and not lower-case
letters, and anything other then YES will abort the ca_config
utility.
-i Initializes the cache partitions during ca_config. All cache data
from the previous session is lost. The configuration file keyword
for this flag is INIT, which takes a yes or no value.
-j Designates the use of the JBM jukebox software. This option is
necessary if jukeboxes are to be used under cache control. The
configuration file keyword for this flag is JUKEBOX, which takes a
yes or no value.
-l filename
Activates the cafslogger daemon, which will log CAFS messages to a
2/94 - Intergraph Corporation 1
ca_config(8) CLIX ca_config(8)
specified log file in addition to the console. If the log file is
not specified, the messages are placed in /dev/console and in the
/usr/ip32/cafs/cafs.log file. The configuration file keyword for
this flag is LOG_NAME, which takes a file location as a value.
-m Activates the quick mount flag of CAFS. By default, CAFS will
cache in the subordinate file systems root directory during the
mount. Since this may cause mounts to take a long time, the quick
mount -m flag will defer the process time until the first access of
the subordinate file systems. The -m flag provides slower first
access, but quicker mounting and faster availability of all
subordinate file systems. The configuration file keyword for this
flag is QUICK_MOUNT, which takes a yes or no value. The default
value is no.
-n num Indicates the maximum number of inodes to cache. The default
number is 16,384. The configuration file keyword for this flag is
MAX_INODES, which takes a numeric value.
-p partition
Indicates the partition or partitions to use. The configuration
file keyword for this flag is PARTITIONS, which takes a character
string special (for example, /dev/dsk/s3u0p7.3). If more than one
partition is specified in the configuration file, they may be
listed with one keyword or multiple keywords.
-q num Limits the number of queued requests that a volume may accept while
other requests are waiting for a volume that is not available. The
VOL_Q_LIMIT keyword is equal to a default 1,024. The VOL_Q_LIMIT
is the limit on the number of queued requests that can be placed on
a volume. These requests will be serviced before the volume is
swapped out of the drive to service another volume request. It is
used primarily for tuning the performance of the cache file system.
-r Attempts to recover transactions and files in the cache partitions
that are not yet written out to subordinate optical file systems.
The configuration file keyword for this flag is RECOVER, which
takes a yes or no value. If the value is set to no, no data may be
recovered from cache.
-s num Specifies the maximum number of subordinate file systems that CAFS
can mount. The default number is 124. If the default number is
greater than the number of mount points that the system is
configured for (NMOUNT), the default number will be reduced to
NMOUNT minus two. The configuration file keyword for this flag is
MAX_SUBFS, which takes a numeric value.
-h num Indicates the high water mark. The maximum high water mark number
is 100. The default number is 90, and the configuration file
keyword is HIGH_WATERMARK.
2 Intergraph Corporation - 2/94
ca_config(8) CLIX ca_config(8)
-w num Indicates a low water mark. The minimum low water mark number is
20. The default number is 70, and the configuration file keyword
is LOW_WATERMARK.
-y num Indicates the system ca_sync time in seconds. The default ca_sync
time is 5 minutes or 300 seconds. The configuration file keyword
for this flag is SYNC_TIME, which takes a numeric value in seconds.
-? Displays the available command-line flags.
DESCRIPTION
The ca_config command activates and configures the cache file system
(CAFS). Configuration parameters are passed to the kernel with option
flags and/or keywords within a configuration file.
If a configuration file is used, only the reserved keywords and comments
are allowed. Keywords are used in conjunction with a value. Configuration
parameters could be specified either in the configuration file or on the
command line. Command line options take precedence over configuration file
specifications.
Comments should always be prefixed with a pound sign (#). If during
parsing of the configuration file a pound sign is encountered, from the
pound sign to the end of line is considered a comment. Empty lines are
ignored.
A keyword in the configuration file may or may not be separated from its
associated value with an equal sign (=). A typical configuration might
look like the following example; note the different combinations that can
be used.
PARTITIONS = /dev/dsk/s3u0p7.3 /dev/dsk/s3u0p7.4
MAX_INODES= 20000
DAEMONS 10 # daemons default is 5
JUKEBOX = y
SYNC_TIME 1800 # sync time default is 300
# we have one more partition to add
PARTITIONS /dev/dsk/s3u0p7.5
VOL_Q_LIMIT = 50
HIGH_WATERMARK = 85
LOW_WATERMARK = 40
LOG_NAME = /usr/ip32/cafs/error.log
RECOVER = yes
QUICK_MOUNT = yes
MAX_SUBFS = 200
EXAMPLES
1. To check the configuration file, key in the following ca_config
2/94 - Intergraph Corporation 3
ca_config(8) CLIX ca_config(8)
command:
ca_config -c -f my_config_file
2. To activate the cache file system with the use of a configuration
file, key in the following ca_config command:
ca_config -f my_config_file
3. To activate the cache file system with the use of a configuration
file, and invoke high and low water marks, recovery, quick mount, and
logger flags, key in the following ca_config command:
ca_config -f /etc/config_file -r -m -l file_name -h 95 -w 75
4. To add an additional partition and to change the daemon value to 6,
key in the following ca_config command:
ca_config -p /dev/dsk/s2u0p7.3 -d 6
5. To activate the cache file system with a configuration file and a
partition, key in the following ca_config command:
ca_config -f my_config_file -p /dev/dsk/s2u0p7.3
6. To force the cache file system to be initialized and ignored, the fact
that there is modified data within the cache, key in the following
ca_config command:
ca_config -F FORCE -f /etc/ca_config_file
The warning message is displayed and the response must be keyed in
upper-case letters only. The following is the warning message:
WARNING!! You will lose ALL modified data in the cache partition!
Are you sure you want to ERASE your cache partition [YES/NO] ? YES
OR
WARNING!! You will lose ALL modified data in the cache partition!
Are you sure you want to ERASE your cache partition [YES/NO] ? NO
4 Intergraph Corporation - 2/94
ca_config(8) CLIX ca_config(8)
ca_config: FORCE Aborted.
FILES
/etc/ca_config_file
NOTES
The maximum high water mark number is 100, and the default number for the
high water mark is 90. The minimum low water mark number is 20, and the
default number for the low water mark is 70. The default ca_sync time is
5 minutes or 300 seconds. The default for the maximum number of
subordinate file system that CAFS can mount is 124. The default value for
daemons is 5, and the minimum number of daemons is 3. The default number
for the maximum number of inodes to cache is 16,384. The default number
for the limit on the number of queued requests that can be placed on a
volume is 1,024.
The ca_config command requires superuser privileges.
The ca_config command can only be executed once per boot of the system
unless the ca_deconfig command is issued.
If a partition is specified from the command line, the partition
information will be added to any partitions listed in the configuration
file. Other command line options will take precedence over configuration
file keywords.
The system administrator may use /etc/ca_size to calculate the minimum
cache disk space and memory needed for the cache file system.
DIAGNOSTICS
The following is a list of common error messages and their meanings:
ca_config: could not acquire jukebox information
An error occurred because ca_config could not communicate with the
Jukebox Manager (JBM) software.
ca_config: JUKEBOX and/or jbinterface is not running
An error occurred because JBM must first be up and running prior to
initializing CAFS.
ca_config: Keyword MY_WORD has an incorrect value.
An error occurred because the specified keyword has an incorrect
value associated with it.
2/94 - Intergraph Corporation 5
ca_config(8) CLIX ca_config(8)
ca_config: Error starting cafslogger daemon
An error occurred because cafslogger failed to start.
ca_config: Error, cafslogger is not running! CAFS Can Not Continue!
An error occurred because ca_config will not activate CAFS unless
cafslogger is running.
EXIT VALUES
The ca_config command exits with a value of 0 if successful. If
unsuccessful, it exits with a nonzero value.
RELATED INFORMATION
Commands: ca_deconfig(8), ca_stat(1), ca_size(1), ca_sync(1),
camountall(8), ca_mkconfig(8), ca_recover(8), ca_merge(8), ca_mnt_done(8),
cafsfsck(8)
6 Intergraph Corporation - 2/94