(Page 1 of 1 in this chapter)

Chapter 3

Installing the Software

3.1 Introduction 16

3.2 Installing Under Windows NT 17

3.2.1 Changing the Configuration After Installation (NT)

3.2.2 Uninstalling the Driver Software (NT)

3.3 Installing Under OS/2 Warp 20

3.3.1 Installing swdaemon.exe

3.3.2 Changing the Driver Configuration After Installation (OS/2)

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

3.4.1 Changing the Driver Configuration After Installation (SCO)

3.4.2 Uninstalling the MC1 Development Kit Version 1.5

3.4.3 Uninstalling Early Versions of the MC1 Development Kit

3.5 Installing Under UnixWare 2.1 31

3.5.1 Changing the Configuration After Installation (UnixWare)

3.5.2 Uninstalling the MC1 Driver Software (UnixWare)

3.1 Introduction

This chapter provides instructions for installing the MC1 board software under the following operating systems: Windows NT 3.51 or later OS/2 Warp 3.0 and 4.0 SCO UNIX SVR3.2 OpenServer Release 3.0 and 5 UnixWare 2.1
To install the software, follow the procedure for your operating system.
Before you begin, make sure you have installed your MC1 boards as described in Chapter 2. The installation program will ask you for the base I/O address(es) of the MC1 board(s) you have installed.
The number of MC1 boards physically installed in the PC must be the same as the number of MC1 boards specified when installing the MC1 driver. During installation if a second board is specified which is not in the PC chassis, the first board will not be able to make connections from the MC1 bus to the MVIP bus.
Note: Some MC1 files are located in different locations than in previous releases of the MC1 development kit. The list of installed files and their locations are located in the file: - NT: nms\mc1\doc\files.txt - OS/2: nms\mc1\doc\files.mc1 - UNIX: opt/nms/mc1/doc/files.mc1 Refer to the readme file for additional information: - NT: nms\mc1\doc\readme.txt - OS/2: nms\mc1\doc\readme.mc1 - UNIX: opt/nms/mc1/doc/readme.mc1

3.2 Installing Under Windows NT

Note: Before installing MC1, ensure that any earlier installation has been removed by the procedure discussed in Section 3.2.2, Uninstalling the Driver Software (NT).

To install the MC1 driver under Windows NT:
1. If you plan to install SwitchPath, do so before installing the MC1 driver software. To learn how to install SwitchPath, see the SwitchPath documentation.
2. Log on as a member of the Administrators group.
3. Insert the MC1 installation disk into a floppy disk drive (typically the A: drive).
4. Bring up the Run dialog box, as follows:
- For Windows NT 4.0:
Choose Start, then select Run... .
- For Windows NT 3.51:
In the Program Manager, from the File menu, choose Run.
The Run dialog box appears.
5. Enter the following and click OK:

a:\setup The installation program starts. After displaying its welcome screen, it prompts you to choose a destination directory for the software.
6. Press Enter to choose the default path, or type a new path and press Enter.
The installation program asks you to select a destination program folder for the software icons.
7. Press Enter to choose the default folder, or type a new name and press Enter.
The installation program copies the package files into the directory you selected.
If the program detects previously installed files that are newer than the versions contained in the package, it asks you whether to install or skip the files in question. Typically, you should not overwrite newer files.
8. Follow the prompts to add an MC1 board by creating a board number and specifying the I/O address of the board.
Each of your MC1 boards should be given a unique board number. When you create your switching application using SwitchPath or the SW Utility, you will use these numbers to refer to your boards in software. Boards should be numbered starting from 0.
9. Press Done.
The MC1 Card Driver Board Installation dialog box reappears. Your board settings appear in the box.
10. Repeat the Add Board procedure for each MC1 board you have installed in your system.
11. When all of your boards are properly listed in the MC1 Card Driver Board Installation dialog box, press Next.
The installation program finishes copying files to your system. It then prompts you to allow changes to your NT environment.
12. Answer the prompts as they appear.

3.2.1 Changing the Configuration After Installation (NT)

