Reference: Appliance Maintenance menu

Use the Appliance Maintenance menu to perform backups, system resets, TanOS upgrades, and system reboots or shutdowns.

Backup overview

There are several options to back up the Tanium Appliance. You can back up to an inactive partition on the appliance, perform minimal and full backups, and back up the Tanium database. For external backups (minimal, full, and database), you can schedule automatic backups or perform a manual backup. The following sections describe the available options:

TanOS contains the options to perform minimal and full backups, and to back up the Tanium database. Additionally, you can take snapshots of the virtual image. For external backups (minimal, full, and database), you can schedule automatic backups or perform a manual backup. The following sections describe the available options:

Backup types

Minimal backup

Back up key files that can help you quickly recover from failures. Perform a minimal backup after the initial configuration of your Tanium Appliance is complete. You do not have to stop Tanium services prior to a minimal backup.

On a Tanium Server appliance, the minimal backup includes the following:

  • Tanium public and private key files
  • Web server SSL certificates
  • Tanium Server configuration database
  • Tanium Downloader configuration database
  • Tanium license file

After the initial configuration completes, these files do not change frequently. A monthly minimal backup is sufficient.

TanOS saves the backup file to the /outgoing directory. Use SFTP to download the backup file.

Full backup

A full backup is a complete backup of the /opt/Tanium directory. You can completely restore the Tanium installation in the event of a hardware failure or corruption of the Tanium installation. This option takes a significant amount of time to complete and requires that you stop the services on the Tanium Appliance.

For Active-Active deployments, take the following steps to minimize downtime:

  1. Confirm that your database replication between your primary and secondary Tanium database is running successfully.
  2. Stop all Tanium services on your Tanium Server that hosts the secondary database (this includes the PostgreSQL service).
  3. Complete the backup.
  4. Start the Tanium services.

This process ensures that you have a backup of your entire Tanium installation, including the Tanium database, without the need to stop both Tanium Servers.

For environments with only a single Tanium Server, an outage is required while the backup runs.

For the Tanium Module Server, stop all Tanium services while the backup runs. During this time, users can still access Tanium and ask questions, but the module workbenches are unavailable until the Module Server restarts.

Partition sync

TanOS has two partitions: an active partition and an inactive partition for use in case of failover or troubleshooting. A partition sync is a backup procedure that uses the rsync utility to copy the active partition to the inactive partition.

In TanOS 1.6.1 and later, virtual appliances contain only one partition by default. Appliances with only one partition do not contain the option to perform a partition sync.

Perform a partition sync before you upgrade TanOS or a Tanium Server component, so that you have an alternate partition in case issues occur during the upgrade process or the Tanium Server update. You can also use the inactive partition if the active partition fails to boot. During the TanOS boot process, you have the option to select the inactive partition if needed.

Database backup

A database backup backs up the Tanium PostgreSQL database. In a new installation, an automatic backup is configured to back up the Tanium PostgreSQL database nightly at 2:01 AM (UTC). If the database fails, use the daily backups to restore the database to a known good state.

The backup automatically saves to the /outgoing directory. You can configure the backup to run at a different time, and you can also schedule daily retrieval of the database backup using sftp as the tancopy user.

Configure and run automatic backups

Use TanOS to configure and run automatic backups for the Tanium Appliance. Through TanOS, you can set up an automatic minimal backup, a full backup, and a database backup. The general process to set up an automatic backup includes the following steps:

  1. Add encryption keys for the backups.
  2. Configure the backup.
  3. Test the backup.
  4. Set the backup schedule.

Add encryption keys for the backups

Encrypt all full, minimal, and database backups with a key pair. Encryption is required for both automatic and manual backups.

  1. Use OpenSSL to generate a public/private key pair in a PEM file. Enter a passphrase when prompted.

    openssl genrsa -aes256 -out ssl-pvk.pem 3072

  2. Extract the public key from the PEM file. Enter your passphrase when prompted.

    openssl pkey -in ssl-pvk.pem -pubout -out ssl-pub.pem

  3. Extract the identifier for the public key. This identifier is visible in the backup file and can be useful to find a particular public key.

    openssl pkey -pubin -in ssl-pub.pem -outform DER | openssl dgst -sha1

  4. Copy the contents of the ssl-pub.pem file (the public key) to the clipboard.
  5. Log into the TanOS console as a user with the tanadmin role.
  6. Enter B to display the Appliance Maintenance menu. ClosedView screen
  7. Enter 1 to display the Backup menu. ClosedView screen
  8. Enter E, paste the public key from the clipboard, and press Ctrl-D.
  9. Press Enter to return to the Backup menu.
  10. To test the encryption, perform a minimal backup using the steps described in Perform a full or minimal backup.
    1. After the backup completes, download the backup file. Note that you are not prompted to set a password.
    2. Extract the backup file. The folder contains a README.txt file that describes how to decrypt the backup.

Configure an automatic backup

