.
contact contact

B.08.40 / Release Notes / Installation

Installation on Linux

 
.
  This document contains installation instructions specific to the Linux platform.

Please refer to the general installation notes in the Eloquence B.08.40 Release Notes for information that is not Linux specific, such as licensing, configuration files and manual procedures when upgrading from prior Eloquence versions.

Supported Linux releases

Eloquence is not distribution specific, however it was only tested against selected SUSE Linux, RedHat Linux and Ubuntu distributions. Other Linux distributions are expected to work but may not have been fully tested or require additional manual configuration.

  • SLES 15 SP3, OpenSUSE 15.3 or newer
  • RHEL 8.5 or newer
  • Ubuntu 20.04 LTS (Debian 11) or newer

System requirements

Eloquence is available for the 64-bit x86_64 (Intel/AMD 64 bit) architecture. It supports both 32 bit and 64 bit applications on 64 bit systems.

Supported OpenSSL versions

Eloquence uses the OpenSSL library for cryptographic functions. Eloquence was tested with the OpenSSL 1.1 and 3.0 library versions. Eloquence dynamically adapts to the OpenSSL library and does not depend on a specific version to be installed.

The OpenSSL library must be designated as libcrypto.so or libssl.so in the Eloquence lib directory. A symbolic link in the Eloquence lib and lib64 directories is created during installation.

To force Eloquence to use a specific crypto library, the symbolic link may be changed manually. For example:

ln -sf /usr/lib/libcrypto.so.1.1 /opt/eloquence/8.4/lib/libcrypto.so
ln -sf /usr/lib/libssl.so.1.1 /opt/eloquence/8.4/lib/libssl.so
ln -sf /usr/lib64/libcrypto.so.1.1 /opt/eloquence/8.4/lib64/libcrypto.so
ln -sf /usr/lib64/libssl.so.1.1 /opt/eloquence/8.4/lib64/libssl.so
This configures Eloquence to use the OpenSSL library version 1.1.

Enabling 32-bit application support

Eloquence on the x86_64 64-bit platform supports both 64-bit and 32-bit applications. Eloquence B.08.40 does not depend on a 32-bit environment.

The Eloquence rpm package on the x86_64 platform includes 32-bit Eloquence libraries for simplicity but does not expose dependencies to 32-bit system libraries, such as the 32-bit glibc and openssl. This makes installation of 32-bit libraries optional when they are not needed, for example in a minimal container.

To support 32-bit applications on Linux, installation of the 32-bit openssl library will resolve the necessary run-time library dependencies and result in a functional 32-bit environment. Please make sure the 32-bit openssl library uses the same version as the 64-bit openssl and gets installed before installing Eloquence. This ensures the symlink to the 32-bit libcrypto.so is installed automatically. Please note the distribution specific hints below.

Installation

Eloquence is available as an RPM package for the x86_64 (64 bit x86) architecture. Eloquence packages are also released in the deb format for use by Debian and derived distributions.

The preferred option for installation on the Linux platform is to use the Eloquence package repository. This will resolve any dependencies and also make it easy to install updates once available. Depending on the Linux distribution, yum/dnf, zypper or apt are used.

Please refer to the Red Hat, SUSE and Debian/Ubuntu notes how to install Eloquence from a package repository.

RPM package installation

The Eloquence package file may also be downloaded and installed separately. This may be required if the system has no connection to the Internet.

Verifying RPM file signature

Any Eloquence B.08.40 RPM packages are signed to allow verifying the package integrity and authenticity. The necessary public keys are included in the repositories and are used to automatically verify software updates. You can also verify the packages manually using the keys below.

Run the following command to verify an Eloquence B.08.40 RPM package:

rpm --checksig -v Eloquence.B0840.*.rpm
The output of this command shows whether the package is signed and which key signed it.

$ rpm --checksig -v Eloquence.B0840.2409-1-el8.x86_64.rpm
Eloquence.B0840.2409-1-el8.x86_64.rpm:
    Header V4 RSA/SHA256 Signature, key ID 984685ff: OK
    Header SHA256 digest: OK
    Header SHA1 digest: OK
    Payload SHA256 digest: OK
    V4 RSA/SHA256 Signature, key ID 984685ff: OK
    MD5 digest: OK
The following GPG keys are used:

