Chapter 8. Installing on Systems Other than UNICOS or UNICOS/mk

This chapter provides NQE 3.3 installation procedures for AIX, Digital UNIX, HP-UX, Solaris, and IRIX systems.


Note: The IRIX inst installation utility is also supported for installing NQE 3.3. To use the inst utility, see Chapter 9, “Installing on IRIX Systems Using the inst Utility”.


For a list of the supported operating system levels, see Table 1-1.


Caution: Ensure that you have installed your FLEXlm license file for this release. The FLEXlm license included with your NQE 3.3 release is temporary; when you order your permanent NQE license, you must restart NQE 3.3. Customers with valid NQE 3.2 FLEXlm licenses do not need new licenses for the NQE 3.3 release.

For information about FLEXlm licensing requirements, see Chapter 6, “FLEXlm License Requirements”.



Note: To install NQE 3.3, you are required to have root permission.

The installation tool checks the version level of the product you are loading. If the same version level as the one you are trying to load already exists, you are prompted to defer or continue loading. If you choose to continue loading, the existing version is overwritten.

To install NQE on an AIX, Digital UNIX, HP-UX, Solaris, or IRIX system, complete the following procedure:

Procedure 8-1.

  1. Verify that you have sufficient disk space and that your port numbers are correct for this release; see Table 7-1, and Table 7-2.

  2. Ensure that the X Window System display environment variable DISPLAY points to your local X Window System server (that is, the workstation you are using to run the installation procedure). The installation tool uses the X Window System display determined by the DISPLAY environment variable.

    For example, your local X Window System server is named ice, and you are installing NQE on a server named snow. If you use sh or ksh, the following command sets the environment variable:

    export DISPLAY=ice:0

    If you use csh, the following command sets the environment variable:

    setenv DISPLAY ice:0

    You must add the host on which you are installing NQE (which is snow in this example) to the client list on your X Window System server by using the xhost command. For example:

    xhost snow

  3. Mount the CD-ROM.

    Place the CD-ROM into the caddy and insert it into the drive. To mount the CD-ROM, use the mount(1M or 8) command.

    For system-specific reference material, see the mount and showmount man pages on your system. Also, Appendix C, “Mounting/Unmounting CD-ROMs”, includes examples of mounting the CD-ROM on supported NQE platforms.


    Note: For Solaris systems. On Solaris systems, the Volume Management daemon automatically mounts the CD-ROM when you insert it at the mount point, /cdrom/network_queuing_environment_33. It also creates a symbolic link, /cdrom/cdrom0, which points to the /cdrom/network_queuing_environment_33 directory. Mount commands are not necessary.



    Note: NQE 3.3 may be installed from a remote CD-ROM drive mounted via NFS to the local system; however, there is one potential problem. If the NFS server and the NFS client are both capable of using the NFS version 3 protocol, files on the CD-ROM might not be accessible. Two known cases affecting the NQE 3.3 CD-ROM are Digital UNIX 4.0 and Solaris. For these cases, the NFS server (where the CD-ROM drive existed) was an IRIX 6.2 machine called pendulum.

    The workaround is to force the mount command (on Digital UNIX 4.0 or Solaris) to use the NFS version 2 protocol. This may also be necessary on other operating systems. Sample mount commands on Digital UNIX 4.0 and Solaris follow, assuming that the CD-ROM drive is on a machine called pendulum and that the CD-ROM is mounted on pendulum as /CDROM.
    Digital UNIX 4.0# mount -t nfs -o ro,nfsv2,soft,intr pendulum:/CDROM
        /tmp/cdrom
    Digital UNIX 4.0# cd /tmp/cdrom/INSTALL
    Digital UNIX 4.0# ls
    AIX      INSTALL  OSF1    SunOS5   common   DIST
    HP-UX    IRIX5  IRIX6    IRIX64     SunOS4   client

    Solaris# mount -F nfs -o ro,vers=2,soft,intr pendulum:/CDROM
       /tmp/cdrom
    Solaris# ls /tmp/cdrom/INSTALL
    AIX      INSTALL  OSF1    SunOS5   common   DIST
    HP-UX    IRIX5  IRIX6    IRIX64     SunOS4   client



  4. Execute the following command:

    ./INSTALL

    A confirmation message will appear on the screen, as follows:

             NOTE
    installing NQE version on system
    Operating system name = OS name
    Operating system level = OS level
    
    

  5. Enter yes at the prompt.

    The following display will appear:

    Figure 8-1. NQE Configuration Install Display


  6. If an NQE configuration file (nqeinfo file) already exists, the following screen will appear before you can continue:

    Figure 8-2. nqeinfo File Warning Screen


    Click on OK and overwrite the existing file.

  7. The following information appears on the NQE configuration Install display:

    • The host name; the NQE configuration utility defaults to the local host name returned by the uname -n command.

    • NQE component list (NQE_DEFAULT_COMPLIST). This is the list of NQE components which will be started or stopped by default when the nqeinit and nqestop scripts are used. The valid NQE components are as follows: NQS, NLB, COLLECTOR, NQEDB, MONITOR, SCHEDULER, and LWS. For more information on valid NQE components, see “Planning Server Type(s) and Clients” in Chapter 7.


      Note: For NQE client-only installation, this component is blank. If one or more components are specified, all NQE components are installed.


    • Port numbers; the default port numbers are provided.

    • The NQE_ROOT is the base location for the installation; it usually is /opt or /usr.

    After you have entered the correct information for your installation, click on OK.

  8. The procedure verifies that there is sufficient disk space available to load NQE. The installation will stop if not enough disk space is available. If less than 10% of the space on the disk would remain available after the installation, you are asked if you want to continue the installation. The following is an example of the disk space verification messages:

    Checking for space...available: 117342 1k bytes...needed
    for nqe: 25807 1k bytes.
    available after the load: 91535 1k bytes or 6% of disk.
    Do you wish to continue with the load? [n/y] y
  9. Once available disk space is confirmed, the installation process continues, and you will see the following messages:

    Done checking for disk space.
    Installing NQS into /nqebase/nqeversion.
    installing MAN pages
    MAN pages complete
    
    INSTALLATION COMPLETE
  10. Eject the CD-ROM.

  11. If you are upgrading to NQE 3.3 directly from NQE 3.2, return to Chapter 5, “Upgrading Directly from NQE 3.2 to NQE 3.3”, and complete the upgrade steps.

  12. If you are upgrading to NQE 3.3 from a release prior to NQE 3.2, skip to Chapter 12, “Upgrading from a Release Prior to NQE 3.1”, and complete the appropriate upgrade procedure.

  13. Otherwise, use the NQE version maintenance utility (nqemaint(8)) to make NQE 3.3 the default version. For information about how to use the NQE version maintenance utility, see Chapter 13, “NQE Version Maintenance Utility”.

  14. Read Chapter 14, “Read This Before You Start NQE”, for important information you should know about before you start NQE 3.3.

For information about how to prepare a node to run NQE see Appendix A, “Preparing a Node to Run NQE”.

For information about how to start and stop NQE, see the nqeinit(8) and nqestop(8) man pages.