Chapter 7. Maintenance Tips

This chapter contains procedures that may be necessary to keep the software installation at your site up to date. The chapter contains these sections:

Installing Maintenance and Feature Releases

The distribution CD for maintenance and feature releases contains two software streams: the maintenance stream contains bug fixes and basic support for new hardware; and the feature stream contains the maintenance stream software as well as new software features (see “Software Release Types” in Chapter 1). The new files in any maintenance or feature release overwrite the corresponding files in the installed subsystem.

The first time you install an intermediate release, Inst prompts you to specify the stream that you wish to install. After you select a stream, Inst makes its installation selections from the appropriate stream. In many cases, you can examine the initial selections with list and enter the go command without making any selection changes.

When Inst makes its initial installation selections on maintenance or feature releases, it automatically selects any updates to existing subsystems, provided that the appropriate version of the subsystem is currently installed. If the required version of a subsystem is not installed, you must upgrade to the required version before installing its replacement in the maintenance or feature release.

Switching Streams

Normally,the previously-chosen stream type is installed on a particular operating system base release. However, you can switch streams. To do this, use the Inst commands install feature or install maintenance when the Inst prompt first appears. Then, follow the procedures discussed in the following two sections.

Feature-to-Maintenance Switches

If you are currently running a feature release and you use the install maintenance command to install the maintenance stream, you must open all CDs from the base release as part of the installation. You then must reinstall the portions of the base release that are affected by the maintenance release that you plan to install. You can determine which files are effected by entering the conflicts command.

Maintenance-to-Feature Switches

If you are currently running a maintenance release and you use the install feature command to install the feature release, you will be prompted with conflict messages in your installation similar to the following:

Overlay product eoe.sw.base (1275066720) cannot be
installed because of missing prerequisites: base
product eoe.sw.base (1274627340)
1a. Do not install eoe.sw.base (1275066720)
1b. Also install base product eoe.sw.base
(1274627340) from an additional distribution --
insert another CD or specify another software
distribution.

If you see conflict messages like this, open the distribution or CD that contains the missing product,then select the product for installation.

Maintenance and Feature Information in List Displays

In Inst subsystem listings, maintenance and release components are listed by the name of the subsystem to which they apply. The letter o to the right of the subsystem indicates that it is an overlay to the subsystem.

Example 7-1 illustrates the legend and a listing for a maintenance or feature release of product X. Notice that two subsystems are designated as installable upgrades (UA) and one subsystem is listed as an uninstallable upgrade (UX).

Example 7-1. Sample Listing for Maintenance or Feature Software

Inst> l
  View:      distribution
  Status:    N=new, U=upgrade, S=same, D=downgrade
  Status:    A=installable patch/overlay, X=uninstallable patch/overlay
  Selection: i=install, r=remove, k=keep
  Subsystem Types [bdro]:  b=reBoot needed, d=Default, r=Required, o=overlay
i UA eoe.man.eoe [o]       8+  manpages - 1008000004
i UA eoe.sw.eoe [o]        0   sw - 1008000004
  UX eoe.sw.eoe [o]        4-  sw - 1008000004


Maintenance and Feature Release Installation Procedure