2048R/984685FF (2018-06-15)
Download: Marxmeier
Fingerprint: 4956 33F7 9F1C 7893 1C63 B1CD 09EB 632C 9846 85FF

Installing the RPM package

Different builds of the Eloquence software are available. Please choose the appropriate version that corresponds with your system:

Eloquence.B0840-*.x86_64.rpm
Eloquence rpm file (x86_64, 64 bit)
This is the build for a 64 bit OS running on AMD64/EM64T (x86_64) based systems. Includes support for 32 bit x86 applications.

The asterisk (*) denotes the version of the RPM package. Higher numbers indicate a newer installation archive.

To install Eloquence execute the command below. This example uses the 64 bit x86_64 build.

rpm -i Eloquence.B0840-*.x86_64.rpm

Eloquence uses systemd to manage its services. The default systemd unit files are provided in the directory /opt/eloquence/8.4/newconfig/systemd and installed in a system location.

If systemd is not available (for example, installing a container) custom startup and shutdown scripts need to be provided. An example is provided in the newconfig/rceloq directory.

Automatic startup of Eloquence server processes during system boot is configured via systemctl enable/disable.

Uninstalling Eloquence B.08.40

To uninstall Eloquence B.08.40 from your system, please make sure the software is not currently in use. The following command may be used to shut down the Eloquence background processes.

systemctl stop eloquence84.target
The software is removed using the rpm utility. Please login as root and run rpm as below
rpm -e Eloquence.B0840

Please note that any changed files (typically customized configuration files) are not removed. If necessary they need to be removed manually.

Eloquence B.08.40 is installed in the following directories:

  • /opt/eloquence/8.4
  • /etc/opt/eloquence/8.4
  • /var/opt/eloquence/8.4


Red Hat (RHEL/Fedora and compatible) specific notes

On RedHat and compatible distributions dnf is used preferably to manage packages.

Installation using the Eloquence package repository

The recommended installation procedure uses the Eloquence package repository to install and update the Eloquence B.08.40 release. The procedure below adds the Eloquence package repository, imports the Eloquence package signing key and installs Eloquence B.08.40.

Add the Eloquence repository

dnf config-manager --add-repo \
  https://marxmeier.com/download/repo/rpm/eloquence-beta-el8.repo
This refers to the Eloquence beta repository for RHEL 8.x and compatible.

Import the public key to verify package integrity and authenticity (recommeded but optional)

rpmkeys --import \
  https://marxmeier.com/download/repo/rpm/RPM-GPG-KEY
then install Eloquence
dnf install Eloquence.B0840

Eloquence depends on the openssl libraries but does not include a dependency on a specific openssl version as openssl versions may differ.
As openssl is typically installed by default this is not a concern other than for a minimal container installation. In this case the openssl utility needs to be installed before Eloquence.

dnf install openssl
If 32-bit application support is needed, the 32-bit openssl library needs to be installed before Eloquence.
dnf install openssl-libs.i686

Installation without the Eloquence package repository

The dnf (or yum) command may also be used to install Eloquence without using the Eloquence package repository. The example below downloads the rpm package and installs it directly. As an optional (but recommended) step the Eloquence package signing key is imported so the package integrity and authenticity can be verified.

Import the public key to verify package integrity and authenticity (recommeded but optional)

rpmkeys --import \
  https://marxmeier.com/download/repo/rpm/RPM-GPG-KEY
Download and install the rpm package
dnf install https://marxmeier.com/download/repo/rpm/\
  eloq-beta-el8/x86_64/Eloquence.B0840.2409-*-el8.x86_64.rpm

The rpm file may also be downloaded and installed separately. This may be required if the system has no connection to the Internet. It is also recommended to download and import the Eloquence package signing key as shown above.

dnf install Eloquence.B0840-2409-*-el8.x86_64.rpm

Finally, the rpm command may also be used to install the Eloquence package. However, this requires to resolve any dependencies manually.

Installing the Eloquence 64-bit rpm package may require installation of the 32-bit glibc library to resolve a dependency error on glibc. The 64-bit Eloquence rpm package includes some 32-bit libraries to allow interoperability with 32-bit applications. However, a 64-bit Fedora or RHEL may not install the 32-bit glibc library by default. In this case please install the glibc.i686 package.


SUSE (SLES/openSUSE) specific notes

