Skip to content

README.md

Latest commit

 

History

History
87 lines (74 loc) · 3.87 KB

README.md

File metadata and controls

87 lines (74 loc) · 3.87 KB

OmenShell | Manage multiple servers through SSH

License: GPLv3 Ubuntu Bash

Requirements

You need a valid user on the remote system with passwordless access via SSH key.

Configuration

Edit the omen.host file to add the remote servers you want to manage. After the installation this file can be located in the ~/bin directory.

Installation

From a Linux terminal type the following commands:

cd
git clone https://github.com/incognia/OmenShell
cd OmenShell
./install.sh

Dependencies

The option -s requires the Speedtest CLI by Ookla to test the internet bandwith. You need to execute the following commands to install it:

sudo apt-get install curl
curl -s https://packagecloud.io/install/repositories/ookla/speedtest-cli/script.deb.sh | sudo bash
sudo apt-get install speedtest
speedtest --accept-license

Usage

omen [-option]
  [-d] Show information about the remote file system
  [-f] Display amount of free and used memory in each remote system
  [-h] Show the remote system's host name
  [-l] Show a listing of last logged in users
  [-n] Show network and DNS configuration
  [-p] Shutdown ALL servers. Use with caution!
  [-r] Show failed SSH root login attempts
  [-s] Test internet bandwidth using speedtest.net
  [-t] Display Linux processes
  [-u] Tell how long each remote system has been running
  [-v] Show OmenShell version and License

Example

The omen command with flag -h:

omen -h

Output:

=======================================================[ Server IP address ]====
                                           ┏━┓┏━┓╺┓  ╺┓ ╺┓ ┏━┓ ╻ ╻┏━┓ ╺┓ ┏━┓┏━┓
                                           ┏━┛┃┃┃ ┃   ┃  ┃ ┣━┓ ┗━┫┃┃┃  ┃ ╺━┫┃┃┃
                                           ┗━╸┗━┛╺┻╸╹╺┻╸╺┻╸┗━┛╹  ╹┗━┛╹╺┻╸┗━┛┗━┛
 Static hostname: faraday
         Chassis: server
Operating System: Ubuntu 22.04.2 LTS
          Kernel: Linux 5.15.0-60-generic
 Hardware Vendor: HPE
=======================================================[ Server IP address ]====
                                           ┏━┓┏━┓╺┓  ╺┓ ╺┓ ┏━┓ ╻ ╻┏━┓ ╺┓ ┏━┓┏━┓
                                           ┏━┛┃┃┃ ┃   ┃  ┃ ┣━┓ ┗━┫┃┃┃  ┃ ╺━┫┣━┓
                                           ┗━╸┗━┛╺┻╸╹╺┻╸╺┻╸┗━┛╹  ╹┗━┛╹╺┻╸┗━┛┗━┛
   Static hostname: desa
           Chassis: vm
    Virtualization: oracle
  Operating System: Ubuntu 16.04.7 LTS
            Kernel: Linux 4.4.0-210-generic
=======================================================[ Server IP address ]====
                                           ┏━┓┏━┓╺┓  ╺┓ ╺┓ ┏━┓ ╻ ╻┏━┓ ╺┓ ╻ ╻┏━┓
                                           ┏━┛┃┃┃ ┃   ┃  ┃ ┣━┓ ┗━┫┃┃┃  ┃ ┗━┫┃┃┃
                                           ┗━╸┗━┛╺┻╸╹╺┻╸╺┻╸┗━┛╹  ╹┗━┛╹╺┻╸  ╹┗━┛
   Static hostname: dev-tomcat
           Chassis: vm
    Virtualization: microsoft
  Operating System: Debian GNU/Linux 9 (stretch)
            Kernel: Linux 4.9.0-19-amd64
===================================================[ OmenShell by incognia ]====

CC 2023 | Rodrigo Ernesto Álvarez Aguilera | Mail | LinkedIn | Blog