---

6    Testing the Installation of a Kit

• The setld utility can install a kit either during system installation or after the system is running.

• The osfboot utility installs foreign device kits before the initial bootstrap of a system. During system installation, the setld utility installs the kit so that it is available for subsequent reboots of the system.

• The RIS utility integrates a foreign device kit into a RIS environment. Client systems can then install the kit from the RIS area by calling the setld utility.

Before shipping a product to customers, you should test the installation of the kit by using the same procedures that your customers will use. You should run these tests on hardware configurations that resemble your customers' systems. When you know that the installation procedure works correctly, you should document it and ship it as part of the product kit.

This chapter describes how to test the installation of a user product, kernel product, and foreign device kit, and how to install a kit in a RIS environment.

---

6.1    Installing a User Product

1. Place the CD-ROM in the drive.

2. Create a directory to be the mount point for the CD-ROM, such as /cdrom:

   # mkdir /cdrom

3. Mount the CD-ROM on /cdrom. For example, if the CD-ROM device were located on the c partition of rz4, you would enter the following command:

   # mount -r /dev/rz4c /cdrom

   After mounting the CD-ROM, you can change to the /cdrom directory and view the directories on the CD-ROM.

4. Install the user product subsets:

   # setld -l /cdrom/ALPHA/OAT100

   The setld utility displays prompts and messages to guide you through the process of selecting the subsets you want to install. After it loads the subsets, setld calls the subset control program for each subset. Figure 6-1 shows the links and dependencies that the ODB subset control program creates.

   ---

   Figure 6-1: Defining Links and Dependicies for the ODB User Product

   ---

   
   
   

5. When the installation is complete, unmount the CD-ROM:

   # umount /cdrom

See the Installation Guide for more information on using the setld utility to install layered products.

---

6.2    Installing a Kernel Product

For example, the /dev/none driver would be installed as follows, if the kit were distributed on CD-ROM:

1. Insert the CD-ROM in the drive.

2. Create a directory to be the mount point for the CD-ROM, such as /cdrom:

   # mkdir /cdrom

3. Mount the CD-ROM on /cdrom. For example, if the CD-ROM device were located on the c partition of rz4, you would enter the following command:

   # mount -r /dev/rz4c /cdrom

4. Install the device driver subsets:

   # setld -l /cdrom/ALPHA/ESA100

   The setld utility displays prompts and messages to guide you through the process of selecting the subsets you want to install. After it loads the subsets onto the system, setld invokes the subset control program to statically or dynamically configure the driver. Figure 6-2 shows the steps the subset control program takes to statically configure the driver; Figure 6-3 shows the steps the subset control program takes to dynamically configure the driver.

5. When the installation is complete, unmount the CD-ROM:

   # umount /cdrom

6. Restart the system with the new kernel:

   # /usr/sbin/shutdown -r now

   When the system starts up, the /dev/none driver is available on the system.

Figure 6-2: Statically Configuring a Driver

---

---

Figure 6-3: Dynamically Configuring a Driver

---

See the Installation Guide for more information on using the setld utility to install layered products. See doconfig(8) for more information on the doconfig utility.

---

6.3    Installing a Foreign Device Kit

Figure 6-4 shows the steps that osfboot takes to build a kernel that includes the foreign device.

Figure 6-4: Bootstrap Linking with a Foreign Device Kit

---

The following steps show how to install the /dev/edgd driver as a foreign device:

1. Insert the Digital UNIX kit in the CD-ROM drive.

2. From the console prompt, invoke the osfboot utility with the -fl option and the fg flags, as follows:

   >>> boot -fl "fg" dka400

   The utility reads bootstrap code from the CD-ROM.

3. The osfboot utility prompts you for the name of the device from which to install the foreign device kit. Enter the appropriate console firmware device name, for example (for a diskette device):

   Enter Device Name: dva0

   For a list of device names, enter the following command:

   >>> sho dev

4. The osfboot utility prompts you for the name of the foreign device kit. With the information you supply here, the utility builds a list of the modules that will go into the kernel. To install the /dev/edgd driver, enter the following:

   Enter Kit Name: edgd.kit

5. Insert the media and press the return key:

   Insert media for kit 'dva0:edgd.kit', press Return 
   when ready: [Return]

6. You may want to install more than one foreign device kit. The osfboot utility prompts you to enter more kit names. These names are also added to the list of modules that will go into building the kernel. Each time you enter a kit name, you must also insert the media that contains the kit. Press the return key (without entering a kit name) in response to this prompt to indicate that there are no more kits:

   Enter Kit Name: [Return]