On SUSE and compatible distributions zypper is used preferably to manage packages.

Installation using the Eloquence package repository

The recommended installation procedure uses the Eloquence package repository to install and update the Eloquence B.08.40 release. The procedure below adds the Eloquence repository, imports the Eloquence package signing key and installs Eloquence B.08.40.

Add the Eloquence repository

zypper addrepo -f \
  https://marxmeier.com/download/repo/rpm/eloquence-beta-s15.repo
This refers to the Eloquence beta repository for SLES 15 and compatible. Unfortunately, SUSE uses an incompatible ncurses package configuration and requires separate packages.

Import the public key to verify package integrity and authenticity (recommeded but optional)

rpmkeys --import \
  https://marxmeier.com/download/repo/rpm/RPM-GPG-KEY
then install Eloquence
zypper install Eloquence.B0840

Eloquence depends on the openssl libraries but does not include a dependency on a specific openssl version as openssl versions may differ.
As openssl is typically installed by default this is not a concern other than for a minimal container installation. In this case the openssl utility needs to be installed before Eloquence.

zypper install openssl
If 32-bit application support is needed, the 32-bit openssl library needs to be installed before Eloquence.
zypper install libopenssl1_1-32bit
 - or -
zypper install libopenssl3-32bit

Installation without the Eloquence package repository

The zypper command may also be used to install Eloquence without using the Eloquence package repository. The example below downloads the rpm archive and installs it directly. As an optional (but recommended) step the Eloquence package signing key is imported so the package integrity and authenticity can be verified.

Import the public key to verify package integrity and authenticity (recommeded but optional)

rpmkeys --import \
  https://marxmeier.com/download/repo/rpm/RPM-GPG-KEY
Download and install the rpm file
zypper install https://marxmeier.com/download/repo/rpm/\
  eloq-beta-s15/x86_64/Eloquence.B0840.2409-*-s15.x86_64.rpm
The rpm file may also be downloaded and installed separately. This may be required if the system has no connection to the Internet. It is also recommended to download and import the Eloquence package signing key as shown above.
zypper install Eloquence.B0840-2409-*-s15.x86_64.rpm

The rpm command may also be used to install the Eloquence package manually. However, this requires to resolve any dependencies manually.


Debian/Ubuntu specific notes

The following notes apply to Debian or Linux distributions derived from Debian (such as Ubuntu).

Installation using the Eloquence package repository

The recommended installation procedure uses the Eloquence Debian package repository to install and update the Eloquence B.08.40 release. The procedure below adds the Eloquence repository, imports the Eloquence package signing key and installs Eloquence B.08.40.

To add the repository please add the eloquence-beta-d11.list file to the /etc/apt/sources.list.d directory.

( cd /etc/apt/sources.list.d && wget \
  https://marxmeier.com/download/repo/deb/eloquence-beta-d11.list )
Import the repository signing key to the apt key ring. This is used to verify the integrity of the repository.
wget -O /etc/apt/trusted.gpg.d/eloquence.asc \
  https://marxmeier.com/download/repo/deb/signing.key
Refresh the apt cache and install Eloquence
sudo apt update
sudo apt install eloquence.b0840

Eloquence depends on the openssl libraries but does not include a dependency on a specific openssl version as openssl versions may differ.
As openssl is typically installed by default this is not a concern other than for a minimal container installation. In this case the openssl utility needs to be installed before Eloquence.

sudo apt install openssl
If 32-bit application support is needed, the 32-bit openssl library needs to be installed before Eloquence.
sudo apt install libssl1.1:i386
 - or -
sudo apt install libssl3:i386

Installation without the Eloquence repository

The Eloquence deb package may also be downloaded and installed separately. This may be required on systems that are not connected to the Internet.

Eloquence does provide a Debian specific .deb installation package. You may then install Eloquence with the command below:

sudo dpkg -i eloquence.b0840_8.40.2409-*_amd64.deb
Please keep in mind that when installing packages manually (instead of using apt) any dependencies may need to be resolved manually. On x86_64 systems, installation of the libc6:i386 package may be necessary as Eloquence supports both 32 bit and 64 bit applications.


 
 
 
  Privacy | Webmaster | Terms of use | Impressum Revision: 2024-09-20  
  Copyright © 1995-2024 Marxmeier Software AG