---

8    Using setld to Install and Remove Software Subsets After an Installation

---

8.1    Using the setld Command

setld [-D root-path] -c subset-id message

setld [-D root-path] -d subset-id [subset-id . . .]

setld [-D root-path] -i [subset-id [subset-id . . .] ]

setld [-D root-path] -l location [subset-id [subset-id . . .] ]

setld [-D root-path] -v subset-id [subset-id . . .]

Table 8-1 provides a brief description of the options for the setld command:

# setld -h 

---

8.2    Displaying Subset Inventories

# /usr/sbin/setld -i 
Subset        Status     Description
------        ------     -----------
OSFACCT410            System Accounting Utilities (System Administration)
OSFAFM410             Adobe Font Metric Files (Printing Environment)
OSFBASE410 installed  Base System (- Required -)
OSFBIN410  installed  Standard Kernel Objects (Kernel Build Environment)
   
.
.
.

# /usr/sbin/setld -i OSFCLINET410
  ./etc/.new..acucap
  ./etc/.new..hosts
   
.
.
.

  ./usr/sbin/bindsetup
  ./usr/sbin/fddi_config

---

8.3    Installing a Software Subset

1. Place your CD-ROM optical disc in its caddy and insert the CD-ROM into the disc drive.

2. As superuser or root, create a directory to be the mount point for the CD-ROM. This example creates a directory called /mnt:

   # mkdir /mnt 

3. Mount the CD-ROM on /mnt. Refer to Appendix B if you do not know how to determine the location of the CD-ROM device. The following example assumes the CD-ROM device is located on the c partition of the rz4 disk:

   # mount -r /dev/rz4c /mnt

   After mounting the CD-ROM, you can change to the /mnt (cd /mnt) directory to view the directories located on the CD-ROM.

4. To install a Digital UNIX base software subset, enter a command similar to the following:

   # setld -l /mnt/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:

   ---

5. The setld command 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 can either 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 can also 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) GNU Emacs
        5) Local Area Transport (LAT)
        6) UNIX(tm) SVID2 Compatibility
        7) UNIX(tm) to UNIX(tm) Copy Facility
   
    - Kernel Build Environment:
        8) ATM Kernel Header and Common Files
        9) ATM Kernel Modules
       10) Logical Storage Manager Kernel Header and Common Files
       11) Logical Storage Manager Kernel Modules
       12) POLYCTR advfs Kernel Modules
   
    - Kernel Software Development:
       13) ATM Kernel Objects
       14) Hardware Kernel Objects
       15) Logical Storage Manager Kernel Objects
       16) POLYCTR advfs Kernel Objects
       17) Standard Kernel Objects
   
    - Mail Applications:
       18) DECwindows Mail Interface
       19) RAND Corp. Mail Handler (MH)
   
    - Network-Server/Communications:
       20) ATM Commands
       21) Additional Networking Services
       22) Dataless Management Services
       23) Remote Installation Service
   
   --- MORE TO FOLLOW ---
   Enter your choices or press RETURN to display the next screen.
   
   Choices (for example, 1 2 4-6):
   
    - Printing Environment:
       24) Adobe Font Metric Files
   
    - Reference Pages:
       25) Ref Pages: Admin/User
       26) Ref Pages: CDE Admin/User
       27) Ref Pages: CDE Development
       28) Ref Pages: Programming
       29) Ref Pages: Realtime
       30) Ref Pages: Windows Admin/User
       31) Ref Pages: Windows Programming
   
    - Software Development:
       32) CDA(tm) Software Development
       33) CDA(tm) for X/Motif Development
       34) CDE Software Development and Programming Examples
       35) GNU Revision Control System
       36) Ladebug Debugger Version 4.0
       37) Ladebug Debugger Version 4.0 Release Notes
       38) Ladebug Debugger Window Interface
       39) Ladebug Debugger remote server
       40) Realtime Software Development
       41) Software Development Desktop Environment
       42) Source Code Control System
       43) Standard Header Files
       44) Static Libraries
       45) X Window and X/Motif Header Files
       46) X Window and X/Motif Programming Examples
       47) X Window and X/Motif Software Development
       48) X Window and X/Motif Static Libraries
   
   
   
   Choices (for example, 1 2 4-6): 25 30
   
    - Supplemental Documentation:
       49) XIE Version 5 Online Documentation
   
    - System Administration:
       50) C2-Security
       51) C2-Security GUI
       52) Kernel Debugging Tools
       53) Logical Storage Manager
       54) Logical Storage Manager GUI
       55) Logical Volume Manager
       56) Obsolete Commands and Utilities
       57) Obsolete Locale databases
       58) POLYCTR advfs
       59) Single-Byte European Locales
       60) System Accounting Utilities
       61) System Exercisers
   
    - Text Processing:
       62) Doc. Preparation Tools
       63) Doc. Preparation Tools Extensions
   
    - Windowing Environment:
       64) DECwindows 75dpi Fonts
       65) LK201 Keyboard Support
       66) LK411 Keyboard Support
       67) LK421 Keyboard Support
       68) LK444 Keyboard Support
       69) PCXAL Keyboard Support
       70) X Customizations for OEM
       71) X Servers for Open3D
       72) X Servers for PCbus
       73) X/Motif 1.1
   
    - Windows Applications:
       74) Additional DECwindows Applications
   
   --- MORE TO FOLLOW ---
   Add to your choices or press RETURN to display the next screen.
   
   
   Choices (for example, 1 2 4-6): 25 30 62
   
       75) Additional X Applications
       76) CDE Additional Applications
       77) Demo X Applications
       78) Nested X Server
       79) Old Additional DECwindows Applications
       80) Virtual X Frame Buffer
   
   The following choices override your previous selections:
   
       81) ALL of the above
       82) CANCEL selections and redisplay menus
       83) EXIT without installing any subsets
   
   Add to your choices, choose an overriding action or
   press RETURN to confirm previous selections.
   
   Choices (for example, 1 2 4-6):  25 30 62

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

   You are installing the following optional subsets:
   
    - Reference Pages:
           Ref Pages: Admin/User
           Ref Pages: Windows Admin/User
   
    - Text Processing:
           Doc. Preparation Tools
   
   Is this correct? (y/n):

