- Print
- DarkLight
- PDF
Insights On-Premises Prerequisites
- Print
- DarkLight
- PDF
The following article explains the prerequisites that are required before you deploy an Insights On-Premises (IOP) server.
You can set up the IOP appliance by either deploying an OVA file from a VMware vSphere Web Client, also known as a virtual appliance, or by running the installation scripts for IOP manually on a dedicated Linux server. Consider the following requirements regardless of the type of installation you choose.
Recommended Installation Types Based on Sessions
You can run IOP on a standalone machine or distributed in clustered environments. An IOP cluster consists of a master node responsible for managing the entire cluster, and one or more data nodes that store Insights data.
Depending on the total number of user sessions in your environment, you can choose to install either a single instance or a clustered environment. The number of sessions is a best practices recommendation to help you decide which deployment is best for your organization.
Standalone
Install a single, standalone server if your ControlUp environment runs 5000 or fewer sessions.
Cluster
Install a clustered environment if you have 5000 or more sessions. Each data node can serve up to 5000 sessions. For every additional 5000 sessions, you must set up a new data node.
Sizing Examples
You must install a master node and at least one data node per 5000 sessions.
Number of sessions | Number of Master Nodes | Number of Data Nodes |
---|---|---|
6 000 | 1 | 2 |
9 000 | 1 | 2 |
11 000 | 1 | 3 |
Minimum Hardware Requirements
CPU and Memory
Installation Mode | CPU Cores | RAM |
---|---|---|
Single (Standalone) | 12 | 12 GB |
Cluster Master Node | 12 | 32 GB |
Cluster Data Node | 8 | 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 For example tune2fs -m 1 /dev/sdb1 |
Master Node (Cluster) | SSD 100 GB (disk with at least 800 IOPs) | 50 GB (/var partition) ** The recommended file systems for the data volume are ext3, ext4 or xfs | |
Data Node (Cluster) | SSD 100 GB (disk with at least 800 IOPs) | 1 TB (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 For example tune2fs -m 1 /dev/sdb1 |
** if mounted on a different file system than OS partition
Network
A general ControlUp prerequisite is to make sure that all monitored servers can resolve their hostnames by DNS by creating the appropriate entries on your DNS server. Of course, this also applies to all IOP components, the standalone machine as well as the master and data nodes.
Additionally, 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 |
Port Usage
Ports | Traffic Source | Usage |
---|---|---|
443 | ControlUp Monitors | IOP user interface |
8088 | IOP users | HEC (Internal information on the ControlUp Monitors) |
8089 | Data nodes Master node ControlUp Monitors | Management port, connects master node and data nodes. |
9997 | ControlUp Monitors | Forwarder(s) sending data to data nodes. |
9887 | Data nodes | Data replication between the indexers in a clustered environment. |
For more information on general port requirements, see Communication Ports Used by ControlUp: On-Premises Mode.
For Linux-Based Installations
Installation Files
Contact us at support@controlup.com to receive the latest installation files for all on-premises components.
Supported Operating Systems
To install the IOP server on a Linux machine, you require one of the following supported Linux variants:
- Photon OS 4.0 or higher
- Ubuntu 20.04 or higher
Installed Software on the Linux Machine
Because the backend IOP components run on Docker, you must install the Docker runtime with version 20.10.14 or higher on your Linux machine. For instructions to install Docker on Linux, see Install Docker Engine.
.