Deployment of Eocortex Client on Linux using Flatpak

Installation of the latest version of Eocortex Client

Install Flatpak and add the Eocortex Flatpak repository:
```
wget -O - https://packages.eocortex.com/flatpak/install/eocortex.sh | bash
```
Note

During the installation of Flatpak, all necessary dependencies and directories are downloaded, so the installation may take more than 5 minutes.

Install the Eocortex Client application:

sudo flatpak install eocortex com.eocortex.client//latest

Then, it is necessary to re-enter the GUI or restart the PC so that the Eocortex Client shortcuts appear in the application menu.

Launch the applications

Once the installation is complete, you can run the Eocortex Client, Eocortex Configurator and Eocortex Player applications.

At the first launch of the application it is necessary to select the interface language. After that the application initialization will start, which may take 5-10 minutes.

The interface of applications under Linux is similar to the interface of these applications under Windows.

Applications can be launched not only from the application menu, but also from the terminal.

Eocortex Client

flatpak run com.eocortex.client

Eocortex Configurator

flatpak run --command=runconfigurator.sh com.eocortex.client

Eocortex Player

flatpak run --command=runplayer.sh com.eocortex.client

Update the minor version of an already installed application Eocortex Client

To upgrade the minor version, run the following command:

sudo flatpak update com.eocortex.client

Installation of other Eocortex Client versions

For example, if you want to upgrade from version 4.1 to 4.2, you must first install 4.2:

sudo flatpak install com.eocortex.client//4.2

and then upgrade to version 4.2 using the command:

sudo flatpak make-current com.eocortex.client//4.2

After that, you need to relaunch the graphical shell or restart your PC to update the shortcuts in the application menu.

When you run the Eocortex Client, the initialization process will occur again, which will take 5 or 10 minutes.

View a list of the current versions of Eocortex Client using the command:

sudo flatpak remote-ls | grep eocortex

Uninstalling of Eocortex Client

To uninstall the Eocortex Client, use the command:

sudo flatpak uninstall com.eocortex.client

Automatic connection of Eocortex Client

To set up an automatic connection of the Eocortex Client when running via a shortcut in the application menu, you need to specify the server IP address (or domain name), port, username, and password in the file /var/lib/flatpak/app/com.eocortex.client/current/active/files/bin/runclient.sh after "${WINE}" "${CLIENTPATH}/${brand^}Client.exe".

Example:

"${WINE}" "${CLIENTPATH}/${brand^}Client.exe" -server office.server.com -port 8080 -user root -password qwerty

To connect via SSL, you must specify the port using the -ssl-port parameter instead of -port, and use the -connectionprotocol parameter with the value 1 to establish an HTTPS connection. The insertion point of the -connectionprotocol parameter does not matter.

Example:

"${WINE}" "${CLIENTPATH}/${brand^}Client.exe" -server office.server.com -sslport 18080 -connectionprotocol 1 -user root -password qwerty

If you want to disable SSL-certificate validation, you can use the -disablesslcertificatesvalidation parameter.

Example:

"${WINE}" "${CLIENTPATH}/${brand^}Client.exe" -server office.server.com -port 8081 -disablesslcertificatesvalidation -user root -password qwerty

Unsupported features

Electronic signature of exported video and screenshots.
Auto-update of the client application.
Active Directory Single Sign-On.
View video in the camera's field of view on maps and plans.
View heat maps on plans.
Automatic opening of exported video.
Operation of Local monitoring and backup archive utility.

Requirements, limitations, recommendations

It is not recommended to use MATE with Marco window manager as a desktop environment due to the following behavior of this combination: When running Eocortex Client application in full-screen mode, the main window with camera cells is always placed on top of other windows (e.g. archive export or application settings) by default. As an alternative solution, it is recommended to use the Cinnamon graphical shell.
When using NVIDIA graphics cards for display, it is recommended to use proprietary drivers at least version 470.
Only USB connection is supported for PTZ remotes. Remote controllers connected by other means are not guaranteed to work.
When installing an application in the MATE desktop environment with the Marco window manager, it is possible that the appearance of third-party applications may change in. This is due to changes in the OS window manager settings required for correct operation of the application.

Troubleshooting

Problem 1

Eocortex Client fails to install or start without displaying any errors.

Cause

The installation was not completed.

Solution

Ensure that the user has permission to install the application and that the computer has unobstructed access to the Internet. Delete the results of the previous application installation attempt, restart the computer and try again.

Problem 2

Secondary application windows (Archive Export, Application Settings, etc.) do not open or open in the background.

Cause

A combination of the MATE graphical shell with the marco window manager is used, with which full-screen applications are always placed on top of other windows.

Solution 2.1

Switch to the desired window using the Alt+Tab key combination.

Solution 2.2

Change the MATE graphical shell to a different one. For example, cinnamon.

Problem 3

The error "GPG verification enabled, but no summary found (check that the configured URL in remote config is correct)" appears during installation.

Cause

The repository metadata has changed.

Solution 3.1

Remove the flatpak repository Eocortex and add a new one:

sudo flatpak remote-delete eocortex

wget -O - https://packages.eocortex.com/flatpak/install/eocortex.sh | bash

Deployment of Eocortex Client on Linux using Flatpak🔗