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.
A QoreStor 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. When you generate a diagnostics log file bundle, it contains all of the QoreStor information that may be needed when contacting Technical Support for technical assistance. This also includes all the previous auto-generated diagnostics log files, which are then deleted from the QoreStor system.
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 [basic]]
|
|
NOTE: Running the command with the "basic" suboption collects diagnostics without core files. |
Refer to the QoreStor Command Line Reference Guide for more information.
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.
To delete an existing diagnostics log file from the Diagnostics summary table on the Diagnostics page, complete the following:
- Select .
- Click Select to select the diagnostics file you want to delete, and click Delete.
- Click OK to delete the selected diagnostics log file (or click Cancel to display the Diagnostics page).
