HP-UX Platform Installation Notes Revision: 2008-05-27 ================================= Supported HP-UX releases ------------------------ Eloquence is available for the PA-RISC (HP9000) and Itanium (Integrity) architecture: * PA-RISC based systems: HP-UX 11iv1 (11.11) or above is required. * Itanium based systems: HP-UX 11iv2 (11.23) or above is required. Previous Eloquence versions --------------------------- Eloquence B.08.00 may be installed in parallel with any previous Eloquence release. 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. During installation, you have the option to create a temporary license key which is valid for four weeks. The default license file includes a new license key for the Eloquence Personal Edition. HP-UX patches ------------- The following HP-UX patches are know to be required for Eloquence on HP-UX. In addition to the patches mentioned below additional patches may be required. It is recommended to install the current HP-UX patch set. HP-UX patches can be obtained from the HP ITRC: * European Site http://europe.itrc.hp.com/ * America/Asia-Pacific Site http://us.itrc.hp.com/ The following patches (or newer) are required with Eloquence. They are known to fix issues that affect the Eloquence product. HP-UX 11iv2 (HP-UX 11.23) PHCO_37940 - pthread library cumulative patch PHNE_37670 - cumulative ARPA Transport patch PHKL_37121 - ksleep kwakeup performance cumulative patch PHCO_37115 - libxcurses cumulative patch PHKL_32542 - libscall-pdk.a cumulative patch HP-UX 11i (HP-UX 11.11) PHNE_37671 - cumulative ARPA Transport patch PHCO_36946 - libxcurses cumulative patch PHCO_35743 - libc cumulative patch (PHCO_23093 or newer) PHKL_34926 - Buffer cache performance improvement PHKL_34534 - vPar,callout, abstime, sync perf, wakeup PHCO_33282 - pthread library cumulative patch PHKL_28489 - fixes erroneous EFAULT System Requirements ------------------- Eloquence requires disk space in the /etc, /opt and /var file systems as indicated below: 1. PA-RISC based system: Temporary disk space for unpacking the distribution file: 50 MB File systems: /opt 50 MB /etc 1 MB /var 1 MB 2. Itanium2 based system: Temporary disk space for unpacking the distribution file: 60 MB File systems: /opt 60 MB /etc 1 MB /var 1 MB Installation ------------ Eloquence is available as a depot package and is installed with swinstall. 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/ Eloquence installation files available for download from the Eloquence web site are compressed with gzip and must be uncompressed before installation. Different versions of the Eloquence software is available. Please choose the appropriate version which corresponds with your hardware: Eloquence-B0800-1-pa11.depot.gz Eloquence depot file (PA-RISC 1.1 and above) Eloquence-B0800-1-pa20.depot.gz Eloquence depot file (PA-RISC 2.0) This build requires a PA-RISC 2.0 system (PA-RISC 8xxx CPU) Eloquence-B0800-1-ia64.depot.gz Eloquence depot file for the IA64 platform (HP-UX 11.23) As "superuser", follow the steps below to install the Eloquence software. 1. Unpack the archive at a temporary location gzip -d Eloquence-B0800-1-pa20.depot.gz This uncompresses the depot file Eloquence-B0800-1-pa20.depot.gz to Eloquence-B0800-1-pa20.depot. The compressed archive file is deleted. 2. Run "swinstall" by typing: /usr/sbin/swinstall -s /tmp/Eloquence-B0800-1-pa20.depot where /tmp/Eloquence-B0800-1-pa20.depot is the absolute path of the Eloquence-B0800-1-pa20.depot file. 3. In the Software Selection Window, select/highlight the Eloquence product then choose the "Mark for Install" item from the Actions menu. The "Marked?" column will automatically be set to "Yes". 4. Select the "Install (analysis...)" item from the Actions Menu. When the analysis is finished with no error, i.e. Status:Ready, choose OK. 5. Choose Yes in the Confirmation window to begin the actual installation process. When the installation is completed, a dialog is displayed to notify you that the install task is completed. You may exit then. To update an existing Eloquence 8.0 installation, please shut down Eloquence using the command below: /sbin/init.d/eloq8 stop After the update has finished Eloquence can be started with the command below: /sbin/init.d/eloq8 start Automatic startup of Eloquence servers during boot is only configured in the /etc/rc.config.d/eloquence8 configuration file. 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. Please comment out the previous license key 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. A default configuration file is installed. Any customizations from a previous installation need to be copied manually. The eloq8 startup configuration file is /etc/rc.config.d/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.