chclusterconfig

Modifies the cluster settings.

Read syntax diagramSkip visual syntax diagram
>>-chclusterconfig--+--------+--+---------+--------------------->
                    +- -?----+  '- -quiet-'
                    +- -h----+
                    '- -help-'

>--+-------------------------+--+------------------+------------>
   '- -spacereclaim--minutes-'  '- -mstrbuff--size-'

>--+-----------------+--+-------------------+------------------->
   '- -subbuff--size-'  '- -admproc--number-'

>--+----------------------+--+--------------------+------------->
   '- -serverproc--number-'  '- -privclient--list-'

>--+---------------------+--+-------------+--------------------><
   '- -rsauser--rsa_user-'  '- -rsapasswd-'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–quiet
Turns off confirmation messages for this command.
–spacereclaim minutes
Specifies the storage pool-space-reclamation interval, in minutes. You can specify a value from 0 to 1 440. The default is 60. A value of 0 disables storage pool-space reclamation.
–mstrbuff size
Specifies the size, in 4-KB pages, of the master metadata server buffer. You can specify a value from 2 048 and 8 192. The default is 2 048.
Note: The buffer size can only be increased; it cannot be decreased.
–subbuff size
Specifies the size, in 4-KB pages, of the subordinate metadata server buffer. You can specify a value from 30 000 and 250 000. The default is 200 000.
Restriction: The buffer size can only be increased; it cannot be decreased.
–admproc number
Specifies the maximum limit for administrative processes, including the number of metadata server commands (from the administrative CLI or SAN File System console), that can run simultaneously. This limit is independent of the server workload process limit. A few commands, such as those that change the state of the cluster, can run on a temporary process even if the limit is currently exceeded. You can specify a value from 4 to 10. If not specified, the default value is 4.
Restriction: This limit can only be increased; it cannot be decreased.
–serverproc number
Specifies the maximum limit for the metadata server workload process, which involves only metadata server workload operations. You can specify a value from 10 to 50. The default value is 20.
Restriction: This limit can only be increased; it cannot be decreased.
–privclient list
Specifies a list of clients, separated by commas, that are to have root-level privileges (for example, –privclient saki,mefi,leki). The current list is replaced with the new list of clients. You can specify from zero to 30 clients; each client name can be up to 256 characters in length and is case-sensitive.
Restriction: This new list replaces the entire list of current privileged clients. If there are clients that have root or administrative privileges and you want to add one more client, you must specify both the current and new clients in the new list.

To remove all clients with root or administrative privileges, specify –privclient ""; however, at least one privileged client is required to create files and directories under the root directory of filesets.

This command does not verify that the specified client names are valid because the metadata server does not keep static information about the clients. It does not keep a list of allowed or possible clients. It has only a list of clients that it allows privileged access if they present themselves. This command lists the clients that are currently accessing data.

–rsauser rsa_user
Specifies the Remote Service Adapter (RSA) user ID that is used to access information from the engines. The RSA user ID and password must be the same for all engines that host the cluster of metadata servers. Also, the values must match those in the RSA system.
Attention: Verify that the user ID is set to the correct ID. If you set an incorrect RSA user ID, all RSA features (including all engine commands) become unusable.
–rsapasswd
Specifies the password corresponding to the RSA user ID. You will be prompted to enter the password and then confirm it.
Attention: Verify that the password is set to the correct password. If you set an incorrect RSA password, all RSA features (including all engine commands) become unusable.

Prerequisites

You must have Administrator privileges to use the command.

You must be logged in to the operating system on the engine that hosts the master metadata server to run this command.

Description

You might have to restart the cluster for changes to take effect.

Restriction: If you modify any disruptive settings using this command or the chadvclusterconfig command, you cannot modify any cluster settings until you restart the cluster.

Example

Changes the cluster settings The following example changes the subordinate metadata server buffer size to 250000 and changes RSA password for the cluster:
sfscli> chclusterconfig -subbuff 250000 -rsapasswd
Are you sure you want to change cluster configuration settings? [y/n] Y
Enter new RSA password:
Confirm new RSA password:
The cluster was modified successfully.

Parent topic: Administrative commands

Related reference
chadvclusterconfig
quiescecluster
resumecluster
startcluster
statcluster
stopcluster
upgradecluster

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.