Skip to main content
You are viewing the documentation for Interana version 2. For documentation on the most recent version of Interana, go to


Interana Docs

Sandbox Deployment Guide: install required software

Now you'll need to install additional software that's required to run Interana. We'll install this on your new AWS instance. 

There are four things you need to install and configure before running the Interana installer:

  1. Log in to your AWS cluster: this is where you’ll be installing Interana and storing your data.

  2. Download the Interana software: this validates the software and metadata downloaded from Interana.

  3. Install MySQL: this is used to store Interana’s configuration information.

Log in to your AWS instance

First you'll need to log in to your AWS instance. Open a terminal window and type this at the command line, replacing your_key.pem with the name of the key you got from AWS and your_amazon_instance with your instance's Public DNS (IPv4) address that you copied earlier.

ssh -i your_key.pem

Troubleshooting tip!

If you get a “Permissions 0644 for ‘<your public key>’ are too open” error, you need to change the permissions of the key file. Type the following in the terminal window, then run the ssh login command again:

chmod 600 your_key.pem

Download the Interana Software

The the APT AWS S3 transport allows you to fetch files from the Interana private repository on AWS S3. You import a Gnu Privacy Guard (gpg) key so you can then securely download the Interana software from a trusted site.

To download the Interana software, do the following:

  1. Open a Terminal window and log into the VM. The following example uses the Ubuntu default username (ubuntu) and password (ubuntu). Use the login credentials established when you provisioned your VM. 
ssh ubuntu@<IP_address> 
password: ubuntu
  1. Install apt-transport-s3 so you can fetch files from the Interana private repository on AWS S3:
  1. Go to /etc/apt/s3auth.conf and configure the AWS credentials Interana provided you with for access to the Interana private repository. The following is an example of the credentials to be added.
AccessKeyId = AKIAyouraccesskeyidUZBA
SecretAccessKey = W18sR/ZrAT0WyoursecretaccesskeyVjOkg0DMl
Token = ''
  1. Import the gpg key by entering the following command.
wget -qO - | sudo apt-key add -
  1. To add an apt repository, enter the following command.
echo "deb [arch=amd64] s3:// trusty main" | 
sudo tee /etc/apt/sources.list.d/interana.list
  1. To refresh your package index with information about the latest version of the Interana software, enter the following command.
sudo apt-get update
Troubleshooting tip!

If you get an "unable to resolve host" error, you may have a problem with your AWS VPC settings. To fix this, open up the /etc/hosts file on your machine and a line with your IP address.

sudo vi /etc/hosts localhost ip-XXX-XX-X-XXX # add this line, but sub in your IP address
# The following lines are desirable for IPv6 capable hosts
::1 ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allroutersff02::3 ip6-allhosts

Install MySQL

Interana uses MySQL to store our configuration information (your data won't be stored in MySQL). You need to install this before installing Interana to give us a place to store the configuration information you'll set when you run the Interana installer. This step is necessary for all single node clusters OR only for the config node of your multi-node cluster.

Type this at the command prompt to start the MySQL installer:

sudo apt-get -y install mysql-server

Start by setting a password for the root user. There are no restrictions or requirements, but you'll need to remember it when you install Interana in the next section (Quick Start guide: install Interana). Type a password and press Enter. 

That's the only thing you need to do; now the installer will install MySQL.

Next: install the Interana software

After the installation is complete, it's time to install Interana!

  • Was this article helpful?