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