9 Software Management

This chapter discusses the following topics:

An overview of software management tools (Section 9.1)

Using the SysMan Menu to perform software management tasks (Section 9.2)

Determining software subset status (Section 9.3)

Displaying a list of files within a software subset (Section 9.4)

Removing software subsets from a single system (Section 9.5)

Removing software subsets from a cluster (Section 9.6)

Installing optional software subsets on a single system (Section 9.7)

Installing optional software subsets on a cluster (Section 9.8)

Rebuilding the kernel after installing kernel build environment software subsets (Section 9.9)

9.1 Software Management Overview

Optional operating system software subsets, worldwide language support (WLS) software subsets, and layered product software subsets can be installed or removed from a system after a Full or Update Installation.

Software subsets can be installed from any CD-ROM shipped with the operating system, a Remote Installation Services (RIS) server, a mounted disk or file system, or a third-party software CD-ROM.

This chapter describes the two software management tools that can be used to perform software management tasks: the SysMan Menu and the setld utility. Both tools provide the same features. The difference between the two is that setld is strictly a command line utility, while the SysMan Menu can be invoked and run in three environments: X, text-based, or the Internet.

This chapter focuses on the setld command line utility because the SysMan Menu software management tasks have an online help system, which is available if you need assistance.

9.2 Software Management from the SysMan Menu

The SysMan Menu is a menu of system management tasks, which is organized in a tree-like hierarchy with main branches of general functionality. Selecting a leaf invokes a task, which opens a dialog box for performing the task.

Depending on the capabilities of your display device, the SysMan Menu provides either a graphical or text-based interface. The SysMan Menu can be invoked from the command line or from the CDE Application Manager if your system is running the CDE desktop.

Invoke the SysMan Menu from the command line by entering the following command:

# /usr/sbin/sysman &

From the SysMan Menu, expand the Software and Installation branches to view the software management tasks as shown in Figure 9-1.

Note

The SysMan Menu is not supported for software load and delete operations on clusters. Use the setld utility to install or remove software subsets on a cluster.

Figure 9-1: SysMan Menu: Expanded Software and Installation Branches

The following is a brief description of each software management task shown in Figure 9-1:

Install software
Installs additional optional software subsets after a Full or Update Installation of the operating system. Supported distribution media includes CD-ROM, RIS server, or mounted disk or file system.

List installed software
Lists the software subsets that are installed and displays a list of the system files contained within a particular software subset.

Remove installed software
Removes software already installed on the system. Dependencies between software subsets automatically are recognized and reported.

Cleanup after an OS update
Invokes the Update Administration Cleanup utility, which is used to remove the backup files created by an Update Installation. This utility is described in Section 3.10.

Each software management task has online help that is available by selecting Help from within the task. The online help describes the functions that can be performed as well as a detailed description of all windows, dialog boxes, and fields that require entries.

9.3 Determining Software Subset Status

Use the setld -i command to list the software subsets recognized by your system. Command output shows the state (or status) of each software subset.

Descriptions of the valid software subset states are located in the setld(8) reference page. A subset can be in any one of the following states: not installed, deleting, pre-load failed, pre-load complete, load failed, load completed, post-load failed, post-load completed, c-install failed, installed, member load failed, member loaded, or unknown.

Output from the setld -i command is similar to the following:

# /usr/sbin/setld -i
Subset           Status         Description
------           ------         -----------
OSFACCT520       not installed  System Accounting Utilities (System Administration)
OSFADVFS520      installed      AdvFS Commands (System Administration)
OSFADVFSBIN520   installed      AdvFS Kernel Modules (Kernel Build Environment)
   
.
.
.
OSFXSYSMAN520    installed      Graphical Base System Management Utilities
                                      (System Administration)
OSFXVFB520       not installed  Virtual X Frame Buffer (Windows Applications)

9.4 Listing Files Contained in a Subset

If you enter the -i option and specify a software subset name, the setld utility displays a list of the files in the specified software subset. This is useful if you want to determine which software subset you need to reload or delete if a particular file is damaged or deleted.

The following command displays the files in the OSFXSYSMAN520 software subset:

