NAME
stgxfwcmsetdev - collects and reflects the device information
SYNOPSIS
/opt/FJSVswstf/bin/stgxfwcmsetdev -n serverName [-d deviceName] [-f fileName | -y]
DESCRIPTION
This command collects the latest device information detected by the server and displays the difference between this and the information managed by AdvancedCopy Manager. After this, it displays the specified device difference information in the management information for AdvancedCopy Manager.
The device information currently being managed and the device information detected are compared, stored, deleted, updated, and used in the following cases:
When operation is started using AdvancedCopy Manager
When device information being managed is changed
It is necessary to execute this command on the Management Server.
OPTIONS
Specify the server name whose device information is to be collected or reflected.
Specify a server name displayed by the stgxfwcmdispsrv command exactly as displayed, including the case.
Specify the device name whose information is to be collected or reflected.
If this specification is omitted, all devices on the specified server are assumed to be specified.
Use the absolute path to specify the file name to which the difference between the device information managed currently and the device information collected is output. Only the device difference information is output to the file, and the reflection processing for the subsequent management information is not executed.
This option cannot be specified with the -y option.
The difference between the device information managed by AdvancedCopy Manager and the latest device information detected is reflected unconditionally in the management information, without an inquiry being made about that difference.
This option cannot be specified with the -f option.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
The information for each device of a server is collected or reflected:
# /opt/FJSVswstf/bin/stgxfwcmsetdev -n Server1 >Device detected 1: /dev/rdsk/c1t0d0s6 (/aaa) 2: /dev/rdsk/c1t0d0s7 >Specify devices to be added. [* or ?-? or ?,? or q] >Device not detected 1: /dev/rdsk/c2t1d0s1 2: /dev/rdsk/c2t1d0s2 (/bbb) 3:/dev/rdsk/c3t0d0s7 >Specify a device requested to be deleted. [* or ?-? or ?,? or q] *1,3 >Information for the following device is changed. Information will be updated. 1:/dev/rdsk/c1t0d0s5 >Do you want to continue the processing? [y or n] y stgxfwcmsetdev completed #
The information for a specific device managed by the server is collected or reflected:
# /opt/FJSVswstf/bin/stgxfwcmsetdev -n Server1 -d /dev/rdsk/c4t0d10s0 > The following device information has been changed. This information is updated. 1:/dev/rdsk/c4t0d10s0 (/zzz) > Do you want to continue the processing? [y or n] y stgxfwcmsetdev completed #
NOTES
The following message is displayed if the number of devices is high:
- hit Enter for more or s to select - |
Press the 'Enter' key to continue to display more devices. To interrupt the display and specify either an addition or a deletion, press 's' key.
Use the following methods to request addition or deletion:
Enter "*" to specify all.
Enter numbers separated by a hyphen to specify a range. (Example: 1-3)
Enter numbers separated by a comma to specify separate numbers. (Example: 2, 4)
A combination of range and separate number specifications can be entered. (Example: 1-3, 5)
Enter no data to specify no devices to add or delete (only press Enter in this case).
Enter "q" to stop the processing.
This command can be executed only by root users.
Obtaining disk information for HP-UX servers with GPT disks using AdvancedCopy Manager is not possible.
When processing takes a long time, a period (.) is displayed until it is complete.
The following message may be displayed when a device requested to be added is specified. It is an indication of an attempt to register a device that is in the box and may have invalid settings. Make sure that this problem is fixed before continuing the processing (This message is also displayed when the -y option is specified.)
>The setting of license or the table size is not done, or the table size is insufficient, to the cabinet where the partition that makes up the following device exists. >Continue? [y or n] |
The following message may be displayed when a device has been requested to be added.
> The partitions that comprise the following device are already managed. > Do you want to continue the processing? [y or n] |
This message may be displayed in the following case.
Check the following before continuing the processing: whether the device is subject to duplicated registration. This message is also displayed when the -y option is specified.
In the case two or more logical servers running on the same physical server are managed on the clustered system operating environment.
In the case a device with the other name that indicates a physical disk in ETERNUS Disk storage system is reflected into the management information of AdvancedCopy Manager.
The amount of time required to process this command is proportional to the total number of devices defined on the specified server when the device information is collected. Therefore, when the number of devices is large, execute the command at a time of low CPU and I/O loads.
Note that it takes about 0.5 second for each device (partition) when there is no load on the system.
This command cannot be executed while the following commands are being executed:
This command cannot be executed by using Web Console when the following operations are being performed:
Register Server
Change Server Details
Delete Server
Add/Reload Device
Delete Device
