Installation of Eocortex Server under Linux

Warning

Starting from version 3.4 of Eocortex, certain components use PostgreSQL database management system of version 11 or later. In this respect, before installing version 3.4 and higher (as well as when upgrading from version 3.3 and lower to version 3.4 and higher), it is required to review the PostgreSQL installation information.

Note

After completion of the installation, it is required to connect to the server using the Eocortex Configurator application launched on the Windows computer, and activate the license on the server.

The Eocortex Configurator application is installed on the Windows computer in the process of installing any of the following applications on the same computer: Eocortex Client, Eocortex Server or Eocortex Standalone.

Below are the sequences of commands used depending on the installation method and the Linux installation package used.

Debian

Supported versions:

• Debian 10

• Debian 11

• Debian 12

Installation of the latest version with access to the Internet

1. Add the Eocortex repository:

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

2. Install the Eocortex Server application:

   sudo apt install eocortex
   

Installation of specific version with access to the Internet

1. Add the Eocortex repository:

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

2. Check out the list of available versions in the repository:

   sudo apt show eocortex -a
   

3. Install the Eocortex Server application of the needed version (e.g. 4.1):

   sudo apt install eocortex=4.1.*
   

Installation without access to the Internet

Warning

For this installation method, you will need a computer with Internet access and an operating system that matches the one on which you want to install the Eocortex Server application.

1. Clear local repository:

   sudo apt-get clean
   

2. Add the Eocortex repository:

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

3. Download all necessary packages (dependencies):

   sudo apt-get install -d -y eocortex
   

