Chapter 10. Installing on UNICOS/mk or UNICOS 10.0 Systems

This chapter provides the NQE 3.3 installation procedures for UNICOS/mk and UNICOS 10.0 systems. The common installation tool (CIT) is used to install the NQE 3.3 software on these systems. For a complete list of the supported operating system levels, see Table 1-1.

If you have received a new system that has NQE 3.3 preinstalled, do not use the procedures in this chapter. Instead, follow the procedures provided in Chapter 4, “Customizing Preinstalled NQE”.

Before You Install NQE

This section describes activities you need to perform before you install NQE.

Note: To install NQE 3.3, you must have root permission.

FLEXlm License File

Ensure that you have installed your FLEXlm license file for this release. 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”.

modules Package

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.

Verify Disk Space and Port Numbers

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/mk systems, the FTA port changed from 21 to 605 as of the NQE 3.1 release.

Ensure Your .rhosts Files Are Configured Correctly

To use CIT, you must ensure that your .rhosts files are configured correctly by performing the following steps:

Procedure 10-1.

  1. On the Cray Research system, log in as root and edit the /.rhosts file so that it includes your workstation name and your login name on the workstation, as shown in the following example:

    crayname% cat /.rhosts
    wrkstat01            workstation_login_id   workstation_login_id

  2. On the local workstation, edit your .rhosts file to ensure that all paths to the Cray Research system are included. The list of paths is in file /etc/hosts on the Cray Research system. The associated login name must be root, as shown in the following example:

    srkstat01% cat ~user_id/.rhosts
    crayname                root
    crayname-hyp            root
    crayname-fddi           root       root   root  root

  3. Ensure that both connections work by issuing the following command:

    wrkstat01% rsh crayname -l root "remsh wrkstat01 -l user_id uname -a"
    SunOS wrkstat01 5.4 Generic_101945-38 sun4m sparc

Installing NQE

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: To install NQE 3.3, you must have root permission.

To install NQE 3.3, perform the following steps:

Procedure 10-2.

  1. A copy of CIT is included on the CD-ROM with the software. To use that copy, change directories as follows.

    wrkstat01% cd /cdrom/cdrom0

  2. The routine setup determines the type of front-end system (Solaris or SunOS) and passes the parameters to CIT. In the current directory, execute the following command to install the software:

    wrkstat01% setup -c crayname -l root .

    The crayname argument is the name of the Cray Research machine on which you are installing the software. If you are installing from CD-ROM, the path is /cdrom/cdrom0. The following main menu appears:

    Figure 10-1. CIT Main Menu

  3. Select the packages to be installed by using the left mouse button and double-clicking on the products listed in the leftmost window. The products will be installed in the order in which you select them. Selected items will move from the leftmost window to the middle window. In the following example, modules and NQE were selected.

    Figure 10-2. Product Selection in CIT

  4. To initiate the installation, click on the Install button.

  5. Before the installation actually begins, you must answer the questions on the NQE Pre-install queries menu. A separate menu appears for each product you are installing.

    Caution: You must select no for the Make this vers default? question when installing NQE.

    When you have answered the questions, click on the Done button.

  6. During installation, a speedometer screen (called the Product speedometer window) and a log screen appear for each product being installed. To interrupt the installation, press the Stop button. This activates the following buttons:

    • Resume, which can restart the installation from the last checkpointed task associated with the product

    • Restart, which restarts the installation from the beginning

    • Cancel, which returns control to the main menu

  7. When the installation is complete, the products that have been installed move from the middle window to the rightmost window in the main menu, as in the following example:

    Figure 10-3. CIT Packages Installed Display

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

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

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

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