FusionServer Tools V2R2 InfoCollect User Guide 22
FusionServer Tools V2R2 InfoCollect User Guide 22
FusionServer Tools V2R2 InfoCollect User Guide 22
V2R2
User Guide
Issue 22
Date 2017-09-30
and other Huawei trademarks are trademarks of Huawei Technologies Co., Ltd.
All other trademarks and trade names mentioned in this document are the property of their respective
holders.
Notice
The purchased products, services and features are stipulated by the contract made between Huawei and the
customer. All or part of the products, services and features described in this document may not be within the
purchase scope or the usage scope. Unless otherwise specified in the contract, all statements, information,
and recommendations in this document are provided "AS IS" without warranties, guarantees or
representations of any kind, either express or implied.
The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute a warranty of any kind, express or implied.
Website: http://e.huawei.com
Contents
1 Overview......................................................................................................................................... 1
1.1 Functions and Features................................................................................................................................................... 1
1.2 Specifications..................................................................................................................................................................1
1.3 Precautions for Using InfoCollect.................................................................................................................................. 4
2 Preparations.................................................................................................................................... 5
2.1 Installing InfoCollect...................................................................................................................................................... 5
2.2 Uploading the Software Package....................................................................................................................................5
6 FAQs...............................................................................................................................................68
6.1 No messages Log File in a Linux Log Package........................................................................................................... 68
6.2 No OS Log file in a Windows Log Package.................................................................................................................68
6.3 Failure of Collecting BMC Log Files...........................................................................................................................68
7 Obtaining Help............................................................................................................................ 71
7.1 Making Preparations Before Contacting Huawei......................................................................................................... 71
7.2 Obtaining Help from Huawei Support Website............................................................................................................71
1 Overview
1.2 Specifications
l Table 1-1 lists the OSs supporting InfoCollect.
l Table 1-2 and Table 1-3 list the InfoCollect specifications.
Windows 8 (32- √ √
bit/64-bit)
Windows 10 (64-bit) √ √
Windows Server √ √
2003 (32-bit/64-bit)
Windows Server √ √
2008 (32-bit/64-bit)
Windows Server √ √
2012 (64-bit)
NOTE
l √ indicates that an item is supported, and × indicates that an item is not supported.
l You need to run InfoCollect as an administrator on Windows 10.
Feature Specifications
Server Linux OS log file Supported mainstream Linux 64-bit operating systems
collection (OSs):
l RHEL 6.4 to 7.3
l SLES 11.1 to 12.1
l CentOS 6.4 to 7.3
l Ubuntu 14.04, 14.10, and 16.04
Table 1-3 InfoCollect specifications for collecting BMC, management module, and switch
module log files
Feature Specifications
Feature Specifications
Switch module log file Supported switch modules of E9000 blade servers:
collection l CX110/CX111
l CX210/CX220
l CX310/CX311/CX312/CX320
l CX710
l CX910/CX911/CX912/CX913/CX915/CX916/CX920
NOTE
l To collect BMC logs of blade servers, use the E9000 management module IP address.
l FusionServer Tools-InfoCollect-V126 and later versions do not support the collection of E6000
management module logs. To collect E6000 management module logs, use FusionServer Tools-
InfoCollect-V125 and earlier versions. Select E6000 MM from the Target drop-down list box, and
enter the MM610 or MM620 IP address, administrator user name, and password, as shown in Figure
1-1.
2 Preparations
On the download page, click to obtain the digital certificate, and click to
download the software. For details about how to obtain the verification tool and method,
see Software Digital Signature (OpenPGP) Validation Tool.
3. The InfoCollect tool is free of installation and can be used directly after you decompress
the software package.
NOTICE
If InfoCollect is used on a Windows OS, the InfoCollect path cannot contain ;. Otherwise, you
cannot run InfoCollect.
NOTICE
Server Linux OS log file collection: You need to upload the InfoCollect_Linux.tar.gz file to
the server Linux OS through Xftp. The path for storing the uploaded file cannot contain
spaces.
Step 2 Run the following command to connect to the server Linux OS:
ssh IP address of the server Linux OS
The SSH User Name window is displayed, as shown in Figure 2-1.
Step 3 Enter the user name of the server Linux OS, and click OK.
The SSH User Authentication window is displayed, as shown in Figure 2-2.
Step 4 Enter the password corresponding to the user name of the server Linux OS, and click OK.
The connection to the server Linux OS starts.
Step 5 Click .
The SSH User Authentication window is displayed, as shown in Figure 2-4.
Step 8 Drag the InfoCollect_Linux.tar.gz file from the left pane to the right pane.
The file uploading starts. When the InfoCollect_Linux.tar.gz file is displayed in the right
pane, the file is uploaded successfully, as shown in Figure 2-6.
NOTE
l Server Windows OS log file collection: You can use the network sharing function or a tool such as a
USB flash drive to upload the InfoCollect_Windows.zip file to the server Windows OS (drive D is
recommended).
l BMC, management module, and switch module log file collection: You only need to run the
InfoCollect.exe tool on the local console (which refers to the laptop running Windows of a service
engineer). For details about BMC log file collection, see Collecting Rack and High-Density
Server Log Files. For details about management module and switch module log file collection, see
Collecting E9000 Server Log Files.
----End
3.1.1 Overview
Run InfoCollect on a Windows PC or server and collect server BMC and OS logs. Ensure that
the IP addresses of the BMC and OS are pingable.
l Table 1-2 lists the OSs supported by this tool for log collection.
l Table 1-3 lists the rack and high-density servers supported by this tool for BMC log
collection.
l The BMC log files collected by using InfoCollect are the same as the log files collected
by running the BMC one-click collection commands. For details, see One-Click Info
Collection in the BMC help.
l For details about the OS log items that can be collected, see OS Log Collection Items.
NOTE
BMC and OS logs can be collected at the same time. The following describes how to collect them
separately.
Scenario
Collect BMC log files of a remote server using the local console (which refers to the laptop
running Windows of a service engineer).
Prerequisites
Conditions
l A Huawei rack or high-density server is available.
l The InfoCollect directory has sufficient available disk space for storing collected log
files.
l The target server is pinged.
Procedure
Step 1 Go to the InfoCollect_GUI folder. Figure 3-1 shows the files in the folder.
User Name BMC user name of the target server. The default
value is root.
SSH Port The default value is 22. It must be the same as the
SSH port number of the target server.
Step 3 Deselect OS Info, and enter the BMC IP address, user name, and password in the BMC Info
area.
The BMC log collection window is displayed, as shown in Figure 3-3.
NOTE
l Set User Name to an administrator (for example, root) for collecting log files.
l By default, you need to set only the BMC IP address, user name, and password for the InfoCollect
tool. If advanced settings are required, you need to modify the SystemConfig.ini file (for
professional users) in the FusionServer Tools-InfoCollect-V125\InfoCollect_GUI\config
directory. Figure 3-4 shows the SystemConfig.ini file.
NOTE
----End
Scenario
Collect Windows OS logs using InfoCollect.
Prerequisites
Conditions
l A Huawei rack or high-density server is available.
l PowerShell must be installed on the target OS and the PowerShell remote service must
be enabled for Windows log collection.
You can run the Enable-PSRemoting -Force command to enable the service on the
PowerShell screen. If the PowerShell remote service is disabled, you can only collect
Windows logs by using the CLI.
l The InfoCollect directory has sufficient available disk space for storing collected log
files.
Procedure
Step 1 Go to the InfoCollect_GUI folder. Figure 3-7 shows the files in the folder.
Step 3 Deselect BMC Info and select Windows in the OS Info area.
The Windows OS log collection window is displayed, as shown in Figure 3-9. Table 3-2
describes the parameters.
SSH Port The default value is 22. It must be the same as the
SSH port number of the target server.
OS Parameter Description
Local User Name Domain name or user name of the local PC.
NOTE
Set User Name to an administrator (for example, root or Administrator) for collecting log files.
Step 4 Enter the OS IP address, user name, and password of the target server, and the domain name/
user name and password of the PC, as shown in Figure 3-10.
NOTE
----End
3.2.1 Overview
Run InfoCollect on a Windows PC or server and collect server management module, OS, and
switch module logs. Ensure that the IP addresses of the management module, OS, and switch
module are pingable.
l Table 1-2 lists the OSs supported by this tool for log collection.
l Table 1-3 lists the servers whose management module and switch module logs can be
collected using this tool.
l The management module log files collected by using InfoCollect are the same as the log
files collected by running the one-click collection commands of the management
module. For details, see Information Collection in the management module help.
l For details about the OS log items that can be collected, see OS Log Collection Items.
l Table 3-3 lists the E9000 switch module log files that can be collected and commands
used to collect logs.
NOTE
Management module, OS, and switch module logs can be collected at the same time. The following
describes how to collect them separately.
Scenario
Collect management module log files of a remote server using the local console (which refers
to the laptop running Windows of a service engineer).
Prerequisites
Conditions
l A Huawei E9000 server is available.
l The InfoCollect directory has sufficient available disk space for storing collected log
files.
l Collect the log files of management modules during off-peak hours to minimize the
impact on services.
l The target server is pinged.
Procedure
Step 1 Go to the InfoCollect_GUI folder. Figure 3-13 shows the files in the folder.
The E9000 server log collection window is displayed, as shown in Figure 3-15. Table 3-4
describes the parameters in the MM910 area.
SSH Port The default value is 22. It must be the same as the
SSH port number of the target server.
NOTE
l Set User Name to an administrator (for example, root) for collecting log files.
l By default, you need to set only the management module IP addresses, user names, and passwords
for the InfoCollect tool. If advanced settings are required, you need to modify the SystemConfig.ini
file (for professional users) in the FusionServer Tools-InfoCollect-V125\InfoCollect_GUI\config
directory. Figure 3-16 shows the SystemConfig.ini file.
Step 4 Enter the MM910 IP address, user name, and password of the target server, and click
Connect.
Connect to the management module to obtain the available slot and switch module
information, as shown in Figure 3-17.
NOTE
After the log files are successfully collected, the message collect log successfully
is displayed, as shown in Figure 3-19.
Scenario
Collect blade server BMC and OS logs using InfoCollect. A Windows OS is used as an
example.
Prerequisites
Conditions
l A Huawei E9000 server is available.
l PowerShell must be installed on the target OS and the PowerShell remote service must
be enabled for Windows log collection.
You can run the Enable-PSRemoting -Force command to enable the service on the
PowerShell screen. If the PowerShell remote service is disabled, you can only collect
Windows logs by using the CLI.
l When Windows OS logs are to be collected, the installation directory of InfoCollect
cannot contain &[]. Otherwise, PowerShell will fail.
l The InfoCollect directory has sufficient available disk space for storing collected log
files.
l The target server is pinged.
Procedure
Step 1 Go to the InfoCollect_GUI folder. Figure 3-20 shows the files in the folder.
SSH Port The default value is 22. It must be the same as the
SSH port number of the target server.
Step 4 Enter the MM910 IP address, user name, and password of the target server, and click
Connect.
Connect to the management module to obtain the available slot and switch module
information. Slot numbers of available nodes are displayed in the Select Device area as shown
in Figure 3-23.
Step 5 In the Select Device area, select the slot number of the node whose OS logs are to be
collected, as shown in Figure 3-24. Table 3-6 describes OS and Local information
parameters.
SSH/PS Port The default value is 22. It must be the same as the
SSH port number of the target server.
Local Local IP Address The default value is Auto select. The IP address
information needs to be on the same network segment as that
of the target server OS.
Local User Name Domain name or user name of the local PC.
NOTE
Step 6 Set OS Type to Windows, enter the OS IP address, user name, and password of the target
server and the PowerShell remote management port number, and click Local information, as
shown in Figure 3-25. In the displayed dialog box, enter the local PC domain name/user
name and password.
NOTE
l After a slot number is selected, the row containing the OS settings of the node is selected by default
in the OS area. To delete the settings in a row, click delete.
NOTE
----End
Scenario
Collect switch module log files of a remote server using the local console (which refers to the
laptop running Windows of a service engineer).
Prerequisites
Conditions
l A Huawei E9000 server is available.
l The InfoCollect directory has sufficient available disk space for storing collected log
files.
l The target server is pinged.
Procedure
Step 1 Go to the InfoCollect_GUI folder. Figure 3-28 shows the files in the folder.
SSH Port The default value is 22. It must be the same as the
SSH port number of the target server.
Step 4 Enter the MM910 IP address, user name, and password of the target server, and click
Connect.
Connect to the management module to obtain the available slot and switch module
information, as shown in Figure 3-31.
Step 5 Select the slot number of the switch module whose logs are to be collected, as shown in
Figure 3-32. Table 3-8 describes Config switch parameters.
Config switch User Name Switch module administrator user name of the
target server. The default value is admin.
NOTE
Set User Name to an administrator (for example, admin) for collecting log files.
Step 7 Enter the user name for whom the logs are to be collected and the corresponding password,
and click Query.
The dialog box shown in Figure 3-34 is displayed.
The system automatically obtains the switch module IP address, subnet mask, and gateway, as
shown in Figure 3-35.
NOTE
You can manually enter the new IP address and subnet mask in the Config Switch dialog box and click
Config to change the IP address and subnet mask.
NOTE
The log file collection is successful if the message collect log successfully is
displayed. See Figure 3-38.
----End
Scenario
Collect Windows log files of a server.
Prerequisites
Conditions
l A Huawei V2, V3 or V5 server is available.
l The InfoCollect_Windows.zip file has been uploaded to the target server.
l You have logged in to Windows as an administrator.
l You have backed up key data, and checked the CPU usage, memory usage, and available
disk space to ensure that InfoCollect is operating properly.
Procedure
Step 1 Decompress the InfoCollect_Windows.zip file, as shown in Figure 4-1.
Step 3 (Optional) Modify the config.ini configuration file to specify the log files to be collected, as
shown in Figure 4-3.
Change the value of flag to specify whether to collect a log file. InfoCollect collects all log
files by default, as shown in Figure 4-4.
NOTE
You are advised to check the log files to be collected. If you do not want to collect a log file, set flag to
no.
The collection of Windows log files starts. Figure 4-6 shows collection process information.
NOTE
The collection process will last several minutes.
After log file collection is complete, the information shown in Figure 4-7 is displayed.
NOTE
l If the information shown in Figure 4-8 is displayed after log file collection is complete, manually
collect crash files to your local computer.
l Crash files are large. You need to manually collect crash files for fault diagnosis.
Step 5 Confirm that all log files are collected based on the content of the filelist.txt file in Figure
4-9.
You can filter the collected log files and then compress them into a package.
NOTE
You are advised to compress log files before sending them to Huawei for analysis.
----End
Scenario
Collect Linux log files of a server.
NOTICE
Do not directly decompress the InfoCollect_Linux.tar.gz tool package of the Linux version
on a Windows OS. Otherwise, the tool cannot collect logs because the lack of execution
permission.
Prerequisites
Conditions
l A Huawei V2, V3 or V5 server is available.
l The InfoCollect_Linux.tar.gz file has been uploaded to the target server.
l You have logged in to Linux as a user with an ID of 0, for example, root.
l You have backed up key data, and checked the CPU usage, memory usage, and available
disk space to ensure that InfoCollect is operating properly.
NOTE
Run the whoami and id commands on the OS. In Figure 4-10, the current user is root and its user ID is
0.
Procedure
Step 1 Confirm that the InfoCollect_Linux.tar.gz file has been uploaded to the server Linux OS. For
details, see Uploading the Software Package.
Step 2 Run the following command to go to the directory where the InfoCollect_Linux.tar.gz file is
located, as shown in Figure 4-11.
cd
Step 3 Run the following command to decompress the collection tool package, as shown in Figure
4-12 and Figure 4-13.
tar -zxvf InfoCollect_Linux.tar.gz
Step 4 Run the following command to go to the InfoCollect_Linux directory, as shown in Figure
4-14.
cd InfoCollect_Linux
Step 5 Run the following command to grant the operation permission on all files in the
InfoCollect_Linux directory to the user:
chmod +x *
Step 6 (Optional) Run the following command to modify the config.ini file to specify the log files to
be collected, as shown in Figure 4-15.
NOTE
You are advised to check the content of the log files to be collected. You can edit the flag column to
determine whether a log file is to be collected. yes indicates that the log file is to be collected. no
indicates that the log file is not to be collected. By default, all log files are to be collected.
Step 7 Run the following command to collect log files, as shown in Figure 4-16.
./infoCollect.sh
NOTE
The collection process will last several minutes.
The log collection is successful if the message shown in Figure 4-17 is displayed.
NOTE
l If the information shown in Figure 4-18 is displayed after log file collection is complete, manually
collect crash files to your local computer.
l Crash files are large. Manually collect crash files for fault diagnosis if necessary.
Step 8 Confirm that all log files are collected based on the content of the filelist.txt file in Figure
4-19.
You can filter the collected log files and then compress them into a package.
NOTE
l You are advised to compress log files before sending them to Huawei for analysis.
l The maximum log file collection duration of InfoCollect is 20 minutes by default.
----End
NOTE
l The number and content of collected log files slightly vary according to the Windows version, but all
log files collected are listed in Table 5-1.
l In the es3000v2.txt of disk module, the value of deviceID is the given ES3000 V2 object, such as 0,
1; the value of controllerID is the given controller serial number, such as 1, 1; the value of
registerAddress is the specified register address, such as 0x2400, 0x2310.
l You can customize the log information to be collected by editing the config.ini file in the tool
directory. The runlog.txt file in system specifies the default log information to be collected and does
not need to be customized.
ethtool -i ethX
ethtool -S ethX
ethtool -g ethX
ethtool -k ethX
netstat -avn
netstat -s
netstat -rvn
biosdecode
lspci -tv
ifconfig -a
/sbin/route -n
ethtool -i ethX
ethtool ethX
ethtool -a ethX
ethtool -l ethX
ethtool -d ethX
ethtool -e ethX
ethtool -S ethX
ethtool -g ethX
ethtool -k ethX
/sbin/lspci -xxx -s
XX:XX.X
/bin/netstat -nlp
/bin/netstat -nr
/bin/netstat -i
/sbin/arp -v
/usr/sbin/iptables -t
filter -nvL
x86tool -r pci/
bXX:XX.X-0xXXXXX+4-
bX
Host bus lspci_fc.txt lspci |grep Fibre Fibre Channel (FC) models
adapter
(HBA) firmware_fc.txt cat /sys/class/scsi_host/ FC HBA firmware
host*/fwrev information
NOTE
l The number and content of collected log files slightly vary according to the Linux version, but all
log files collected are listed in Table 5-2.
l The InfoCollect tool invokes a large number of system commands, such as ipmitool and smartctl. If
the related software has not been installed, certain log information cannot be collected.
l The bash_history command collects historical command information for fault diagnosis. Collect the
information unless necessary. You can modify the config.ini file to disable command information
collection or manually delete the collected command information after collection and then compress
the files into a package.
l The sosreport and supportconfig commands are log file collection commands that come with the
OS. The collected log files are used for in-depth fault diagnosis. Run the commands only when
necessary. You can modify the config.ini file to disable log file collection or manually delete the log
files after collection and then compress the files into a package.
l You can modify the config.ini file in the InfoCollect directory to specify the log files to be collected.
l mezz_info.tar.gz contains NIC information about the E9000. Although duplicate information is
collected, the collected information is helpful for E9000 operation.
6 FAQs
Step 1 Log in to the BMC CLI over Secure Shell (SSH). See Figure 6-1.
Step 4 Run the following command to clear /tmp. See Figure 6-4.
rm
NOTE
/tmp is a temporary folder, and all files in /tmp can be deleted.
----End
7 Obtaining Help
You are advised to make the following preparations before contacting Huawei technical
support.
l Collecting Fault Information
– You need to collect the following information:
n User name and address
n Contact name and telephone number
n Time when the fault occurred
n Fault symptom
n Device type and software version
n Measures taken after the fault occurred and results
n Fault severity and expected rectification deadline
l Preparing for Debugging
When you seek technical support, Huawei technical support may assist you in collecting
more fault information or even rectifying the fault. Before seeking technical support,
prepare spare server parts, screwdrivers, screws, serial cables, network cables, and other
necessary objects.