Use the procedure below as a guideline for installing a maintenance or feature release:

  1. Determine whether a miniroot installation is required.

    Read the release notes or the CD booklet that accompanied the release to determine whether it requires a miniroot installation.

  2.  Load the installation CD into the CD-ROM drive.

    One CD in a maintenance and feature release contains installation utilities; this CD must be loaded first. Even if you are installing a maintenance or feature release and a base release at the same time, the first CD that you load must be the maintenance or feature release CD containing the installation tools.

  3. Invoke Inst from the installation CD.

    If the release requires a miniroot installation, load the miniroot from the installation CD (see “Loading From a Local CD” in Chapter 3 if you need instructions). If the release does not require a miniroot installation, invoke Inst to start the installation (see “Starting a Live Installation” in Chapter 3).

  4. Load the remaining CDs, if there are others.

    Load the remaining CDs for the release (see “ Opening Multiple Distributions” in Chapter 2).

  5. Select products and subsystems for your specific installation. Give the following commands, depending on which stream you with to install:

    • Give the following commands to upgrade a previously-chosen maintenance or feature stream:

      keep *
      install standard
      

      This clears any existing selections, selects upgrades to currently installed products, and selects products required by these upgrades. You can continue to customize selections after executing these commands.

    • Give the following command to switch to the maintenance stream release:

      install maint
      

      This clears any existing selections, selects maintenance stream upgrades, selects products required by these upgrades, and sets the release stream preference to maintenance. You can continue to customize selections after you execute this command.

    • Give the following command to switch to the feature stream release:

      install feature
      

      This clears any existing selections, selects feature stream upgrades, selects products required by these upgrades, and sets the release stream preference to feature. You can continue to customize selections after you execute this command.

  6. Resolve any conflicts.

    Enter the conflicts command to display any conflicts among the subsystems selected for installation. Resolve the conflicts before launching the installation. If you switched streams (see “Switching Streams”), the conflicts will include those files in the base release that are affected by the switch.

  7. Enter the go command to launch the installation.

  8. Exit Inst.

  9. Correct your configuration files, if necessary.

    If you see a message about changed configuration files after the installation is complete, follow the directions in “Merging Configuration Files” in Chapter 4 to merge configuration files. If you do not merge changed configuration files, a message about changed configuration files is posted during the next several system reboots.

Installing Optional Software Products

Software options are products that you may or may not choose to run on a system. They are usually purchased separately from a computer system but may also be shipped as a complimentary offering with a new system or when a new version of a purchased option is released. When you install a software option, keep these points in mind:

  • The release notes for a software option explain whether a miniroot installation is required.

  • If the option requires a miniroot installation and the distribution CD contains installation tools, use the installation tools on the CD. If the option requires a miniroot installation and the distribution CD does not contain installation tools, use the installation CD from your most recently installed release.

Installing Patches

A patch release contains replacement files that you install to fix or otherwise improve a previously-installed software product. The subsystems that are affected by a patch may span several products. For example, a patch for the FDDI product might contain replacement files for the eoe and fddivis subsystems.

In some cases, a patch is incompatible with a previous patch and the older patch must be removed before you can install the new one. When you install a patch, Inst automatically moves the original files before installing their patch replacements. The original files are copied to a directory that Inst creates specifically to save such files, /var/inst/patchbase. This way you can re-install the original files if necessary.

Interpreting Patch Information in list Displays

In Inst subsystem listings, patches are identified by their patch number and product subsystem name. For example, patchSG0000034.bvo_sw.bvo identifies a patch to a subsystem of the Broadcast Video Option product.

If patches are present on a distribution, the legend of a list display and the software components that list posts include patches. Example 7-2 illustrates the list legend and patch entries in a list display.

Example 7-2. Sample list Display of Patches

Inst> list 
  View:       distribution
  Status:    N=New, U=Upgrade, S=Same, D=Downgrade, P=Patch upgrade
  Patches:   A=installable patch, X=uninstallable patch (missing base product)
  Selection: i=install, r=remove, k=keep
  Subsystem Type(s) [bdrpc]: b=reBoot needed, d=Default, r=Required, p=Patch,
                             c=client only
DA patchSG0000000.eoe1_sw.unix [bp]    0  IRIX Execution Environment
SA patchSG0000001.eoe1_sw.unix [bp]    0  IRIX Execution Environment
PA patchSG0000002.eoe1_sw.unix [bp]    0  IRIX Execution Environment
NA patchSG0000005.4DDN_sw.4DDN [bd]    0  4DDN Software
NX patchSG0000011.dwb_sw.aps [p]       0  Autologic APS-5 Fonts

The mnemonic tags on patches have these meanings:

DA 

(Downgrade Applicable) This patch applies to an installed base subsystem; it is a downgrade to another patch that is already installed.

NA 

(New Applicable) This patch applies to a base subsystem that is installed or available for installation; it does not apply to any installed patch.

NX 

(New Uninstallable) This patch applies to software that is not installed and not available for installation from this distribution.

PA 

