Skip to content
/ sassist Public

Dell SupportAssist log collector for Linux

License

Notifications You must be signed in to change notification settings

dell/sassist

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

This is 'sassist', Dell SupportAssist log collector agent for Linux.

What is 'sassist'?

Dell SupportAssist embedded in Dell iDRAC helps with troubleshooting/debugging issues with Dell PowerEdge Server hardware/OS.

'sassist' is an agent that runs on the Linux Operating System to work with Dell iDRAC enabling log and configuration collection. It uses native log/configuration collection tools like sos and supportconfig available in popular Linux distributions.

'sassist' requires Dell iDRAC 9 or later.

Working

  • User initiates SupportAssist Collection from Dell iDRAC through any of the available interfaces (Web UI, wsman, redfish, racadm)
  • 'sassist' collects system logs/configuration and packages it for use by Dell iDRAC.
  • Dell iDRAC aggregates OS/firmware/hardware logs and makes it available via the requested method.

Download

  • 'sassist' is available in Fedora 29, openSUSE Leap 15.4 and Tumbleweed. It can be installed from the default repository. On SUSE Linux Enterprise Server 15 SP4 it is available via SUSE PackageHub.
  • Pre-built packages for RHEL (CentOS, Fedora) and SLES (OpenSUSE) based distributions are available here

Build

rpm:

  • Download the tarball.
  • tar xf <VERSION>.tar.gz
  • make

deb:

  • TODO

Installation:

  • Install package

    • $ sudo yum install sassist-<version>.rpm

    OR

    • $ sudo zypper in sassist-<version>.rpm
  • Start sassist

    • $ sudo systemctl enable --now sassist

Usage:

Create a SupportAssist collection from Dell racadm cli:

  • racadm supportassist accepteula
  • racadm supportassist collect -t sysinfo,osAppAll -f <REPORT_LOCATION>
  • Report will be saved in REPORT_LOCATION
  • More details here

Create a SupportAssist collection from Dell iDRAC Web UI:

  • Navigate to Maintenance -> SupportAssist
  • At the “SupportAssist Registration” screen, click "Cancel" (The support to automatically/periodically collect and upload logs to Dell Support sites is still not available with ‘sassist’. Until then, the log collection can only be initiated manually).
  • Click “Start a Collection”
  • Check “OS and Application Data” and click “Collect”
  • Accept EULA and click “Continue”
  • Monitor Progress. The process would take a couple of minutes.
  • On completion, click “Ok” and save the “zip” archive. This can be used for analysis/debugging.
  • More details here

Notes

  • Do not run SupportAssist Collection while updating system firmware components with Dell DSU.

Send patches and suggestions to the following mailing list with "sassist: " in the subject line: mailing list