.
contact contact

B.08.10 / Release Notes / Installation

Installation on Linux

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

Please refer to the "Installation" section in the Eloquence B.08.10 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:

  • Linux 2.6.9 kernel (or newer)

  • glibc 2.3 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.4" (or newer).

  • OpenSSL 0.9.7 (or newer)

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.10 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.1/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.

Please check the Eloquence web site for any updates or recommended patches: http://eloquence.marxmeier.com/support/B0810

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

Eloquence.B0810-*.i686.rpm
Eloquence rpm file (x86, 32 bit)

Eloquence.B0810-*.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.B0810-*.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.B0810-*.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.1/newconfig/startup.

Automatic startup of Eloquence server processes during system boot is configured in the /etc/sysconfig/eloquence81 configuration file.

Uninstalling Eloquence B.08.10

To uninstall Eloquence B.08.10 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/eloq81 stop
/usr/sbin/rceloq81 stop
The software is removed using the rpm utility. Please login as root and run rpm as below
rpm -e Eloquence.B0810

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

Eloquence B.08.10 is installed in the following directories:

  • /opt/eloquence/8.1
  • /etc/opt/eloquence/8.1
  • /var/opt/eloquence/8.1

Ret Hat (Fedora and RHEL) specific notes

When installing Eloquence B.08.10 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.

SUSE specific notes

When installing Eloquence B.08.10 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.

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.B0810-*.i686.rpm --scripts
The configuration file /etc/default/eloquence81 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 package.

sudo apt-get install ia32-libs


 
 
.
 
 
  Privacy | Webmaster | Terms of use | Impressum Revision:  2011-11-09  
  Copyright © 2010 Marxmeier Software AG