# /usr/sbin/setld -i OSFXSYSMAN520
./.dt
./.dt/types
./.dt/types/sysmanfp.dt
./.dt/types/sysmanfp.fp
./etc/shortlist.desc
./usr/bin/X11/dxaccounts
     
.
.
.

9.5 Deleting Software Subsets from a Single System

Deleting a software subset requires that you know the subset name (OSFACCT520 for example). See Appendix C for the name and description of each software subset. To delete a software subset, log in as root, and use the setld -d command with the following syntax:

/usr/sbin/setld [-D root_path] -d [-f] [subset-id [ subset-id... ] ]

If you attempt to delete a software subset on which another subset depends, a message similar to the following is displayed:

# setld -d OSFDCMT520
 
The following subsets need "Doc. Preparation Tools" (OSFDCMT520) 
to operate correctly:
 
  Ref Pages: CDE Development (OSFCDEMANOP520)
  Ref Pages: CDE Admin/User (OSFCDEMANOS520)
  Doc. Preparation Tools Extensions (OSFDCMTEXT520)
  Ref Pages: Programming (OSFMANOP520)
  Ref Pages: Admin/User (OSFMANOS520)
  Ref Pages: Windows Programming (OSFMANWOP520)
  Ref Pages: Windows Admin/User (OSFMANWOS520)
 
Are you sure you wish to delete "Doc. Preparation Tools" 
(OSFDCMT520)? (y/n): y
 
Deleting "Doc. Preparation Tools" (OSFDCMT520)

In the previous example, the reference page software subsets depend on the Doc. Preparation Tools (OSFDCMT520) subset in order to operate properly. If you do not delete the dependent subsets, the dependent subsets will not function properly.

9.6 Deleting Software Subsets from a Cluster

Deleting one or more software subsets from a cluster is no different from deleting one or more software subsets from a single system; deleting a software subset from a cluster requires that you know the subset name.

To delete a software subset from a cluster, log in as root to any member in the cluster, and use the setld -d command with the following syntax:

/usr/sbin/setld -d [subset-id [ subset-id... ] ]

The setld -d command can be invoked from any member in the cluster, and the delete operation takes place across all cluster members. If a cluster member is down at the time of a subset deletion, for each member that is down, run setld -Z once the member or members come up. If necessary, run setld -Z -f if the original setld -Z fails.

Subset deletion messages appear on the member on which the operation was initiated.

For a record of the software subset deletion activity for each cluster member, review the log file located at /var/adm/smlogs/setld.log on each cluster member.

9.7 Installing Software Subsets on a Single System

To install an optional software subset, log in as root, and use the setld -l command with the following syntax:

/usr/sbin/setld [-D root_path] -l location [subset-id [ subset-id... ] ]

The location parameter specifies the location of the software subset that you want to install. The following are valid locations:

ris_server: specifies the name of the remote host (RIS server) appended with a colon ( : ).

directory specifies the disk distribution directory. The directory must be the parent of the instctrl directory.

The subset-id variable specifies the name of the software subset. If you do not specify a subset-id variable, a list of software subsets is displayed, which lets you choose the software subsets to install. If you specify one or more subset-id variables, only those software subsets are installed. See Appendix C for the names and descriptions of all software subsets.

Use the following procedure to install software subsets from a CD-ROM. The distribution path shown in the following examples is for the base operating system CD-ROM. For other distribution kits, refer to the document supplied by your software vendor.

Insert the CD-ROM into the disc drive.

As superuser or root create a directory to be the mount point for the CD-ROM. This example creates a directory called /cdrom:
```
# mkdir /cdrom 
```

Mount the CD-ROM on /cdrom. See Appendix B if you do not know the CD-ROM device name. The following example assumes a single CD-ROM device is attached to the system:
```
# mount -r /dev/disk/cdrom0c /cdrom
```
After mounting the CD-ROM, you can change to the /cdrom ( cd /cdrom ) directory to view the directories located on the CD-ROM.

Enter a command similar to the following to install the base operating system software subsets:
```
# setld -l /cdrom/ALPHA/BASE
```
Note

If you are using a RIS server as the source of the software, make sure your system is registered as a client of the RIS server, then enter a command similar to the following:
```
# setld -l ris_server_name:
```

