MassUPD

About

MassUPD is a powerful command-line tool primarily designed for mass updating Linux systems. In addition to its core functionality of updating software across multiple systems, it also offers the ability to run custom commands on all connected systems simultaneously. This makes it ideal not only for bulk software installations but also for various other administrative tasks. The tool leverages multi-threading to ensure high performance by connecting to all clients concurrently.

The tool is very easy to configure using the various config files

Features

The tool has a wide range of features such as:

• Filtering connections
• Importing connections using a formatted json file
• Logging
• Executing custom commands
• Ability to add more package managers
• And much more

Install

Before you install MassUPD make sure you have python installed.

Linux

git clone https://github.com/LoserPurp/massupd.git && sudo bash massupd/install.sh

Windows

Download or clone the repo and run the install.ps1 file

Make sure you enable running powershell scripts

General information

All the connections are stored encrypted in a file called connections.json. The user sets up their own encryption key, which is wrapped (encrypted with itself) and stored inside a file called "key.txt". The wrapped key is only used to validate that the key you enter when using the tool, ensuring data safety.

All activities performed by the tool are logged in a log file for easy debugging. Access the log by running:

massupd -l

Note: if you change the salt in the config file, you would need to re-encrypt existing connections.

How to use

IMPORTANT: before you use the tool remember to change the salt inside the "conf.yaml" file.

Flags

Running the tool without any flags starts the updating process.

Here are a list of all the different flags and what they do

  -a, --add                                        Add one or more new connections
  -b BACKUP, --backup BACKUP                       Makes or restore a backup
  -c, --connections                                List all connections
  -e, --edit                                       Edit one or more connection
  -f FILTER, --filter FILTER                       Filter out connections
  -h, --help                                       Shows this message
  -i [IMPORT_LIST], --import-list [IMPORT_LIST]    import connections from list
  -k KEY, --key KEY                                Run script with key inn command
  -l [LOG], --log [LOG]                            Reads last 'n' lines in log file (default / blank is 25)
  -n, --new-key                                    Sets a new dectryption key
  -r, --remove                                     Remove connection by ip
  -t, --test                                       Test all connections
  -u, --user-command                               Run a user defined command
  -w, --wipe                                       Wipes all the connections
  -x, --export                                     Saves all connections as a unencrypted json file

Detailed explanations

Using -f or --filter

massupd -f b

Blacklist option

massupd -f w

Whitelist option

Use the filter flag with another valid flag to filter out connections based on specific criteria. For instance, you can filter out all connections using the package manager apt and update only the remaining systems.

Here is an example that filters out every connection with the package manger apt. and therefore updates only systems without that manager.

The filter option can be used with --key (-k), --user-command (-u), --test (-t), and without another flag.
Running the command without a flag will update all systems

Using -i or --import-list

massupd -i [filename]

If the filename is left blank, it will look for /usr/lib/massupd/list.json, which is a dummy file.

The import flag allows you to preconfigure all your connections in a JSON file.

The JSON file has four main parts:

• loop: Indicates if the loop function should run.
• creds: Shared credentials for multiple connections.
• ips: List of IP addresses with shared credentials.
• connections: Standalone connections with defined IP and credentials.

Note that "passwordSudo" means passwordless sudo wich is not enabled by default

Example JSON file:

{
    "loop" : true,
    "creds" : {
        "user" : "bob",
        "password" : "pWord",
        "port" : 22,
        "passwordSudo" : "no",
        "manager" : "apt"
    },
    "ips" : [
        "192.168.10.150",
        "192.168.10.151",
        "192.168.10.152",
        "192.168.10.153",
        "192.168.10.154",
        "192.168.10.155"
    ],
    "connections" : [
        {
        "user": "jan",
        "ip": "192.168.10.420",
        "port": 22,
        "password": "password",
        "passwordSudo": "yes",
        "manager": "yum"
        },
        {
        "user": "banan",
        "ip": "192.168.10.69",
        "port": 33,
        "password": "password",
        "passwordSudo": "no",
        "manager": "dnf"
        }
    ]
}

Note: it is recommended that you delete this file after use

Using -x or --export

massupd -x

Exporting connections will decrypt all the connections and save them as a json file in the folder you are running the command. The exported file, called "export.json" will be compatible with the import function.

Using -w or --wipe

massupd -w

Restores everything to default settings, except configurations made in the config files.

Using -b or --backup

The backup function will make a copy of all the connections to be restored later or moved to another system

massupd -b m

Makes a new backup

massupd -b r

Restores connetions from a backup

Using -n or --new-key

Used to change the encryption key

re-encrypts the connections and all backups

massupd -n

Configuration

There are two yaml files used for configuring the tool.

• managers.yaml
• conf.yaml

Mangers.yaml

apt: 'sudo apt update && sudo apt upgrade -y'
dnf: 'sudo dnf upgrade -y'
yum: 'sudo yum update -y'
pacman: 'sudo pacman -Syu --noconfirm'

Add or modify package managers and their update commands here.

Conf.yaml

salt: salt1234
testCommand: whoami
logFile: log
listFile: /usr/lib/massups/list.json
conFile: connections.json
managerFile: mangers.yaml
keyFile: key.txt

This file contains settings such as the salt for encryption, the command for testing connections, and file paths. It is crucial to change the salt to something random and complex.

File paths

Paths for script and config files

Linux path: /usr/lib/massupd

Windows path: C:\Program Files\massupd

Path for the wrapper scripts

Linux path: /usr/bin/massupd

Windows path: C:\Windows\massupd.bat

Extra

MassUPD is still under development. If you encounter any bugs, issues, or have feature requests, please let me know.