(Page 1 of 1 in this chapter)

Chapter 3

Installing the Software

3.1 Introduction
3.2 Installing Under Windows NT
3.2.1 Installing the Base/Device Driver 18
3.2.2 Defining the TX 2000/TX 3000 Board as a Windows NT Netcard 20
3.2.3 Adding New TX 2000/TX 3000 Board to Existing Installation 22
3.3 Installing Under UnixWare 2.x
3.3.1 Adding Another TX 2000/TX3000 Board to an Existing Installation 25
3.4 Installing Under Solaris x86
3.4.1 Command Line Software Installation (Solaris x86) 27
3.5 Adding Another TX 2000/TX 3000 Board to an Existing Installation

3.1 Introduction

This chapter lists procedures for installing the TX software under the following operating systems:

The TX software runs on the specified version of the operating system and any later version.

To install the software, follow the appropriate procedure for your operating system.

3.2 Installing Under Windows NT

This section provides instructions for installing the TX software on the Windows NT operating system.

Note: Before installing the TX software, ensure that any earlier installation has been removed.

3.2.1 Installing the Base/Device Driver

      1. Log on as a member of the Administrator group.

        

      2. Insert the NMS product-specific CD-ROM into the CD-ROM drive.
        

        

      3. If your CD-ROM drive supports Autorun, the CD browser runs automatically. Otherwise, launch Windows Explorer, and double-click on setup.exe.
        

        

      4. After installation initialization, click through the Welcome and Licensing Agreement.
        

        

      5. A Destination Location screen appears. It is recommended that the destination directory NOT be changed from the \tektx directory default.
        

        

      6. Click Next.
        

        

      7. The Base Software is copied to your hard drive and the TX Series Device Driver is installed on your system.
        

        

      8. The CP Configuration program (cpcfg) is executed automatically and the Select NMS Communications Processor dialog box appears. This allows you to configure the settings for the software that communicates with the TX 2000/TX 3000 board.
        

        

      9. Highlight the first unused board number to configure. On a new installation, this is Board 1.
        

        

      10. Click Select.
        

        
The following configuration options are available:
        
Hardware 
      

    


    Select the IRQ previously set on the TX 2000/TX 3000 board.
    


    Select Base Address previously set on the TX 2000/TX 3000 board.
    


    Select Board type (TX 2000 or TX 3000).
    

Buffer
    

    It is recommended that you do not change the default settings.
    

About Memory
    

    This is useful information should buffer changes be required.
    

      


    1. Click OK 
      

      
The Select NMS Communications Processor dialog box reappears, displaying the new board configuration. 
      
To configure another board, select the next unused board number and repeat steps 8-10.    
      

    2. Click Exit when finished. 
      

      

    3. You must restart your computer at this time for the changes to take effect. 
      

      
Note:  If your configuration requires defining the TX 2000/TX 3000 board as a Network Adapter Card, see Section 3.2.2 for more information on this feature.

    

    



3.2.2	 Defining the TX 2000/TX 3000 Board as a Windows NT Netcard





Follow the steps below if you wish to install the TX 2000/TX 3000 board as a TCP/IP Netcard under Windows NT. This feature allows the Host operating System's native TCP/IP stack to use the TX 2000/TX 3000 board as if it were an Ethernet card. An Ethernet/NIC Driver for NT is supplied which must be installed.


Note:  You must have the Windows NT TCP/IP network software installed before installing the TX 2000/TX 3000 board as a network adapter card. The TX Netcard driver for Windows NT supports only the TCP/IP stack, it does not support other network protocols such as Novell.

    


  1. Click the Start button, point to Settings, and click Control Panel.
    

    

  2. Double-click the Network icon. The Network dialog box appears.
    

    

  3. Click the Adapters tab.
    

    

  4. Click Add. 
    

    

  5. Click Have Disk. 
    

    

  6. Replace a:\ as the disk location with c:\tektx\soft\util.
    

    

  7. Click OK. 
    

    

  8. In the SelectOEM Option dialog box, select the processor type installed in the host computer (Ex: NMS TX Series Communications Processor).
    

    

  9. Click OK.
    

    

  10. Select the Target NMS Communications Processor on which to install the Ethernet/NIC Driver for NT.
    

    

  11. Click Select.
    

    

  12. In the Select NMS Product(s) to Install/Configure dialog box, highlight TCP/IP Local Area Network Interface. 
    

    

  13. Click OK.
    

    