7. When all the kit names have been entered, osfboot prompts you to reinsert the media that contains the Digital UNIX base system. This is to ensure that you have not replaced the base system kit with a foreign device kit during the previous steps:

   Insert boot media, press Return 
   when ready: [Return]

8. At this point, osfboot prompts you to reenter the kits that you want included in the kernel. This time, osfboot reads the modules from the kits and links them into the kernel.

9. When the link operation has completed, osfboot prompts you to reboot the system. As the system boots up, you must reinsert the foreign device kit one more time to load the subsets and install them on the system.

   Insert media for kit 'dva0:edgd.kit', press Return 
   when ready: [Return]
   
   Insert boot media, press Return when ready: [Return]

   This step repeats once for each kit you named. Later in the installation procedure, the setld utility installs the kits and builds a kernel configuration that includes them.

---

6.4    Installing a User or Kernel Product into a RIS Area

To install the product kit from the RIS server onto the client system, register the client system with the RIS server, then use the setld utility, as follows:

1. Run the RIS utility on the server, and choose ADD a client from the main menu:

   # /usr/sbin/ris
   
   # 
   *** RIS Utility Main Menu ***
   
   Choices without key letters are not available.
   
       a)  ADD a client
       d)  DELETE software products
       i)  INSTALL software products
        )  LIST registered clients
        )  MODIFY a client
        )  REMOVE a client
       s)  SHOW software products in remote installation 
           environments
       x)  EXIT
   
   Enter your choice: a

   Enter the client information requested by the prompts, as described in Sharing Software on a Local Area Network.

2. As superuser or root on the client system, install the product subsets from the RIS area. For example, if the RIS area were on node visier, you would enter the following command:

   # setld -l visier:

   The setld utility displays prompts and messages to guide you through the installation process. See the Installation Guide for more information on using the setld utility to install layered products.

---

6.5    Installing a Foreign Device Kit into a RIS Area

1. On the RIS server, choose INSTALL software products from the RIS Utility Main Menu.

   *** RIS Utility Main Menu ***
   
   Choices without key letters are not available.
   
       a) ADD a client
       d) DELETE software products
       i) INSTALL software products
        ) LIST registered clients
        ) MODIFY a client
        ) REMOVE a client
       s) SHOW software products in remote installation 
          environments
       x) EXIT
   
   Enter your choice: i

2. From the RIS Software Installation Menu, choose Add software into an existing area. The RIS utility displays the name of the existing environment. In this example, the name is /usr/var/adm/ris/ris0.alpha.

   RIS Software Installation Menu:
   
       1)  Install software into a new area
       2)  Add software into an existing area
       3)  Return to previous menu
   
   Enter your choice: 2
   
   You have chosen to add a product to an existing 
   environment.
   
   The existing environment is /usr/var/adm/ris/ris0.alpha.

3. The RIS utility prompts you to enter the location of the software that you want to install. In this example, the name is /floppy/ALPHA/EDGSTATIC100. The path you enter is the name of the top-level directory on the distribution media for the product kit.

   Enter the device special file name or the path of the
   directory where the software is located (for example,
   /mnt/ALPHA/BASE): /floppy/ALPHA/EDGSTATIC100

4. The RIS utility displays a list of the base products that are installed in the RIS area. You must choose one; this is the base product to which the foreign device kit will be added. In this example, there is only one base product to choose from.

   Please select one of the following products to 
   base against or add the kit to.
   
        1   'Digital UNIX V4.0 Operating System ( Rev 375 )'
   
   Enter your selection or (return) to quit : 1

5. The RIS utility loads the product from the distribution media into the RIS area in preparation for the installation. No user interaction is required at this time.

   Preparing new product area...
           Working....Mon Apr 29 15:06:33 EDT 1996
           Working....Mon Apr 29 15:08:34 EDT 1996
           Working....Mon Apr 29 15:10:35 EDT 1996
             .
             .
             .

6. When all the subsets have been loaded, the RIS utility lets you choose which subsets you want to install. In this example, the /dev/edgd kit contains only one subset.

   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 extracted.
   
        1) EDGD kit subset
   
    Or you may choose one of the following options:
   
        2) ALL of the above 
        3) CANCEL selections and redisplay menus
        4) EXIT without extracting any subsets 
   
   Enter your choices or press RETURN to redisplay menus.
   
   Choices (for example, 1 2 4-6): 1

