HP-UX Platform Installation Notes Revision: 2010-06-15 ================================= 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.10 may be installed in parallel with any previous Eloquence release. Eloquence B.08.10 is installed in the /opt/eloquence/8.1 directory and the configuration files reside in the /etc/opt/eloquence/8.1 directory. License keys ------------ Eloquence B.08.10 requires a license key version B.08.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. 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. Please note that the temporary license currently does not include the replication or encryption option. The default license file includes a license key for the Eloquence Personal Edition. HP-UX patches ------------- The following HP-UX patches are known 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 11iv3 (HP-UX 11.31) PHCO_37116 - libxcurses cumulative patch 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_37859 - libxcurses cumulative patch PHKL_32542 - swapcontext(), gethrtime() HP-UX 11i (HP-UX 11.11) PHNE_37671 - cumulative ARPA Transport patch PHCO_37858 - 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_30542 - eventport (/dev/poll) pseudo driver PHKL_28489 - fixes erroneous EFAULT Database encryption ------------------- Eloquence uses the OpenSSL product for cryptographic functions. To use database encryption, OpenSSL must be installed. OpenSSL may be obtained from the HP Software Depot web site. https://h20392.www2.hp.com/portal/swdepot/displayProductInfo.do?productNumber=OPENSSL11I For HP-UX 11i v1 (HP-UX 11.11) it is recommended to install the KRNG kernel support for strong random numbers in addition. It is available from the HP Software Depot web site. https://h20392.www2.hp.com/portal/swdepot/displayProductInfo.do?productNumber=KRNG11I 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 downloaded from the Eloquence ftp server 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-B0810-*-ia64.depot.gz Eloquence depot file for the IA64 platform Eloquence-B0810-*-pa20.depot.gz Eloquence depot file (PA-RISC 2.0) This build requires a PA-RISC 2.0 system A release for the PA-RISC 1.1 architecture is currently not planned. As "superuser", follow the steps below to install the Eloquence software. 1. Unpack the archive at a temporary location gzip -d Eloquence-B0810-*-pa20.depot.gz This uncompresses the depot file Eloquence-B0810-*-pa20.depot.gz to Eloquence-B0810-*-pa20.depot. The compressed archive file is deleted. 2. Run "swinstall" by typing: /usr/sbin/swinstall -s /tmp/Eloquence-B0810-*-pa20.depot where /tmp/Eloquence-B0810-*-pa20.depot is the absolute path of the Eloquence-B0810-*-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 installation, please shut down Eloquence using the command below: /sbin/init.d/eloq81 stop After the update has finished Eloquence can be started with the command below: /sbin/init.d/eloq81 start Automatic startup of Eloquence servers during boot is only configured in the /etc/rc.config.d/eloquence81 configuration file. Updating from a previous Eloquence version ------------------------------------------ When updating from a previous Eloquence A.06.xx, B.06.xx, B.07.xx or B.08.00 release, the following actions should be performed in addition to updating the software. License key ----------- Eloquence B.08.10 requires a license key version B.08.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 you are using a commercial Eloquence version, please request your new B.08.10 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.10 license key to your license file /etc/opt/eloquence/8.1/license. Eloquence Personal Edition -------------------------- The Eloquence B.08.10 default license file includes a license key for the Eloquence Personal Edition. It is installed by default and also available in /opt/eloquence/8.1/newconfig/config/license. Startup configuration --------------------- Eloquence B.08.10 uses the separate startup/shutdown script /sbin/init.d/eloq81 The B.08.10 startup script uses a separate configuration file. A default configuration file is installed. Any customizations from a previous Eloquence version need to be copied manually. The startup configuration file is /etc/rc.config.d/eloquence81 Configuration files ------------------- Eloquence B.08.10 uses separate configuration files in the /etc/opt/eloquence/8.1 directory. Default configuration files are installed. Any customizations from a previous installation need to be copied manually.