12.3. Generating a diagnostic bundle by using the roxctl CLI

Prerequisites

• To generate a diagnostic bundle, you need read permission for the Administration resource.
• You must have configured the RHACS administrator password or API token and central address.

Procedure

• To generate a diagnostic bundle by using the RHACS administrator password, perform the following steps:

  1. Run the following command to configure the ROX_PASSWORD and ROX_CENTRAL_ADDRESS environment variables:

     $ export ROX_PASSWORD=<rox_password> && export ROX_CENTRAL_ADDRESS=<address>:<port_number> 

     1

     1

     For <rox_password>, specify the RHACS administrator password.

  2. Run the following command to generate a diagnostic bundle by using the RHACS administrator password:

     $ roxctl -e "$ROX_CENTRAL_ADDRESS" -p "$ROX_PASSWORD" central debug download-diagnostics

• To generate a diagnostic bundle by using the API token, perform the following steps:

  1. Run the following command to configure the ROX_API_TOKEN environment variable:

     $ export ROX_API_TOKEN=<api_token>

  2. Run the following command to generate a diagnostic bundle by using the API token:

     $ roxctl -e "$ROX_CENTRAL_ADDRESS" central debug download-diagnostics