You may need to modify your driver configuration after you have completed the installation process. For example, you may wish to add additional boards to your system, or you may need to change the base I/O address of a board.
To change your driver configuration:
1. Start setup.exe again, as described in Steps 4 and 5 of Section Chapter 3.2.
The installation program starts, and displays its welcome screen.
2. Click on Modify Board Configuration.
3. Add, edit, or delete board entries as needed, using the Add Board, Edit Board or Delete Board buttons.
Note: Reboot your system if you are directed to do so by the installation program.

3.2.2 Uninstalling the Driver Software (NT)

To remove the driver software from your system, you can use the uninstall program installed with the software.
To use this program: 1. In the MC1 program folder in the Program Manager, double-click the Uninstall icon. The Uninstall program starts up. 2. Follow the prompts as they appear. The program removes the driver software and related files from your system.

3.3 Installing Under OS/2 Warp

To install the MC1 software under OS/2 Warp, run the installation program and edit your config.sys file, as described in the following procedure. 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 plan to install SwitchPath, do so before installing the MC1 driver software. To learn how to install SwitchPath, see your SwitchPath documentation. 2. Insert the MC1 software installation disk into your floppy drive. 3. Open a system command window. 4. Make the drive containing your installation disk the default drive by entering A: or B: at the system prompt. 5. Enter: install The installation program starts up, and displays its welcome and information screens. It then prompts you for a destination drive. 6. Use the arrow keys to select the drive on which to install, and press Enter. The install program prompts you to enter the number of MC1 boards you are installing. 7. Enter the number of boards you are installing, and press Enter. The program displays a menu containing a list of base I/O addresses. 8. Use the arrow keys to highlight the address of one of your boards, and press the space bar to toggle the board selection. The default address is already selected. 9. Repeat this step until the addresses of all of your boards are highlighted. 10. When you have selected the addresses of all of your boards, press Enter. The installation program begins copying the files from the installation disk to the NMS subdirectory tree on the specified drive. If the installation program detects previously installed files that are newer than the versions contained in the package, it asks you whether to install or skip the files in question. Typically, you should not overwrite newer files. When the installation program finishes copying files, it displays a list of changes to make to your config.sys file. The list is stored in the ASCII file config.mc1 in the root directory of the drive on which the software is being installed. 11. Press Enter to exit the installation program. 12. Using a text editor, open config.mc1 and config.sys. 13. Edit your config.sys file as directed in config.mc1. 14. Exit the text editor, saving changes. 15. Reboot your system so that the new configuration takes effect.
The following is a sample config.mc1 file (for a one-board installation), with the changes to make to the config.sys file underlined. The contents of your config.mc1 file may be different.

3.3.1 Installing swdaemon.exe

Note: In OS/2, SwitchPath uses a detached daemon process to maintain its database of connections, group names, and handles even when an application using SwitchPath is not running. In order for this process to work, swdaemon.exe should start up before SwitchPath loads.

To start swdaemon.exe whenever OS/2 starts up, make sure the following line is included in your config.sys file for the 16-bit MC1 wrapper DLL: RUN=c:\nms\bin\swdaemon.exe mc1sw16
There are two wrapper DLLs provided. They are mc1sw16.dll and mc1sw32.dll. They provide a 16-bit and 32-bit interface to the driver, respectively.
Not all NMS device drivers support 32-bit data structures. This means that a system may have boards that require 16-bit data structures. It is recommended that you use the mc1sw16.dll in systems with boards that require 16-bit data structures. Note: If you are using the sw utility, you must use the 16-bit wrapper DLL.
If you are using the 32-bit MC1 wrapper DLL, include the following line: RUN=c:\nms\bin\swdaemon.exe mc1sw32 Note: If more that one driver is being used, make sure that they are all included in your config.sys file. This example uses the 16-bit MC1 wrapper DLL and the AG Conference board driver: RUN=c:\nms\bin\swdaemon.exe mc1sw16 agcfsw
For more information about swdaemon.exe, see the SwitchPath Technical Reference Manual.

