ELMA365 Standard On-premise > Installing ELMA365 Standard / Installing on Ubuntu

Installing on Ubuntu

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.

Operating System

Ubuntu Server 20.04 LTS

Or use supported distributions with snap pre-installed

Additional Software

snapd, bash, curl

An Internet connection is required to install ELMA365

Minimum hardware requirements (200+ licenses)*

CPU: 2.2 GHz and above, 4 core (Intel Xeon recommended)

Hard drive:

  • 50 GB (application + OS, RAID 5),
  • 100 GB (files, DB, RAID 5 SATA)

RAM: 8 GB

Network connection: LAN 100 Mbit/sec or above.

Recommended hardware requirements (200+ licenses)

CPU: 2.2 GHz and above, 8 core (Intel Xeon recommended)

Hard drive:

  • 100 GB (application + OS, RAID 5),
  • 300 GB (files, DB, RAID 5 SATA)

RAM: 16 GB

Network connection: LAN 1 Gbit/sec or above.

*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:

auth

Authorization and groups, users, and org chart management

balancer

Multi-tenancy management

calculator

Calculating different values in app items

chat

Private and group messages

collector

App items read and filter

convertik

Office formats to pdf converting

deploy

Migration management

diskjockey

Files and directories

docflow

Document workflow. Approval and review.

feeder

Activity stream / channels

front

ELMA365 Front end

integrations

External integrations

mailer

Email management

main

API gateway

notifier

Notifications and web-sockets

processor

Process management

scheduler

Schedules

settings

User profile and system profile management

templater

Text and office documents templater

vahter

Users management in a multi-tenancy system

web-forms

Web forms for external systems management

widget

Widget management (interface customization)

worker

Validating, transpiling and user scripting

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