doc/man8/untangle-https-backup.8

   1 .TH untangle\-https\-backup 8
   2
   3 .SH NAME
   4 untangle\-https\-backup \- Back up Untangle configurations via the web admin UI
   5 .SH SYNOPSIS
   6 \fBuntangle\-https\-backup\fR [\fB\-\-config\-file <INI file>\fR] [\fB\-hb\fR]
   7 .SH INPUT
   8 .P
   9 None; the program's behavior is entirely determined by its
  10 configuration (INI) file.
  11 .SH OUTPUT
  12 .P
  13 Errors are output to \fIstderr\fR; otherwise, silence is golden.
  14 .SH DESCRIPTION
  15 .P
  16 The Untangle web UI provides a way to create backups of the local
  17 configuration. However, if you manage enough Untangle installations,
  18 it becomes impractical to log in to each one and navigate to the
  19 backups in a browser. The untangle\-https\-backup program automates that
  20 process for a list of installations contained in a configuration file.
  21 .P
  22 By default, the INI-style configuration file is located at
  23 /etc/untangle\-https\-backup.ini, but that can be overridden by the
  24 \fB\-\-config\-file\fR option.
  25 .SH CONFIGURATION FILE
  26 The configuration file is an INI-style list of Untangle installations
  27 to back up. An example entry is,
  28
  29 .nf
  30 [Test installation]
  31 host = 192.168.1.100
  32 username = testuser
  33 password = hunter2
  34 .fi
  35
  36 There are currently five parameters that may be set for each installation:
  37
  38 .IP \fBhost\fR\ (required)
  39 The hostname or IP address where the Untangle web UI is available.
  40 .IP \fBusername\fR\ (required)
  41 The Untangle admin username.
  42 .IP \fBpassword\fR\ (required)
  43 The Untangle admin password.
  44 .IP \fBversion\fR\ (default:\ \fI11\fR)
  45 The version of Untangle running on this host. Currently only \fI9\fR
  46 and \fI11\fR are supported.
  47 .IP \fBverify_cert\fR\ (default:\ False)
  48 Whether or not to verify the site's SSL certificate, either
  49 \fITrue\fR or \fIFalse\fR.
  50 .SH EXAMPLES
  51 .P
  52 It is difficult to invoke untangle-https-backup incorrectly:
  53
  54 .nf
  55 .I $ untangle\-https\-backup
  56 .fi
  57
  58 Show the usage information:
  59
  60 .nf
  61 .I $ untangle\-https\-backup \-\-help
  62 .fi
  63
  64 Specify an alternate configuration file:
  65
  66 .nf
  67 .I $ untangle\-https\-backup \-\-config\-file /etc/foo.ini
  68 .fi
  69 .SH OPTIONS
  70
  71 .IP \fB\-\-config\-file\fR,\ \fB\-c\fR\ (default:\ \fI/etc/untangle\-https\-backup.ini\fR)
  72 Path to the configuration file.
  73 .
  74 .SH BUGS
  75 .P
  76 Send bugs to michael@orlitzky.com.