This section explains how to collect the data required to diagnose the causes of problems.
About 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 in 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 collection of data from all managed servers at once via the network. This is easier than executing a command individually on each managed server.
For how to collect the data, refer to "Collecting Data from the Admin Server (rcxadm mgrctl snap -all)".
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.
For how to collect the data, refer to "Collecting Data Separately from each Server (rcxadm mgrctl snap, rcxadm agtctl snap)".
Around 65 MB of free space is required to execute the rcxadm mgrctl snap command,
and around 35 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.
For how to collect the data, refer to "Collecting HBA Address Rename Setup Service Environment 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.
[Windows]
>"Installation_folder\Manager\bin\rcxadm" mgrctl snap [-dir dir] -all <RETURN> |
[Linux]
# /opt/FJSVrcvmr/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 be 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 the server
The managed server is stopped
In either case, however, data will continue to be collected from other managed servers.
Use the command execution logs to check the execution results.
Refer to "5.7 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 administrator 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
[Windows]
>"Installation_folder\Manager\bin\rcxadm" mgrctl snap [-dir dir] <RETURN> |
[Linux]
# /opt/FJSVrcvmr/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> |
[Solaris]
# /opt/FJSVrcvat/bin/rcxadm agtctl snap [-dir dir] <RETURN> |
Send the collected troubleshooting data to Fujitsu technical staff.
For details, refer to "5.1 rcxadm agtctl" or "5.7 rcxadm mgrctl" of the "ServerView Resource Coordinator VE Command Reference".
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 server to collect troubleshooting data.
Collect files from the HBA address rename server.
[Windows]
Collect the file Installation_folder\WWN Recovery\rcxinstaller. log, and all files and folders under the following folder: Installation_folder\WWN Recovery\var.
[Linux]
Collect the log file /var/tmp/rcxinstaller.log, and all files and folders under the following folder: /var/opt/FJSVrcvhb.
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.
[Windows]
From Windows explorer, right-click the "My Computer" icon, and select "Properties" from the popup menu.
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.
[Linux]
Execute and collect the results of the following commands.
# cat /etc/redhat-release <RETURN> |
# cat /proc/version <RETURN> |
# cat /proc/meminfo <RETURN> |
# cat /proc/cpuinfo <RETURN> |
# rpm -qa <RETURN> |
Send the collected troubleshooting data to Fujitsu technical staff.
