Automatic Installation
Last updated
Last updated
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.
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.
The following steps are the same for the installation of the database and the app server. Carry these out and then continue with the appropriate instructions.
Boot the database server with the Enginsight Debian image and select the corresponding server on the start page.
After you have selected the DB server, a blue screen appears for a few moments. This is correct behavior, just wait.
Select the desired language, your location and the layout of your keyboard.
The setup now starts to automatically retrieve information about the network. This may take a short time, wait until everything has loaded.
Assign a computer name, we recommend “ngs-db” for the database server and “ngs-app” for the app server.
Then set up your network. To do this, enter your full domain name, e.g. company.com.
If you are using an HTTP proxy, configure the proxy data in the standard format. If you do not need a proxy to access the Internet, you can leave the entry 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.
Now set up your new user.
Enter the name of your account.
Save your entries in a password manager.
Then assign a password for the newly created user.
Confirm your previously selected password by entering it again.
Select the hard disk to be partitioned.
Make sure once again that the hard disk you have selected is large enough to meet your requirements.
The base system and other components are being installed, please be patient for a moment.
You will receive this information after completing the installation and configuration. Then restart your system.
Make sure that the installation image is not loaded again, but Debian.
From this point of the installation, you can optionally continue the installation via SSH.
Then log in to your VM again. Use the previously assigned computer name and the defined password. As the script requires root rights, you will need to enter your password twice.
Now specify whether you want to activate TLS and role-based access controls. We strongly recommend this.
You will now be asked to enter the IP address of your app server. Now start the setup of your app server at the same time to query its IP address.
Then check whether the correct IP address of the database server that can be reached by the app server has been recognized. Accept the IP address or enter the corresponding IP address if there is a discrepancy.
Your TLS certificates are then issued, TLS is activated, MongoDB is initialized, a new user is created and your database access is secured.
Certificates are now copied to the app server. To do this, enter the user name of your app server and confirm the connection to the host. You will then be asked to enter the app server password several times.
This completes the installation and configuration of your database server.
We recommend that you change the authentication procedure for SSH access as soon as you start using Enginsight productively. Use public key authentication instead of logging in with a user name and password.
Then log in to your VM again. Use the previously assigned computer name and the defined password. As the script requires root rights, you will need to enter your password twice.
Log in to the Docker Registry with your access data.
You will receive the access data for the Docker Registry from us.
After you have logged in to the Docker Registry, please be patient while the Enginsight images are being downloaded.
Read the end user license agreement and then confirm your agreement with a “y”.
In the following steps you will be asked to enter the MongoDB URI, Redis URI, App URL and the API URL. You will already find an entry here, check it and confirm it for each query.
Once all entries have been entered correctly, initialization starts.
Please note that this may take some time.
Finally, follow our recommendation and adjust the configuration as indicated to enable access via HTTPS.
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!
This completes the installation and configuration of your app server.
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.
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.