In the TXn000 NCPI LAN Driver Configuration dialog box, the options describe the base TCP/IP port and message security check mechanism. The default is strongly recommended for these driver level parameters. 
    

  14. Click OK to return to the Network dialog box.
    

    

  15. Click Close. This step is essential for Windows NT's TCP/IP stack to recognize the added TX 2000/TX 3000 adapter.
    

    
Note:  Do NOT restart your computer at this time.




Binding Windows NT's TCP/IP stack to the TX 2000/TX 3000 board


    


  1. Click the Start button, point to Settings, and click Control Panel.
    

    

  2. Double-click the Network icon. The Network dialog box appears.
    

    

  3. Click the Protocols tab, and click TCP/IP Protocol.
    

    

  4. Click Properties.
    

    

  5. Click the IP Address tab.
    

    

  6. Highlight NMS TXn000 LAN Adapter from the adapter drop down list. 
    

    

  7. Add the IP address (by overwriting the 64.x.x.x default) and subnet mask for your machine's IP network. 
    

    

  8. Click OK until you can click Yes to restart your computer.
    

    
Note:  The TX 2000/TX 3000 board is not a standard Ethernet NIC card. In order for the Host TCP/IP stack to work with the TX 2000/TX 3000 board, the TX board must be downloaded and configured by the user. This is normally accomplished via APIs that are provided to the user. An example of how to do this can be found in the fusdemo sample program in the directory \tektx\samples\fusdemo. If the user wishes to have the NIC card capability available at system startup, they must write a program that can be loaded by Windows NT at system initialization.

 
    







3.2.3	 Adding New TX 2000/TX 3000 Board to Existing Installation





To install any subsequent TX 2000/TX 3000 boards to your system, follow these steps:


    


  1. From a DOS command prompt, run cpcfg.exe 
    

    

  2. Highlight the next unused board number and click Select.
    

    

  3. Select an available IRQ and Base Address for the new board. These must be different from all previously installed boards. 
    

    

  4. Click OK
    

    

  5. Click Exit
    

    

  6. Repeat steps in Section 3.2.2 if you are installing this new TX 2000/TX 3000 board as a Windows NT Netcard.
    

    

  7. Restart the computer.
    

    
 
    







3.3	 Installing Under UnixWare 2.x





This section provides instructions for installing the TX software from the command line. 


Note:  Before installing the TX software, ensure that any earlier installation has been removed.

    


  1. Log on as the root user or some other user with superuser privileges.
    

    

  2. Insert the NMS product-specific CD-ROM in the CD-ROM drive.
    

    

  3. Use App_Installer (located in the Admin_Tools directory) to install the software.
    

    

  4. The screen prompts you:
    

       Add a txn board or skip installing the driver now (a/s) :





Typing `s' will print a small instructional page and continue to install the software onto the hard disk without first configuring the driver. You can configure the driver at a later time using the txninst utility, which prompts the user in the same way that this post-install script does.



Typing `a' displays an instructional page and the additional hardware configuration prompts.


    


  1. At the prompt:
    

       Enter the IRQ value for this board [3, 4, 5, 7, 9, 10, 11, 12, 14,
   15] :





Type the interrupt setting strapped on the board.


    


  1. The next prompt is:
    

       Enter the Mem Addr for this board [80000-FE000 in increments of
   2000] :





Type the memory setting strapped on the board.


Note:	 Some of the board documents have the memory options listed as ranging between 8000H and FE00H. For example, if you set the board at E000H, you would enter E0000 at the prompt.


    


  1. After entering the memory address, the next prompt appears:
    

       Enter the type of board [2000 or 3000] :





Enter `2000' for a TX 2000 board or `3000' for a TX 3000 board.


    


  1. The next prompt is:
    

       Are you using a single IRQ for multiple boards (y/n) :





Type `y' if you have multiple boards in the system that are all set to the same IRQ value.


Note:	 Older TX 2000 boards do not support interrupt sharing. Consult Natural MicroSystems Developer Support for more details.


    


  1. The next prompt is:
    

       Do you have another txn board to install? (y/n/q) :





If you type `y', you will be prompted for the information described in steps 6, 7, and 8.



