Skip to content

SYSIS is a cross-platform script that displays base system & network information

License

Notifications You must be signed in to change notification settings

robertpeteuil/sysis

Repository files navigation

SYSIS - the Lightweight System-Information Utility

Quickly Display System Information for Varied Host Types

GitHub release lang license


SYSIS provides a simple way to retrieve and display system information across multiple system types, by eliminating the need to use multiple OS specific commands.  It is especially useful for sys-admins, developers and IT Professionals who maintain simultaneous connections to multiple hosts, as it allows rapid retrieval of system info for any host.

Designed for maximum productivity:

  • Simple to use and requires no parameters
  • Executes quickly by focusing on most commonly needed information
  • Includes Network Connection Details - Adapter Name, IPv4 Address, IPv6 Address, and MAC Address
    • Details about Network Info are described in the CHANGELOG

macOS with 2 NICs: "en1" with IPv4 & IPv6, "en2" with IPv4

macOS

Ubuntu with 1 NIC: "enp0s10" with IPv4 & IPv6

Ubuntu

Supported Platforms

  • Linux
  • macOS (OS X)
  • Windows 10 Linux Shells
  • Embedded Devices running Linux

Download

Download latest release from my bootstrap server (iac.sh or https://iac.sh)

curl iac.sh/sysis > sysis
chmod +x sysis
# optional - move to system binary directory
sudo mv sysis /usr/local/bin

Download from GitHub

curl -LO https://raw.github.com/robertpeteuil/sysis/master/sysis
chmod +x sysis

Hosted Script Execution and Security

For the purpose of this utility, there are two scenarios where executing a script directly from GitHub is desirable:

  • executing the installation script
    • this makes for an extremely simple, one-step install
  • executing sysis without installation
    • this is enables use of the utility on hosts where installation is not possible

In general, executing hosted scripts is not secure because the scripts are executed without a chance to inspect them. Fortunately, the security risks can be mitigated by performing actions specific to each scenario.

Preparations for Using Hosted Installation Script This is the easier of the two scenarios to address because you will only run the installer once and don't need to consider future changes.

  • review the installer and ensure its safe and meets your security standards
  • After review, the hosted installation script can be executed with the command below.
    • This is the equivalent of the first installation option, but performed in one step.

The online-installation command:

bash -c "`curl -s -L https://raw.github.com/robertpeteuil/sysis/master/install.sh`"

Preparations for Using Hosted sysis Script

  • Review the sysis script and ensure its safe and meets your security standards
  • Create a fork of this repo in your GitHub account
    • This provides an isolated copy that you control and allows you to review all future commits before syncing them to your fork.
    • In your fork, edit install.sh and change the value assigned to REPOACCT to your username. (This ensures that running the installer in your fork will look for releases in your fork.)
    • Change the username in the command below so the script runs from your fork.
  • For ease of use, you will likely want to create an alias or terminal macro to execute the command:
bash -c "`curl -s -L https://raw.github.com/robertpeteuil/sysis/master/sysis`"
# remember to change 'robertpeteuil' to your account name if you've created a fork

Usage and Options

USAGE: sysis [OPTIONS]

 OPTIONS:
     -c  : compressed output (no separation lines)
     -d  : debug only report
     -n  : network only report
     -h  : help
     -V  : version info
 --help  : detailed help

Project History

SYSIS, an acronym for "SYStem IS", was originally written in 2014 and released as open-source in 2017.