Skip to content
No description, website, or topics provided.
Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
.gitignore
LICENSE
README.md
debug.sh

README.md

sf-debug

Maintenance GitHub Supported STARFACE Versions
CircleCI GitHub file size in bytes

How to use this script?

Pre-Flight checklist

Required

Option 1: Download and execute

  • Download the script to your appliance (e.g. /root/debug.sh) and make it executable. For that, execute
    curl -k --silent https://raw.githubusercontent.com/sf-janz/sf-debug/master/debug.sh > /root/debug.sh && chmod +x /root/debug.sh
    within the shell (SSH).
  • Start the script (you can use Parameters):
    /root/debug.sh
  • Using SCP or sFTP, download the debuginfo-XXXXXXXX.zip from the /root/ folder.

Option 2: Execute via cURL

  • Execute
    curl -k --silent https://raw.githubusercontent.com/sf-janz/sf-debug/master/debug.sh | /bin/bash\
  • Using SCP or sFTP, download the debuginfo-XXXXXXXX.zip from the /root/ folder.

Parameters

You can change the behaviour of the script, depending on which Paramters you pass along:

debug.sh [-v|q] [-j] [-r] [-a] [-u] [-h]
-v: Verbose output (inner function calls)
-q: Minimum output (quiet)
-j: Create Java memorydump
-r: Dont verify RPMs, may save a lot of time if unnecessary
-a: Dont include /etc/asterisk
-fs: Force fsck for the root partition on the next boot
-u: Upload the resulting file to a STARFACE Nextcloud share (requries URI from the support)
-h: Help (this screen)

Examples

  • You've been tasked to verify integrity of all installed RPM Pakets. You don't need a Java memory dump:
    ./debug.sh
  • You just need the logfiles from the appliance:
    ./debug.sh -r -a
  • You don't want to include the passwords of the SIP accounts:
    ./debug.sh -a
  • Upload the logs to STARFACE Nextcloud share: ./debug.sh -u
You can’t perform that action at this time.