If you type `n', the script continues.


    


  1. The script will prompt you:
    

       Relink the kernel now? (y/n/q) :





You can choose to relink the kernel at this point, or you can relink later by logging on as root, making sure that /etc/conf/bin is in your path, and typing:



 idbuild -b



After the kernel is relinked, you must reboot the system to effect the configuration changes. You can either do this now, or after installing the TX product-specific software. 


Note:	 The system reboot MUST occur before an attempt is made to use the installed TX software for the first time.



At this point, the installation of the base/device driver software is complete.






3.3.1	 Adding Another TX 2000/TX3000 Board to an Existing Installation





To install subsequent TX 2000/TX 3000 boards to your system, follow the steps below. This procedure assumes that you have already installed the base/device driver software on your system.


    


  1. Make sure that you note the memory addresses and IRQ numbers for all boards (both existing and new) that will be in the system.
    

    

  2. Log in as the root user or another user with superuser privileges. At the console shell, type:
    




txninst


    


  1. The txninst utility displays the following prompt:
    

       Add a board or remove the txn driver or q to quit (a/r/q):





Type `r'. You will add back the configuration information for existing boards in a moment.


    


  1. The script will prompt you to relink the kernel. Type `n'.
    

    

  2. At this point, the script exits and must be invoked again by typing:
    




txninst


    


  1. Type `a' at the prompt.
    

    

  2. At the prompt:
    

       Enter the IRQ value for this board [3, 4, 5, 7, 9, 10, 11, 12, 14,
   15] :





Type the interrupt setting strapped on the board.


    


  1. The next prompt is:
    

       Enter the Mem Addr for this board [80000-FE000 in increments of
   2000] :





Type the memory setting strapped on the board.


Note:	 Some of the board documents have the memory options listed as ranging between 8000H and FE00H. For example, if you set the board at E000H, you would enter E0000 at the prompt.


    


  1. After entering the memory address, the next prompt appears:
    

       Enter the type of board [2000 or 3000] :





Enter `2000' for a TX 2000 board or `3000' for a TX 3000 board.


    


  1. The next prompt is:
    

       Are you using a single IRQ for multiple boards (y/n) :





Type `y' if you have multiple boards in the system that are all set to the same IRQ value.


Note:	 Older TX 2000 boards do not support interrupt sharing. Consult Natural MicroSystems Developer Support for more details.


    


  1. The next prompt is:
    

       Do you have another txn board to install? (y/n/q) :





If you type `y', you will be prompted for the information described in steps 6, 7, and 8.



If you type `n', the script continues.


    


  1. The script will prompt you:
    

       Relink the kernel now? (y/n/q) :





You can choose to relink the kernel at this point, or you can relink later by logging on as root, making sure that /etc/conf/bin is in your path, and typing:



 idbuild -b



After the kernel is relinked, you must reboot the system to effect the configuration changes. You can either do this now, or after installing the TX product-specific software. 


Note:	 The system reboot MUST occur before an attempt is made to use the installed TX software for the first time.


 






3.4	 Installing Under Solaris x86





This section provides instructions for installing the TX software for Solaris x86. 


Note:  Before installing the TX software, ensure that any earlier installation has been removed.





3.4.1	 Command Line Software Installation (Solaris x86)


        


      1. Log on as the root user or some other user with superuser privileges.
        

        

      2. Ensure that the vold utility is not running by typing:
        

      

    


    ps -e | grep vold
    

If vold is an active process, note vold's process ID from the output of the ps utility and type:
    

    kill <vold_process_id>
    

      


    1. Insert the NMS product-specific CD-ROM in the CD-ROM drive.
      

      

    2. Run the software management tool, located in the /usr/sbin/swmtool directory.
      

      

    3. The screen prompts you:
      

         Add a txn board or skip installing the driver now (a/s):


    


    Typing `s' will print a small instructional page and continue to install the software onto the hard disk without first configuring the driver. You can configure the driver at a later time using the txninst utility, which prompts the user in the same way that this post-install script does.
    


    Typing `a' displays an instructional page and the additional hardware configuration prompts.
    

      


    1. At the prompt:
      

         Enter the IRQ value for this board [3, 4, 5, 7, 9, 10, 11, 12, 14,
   15] :


    


    Type the interrupt setting strapped on the board.
    

      


    1. The next prompt is:
      

         Enter the Mem Addr for this board [80000-FE000 in increments of
   2000] :


    


    Type the memory setting strapped on the board.
    

Note:	 Some of the board documents have the memory options listed as ranging between 8000H and FE00H. For example, if you set the board at E000H, you would enter E0000 at the prompt.
    

      


    1. After entering the memory address, the next prompt appears:
      

         Enter the type of board [2000 or 3000] :


    


    Enter `2000' for a TX 2000 board or `3000' for a TX 3000 board.
    

      


    1. The next prompt is:
      

         Are you using a single IRQ for multiple boards (y/n) :


    


    Type `y' if you have multiple boards in the system that are all set to the same IRQ value.
    

Note:	 Older TX 2000 boards do not support interrupt sharing. Consult Natural MicroSystems Developer Support for more details.
    

      


    1. The next prompt is:
      

         Do you have another txn board to install? (y/n/q) :


    


    If you type `y', you will be prompted for the information described in steps 6, 7, and 8.
    


    If you type `n', the script continues.
    

 
    

      


    1. You will see the following output:
      

         ## Checking for conflicts with packages already installed.
   The following files are already installed on the system and are
   being used by another package:
   /etc <attribute change only>
   /usr <attribute change only>
   /usr/bin <attribute change only>
   /usr/include <attribute change only>
   /usr/lib <attribute change only>
   /usr/src
   Do you want to install these conflicting files [y, n, ?, q]


    


    Type `n' at this prompt. The system then prompts you:
    

        Do you want to continue with the installation of <txn> [y, n, ?]


    

    Type `y' at this prompt. The system will remind you that you must have superuser privileges. Type `y' to continue.
    

      


    1. You MUST reboot the system to effect the configuration changes. You can either do this now, or after installing the TX product-specific software. 
      

      