7. After you confirm your choice, messages similar to the following display as the software subsets are loaded and configured:

   Checking file system space required to install selected
   subsets:
   
   File system space checked OK.
   
   3 subset(s) will be installed.
   
   Loading 1 of 3 subset(s)....
   
   Doc. Preparation Tools
      Copying from dumper (inet)
      Verifying
   
   Loading 2 of 3 subset(s)....
   
   Ref Pages: Admin/User
      Copying from dumper (inet)
           Working....Fri Dec 13 11:46:17 EST 1996
      Verifying
   
   Loading 3 of 3 subset(s)....
   
   Ref Pages: Windows Admin/User
      Copying from dumper (inet)
      Verifying
   
   3 of 3 subset(s) installed successfully.
   
   
   Configuring "Doc. Preparation Tools " (OSFDCMT410)
   
   Configuring "Ref Pages: Admin/User " (OSFMANOS410)
   
   Configuring "Ref Pages: Windows Admin/User " (OSFMANWOS410)

8. If you are installing from CD-ROM, after the software subsets are installed, unmount the CD-ROM.

   # umount /dev/rz4c

To install Digital software subsets on Remote Installation Services (RIS) clients, refer to Sharing Software on a Local Area Network.

---

8.4    Installing Software Subsets with Dependencies

Checking file system space required to install selected subsets:

File system space checked OK.

1 subset(s) will be installed.

Loading 1 of 1 subset(s)....
setld:
Error installing "Ref Pages: Admin/User " (OSFMANOS410)
This subset requires following subset(s) to operate correctly:

        "Doc. Preparation Tools " (OSFDCMT410)
setld:
Please install required subset(s) first.

0 of 1 subset(s) installed successfully.

The setld command will not install software subsets with dependencies without installing the software subset on which the dependency occurs. You must invoke the setld command again and make sure you select all software subsets along with their dependencies.

Appendix D describes each software subset and shows the dependencies between software subsets (if any).

---

8.5    Rebuilding the Kernel After Installing Kernel Build Environment Subsets

Refer to Table D-4 in Appendix D for a list of the software subsets that contain kernel components for which you must run doconfig to build a new kernel. Refer to the doconfig(8) reference page for more information about the doconfig utility.

---

8.6    Rebuilding the Kernel After Installing ATM Adapters