Installing Eocortex Client application on Linux🔗

Warning

Internet access must be provided for the computer during the installation process.

Note

The installation requires a graphical shell.

All actions during the installation, update, and removal of the application must be performed through the system's graphical user interface (GUI) by a pre-configured user with administrator privileges, using the sudo command in the terminal.

Note

To submit feedback or report issues, please contact us at support@eocortex.com.

Below are the steps for installing, updating, and removing the Eocortex Client application.

Ubuntu🔗

Supported versions:

Ubuntu 20.04
Ubuntu 22.04
Ubuntu 24.04

Installation of the latest version🔗

If third-party versions of Wine and Winetricks are installed on the device, uninstall them before starting the installation of the Eocortex Client application:
```
apt-get remove 'wine*'
```

Add the Eocortex repository:

wget -O - https://packages.eocortex.com/deb/install/eocortex-deps-ubuntu.sh | bash

Install the Eocortex Client application:
```
apt-get install eocortex-client
```

To further update the application from version 4.1 it is enough to repeat steps 2-3 in sequence. To update from version 3.6 to the current version, it is recommended to follow the corresponding instructions.

Note

When starting the installation process, it is required to specify the username for which the application will be installed.

Update from version 4.1🔗

To upgrade the Eocortex Client application from version 4.1 to the next version, repeat the steps to add the Eocortex repository and install the application from the instructions for the selected operating system.

Update from version 4.5🔗

After updating from version 4.5 to version 4.6 or later, you must manually delete the desktop and ~/.local/share/applications/wine shortcuts for previous versions of the Eocortex Client, Eocortex Configurator, and Eocortex Player applications.

Note

To restore deleted shortcuts, you can drag the desired icon from the applications menu to the desktop or run the following commands in the terminal:

cp /usr/share/applications/com.eocortex.client.desktop "$(xdg-user-dir DESKTOP)/Eocortex.desktop"

cp /usr/share/applications/com.eocortex.client.configurator.desktop "$(xdg-user-dir DESKTOP)/EocortexConfigurator.desktop"

cp /usr/share/applications/com.eocortex.client.player.desktop "$(xdg-user-dir DESKTOP)/EocortexPlayer.desktop"

Uninstallation🔗

Remove Eocortex Client:
```
apt-get remove eocortex-client
```
Remove Wine:
```
apt-get remove eocortex-wine
```
Remove the Wine environment:
```
rm -rf /home/USER/.eocortexclient
```
Where:
- USER: OS user for which the application was installed.
Note

When deleting the Wine environment, all previously made application settings will also be deleted. To avoid this, save a copy of the contents of ~/.eocortexclient/drive_c/users/$USER/AppData/Local/Eocortex before uninstalling the environment. After installing the current version of the application, place the copied files in the same path.

Launch the applications🔗

Note

Before running installed applications via shortcuts created on the desktop, they must be allowed to run. Right-click the shortcut of the desired application with a .desktop extension and select Allow launching.

Once the installation is complete, you will be able to launch the applications Eocortex Client, Eocortex Configurator, and Eocortex Player.

The applications are launched from the system applications menu.

The appearance of the applications is identical to that of the same applications on Windows.

The applications can also be launched via the terminal:

Eocortex Client:

bash /opt/EocortexClient/runclient.sh

Eocortex Configurator:

bash /opt/EocortexClient/runconfigurator.sh

Eocortex Player:

bash /opt/EocortexClient/runplayer.sh

MCM file operations🔗

The Eocortex Player application supports opening MCM files by double-clicking them in the file manager. Files with the .mcm extension are displayed with the player icon.

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🔗

Eocortex Client uses its own version of Wine, which is incompatible with other versions from third-party repositories.

It is not recommended to use MATE with Marco window manager as a desktop environment due to peculiarities of 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. The drop-down lists in Eocortex Client, Eocortex Configurator and Eocortex Player applications may not work correctly. As an alternative solution, it is recommended to use the Cinnamon desktop environment.

When using NVIDIA video cards for display, it is recommended to use proprietary drivers no lower than version 470.
When using Intel UHD Graphics video cards for display, it is recommended to use the latest stable version of Intel proprietary drivers.

The open source Nouveau driver is not supported. When running the Eocortex Client application with this driver, hardware acceleration will be disabled.
Only USB connection is supported for PTZ remotes. Remote controllers connected by other means are not guaranteed to work.
Hardware acceleration is not supported in the Eocortex Configurator application.

Troubleshooting🔗

Problem 1🔗

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

Cause 1.1

The installation was not completed.

Solution 1.1

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.

Cause 1.2

Application conflict.

Solution 1.2

nsure that only eocortex-wine is installed on the device and that there are no other versions of Wine from third-party repositories.

Problem 2🔗

Eocortex Client fails to launch with the GLXBadFBConfig error.

Error of failed request: GLXBadFBConfig

Major opcode of failed request: 153 (GLX)

Minor opcode of failed request: 0 ()

Serial number of failed request: 1602

Current serial number in output stream: 1602

Cause 2

Wine is unable to initialize OpenGL.

Solution 2

Before launching, set the environment variable:

export MESA_GL_VERSION_OVERRIDE=4.5

Problem 3🔗

Eocortex Client fails to launch with the XVidMode error.

Cause 3

Wine is unable to initialize XVid codec.

Solution 3

Disable the codec by changing the UseXVidMode parameter: .. code-block:

WINEPREFIX="/home/$USER/.eocortexclient" wine reg.exe ADD "HKEY_CURRENT_USER\\Software\\Wine\\X11 Driver" "/v" "UseXVidMode" "/t" "REG_SZ" "/d" "N"'

Problem 4🔗

Unable to verify the certificate when installing a license or attempting to connect to the server via HTTPS.

Cause 4

There is a mismatch between the installed certificates, or their validity cannot currently be confirmed.

Solution 4

Disable certificate validation by adding the -disablesslcertificatesvalidation flag to the launch command.

Problem 5🔗

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

Cause 5

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 5

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

Solution 5

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