Linux Platform Installation Notes Revision: 2010-02-05 ================================= Supported Linux releases ------------------------ Eloquence is available as an RPM package for the IA32 (i686), AMD64/EM64T (x86_64) and IA64 (Itanium) architecture. While Eloquence is not distribution specific, it was only tested against SUSE Linux and RedHat Linux distributions. Other Linux distributions are expected to work, but have not been tested. They may also require additional steps for installation if the distribution does not follow the LSB. The following prerequisites must be met: * Linux 2.6.9 kernel * glibc2.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). License keys ------------ Eloquence B.08.10 requires a license key version B.08.10 or above. For a new Eloquence installation or when upgrading from a previous Eloquence version a new license key must be obtained to use the Eloquence server components. Please request a permanent license key using the form included with the delivery or refer to the Eloquence web site at URL http://eloquence.marxmeier.com/license. The default license file includes a license key for the Eloquence Personal Edition. 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 libcrpyto.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 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.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. 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.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. (On Debian/Ubuntu the file is /etc/default/eloquence81). 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 Fedora specific notes --------------------- When installing Eloquence B.08.10 on Fedora 9 or newer, installation of the compat-libstdc++-33 package is required. 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, 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 Updating from a previous Eloquence version ========================================== When updating from a previous Eloquence A.06.xx, B.06.xx, B.07.xx or B.08.00 release, the following actions should be performed in addition to updating the software. License key ----------- Eloquence B.08.10 requires a license key version B.08.10 or above. For a new Eloquence installation or when upgrading from a previous Eloquence version, a new license key must be obtained to use the Eloquence server components. If you are using a commercial Eloquence version, please request your new B.08.10 license key before updating Eloquence. A new license key can be requested by either submitting the form enclosed with your software update or on-line at the Eloquence web site: http://eloquence.marxmeier.com/license. Please comment out the previous license key when adding the new B.08.10 license key to your license file /etc/opt/eloquence/8.1/license. Otherwise the new license may not be recognized and chklic might output the following messages: B.08.00: Bad license key revision. Duplicate sequence number: Ignoring license Eloquence Personal Edition -------------------------- The Eloquence B.08.10 default license file includes a license key for the Eloquence Personal Edition. It is installed by default and also available in /opt/eloquence/8.1/newconfig/config/license. Startup configuration --------------------- Eloquence B.08.10 uses the separate startup/shutdown script /etc/init.d/eloq81 (or /usr/sbin/rceloq81 on SUSE Linux) The B.08.10 startup script uses a separate configuration file. A default configuration file is installed. Any customizations from a previous Eloquence version need to be copied manually. The startup configuration file is /etc/sysconfig/eloquence81 Configuration files ------------------- Eloquence B.08.10 uses separate configuration files in the /etc/opt/eloquence/8.1 directory. Default configuration files are installed. Any customizations from a previous installation need to be copied manually.