.
contact contact

B.08.30 / 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.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:

  • glibc 2.3.5 based systems (or newer) supporting the NPTL based threading.

    This may be verified with the "getconf GNU_LIBPTHREAD_VERSION" command that should return "NPTL 2.3.5" (or newer).

  • OpenSSL 0.9.8b (or newer)

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 a convenience, you may also install this RPM from our web site:
    # rpm --import https://marxmeier.com/download/repo/rpm/RPM-GPG-KEY
    
    # dnf install \
      https://marxmeier.com/download/rhel-9/ncurses-compat-libs-6.2-8.20210508.el9.x86_64.rpm
    
    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.


 
 
 
  Privacy | Webmaster | Terms of use | Impressum Revision: 2022-11-24  
  Copyright © 1995-2024 Marxmeier Software AG