Skip to main content

How to upgrade my instance of Interana

This applies tov2.20


After completing this how-to you will have upgraded to the latest version of Interana.  NOTE: This guide applies to all Interana upgrades up to and including 2.20.

First Step - Download the build

  1. SSH into your Interana instance: ssh ubuntu@<your instance IP address>
  2. Navigate to the interana directory: cd interanaNOTEIf this is the first time you're upgrading this instance, start by creating the interana directory (mkdir interana) and then navigate to it.

  3. Get the latest build from Filer. Go to, find the URL for the release you want, then: wget <file URL> Tip: Make sure that an file with the same name doesn't exist in the folder before you get the new file.

Second Step - Prepare your upgrade

  1. Expand the archive: tar xvfz <interana file>
  2. Copy the SQL database connection information: cp /opt/interana/backend/config.yml backend
  3. Make the tmp directory.  (mkdir backend/deploy/tmp)
  4. Navigate to the tmp directory: cd backend/deploy/tmp.  
  5. Copy the file tiers.json.localhost from git (  Note: this is a one-time operation
    1. Copy the file (or rename it) as tiers.json
    2. Edit tiers.json and change the username (to "ubuntu") and the ssh_key_path (to "/home/ubuntu/.ssh/cluster-bender/ubuntu").
  6. If you had a previous copy of ~backend,  copy tiers.json from the old/tmp to the new backend directory: cp interana.old/backend/deploy/tmp/tiers.json backend/deploy/tmp/
    Navigate to interana/backend/deploy


Third Step - Run your upgrade

  1. Run the script to validate the instance's connections: ./
  2. Run the third party installation script: ./
  3. Run the upgrade script: ./

What's Next


  1. To enable the A/B Test view:
    1. Run the following command:/opt/interana/third_party/bin/ -u nobody -pti
    2. At the MariaDB command line, enter the following: insert into cluster_config.application_settings values ('webapp', 'showABTestView' , '"true"');
    3. Type exit to return to the command line.

You are now running the latest version of Interna.

  • Was this article helpful?