Linux Platform Installation Notes Revision: 2008-05-28 ================================= Supported Linux releases ------------------------ Eloquence is available as a RPM package for the x86, x86_64 and Itanium2 architecture. Eloquence is not distribution specific, however it was only tested against selected SUSE Linux and RedHat Linux distributions. Other Linux distributions are expected 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 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.5" (or newer). Previous Eloquence versions --------------------------- Eloquence B.08.00 may be installed in parallel with any previous Eloquence release. Eloquence B.08.00 uses a different package name (Eloquence.B0800), a previous version is not replaced. Eloquence B.08.00 is installed in the /opt/eloquence/8.0 directory and the configuration files reside in the /etc/opt/eloquence/8.0 directory. License keys ------------ Eloquence B.08.00 requires a license key version B.08.00 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. You may use the /opt/eloquence/8.0/etc/chklic command to verify your license file. System Requirements ------------------- Eloquence requires disk space in the /etc, /opt and /var file directories or file systems as indicated below: Temporary disk space for the distribution file: 10 MB File systems: /opt 20 MB /etc 1 MB /var 1 MB Please make sure at least the following shared library versions are installed: glibc2.3.x libncurses.so.5 (libncurses.so.5.4) libstdc++.so.5 (libstdc++.so.5.0.6) libgcc_s.so.1 Eloquence B.08.00 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 a 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 updates and patches. http://eloquence.marxmeier.com/support/ Different builds of the Eloquence software is available. Please choose the appropriate version which corresponds with your system: Eloquence.B0800-*-1-i686.rpm Eloquence rpm file (x86, 32 bit) Eloquence.B0800-*-1-x86_64.rpm Eloquence rpm file (x86_64, 64 bit) This build requires the OS running in 64 bit mode on AMD64/EM64T Eloquence.B0800-*-1-ia64.rpm Eloquence rpm file (Itanium2, 64 bit) To install Eloquence execute the command below: rpm -i Eloquence.B0800-*.i686.rpm To update a previous Eloquence 8.0 installation, please shut down Eloquence using the command below: /etc/init.d/eloq8 stop Then perform the update with a command like below: rpm -U Eloquence.B0800-*.i686.rpm After the update has finished Eloquence can be started with the command below: /etc/init.d/eloq8 start 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 start and shutdown scripts need to be added manually. Template files are provided in the directory /opt/eloquence/8.0/newconfig/startup. Automatic startup of Eloquence server processes during system boot is (by default) configured in the /etc/sysconfig/eloquence8 configuration file. Debian specific notes --------------------- The following notes apply to Debian based Linux systems in addition: Eloquence currently does not provide a Debian specific .deb package and the "alien" utility must be used to install the RPM package. To install "alien", execute the commands below: sudo apt-get update sudo apt-get install alien After that, you can install Eloquence: sudo alien -i Eloquence.B0800-*.i686.rpm --scripts The configuration file /etc/default/eloquence8 is used for startup configuration. Updating from a previous Eloquence version ------------------------------------------ When updating from a previous Eloquence A.06.xx, B.06.xx or B.07.xx release the following actions should be performed in addition to updating the software. License key ----------- Eloquence B.08.00 requires a license key version B.08.00 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.00 license key before updating Eloquence. As an alternative you have the option to install a temporary license key during installation which is valid for a period of four weeks. 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. You may use the /opt/eloquence/8.0/etc/chklic command to verify your license file. Please comment out previous license keys when adding the new B.08.00 license key to your license file /etc/opt/eloquence/8.0/license. Otherwise the new license may not be recognized and chklic might output the following messages: B.07.00: Bad license key revision. Duplicate sequence number: Ignoring license Eloquence Personal Edition -------------------------- With the Eloquence Personal Edition, please copy the B.08.00 license file template to /etc/opt/eloquence/8.0/license. The new license file includes an updated license key for the Eloquence Personal Edition. cp /opt/eloquence/8.0/newconfig/config/license \ /etc/opt/eloquence/8.0/license Startup configuration --------------------- The B.08.00 startup script uses a different configuration file from previous versions. A default configuration file is installed on supported distributions. Any customizations from a previous installation need to be copied manually. The eloq8 startup configuration file is /etc/sysconfig/eloquence8 To copy over the new template configuration file please execute the command below: cp /opt/eloquence6/newconfig/startup/eloquence.rc \ /etc/sysconfig/eloquence8 Default database config file ---------------------------- The default database server config file has been changed from eloqdb6.cfg to eloqdb.cfg and it resides in the changed default directory /etc/opt/eloquence/8.0 -- this change requires manual adjustments if you update from earlier Eloquence versions and have used the previous default config file in the past. The installation of the Eloquence 8 software creates a default database server config in /etc/opt/eloquence/8.0/eloqdb.cfg that is based on the template in /opt/eloquence/8.0/newconfig/config. If you are updating from an earlier Eloquence version and want to continue using the "default server instance", you need to copy your customized /etc/opt/eloquence6/eloqdb6.cfg over to the new /etc/opt/eloquence/8.0/eloqdb.cfg file: cp /etc/opt/eloquence6/eloqdb6.cfg \ /etc/opt/eloquence/8.0/eloqdb.cfg If you plan to start the default server with either Eloquence 8 or the prior Eloquence version, for example during an initial validation phase, then it might be better to use a symbolic link instead of a copy: ln -s /etc/opt/eloquence6/eloqdb6.cfg \ /etc/opt/eloquence/8.0/eloqdb.cfg Without one of the above steps, some of the Eloquence database utilities, like dbvolcreate, dbvolextend, or dbvoldump, for example, will no longer work without specifying the path to the config file using the -c command line option explicitly.