search string side menu

ELMA365 On-Premises > ELMA365 On-Premises Standard / Install ELMA365 Standard

Install ELMA365 Standard

ELMA365 Standard edition can be installed on Kubernetes-in-Docker (KinD). This installation option is straightforward and allows you to run a local Kubernetes cluster using a Docker container node.

The installation consists of three steps:

  1. Install Docker for your operating system.
  2. Download the installation script and fill in the configuration file.
  3. Run ELMA365 Standard installation script.

First ready the ELMA365 On-Premises Standard system requirements.

Step 1: Install Docker

Install Docker for your operating system.

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

Please be aware that KinD does not support creating a Kubernetes cluster with Cgroups v2. Refer to the documentation for possible errors.

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

Step 2: Download the installation script and fill in the configuration file

Upon the first run, the installation script will create a configuration file named config-elma365.txt in the directory from which it was executed.

  1. Download and run the ELMA365 installation script to create a configuration file by executing the following command:

sudo curl -fsSL -o elma365-installer-docker.sh https://dl.elma365.com/onPremise/master/latest/installer-docker && \
sudo chmod +x elma365-installer-docker.sh && \
sudo ./elma365-installer-docker.sh

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

To create a new default configuration file, rename the existing configuration file config-elma365.txt  and run the installation script with the --new-config flag.

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

  1. Make changes to the configuration file config-elma365.txt prepared with the installation script.
  1. For a quick start with ELMA365 Standard, uncomment and fill in the necessary variables.

Filling in the main parameters in the configuration file config-elma365.txt may look like the following:

offline_install_parameters

Where:

  • ELMA365_HOST=192.168.1.103 is the IP address of the host machine through which the ELMA365 Standard application will be accessible. For details on creating a FQDN, refer to Modify ELMA365 Standard parameters;
  • ELMA365_EMAIL=admin@mail.com is the administrator's email address;
  • ELMA365_PASSWORD=test is the  administrator's password;
  • ELMA365_LANGUAGE=en-US is the language of the installed system.

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

If Docker is installed via Snap, you need to uncomment and change the paths to folders/directories for the parameters: ELMA365_INSTALL_DIR, ELMA365_BACKUP_DIR, for example:

  • ELMA365_INSTALL_DIR=/mnt/elma365/docker;
  • ELMA365_BACKUP_DIR=/mnt/elma365/backup.

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

Filling in connection variables to the proxy server

To use your proxy server for the installation and operation of ELMA365 Standard, uncomment and fill in the variables in the section Настройка режима работы сервера ELMA365 через прокси-сервер of the configuration file config-elma365.txt.
 

Example for ELMA365_HOST=192.168.1.103:
 

# -------------------------------------------------------------
# Setting up the operation mode of the ELMA365 server through the proxy server
# -------------------------------------------------------------
HTTPS_PROXY=http://proxy_user:proxy_pass@host:port/
HTTP_PROXY=http://proxy_user:proxy_pass@host:port/
NO_PROXY=localhost,192.168.1.103,127.0.0.0/8,10.0.0.0/8,
169.254.0.0/16,192.168.0.0/16,100.64.0.0/10,172.16.0.0/12,
cluster.local,linkerd.svc
https_proxy=http://proxy_user:proxy_pass@host:port/
http_proxy=http://proxy_user:proxy_pass@host:port/
no_proxy=localhost,192.168.1.103,127.0.0.0/8,10.0.0.0/8,
169.254.0.0/16,192.168.0.0/16,100.64.0.0/10,172.16.0.0/12,
cluster.local,linkerd.svc

 
Example for ELMA365_HOST=example.com:
 

# -------------------------------------------------------------
# Setting up the operation mode of the ELMA365 server through the proxy server
# -------------------------------------------------------------
HTTPS_PROXY=http://proxy_user:proxy_pass@host:port/
HTTP_PROXY=http://proxy_user:proxy_pass@host:port/
NO_PROXY=localhost,example.com,127.0.0.0/8,10.0.0.0/8,
169.254.0.0/16,192.168.0.0/16,100.64.0.0/10,172.16.0.0/12,
cluster.local,linkerd.svc
https_proxy=http://proxy_user:proxy_pass@host:port/
http_proxy=http://proxy_user:proxy_pass@host:port/
no_proxy=localhost,example.com,127.0.0.0/8,10.0.0.0/8,
169.254.0.0/16,192.168.0.0/16,100.64.0.0/10,172.16.0.0/

 

where:

  • proxy_user is the username for authentication on the proxy server;
  • proxy_pass is the password for authentication on the proxy server;
  • host is the host of the used proxy server;
  • port is the port of the used proxy server.

Make sure that the no_proxy and NO_PROXY variables contain network address ranges and domains to be excluded from using the proxy.

For more information on config-elma365.txt configuration file parameters, refer to Modify ELMA365 Standard parameters.

Step 3: Run ELMA365 Standard installation script

The volume of downloaded files during ELMA365 Standard installation is approximately 4-5 GB, and the installation time is around 10-15 minute.

  1. Run the downloaded installation script:

sudo ./elma365-installer-docker.sh

Once installation is complete, a message about the successful installation of the ELMA365 Standard application will be displayed in the script.

kubernetes-in-docker-3

  1. Launch the browser and open the ELMA365 Standard application login page at http://ELMA365_HOST. The ELMA365_HOST parameter was specified in the config-elma365.txt file on the Download the installation script and fill in the configuration file step.

In the provided example, the following application login page address is used: http://192.168.1.103
standard_offline_login

  1. For login, use the administrator's email address and the password that was used in the config-elma365.txtconfiguration file under the parameters ELMA365_EMAIL and ELMA365_PASSWORD.

In the provided example, they are::

  • Login — admin@mail.com;
  • Password — test.
  1. Click the Sign In button.
    The ELMA365 system activation window will open.
  1. Fill out the form, check the box at the bottom of the form to agree to the terms of the user agreement and privacy policy.
  1. Click the Try 2 weeks free button.

After this, the ELMA365 application window will open.

The offline installation of ELMA365 Standard has been successfully completed.

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

Save the config-elma365.txt file for future updates.

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

elma365-standard-trial-version.html install-kind-offline.html

Found a typo? Highlight the text, press ctrl + enter and notify us