This section explains how to collect the data required to diagnose a problem's cause.
Collection Methods
The initial troubleshooting data can be collected using the following methods.
Based on each collection method's characteristics, chose the appropriate one according to the environment and system state for which the problem occurred.
Collecting data from the Admin Server
This method involves executing a troubleshooting data collection command (rcxadm mgrctl snap -all) on the Admin Server.
This method allows data from each managed server to be collected all at once via the network. This is easier than executing a command individually on each managed server.
Refer to "Collecting Data from the Admin Server (rcxadm mgrctl snap -all)" to collect the data.
Executing the rcxadm mgrctl snap -all command requires approximately the free space determined by the following formula:
number of registered servers * 30 MB + 65 MB
Collecting data separately from each server
This method involves executing a data collection command (rcxadm mgrctl snap or rcxadm agtctl snap) on each server.
Refer to "Collecting Data separately from each Server (rcxadm mgrctl snap, rcxadm agtctl snap)" to collect the data.
About 65 MB of free space is required to execute the rcxadm mgrctl snap command, and about 30 MB of free space is required to execute the rcxadm agtctl snap command.
Collecting HBA address rename setup service environment data
This method involves collecting data that is required for identifying the cause of a problem that occurs on the HBA address rename setup service.
Refer to "Collecting HBA Address Rename Setup Service Environment Data" to collect the data.
About 8 MB of free space is required to collect troubleshooting data for the HBA address rename server.
Note
[VMware]
For VMware ESX4, please also collect and send the following data to Fujitsu technical staff.
Use the copy command to collect and send the following files.
/var/log/vmware/hostd.log
/var/log/vmware/hostd-*.log
/var/log/vmware/hostd-*.log.gz
Collect and send the result (output) of the following command.
/usr/sbin/esxcfg-firewall -q
Collecting Data from the Admin Server (rcxadm mgrctl snap -all)
Troubleshooting data from every managed server can be collected all at once by executing the command for collecting troubleshooting data, rcxadm mgrctl snap -all, on an Admin Server.
The following method is used to collect data with the data collection command, rcxadm mgrctl snap -all.
Collection Method
Perform the following procedure on the Admin Server to collect investigation data:
Log on to the Admin Server with OS administrative privileges.
OS administrative privileges are required to collect troubleshooting data.
Execute the rcxadm mgrctl snap command with the -all option specified.
>"Installation_Folder\Manager\bin\rcxadm" mgrctl snap [-dir dir] -all <RETURN> |
Send the collected troubleshooting data to Fujitsu technical staff.
Note
The Manager must be running on the Admin Server in order to collect data from the Admin Server. If the Manager cannot run, collect data from each server.
When collecting data via the Admin Server, data cannot be collected from a managed server in the following cases.
Communication cannot be established with that server
The server is stopped
Even in such cases, however, data will continue to be collected from other managed servers.
Use the command execution logs to check the execution results.
Refer to "5.6 rcxadm mgrctl" of the "ServerView Resource Coordinator VE Command Reference" for details.
For managed servers where data collection has failed, collect data by either executing the rcxadm mgrctl snap -all command on the Admin Server again, or by executing the rcxadm agtctl snap command on the managed server where data collection failed.
Collecting Data separately from each Server (rcxadm mgrctl snap, rcxadm agtctl snap)
In addition to the rcxadm mgrctl snap -all command, which can collect troubleshooting data from all the managed servers at once, the commands rcxadm mgrctl snap and rcxadm agtctl snap are also provided. These collect data from only the server on which they are executed.
Use the following procedure to collect data with the rcxadm mgrctl snap command or the rcxadm agtctl snap command.
Collection Method
Perform the following procedure on the server from which data is to be collected:
Log on to the server with OS administrative privileges.
OS administrative privileges are required to collect troubleshooting data.
Execute the rcxadm mgrctl snap command or the rcxadm agtctl snap command.
Note that the command differs depending on the server from which data is collected.
Admin Servers
>"Installation_folder\Manager\bin\rcxadm" mgrctl snap [-dir dir] <RETURN> |
Managed servers
[Windows]
>"Installation_folder\Agent\bin\rcxadm" agtctl snap [-dir dir] <RETURN> |
[Linux/VMware]
# /opt/FJSVrcxat/bin/rcxadm agtctl snap [-dir dir] <RETURN> |
Send the collected information to Fujitsu technical staff.
Refer to "5.1 rcxadm agtctl" and "5.6 rcxadm mgrctl" of the "ServerView Resource Coordinator VE Command Reference" for details.
Collecting HBA Address Rename Setup Service Environment Data
The following method is used to collect the troubleshooting data necessary to investigate problems that occur on an HBA address rename setup service.
Collection Method
Perform the following procedure on the HBA address rename setup server to collect troubleshooting data.
Collect data directly, using a tool such as Windows Explorer.
Collect the data under the following folder: installation_folder\WWN Recovery.
From the HBA address rename server, collect the log file installation_folder\WWN Recovery\rcxinstaller.log, and all files and folders under the following folder: installation_folder\WWN Recovery\var.
Take a screenshot of the window displayed when the problem occurred.
Perform the following operation on the server for HBA address rename setup service from which the data is to be collected in order to take a screenshot of the window:
Press the Print Screen key to copy image data onto the Clipboard, and then paste the image data into an image editing tool and save it as a bitmap file.
Obtain system version information.
From Windows explorer, right-click the "My Computer" icon, and from the popup menu select "Properties".
In the [System Properties] dialog click the "General" tab and use the procedure explained in step 2 to obtain information such as the OS type, version and level, and service pack number.
Send the collected information to Fujitsu technical staff.