The setld utility displays a numbered list of software subset descriptions and prompts you to enter the number of the software subsets you want to install.

Enter the number or numbers associated with the software subsets you want to install. There may be more software subsets presented in the menu than can be displayed on a single screen. You either can select software subsets in each screen or select them all together on the last screen. If you select software subsets as each screen is displayed, all your choices are presented for you to confirm on the final screen. You also can change your choices or redisplay the software subset options.

Only the software subsets not yet installed on your system are displayed. The software subset selection list looks similar to the following:

The subsets listed below are optional:
 
There may be more optional subsets than can be presented on a single
screen. If this is the case, you can choose subsets screen by screen
or all at once on the last screen. All of the choices you make will
be collected for your confirmation before any subsets are installed.
 
 - General Applications :
 
     1) Additional Terminfo databases
     2) Computer Aided System Tutor
     3) DOS tools
     4) Local Area Transport (LAT)
     5) Perl Runtime 
     6) UNIX(tm) SVID2 Compatibility 
     7) UNIX(tm) to UNIX(tm) Copy Facility  
 
 - Kernel Build Environment :
 
     8) Logical Storage Manager Kernel Modules 
     9) POLYCTR advfs Kernel Modules 
 
 - Kernel Software Development :
 
    10) Hardware Kernel Objects 
    11) POLYCTR advfs Kernel Objects
    12) Standard Kernel Objects 
 
 - Mail Applications :
 
    13) DECwindows Mail Interface 
    14) RAND Corp. Mail Handler (MH)
 
 - Network-Server/Communications :
 
    15) ATM Commands 
    16) Additional Networking Services 
    17) Dataless Management Services 
    18) Remote Installation Service
 
 - Printing Environment :
 
    19) Adobe Font Metric Files 
 
--- MORE TO FOLLOW ---
Enter your choices or press RETURN to display the next screen.
 
Estimated free diskspace(MB) in root:62.3 usr:405.6
 
Choices (for example, 1 2 4-6): 11

At the bottom of each screen, the disk space available in the /, /usr, var, and i18n file systems is shown. As you select additional subsets, the amount of free disk space is reduced accordingly.

If you choose a subset that depends on another subset to be installed, the setld utility automatically selects the dependent subset or subsets. For example, if you choose POLYCTR advfs Kernel Objects, the following is displayed:

The chosen subset(s) require one or more additional subset(s) 
which will be loaded automatically: 
 
 * 9 POLYCTR advfs Kernel Modules        (OSFADVFSBIN520)
 
 - Software Development :
 
    20) CDA(tm) Software Development 
    21) CDA(tm) for X/Motif Development
    22) CDE Software Development and Programming Examples 
    23) GNU Revision Control System  
    24) Ladebug Debugger Version 4.0-43 
    25) Ladebug Debugger Version 4.0-43 Release Notes  
    26) Ladebug Debugger graphical user interface
    27) Ladebug Debugger remote server 
    28) Programming Examples  
    29) Software Development Desktop Environment  
    30) Software Development Tools and Utilities 
    31) Source Code Control System 
    32) Standard Header Files
    33) Standard Programmer Commands
    34) Static Libraries 
    35) X Window and X/Motif Header Files 
    36) X Window and X/Motif Programming Examples 
    37) X Window and X/Motif Software Development
    38) X Window and X/Motif Static Libraries 
 
 - Supplemental Documentation :
 
    39) XIE Version 5 Online Documentation 
 
 - System Administration :
 
    40) ATM Configuration Application
    41) Advanced File System Daemon 
    42) Advanced File System Graphical User Interface
    43) C2-Security
    44) C2-Security GUI 
 
--- MORE TO FOLLOW ---
 
Add to your choices or press RETURN to display the next screen.
 
Estimated free diskspace(MB) in root:61.2 usr:403.9
 
Choices (for example, 1 2 4-6):  11 40

After you enter all your choices, the following confirmation message is displayed:

You are installing the following optional subsets:
 
 - Kernel Build Environment :
        POLYCTR advfs Kernel Modules
 
 - Kernel Software Development :
        POLYCTR advfs Kernel Objects 
 
 - System Administration :
        ATM Configuration Application 
        POLYCTR advfs 
 
