Chapter 5. Updating Software on Diskless Trees
Prev |  | Next

## Chapter 5. Updating Software on Diskless Trees

This chapter explains how to update the software for a diskless implementation that is already running an earlier software release. It explains how to install the updated share tree and client trees, and how to create a new client tree that contains updated software. It also explains how to add software options to a share tree and client tree.

This chapter contains these sections:

- “Points to Keep in Mind”

- “Updating a Share Tree”

- “Updating Existing Client Trees”

- “When New Clients Need Updated Trees”

- “Software Options as Updates”

## Points to Keep in Mind

When you use these procedures, keep software compatibility considerations in mind: the revision level of the server software supporting the diskless implementation must be equal to or greater than the software on the share tree. In addition, you must update the share tree before updating any of its client trees.

All clients should be shut down while you update their share tree. An individual client should be shut down while you update its client tree.

| Caution: If you do not shut down clients to perform an update, they might crash during the update or not operate properly after the installation.

## Updating a Share Tree

The update procedure replaces the software on a share tree with a later software release. The update procedure also adds new subsystems to the share tree and removes subsystems that are no longer needed.

Because software was previously installed in the tree that you are updating, `inst` has a record of the installation; it uses this record to identify currently installed software for which the new software contains a revision. In `inst` listings, these subsystems are marked with the letters i U, indicating that they are updates and are selected for installation.

The following procedure explains how to update software on a share tree:

1. Shut down all client workstations in this class.

2. Change to the `/var/boot` directory on the server.

       # cd /var/boot

3. Start share_inst.

   Enter the share_inst command, substituting the name of your share tree for the one shown in this example:

       # ./share_inst -r IRIX_65-32

   | Note: If you have not shut down the clients using this share tree, `share_inst` displays this message:

              WARNING: release IRIX_65-32 is still serving clients.
              continue to update IRIX_65-32 (Y/N)?

   If you answer yes, `share_inst` posts a final warning:

              Checking clients status:
              client client_1 ... UP
              WARNING: clients will be out of sync. Clients which
              are UP may crash.

   If clients have been shut down (or if you proceed with the installation in spite of the warnings), `share_inst` displays a confirmation prompt:

       About to install shared tree at /diskless/share/IRIX_65-32......
       Enter confirmation (y/Y):

4. Enter `y` or `Y` (yes) to confirm the installation.

   After your entry, the Inst Main Menu is displayed:

       Default location of new software is <previous installation location>
       If you are a first-time inst user, give the command “help beginner".
       Inst Main Menu
        1. from [source...]          Specify location of software to be installed
        2. open [source...]          Specify additional software locations
        3. close [source]            Close distributions
        4. list [keywords][names]    Display information about software subsystems
        5. go                        Perform software installation and removal now
        6. install [keywords][names] Select subsystems to be installed
        7. remove [keywords][names]  Select subsystems to be removed
        8. keep [keywords][names]    Do not install or remove these subsystems
        9. step [keywords][names]    Enter interactive mode for install/remove/keep
       10. conflicts [choice...]     List or resolve installation conflicts
       11. help [topic]              Get help in general or on a specific word
       12. view ...                  Go to the View Commands Window
       13. admin                     Go to the Administrative Commands Menu
       14. quit                      Terminate software installation

       Inst>

5. Enter `from` to specify the software location.

   The `inst` utility assumes that the location of your update software is the same as it was for the previous installation. (Notice the “default location” message above the Main menu.)

   - If you plan to install the updates from the default location, press the Enter key and go to Step 6.

     | Note: If you used CD-ROM as the source for the previous installation, insert the CD before pressing the Enter key.

   - If you plan to install the updates from a location other than the default, specify the location with the `from` option, insert a CD if one is required, and press Enter, then go to Step 6.

6. Enter `list` to determine the default installation selections.

   The `inst` utility automatically identifies software updates and selects them for installation. By default, inst selects all new subsystems (designated by the letters i N) and all subsystems that are updates (designated by the letter i U). Use the `list` option to check these selections and their space requirements before installing them.

7. Change the default selections if necessary.

   If you want to change the default selections, use the `step i` option to advance through the list of selected subsystems on the source. Type one of these entries for each subsystem that the `step` option posts:

   `Enter` |  | To leave the selection unchanged.
   `r Enter` |  | If it is marked i and you do not want it installed
   `i Enter` |  | If it is not marked i and you want to install it.

8. Enter `go` to launch the installation.

   When your selections are satisfactory, enter the `go` option to launch the installation. As your share tree software is updated, you will see messages such as the examples shown below.

       Removing old versions of selected eoe.sw.xfs subsystems
       Installing new versions of selected eoe.sw.xfs subsystems
       Removing old versions of selected desktop_eoe.sw.envm subsystems
       Installing new versions of selected desktop_eoe.sw.envm subsystems

   At the end of the installation, you see this message:

       Installation and/or removal succeeded.

9. Enter `quit` to complete the update procedure.

   Allow the `exit` commands several minutes to process.

   | Caution: Do not make any entries that will interrupt processing of the `exit` commands (such as CtrlhostnameC, for example). Doing so can result in damage to your system.

When processing is complete, the share tree for the class you specified is updated, and you are ready to update client trees for the class.

## Updating Existing Client Trees

The `clone_client` program for client trees automatically installs updated software from the share tree into an existing client tree. This program installs all subsystems that are new to the client tree and all subsystems for which the share tree contains a newer version. It also removes any subsystem on the client for which there is no corresponding subsystem in the share tree—these subsystems are considered obsolete.

