HP Eloquence A.06.30 Changed: 2000-03-27 ------------------------------ Linux platform installation notes ================================= HP Eloquence A.06.30 requires new license keys. The default license file includes a new 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 URL http://www.hp-eloquence.com/license/ HP Eloquence for the Linux platform is available in separate packages for libc5 and libc6 (also known as glibc 2.0) based systems. Recent Linux distributions (such as SuSE 6.x or RedHat 5.x) are based on libc6 and you should use the libc6 package. For libc5 based distributions (eg. SuSE 5.x or Red Hat 4.x) you should choose the libc5 version. - If you are installing the libc6 package, please make sure that you have at least the following shared library versions installed: libc.so.6 (glibc-2.0.6) libm.so.6 (glibc-2.0.6) libncurses.so.4.2 libstdc++.so.2.9.0 - If you are installing the libc5 package, please make sure that you have at least the following shared library versions installed: libc.so.5.4.33 libm.so.5.0.9 libncurses.so.3.0 libstdc++.so.2.9 Earlier versions are probably to cause problems. For example the libc.so.5.3.12 included with Red Hat does not work with HP Eloquence and causes random failures. HP Eloquence A.06.30 has been compiled with egcs-1.1.2 for the libc6 version respectively egcs-1.1.1 for the libc5 version and requires the recent libstdc++.so.2.9.0. Since this version may not be easily available on older distributions it is included with HP Eloquence. If your system comes with a libstdc++.so.2.9.0 you may want to remove the one in the /opt/eloquence6/lib directory to avoid having the same library loaded twice (which takes additional memory). Linux kernel version -------------------- While HP Eloquence should work with any Linux kernel version 2.0 and above (currently 2.4 is about to be released shortly) 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. For new installations, a recent glibc2.1 based distribution (such as SuSE 6.3 or RedHat 6.1) is recommended. The following kernel versions are recommended: 2.0 Kernel version 2.0.37 and above is recommended. These kernel versions include a patch to the fsync() system call which is essential when using the eloqdb6 database server with sync writing mode. 2.2 Kernel version 2.2.14 and above is recommended. Since the kernel version is related to your base system, you should check the web site of your Linux distribution for a kernel update. 2.4 Kernel version 2.4 has not been released yet. Please check the HP Eloquence web site for notes or updates. Future HP Eloquence release will 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.30.libc6-*.i386.rpm Please note if you get an error installing this archive (error -2 reading header: Unknown error) you need to update your rpm to a more recent version. To update an existing HP Eloquence installation, please shut down HP Eloquence and execute the command below: SuSE Linux: /sbin/init.d/eloq6 stop rpm -U B1368B-A.06.30.libc6-*.i386.rpm /sbin/init.d/eloq6 start RedHat Linux: /etc/rc.d/init.d/eloq6 stop rpm -U B1368B-A.06.30.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 shut 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 ----------- If you are using the commercial HP Eloquence version, please request your new A.06.30 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.30 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.30 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. 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=""