chwcachesource
Use the chwcachesource command to change the properties of a
home system on a fileset. The home system is the source of the data in a wide area network (WAN)
cache configuration. You can use WAN caching to distribute data transparently among data centers and
multiple remote locations without disruption to applications. You must have Administrator authority
to use this command.
You can modify the properties of the home system by adding or
removing cache systems. You can also update the public keys on all the cache systems for the
specified home
system.
Syntax
Parameters and arguments
- -user user_name
- Specifies an IBM Spectrum Control user ID.
- -pwd password
- Specifies the password for the IBM Spectrum Control user ID.
- -url url
- Specifies the Device server. The format of the URL is system:port_number, where system represents either the host name or IP address, and port_number represents the IBM Spectrum Control Device server port.
- -cachesource cache_source_id
- Specifies the ID of the home system that is created by the mkwcachesource command. Use the lswcachesource command to retrieve the cache source ID.
- -addclient client_definition
- Adds a cache system to the existing list of clients for a specified home system. The
client_definition variable contains a comma-separated list of the IP address and
access mode of the management nodes for the cache systems. Access mode can be either
ro (read-only) or rw (read/write). Only one of the cache clients
can have read/write permission at any time. You must enclose this parameter in single quotation
marks. Restriction: You cannot add a cache client with read/write access if there is an export with read/write access for the same path. For example, an export is enabled on protocol types like NFS, CIFS, or FTP.
- -removeclient client_cluster_id
- Removes a cache system from the existing list of clients for a specified home system. The
client_cluster_id variable is the cluster ID of the cache system. Use the
lswcachesource command with the -l option to find the
cluster ID of a specified cache system. Restriction: You cannot remove the last cache system for a specified cache home system.
- -updatekeys
- Updates the public keys of all the cache systems for the specified home systems.
- -fs character
- Specifies the 7-bit character that separates the information in the output. If you omit this parameter, the information is separated by blank spaces.
- -header
- Suppresses the column headings in the output. If you omit this parameter, the column headings are included.
- -help | -h | -?
- Lists help information for the command.
- -qs character
- Specifies the 7-bit character that surrounds character strings and date stamps in the output. If you omit this parameter, character strings and date stamps are enclosed by double quotation marks (").
- -silent
- Suppresses all output for the command. If you omit this parameter, output is included.
Example: Adding a cache system to a home system that is enabled for WAN caching
The following command adds a cache system to a home system on the home
cluster.
tpctool> chwcachesource -cachesource eesrc10+storage1.storage.tucson.
ibm.com+127.0.0.1+0 -addclient '127.0.0.2(ro)'The following output is returned:
CachesourceId Status
============================================================
eesrc10+storage1.storage.tucson.ibm.com+127.0.0.1+0 SUCCESS
Example: Removing a cache system from a home system that is enabled for WAN caching
The following command removes a cache system from a home system on the home
cluster.
tpctool> chwcachesource -cachesource eesrc10+storage1.storage.tucson.
ibm.com+127.0.0.1+0 -removeclient 792217928950257960The following output is returned:
CachesourceId Status
============================================================
eesrc10+storage1.storage.tucson.ibm.com+127.0.0.1+0 SUCCESS