|
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.
In addition a build for the 64-bit aarch64 (arm64) architecture
is available in the deb repository.
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-2-el8.x86_64.rpm
Eloquence.B0840.2409-2-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 package 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.
Files with a version suffix el8 are intended for use with RHEL 8.x
and compatible, a version suffix s15 indicates compatibility with
SUSE Linux.
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 must be used.
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://repo.marxmeier.com/rpm/eloquence-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://repo.marxmeier.com/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
To enable access to Eloquence test versions the eloquence-beta-el8
repository may be added.
dnf config-manager --add-repo \
https://repo.marxmeier.com/rpm/eloquence-beta-el8.repo
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://repo.marxmeier.com/rpm/RPM-GPG-KEY
Download and install the rpm package
dnf install https://repo.marxmeier.com/rpm/\
eloquence-el8/x86_64/Eloquence.B0840.2409-2-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://repo.marxmeier.com/rpm/eloquence-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://repo.marxmeier.com/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
To enable access to Eloquence test versions the eloquence-beta-s15
repository may be added.
zypper addrepo -f \
https://repo.marxmeier.com/rpm/eloquence-beta-s15.repo
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://repo.marxmeier.com/rpm/RPM-GPG-KEY
Download and install the rpm file
zypper install https://repo.marxmeier.com/rpm/\
eloquence-s15/x86_64/Eloquence.B0840.2409-2-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-d11.list
file to the /etc/apt/sources.list.d directory.
( cd /etc/apt/sources.list.d && wget \
https://repo.marxmeier.com/deb/eloquence-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://repo.marxmeier.com/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
To enable access to Eloquence test versions the eloquence-beta-d11
repository list may be added.
( cd /etc/apt/sources.list.d && wget \
https://repo.marxmeier.com/deb/eloquence-beta-d11.list )
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.
|