(Patch Upgrade) This patch applies to an installed base subsystem; it upgrades a patch that was already installed.

SA 

(Same Applicable) This patch is already installed.

Patch Installation Procedure

Use the procedure below as a guideline for installing a patch release:

  1. Read the release notes on the installation CD to decide whether to install the patch.

    Typically, the reported errors that result in a patch occur only under certain operating conditions. For this reason, installing a patch is necessary only if a system or site is experiencing a problem that the patch addresses. Review the release notes that accompany the patch release to determine whether to install it or not.

  2. Invoke Inst (from the miniroot, if necessary).

    Check the release notes for installation instructions. Invoke Inst from the miniroot if the patch requires a miniroot installation (see “Starting a Miniroot Installation” in Chapter 3 if you need help); otherwise, invoke Inst from the IRIX command line (see “Starting a Live Installation” in Chapter 3 if you need help).


    Note: For live installations, you can use inst -f and specify the location of the patch distribution in your command.


  3. Select the patches for installation.

    From the Inst Main menu, use the install installable command to select patches and patch sets for installation. (The installable command tells Inst to install all applicable and upgrade patches in the patch release.)


    Note: Do not install a subset of patches, but rather the entire installable set in the patch release.


    Inst> install installable
    

  4. List all of the patches that you have selected to install.

    Inst> list i
    

  5. Resolve any conflicts.

    Enter the conflicts command to display any conflicts among the subsystems selected for installation. Resolve the conflicts before launching the installation.

  6. Enter the go command to launch the installation.

    Patches contain no known conflicts with standard installed products; however, conflicts might occur with other patches that you have installed. Use the resolution suggested in the conflicts message to determine your course of action.

  7. Exit Inst.

Removing Patches

You can remove a patch after it is installed if you wish. When you remove a patch, the original product files in /var/inst/patchbase are automatically reinstalled on the system. Use this procedure as a guideline for removing patches.

  1. Invoke Inst (from the miniroot, if necessary).

    Check the release notes for the product. If the product requires a miniroot installation, you must invoke Inst from the miniroot to remove the patch (see “Starting a Miniroot Installation” in Chapter 3 if you need help); otherwise, invoke Inst from the IRIX command line (see “Starting a Live Installation” in Chapter 3 if you need help).

  2. Select the patch for removal.

    Use the remove command from the Inst Main menu to remove the patch:

    Inst> remove patchname 
    


    Note: Do not remove portions of patches; to preserve the integrity of the software product, remove the entire patch.


  3. Enter the go command to complete the removal.

Removing Original Product Files

Sometimes it may be necessary to remove original product files from /var/inst/patchbase (to save disk space, for example). A special argument to the versions command removes the files that a patch has replaced. However, there are important reasons why you should create a backup copy of /var/inst/patchbase before removing any of its contents:

  • Original product files are not recoverable after they are removed from /var/inst/patchbase.

  • Original product files are sometimes required for subsequent patches to the product.

Use the versions command with the removehist argument to remove original product files from /var/inst/patchbase.


Caution: Before you use this command, make a backup copy of /var/inst/patchbase:


# versions removehist patchname 

Installing Software for Hardware Upgrades

In some cases, changes to software are required when you install a hardware upgrade on a system that is already in service. As a general rule, adding memory, bitplanes, and disks requires no change to the software, but other hardware upgrades require changes to the installed software. The documentation that accompanies the upgrade explains whether a software installation is necessary.

Installing Accompanying Product Releases

Some hardware upgrades are shipped with a software distribution in the form of a software product release. Use the directions in “Installing Optional Software Products” to install this type of software distribution. If the software distribution contains installation tools, you must use them.

Reinstalling the Same Software

Some hardware upgrades are not shipped with a software distribution, but they require that you reinstall some software after the hardware upgrade is completed. For example, upgrades to a CPU board or the graphics subsystem require a software reinstallation. In such cases, the reinstallation is necessary because the hardware-specific files that were installed for the original hardware are not appropriate for the new hardware.

When Inst determines that a system contains new hardware, it notifies you that it has selected a new set of hardware-dependent files for installation:

