This document demonstrates how to install Interana using an Amazon Machine Image (AMI) in the Amazon Elastic Compute Cloud (Amazon EC2).
About Amazon EC2 and AMIs
Amazon Linux is a stable, secure, and high-performance execution environment for applications running on Amazon EC2. Amazon EC2 provides scalable computing capacity in the Amazon Web Services (AWS) cloud. You can use Amazon EC2 to launch as many virtual servers, or instances, as needed.
Amazon Machine Image (AMI) is a Linux image that is supported and maintained by AWS. Each AMI is a preconfigured template that packages the required bits for a virtual server, including the operating system and any necessary additional software. The recommended Interana AMI instance is a specialized configuration of CPU, memory, storage, and networking capacity, that you can modify, as needed.
Before you begin
To complete this procedure you must have an AWS account. If you don't already have an account, go to https://aws.amazon.com/ and click Create an AWS account.
You'll need more processing power and space to run Interana than is available from a free AWS account. Based on Amazon's calculator, it will cost approximately $300 per month to run your Interana instance (based on pricing for Amazon US-East).
For more information, see Sandbox Deployment Guide: create an AWS instance.
The procedure for installing an Interana single-node AMI includes the following steps:
- Log in to AWS and select an instance.
- Configure instance details.
- Add storage.
- Add tags.
- Configure Security group.
- Review and launch the instance.
- Add a domain.
- Register the account.
1. Log in to AWS and select the Interana instance
In this step, you log in to your AWS account, navigate to EC2 and select the Interana AMI instance. NOTE: In 2.24, the Interana AMI is private, so you will have to request access by contacting firstname.lastname@example.org.
To select the Interana AMI instance, do the following:
- Log in to the AWS Console.
- In the AWS Services field, search for EC2.
- Click Launch Instance to begin creating a new instance.
- Click My AMIs and search for interana-demo.
- Click Select to choose the AMI.
- On the Choose an Instance Type page, select the check box on the left for the desired instance.
- In the lower right corner, click Configure instance details.
2. Configure instance details
You've selected an AMI instance and are now ready to configure the details for your Virtual Private Cloud (VPC).
To configure the instance details, do the following:
- On the Configure instance details page, specify the necessary details for the instance.
- Specify the details for Network interfaces.
- To add another network interface, click Add device and specify the necessary details.
- Click Add storage.
3. Add storage
This section demonstrates how to add storage capacity to the instance and specify device settings. You can attach additional EBS volumes and instance store volumes, or edit the settings of the root volume. You can also attach additional EBS volumes after launching an instance, but not instance store volumes.
To add storage to an instance, do the following:
- On the Add Storage page, specify the storage Size (GiB), or accept the default.
- Select a Volume Type from the drop-down list, or accept the default.
- Accept the default Delete on Termination option, or deselect to retain on termination.
- To add more storage capacity, click Add New Volume. A new row appears below, showing options for the new volume.
- Specify the settings for the new volume.
- Click Add Tags.
4. Add tags
A tag consists of a case-sensitive key-value pair. A tag can be applied to volumes, instances or both. Tags are applied to all instances and volumes.
To add tags to your volumes and instances, do the following:
- On the Add Tags page, click Add tag.
- Enter a Key and Value string (up to 127 characters each) in each respective field.
- Accept the default of the tag being applied to all Instances and Volumes, or deselect the options to limit how the tag is applied.
- To add another tag, click Add another tag. and repeat steps 1-3. You can apply up to 50 tags.
- Click Configure security group.
5. Configure security group
A security group controls the traffic for your instance. You add rules to allow access for specific traffic. For example, you may want to add rules that allow unrestricted access to HTTP and HTTPS ports, so a web server can reach your instance. You can create a new security group or select an existing one.
To configure a security group, do the following:
- To create a new security group (default), specify the following:
- Security group name
- Port range
- To apply a rule, click Add rule and specify the parameters.
- To select a security group, click Select an existing security group and make a selection from the list that appears.
- Click Review and launch.
6. Review and launch the instance
You can view and edit your instance details on the Review and Launch page.
To review and launch your instance, do the following:
- Expand and review the details of each detail group.
- Click the Edit link on the right to make changes to the details.
- When you're satisfied with the instance details, click Launch.
7. Add a domain
Now that you've created an AMI instance, you can add a domain.
To add a domain to your AMI instance, do the following:
- Open a terminal window and ssh to the instance.
- Get a token with the following command.
ia config --unsafe <instance_IP_address>
- Open a browser, point to the Public DNS Name, and login: root / root
- Open the URL to get a token and paste it at the prompt.
- Add a domain with the following command.
ia email-domain add --unsafe <domain_name>
8. Register the account
This section demonstrates how to register and get an Interana account.
To register for an Interana account, do the following:
- Open a browser and point to the Public DNS Name.
- Click Don't have an account.
- Enter your email address and a password.
- Re-enter the password, and click Sign Up.
- Check your email and click the activation link.
- Make yourself an admin (user role).
- Delete the root@localhost user.
Congratulations! Now that you've installed Interana, you can add your data.