Skip to main content
Interania

Quick Start 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. Import a gpg key: this is used to validate the software and metadata downloaded from Interana.

  3. Get the Interana software: this is required to run the Interana installation process.

  4. 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 ubuntu@your_amazon_instance.amazonaws.com

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

Import the Interana gpg key

Type this at the command line to import the Interana gpg key:

wget -qO - http://interana-apt-dev.s3.amazonaws.com/repo.key | sudo apt-key add -echo "deb [arch=amd64] http://interana-apt-dev.s3.amazonaws.com trusty main" | sudo tee/etc/apt/sources.list.d/interana.list

To be able to download the Interana software, you need to tell your AWS instance that place where we store the installation files is a trusted site.

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

127.0.0.1 localhost
127.0.1.1 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

Add the Interana apt repository

Back in the terminal window, type the following at the command line: 

echo "deb [arch=amd64] http://interana-apt-dev.s3.amazonaws.com trusty main" | sudo tee /etc/apt/sources.list.d/interana.list

Type this command to be sure that the installation program has the latest files:

sudo apt-get update

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.

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

  • Was this article helpful?