3.4 Installing Under SCO UNIX SVR3.2 OpenServer Releases 3.0 and 5

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.4.2, Uninstalling the MC1 Development Kit Version 1.5 to learn how to remove software from your system.

3. If you plan to install SwitchPath, do so now before installing the MC1 software.

4. To learn how to install SwitchPath, see your SwitchPath documentation.

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

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

7. Invoke the pkgadd utility by entering a command of the form:

     pkgadd -d devicename
   

8. ...where devicename is the name of the floppy disk drive from which you are installing. For example:

     pkgadd -d /dev/rdsk/f03h
   

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

10. Select the "mc1" package, and press Enter.

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

12. 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 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:
    

13. Enter "c".

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

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

16. To select an address, type its number. The menu reappears with the address marked.

17. 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.

18. 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.

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

20. pkgadd displays this message:

    Rebuild the kernel with the MC1 Board device driver now? (y/n)
    

21. Enter "y".

22. pkgadd prepares to rebuild the kernel. It displays this message:

    Do you want this kernel to boot by default? (y/n)
    

23. Enter "y".

24. pkgadd causes the kernel to be rebuilt.

25. When pkgadd has finished rebuilding the kernel, it displays this message:

    Do you want the kernel environment rebuilt? (y/n)
    

26. Enter "y".

27. pkgadd sets up the new kernel environment.

    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.

28. Include the directory /opt/nms/bin in your path.

29. Reboot your system so that your changes will take effect.

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:

4. The following message appears:

   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:
   

5. Enter "c".

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

7. 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.

8. Remember the order in which you select the addresses, so you know what device number each board is given. Ignore any warnings of address conflicts with MC1.

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

10. Now follow steps 2 through 3 in section 3.4 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 MC1 package information and displays the following:

      Do you want to remove this package (y,n?,q)
   

4. Enter "y".

5. The following message appears:

   Rebuild the kernel now? (y/n)
   

6. Enter "y".

7. The kernel is rebuilt and the following message is displayed:

   Do you want this kernel to boot by default? (y/n)
   

8. Enter "y".

9. When the kernel build has finished, the following message is displayed:

   Do you want the kernel environment rebuilt? (y/n)
   

10. Enter "y".

11. Shut down your system and reboot.

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

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

   removepkg mc1
   

3. removepkg removes the package, and terminates.

4. Now update the kernel configuration data with idinstall. To do so, enter:

   /etc/conf/bin/idinstall -d mc1
   

5. idinstall removes mc1 from the kernel configuration data.

6. Rebuild the kernel. To do so, enter:

   /etc/conf/bin/idbuild
   

7. idbuild prepares to rebuild the kernel. It displays this message:

   Do you want this kernel to boot by default? (y/n)
   

8. Enter "y".

9. idbuild causes the kernel to be rebuilt.

10. When idbuild has finished rebuilding the kernel, it displays this message:

    Do you want the kernel environment rebuilt? (y/n)
    

11. Enter "y".

12. idbuild sets up the new kernel environment.

13. Remove old MC1 files by entering:

       rm -r /opt/nms/mc1
       rmdir /opt/nms/mc1
    

14. Shut down your system and reboot.