Linux Platform Installation Notes Revision: 2006-01-11 ================================= Supported Linux releases ------------------------ Eloquence is available for the x86 architecture. While Eloquence is not distribution specific it was only tested against SUSE Linux and RedHat Linux distributions. Other Linux distributions are expected work but have not been tested. They may also require additional steps for installation if the distribution does not follow the LSB. Eloquence is available as a rpm package for glibc2.2 or glibc2.3 based systems. License keys ------------ Eloquence B.07.10 requires a license key version B.07.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. The default license file includes a license key for the Eloquence Personal Edition. Please request a new permanent license key using the form included with the delivery or refer to the Eloquence web site at http://www.marxmeier.com/eloquence/license 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: 5 MB File systems: /opt 12 MB /etc 1 MB /var 1 MB The system should be based on the glibc2.2 or glibc2.3 library. Please make sure that at least following shared library versions are installed: glibc 2.2.5 libc.so.6 libm.so.6 ld-linux.so.2 ncurses libncurses.so.5.2 Eloquence provides its own copy of the following libraries in the /opt/eloquence6/lib directory: libstdc++ libstdc++-libc6.2-2.so.3 This library has been included to solve posssible compatibility problems with various Linux distributions using incompatible versions of this library. Eloquence B.07.10 was compiled with gcc2.95.3 for the glibc2.2 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. NOTE: Any previous HP Eloquence A.06.xx product (B1368B) must be uninstalled before Eloquence can be installed. A rpm update is not possible. Please refer to the update section below for details. Please check the Eloquence web site for updates and patches. URL: http://www.marxmeier.com/eloquence/support/ To install Eloquence execute the command below: rpm -i Eloquence-B0710.glibc2.2-*.i386.rpm To update an existing Eloquence installation, please shut down Eloquence and execute the command below: SUSE Linux: /etc/init.d/eloq6 stop rpm -U Eloquence-B0710.glibc2.2-*.i386.rpm /etc/init.d/eloq6 start RedHat Linux: /etc/rc.d/init.d/eloq6 stop rpm -U Eloquence-B0710.glibc2.2-*.i386.rpm /etc/rc.d/init.d/eloq6 start Installation of automatic startup of Eloquence servers during boot is only performed for SUSE and RedHat 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/eloquence6/newconfig/startup. Updating from a previous Eloquence version ========================================== When updating from a previous HP Eloquence A.06.xx release (B1368B product) the previous HP Eloquence product needs to be uninstalled. Eloquence uses a different package name than previous HP Eloquence releases and cannot be installed without uninstalling any previous HP Eloquence release. To uninstall a previous HP Eloquence release, execute the command below: rpm -e B1368B This will remove the HP Eloquence product but leaves the configuration files in place. After that, please proceed to install the new Eloquence version. License key ----------- Eloquence B.07.10 requires a license key version B.07.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 using the commercial Eloquence version, please request the appropriate license key _before_ updating Eloquence. Currently no temporary license key is generated on the Linux platform during installation. The 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 any previous entries when adding the new B.07.10 license key to the license file /etc/opt/eloquence6/license. Otherwise the new license may not be recognized and chklic might output a message like below: B.07.00: Bad license key revision. Duplicate sequence number: Ignoring license Eloquence Personal Edition -------------------------- With the Eloquence Personal Edition, please copy the B.07.10 license file template to /etc/opt/eloquence6/license. The new license file includes an updated license key for the Eloquence Personal Edition. cp /opt/eloquence6/newconfig/config/license /etc/opt/eloquence6/license Startup configuration --------------------- Updating from B.07.00 and B.06.32 The B.07.10 startup script adds an additional configuration option and uses a new startup configuration file template. An new option may be used to configure starting and stopping a database instances without requiring root privileges. Previous startup configuration files are compatible. An update of the startup configuration file is only needed when using the new start/stop option. Please note that the B.07.10 startup configuration no longer supports the eloqdb5 daemon. Updating from releases before B.06.32 The B.07.10 startup script provides additional configuration options and uses a new startup configuration file template which supports multiple eloqdb6 instances. Previous startup configuration files are compatible. It is recommended to use a new template configuration file and manually change any options. The startup configuration file is located at /etc/sysconfig/eloquence6. To copy over the new template configuration file please execute the command below: cp /opt/eloquence6/newconfig/startup/eloquence.rc \ /etc/sysconfig/eloquence6