Manual Installation
Last updated
Was this helpful?
Last updated
Was this helpful?
Check system for application server, database server, and software components.
Get approved to receive Enginsight and request Docker credentials. Email .
Database server
Install .
(especially set up replica set).
Application server
Install .
Install .
Install .
Set up the .
.
Take care of securing via .
Configure your On-Premises instance.
Roll out the as sensors.
Make sure that the latest version of Docker Compose is always installed. In addition, do not install Docker via Snap or when installing the operating system, but only install Docker from the package sources in the official instructions.
1.Make sure that you have root privileges. If this is not the case, log in as superuser.
2. Start MongoDB if it does not start automatically.
3. Open the file /etc/mongod.conf
in an editor of your choice, for example nano
.
4. Change the net section as follows so that MongoDB is accessible from outside.
5. Set up the replica set as follows to allow the database to push information to the API.
Save the configuration file (Ctrl+o) and confirm the saving process. Close nano (Ctrl+x).
If the database is not running in replica mode, many Enginsight functions will not work correctly.
6. Restart MongoDB.
7. Open the MongoDB CLI.
8. Activate the replica set. For <public DB IP>
, enter the IP of the database server that can be reached from the application server.
9. Check if the replica sets are active.
If the configuration is correct, you will see the prompt after executing the command:
10. Close the Mongo interface.
11. Secure the database with iptables.
This step is important to ensure the security of the Enginsight software. It results in only the application being able to access MongoDB. Unauthorized access is prevented.
Replace <APP IP>
with the application server IP reachable from the database. Replace <DB IP>
with the IP of the database server reachable from the application.
12. Save the rules and make sure they are loaded at every restart.
Make sure that you have root privileges. If this is not the case, log in as superuser.
Make sure that you have the latest version of Docker and Docker Compose installed.
Do not install Docker via Snap or when installing the operating system. Only install Docker from the package sources in the official guide.
Log in to Docker.
You receive the credentials from us.
Create a directory and clone Enginsight.
Execute the setup.
The installation may take a few moments. In the browser, open the application.
Once the installation is complete, you can log in using the temporary login credentials. You can obtain them as follows:
Copy the ID of the server-m2
module.
The credentials for the initial login will now be issued to you. Please save the initial login data.
Change the initial login data immediately after you have logged in for the first time.
To do this, go to Settings → User account. Adjust your e-mail address in the personal details and assign a new password under Password.
ATTENTION! Without a changed and saved password or saved intial password you will lose access to the Enginsight platform. Use a password manager!
Regulate the memory requirements of the Docker logs by limiting them to 100 Mb as follows:
Insert the following:
Restart Docker service:
If you adjust a configuration file on the application server, setup.sh
must always be executed afterwards. Only then the settings will take effect.
Open the configuration file in an editor of your choice, for example nano.
In the app section, replace the IP address of the application server with its DNS name.
Save the new configuration file (Ctrl+o) and confirm the saving process. Close nano (Ctrl+x).
2. Navigate to /opt/enginsight/enterprise
.
3. Restart the application.
For a proper operation of the Enginsight application, the access via HTTPS is mandatory.
You can import the license file under Settings → License.
Configure your Enginsight on-premises installation.
In addition to the Enginsight application, you can install other software components to take advantage of the full range of Enginsight features.
Install Pulsar Agent on all servers and clients you want to monitor with Enginsight. Start with the servers on which you have installed Enginsight.
The Observer is responsible for monitoring your endpoints from the outside. You can place multiple Observers at different points of the network (e.g. in different network segments) and Internet (e.g. different countries and continents).
A watchdog installed in a network segment can perform asset discovery. It is also responsible for agentless monitoring (ping and port monitoring, SNMP).
The Hacktor is a software component that can be installed on a specific network segment to perform penetration tests on reachable assets.
The current version numbers can be found here: , .
Install and configure nginx to set up an encrypted connection and enable HTTPS.
To use Enginsight OnPremises, you need a license file. Contact us to purchase a license package:
Do you want to manage multiple organisations with Enginsight and use the multitenancy? what you have to consider regarding the license.
to be able to send emails.
to secure login.
to keep data longer in the database.
to customize the installation to your corporate identity.
To learn how to install a Pulsar agent, click .
You can learn how to add an Observer .
To learn how to add a watchdog, click .
To learn how to add a Hacktor, click .