Requirements
Learn about the requirements to run Enginsight on-premise on your own servers.
Please note that we orchestrate our services using Docker. For this reason, it is important that only the Enginsight Docker instances run on the servers. Changes to the setup configuration in the docker-compose.yml file can lead to unpredictable side effects.
We strongly recommend that you use the Linux image versions we have identified, as we are unfortunately unable to support special custom builds!
Furthermore, only Debian-based systems are supported. Any deviations from our documentation, such as unauthorized changes to the configuration, changes to the setup or the addition of further services on the server, cannot be supported by us.
Virtual machines (VM)
as an Application Server
as an Database Server
for the Observer/Watchdog/Hacktor
Remote support (in case of installation by Enginsight Support)
Capabilities
Application Server
The application server is used to operate the central API, the user interface and other services of the platform.
Monitoring of up to 500 servers and clients with Pulsar Agent
Operation System | Debian 11, 64bit |
---|---|
CPU | 4 Cores |
RAM | 8 GB |
Mass storage | 200 GB (SSD recommended) Best Practice: Create a common partition for the entire system |
Connectivity | Inbound: Port 80 (Redirect to 443 + Let’s Encrypt) and Port 443 Outbound: Port 27017 to Database Server and Port 80 & 443 to the servers which are listed in the firewall rules |
Monitoring of more than 500 servers and clients with Pulsar Agent
If your on-premises instance monitors more than 300 servers and clients with the Pulsar agent, you should consider the possibilities of load balancing on multiple application servers. If you have more than 500 Pulsar agents installed, load balancing across multiple application servers is necessary.
Maximale Anzahl an Pulsar-Agents | Number of application servers |
---|---|
500 | 1 virtual machine |
1000 | 3 virtual machines |
2500 | 8 virtual machines |
5000 | 16 virtual machines |
10000 | 32 virtual machines |
If you want to use the Shield module to block network attacks, you should have more performance reserves. The required performance depends on how many events occur. Therefore, you should introduce Shield in several steps and observe the performance in monitoring to be able to scale up in time if necessary.
Make sure that the following external addresses are reachable and not blocked by firewall rules:
registry.enginsight.com
get.enginsight.com
registry-auth.enginsight.com
Please make sure that access via SSH is possible or VMware Tools are installed.
Database Server
The database server stores all monitoring data and communicates exclusively with the application server.
Operation System | Debian 11, 64bit |
CPU | 4 Cores |
RAM | 4 GB |
Mass storage | 100 GB (SSD recommended) in the directory \var |
Connectivity | Inbound: Port 27017 for Enginsight Application-Server Outbound: Port 80 & 443 to the servers which are listed in the firewall rules |
Please make sure that access via SSH is possible or VMware Tools are installed.
Observer/Watchdog/Hacktor
For the software components Observer, Hacktor and Watchdog you may need additional VMs. The individual software components can be operated together on one system, but separate operation is recommended. In case of shared operation, the resources have to be doubled.
These are minimum requirements. Upgrade the instances with more power so that the software components have more performance reserves.
One observer with the specified resources can take over the monitoring of up to 50 endpoints. For endpoints, note the option to define parallel processing of endpoints. The default setting is "2". Depending on the performance reserves, you can adjust the setting down or up. You also have the option to assign multiple observers to the same region, so that the observers share the monitoring of the endpoints among themselves.
Consider also the options for the Configuration of the Hacktor software component, especially the possibility to increase the Number of parallel scans.
Operating System | Linux: Debian 9/10/11, CentOS 7/8, no Windows AMD64 and ARMv7/ARMv8 |
CPU | 2 Core / 4 Cores (for shared operation) |
RAM | 2 GB / 4 GB (for shared operation) |
Mass Storage | 20 GB / 50 GB (for shared operation) |
Connectivity | Outgoing: Port 80 resp. 443 |
Number of maximum processes ( | Minimum: 20,000 Best practice: unlimited |
Please make sure that access via SSH is possible or VMware Tools are installed.
Firewall rules
Please release the following ports in the firewall:
Server | outgoing | incoming |
---|---|---|
APP / DB / COMP / SIEM | 80/443 | |
DB | 27017 (only from App Server, SIEM Management Server) | |
APP | 443 | |
if LetsEncrypt is used: APP / SIEM MANAGEMENT | 80 |
If your instance is not encrypted, the APP server must also be accessible via 80 and 8080. This is not recommended! Also, please make sure that all servers reach your DNS.
Furthermore, the following domains must be reachable from the servers:
All servers:
Debian mirror selected during installation (default: deb.debian.org)
APP server:
registry.enginsight.com
get.enginsight.com
registry-auth.enginsight.com
github.com
download.docker.com
raw.githubusercontent.com
dls.enginsight.com
registry-1.docker.io
Database:
repo.mongodb.org
www.mongodb.org
Certificate
To ensure that network traffic between the sensors (Pulsar Agent, Observer, Watchdog, Hacktor) and the Enginsight API is encrypted, you need an SSL/TLS certificate. As a best practice, we recommend a public certificate (e.g. from Let's encrypt) that you resolve internally.
Use a reverse proxy (external or on the server itself) that forwards requests to port 80 (app) and port 8080 (API).
For a smooth operation of the Enginsight application, the call via HTTPS is mandatory.
For the operation of the standard installation we recommend two DNS names:
ngs-api.your-domain.com
ngs-app.your-domain.com
Please make sure that the certificate is in PEM format.
Docker Credentials
To run Enginsight on-premises, you need Docker credentials, which you can get from us.
Just contact us via email: hello@enginsight.com.
Licence File
You can purchase the necessary license file directly from us.
Just contact us via email: hello@enginsight.com.
Remote support
If you want to install Enginsight on-premises with assistance from our support, please make sure that a remote control option is available. In our experience, TeamViewer works the most reliably.
Last updated