Viewing system diagnostic log files
A QoreStor system diagnostics log file is a bundle that contains a variety of file types that record the latest system settings and saves them in a compressed .lzip file format.
In the QoreStor system GUI, the Diagnostics page allows you to generate diagnostic logs that capture the state of your system. You can also download these log files or delete them as needed.To view the system diagnostics page, follow these steps.
- In the navigation menu, click Diagnostics.
- You can view the following columns of information on the Diagnostics page for the diagnostics logs that have been generated.
- File name—in this format, <hostname>_<date>_<time>.lzip, as in this example:acme-sys-19_2012-10-12_13-51-40.lzip
NOTE: Diagnostic log file names are limited to 128 characters.
- Size—in Megabytes.
- Path—The location to which the diagnostics bundle is saved.
- Download—Use this icon to download the diagnostics bundle.
- File name—in this format, <hostname>_<date>_<time>.lzip, as in this example:acme-sys-19_2012-10-12_13-51-40.lzip
Understanding diagnostics collection
The Diagnostics function in the QoreStor system lets you collect and manage your system’s diagnostic log file bundles. The Diagnostics function works by collecting all the system-related information that could help when diagnosing a problem or error condition in the system. Each diagnostic log file bundle provides:
- A current snapshot of system operations
- System-related information that assists in understanding system operations
- A record of system operations in case Technical Support needs to provide technical assistance
Diagnostics bundles are generated when a QoreStor CLI or GUI request is made by the administrator (and the default reason that is listed is admin-generated).
When the diagnostics log directory exceeds the maximum storage capacity, any log older than one hour is automatically deleted. QoreStor GUI lets you download and save diagnostics log files to other systems on your network. QoreStor also maintains a separate archive logs directory that collects other system-related information, and these archive logs are also automatically deleted when they exceed a maximum capacity. When you generate a diagnostics log file bundle, it contains all of the QoreStor information that you need when contacting Technical Support for technical assistance. . When a diagnostics log file bundle is generated, this process also collects all the previous auto-generated diagnostics and deletes them from the system.
The QoreStor GUI provides options to display existing diagnostics logs, generate new diagnostics logs, download and save copies of existing diagnostics logs, or delete existing diagnostics logs. TheQoreStor CLI also provides the means for managing, generating, or downloading the diagnostics log files. For more information, see the QoreStor Command Line Reference Guide.
Generating a diagnostics log file
Generating a diagnostics file through the GUI
To generate a diagnostics log file bundle for your system, complete the following steps:
- In the left navigation menu, click Diagnostics.
- On the right side of the page, click Generate Diagnostics.
Once completed, the new diagnostics log file resides at the top of the File Name column in the table. To verify, check its timestamp (using its date and time), to ensure this is the latest diagnostics file created.
Generating a diagnostics log file through the command line
To generate a diagnostics log file bundle for your system, complete the following steps:
- Access your system's command line interface. QoreStor commands are located in the /opt/qorestor/bin directory. Either change directories to the appropriate location, or add the appropriate location to your system path.
- Generate a diagnostics log file with the command
maintenance --diags --collect
Refer to the QoreStor Command Line Reference Guide for more information.
Downloading diagnostics log files
To download an existing diagnostics log file, complete the following steps:
- In the left navigation menu, click Diagnostics.
- In the list, select the diagnostics log file you want to download, and click the Download icon.
- Download and save the file as needed.