Insights On-Premise 8.1 Linux Based Installation

CentOS-01.png Ubuntu-01.png RedHat-01.png

The IOP component captures, indexes, and correlates real-time data in a searchable repository from which you can view a variety of dashboards build from graphs, vast amounts of reports, alerts, etc. The following are the prerequisites for an Insights server in the On-Premises topology.

ControlUp Insights On-Premise v8.1 has significant improvements in performance and user experience. This version of Insights is available in 2 installation modes:

  • "Virtual Appliance" - This option comes as an OVA that runs Photon OS Linux distribution.
    Currently Supported only on VMWare.
  • "Linux OS Installation" - This option allows you to install the IOP on varied Linux distribution.

To read more about IOP 8.1 Virtual Appliance Based Installation go to this article - Link

In IOP 8.1 we add a new component called "IOP Forwarder". This component is in charge of moving (forward) the Activity files from the Monitors servers to the IOP servers.

 Table of Content

  1. Insights On-Premise Pre-Requisites
  2. Insights On-Premise Installation
  3. Forwarder Installation

Insights On-Premise Pre-Requisites

You can install IOP 8.1 as a Single (Standalone) mode or as a Cluster mode for better performance in larger-scale environments.

  • Single (Standalone) - Recommended for companies with up to 5000 sessions, you need to prepare only one Linux server.
  • Cluster - Recommended for companies with 5000 sessions and more, in this variation you will need to prepare several Linux servers, 1 for the Master role and 1 Data role for every 5000 sessions.
    In cluster mode, you need to repeat the next chapters one time for the Master server and for each Data server.
    Sizing examples:
    # of Session # of Master nodes # of Data nodes
    6000 1 2
    9000 1 2
    11000 1 3

Sizing Recommendations

  • For Single (Standalone) installation Under 5000 Session
    • 12 Cores (Minimum)
    • 32 GB RAM
    • Storage:
      • 100 GB OS drive
      • 500 GB DATA disk drive with 800 IOPs (SSD preferred) mounted under /opt/iop_volumes/data/
  • For Clustered (Master and Data) installation Over 5000 Sessions
    • Master server
      • 12 Cores (Minimum)
      • 32 GB RAM
      • Storage:
        • 100 GB OS disk drive with 800 IOPs (SSD preferred)
    • Data servers (each)
      • 8 Cores (Minimum)
      • 16 GB RAM
      • Storage:
        • 100 GB OS drive
        • 1 TB DATA disk drive with 800 IOPs (SSD preferred) mounted under /opt/iop_volumes/data

Operation System

  • Linux Kernel 2.4
    • CentOS 7 (or above)
    • ubuntu 16.4 (or above)
    • Red Hat Enterprise Linux 7.6

Required Packages

  • Python 3.6
  • Docker 18.09.8 (or above)


  • We fully support Chrome browser and the New Edge (based on chromium)

Firewall Settings

The following ports need to be opened, depending on the installation mode.

Machine type
Inbound open ports


  • 443
  • 9997
  • 443
  • 8089


  • 9887
  • 9997
  • 8089

More information about each port:

Accept incoming traffic from
9997/tcp CU Monitors Forwarder(s) send data to the Data node(s).
443/tcp IOP users IOP UI.


  • Data nodes
  • Master node
  • CU Monitor

Management port - connects between the master node and the data node(s).

9887/tcp Data nodes Data Replication.

Insights On-Premise Installation

Checking the Pre-Requisites

Before you start the IOP installation, check if the pre-requisites were installed:

Check if the Python and the Docker are installed:

Note: The Syntax can be different between the Linux OS versions.

  • Connect to your Linux.
  • Type "python" and press twice on the "Tab" key
  • Run "docker -v"
  • If the components are not installed:
  • If the components installed:

If you don't have Docker installed, you can follow the instructions from one of the sites below:

  1. Docker - Docks
  2. Digitalocean

If the Linux OS is ready, you can start the IOP installation.

Copy files from Windows to Linux

  1. Download the IOP packaged to your Windows machine from here - Link
    • iop_forwarder-8.1.733.XX.msi
    • iop_8.1_images_stable.tgz
    • iopcmd-8.1.XXX.XX.tgz
  2. Copy iop_8.1_images_stable.tgz and iopcmd-8.1.733.XX.tgz to your Linux machine.
    • To copy files from Windows OS to Linx OS you can use the WinSCP tool.
    • Open the WinSCP tool and make a connection to your Linux.
    • Copy the files to your Linux user home folder.


Prepare the files for the Installation

  1. Log in to your Linux machine.
  2. Move the iop_8.1_images_stable.tgz and iopcmd-8.1.733.XX.tgz from the user folder to /opt folder.
    • sudo mv iop_8.1_images_stable.tgz /opt/
    • sudo mv iopcmd-8.1.733.37.tgz /opt/
  3. CD into “/opt/” directory.
  4. Extract the installation file
    • sudo tar zxvf iopcmd-8.1.733.37.tgz
  5. Move the iop_8.1_images_stable.tgz to “/opt/iopcmd/iop_images.tgz” 
    • sudo mv /opt/iop_8.1_images_stable.tgz /opt/iopcmd/iop_images.tgz
  6. CD into "/opt/iopcmd/" directory.

Installation Process

Before the installation there a few Important Notes for the Installation:

  1. Password:
    • Recommended putting a "Strong" password.
    • This is an Admin password for the IOP.
    • It will be used in the future for upgrades.
  2. After the installation is done, it is recommended to remove the iop_images.tgz from the /opt/iopcmd/ directory.
  3. When the installation is complete, you can connect to your Insights by browsing to https://<Server_IP>

Single (Standalone) Installation

  1. Run the Install command.
    • sudo ./iopcmd install local -t standalone -pwd <Your Password>
    • For example:
    • sudo ./iopcmd install local -t standalone -pwd abc123
  2. Wait till the installation is finished.

Cluster Installation

  1.  Run the Install command on the Master server
    • sudo ./iopcmd install local -t master -pwd <Your Password>
    • For example:
    • sudo ./iopcmd install local -t standalone -pwd abc123
  2. Wait till the installation is finished. 
  3. Run the Install command on the Data servers

    • sudo ./iopcmd install local -t data -m <DNS name or ip address of Master> -pwd <Your Password>
  4. Wait till the installation is finished. 

Forwarder Installation

The Forwarder is a component that forwards the activity files from Monitors servers to the IOP servers.

Durning the ControlUp On-Premise Installation you choose where to put the "Activity Files".
If you choose a local folder, then you need to install the IOP Forwarder on each Monitor. If you choose a shared location, you need to install only one IOP Forwarder.

Steps for the Installation of Forwarder:

  1. Login to your Monitor windows machine.
  2. Download the Forwarder from here - Link (if you didn't download that in the beginning)
  3. Run the “iop_forwarder_8.1.733.XX.msi” file:
  4. Specify where to install the forwarder (on the Monitor machine).
  5. Choose the type of installation accordingly to the type of Insights installation.
  6. Select the "Activity Files" folder location.
    Enter the IP of your IOP Server machine.
  7. Install the forwarder.
Powered by Zendesk