3.3.2 Changing the Driver Configuration After Installation (OS/2)

You may need to modify your driver configuration after you have completed the installation process. For example, you may wish to add additional boards to your system, or you may need to change the base I/O address of a board.
To change your driver configuration: 1. Modify the device=c:\nms\mc1\sys\mc1.sys /a:addr,...,addr statement in your config.sys file to reflect your changes. The syntax of this line is shown in Section 3.3. 2. Reboot your system to make the changes effective.

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

Note: If you are installing over earlier versions of MC1 software, remove the earlier version and rebuild the kernel before you install the new software. See Section 3.4.2 to learn how to remove software from your system.

To install the MC1 board software under SCO UNIX SVR3.2 OpenServer Release 3.0 and 5, run the installation program as described in the following procedure. During the installation, any warnings and errors that occur will be logged to the file /opt/nms/mc1/drv/pkginst.log.
During installation, the directory /tmp/nms is created and destroyed. Do not use this directory. 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.
If you plan to install SwitchPath, do so now before installing the MC1 software. To learn how to install SwitchPath, see the SwitchPath documentation.
To install the MC1 software: 1. Access a command prompt, and log in as root. 2. Insert the MC1 board installation disk into your floppy disk drive. 3. Invoke the pkgadd utility by entering a command of the form: pkgadd -d devicename ...where devicename is the name of the floppy disk drive from which you are installing. For example: pkgadd -d /dev/rdsk/f03h pkgadd starts up, and displays a list of software packages available for installation. 4. Select the mc1 package, and press Enter. pkgadd copies the driver software from the disk onto your system. 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: 5. Enter c. pkgadd displays a menu of base I/O addresses. 6. Mark the addresses of the MC1 boards in your system by entering the address number. The menu reappears with the address marked. 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 sw, you will use these numbers to refer to your boards in software. For example, if you mark address 0x0640 first, and then mark address 0x2140, the board at address 0x0640 is assigned device number 0. The board at address 0x2140 is assigned device number 1. 7. When you have selected the addresses of all of your boards, enter 0. pkgadd displays this message: Rebuild the kernel with the MC1 Board device driver now? (y/n) 8. Enter y. pkgadd prepares to rebuild the kernel. It displays this message: Do you want this kernel to boot by default? (y/n) 9. Enter y. pkgadd causes the kernel to be rebuilt. 10. When pkgadd has finished rebuilding the kernel, it displays this message: Do you want the kernel environment rebuilt? (y/n) 11. Enter y. 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 installation program were marked with the installation date, not their creation dates. Later versions of the installation program preserve the creation date. This warning may appear 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. 12. Include the directory /opt/nms/bin in your path. 13. Reboot your system so that your changes will take effect.

3.4.1 Changing the Driver Configuration After Installation (SCO)

You may need to modify your MC1 board driver configuration after you have completed the installation process. For example, you may wish to add additional boards to your system, or you may need to change the base I/O address of a board.
When changing the driver, any warnings and errors that occur will be logged to the file /opt/nms/mc1/drv/pkginst.log. The directory /tmp/nms is created and destroyed. Do not use this directory.
To change your driver configuration, do the following: 1. Access a command prompt, and log in as root. 2. Execute the confdrvr shell script by entering: sh /opt/nms/mc1/drv/confdrvr confdrvr starts up. 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: 3. Enter c. confdrvr displays a menu of base I/O addresses. 4. Mark the base I/O addresses of all boards in your system, just as you did during the initial installation 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. 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. 5. When you have selected the addresses for all of your boards, enter 0. 6. Now follow steps 7 through 13 in Section 3.4 to rebuild the kernel and reboot the system.

3.4.2 Uninstalling the MC1 Development Kit Version 1.5

