HP Eloquence A.06.31 Revision: 2001-07-09 ---------------------------------------------------------------------- Linux platform installation notes ================================= HP Eloquence A.06.31 requires a license key version A.06.30 or above. For a new HP Eloquence installation or when upgrading from a HP Eloquence version before A.06.30 a new license key must be installed in order to use the HP Eloquence server components. When updating from revision A.06.30 no new license key is required. The default license file includes a license key for the HP Eloquence Personal Edition. Please request a new permanent license key using the form included with the delivery or refer to the HP Eloquence web site at http://www.hp-eloquence.com/license/ HP Eloquence for the Linux platform is available in separate packages for libc6 (also known as glibc2) and libc5 based systems. libc6 (glibc2) based systems ---------------------------- Recent Linux distributions (such as SuSE 6.x or RedHat 5.x) are based on the glibc2 library and it is recommended to use the HP Eloquence libc6 package for installation. Please make sure that at least following shared library versions are installed: libc.so.6 (glibc-2.0.6) libm.so.6 (glibc-2.0.6) For distributions using a newer version of the glibc library such as SuSE 6.2 and above or Red Hat 6.x and above you may need to install backwards compatible library versions. HP Eloquence provides its own copy of the following libraries in the /opt/eloquence6/lib directory: libncurses.so.4.2 libstdc++.so.2.9 Those libraries have been included to solve compatibility problems with various Linux distributions providing prossibly incompatible versions of those libraries. libc5 based systems ------------------- For libc5 based distributions (eg. SuSE 5.x or Red Hat 4.x) you should choose the HP Eloquence libc5 package for installation. Please make sure that at least following shared library versions are installed: libc.so.5.4.33 libm.so.5.0.9 Earlier versions of those libraries are likely to cause problems. For example the libc.so.5.3.12 included with old Red Hat distributions does notwork with HP Eloquence and causes random failures. HP Eloquence provides its own copy of the following libraries in the /opt/eloquence6/lib directory: libncurses.so.3.0 libstdc++.so.2.9 Those libraries have been included to solve compatibility problems with various Linux distributions providing prossibly incompatible versions of those libraries. glibc2.1 based systems ---------------------- For additional compatibility with current Linux distributions which are using the glibc2.1 or glibc2.2 libraries a glibc2.1 based HP Eloquence package is available. Please note that this build has received less testing and we recommend to use the libc6 build for glibc2.1 and glibc2.2 based distributions. If you have trouble getting HP Eloquence working reliable on a glibc2.1 or glibc2.2 based distribution you may want to try the glibc2.1 build though. Please send us a messsage at support@hp-eloquence.com if it makes a difference for you. Please make sure that at least following shared library versions are installed: libc.so.6 (glibc-2.1.2) libm.so.6 (glibc-2.1.2) For distributions using the glibc 2.2 library such as SuSE 7.x and Red Hat 7.x and above you may need to install backwards compatible libraries. HP Eloquence provides its own copy of the following libraries in the /opt/eloquence6/lib directory: libncurses.so.4.2 /usr/lib/libstdc++-libc6.1-1.so.2 Those libraries have been included to solve compatibility problems with various Linux distributions providing prossibly incompatible versions of those libraries. HP Eloquence A.06.31 has been compiled with egcs-1.1.2 for the glibc versions and egcs-1.1.1 for the libc5 version. Linux kernel version -------------------- HP Eloquence should work with any Linux kernel version 2.0 and above. You are encouraged to use the latest stable kernel version which fits four your installed system. New kernel versions include bug fixes, updated drivers and security fixes. Your distribution should provide an updated kernel package which fits for your base system. We do not recommend to use early Linux 2.4 kernels (before version 2.4.6) in production environments. For new installations, a recent glibc based distribution (such as SuSE 7.x or RedHat 7.x) is recommended. Future HP Eloquence release are likely to no longer support libc5 based systems and Linux kernel versions below 2.2. Installation ------------ HP 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@hp-eloquence.com. Please check the HP Eloquence web site for updates and patches. URL: http://www.hp-eloquence.com/support/A06/ To install HP Eloquence execute the command below: rpm -i B1368B-A.06.31.libc6-*.i386.rpm To update an existing HP Eloquence installation, please shut down HP Eloquence and execute the command below: SuSE Linux 7.1 and above: /etc/init.d/eloq6 stop rpm -U B1368B-A.06.31.libc6-*.i386.rpm /etc/init.d/eloq6 start SuSE Linux before 7.1: /sbin/init.d/eloq6 stop rpm -U B1368B-A.06.31.libc6-*.i386.rpm /sbin/init.d/eloq6 start RedHat Linux: /etc/rc.d/init.d/eloq6 stop rpm -U B1368B-A.06.31.libc6-*.i386.rpm /etc/rc.d/init.d/eloq6 stop Installation of automatic startup of HP Eloquence servers during boot is only performed for SuSE and RedHat distributions. If you are using another Linux distribution, you need to add the start and shutdown scripts manually. Template files are provided in the directory /opt/eloquence6/newconfig/startup. Updating from a previous HP Eloquence version --------------------------------------------- When updating from a previous HP Eloquence release the following actions should be performed in additon to updating the software. License key ----------- HP Eloquence A.06.31 requires a license key version A.06.30 or above. If you are using the commercial HP Eloquence version, please request the appropriate license key _before_ updating HP 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 HP Eloquence web site: http://www.hp-eloquence.com/license/ Please comment out the previous license key when adding the new A.06.30 license key to your license file /etc/opt/eloquence6/license. Otherwise the new license may not be recognized and chklic might output the following messages: A.06.20: Bad license key revision. Duplicate sequence number: Ignoring license HP Eloquence Personal Edition ----------------------------- With the HP Eloquence Personal Edition, please copy the A.06.31 license file template to /etc/opt/eloquence6/license. The new license file includes an updated license key for the HP Eloquence Personal Edition. cp /opt/eloquence6/newconfig/config/license /etc/opt/eloquence6/license Startup configuration on SuSE Linux ----------------------------------- The A.06.31 startup script provides additional configuration options. Updating /etc/rc.config is optional. Please check file /opt/eloquence6/newconfig/startup/suse/config.eloq6 and update your /etc/rc.config manually. By default HP Eloquence is configured to start automatically. New startup config options: # The following settings are related to starting HP Eloquence # automatically during system boot. # # Start HP Eloquence daemons? ("yes" or "no") START_ELOQ="yes" # # The following settings allow specifying startup for specific # daemons and daemon commandline arguments. They are all optional. # # Set START_ELOQSD to 1 to start the eloqsd daemon. #START_ELOQSD=1 #ELOQSD_ARGS="" # # Set START_ELOQDB6 to 1 to start the eloqdb6 daemon. #START_ELOQDB6=1 #ELOQDB6_ARGS=""