Your system hardware configuration has changed since you
last installed software, and some subsystems will therefore
need to be re-installed for proper operation.

Use this procedure to reinstall all software:

  1. Select all installed software for installation.

    Because you are reinstalling the same software, Inst automatically marks previously installed subsystems (including the hardware-specific subsystems that require replacing) with a k (keep). For this reason, you must explicitly select subsystems for installation to force Inst to perform the installation. This command selects all previously installed software for reinstallation:

    Inst> install stale 
    

  2. Check the output of list after your entry.

    Every subsystem in the distribution inventory that is marked with an I (installed) in the second column should also contain an i (install) in the first column.

  3. Launch the installation.

    Inst> go 
    

  4. Quit Inst.

    Inst> quit 
    

Installing Reference Pages

The reference pages (manual pages) that apply to a product are shipped as a software component of the product. For example, all reference pages and software for Digital Media Development software are shipped in a subsystem of the dmedia_dev product. The subsystems containing reference pages consist exclusively of reference pages.

The software subsystems in a product usually have a corresponding reference page subsystem. The names of the software and reference page subsystems differ only in the image segment of the name. The name for a reference page subsystem always contains the letters .man in the image segment. For example, dmedia_dev contains the software subsystem dmedia_dev.sw.movie and a reference page subsystem called dmedia_dev.man.movie. 

When release notes accompany a product, the product contains an additional .man image that contains the release notes—dmedia_dev.man.relnotes, in this case. Some reference page subsystems contain reference pages for more than one software subsystem. When you receive your workstation and when you install a software option for the first time, be sure to check the status of reference page subsystems to verify that the reference pages that you want are installed.

The commands that follow are useful for checking and installing reference page subsystems.

  • Check to see which reference page subsystems are installed:

    
    # showprods '*.*man*' 
    

  • List all reference page subsystems available for installation:

    Inst> list *.*man* 
    

  • Select all reference page subsystems, not release notes, for installation:

    Inst> install *.*man* 
    Inst> keep *.*.relnotes 
    

Reinstalling an Older Software Release

Inst is designed to install software products that are new to your workstation or newer than the currently installed version. When you want to install a version of eoe that is older than the currently installed version, the installation procedure must be modified. If you do not follow this modified procedure (for example, you use set neweroverride on instead), you may be left with configuration files that do not match the rest of the software. This can inhibit system reboots and make it difficult to diagnose compatibility problems.

The steps below describe the procedure for installing an older IRIX release after you have installed the new release. You should perform a complete system backup before performing this procedure.

In the procedure, you will back up your new, modified system configuration files, remove your new system software, and then install an older version. The final step is to integrate any modifications you made to your new configuration files into the restored, older configuration files.


Note: This procedure begins from the miniroot.

