|
This document contains installation instructions specific to the Linux platform.
Please refer to the general installation notes
in the Eloquence B.08.30 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 and RedHat Linux distributions.
Other Linux distributions are expected to work but may not have
been fully tested or require additional manual configuration steps
after installation if the distribution does not implement systemd
or LSB compatibility.
The following prerequisites must be met:
Linux distributions RHEL 7.x, SLES 11 and Ubuntu 1804 LTS were
tested and are supported along with newer versions.
System requirements
Eloquence is available for the x86_64 (Intel/AMD 64 bit)
and x86 (32 bit) architectures. The 64 bit x86_64 build supports
both 32 bit and 64 bit applications on 64 bit systems.
The 32 bit x86 build is limited to 32 bit applications and intended
for use with systems that only support 32 bit environments.
Please note that Linux on Itanium is no longer supported as of
B.08.30 as the Itanium platform is no longer supported by current
Linux distributions.
Eloquence requires disk space in the /etc, /opt and /var file systems
as indicated below:
- AMD64/EM64T (x86_64) based systems (default)
-
File systems: /opt 25 MB, /etc 1 MB, /var 1 MB
- IA32 (x86) based systems (32 bit systems)
-
File systems: /opt 20 MB, /etc 1 MB, /var 1 MB
Eloquence B.08.30 was compiled with gcc 4.3.4 for the x86 and
x86_64 builds.
Supported OpenSSL versions
Eloquence uses the OpenSSL library for cryptographic functions.
Eloquence was tested with the OpenSSL 0.9.8, 1.0, 1.1 and 3.0 library
versions. The OpenSSL library must be available as libcrypto.so.
A symbolic link in the Eloquence lib and lib64 directories is created
during installation. To force Eloquence to use a specific crypto library,
this symbolic link may be changed.
For example:
ln -s /lib/libcrypto.so.1.0.0 /opt/eloquence/8.3/lib/libcrypto.so
ln -s /lib64/libcrypto.so.1.0.0 /opt/eloquence/8.3/lib64/libcrypto.so
The eloqsd server may use the OpenSSL libssl.so library. A symbolic
link is created during installation.
Installation
Eloquence is available as an RPM package for the
x86_64 (64 bit x86) and x86 (i686) 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.
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
As of Eloquence B.08.30 the 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.30 RPM package:
rpm --checksig -v Eloquence.B0830.*.rpm
The output of this command shows whether the package is signed and which
key signed it.
# rpm --checksig -v Eloquence.B0830.1806-1.x86_64.rpm
Eloquence.B0830.1806-1.x86_64.rpm:
Header V4 RSA/SHA256 Signature, key ID 984685ff: OK
Header SHA1 digest: OK (5457bcb56c21bd6db1a1baf01dd89eb6f6973afa)
V4 RSA/SHA256 Signature, key ID 984685ff: OK
MD5 digest: OK (599cdaf402b83ec7361ad63ac268bedf)
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 archive
Different builds of the Eloquence software are available.
Please choose the appropriate version that corresponds with your system:
- Eloquence.B0830-*.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.
- Eloquence.B0830-*.i686.rpm
-
Eloquence rpm file (x86, 32 bit).
This build does not include any 64 bit support and should not be
installed on 64 bit operating systems.
The asterisk (*) denotes the version of the RPM archive. 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.B0830-*.x86_64.rpm
Installation of automatic startup of Eloquence servers during boot
is only performed for distributions supporting systemd to manage
services or SUSE, RedHat, Debian and LSB compliant distributions
supporting SystemV init scripts.
For other Linux distributions, the startup and shutdown scripts need
to be added manually.
Template files are provided in the directory
/opt/eloquence/8.3/newconfig/startup.
Automatic startup of Eloquence server processes during system boot is
configured via systemctl enable/disable on systems supporting systemd
or the /etc/sysconfig/eloquence83 configuration file
otherwise.
Uninstalling Eloquence B.08.30
To uninstall Eloquence B.08.30 from your system, please make sure the
software is not currently used. The following command may be
used to shut down the Eloquence background processes.
When using systemd:
systemctl stop eloquence83.target
When using SystemV start/stop scripts:
/etc/init.d/eloq83 stop
The software is removed using the rpm utility. Please login as root and run
rpm as below
rpm -e Eloquence.B0830
Please note that any changed files (typically customized configuration files)
are not removed. If necessary they need to be removed manually.
Eloquence B.08.30 is installed in the following directories:
- /opt/eloquence/8.3
- /etc/opt/eloquence/8.3
- /var/opt/eloquence/8.3
Red Hat (Fedora/RHEL/CentOS) specific notes
For RedHat or compatible distributions yum is used to
manage packages. For Fedora 22 (or newer) the dnf command is used
instead of yum.
Installation using the Eloquence repository
The recommended installation procedure uses the Eloquence repository
to install and update the Eloquence B.08.30 release.
The procedure below adds the Eloquence repository, imports the
Eloquence package signing key and installs Eloquence B.08.30.
Add the Eloquence repository
yum-config-manager --add-repo \
https://marxmeier.com/download/repo/rpm/eloquence.repo
As an alternative to yum-config-manager the following commands may
be used:
( cd /etc/yum.repos.d/ && wget \
https://marxmeier.com/download/repo/rpm/eloquence.repo )
Import the public key to verify package integrity and authenticity
(recommeded but optional)
rpm --import \
https://marxmeier.com/download/repo/rpm/RPM-GPG-KEY
Install Eloquence
yum install Eloquence.B0830
Installation without the Eloquence repository
The yum (or dnf) command may also be used to install Eloquence without
using the Eloquence repository. The example below downloads the rpm
archive and installs it. 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)
rpm --import \
https://marxmeier.com/download/repo/rpm/RPM-GPG-KEY
Download and install the rpm file
yum install https://marxmeier.com/download/eloq/B0830/linux/\
Eloquence.B0830-2211-23.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.
yum localinstall Eloquence.B0830-2211-23.x86_64.rpm
The rpm command may also be used to install the Eloquence package
manually. However, this requires to resolve any dependencies
manually.
Installing the Eloquence 64-bit rpm on Fedora or RHEL 6 may require
installation of the 32-bit glibc library to resolve a dependency
error on glibc.
The 64-bit Eloquence rpm includes some 32-bit libraries to allow
interoperability with 32-bit applications.
However, 64-bit Fedora or RHEL may not install the 32-bit glibc library.
In this case please install the glibc.i686 package.
Red Hat Enterprise Linux 9 specific notes
Installation of Eloquence B.08.30 on Red Hat Enterprise Linux 9 requires
the following manual steps:
-
The RHEL 9 standard repositories no longer include the ncurses-compat-libs.
Consequently, installing Eloquence 8.30 will fail with missing ncurses
dependencies.
As a workaround it is possible to download the ncurses source RPM and
use rpmbuild --rebuild to create the missing ncurses-compat-libs
package for a subsequent dnf localinstall.
$ su -c "dnf install rpmdevtools"
$ dnf download --source ncurses
$ su -c "dnf builddep ncurses-6.2-8.20210508.el9.src.rpm"
$ rpmbuild -rb ncurses-6.2-8.20210508.el9.src.rpm
$ su -c "dnf localinstall rpmbuild/RPMS/x86_64/ncurses-compat-libs-6.2-8.20210508.el9.x86_64.rpm"
As an alternative to the above effort there are several other approaches,
such as installing the ncurses-compat-libs package from Fedora Project's EPEL
repository, or from Rocky Linux or AlmaLinux "devel" repositories. Using the
rpm packages from those other repositories is typically more convenient than
building your own rpm.
For example, using Fedora Project's EPEL repository:
# dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
# dnf install ncurses-compat-libs
See this ReadMe
document for details.
Installing the Eloquence.B0830 package should now work without errors.
SUSE (openSUSE/SLES) specific notes
On SUSE and compatible distributions zypper is
used preferably to manage packages.
When installing Eloquence B.08.30 on openSUSE 15 or newer, installation
of the libncurses5 package is required, otherwise installation will fail
due to an unmet dependency on libncursesw.so.5.
The libncurses5 package is included in the standard repository.
Please note that as of SLES 15, the libncurses5 package has been moved
into the "sle-module-legacy" repository, which has to be added explicitly
in the yast software-repositories during or after SLES 15 installation.
Installation using the Eloquence repository
The recommended installation procedure uses the Eloquence repository
to install and update the Eloquence B.08.30 release.
The procedure below adds the Eloquence repository, imports the
Eloquence package signing key and installs Eloquence B.08.30.
Add the Eloquence repository
zypper addrepo -f \
https://marxmeier.com/download/repo/rpm/eloquence.repo
Import the public key to verify package integrity and authenticity
(recommeded but optional)
rpm --import \
https://marxmeier.com/download/repo/rpm/RPM-GPG-KEY
Please note that some older rpm versions may not support fetching
the key from a remote server. In this case please download the
public key file and perform the rpm --import on the local file.
Install Eloquence
zypper install Eloquence.B0830
Installation without the Eloquence repository
The zypper command may also be used to install Eloquence without
using the Eloquence repository. The example below downloads the rpm
archive and installs it. 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)
rpm --import \
https://marxmeier.com/download/repo/rpm/RPM-GPG-KEY
Please note that some older rpm versions may not support fetching
the key from a remote server. In this case please download the
public key file and perform the rpm --import on the local file.
Download and install the rpm file
zypper install https://marxmeier.com/download/eloq/B0830/linux/\
Eloquence.B0830-2211-23.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.B0830-2211-23.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 repository
The recommended installation procedure uses the Eloquence debian
repository to install and update the Eloquence B.08.30 release.
The procedure below adds the Eloquence repository, imports
the Eloquence package signing key and installs Eloquence B.08.30.
To add the repository please add the .list
file to /etc/apt/sources.list.d
( cd /etc/apt/sources.list.d && wget \
https://marxmeier.com/download/repo/deb/eloquence.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-get update
sudo apt-get install eloquence.b0830
Installation without the Eloquence repository
The Eloquence package file 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 install Eloquence with the command below:
sudo dpkg -i eloquence.b0830_8.30.2211-23_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.
Ubuntu 24.04 LTS specific notes
Installation of Eloquence B.08.30 on Ubuntu 24.04 LTS or newer requires
the following manual steps:
-
The Ubuntu 24.04 standard repositories no longer include the libncurses*5 libs.
Consequently, installing Eloquence 8.30 will fail with missing ncurses
dependencies. A similar issue also applies to the old libodbc1 libdodbc2 libs.
As a workaround it is possible to use those older library versions from the
Ubuntu 22.04 repositories and use apt-mark hold to protect them from
being auto-removed by subsequent apt upgrade activities.
# cd /etc/apt/sources.list.d/
# sed 's,noble,jammy,g' ubuntu.sources >jammy.sources
# apt update
# apt install libncurses5 libncursesw5 libodbc1/jammy libodbc2/jammy
# apt-mark hold libodbc1 libodbc2
# sed -i 's,^,#,g' jammy.sources # disable jammy repositories again
Installing the Eloquence.B0830 package should now work without errors.
|