4. Create the EocortexPackages directory and move all downloaded packages into it:

   mkdir ~/EocortexPackages/ && cp -R /var/cache/apt/archives/*.deb ~/EocortexPackages/
   

5. Copy the entire EocortexPackages directory to a USB drive and transfer the data to the server. Install the Eocortex Server application with all dependencies using the following command:

   sudo dpkg -i /path/to/EocortexPackages/*.deb
   

Silent installation

To avoid appearance of redundant questions during the installation, it is required to set up debconf. The following command is used for this purpose:

dpkg-reconfigure debconf

First, it will be suggested to select the interface for interacting with debconf.

Then, it will be required to choose the lowest permissible priority of the questions to be displayed.

Later, during the installation process, the system will automatically substitute answers to the lower priority questions, taking these answers from the debconf database. The rest of the questions (with the selected and higher priority) the user will have to answer on their own, in an interactive mode.

To select the critical priority, it is required to execute the following command:

echo debconf debconf/priority select critical| debconf-set-selections

If it is necessary to turn off duplicate questions, it is possible to clearly tell the system not to ask a question since it has already been seen before. To do this, it is required to manually add the flag “seen” for the desired question in the /var/cache/debconf/config.dat file.

Name: eocortex/license-agreed

Template: eocortex/license-agreed

Value: true

Owners: eocortex

Flags: seen

To install Firebird without questions, it is required to add a database access password for debconf by running the following command, substituting password_value with an actual password:

echo firebird3.0-server shared/firebird/sysdba_password/first_install password password_value | debconf-set-selections

The existing templates and their values can be viewed in the /var/cache/debconf/config.dat file.

Update with access to the Internet

1. Update the Eocortex repository:

   sudo rm /etc/apt/sources.list.d/eocortex.list
   
   wget -O - https://packages.eocortex.com/deb/install/eocortex-deps-debian.sh | bash
   

2. Install the latest version of Eocortex Server application:

   sudo apt-get install eocortex
   

Update without access to the Internet

The steps are identical to the installation without access to the Internet. To update the Eocortex Server application on a device without Internet access, repeat the steps above.

Uninstallation

To uninstall the Eocortex Server application, run the following command:

sudo apt-get remove eocortex

Ubuntu

Supported versions:

• Ubuntu 20.04

• Ubuntu 22.04

Installation of the latest version with access to the Internet

1. Add the Eocortex repository:

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

2. Install the Eocortex Server application:

   sudo apt install eocortex
   

Installation of specific version with access to the Internet

1. Add the Eocortex repository:

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

2. Check out the list of available versions in the repository:

   sudo apt show eocortex -a
   

3. Install the Eocortex Server application of the needed version (e.g. 4.1):

   sudo apt install eocortex=4.1.*
   

Installation without access to the Internet

Warning

For this installation method, you will need a computer with Internet access and an operating system that matches the one on which you want to install the Eocortex Server application.

1. Clear local repository:

   sudo apt-get clean
   

2. Add the Eocortex repository:

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

3. Download all necessary packages (dependencies):

   sudo apt-get install -d -y eocortex
   

4. Create the EocortexPackages directory and move all downloaded packages into it:

   mkdir ~/EocortexPackages/ && cp -R /var/cache/apt/archives/*.deb ~/EocortexPackages/
   

5. Copy the entire EocortexPackages directory to a USB drive and transfer the data to the server. Install the Eocortex Server application with all dependencies using the following command:

   sudo dpkg -i /path/to/EocortexPackages/*.deb
   

Silent installation

To avoid appearance of redundant questions during the installation, it is required to set up debconf. The following command is used for this purpose:

dpkg-reconfigure debconf

First, it will be suggested to select the interface for interacting with debconf.

Then, it will be required to choose the lowest permissible priority of the questions to be displayed.

Later, during the installation process, the system will automatically substitute answers to the lower priority questions, taking these answers from the debconf database. The rest of the questions (with the selected and higher priority) the user will have to answer on their own, in an interactive mode.

To select the critical priority, it is required to execute the following command:

echo debconf debconf/priority select critical| debconf-set-selections

If it is necessary to turn off duplicate questions, it is possible to clearly tell the system not to ask a question since it has already been seen before. To do this, it is required to manually add the flag “seen” for the desired question in the /var/cache/debconf/config.dat file.

Name: eocortex/license-agreed

Template: eocortex/license-agreed

Value: true

Owners: eocortex

Flags: seen

To install Firebird without questions, it is required to add a database access password for debconf by running the following command, substituting password_value with an actual password:

echo firebird3.0-server shared/firebird/sysdba_password/first_install password password_value | debconf-set-selections

The existing templates and their values can be viewed in the /var/cache/debconf/config.dat file.

Update with access to the Internet

1. Update the Eocortex repository:

   sudo rm /etc/apt/sources.list.d/eocortex.list
   
   wget -O - https://packages.eocortex.com/deb/install/eocortex-deps-ubuntu.sh | bash
   

2. Install the latest version of Eocortex Server application:

   sudo apt-get install eocortex
   

Update without access to the Internet

The steps are identical to the installation without access to the Internet. To update the Eocortex Server application on a device without Internet access, repeat the steps above.

Uninstallation

To uninstall the Eocortex Server application, run the following command:

sudo apt-get remove eocortex

CentOS

Supported versions:

• CentOS 7

Installation of the latest version with access to the Internet

1. Add the Eocortex repository:

   wget -O - https://packages.eocortex.com/rpm/install/eocortex-deps-centos.sh | bash
   

2. Install the Eocortex Server application:

   sudo yum install eocortex
   

Installation of specific version with access to the Internet

1. Add the Eocortex repository:

   wget -O - https://packages.eocortex.com/rpm/install/eocortex-deps-centos.sh | bash
   

2. Check out the list of available versions in the repository:

   sudo yum list --showduplicates eocortex
   

3. Install the Eocortex Server application of the needed version (e.g. 4.1):

   sudo yum install eocortex-4.1.*
   

Installation without access to the Internet

Warning

For this installation method, you will need a computer with Internet access and an operating system that matches the one on which you want to install the Eocortex Server application.

1. Add the Eocortex repository:

   wget -O - https://packages.eocortex.com/rpm/install/eocortex-deps-centos.sh | bash
   

2. Install yum extensions:

   sudo yum install -y yum-utils
   

3. Create the EocortexPackages directory:

   mkdir EocortexPackages
   

4. Go to the created directory and download all necessary packages (dependencies):

   sudo yumdownloader --downloadonly eocortex --resolve
   

5. Copy the entire EocortexPackages directory to a USB drive and transfer the data to the server. Install the Eocortex Server application with all dependencies using the following command:

   sudo rpm -ivh EocortexPackages/*.rpm
   

Update with access to the Internet

1. Update the Eocortex repository:

   sudo rm /etc/apt/sources.list.d/eocortex.list
   
   wget -O - https://packages.eocortex.com/rpm/install/eocortex-deps-centos.sh | bash
   

2. Install the latest version of Eocortex Server application:

   sudo yum update eocortex
   

Update without access to the Internet

The steps are identical to the installation without access to the Internet. To update the Eocortex Server application on a device without Internet access, repeat the steps above.

Uninstallation

To uninstall the Eocortex Server application, run the following command:

sudo yum remove eocortex