Automatic Installation
The easiest way to successfully install your own Enginsight on-premises instance is to use the Debian image we have prepared. During the installation process, important configurations are already performed automatically or asked interactively.
Preparations
1. Download the Enginsight Debian image.
If your browser displays a security warning, you can ignore it. For example, in Chrome, click "Keep" to execute the download.
2. Create three virtual machines with the CPU, RAM, and mass storage values defined in the requirements.
For a smooth automatic installation, it is crucial that the database (DB) is installed first! You can already start the app server to obtain its IP address, but you should only continue to run the script after the DB installation has been completed.
DB-Server (MongoDB Database)
1.Boot the Database Server with the Enginsight Debian image and select DB Server from the start page.
After you have selected the DB server, a blue screen appears for a few moments. This is a correct behavior, just wait.
2. Select the language you want, your location and the language of your keyboard.
The setup now starts to automatically request information about the network.
3. Enter a host name, we recommend ngs-db for database server.
4. Enter your domain name, for example firma.de.
5. Set up a user and a password.
Save your entries in a password manager.
6. Select the hard disk to be partitioned.
Once again, make sure that the hard disk you have chosen is large enough to fit the requirements.
7. If you are using an HTTP proxy, configure the proxy data in the default format. If you do not need a proxy to reach the Internet, you can leave the input blank.
For example:
http://1.2.3.4/
no User / Password, no Port
http://user:secret@1.2.3.4/
User / Password, no Port
http://user:secret@1.2.3.4:8080/
User / Password and Port
The last slash "/" must be set.
8. To continue with the installation and configuration, you must reboot your system.
Make sure that Debian is loaded instead of the installation image again.
9. Log in with your user credentials. Since the script requires root privileges, you must enter your password twice.
After this point of the installation, you can optionally continue the installation via SSH.
10. Enter the IP address at which the database server and app server can reach each other.
First, enter the IP address of the app server.
Then check that the correct IP address of the database server was detected, which is reachable from the app server. Accept the IP address or, if different, enter the appropriate IP address.
MongoDB is then initialized and database access is automatically secured.
This completes the installation and configuration of your database.
We recommend changing the authentication procedure for SSH access as soon as you start using Enginsight productively. Use public key authentication instead of logging in via username and password.
App-Server (Enginsight Application)
1. Boot the application server with the Enginsight Debian image and select App Server on the start page.
After you have selected the App server, a blue screen appears for a few moments. This is a correct behavior, just wait.
2. Select the language you want, your location and the language of your keyboard.
The setup now starts to automatically request information about the network.
3. Enter a host name, we recommend ngs-app for application server.
4. Enter your domain name, for example firma.de.
5. Set up a user and a password.
Save your entries in a password manager.
6. Select the hard disk to be partitioned.
Once again, make sure that the hard disk you have chosen is large enough to fit the requirements.
7. If you are using an HTTP proxy, configure the proxy data in the default format. If you do not need a proxy to reach the Internet, you can leave the input blank.
For example:
http://1.2.3.4/
no User / Password, no Port
http://user:secret@1.2.3.4/
User / Password, no Port
http://user:secret@1.2.3.4:8080/
User / Password and Port
The last slash "/" must be set.
8. To continue with the installation and configuration, you must reboot your system.
Make sure that Debian is loaded instead of the installation image again.
9. Log in with your user credentials. Since the script requires root privileges, you must enter your password twice.
After this point of the installation, you can optionally continue the installation via SSH.
10. Log in with your Enginsight Docker Registry.
You will receive the credentials from us.
After successful login, the current version of Enginsight is downloaded and unpacked via the Internet. This may take a few moments.
11. After the Enginsight images have been successfully downloaded and unpacked, the installation will start automatically.
Confirm the license conditions: y
Specify the URI of the database. Use the given format: mongodb://<Domain or IP>:27017/enginsight?replicaSet=rs0
Confirm the Redis URI by pressing Enter.
Enter the APP URL.
Enter the API URL.
12. 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!
13. In the next step, set up encryption via SSL/TLS. Nginx is already installed.
For a proper operation of the Enginsight application, the call via HTTPS is mandatory.
14. Configure your mail server.
15. Enable 2-factor authentication.
16. Optionally, Adjust storage times or do White labeling.
For a smooth operation of the Enginsight application, the call via HTTPS is essential.
Forward the requests to port 80 (app) and port 8080 (API).
Save the new configuration file (Ctrl+o) and confirm the saving process. Close nano (Ctrl+x).
14. Restart nginx and enable automatic startup.
15. Run the setup to complete the installation.
16. Configure your On-Premises instance.
When installing the application server via the Enginsight Debian image, automatic updates of the Enginsight application via cronjob are already configured. The setting specifies that Enginsight is automatically updated every Saturday at 12:00 if a new version is available.
We recommend changing the authentication procedure for SSH access as soon as you start using Enginsight productively. Use public key authentication instead of logging in via username and password.
Component-Server
1. Boot the component server with the Enginsight Debian image and select Component-Server on the start page.
After you have selected the Component-Server, a blue screen appears for a few moments. This is a correct behavior, just wait.
2. Select the language you want, your location and the language of your keyboard.
The setup now starts to automatically request information about the network.
3. Enter a host name, we recommend ngs-component for component server.
4. Enter your domain name, for example firma.de.
5. Set up a user and a password.
Save your entries in a password manager.
6. Select the hard disk to be partitioned.
Once again, make sure that the hard disk you have chosen is large enough to fit the requirements.
7. If you are using an HTTP proxy, configure the proxy data in the default format. If you do not need a proxy to reach the Internet, you can leave the input blank.
For example:
http://1.2.3.4/
no User / Password, no Port
http://user:secret@1.2.3.4/
User / Password, no Port
http://user:secret@1.2.3.4:8080/
User / Password and Port
The last slash "/" must be set.
8. To continue with the installation and configuration, you must reboot your system.
Make sure that Debian is loaded instead of the installation image again.
9. Log in with your user credentials. Since the script requires root privileges, you must enter your password twice.
After this point of the installation, you can optionally continue the installation via SSH.
10. Install the Observer, Watchdog and Hacktor software components.You do not need to do anything other than run the corresponding installation scripts that you can find in the Enginsight platform.
You get detailed instructions here:
We recommend changing the authentication procedure for SSH access as soon as you start using Enginsight productively. Use public key authentication instead of logging in via username and password.
Buy and import license file
To use Enginsight OnPremises, you need a license file. Contact us to purchase a license package: hello@enginsight.com
You can import the license file under Settings → License.
Do you want to manage multiple organisations with Enginsight and use the multitenancy? Here you can find out, what you have to consider regarding the license.
Last updated
