[Return to Library] [Contents] [Previous Chapter] [Next Section] [Next Chapter] [Index] [Help]


8    Using the setld Command to Install and Remove Software Subsets After An Installation

The goal of this chapter is to provide the information necessary for you to use the setld command to perform the following tasks:

A detailed technical explanation of the setld command is documented in Guide to Preparing Product Kits.


[Return to Library] [Contents] [Previous Chapter] [Next Section] [Next Chapter] [Index] [Help]


8.1    Using the setld Command

The syntax of the setld command is as follows:

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:

Table 8-1: Options for the setld Command

Option Description
-D In conjunction with any other option, specifies an alternative root directory. For example:

setld -D /usr/doctools -i

  The directory specified must be the root directory of an entire system hierarchy. Do not attempt to use this option to place software in a directory that is not a system root.
-l Loads the software kits that are in the specified location; if software subsets are specified, only the named software subsets are installed. For example:

setld -l /mnt/ALPHA/BASE DNABASE100

-c Runs the configuration phase of the named software subset's subset control program (SCP). Refer to the document supplied by your software vendor for the command syntax. For example:

setld -c DNABASE100 INSTALL

-i Displays a list of software subsets and their installation status. If a software subset is named, displays a list of that software subset's contents. For example:

setld -i OSFMANOS400

-v Runs the named software subset's Installation Verification Procedure (IVP). For example:

setld -v OSFMANOS400

-d Deletes the named software subset or software subsets. For example:

setld -d OSFMANOS400 OSFMANOP400

To list all the options available for the setld command, use the -h option:

setld -h


[Return to Library] [Contents] [Previous Chapter] [Previous Section] [Next Section] [Next Chapter] [Index] [Help]


8.2    Displaying Subset Inventories

You can use the setld command to display an inventory of the software subsets recognized by your system, showing the status (installed or not installed) of each software subset.

To display a software subset inventory, use the setld -i command with the following syntax:

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

The following command shows the status of the software subsets:

/usr/sbin/setld -i 

Subset        Status     Description
------        ------     -----------
OSFACCT400            System Accounting Utilities (System Administration)
OSFAFM400             Adobe Font Metric Files (Printing Environment)
OSFBASE400 installed  Base System (- Required -)
OSFBIN400  installed  Standard Kernel Objects (Kernel Build Environment)

.
.
.

If you use the -i option to specify a software subset, the setld command 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 OSFCLINET400 software subset:

/usr/sbin/setld -i OSFCLINET400

  ./etc/.new..acucap
  ./etc/.new..hosts

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

Use the -D option to specify a root directory other than the system root.


[Return to Library] [Contents] [Previous Chapter] [Previous Section] [Next Section] [Next Chapter] [Index] [Help]


8.3    Installing a Software Subset

This section describes how to install software subsets from a specified location. To install a 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 variable specifies the location of the software subset that you want to install. You can specify the following location variables:

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.

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

  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 Mar 15 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 " (OSFDCMT400)
     
    Configuring "Ref Pages: Admin/User " (OSFMANOS400)
     
    Configuring "Ref Pages: Windows Admin/User " (OSFMANWOS400)

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

    umount /dev/rz4c

Note

If there are upgrades to the software subsets you installed previously, you may need to install these upgrade software subsets. To perform an upgrade, enter the following command:

setld -l /mnt/ALPHA/UPDATE

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


[Return to Library] [Contents] [Previous Chapter] [Previous Section] [Next Section] [Next Chapter] [Index] [Help]


8.4    Installing Software Subsets with Dependencies

If you select a software subset that has a dependency on another subset that is not yet selected or is not already installed, you will see a message similar to the following during subset loading:

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 " (OSFMANOS400) This subset requires following subset(s) to operate correctly:
 
"Doc. Preparation Tools " (OSFDCMT400) setld: Please install required subset(s) first.
 
0 of 1 subset(s) installed successfully.

In the previous example, the reference page software subset was not installed because it requires the installation of the Doc. Preparation Tools (OSFDCMT400).

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 C describes each software subset and shows the dependencies between software subsets (if any).


[Return to Library] [Contents] [Previous Chapter] [Previous Section] [Next Section] [Next Chapter] [Index] [Help]


8.5    Rebuilding the Kernel After Installing Kernel Build Environment Subsets

Certain Digital UNIX base operating system products (such as the Logical Storage Manager, Advanced File System, and Local Area Transport) 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 the option to use the product will not be available. After building a new kernel, reboot with the new kernel to make the product available for use.

Refer to Table C-4 in Appendix C 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.


[Return to Library] [Contents] [Previous Chapter] [Previous Section] [Next Chapter] [Index] [Help]


8.6    Rebuilding the Kernel After Installing ATM Adapters

If you install the Asynchronous Transfer Mode (ATM) DGLTA adapter after installing Digital UNIX, you must boot the system off the generic kernel genvmunix, install the ATM software subsets from the CD-ROM, and then run the doconfig program to rebuild your system kernel to enable the added ATM support.