Skip to main content
Interania

Sandbox Deployment Guide: install Interana

After installing and configuring the required software, it’s time to download and run the Interana installer. This takes about 10 minutes to complete.

In this section, you will:

  1. Download and run the Interana installation software
  2. Install Nginx, another required application
  3. Start Interana
  4. Create an account: this is the admin account, and you'll use it to add data and run queries (described in the next sections)

Download and run the Interana installer

First, you'll need to download and run the Interana install program. 

To install Interana, first do one of the following:

  • To install the full Interana package that includes GPL-licensed software, enter the following command:
sudo apt-get -y install interana-cli interana
  • To install Interana without any GPL-licensed software, enter the following command:
sudo apt-get -y install --no-install-recommends interana-cli interana

If you already have interana fully installed and want to remove GPL-licensed software, use the following command:
sudo apt-get remove interana-python3-extra

The installer will then ask you for is the address of your MySQL server. Since you're creating a single-node install, you can use either localhost or 127.0.0.1. (If you were setting up a more complex,  multi-node installation, you'd need to be more specific about the various IP addresses.) 

Enter the MySQL username, which we configured to be root when we installed MySQL:

Next, enter the password that you set for the MySQL root user in the previous section:

Now the Interana installer asks you to configure the role for this node. Since you’re installing a single-node cluster, you want almost all of them (you don't need the listener node; it's used with more complex installations that use a continuous data ingest process).

Accept the default values and press Enter.

Now you've installed the main Interana software package, but there's one more piece of software to install: the software we use to build our user interface. 

Install Nginx

We use Nginx to run the Interana user interface.

Type the following in your terminal window to install Nginx: 

sudo apt-get -y install nginx-extras

That's it! There are no settings to configure for Nginx.

Start the Interana service

Now you’re ready to start Interana, so there's one more command to type in the terminal window: 

sudo service interana start

Create an account

Now that you’ve started Interana, open a web browser and create an account. Use Chrome or MS Edge to go to the IP of your cluster (you can find this in the AWS console) and follow the instructions to create an account.

The default username is root@localhost, and the default password is root.

Troubleshooting

Welcome to nginx!

If you see a “Welcome to nginx!” message in your browser instead of the Interana login prompt, go back to the terminal window line and type these two commands to remove a file that's keeping Interana from starting correctly:

cd /etc/nginx/sites-enabled
rm default

Now type ls -l and look for a file named default.something. Use this command to rename the file to default(but change default.something to the actual name of the file):

mv default.something default

Now restart Nginx (typesudo service nginx restart) and open your site’s URL from your browser again.

Invalid SSL certificate

If you see an invalid SSL certificate warning and want to fix it, see Implementing Let's Encrypt SSL with Interana for instructions about using Let's Encrypt to generate and use a free SSL certificate for your instance. 

Next: add your data

Congratulations! Now that you've installed Interana, it's time to add your data.

  • Was this article helpful?