| Note: If you are adding a new client to the diskless implementation and you want its client tree to contain updated software, you must complete Step 2 of this procedure twice. (See “When New Clients Need Updated Trees” for an explanation.)

Updating clients involves three general steps:

1. Shut down the workstation whose client tree you are updating.

   If you do not shut down the client, `clone_client` warns you that it might crash during the update.

2. Use `clone_client` to launch an automatic update of client trees.

   When you use `clone_client` to update a client tree, `inst` takes these actions:

   - Installs all new subsystems. This software is on the share tree but is not yet installed on the client tree; these subsystems are marked N in `inst` listings.

   - Installs all subsystems in the client tree for which there is a newer version in the share tree; these subsystems are marked U in `inst` listings.

   - Removes any subsystems from the client tree that do not exist in the share tree; these subsystems are considered obsolete.

   If you prefer to select the software to be updated, complete the instructions in “Client and Swap Tree Installation Procedure” instead of using `clone_client` program.

3. Reboot the client workstation.

   See “Booting a Client Workstation” in Chapter 4 for instructions.

After the boot procedure is completed, the client is operating with updated software.

## When New Clients Need Updated Trees

If you want to create a new tree containing updated software (that is, put a new client workstation into service running the updated software), you must run `client_inst` twice. The first time that `client_inst` invokes the `inst` program, `inst` searches the client tree for a record describing previously installed software. Because no record exists on a new client tree, `inst` installs a baseline version of the software, without adding updates. The second time that cl `ient_inst` invokes `inst`, `inst` uses the baseline software to add the updates to the new tree.

## Software Options as Updates

Whenever you add a software option, you must add the software to the share tree first. Then, add it to the client tree of each diskless workstation that is to use the option. Options that you add to a share or client tree need not be installed on the server containing the trees.

### Adding Options to a Share Tree

To add a software option to the share tree, follow these steps:

1. Enter the `share_inst` command to install software on a share tree.

   Your entry will look like the example that follows. In this example, 32bitIRIX_65 is the share tree to which the option is being added:

       # /var/boot/share_inst -r 32bitIRIX_65

   After your entry, `share_inst` asks you for a confirmation, then the `inst` Main menu is displayed:

       Default location of new software is <previous installation location>
       If you are a first-time inst user, give the command "help beginner".
       Inst Main Menu
        1. from [source...]          Specify location of software to be installed
        2. open [source...]          Specify additional software locations
        3. close [source]            Close distributions
        4. list [keywords][names]    Display information about software subsystems
        5. go                        Perform software installation and removal now
        6. install [keywords][names] Select subsystems to be installed
        7. remove [keywords][names]  Select subsystems to be removed
        8. keep [keywords][names]    Do not install or remove these subsystems
        9. step [keywords][names]    Enter interactive mode for install/remove/keep
       10. conflicts [choice...]     List or resolve installation conflicts
       11. help [topic]              Get help in general or on a specific word
       12. view ...                  Go to the View Commands Window
       13. admin                     Go to the Administrative Commands Menu
       14. quit                      Terminate software installation

       Inst>

2. Enter `from` to specify a different software location, if necessary.

   The`inst` utility assumes that you are installing the software option from the same location as the previous installation (the “default location” message above the Main Menu specifies CD, because no options have previously been installed on this tree). If you plan to use the default location, go to Step 4.

   If you plan to install the software from a location other than the default, use the `from` option to specify the new location. See the `inst` online help if you need instructions.

3. Enter `keep I` to clear unwanted selections.

   Software at the installation location is likely to have many subsystems selected for installation in addition to the option you want to install. The `keep I` entry tells `inst` to ignore all subsystem selections except those that are currently installed.

   After your entry, `inst` identifies the software at the installation location and posts a list such as the partial listing shown in this example:

       Reading product description from guest@bigsgi:/d2/32bitIRIX65

4. Enter `install` option_name to select the software option.

   For example, if you want to install the MineSet product option, your entry would look like this:

       inst> install MineSet

5. Enter `list` to verify the software that you selected:

       Inst> list

6. Enter `go` to launch the installation:

       Inst> go

7. Enter `quit` to finish the installation:

       Inst> quit

When processing is complete, the option is added to the share tree. The option can now be added to client trees that will be using it.

### Adding Options to Client Trees

This section describes the procedure for adding a software option to a client tree. The following steps must be completed for each client using the new option. The option must already be installed on the share tree when you do this procedure.

1. Enter the `client_inst` command to add software to a client tree:

       /var/boot/client_inst -r IRIX_65-32 -c O2 -h starlite

   In this example, starlite, the client using the IRIX_65-32 share tree is receiving the software option. After your entry, `client_inst` asks you for a confirmation, then the Inst Main menu is displayed.

2. Enter `keep I` to clear unwanted subsystem selections.

   Because many subsystems in the share tree are selected for installation, you need to clear these selections before going on with the installation. The `keep I` entry tells `inst` to ignore all subsystem selections except those that are currently installed.

3. Enter `install` to select the software that you want to add.

       Inst> install MineSet

4. Enter `list` to verify the software that you selected.

       Inst> list

5. Enter `go` to launch the installation.

       inst> go

   After your entry, `inst` computes disk space changes, then installs the software option.

6. Enter `quit` to finish the installation.

       Inst> quit

When processing is complete, the option is added to the client tree and is available to users of this diskless workstation.

Prev | Table of Contents | Next
Chapter 4. Creating Client Trees |  | Chapter 6. Maintaining Diskless Implementations