chserverconfig

Changes the IP address that SAN File System uses for the specified metadata server.

Read syntax diagramSkip visual syntax diagram
>>-chserverconfig--+------------+-- –ip --IP_address---------->
                   '- –quiet -'

>--server_name-------------------------------------------------><

Parameters

–quiet
Turns off confirmation messages for this command
–ip IP_address
Specifies a new IP address for the metadata server.
Attention: Verify that the IP address is correct. Setting an incorrect IP address might cause the metadata server to cease functioning.
server_name
Specifies the name of the metadata servers whose setting you want to modify. This metadata server must be part of the cluster.

Prerequisites

You must have Administrator privileges to use the command.

Description

Modifying the IP address requires that you reboot the metadata server before the changes are applied.

Tip: If you run this command from an engine hosting a subordinate metadata server, you can change configuration settings only for the local server. If you run this command from an engine running the master metadata server, you can change configuration settings for any metadata server.

This command does not modify the IP address on the engine. This command informs the SAN File System about which IP address to use in case of a dual-network interface. To modify the IP address or any other network setting on the engine, use the operating system commands.

Attention: If there is an incorrect LDAP setting defined on the metadata server, the administrative agent cannot authenticate access with the LDAP server, thereby rendering the system unusable. All administrative functions are denied, and the cause of the fault is listed in the cimom.log file. If an incorrect configuration renders the administrative agent unusable, you can reset the configuration using this procedure:
  1. Log in to the the operating system on engine hosting master metadata server.
  2. Stop the CIMOM using the stopCimom command.
  3. Edit the tank.properties file located in /usr/tank/admin/config and enter the appropriate overrides. Metadata server overrides are provided with the existing TANK_NORMAL_OPTS option in the tank.properties file. These take effect when the metadata server is restarted.

    NOTE TO REVIEW: What are the appropriate overrides for LDAP configuration?

  4. Restart the CIMOM using the startCimom command. If metadata server configurations were changed, stop and restart the metadata server using the stopserver and the startserver commands.
  5. Use the chserverconfig command to modify the settings.
    Tip: You will not see the effect of the change at this time because the administrative agent is working from the override settings. administrative agent sese the new settings when it is restarted. In addition, a log message is generated each time an overridden parameter is modified to remind you to remove the tank.properties override file.
  6. Remove the tank.properties override file and restart the CIMOM using the stopCimom and the startCimom commands.

Example

Change the metadata server settings The following example changes IP address for metadata server ST0:
#sfscli chserverconfig -ip 27.172.45.134 ST0
Are you sure you want to change the server configuration settings, which 
will require a server restart for changes to apply? [y/n] Y
Server configuration settings successfully modified.  Restart the server 
for all changes to apply.

Related reference
addserver
dropserver
lsautorestart
lsserver
setautorestart
setport
startautorestart
startserver
statserver
stopautorestart
stopserver

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