suntorytimed / sassist

Dell SupportAssist log collector for Linux

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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

About

Dell SupportAssist log collector for Linux

License:Other


Languages

Language:Shell 91.2%Language:Makefile 8.8%