3.5 Installing Under UnixWare 2.1

Note: Install your MC1 boards in your system before installing the software. (See Chapter 2 to learn how to do this.) Make a note of the base I/O addresses at which you installed the boards. The installation program will prompt you for these addresses.

1. If you are installing over earlier versions of MC1 software, remove the earlier version and rebuild the kernel before you install the new software.

2. See section 3.5.2 to learn how to remove driver software from your system.

3. Access a command prompt, and log in as root.

4. Insert the MC1 board installation diskette into your floppy disk drive.

5. Enter this command to invoke the pkgadd utility:

     pkgadd -d diskette1
   

6. pkgadd starts up, and displays a list of software packages available for installation.

7. Select the "mc1" software package, and press Enter.

8. pkgadd copies the driver software from the disk onto your system.

9. When pkgadd has finished copying files, it displays the following message:

      You will now be asked to provide the base addresses of the MC1
      Boards you are installing in your system. When you are prompted for
      a base address, a list of possible choices will be given.
   
      If you are installing more than one MC1 Board into your system,
      the choices you have already selected during this installation will be
      marked, and the device node name that will be used to access the
      MC1 Board is listed.
   
      Enter c to continue or enter q to quit:
   

10. Enter "c".

11. pkgadd displays a menu of base I/O addresses.

12. Mark the addresses of the MC1 boards in your system.

13. To select an address, enter its number. The menu reappears with the address marked "already selected".

14. As you select addresses, make a note of the order in which you select them. The install program assigns device numbers to your boards based on the order in which they are selected. When you create your application using SwitchPath or the sw utility, you will use these numbers to refer to your boards in software.

15. For example, if you mark address 0x0640 first and then address 0x2140, the board at address 0x0640 is assigned device number 0. The board at address 0x2140 is assigned device number 1.

16. When you have selected the addresses of all of your boards, enter 0. pkgadd asks if you want to rebuild the kernel with the MC1 Interface Board Driver. Enter "y".

17. pkgadd marks the kernel to be rebuilt on the next reboot.

    Note: pkgadd may warn you that it is about to overwrite newer versions of files on your system with older ones. This warning may appear even if the files you are installing are actually newer than the ones on your system. This is because files installed with earlier versions of the install script were marked with the installation date, not their creation dates. Later versions of the script preserve the creation date.
    
    This warning may appear particularly if you have installed SwitchPath. If you have SwitchPath 1.1 or earlier, direct pkgadd to overwrite the "newer" files. If you have a later version of SwitchPath, do not overwrite files.

18. When the kernel rebuild is complete, the following message appears:

       Installation of MC1 for UnixWare 2.1 (mc1) was successful.
    

19. Type "q" to quit.

20. Shut down your system and reboot.

21. The driver will not be available until you reboot.

1. Access a command prompt, and log in as root.

2. Execute the confdrvr shell script by entering this command:

      sh /opt/nms/mc1/drv/confdrvr
   

3. confdrvr starts up. It displays this message:

      You will now be asked to provide the base addresses of the MC1
      Boards you are installing in your system. When you are prompted for
      a base address, a list of possible choices will be given.
   
      If you are installing more than one MC1 Board into your system,
      the choices you have already selected during this installation will be
      marked, and the device node name that will be used to access the
      MC1 is listed.
   
   Enter c to continue or enter q to quit:
   

4. Enter "c".

5. confdrvr displays a menu of base I/O addresses.

6. Mark the base I/O addresses of ALL boards in your system, just as you did during the initial install procedure. (See section 3.4 for more information.)

   Note: Even if you are adding a new board to a system which already includes MC1 boards, you must specify the base addresses of all boards. In this case, ignore the message that the base address you requested causes a conflict with mc1.

7. Remember the order in which you select the addresses, so you know what device number each board is given.

8. When you have selected the addresses of all of your boards, enter 0.

9. Now follow steps 2 through 3 in Section 3.5, Installing Under UnixWare 2.1 to rebuild the kernel and reboot the system.

1. Access a command prompt, and log in as root.

2. Direct the pkgrm utility to remove the "mc1" package. To do so, enter:

   pkgrm mc1
   

3. pkgrm displays the following:

      The following package is currently installed:
      mc1  MC1 Interface for UnixWare 2.1
        (i386) 1.5
      Do you want to remove this package [yes,no?,quit]
   

4. Enter "y".

      Removing installed package instance <mc1>
      Verifying package dependencies
      Executing preremove script.
      Removing MC1 Driver
   
      Rebuild the kernel now? (y/n)
   

5. Enter "y".

      Removal of <mc1> was successful.
   

6. Now shut down your system and reboot.