---
title: "Insights On-Premises Prerequisites"
slug: "insights-on-premises-prerequisites"
updated: 2024-07-15T11:12:06Z
published: 2024-07-15T11:12:06Z
canonical: "support.controlup.com/insights-on-premises-prerequisites"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.controlup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Insights On-Premises Prerequisites

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](/v1/docs/communication-ports-used-by-controlup-on-premises-mode).

## For Linux-Based Installations

### Installation Files

Contact us at [support@controlup.com](mailto: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 5.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.](https://docs.docker.com/engine/install/#server) .