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=""