Before beginning this procedure, locate the older software distribution you will be downgrading to. Be sure that you have the installation tools (sa file) that accompanied the older distribution.

  1. Load the miniroot from your current distribution.

    Begin by loading the miniroot from your current distribution. (Refer to “Starting a Miniroot Installation” in Chapter 3“Starting a Miniroot Installation” in Chapter 3 for information on how to load the miniroot.)

  2. Invoke an IRIX shell.

    Use the shroot command to escape to a root shell, enter sh to start a Bourne shell, and then use showfiles to create a list of modified configuration files:

    Inst> shroot 
    # sh 
    # showfiles -s -c -m > /usr/tmp/configlist 
    

  3. Edit the configuration files list (optional).

    If you want to edit the list of configuration files to add additional files or remove unnecessary files, you can do so now by setting your TERM variable and using vi(1):

    # TERM=vt100; export TERM 
    # vi /usr/tmp/configlist 
    

  4. Create backup configuration files.

    When you are satisfied with /usr/tmp/configlist, create the backup configuration files and then quickly replace the password and hosts files (in case of disaster while performing the rest of the procedure):

    # sh -c `while read fname; do mv $fname $fname.bak; done' < /usr/tmp/configlist 
    # cp /etc/hosts.bak /etc/hosts 
    # cp /etc/passwd.bak /etc/passwd 
    # exit 
    # exit 
    Inst>
    


    Note: The < /usr/tmp/configlist portion that appears on the second line of this example should be included at the end of the first line in your entry.


  5. Remove target software.

    Remove all currently installed software. At the Inst prompt, enter the commands shown below. It is critical that you not give any other commands at the Inst prompt at this time.

    Inst> set rulesoverride true 
    Inst> view targ 
    Inst> remove I 
    Inst> go 
    

    If you receive a device-busy error at this point and receive the Interrupt menu, select continue. When Inst is finished and you quit, you may be asked if you really want to quit. Enter y for yes.

    Inst> quit 
    Please wait ...
    Ready to restart the system. Restart? { y(es), (n)o, (sh)ell, (h)elp } sh 
    

  6. Enter the sh command to get a shell prompt.

  7. Remove installation history files.

    After escaping to the shell, remove all files that make up what is known as your installation history and then restart the system:

    # rm -rf /root/var/inst 
    # exit 
    Ready to restart the system. Restart? { y(es), (n)o, (sh)ell, (h)elp } y 
    

  8. Load the miniroot from the older distribution.

    Use the older software distribution that you located at the beginning of this procedure to load the miniroot and invoke Inst; be sure that the installation tools and the software version match.

  9. Install the older software version.

    Remember that Inst no longer has valid software installation information about this system, so its initial selections are the default selections (see “Required and Default Subsystems” in Chapter 1). Use Inst to specifically select for installation any additional software you wish to install.

  10. Reboot your system.

  11. Merge configuration files.

    In IRIX, merge config.bak files (listed in /usr/tmp/configlist) with the restored configuration files.

    If you created a backup copy of customized configuration files (described in “Backing Up the Target Systems” in Chapter 2) when you were running this release earlier, you should be able to restore the configuration files from that backup and use them. Add any new configuration information that has been added since they were last used.

    If you have no backup of the current system files, compare the .bak and installed versions of the files in /usr/tmp/configlist, then make the required changes using a process similar to the one for merging configuration files described in “Merging Configuration Files” in Chapter 4. Be careful not to introduce new features from the later release.

If you modified any configuration files, you should restart the system now to boot from the desired configuration.

Avoiding Compatibility Problems

Although some compatibility information is contained in the product descriptions that Inst reads when it accesses a software distribution, Inst allows you to install incompatible software in many situations. The list below contains guidelines for avoiding compatibility problems.

  • Inst tells you about incompatible subsystems when you try to install them. To learn about these incompatibilities earlier, check the release notes for the products that you plan to install.

  • All subsystems of a product should have the same release number. When in doubt, give the showprods command with the -n argument:

    % showprods -n names 
    

    The column that normally contains the installation date contains a number instead. Make sure that all subsystems in each product have the same number. If there are subsystems from different releases in the same product, compatibility problems might result.

  • When you receive a software update, install the new versions of all the products you receive, not just some of them.

  • If any subsystems that you want to install require a miniroot installation, perform all installations during a single miniroot installation session. Performing a single installation prevents incompatibilities that can occur when you switch from one installation to another.

Removing Software

You can remove software from a target system using the versions remove command (see the versions reference page). When you use this command, inst is invoked to perform the removal without user intervention. The subsystems, images, or products to be removed are specified as arguments to the command. For example, this command removes the entire 4DDN product and all release notes from the target:

# versions remove 4DDN *.man.relnotes

To remove all installed software from the target system, you must perform a miniroot installation; you cannot remove all software during a live install, since the miniroot is needed to supply the functions that sustain the system until critical software is replaced. Because removing all software is not desirable under most circumstances, Inst behavior is overridden to perform this procedure.

Follow these instructions to remove all installed software.

  1. Override Inst rules:

    Inst> set rulesoverride on 
    

  2. Select installed subsystems for removal:

    Inst> remove I 
    

  3. Start the removal:

    Inst> go 
    

When you remove software, any configuration files that have been modified are not removed. This preserves any local information that might have been added. To list configuration files, enter the showfiles -cCH command from an IRIX shell.