NAME
stgxfwcmsetdev - collects and reflects the device information
SYNOPSIS
<program-directory>\bin\stgxfwcmsetdev -n Server-Name [-d Device-Name] [-f File-Name | -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. It is necessary to execute this command on the Management Server.
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
OPTIONS
Specify the server name whose device information is to be collected or reflected.
Specify a server name displayed by stgxfwcmdispsrv (Server information display 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:
C:\>C:\ETERNUS_SF\ACM\bin\stgxfwcmsetdev -n Server1 >Device detected 1:g1d38p1 (X:) 2:g1d38p2 3:g1d38p3 >Specify the device to be added. [* or ?-? or ?,? or q] *1,3 >Device not detected 1:g1d39p1 (Y:) 2:g1d39p2 >Specify a device requested to be deleted. [* or ?-? or ?,? or q] * >The information of the following device will be changed. Information to be changed: 1:g1d40p1 >Do you want to continue the processing? [y or n] y stgxfwcmsetdev completed C:\>
The information for a specific device managed by the server is collected or reflected:
C:\>C:\ETERNUS_SF\ACM\bin\stgxfwcmsetdev -n Server1 -d g1d38p1 > The following device information has been changed. This information is updated. 1:g1d38p1 (X:) > Do you want to continue the processing? [y or n] y stgxfwcmsetdev completed C:\>
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 a local account belonging to the Administrator's group or by a domain account belonging to the Domain Admins group of the domain.
Please perform the command in the location specified at the time of product installation.
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 will be 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.
When backup synchronous processing or synchronous replication processing is being performed, device information may not be acquired accurately. Therefore, if you need to acquire device information, only perform this command after all synchronous processing has been cancelled
This command cannot be executed while the following commands are being executed:
This command cannot be executed by using the Web Console when the following operations are being performed:
Addition of a new server
Change of a server
Deletion of a server
Acquisition and Reflection of Information on All Devices
Acquisition and Reflection of Information on a Specific Device
Deletion of device information