Note:	 The system reboot MUST occur before an attempt is made to use the installed TX software for the first time.
      

      
At this point, the installation of the base/device driver software is complete.
    

    



3.5	 Adding Another TX 2000/TX 3000 Board to an Existing Installation





To install subsequent TX 2000/TX 3000 boards to your system, follow the steps below. This procedure assumes that you have already installed the base/device driver software on your system.


    


  1. Make sure that you note the memory addresses and IRQ numbers for all boards (both existing and new) that will be in the system.
    

    

  2. Log in as the root user or another user with superuser privileges. At the console shell, type:
    




txninst


 


    


  1. The txninst utility displays the following prompt:
    

       Add a board or remove the txn driver or q to quit (a/r/q):





Type `r'. You will add back the configuration information for existing boards in a moment.


    


  1. At this point, the script exits and must be invoked again by typing:
    




txninst


    


  1. Type `a' at the prompt.
    

    

  2. At the prompt:
    

       Enter the IRQ value for this board [3, 4, 5, 7, 9, 10, 11, 12, 14,
   15] :





Type the interrupt setting strapped on the board.


    


  1. The next prompt is:
    

       Enter the Mem Addr for this board [80000-FE000 in increments of
   2000] :





Type the memory setting strapped on the board.


Note:	 Some of the board documents have the memory options listed as ranging between 8000H and FE00H. For example, if you set the board at E000H, you would enter E0000 at the prompt.


    


  1. After entering the memory address, the next prompt appears:
    

       Enter the type of board [2000 or 3000] :





Enter `2000' for a TX 2000 board or `3000' for a TX 3000 board.


    


  1. The next prompt is:
    

       Are you using a single IRQ for multiple boards (y/n) :





Type `y' if you have multiple boards in the system that are all set to the same IRQ value.


Note:	 Older TX 2000 boards do not support interrupt sharing. Consult Natural MicroSystems Developer Support for more details.


    


  1. The next prompt is:
    

       Do you have another txn board to install? (y/n/q) :





If you type `y', you will be prompted for the information described in steps 6, 7, and 8.



If you type `n', the script continues.


    


  1. The script will prompt you:
    

       Relink the kernel now? (y/n/q) :





You can choose to relink the kernel at this point, or you can relink later by logging on as root, making sure that /etc/conf/bin is in your path, and typing:



 idbuild -b



After the kernel is relinked, you must reboot the system to effect the configuration changes. You can either do this now, or after installing the TX product-specific software. The system reboot MUST occur before an attempt is made to use the installed TX software for the first time.











 
    (Page 1 of 1 in this chapter)




 




tech_support@nmss.com



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