Chapter 11. Installing on UNICOS 9.0.x Systems

This chapter provides the NQE 3.3 installation procedures for UNICOS 9.0.x systems. UNICOS customers running only the NQE subset (NQS and FTA) should also use these NQE installation procedures.

Caution: Ensure that you have installed your FLEXlm license file for this release. Customers with valid NQE 3.1 FLEXlm licenses do not need new licenses for the NQE 3.3 release.

UNICOS customers running only the NQE subset (NQS and FTA) do not need to install and configure a FLEXlm license file for this release.

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

The modules package is included on the NQE release medium. If you do not already have this version of the modules package loaded on your system, it is highly recommended that you install it and make it available to the users of the NQE components. For installation instructions and information about using modules with NQE 3.3, see Chapter 16, “Using modules with NQE”. If you choose not to install or use the modules package, you will get a warning message (as described in Chapter 16, “Using modules with NQE”) during the installation of NQE 3.3; you may ignore this warning message.

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.

Note: The procedural steps described in this chapter must be performed in the order specified. Doing so will install all parts of the NQE product.

The NQE 3.3 distribution package contains one cpio file with all of the NQE files and the installation script. For information about setting parameters and device names appropriate for your system and media type, see your UNICOS installation guide or the UNICOS System Configuration Using ICMS, publication SG-2412.

Procedure 11-1.

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

To install NQE 3.3, perform the following steps:

  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.

    Note: For UNICOS and UNICOS/mk systems, the FTA port changed from 21 to 605 as of the NQE 3.1 release.

  2. Invoke the installation tool as follows:

    cd /etc/install

  3. From the UNICOS Installation/Configuration Menu System menu, select Release Media Management.

  4. Select Define Load Device and set parameters appropriate to your load device. Also set Miscellaneous Load Options to -A.

  5. Return to the UNICOS Release Media Management menu by pressing e twice.

  6. In the UNICOS Release Media Management menu, position the menu prompt next to the Load asynchronous product selection, as shown in the following screen, and press RETURN.

                      Release Media Management
           Define load device ==>
       A-> Load asynchronous product ...

  7. Depending on the selected method of loading or the load medium, a message such as the following appears on the screen:

    Load Manager:  Loading Async from Tape
    Device (Root - / )
    Mount ASYNC0 tape on the local J90_EL style
    tape drive, then press return:

    Verify that the release medium is mounted on the chosen device and press RETURN.

  8. If the package you loaded contains multiple products, the following screen appears:

                       Distribution Package
    M-> Distribution Package Contents ==>
        Load selected products... 

  9. To view a list of individual products in a package, position the M-> menu prompt at the Distribution Package Contents menu item and press RETURN.

    A form menu describing the package contents is displayed as shown in the following example:

                    Distribution Package Contents
          Load ?  [Description]   [Vol]  [Pos]  [Directory]
          ------  --------------  -----  -----  -----------
     E->  YES     Package 1         0      0       pkgdir0
          YES     Package 2         0      1       pkgdir1
          YES     Package 3         0      2       pkgdir2
          YES     Package N         0      n       pkgdir(n)
        Keys: ^? Commands  H Help  Q Quit  V ViewDoc W WhereAmI

    By default, all packages are loaded when you select the Load selected products action item of the Distribution Package menu.

    Note: If your screen is not wide enough to display the full form menu, an > or < symbol appears in the direction of the undisplayed information. Use the > and the < keys to scroll the screen from side to side.

    The NQE installation is now complete.

  10. Make the following changes to the installation tool settings so that future use of the tool does not corrupt your NQE 3.3 nqeinfo file.

    Caution: Remove the entries from the Utilities menus before making configuration changes.

    1. Remove all NQS, NQE, and FTA entries from the following tables:

      • UNICOS Installation/Configuration Menu System->Utilities->Conversion Utility->Conversion Table

      • UNICOS Installation/Configuration Menu System->Utilities->Import Utility->Import Table

      • UNICOS Installation/Configuration Menu System->Utilities->Activation Utility->Activation Table

    2. In the UNICOS Installation/Configuration Menu System->Configure System->Startup (/etc/rc) Configuration list, change the NQS log file path to be the NQE default path (as shown below) or the path where you want the NQS log file to be located:

      NQS logfile (blank = /usr/spool/nqs/log)/usr/spool/nqe/log

    3. In the UNICOS Installation/Configuration Menu System->Configure System->System Daemons Configuration->System Daemons Table, change the NQS daemon setting to NO (not required).

    4. In the UNICOS Installation/Configuration Menu System->Configure System->Major Software Configuration list, change the FTA and NQS settings to OFF.

    5. In the UNICOS Installation/Configuration Menu System->Configure System->Configurator Automation Options list, change the FTA, NQS, and NQE configuration settings to NO.

  11. If you are using USCP, as of the NQE 3.1 release, the locations of the NQS user commands moved from /usr/bin to /nqebase/bin. USCP must be configured with the correct location for the NQS user commands. There is a USCP run-time configuration parameter that can be set to override the default location of /usr/bin. To make this change, you must modify the value of the USCP configuration parameter NQSDIR to be /nqebase/bin.

    If you are using the installation tool, the menu path is as follows: UNICOS Installation/Configuration Menu System->Configure System->Network Configuration->USCP Configuration->General Parameter Overrides (uscp.rc). Otherwise, you can edit the USCP run-time configuration file in /etc/config/uscp.rc and add the following line:

    NQSDIR /nqebase/bin

    Once the run-time configuration file is changed, you need to stop and then start USCP for the change to take effect.

  12. 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.

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

  14. 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”.

  15. 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. For UNICOS systems that run only the NQE subset (NQS and FTA components), for information about how to start and stop NQS, see the qstart(8) and qstop(8) man pages.