Knowledge Base Home

Call Support


Search the Knowledge Base

Skip to end of metadata
Go to start of metadata

Environment

Netmail Archive 5.x with Netmail Store

Synopsis

To help troubleshoot Netmail Store Cluster Services Node (CSN) issues as part of a third-party escalation, the third party (Caringo) requires an sosreport (son of sysreport) to debug the system.  An sosreport is a Linux tool used in Redhat Enterprise Linux (RHEL) to generate detailed debugging information using the sosreport command.  This tool will collect detailed configuration and diagnostic information about the hardware and setup of the CSN node and will package the information as an archive written to /tmp.  For example, it gathers information about the running kernel version, loaded modules, and system and service configuration files. The command also runs external programs to collect additional information, and it stores this output in the resulting archive. The archive can then be sent to Caringo to give them a more complete view of the overall system status and help them identify the issue. This article will explain how to do this.

Solution

To be able to generate a sosreport, the sos package must be installed. The package is part of the default group of packages and is installed automatically on most systems. If the package is not present, it may be added manually as outlined in this article.

To run the report tool, open a terminal on the server (or access the server via SSH) and gain root privileges. As root, issue the following command to generate the report:

sosreport

Once the command is invoked, the prompts will request a name and then the third party case number (as shown in the screenshot below). After the script runs, it may take some time to collect all the data and produce a compressed file, depending on the speed of the system and how many packages are installed. As illustrated below in the command’s output, the filename and path where the compressed archive is saved will be indicated, along with an md5 checksum:

 

 

The archive is stored by default in the following format at /tmp/sosreport-* as a compressed file (tar.xz, gz, or bz2):

-rw------- 1 root root 631098 June 1 14:34 sosreport-testserver.9999-725705-3400ad.tar.bz2

The compressed archive contains all linux configuration files, startup/shutdown scripts, and current system information (e.g., dmidecode, lsmod, lspci, netstat, iptables, rpm, network routes, LVM, device mapper, EMC multipathing, etc.).

The archive containing the debug data may be copied to a desktop and subsequently provided to the third party for analysis.

The sosreport command allows an administrator with access to the CSN node to easily create a file containing all relevant settings needed for troubleshooting. This is especially useful if the administrator is not familiar with Linux, in which case it can be more difficult to gather all of the necessary information. The sosreport is a simple and effective command for gathering the data needed to speed up third party resolution.

Notes


Help us improve!
Is this article helpful?
Is it well written?
Is the content complete?