Overview

The purpose of this article to provide information on how to generate a Diag from a CLI. A Diag (short for diagnostic) is needed for the purposes of troubleshooting. Generally, it is best to generate it via GEM Web UI.

However, it can also be generated via the CLI in scenarios where access to the web UI is not possible or not preferred.

Procedure

To generate a Diag from the CLI complete the following steps:

Step 1: Open a CLI (this can be through the VM's CLI pertaining to the GEM appliance).-

Step 2: Log into the appliance. In the example below, the login is via an sbox user.

Step 3: Run the following command:

curl -k -X PUT https://127.0.0.1:8686/diag

The screen below shows the command run on CLI:

Once the command above is run, the output is seen as:

The output indicates that the "Diag" file is generated within: /opt/sbox/tmp/diag

Step 4: Run the following command:

cd /opt/sbox/tmp

Step 5: After the above command is run, type: "ls"

The user will now be in the "Diag" directory.

Step 6: To get to the "Diag" generated, type the following in the CLI

 cd diag

Within the Diag directory, there may be more than one Diag present. The Diags will be time stamped, so the latest Diag generated will be id by the time indicators. In the example below, the most recent Diag is indicated by "2019-11-04"

Step 7: The contents of the "Diag" can be accessed by the following command in CLI. As per the example the file needed is "Gemini_gemini-278b56cc_20191104_134615.diag"

 cat Gemini_Diag_gemini-278b56cc_20191104_134615.diag

Within the command prompt, the command is run as:

Once generated there are numerous ways in which the Diag file can be transferred to your laptops or PC to be added for attachment to the support ticket. Utilities like WinScp or FileZilla can be used to login into the GEM Appliance, navigating to the default location of diag files at /opt/sbox/tmp/diag, and proceed to download.