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:
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. |
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:
Shut down all client workstations in this class.
Change to the /var/boot directory on the server.
# cd /var/boot
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):
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>
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.
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.
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.
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.
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.
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:
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.
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.
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.
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 client_inst invokes inst, inst uses the baseline software to add the updates to the new tree.
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.
To add a software option to the share tree, follow these steps:
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>
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.
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
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
Enter list to verify the software that you selected:
Inst> list
Enter go to launch the installation:
Inst> go
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.
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.
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.
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.
Enter install to select the software that you want to add.
Inst> install MineSet
Enter list to verify the software that you selected.
Inst> list
Enter go to launch the installation.
inst> go
After your entry, inst computes disk space changes, then installs the software option.
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.