7. The RIS utility gives you the chance to confirm your choice.

   You are installing the following optional subsets:
   
           EDGD kit subset
   
    Is this correct? (y/n): y

8. The RIS utility extracts the foreign device kit into the RIS area. No user interaction is needed at this time.

   Checking file system space required to extract selected 
   subsets:
   
   File system space checked OK.
   Extracting EDGSTATIC100...
   Media extraction complete.
   .
   .
   .
   EXTRACT phase for EDGD kit installation into RIS area

9. The foreign device has been extracted into the RIS area and installed into a new version of the base system. If you choose SHOW software products in remote installation environments from the RIS Utility Main Menu, you can see that there are now two base products -- Digital UNIX Version 4.0 without the /dev/edgd foreign device kit and Digital UNIX Version 4.0 with the /dev/edgd foreign device kit.

   *** RIS Utility Main Menu ***
   
   Choices without key letters are not available.
   
       a) ADD a client
       d) DELETE software products
       i) INSTALL software products
        ) LIST registered clients
        ) MODIFY a client
        ) REMOVE a client
       s) SHOW software products in remote installation 
          environments
       x) EXIT
   
   Enter your choice: s
   
   1  /usr/var/adm/ris/ris0.alpha
         'Digital UNIX V4.0 Operating System ( Rev 375 )'
         'Digital UNIX V4.0 Operating System ( Rev 375 )' w/ 
   'EDGSTATIC software version 1' 

1. On the RIS server, choose Add a client from the RIS Utility Main Menu.

   *** RIS Utility Main Menu ***
   
   Choices without key letters are not available.
   
       a) ADD a client
       d) DELETE software products
       i) INSTALL software products
        ) LIST registered clients
        ) MODIFY a client
        ) REMOVE a client
       s) SHOW software products in remote installation 
          environments
       x) EXIT
   
   Enter your choice: a

2. Through a series of prompts, the RIS utility lets you know what information you need to enter and gives you the opportunity to exit from the procedure.

   You have chosen to add a client for remote installation 
   services.
   
   The following conditions must be met to add a client:
   
           1. You must know the client processor's hostname
           2. The client's hostname must be in your system's 
              host database(s).
           3. You must know whether the client is on an 
              Ethernet, FDDI, or Token Ring network.
           4. You must know the client's hardware Ethernet, 
              FDDI, or Token Ring address if the client is 
              registering to install operating system software.
           5. If the client and the server reside on different 
              subnets, you will need the address of the 
              gateway(s) that the client can use to 
              communicate with the server.
   
   Do you want to continue? (y/n) [y]: y

3. The RIS utility prompts you for the client processor's host name. In this example, the name is xnite.

   Enter the client processor's hostname or press RETURN 
   to quit: xnite
   
   The existing environment is /usr/var/adm/ris/ris0.alpha

4. The RIS utility prompts you to choose the products for the client to install. In this example, the user chooses the base system that includes the /dev/edgd foreign device.

   Select one or more products for the client to install
   from /usr/var/adm/ris/ris0.alpha:
   
   Product    Description
      1    'Digital UNIX V4.0 Operating System ( Rev 375 )'
      2    'Digital UNIX V4.0 Operating System ( Rev 375 )' w/ 
   'EDGSTATIC software version 1' 
   
   The following products:  1 2, are Operating System Base 
   products. Please select only one of these products when 
   making your selections.
   
   Enter one or more choices as a space-separated list
   (for example, 1 2 3): 2

5. The RIS utility displays the product you have chosen and gives you the opportunity to confirm your choice.

   You chose the following products: 
   
      2    'Digital UNIX V4.0 Operating System ( Rev 375 )' w/ 
   'EDGSTATIC software version 1' 
   
   Is that correct? (y/n) [y]:y

6. The RIS utility prompts you to enter the network type and the client processor's hardware network address.

   Network type:
           1) Ethernet or FDDI
           2) Token Ring
   
   Enter your choice: 1
   
   Enter the client processor's hardware network address.  
   For example, 08-00-2b-02-67-e1: 08-00-2b-e2-3a-43 

7. If this is the first client added for this product, RIS builds the kernel at this time. No user interaction is required.

   A new generic install kernel for the client systems will 
   now be built which includes support for the 3rd party 
   device(s).
   
   *** PERFORMING KERNEL BUILD ***
           Working....Mon Apr 29 14:37:39 EST 1996
           Working....Mon Apr 29 14:39:40 EST 1996
            .
            .
            .

8. Preparation of the kit in the RIS area is complete. You may exit from the RIS utility.

>>> boot ewa0