search cancel

Using RACADM or iDRAC to generate support logs

book

Article ID: 210804

calendar_today

Updated On:

Products

Security Analytics

Issue/Introduction

If there is a suspected hardware issue with a Dell appliance running Security Analytics, you can generate a TSR log bundle using RACADM at the command line.  iDRAC can also be used to generate the support bundle.

 

Resolution

Here is the main link for the RACADM 4.00.00.00 and up CLI guide:


Web: https://www.dell.com/support/manuals/us/en/04/idrac9-lifecycle-controller-v4.x-series/idrac_4.00.00.00_racadm/introduction?guid=guid-3f6fb670-796a-4724-9d61-ad8a523b7b3e&lang=en-us
PDF: https://topics-cdn.dell.com/pdf/v4_00_cliguide_en-us.pdf
RACADM is included with Security Analytics 8.1.x.  If for some reason if it is not already installed, you can download the installer here: https://www.dell.com/support/home/en-us/drivers/driversdetails?driverid=0992n

To install RACADM, do the following:

  1. Look for the "gnu zip file for software installation"
  2. scp to the server to the /home directory and unzip (tar -xzf filename.tar.gz)
  3. cd to iDRACTools/racadm and run  ./install_racadm.sh
  4. Re-establish your SSH session and racadm should be in your path

To uninstall RACADM, do the following:

  1. Assuming RACADM was installed using the above procedure, go to the iDRACTools/racadm directory.
  2. Run:  ./uninstall_racadm.sh
  3. Re-establish your SSH session to complete the uninstallation.

If you have access to iDRAC, the TSR can be downloaded through the iDRAC user interface.  For steps on how to do that, see the following links:

iDRAC 7/8: https://www.dell.com/support/article/en-us/sln295784/
iDRAC 9: https://www.dell.com/support/article/en-us/sln306670/

 

Once RACADM is installed, follow these steps to generate a TSR from the CLI:

  1. Add /opt/dell/srvadmin/sbin to your path by entering export PATH=$PATH:/opt/dell/srvadmin/sbin
  2. run racadm set LifecycleController.LCAttributes.CollectSystemInventoryOnRestart 1
  3. Change to the directory you wish to have the TSR file saved to.
  4. run racadm techsupreport collect -t SysInfo,TTYLog and press ENTER
  5. racadm jobqueue view and watch for the job to complete (takes several minutes)
  6. run racadm techsupreport export -f <NAME>.zip and press ENTER
  7. The file should then be saved to the location you are currently in.

Included in the TSR zip file is a viewer.html.  By opening that file with a browser you can see a full set of logs along with the current status and configuration.

Additional Information

If you happen to see an error to "Retry" then either wait five minutes or run 'racadm jobqueue view' and watch for when the collect job completes to 100%.

The error returned if the collect job is not complete is -
ERROR: RAC1150: Unable to complete the export operation.
    Retry the export operation after five minutes