Upgrading Tanium Appliance software

You can use TanOS to upgrade the TanOS system, the TanOS shell, and Tanium appliance role: Tanium Server, Module Server, Zone Server, and Zone Server Hub.

About Tanium Appliance software versions

The TanOS version is the version of the appliance operating system and menus. The appliance operating system is updated periodically to support new features and to support new Tanium Core Platform features.

The TanOS shell version is separate from the TanOS version. Shell updates are included in operating system rpm packages. When necessary to address issues, special shell updates can distributed as separate rpm packages.

The Tanium Core Platform version is the version of the platform server component. All components must run the same build version. The TanOS distribution includes installers for supported Tanium Core Platform versions. In Tanium Appliance deployments, support for a Tanium Core Platform release might require a TanOS upgrade.

Tanium Core Platform TanOS version required
7.2 1.2 or later, 1.3 recommended
7.1 1.2 recommended

Follow the upgrade paths indicated. Direct upgrade can result in unexpected behavior and is not supported.

Upgrade TanOS

Copy the upgrade package to the /incoming directory on the Tanium Appliance and then use the TanOS menus to install it.

Upgrade path

  1. Starting from TanOS 1.0.0-365.
  2. Upgrade the TanOS shell to 1.0.0-480.
  3. Use the TaniumTanOS_Upgrade-1.1.0-62.noarch.rpm upgrade file to upgrade to TanOS 1.1.0-420.
  4. Use the TaniumTanOS_Shell-1.0.0-541.noarch.rpm upgrade file to upgrade the TanOS shell to 1.0.0-541.
  5. Use the TaniumTanOS_Upgrade-1.2.0-46.noarch.rpm upgrade file to upgrade to TanOS 1.2.0.

    From TanOS 1.2.0, you can upgrade directly to TanOS 1.2.1 or TanOS 1.3.2.

  6. Optional. Use the TaniumTanOS_Upgrade-1.2.1.noarch.rpm upgrade file to upgrade to TanOS 1.2.1. If your target is 1.3.2, you can skip this step.
  7. Use the TaniumTanOS_Upgrade-1.3.2.noarch.rpm upgrade file to upgrade to TanOS 1.3.2.
  1. Starting from TanOS 1.2.x or 1.3.x.
  2. Use the TaniumTanOS_Upgrade-1.3.2.noarch.rpm upgrade file to upgrade to TanOS 1.3.2.

Upgrade TanOS

  1. Use SFTP to copy the TanOS upgrade file to the /incoming directory on the appliance.
  2. Log into the TanOS console as the user tanadmin.
  3. Enter B to go to the Appliance Maintenance menu.
  4. Enter 3 and then follow the prompts to complete the upgrade.

Upgrade the TanOS shell

Typically, the TanOS shell upgrades are included in TanOS operating system upgrades. It is possible that a TanOS shell upgrade package is delivered separately. If so, copy the upgrade package to the /incoming directory on the Tanium Appliance and then use the TanOS menus to install it.

Upgrade path

No dependencies, but the version should be in the range beginning with the version included with the TanOS release and ending with the last shell version before the next TanOS release. Upgrade only as necessary. Downgrade is not supported.

Upgrade the TanOS shell

  1. Use SFTP to copy the TanOS shell RPM file to the /incoming directory on the appliance.
  2. Log into the TanOS console as the user tanadmin.
  3. Enter B to go to the Appliance Maintenance menu.
  4. Enter 4 and then follow the prompts to complete the upgrade.

 

Upgrade Tanium server software

The server upgrade rpms are included in TanOS installation and upgrade packages. It is possible that a server upgrade package is delivered separately. If so, copy the upgrade package to the /incoming directory on the Tanium Appliance and then use the TanOS menus to install it.

Upgrade path

Check with your technical account manager (TAM) to understand the ramifications of direct upgrade and whether intermediate steps are recommended.

Before you begin

  • Read the release notes for all of the core platform software versions that were released after your current version to stay informed about expected behavior.
  • Your will let you know when upgrades are advised and can assist you with the upgrade.
  • YourTAM will provide the upgrade package files.
  • All servers must have the same version number (for example, 7.2.314.3181), so you must be ready to upgrade all Tanium servers in your environment.
  • Make sure the current deployment is working as expected.
  • Back up the database. See Backup the Tanium database.
  • Back up the appliance. See Back up to the alternate partition.

Upgrade the server software

  1. If necessary, use SFTP to copy the Tanium server RPM file to the /incoming directory on the appliance.
  2. Log into the TanOS console as the user tanadmin.
  3. Enter 1 to go to the Tanium Installation menu.
  4. Enter U to go to the software upgrade page. Follow the prompts to complete the upgrade.

Last updated: 8/13/2018 10:23 AM | Feedback