Skip to main content
Interania

Admin Guide: Install the Interana CLI

0votes
11updates
131views

This page walks you through the process of installing and configuring the Interana command line interface (CLI) on a local system, so you can manage remote clusters from one location.

Before you begin

 Make sure your local system meets the following requirements:

Linux Mac 
Ubuntu 14.04 Mac OS X 10.8 or later

Python  (Included with Linux)

Python (Included with Mac OS)

Terminal window Terminal window
sudo privileges sudo privileges

Installation overview

You can install and configure the Interana CLI with the following steps. Click a step to jump to the walkthrough instructions.

  1. Install the Interana CLI.
  2. Configure the Interana CLI.

1. Install the Interana CLI.

In this step, you install the Interana CLI on the system on which your are logged in. 

To install the Interana CLI, do the following:

In a shell window, type the command:

sudo pip2 install interana-cli

2. Configure the Interana CLI.

Before you can use the Interana CLI, it must be configured. This step walks you through the process of configuring the CLI in either of the following ways:

  • Default cluster — Configure the login credentials for the default cluster on which Interana has been provisioned and installed. This allows you to manage the cluster remotely with the CLI.
  • Mulitple clusters — Configure the login credentials for the clusters on which Interana has been provisioned and installed, and save the authentication profile under the specified cluster name. This allows you to manage multiple Interana clusters remotely with the CLI from one system. 

Interana must already be installed and provisioned on a cluster, or clusters, to be managed with the CLI. For more information, see the installation chapters of the Admin Guide.

Default cluster configuration

Before you begin, you must have login credentials for the cluster to be managed with the CLI and know the cluster URL. The HTTPS URL uses the fully qualified domain name (FQDN) of the instance to configure a connection with the cluster.

To configure the CLI to manage the default cluster, do the following:

  1. In a shell window, type the following command.
ia config https://<default-cluster-address.com>

You receive a response similar to the following:

Visit https://mycluster.interana.com/api/create_token and supply your new API token.
  1. Click https://mycluster.interana.com/api/create_token, and you receive a generated token similar to the following.

  1. Enter the token value as it appears (between the "") when you are prompted for the API key, and then press Enter. You are notified that the credentials are configured.
Enter API Key: <pasted token value is not visible>
 
Success! Credentials stored as default config
  1. You can begin using the Interana CLI. For more information, see the Interana CLI Reference.

Multiple cluster configuration

You can configure the Interana CLI to run on multiple clusters. This allows you to manage the clusters remotely from one system. 

Perform this procedure for each Interana cluster you want to manage remotely.

With multiple cluster configuration process, you save the authentication profile under the specified cluster name. You do this using the --instance-name option in conjunction with the cluster URL to specify the cluster on which the CLI is to be configured. 

To configure the CLI to manage multiple clusters, do the following:

  1. In a shell window, type the following command.
ia config https://<mycluster2.address.com> --instance-name <cluster2_name>

You receive a response similar to the following:

Visit https://mycluster.interana.com/api/create_token and supply your new API token.
  1. Click https://mycluster.interana.com/api/create_token, and you receive a generated token similar to the following.

  1. Enter the token value as it appears (between the "") when you are prompted for the API key, and then press Enter. You are notified that the credentials are configured.
Enter API Key: <pasted token value is not shown>
 
Success! Credentials stored as default config
  1. You can begin using the Interana CLI. For more information, see the Interana CLI Reference.
  • Was this article helpful?