Estimated free diskspace(MB) in root:56.6 usr:402.8
 
Is this correct? (y/n): y

After you confirm your choices, messages similar to the following are displayed as the software subsets are loaded and configured:

Checking file system space required to install selected subsets:
 
File system space checked OK.
 
4 subset(s) will be installed.
 
Loading subset 1 of 4 ...
 
POLYCTR advfs Kernel Modules
   Copying from risserver1 (inet)
   Verifying
 
Loading subset 2 of 4 ...
 
POLYCTR advfs
   Copying from risserver1 (inet)
        Working....Fri Aug 24 14:48:02 EST 2001
   Verifying
 
Loading subset 3 of 4 ...
 
ATM Configuration Application
   Copying from risserver1 (inet)
   Verifying
 
Loading subset 4 of 4 ...
 
POLYCTR advfs Kernel Objects
   Copying from risserver1 (inet)
        Working....Fri Aug 24 14:48:34 EST 2001
   Verifying
 
4 of 4 subset(s) installed successfully.
 
Configuring "POLYCTR advfs Kernel Modules" (OSFADVFSBIN520)
 
Configuring "POLYCTR advfs" (OSFADVFS520)
 
Configuring "ATM Configuration Application" (OSFATMGUI520)
 
Configuring "POLYCTR advfs Kernel Objects" (OSFADVFSBINOBJECT520)

If you are installing from CD-ROM, unmount the CD-ROM after the software subsets are installed:
```
# cd/
# umount /dev/disk/cdrom0c
```

9.8 Installing Optional Software Subsets on a Cluster

Installing one or more optional software subsets onto a cluster is no different from installing one or more software subsets onto a single system.

To install optional software subsets onto a cluster, log in as root to any member in the cluster, and follow the step-by-step instructions for mounting the distribution media and invoking setld as shown in Section 9.7. The software load takes place across all cluster members. If a cluster member is down at the time of a subset load, the load information is stored, and the load operation takes place as soon as the cluster member comes back online.

Subset load and configuration messages are displayed on the member on which the load operation was initiated. For example, if you initiate the load operation of the OSFDCMT520 subset on member2 of a three member cluster, messages similar to the following are displayed on member2:

Checking file system space required to install selected subsets:
 
File system space checked OK.
 
1 subset(s) will be installed.
 
Loading subset 1 of 1 ...
 
Doc. Preparation Tools
   Copying from risserver1 (inet)
        Working....Fri Aug 24 14:48:02 EST 2001
   Verifying
 
1 of 1 subset(s) installed successfully.
 
Configuring "Doc. Preparation Tools" (OSFDCMT520) on member 0.
Configuring "Doc. Preparation Tools" (OSFDCMT520) on member 1.
Configuring "Doc. Preparation Tools" (OSFDCMT520) on member 2.
Configuring "Doc. Preparation Tools" (OSFDCMT520) on member 3.

In a cluster, member0 is not a physical machine; it is a directory that serves as a general repository for cluster member specific information.

For a record of the software subset load activity for each cluster member, review the log file located at /var/adm/smlogs/setld.log on each cluster member.

9.9 Rebuilding the Kernel After Installing Kernel Build Environment Subsets

Certain base operating system products (such as the Logical Storage Manager, Advanced File System, and Asynchronous Transfer Mode) contain a kernel component. If you use setld to install one of these software subsets after the installation, you must run the doconfig utility to rebuild the kernel with the new kernel component; otherwise you will not be able to use the software product. After building a new kernel, move the new kernel to the / (root) file system, and reboot with the new kernel to make the product available for use.

See Appendix C for a list of the software subsets that contain kernel components for which you must run the doconfig utility to build a new kernel. See doconfig(8) for more information.

If you install the Asynchronous Transfer Mode (ATM) DGLTA adapter after installing the operating system, you must boot the system off the generic kernel genvmunix, install the ATM software subsets from the CD-ROM, and then run the doconfig utility to rebuild your system kernel to enable the added ATM support. To configure the adapter, run the ATM configuration utility from the SysMan Menu.