michael orlitzky

untangle-https-backup

get it

The development version can be found in the untangle-https-backup git repository. The latest official release is untangle-https-backup-0.0.7.

What is it?

The Untangle web UI provides a way to create backups of the local configuration. However, if you manage enough Untangle installations, it becomes impractical to log in to each one and navigate to the backups in a browser. The untangle-https-backup program automates that process for a list of installations contained in a configuration file.

An example configuration file is provided.

Usage

user $ untangle-https-backup [--config-file <INI file>]

Input

None; the program's behavior is entirely determined by its configuration (INI) file.

Output

Errors are output to stderr; otherwise, silence is golden.

Configuration file

The configuration file is an INI-style list of Untangle installations to back up. An example entry is,

1
2
3
4
[Test installation]
host = 192.168.1.100
username = testuser
password = hunter2

There are currently five parameters that may be set for each installation:

host (required)
The hostname or IP address where the Untangle web UI is available.
username
(default: admin) The Untangle admin username.
password (required)
The Untangle admin password.
version
(default: 12) The version of Untangle running on this host. Versions 9, 10, 11, and 12 are supported.
verify_cert
(default: False) Whether or not to verify the site's SSL certificate, either True or False.

Examples

It is difficult to invoke untangle-https-backup incorrectly:

user $ untangle-https-backup

Show the usage information:

user $ untangle-https-backup --help

Specify an alternate configuration file:

user $ untangle-https-backup --config-file /etc/foo.ini

Options

--config-file, -c
(default: /etc/untangle-https-backup.ini) Path to the configuration file.

How to report bugs

Email them to me at michael@orlitzky.com.