In a new installation, an automatic backup is configured to back up the Tanium PostgreSQL database nightly at 2:01 AM UTC. You can edit the database backup or configure automatic minimal and full backups.

  1. Log into the TanOS console as a user with the tanadmin role.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter 1 to display the Backup menu. ClosedView screen
  4. Enter C to configure an automatic backup. ClosedView screen
  5. Select the type of backup to configure:
    • To configure a minimal backup, enter N.
    • To configure a full backup, enter F.
    • To configure a database backup, enter T.
  6. Follow the prompts to enable the backup and to specify file transfer options.
    • Automatic backups always save the backup files to the /outgoing directory for download with SFTP.
    • You can specify a username and IP address for a destination server to reach with secure copy protocol (SCP). If you set up a file transfer with SCP, copy the public key of the user that you are using to configure the backup to the ~/.ssh/authorized_keys file on the remote system. Ensure proper privileges on the remote system; you may need to run CHMOD 600 on the ~/.ssh/authorized_keys file.

Test an automatic backup

  1. Log into the TanOS console as a user with the tanadmin role.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter 1 to display the Backup menu. ClosedView screen
  4. Enter A to display the Run Now menu. ClosedView screen
  5. Select the type of backup to run.
  6. Verify the backup settings and enter Yes to run the backup.
  7. Verify the backup completes successfully. ClosedView screen
    • If the backup exports to a remote server with SCP, log in to the remote server and verify the backup file exists.
    • Extract the backup file. The folder contains a README.txt file that describes how to decrypt the backup.

Schedule an automatic backup

  1. Log into the TanOS console as a user with the tanadmin role.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter 1 to display the Backup menu. ClosedView screen
  4. Enter S to display the Schedule menu. ClosedView screen
  5. Select the type of backup to view the schedule settings. The schedule settings include the current settings and the pending settings. ClosedView screen
    • Enter 1 to disable the backup.
    • Enter 2 to enable the backup.
    • Enter 4 to enter the days of the month to run the backup. You can enter a date range or comma-separated days.
    • Enter 5 to enter the days of the week to run the backup. You can enter a range or comma-separated values.
    • Enter 6 to select the time to run the backup. Enter the hours and minutes in UTC time.
    • To confirm the pending settings, enter 7 to activate the settings. The active settings update to match the pending settings.
    • If you enter R and not activate the settings, the changes do not save.

Configure and run manual backups

You must encrypt all full, minimal, and database backups with a key pair. Encryption is required for both automatic and manual backups. For steps on how to set up encryption, see Add encryption keys for the backups.

Perform a partition sync

In TanOS 1.6.1 and later, virtual appliances contain only one partition by default. Appliances with only one partition do not contain the option to perform a partition sync.

  1. Log into the TanOS console as a user with the tanadmin role.

    The TanOS console displays the tanadmin menu. ClosedView screen

  2. Enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter 1 to display the Backup menu. ClosedView screen
  4. Enter P to display the Partition Sync menu. ClosedView screen
  5. Follow the prompts to complete the backup.
  6. After the backup completes, press Enter to return to the Backup menu.

For information on how to change the active partition to the inactive partition, see Change the active partition.

Perform a full or minimal backup

Complete the following steps to perform a manual backup of the Tanium Appliance:

  1. Log into the TanOS console as a user with the tanadmin role.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter 1 to display the Backup menu.
  4. Use the menu to create a backup:
    • Enter N to display the Backup off-box minimal menu.
    • Enter F to display the Backup off-box full menu.
  5. Follow the prompts to confirm the backup and to specify file transfer options. You can save the backup file to the /outgoing directory for download with SFTP, and you can specify a username and IP address for a destination server that can be reached with secure copy protocol (SCP). ClosedView screen
  6. After the backup completes, press Enter to return to the Backup menu.

Back up the Tanium database

Complete the following steps to perform a manual backup of the database:

  1. Log into the TanOS console as a user with the tanadmin role.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter 1 to display the Backup menu.
  4. Enter T and follow the prompts to create a database backup. The backup is saved to the /outgoing folder.
  5. Use SFTP to copy the backup file from the /outgoing directory on the appliance to your management computer.

Manage Tanium database backups

To select a specific backup from the last 7 days, including manual backups, you can navigate to the List Tanium Database Backups menu.

  1. Log into the TanOS console as a user with the tanadmin role.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter 1 to display the Backup menu.
  4. Enter L to list the Tanium database backups.
  5. Follow the prompts to export, rename, or delete the backup.

Configure alerts

TanOS can send alerts to a syslog server or to an email recipient. For optimal results, configure an SMTP email recipient. If the syslog server fails, the SMTP recipient receives a failure notification every 15 minutes until the failure is resolved or syslog forwarding is disabled.

Configure alerts

Use the Configure Alerts menu to set the alert severity threshold to info, warn, or error.

  • Info: Includes all alerts
  • Warn: Includes all error and warning alerts
  • Error: Includes error alerts
  1. Log into the TanOS console as a user with the tanadmin role.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter 2 to display the Alerting menu. ClosedView screen
  4. Enter 3 to display the Configure Alerts menu. ClosedView screen
  5. Use the menu to set a severity level and enable/disable alerting.

