|
This document contains installation instructions specific to the Linux platform.
Please refer to the "Installation" section in the Eloquence B.08.20 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 available as an RPM package for the IA32 (i686), AMD64/EM64T (x86_64)
and IA64 (Itanium) architecture.
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 have not been tested and may require
additional manual configuration steps after installation if the distribution does
not implement LSB compatibility.
The following prerequisites must be met:
System requirements
Eloquence requires disk space in the /etc, /opt and /var file systems
as indicated below:
- IA32 (x86) based systems
-
File systems: /opt 20 MB, /etc 1 MB, /var 1 MB
- AMD64/EM64T (x86_64) based systems
-
File systems: /opt 20 MB, /etc 1 MB, /var 1 MB
- IA64 (Itanium) based systems
-
File systems: /opt 50 MB, /etc 1 MB, /var 1 MB
Please make sure the following shared library versions (or newer)
are installed:
glibc2.3.x
libncurses.so.5 (libncurses.so.5.4)
libstdc++.so.5 (libstdc++.so.5.0.6)
libgcc_s.so.1
libcrypto.so (libcrypto.so.0.9.7)
Eloquence B.08.20 was compiled with gcc 3.3.3 for the x86 and
x86_64 builds and icc 9.0 for the ia64 build.
Database encryption
Eloquence uses the OpenSSL crypto library for cryptographic
functions. To use database encryption, OpenSSL must be installed.
Eloquence was tested with the OpenSSL 0.9.7 and 0.9.8 library
versions. The OpenSSL library must be available as libcrypto.so.
If necessary create a symbolic link. To force Eloquence to use a
specific crypto library, a symbolic link may be created in the
Eloquence lib or lib64 directory.
For example:
ln -s /usr/lib/libcrypto.so.0.9.8 /opt/eloquence/8.2/lib/libcrypto.so
Installation
Eloquence is available as an rpm package.
The rpm package is not specific to a particular Linux distribution.
However, it has only been tested against SUSE and RedHat distributions.
If you encounter a problem during installation, please send us a notice at
support@marxmeier.com.
Different builds of the Eloquence software are available.
Please choose the appropriate version that corresponds with your system:
- Eloquence.B0820-*.i686.rpm
-
Eloquence rpm file (x86, 32 bit)
- Eloquence.B0820-*.x86_64.rpm
-
Eloquence rpm file (x86_64, 64 bit)
This build requires a 64 bit OS running on AMD64/EM64T (x86_64) based systems.
Includes support for 32 bit x86 applications.
- Eloquence.B0820-*.ia64.rpm
-
Eloquence rpm file (Itanium2, 64 bit)
Includes support for 32 bit x86 applications.
The asterisk (*) denotes the version of the RPM archive. Higher numbers indicate a
newer installation archive.
Installing the RPM archive
To install Eloquence execute the command below. This example uses the 32 bit x86 build.
rpm -i Eloquence.B0820-*.i686.rpm
Installation of automatic startup of Eloquence servers during boot is only performed
for SUSE, RedHat, Debian or LSB compliant distributions. If using another Linux
distribution, the startup and shutdown scripts need to be added manually.
Template files are provided in the directory /opt/eloquence/8.2/newconfig/startup.
Automatic startup of Eloquence server processes during system boot is configured in
the /etc/sysconfig/eloquence82 configuration file.
Uninstalling Eloquence B.08.20
To uninstall Eloquence B.08.20 from your system, please make sure the
software is not currently used. Either of the following command may be used
to shut down the Eloquence background processes.
/etc/init.d/eloq82 stop
/usr/sbin/rceloq82 stop
The software is removed using the rpm utility. Please login as root and run
rpm as below
rpm -e Eloquence.B0820
Please note that any changed files (typically customized configuration files)
are not removed. If necessary they need to be removed manually.
Eloquence B.08.20 is installed in the following directories:
- /opt/eloquence/8.2
- /etc/opt/eloquence/8.2
- /var/opt/eloquence/8.2
Ret Hat (Fedora and RHEL) specific notes
When installing Eloquence B.08.20 on Fedora 9 or newer, installation
of the compat-libstdc++-33 package is required.
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.
Using yum (or dnf) is helpful for installing with dependencies:
yum install http://eloquence.marxmeier.com/download/B0820/linux/Eloquence.B0820-3.x86_64.rpm
SUSE (openSUSE and SLES) specific notes
When installing Eloquence B.08.20 on SUSE 11.1 or newer, installation
of the libstdc++-33 package is required. Otherwise installation will
fail due to an unmet dependency on libstdc++.so.5.
Note that as of SLES 12, the libstdc++-33 package has been moved into
the Legacy_Module_12_x86_64 repository, which has to be added explicitly
in yast repositories during or after SLES 12 installation.
Using zypper is helpful for installing with dependencies:
zypper install http://eloquence.marxmeier.com/download/B0820/linux/Eloquence.B0820-3.x86_64.rpm
If libstdc++-33 is missing in your repositories,
including software.opensuse.org might be useful:
zypper install \
http://eloquence.marxmeier.com/download/B0820/linux/Eloquence.B0820-3.x86_64.rpm \
http://download.opensuse.org/repositories/devel:/gcc/openSUSE_Leap_42.1/x86_64/libstdc++33-3.3.3-33.1.x86_64.rpm
Debian/Ubuntu specific notes
The following notes apply to Debian based Linux systems and Linux distributions
derived from Debian (such as Ubuntu).
Eloquence currently does not provide a Debian specific .deb installation package.
The Debian "alien" utility may be used to install the Eloquence RPM package.
To install the "alien" utility on your system, please execute the commands below:
sudo apt-get update
sudo apt-get install alien
After that, you may install Eloquence with the command below:
sudo alien -i Eloquence.B0820-*.i686.rpm --scripts
The configuration file /etc/default/eloquence82 is used for configuring
the start/stop scripts and the automatic startup on system boot.
On Debian 4.0 based systems (or newer), installation of the libstdc++5 package is required.
To install it from the command line, the command below may be used:
sudo apt-get install libstdc++5
On x86_64 systems, you also need to install the ia32-libs or libc6:i386 package.
sudo apt-get install ia32-libs # prior to MultiArch
OR
sudo apt-get install libc6:i386 # if using MultiArch
|