To remove the driver software for the MC1 Development Kit version 1.5 or later: 1. Access a command prompt, and log in as root. 2. Enter: pkgrm mc1 pkgrm displays the MC1 package information and the following prompt: Do you want to remove this package (y,n?,q) 3. Enter y. The following message appears: Rebuild the kernel now? (y/n) 4. Enter y. The kernel is rebuilt and the following message is displayed: Do you want this kernel to boot by default? (y/n) 5. Enter y. When the kernel build has finished, the following message is displayed: Do you want the kernel environment rebuilt? (y/n) 6. Enter y. 7. Shut down your system and reboot.

3.4.3 Uninstalling Early Versions of the MC1 Development Kit

To remove the MC1 Development Kit for versions prior to 1.5: 1. Access a command prompt, and log in as root. 2. Enter: removepkg mc1 removepkg removes the package, and terminates. 3. Update the kernel configuration data with idinstall by entering: /etc/conf/bin/idinstall -d mc1 idinstall removes mc1 from the kernel configuration data. 4. Rebuild the kernel by entering: /etc/conf/bin/idbuild idbuild prepares to rebuild the kernel. It displays the following message: Do you want this kernel to boot by default? (y/n) 5. Enter y. idbuild causes the kernel to be rebuilt and then displays this message: Do you want the kernel environment rebuilt? (y/n) 6. Enter y. idbuild sets up the new kernel environment. 7. Remove old MC1 files by entering: rm -rf /opt/nms/mc1 8. Shut down your system and reboot.

3.5 Installing Under UnixWare 2.1

Note: If you are installing over earlier versions of MC1 software, remove the earlier version and rebuild the kernel before you install the new software. See Section Chapter 3.5.2 to learn how to remove driver software from your system.

To install the MC1 board software under UnixWare 2.1, run the installation program as described in this procedure. 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. Access a command prompt, and log in as root. 2. Insert the MC1 board installation disk into your floppy disk drive. 3. Enter the following: pkgadd -d diskette1 pkgadd starts up, and displays a list of software packages available for installation. 4. Select the mc1 software package, and press Enter. pkgadd copies the driver software from the disk onto your system. 5. 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: 6. Enter c. pkgadd displays a menu of base I/O addresses. 7. Mark the addresses of the MC1 boards in your system by entering the address number. The menu reappears with the address marked. 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 sw, you will use these numbers to refer to your boards in software. 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. 8. When you have selected the addresses of all of your boards, enter 0. pkgadd prompts you to rebuild the kernel with the MC1 Interface Board Driver. 9. Enter y. 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 installation program were marked with the installation date, not their creation dates. Later versions of the installation program preserve the creation date. This warning may appear 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. When the kernel rebuild is complete, the following message appears: Installation of MC1 for UnixWare 2.1 (mc1) was successful. 10. Enter q to quit. 11. Shut down your system and reboot. The driver will not be available until you reboot.

3.5.1 Changing the Configuration After Installation (UnixWare)

You may need to modify your driver configuration after you have completed the install process. For example, you may wish to add additional boards to your system, or you may need to change the base I/O address of a board.
To change your driver configuration: 1. Access a command prompt, and log in as root. 2. Enter: sh /opt/nms/mc1/drv/confdrvr confdrvr starts up. 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 is listed. Enter c to continue or enter q to quit: 3. Enter c. confdrvr displays a menu of base I/O addresses. 4. Mark the base I/O addresses of all boards in your system, just as you did during the initial install procedure. 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. Remember the order in which you select the addresses, so that you know what device number each board is given. 5. When you have selected the addresses of all of your boards, enter 0. 6. Now follow steps 8 through 11 in Section 3.5 to rebuild the kernel and reboot the system.

3.5.2 Uninstalling the MC1 Driver Software (UnixWare)

To remove the MC1 driver software from your system: 1. Access a command prompt, and log in as root. 2. Enter: pkgrm mc1 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] 3. Enter y. Removing installed package instance <mc1> Verifying package dependencies Executing preremove script. Removing MC1 Driver Rebuild the kernel now? (y/n) 4. Enter y. Removal of <mc1> was successful. 5. Shut down your system and reboot.

(Page 1 of 1 in this chapter)

tech_support@nmss.com

Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.