Insights On-Premises Linux-Based Installation - Version 8.5

The Insights on-premises (IOP) component captures, indexes, and correlates real-time data in a searchable repository from which you can view a variety of dashboards, graphs, reports, alerts, etc.

IOP is a Linux-based application that can be installed in two different ways:

  • Virtual Appliance: This option includes the deployment of an OVA file that runs the Photon OS distribution. This installation option is currently available for VMware only. 
  • Linux OS installation: This option allows you to install IOP on a separate Linux machine. It means, you install one of the supported Linux distributions and we provide you the necessary installation files.

This installation guide assumes that you want to use the Linux-based installation of IOP 8.5. If you want to install IOP from an OVA file, refer to the Insights On-Premises Virtual Appliance-Based Installation - Version 8.5 installation guide.

Prerequisites

Session-based Installations

  • Single (Standalone): The recommended server installation for environments with 5000 or fewer sessions. In this case, you only need 1 Linux server. 
  • Cluster: This option is recommended for environments with 5000 or more sessions. As this is a clustered environment, at least 2 Linux servers must be used, one for the master node, the other for the data node(s). Each data node should serve up to 5000 sessions. It means that for every 5000 sessions, you need to set up a new machine for the data node. 

Sizing examples

Number of sessions Number of Master Nodes Number of Data Nodes
6 000 1 2
9 000 1 2
11 000 1 3

CPU / RAM

Minimum requirements for CPU and memory

Installation Mode CPU Cores RAM
Single (Standalone) 12 Cores 32 GB
Cluster Master Node 12 Cores 32 GB
Cluster Data Node 8 Cores 16 GB

Storage

Installation Mode OS Volume Data Volume Notes
Single (Standalone) SSD 100 GB 500 GB (disk with at least 800 IOPs)

50 GB (/var partition) **


The data must be mounted under /opt/iop_volumes


If ext3 or ext4 are chosen for the data volume, the “Reserved block percentage” should be set to 1%, using the following command (as root): tune2fs -m 1 <FILESYSTEM-PATH>. For example: tune2fs -m 1 /dev/sdb1

Cluster Master Node SSD 100 GB (at least 800 IOPs) 1 TB (disk with at least 800 IOPs)

50 GB (/var partition) **

The recommended file systems for the data volume are ext3, ext4 or xfs

 

Cluster Data Node SSD 100 GB (at least 800 IOPs)  

50 GB (/var partition) **

 

The data must be mounted under /opt/iop_volumes

 

If ext3 or ext4 are chosen for the data volume, the “Reserved block percentage” should be set to 1%, using the following command (as root): tune2fs -m 1 <FILESYSTEM-PATH>. For example: tune2fs -m 1 /dev/sdb1

 

** if mounted on a different file system than OS partition

Network

The following ports must be open on your IOP server:

Machine Type Protocol Port
Standalone TCP

443

8089

9997

Master Node TCP

443

8089

Data Node TCP

9887

9997

8089

For more information on general port requirements, see the Communication Ports Used by ControlUp: On-Premises Mode article.

Recommended Operating Systems

To install the IOP server, you will need to have one of the following supported Linux variants:

  • Photon OS 3.0
  • CentOS 7 (or above)
  • Ubuntu 16.4 (or above)
  • Red Hat Enterprise Linux 7.6

Installed Software

Some of our backend components run Docker containers, so you need to install Docker 18.09.08 or above on your Linux machine. Installation instructions for Docker on Linux can be found here.

IOP Installation

For the installation of the IOP server on your Linux machine, you need 2 files that are provided by our Support Team:

  • iopcmd-[version].tgz (for example iopcmd-8.5.733.34.tgz)
  • iop_[version]_images_stable.tgz (for example iop_8_5_images_stable.tgz)

The installation steps of both environment types, standalone or clustered, are explained below. 

Installation on a standalone machine

To install IOP on your standalone machine:

  1. Download the iop_[version]_images_stable.tgz and iopcmd-[version].tgz to your Windows machine. 
  2. Copy both files to the /opt/ directory on your Linux machine. For this, you can use WinSCP or any other software of your choice. 
  3. Login to your Linux machine and move both files to /opt
    sudo mv iop_8.5_images_stable.tgz /opt/
    sudo mv iopcmd-8.5.733.34.tgz /opt/
  4. Extract the iopcmd-8.5.733.34.tgz file to /opt. This will create a new directory "iopcmd" and 2 files, iopcmd and iopcmd.conf. 
    sudo tar zxvf iopcmd-8.5.733.34.tgz
  5. Move the iop_8.5_images_stable.tgz file to /opt/iopcmd/ and rename the file to iop_images.tgz:
    sudo mv iop_8.5_images_stable.tgz /opt/iopcmd/iop_images.tgz
  6. Start the installation script. As this is a standalone installation, use the -t standalone parameter and choose a strong password, in our case P@ssw0rd
    sudo ./iopcmd install local -t standalone -pwd P@ssw0rd -p iop_images.tgz

    After some minutes, the installation is completed:

    InstallationComplete.png

    Note: The password must be at least 8 characters in length. Use a strong password with special characters as this is the admin password for your IOP environment. The password is also necessary for any upgrades, so make sure you don’t lose it.

Installation of a clustered machine

If you decide to use a clustered environment, repeat Steps 1-3 on each cluster node. Pay attention to Step 8 which uses a slightly different command for cluster and data node. 

  1. Download both files iop_[version]_images_stable.tgz and iopcmd-[version].tgz to your Windows machine. 
  2. Copy both files to the /opt/ directory on your master node. For this, you can use WinSCP or any other software of your choice. 
  3. Log in to your master node and change to the /opt/ directory.
    cd /opt/
  4. Move the iop_[version]_images_stable.tgz to /opt/iopcmd/iop_images.tgz.
    sudo mv /opt/iop_8_5_images_stable.tgz /opt/iopcmd/iop_images.tgz
  5. Log in to your data node and change to the /opt/ directory.
    cd /opt/
  6. Move the iop_8_5_images_stable.tgz to /opt/iopcmd/iop_images.tgz by running the following command:
    sudo mv /opt/iop_8_5_images_stable.tgz /opt/iopcmd/iop_images.tgz
  7. Make sure that you currently are in the /opt/iopcmd directory. Run the following command on the master node:
    sudo ./iopcmd install local -t master -pwd <Your Password> -p iop_images.tgz
  8. Run the following command on each data node
    sudo ./iopcmd install local -t data -m <DNS name or IP address of the Master Node> -pwd <Your Password> -p iop_images.tgz

Once the installation is complete, the message “Install Complete!” appears in the installation prompt. 

Congratulations! You have promoted your Linux server to a new IOP server. To test connectivity with the new server, browse to https://<IPofIOPServer> and wait for the login screen of IOP. 

mceclip0.png
Sign in with the admin user and use the password that you defined in the installation script. 

mceclip1.png

After you successfully logged in, you should see the home screen of Insights:

mceclip2.png

1-on-1 Demo
Schedule now
Price Quote
Get it now
Need a Script?
Get it here
Powered by Zendesk