HP-UX Platform Installation Notes Revision: 2006-01-11 ================================= 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) and HP-UX 11iv2 (11.23) are supported with this release. * Itanium based systems: HP-UX 11i version 2 (HP-UX 11.23) or above is required. Previous HP Eloquence versions ------------------------------ Eloquence B.07.10 can not be installed in parallel with any previous Eloquence A.06.xx, B.06.32 or B.07.00 release. As the product name as changed, a previous HP Eloquence A.06.xx product (B1368B-A0600) is uninstalled automatically, any configuration files are retained. Eloquence B.07.10 is installed in the /opt/eloquence6 directory and the configuration files reside in the /etc/opt/eloquence6 directory. License keys ------------ Eloquence B.07.10 requires a license key version B.07.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://www.marxmeier.com/eloquence/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/ In addition, HP-UX patches are available for download by anonymous ftp from the HP ITRC ftp server at: * European Server: ftp://europe-ffs.external.hp.com/hp-ux_patches/s700_800 ftp://europe-ffs.external.hp.com/superseded_patches/hp-ux_patches/s700_800 * America/Asia-Pacific Server: ftp://us-ffs.external.hp.com/hp-ux_patches/s700_800 ftp://us-ffs.external.hp.com/superseded_patches/hp-ux_patches/s700_800 Note: Once a patch is superseded it is no longer available from the hp-ux_patches directory. It is then available from the superseded_patches directory. 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) PHKL_32542 - libscall-pdk.a cumulative patch PHCO_31575 - libxcurses cumulative patch HP-UX 11i (HP-UX 11.11) PHCO_30778 - libxcurses cumulative patch PHKL_28489 - errorneous EFAULT returned 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: 24 MB File systems: /opt 45 MB /etc 1 MB /var 1 MB 2. Itanium2 based system: Temporary disk space for unpacking the distribution file: 50 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://www.marxmeier.com/eloquence/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-B0710-10-pa11.depot.gz Eloquence depot file (PA-RISC 1.1 and above) Eloquence-B0710-10-pa20.depot.gz Eloquence depot file (PA-RISC 2.0) This build requires a PA-RISC 2.0 system (PA-RISC 8xxx CPU) Eloquence-B0710-10-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-B0710-10-pa20.depot.gz This uncompresses the depot file Eloquence-B0710-10-pa20.depot.gz to Eloquence-B0710-10-pa20.depot. The compressed archive file is deleted. 2. Run "swinstall" by typing: /usr/sbin/swinstall -s /tmp/Eloquence-B0710-10-pa20.depot where /tmp/Eloquence-B0710-10-pa20.depot is the absolute path of the Eloquence-B0710-10-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/eloq6 stop After the update has finished Eloquence can be started with the command below: /sbin/init.d/eloq6 start Automatic startup of Eloquence servers during boot is only configured in the /etc/rc.config.d/eloquence6 configuration file. Updating from a previous Eloquence version ------------------------------------------ When updating from a previous Eloquence A.06.xx, B.06.32 or B.07.00 release the following actions should be performed in additon to updating the software. License key ----------- Eloquence B.07.10 requires a license key version B.07.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.07.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://www.marxmeier.com/eloquence/license. Please comment out the previous license key when adding the new B.07.10 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: B.07.00: Bad license key revision. Duplicate sequence number: Ignoring license Eloquence Personal Edition -------------------------- With the Eloquence Personal Edition, please copy the B.07.10 license file template to /etc/opt/eloquence6/license. The new license file includes an updated license key for the Eloquence Personal Edition. cp /opt/eloquence6/newconfig/config/license /etc/opt/eloquence6/license Startup configuration --------------------- Updating from B.07.00 and B.06.32 The B.07.10 startup script adds an additional configuration option and uses a new startup configuration file template. An new option may be used to configure starting and stopping a database instances without requiring root privileges. Previous startup configuration files are compatible. An update of the startup configuration file is only needed when using the new start/stop option. Please note that the B.07.10 startup configuration no longer supports the eloqdb5 daemon. Updating from releases before B.06.32 The B.07.10 startup script provides additional configuration options and uses a new startup configuration file template which supports multiple eloqdb6 instances. Previous startup configuration files are compatible. It is recommended to use a new template configuration file and manually change any options. The startup configuration file is /etc/rc.config.d/eloquence6 To copy over the new template configuration file for manual editing please execute the command below: cp /opt/eloquence6/newconfig/startup/eloquence6 /etc/rc.config.d/eloquence6