ELMA365 On-Premises > ELMA365 On-Premises Standard / Administering ELMA365 Standard

Administering ELMA365 Standard

Updating ELMA365 Standard

The update process for ELMA365 Standard (KinD) is simple and is carried out similarly to the installation process.

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

To ensure data integrity when migrating with a version change of the ELMA365 edition, it is recommended to update each minor version without skipping any. For instance, version 2023.2.1 can be updated to 2023.3.1.

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

If the minor version of the installed chart differs by more than one from the minor version of the current (latest) chart, the update should be carried out in several steps for each minor version.

начало примера

Examples:

  1. Installed chart version 2023.5.1, current (latest) chart version 2023.6.9 - the update is done in one step (directly to 2023.6.9).
  2. Installed chart version 2023.3.23, current (latest) chart version 2023.6.9 - the update is done in three steps (2023.3.23->2023.4.x->2023.5.x->2023.6.9).

конец примера

 
Procedure for online installation:

  1. Download the installation script for the current (latest) version.
  2. Copy the configuration file from the currently installed version.
  3. Run the installation script with the --upgrade key.

For more details on online installation, refer to Install ELMA365 Standard.

 

Procedure for offline installation without internet access:

  1. On a computer with internet access, download the files for the current (latest) offline version and copy the downloaded files to a computer in a closed circuit.
  2. Copy the configuration file from the currently installed version.
  3. Run the installation script with the keys --offline --upgrade.

For more information on installation without internet access, read the article Install ELMA365 Standard offline.

 

Step 1: Download installation script

For online installation:
Download the installation script for the current version of ELMA365 Standard (KinD) into a separate directory:

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

For offline installation without internet access:

  1. On a computer with internet access, download the necessary files for the current offline version (downloaded files size is approximately 4-5GB) by executing the following command:

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

  1. The boot script will create a directory named elma365-X.Y.Z in the directory from which it was launched, and will download the necessary files into it.
  2. Once the files for the offline version are downloaded, the boot script will display information about the directory where the files were saved and will suggest copying them to a computer in a closed circuit.

Example of executing the boot script:

administrating-1

 

  1. After downloading all the files, copy the resulting elma365-X.Y.Z directory to the server where the installation will be carried out.

 

Step 3: Run the Installation Script to Update ELMA365 Standard (KinD)

  1. Update the ELMA365 Standard (KinD) app using the elma365-installer-docker.sh installation script, launched with the --upgrade key.

For online installation:

sudo ./elma365-installer-docker.sh --upgrade

For offline installation without internet access:

sudo ./elma365-installer-docker.sh--offline --upgrade

After starting, the installation script will identify the version of the installed ELMA365 Standard (KinD) and suggest moving to a new version.

 

When updating, the current (latest) version of ELMA365 Standard (KinD) must be higher than the version being updated (current).

 

  1. Agree to move to the new version by typing the symbol [Y]. Entering any other symbol will interrupt the app update.

administrating-2

  1. Next, you'll see a notification indicating that you need to make a backup before updating ELMA365 Standard (KinD).

To continue updating the app, enter one of the options:

  • [B]. Create a backup (Backup);
  • [C]. Skip creating a backup (Continue);
  • [E]. Interrupt the app update (Exit).
  1. Create a backup and continue updating ELMA365 Standard (KinD) by choosing [B] or pressing the ENTER key.

The installation script will execute the backup and proceed with the app update.

administrating-3

  1. Wait for the app update to complete. You'll see the message "Upgrade ELMA365 application successful".

The update of ELMA365 Standard (KinD) settings is finished.

Reinstallation of ELMA365 Standard

To reinstall ELMA365, run the installation script with the --reset key.

For online installation:

sudo ./elma365-installer-docker.sh --reset

For offline installation without internet access:

sudo ./elma365-installer-docker.sh --offline --reset

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

When running the script, all data stored in ELMA365 Standard (KinD) will be deleted.

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

Clean the node for subsequent installation of ELMA365 Standard

To clean the host node for subsequent installation of ELMA365 Standard (KinD), run the installation script with the --delete key:

sudo ./elma365-installer-docker.sh --delete

Diagnostics and Troubleshooting

  1. Collect diagnostic information.

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

For accurate collection of network status diagnostic information, the script requires the net-tools utility.

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

To collect diagnostic information about the system status, run the installation script elma365-installer-docker.sh with the --diag key:

sudo ./elma365-installer-docker.sh --diag

After starting, the installation script will determine the version of the installed ELMA365 Standard (KinD) and offer a method to save diagnostics.

To continue with the diagnostics collection, enter one of the options:

[S]. Collect and upload diagnostic information to the ELMA365 server.

The installation script will return a link to download the diagnostic information. Example link: https://nc.elma365.tech/iuq1fg.txt.

[F]. Collect and save to a file on a local disk.

The installation script will provide a path to the file with diagnostic information, for example, /root/elma365-2023.2.15/elma365-diagnostic-20230410-142556.

The installation script will then collect the diagnostic information.

  1. Generate logs and check service status.

To get logs from application services, run the command:

docker exec elma365 kubectl logs -l tier=elma365 --all-containers > logs.txt

To view logs from a specific service, replace [name] with the desired service:

начало примера

Example:

docker exec elma365 kubectl logs -l app=main

конец примера

To view logs in real-time, add the -f option.

начало примера

Example:

docker exec elma365 kubectl logs -l app=main -f

конец примера

To check the status of services, run the command:

docker exec elma365 kubectl get pod

The result will be displayed in a table format with a list of services. Services should be in the Running status, and tasks should be in the Completed status.

List of available commands for elma365-installer-docker.sh

To view the list of all available commands, run the installation script with the key --help:

sudo ./elma365-installer-docker.sh --help

Доступные команды:

--new-config

Create a new installation configuration file: config-elma365.txt

--diag

Collect diagnostic information

--install

Installing ELMA365

--offline

Offline installation of ELMA365

--upgrade

Update ELMA365

--stop

Stop ELMA365 application

--start

Start ELMA365 application

--dump

Database backup to /backup/ELMA365 folder with version and timestamp

--restore

Restore the database backup from the archive

--reset

Reinstall ELMA365 (all data will be deleted)

--delete

Delete ELMA365 (all data will be deleted)

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