HP-UX Platform Installation Notes Revision: 2003-02-07 ================================= Supported HP-UX releases ------------------------ Eloquence is supported on the HP-UX Operating System versions B.10.01 to B.11.11. HP-UX version B.10.30 is not supported. We recommand to use HP-UX 11i for new installations. Future versions of Eloquence will no longer support HP-UX versions before HP-UX 10.20. We recommend to update your system to HP-UX release 11.00 or above. Previous HP Eloquence versions ------------------------------ Eloquence B.06.32 can not be installed in parallel with any previous HP Eloquence A.06.xx release. During installation, a previous HP Eloquence A.06.xx product (B1368B-A0600) is uninstalled automatically, any configuration files are retained. Eloquence B.06.32 is installed in the /opt/eloquence6 directory and can be installed in parallel with a previous HP Eloquence A.05.20 release. License keys ------------ Eloquence B.06.32 requires a license key version B.06.32 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. To ease the update from a previous HP Eloquence release, a key revision of A.06.31 is accepted as well. Please request a permanent license key using the form included with the delivery or refer to the Eloquence web site at URL http://www.hp-eloquence.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 required for Eloquence on HP-UX. These patches are included on the Eloquence media (in the hpux subdirectory). In addition to the patches mentioned below 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 * America/Asia-Pacific Server: ftp://us-ffs.external.hp.com/hp-ux_patches/s700_800 Patch PHKL_23995 For HP-UX 11i (HP-UX 11.11) installation of patch PHKL_23995 is suggested. Please refer to the patch documentation PHKL_23995.text for more information. Patch PHKL_23995 is available for download + from the Eloquence ftp server at ftp://ftp.hp-eloquence.com/eloq/B0631/hpux/PHKL_23995 + or the HP ITRC ftp servers at ftp://europe-ffs.external.hp.com/hp-ux_patches/s700_800/11.X/PHKL_23995 ftp://us-ffs.external.hp.com/hp-ux_patches/s700_800/11.X/PHKL_23995 Patch PHKL_24005 For HP-UX 11.0 installation of patch PHKL_24005 is required. Please refer to the patch documentation PHKL_24005.text for more information. Patch PHKL_24005 is available for download + from the Eloquence ftp server at ftp://ftp.hp-eloquence.com/eloq/B0631/hpux/PHKL_24005 + or the HP ITRC ftp servers at ftp://europe-ffs.external.hp.com/hp-ux_patches/s700_800/11.X/PHKL_24005 ftp://us-ffs.external.hp.com/hp-ux_patches/s700_800/11.X/PHKL_24005 Patch PHCO_10947 For HP-UX 10.20 installation of patch PHCO_10947 is required. Please refer to the patch documentation PHCO_10947.text for more information. Patch PHCO_10947 is available for download + from the Eloquence ftp server at ftp://ftp.hp-eloquence.com/eloq/B0631/hpux/PHCO_10947 + or the HP ITRC ftp servers at ftp://europe-ffs.external.hp.com/hp-ux_patches/s700_800/10.X/PHCO_10947 ftp://us-ffs.external.hp.com/hp-ux_patches/s700_800/10.X/PHCO_10947 Patch PHCO_10950 For HP-UX 10.10 installation of patch PHCO_10950 is required. Please refer to the patch documentation PHCO_10950.text for more information. Patch PHCO_10950 is available for download + from the Eloquence ftp server at ftp://ftp.hp-eloquence.com/eloq/B0631/hpux/PHCO_10950 + or the HP ITRC ftp servers at ftp://europe-ffs.external.hp.com/hp-ux_patches/s700_800/10.X/PHCO_10950 ftp://us-ffs.external.hp.com/hp-ux_patches/s700_800/10.X/PHCO_10950 Patch PHCO_6070 For HP-UX 10.01 installation of patch PHCO_6070 (or successor) is required. At this time, the most recent replacement patch is PHCO_21508. Please refer to the patch documentation PHCO_21508.text for more information. Patch PHCO_6070 or a succeeding patch is likely already installed on your system (cummulative libc patch). 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@hp-eloquence.com. Please check the Eloquence web site for updates and patches. htp://www.hp-eloquence.com/support/B06/patch-B0632.html Eloquence installation files downloaded from the Eloquence ftp server are compressed with gzip and must be uncompressed before installation. As "superuser", follow the steps below to install the Eloquence software. 1. Unpack the archive at a temporary location gzip -d Eloquence-B0632-6.depot.gz This unpacks Eloquence-B0632-6.depot.gz to Eloquence-B0632-6.depot. The compressed archive file is deleted. 2. Run "swinstall" by typing: /usr/sbin/swinstall -s /tmp/Eloquence-B0632-6.depot where /tmp/Eloquence-B0632-6.depot is the absolute path of the Eloquence-B0632-6.depot file. 3. In the Software Selection Window, select/highlight the product options you would like to install then choose the "Mark for Install" item from the Actions Menu. The "Marked?" column will automatically be set to "Yes". By default, swinstall should display the "top" level options ("Bundles and Products"). The following options are available: Eloquence_Std Installs the base product Eloquence_Tmplic Installs the base product and a temporary license key which is valid for a period of four weeks. Please note that a temporary license key can only be installed once per system Eloquence_All Installs all components (including temporary license key) Alterntively, the "View - Change Software View - Start with Products" menu option selects the "Products" view in swinstall which allows to select single Eloquence product options. The Eloquence product supports the following options: Base The Eloquence base product Tmplic Install a temporary license key Migration Installs the HP260 migration tools DocHTML Installs the Eloquence documentation in HTML format. This option is only available for the depot file on the CD-ROM media. When obtaining Eloquence by download, the HTML documentation is available as a separate tar archive. DocPDF Installs the Eloquence documentation as PDF format. This option is only available for the depot file on the CD-ROM media. When obtaining Eloquence by download, the PDF documentation is available as a separate tar archive. 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 release the following actions should be performed in additon to updating the software. License key ----------- If you are using a commercial Eloquence version, please request your new B.06.32 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.hp-eloquence.com/license. Please comment out the previous license key when adding the new B.06.32 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.30: Bad license key revision. Duplicate sequence number: Ignoring license Eloquence Personal Edition -------------------------- With the Eloquence Personal Edition, please copy the B.06.32 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 --------------------- The B.06.32 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