dell / sassist Goto Github PK

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

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.

• 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.

• '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

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

• TODO

• Install package

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

  OR

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

• Start sassist

  • $ sudo systemctl enable --now sassist

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

• 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

• 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