Configure syslog destination

The syslog alert configuration is separate from the syslog configuration in the Appliance Configuration menu. This configuration sends alerts for the alert threshold severity. The syslog configuration in the Appliance Configuration menu sends all logs.

  1. Log into the TanOS console as a user with the tanadmin role.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter 2 to display the Alerting menu. ClosedView screen
  4. Enter 1 to display the Configure Syslog Destination menu. ClosedView screen
  5. Enter 2 and follow the prompts to configure a syslog destination. ClosedView screen
  6. Enter 1 to enable syslog alerts. The Configure Syslog Destination menu updates to show the current status. ClosedView screen
  7. Enter 3 to send a test alert to the syslog server.

The test alert appears in the syslog server logs.

Configure SMTP destination

  1. Log into the TanOS console as a user with the tanadmin role.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter 2 to display the Alerting menu. ClosedView screen
  4. Enter 2 to display the Configure SMTP Destination menu. ClosedView screen
  5. Enter 2 and follow the prompts to configure the SMTP destination. ClosedView screen
  6. Enter 1 to enable SMTP alerts. The Configure SMTP Destination menu updates to show the current status. ClosedView screen
  7. Enter 3 to send a test alert to the mail recipient.

Upgrade TanOS

See Upgrade TanOS.

Request a shell access key

You can request OS shell access to examine OS processes and files written to the file system. See Examine OS processes and files.

Clean up generated files

Clean directories to clear up disk space or clear logs to make it easier to work with new entries in the log viewer.

  1. Log into the TanOS console as a user with the tanadmin role.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter A to display the Clean directories menu. ClosedView screen
  4. Use the menu to delete files that have been generated in the SFTP /incoming and /outgoing directories, core dump files, application logs, and so on.

Reboot or shut down

Tasks that you complete with TanOS menus typically do not require you to reboot the system. A reboot might be required during troubleshooting workflows.

Shutdown turns off the system and powers down the appliance.

You must have physical access to the appliance to power it on. Do not perform a system shutdown unless you are prepared to power the appliance back on.

Reboot

  1. Log into the TanOS console as a user with the tanadmin role.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter B to display the Reboot/Shutdown menu. ClosedView screen
  4. Enter 1 to display the Reboot menu. ClosedView screen
  5. Follow the prompts to reboot the appliance.

Shut down

  1. Log into the TanOS console as a user with the tanadmin role.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter B to display the Reboot/Shutdown menu. ClosedView screen
  4. Enter 2 to display the Shutdown menu. ClosedView screen
  5. Follow the prompts to shut down the appliance.

Exit maintenance mode

Some maintenance procedures that you perform with TanOS menus prompt you to enter maintenance mode to ensure Tanium services are not affected by the maintenance operation. When the operation completes, exit maintenance mode to resume normal operations.

  1. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  2. Enter C to display the Maintenance Mode menu.
  3. Enter 1 to clear any maintenance actions.

Enable partitions

In TanOS 1.6.1 and later, virtual appliances contain only one partition set by default. On virtual appliances, you can add an alternate (inactive) partition set to use as a backup partition.

The option to enable partitions only displays if you have a single partition on a virtual appliance.

  1. If needed, modify the virtual image to add disk storage.

    This action is not reversible. Storage that you add to the appliance is permanently allocated. Do not attempt to remove disk storage from an appliance, as the appliance will become unusable.

  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter E and follow the prompts to enable alternate partitions.

Disable partitions

Use this option on virtual appliances to remove the alternate (inactive) partition set. Use this option if you do not need the alternate partition. After you remove the alternate partition set, you can allocate the unused storage to the primary partition.

Do not disable the alternate partition set with the intent to reclaim disk storage. Disk storage on the appliance is permanently allocated. Do not attempt to remove disk storage from an appliance, as the appliance will become unusable.

In TanOS 1.6.1 and later, virtual images contain only one partition set by default. If you upgrade from a previous version of TanOS, the existing partition configuration is preserved. This menu option only displays if your virtual appliance has an alternate partition set.

  1. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  2. Enter D and follow the prompts to remove all alternate partitions. ClosedView screen

Use the Increase storage option to reallocate the storage from the deleted partition set.

Increase storage

On virtual appliances, you can add a disk to the virtual image to increase the amount of available storage.

On a Tanium Cloud Appliance, you can add a disk to the virtual image to increase the amount of available storage.

This action is not reversible. Storage that you add to the appliance is permanently allocated. Do not attempt to remove disk storage from an appliance, as the appliance will become unusable.

  1. Modify the virtual image to add disk storage.
  2. From the tanadmin menu, enter B to display the Appliance Maintenance menu. ClosedView screen
  3. Enter I to display the Increase Storage menu. ClosedView screen
  4. Follow the prompts to add the disk storage. ClosedView screen

    If you have an inactive partition set, any new storage is evenly allocated across the active (/OPT) and inactive (/ALTOPT) partitions.