Installation of Awide
This section describes the procedures for obtaining Platform distribution from the Developer’s repository and installing Platform.
Before installing Platform, make sure that the necessary ports are open and install Docker.
Open ports
For Platform to work correctly on devices with Agent installed, ports 443, 4222 shall be open towards Platform.
Docker installation
Attention
All commands during the installation process shall be run by the root user or any other user with sudo rights.
Warning
If you are installing Docker on OS with mandatory integrity control mode enabled, commands shall be run by a user with a high integrity level.
To install Docker:
Install the required packages:
apt update apt install docker.io apt install docker-compose-v2
Add the official Docker repository and install the required packages:
curl https://download.docker.com/linux/centos/docker-ce.repo -o /etc/yum.repos.d/docker-ce.repo yum install yum-utils \ device-mapper-persistent-data \ docker-ce \ -y
Start the Docker service:
systemctl start docker
Ensure the Docker service starts automatically after server reboot:
systemctl enable docker
Download docker from the official repository.
Change the permissions of the file /usr/local/bin/docker-compose:
chmod +x /usr/local/bin/docker-compose
Install the required packages:
dnf install yum-utils \ device-mapper-persistent-data \ docker-ce \ -y
Start the Docker service:
systemctl start docker
Ensure the Docker service starts automatically after server reboot:
systemctl enable docker
Note
If you are installing Docker Engine from third-party sources, the Docker version shall be at least 20.10.13.
Obtaining the distribution
To obtain Platform distribution:
Enter the following command:
wget https://public.tantorlabs.ru/tantor-eco-6.2.0.tar.gz -O tantor-eco-6.2.0.tar.gz
Save the distribution on the server where Platform will be installed.
Installation of Platform
To start the installation of Platform:
Go to the directory with the saved distribution of Platform.
Unpack the distribution using the following command:
tar xvf tantor-eco-6.2.0.tar.gz
Start the installation procedure using the following command:
sudo ./installer
The installation program will request confirmation to start:
Awide will be installed, version 6.2.0 Proceed? (Y/N):
to continue the installation, enter Y;
to cancel the installation, enter N.
When prompted by the installation program, enter the email of the System Administrator:
-Enter Awide administrator email: <admin@example.ru>
Type in name of the System Administrator:
-Enter Awide administrator name: <Admin Name>
Attention
The name of the System Administrator must contain more than four characters.
Type in domain name of the device that will be used by Platform. The domain name shall be registered in the organization’s DNS table if it is required to use the organization’s certificate instead of the certificates created by Platform.
-Enter Awide domain name: <host.example.ru>
Attention
The following data is used as examples:
email of the system administrator <admin@example.ru>;
name of the System Administrator <Admin Name>;
domain name of devices <host.example.ru>.
Important
If the domain name is not listed in the organization’s domain tables, add it to the hosts file of the server on which Platform is being installed.
Also, add this domain name to the hosts file of the servers on which Agents will be installed and from which the user will access Platform via a web browser.
Example:
192.168.0.154 host.example.ru
The installer will ask if there is an SSL certificate for the device name on which Platform is being installed (<host.example.ru>):
Do you have SSL certificates match domain name <host.example.ru>?
If there is no SSL certificate, the installer can create a certificate for the specified device. To do so enter N.
If the certificate is available, enter Y. Next, the installer will request the path to the SSL certificate files:
enter the path to the private key:
-Enter the absolute path to SSL private key with 'pem' extension: <example_path_to_key/key.pem>
enter the path to the public key:
-Enter the absolute path to SSL public key with 'pem' extension: <example_path_to_key/certificate.pem>
The installer will offer to choose one of the installation options:
Platform: only Platform will be installed.
Platform + pg_explain: Platform and query plan analyzer will be installed.
Platform + pg_explain + pg_monitor: Platform, query plan analyzer, and log analysis module will be installed.
Enter the number of the required installation option (1-3).
Important
If you chose option 3, after installing Platform, configure the log analysis module (Advanced analytics)
The installer will display the previously filled values for confirmation, enter:
Y — to confirm the entered parameters;
N — if you need to change the parameters.
Wait for Platform installation to complete.
After the installation is complete, a message will be displayed:
Awide version 6.2.0 is installed and running. Please connect to Awide using: #. Awide URL: https://host.example.ru Awide administrator email/login: admin@example.ru Awide administrator password: xiet7KLumux50Q2dmV/FBue2zqtexElavkVAKnEYN/rw2YLIn51TQsXb3u8FPm4wiuHUTtEjjvBIrtBPAgRMsA== #. Please note. You will have to change the password on the first login to Awide.
To connect to Platform, copy the above Awide URL into the browser’s address bar. The homepage with login/password will open.
Save the login and password from the message above for the first connection to Platform. See more in section First connection.
Attention
After the first connection, Platform will require you to change the password.