Installation

ELMA365 Standard Edition can be installed on Ubuntu Server 20.04 LTS.

Before you begin, please read the minimum requirements to install and run ELMA365 Standard Edition. The following information does not provide instructions for configuring your company’s server, but helps you estimate compatibility with ELMA365.

Actual requirements depend on a real-life use of the system and vary significantly among different companies.

System requirements

The table below lists software and hardware requirements for installing ELMA server.

*A backup system must be located on a separate server; RAM capacity must match the backup frequency

Installing the server on Ubuntu

начало внимание

If you are using VMWare ESXi >= 6.5, make sure that disk UUID is switched on. Read more about that on the official VMWare website.

конец внимание

There are several steps to install the server.

Step 1. Open the command line on the server. Then, run the following command:

curl -fsSL -o get_elma365.sh https://dl.elma365.com/standard/master/install.sh && chmod +x get_elma365.sh && ./get_elma365.sh

You can increase the installation timeout if necessary. Set the value for 120 minutes, for example.

TIMEOUT=120m ./get_elma365.sh

Step 2. Enter the Administrator password (root).

Step 3. Enter base-URL – local domain name or the server IP address. ELMA365 will be available at this IP address.

Step 4. Enter the main administrator login (email).

Step 5. Enter the main administrator password.

Next, you can set up an smtp server for email messaging. Skip this step if you want to configure the smtp server later. You can find it in the Administration workspace.

Step 6. Set up an smtp server:

• SMTP host. Enter the server address according to your email server settings. For example, smtp.gmail.com.
• SMTP port. Enter the connection port according to your email server settings. For example, 465.
• Select the SSL. For example, TLS.
• From address. Specify the address you want to use to send messages.
• SMTP password. Specify the server password.

The installation process takes up 10-15 minutes. If the program is installed successfully, the following message will appear: ELMA365 successfully installed. Visit http:/.... [Step 3 server IP address].

The installation log files are located in /var/log/elma365/install.log. If you are experiencing problems installing ELMA365, consult the log files to troubleshoot the installation.

Uninstalling

Remove the microk8s to delete all program components. To do so, run the following command:

sudo snap remove microk8s

To delete the user configuration files, remove the sudo rm /etc/elma365/elma365.yaml

Status check

You can check the statuses of the servers with the following command:

microk8s kubectl get pod

The table with the list of services appears. They should have the Running status.

Logging

You can view all log files by running the following command:

microk8s kubectl logs --selector=release=elma365 --all-containers > logs.txt

To find specific logs, specify the needed service [name].

microk8s kubectl logs --selector app=[name]

Example:

microk8s kubectl logs --selector app=main

To monitor the log files in real time, add -f to the command.

Example:

microk8s kubectl logs --selector app=main -f

To decrease the number of lines in a log file, add --tail to the command.

Additional information

The microk8s service is installed with the system. The microk8s service has the following components:

databases:

• mongo
• minio
• redis
• postgresql
• rabbitmq

apps:

To access the databases, you need to forward the ports of the corresponding services:

• sudo microk8s kubectl port-forward mongo-0 27017:27017
• sudo microk8s kubectl port-forward redis-master-0 6379:6379
• sudo microk8s kubectl port-forward postgres-0 5432:5432
• sudo microk8s kubectl port-forward rabbitmq-0 15672:15672