• Windows NT 4.0

• UnixWare 2.x

• Solaris x86

• If you are running a version of SS7 2.0x or earlier, refer to Section 3.2.1 for instructions on configuring your software.

• If you are running a version of SS7 2.1x or later, refer to Section 3.2.2 for instructions on configuring your software.

  
  3.2.1	 Configuring the Software (SS7 2.0x or Earlier)
  
  

1. Run the CP Configuration program (cpcfg), located in the \tektx\soft\util\ directory. 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.

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

3. Click Select.
   The following configuration options are available:
   Hardware

Buffer

About Memory

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 2 through 4.

2. Click Exit when finished.

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

   
   3.2.2	 Configuring the Software (SS7 2.1x or Later)
   
   

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

5. Click the Start button, point to Settings, and click Control Panel.
   
6. Click NMS TX CPs (shown in step 1). The Configure/Install/Remove TX dialog box appears.
   A list of currently installed TX CPs is displayed.
   The Help button also appears in this dialog box. If at any time you have questions about the configurable fields and their respective values, return to this window and click the Help button. The help dialog box appears.
   Select the type of driver you would like help with and an index of help topics will appear.

7. If you are configuring a TX CP that has already been installed, highlight the TX CP to be configured in the Currently Installed TX Communications Processors window and click Configure Selected CP. Skip ahead to step 7.
   If no TX CPs are currently installed, or you have additional TX CPs to install, click Install TX ISA. The New CP Type & Number dialog box appears.
   
8. Select the option button that best describes the TX CP you are installing and click OK. The Select a CP Number to Assign dialog box appears.
   
9. Highlight the CP number with which you want the TX CP to be associated and click OK.

10. The NMS TXn000 Configuration dialog box appears.
    The General tab is automatically selected. The Display Name field is the text name that is used to identify the highlighted board in the Configure/Install/Remove TX dialog box.

11. Click the Hardware tab.
    The following fields are user-defined:

    Field	Description
    Hardware Interrupt Request (IRQ)	This value must match the IRQ setting on the TX board you are installing/configuring. For more information on setting the IRQ on the TX boards, see Section 2.2.2.
    Board Type	The type of TX board being installed/configured.
    Base Address	This value must match the memory address setting on the TX board you are installing/configuring. For more information on setting the base memory address on the TX boards, see Section 2.2.1.
    Other CP Resources	This window displays other TX CPs that are already installed and cannot be edited.

12. Click the Buffers tab.
    

    WARNING:

    The TX driver pre-allocates buffers for communication with each board at OS startup. To avoid any allocation errors, it is recommended that you not change these settings.

    The following fields are user-definable:

    Field	Description
    Maximum CP Channels	Sets the maximum number of channels available to the TX CP. Valid range is 16 to 256.
    DEFAULT Buffering Count	Sets the number of pre-allocated buffers. Valid range is 1 to 999.
    DEFAULT Buffering Size	Sets the size of pre-allocated buffers. Valid range is 7 to 2000 bytes.
    New Definition Channel	The specific channel whose global buffering settings you wish to override.
    New Definition Count	Sets the number of buffers for the specific channel indicated.
    New Definition Size	Sets the size of the buffers for the specific channel indicated.

    The Currently Defined window lists all of the channels for which the global buffering settings have been overridden, as well as the new settings.
    To define specific settings for an individual channel, enter the channel, count, and size data and click Define. The new buffer settings for the specified channel will appear in the Currently Defined window on the left.
    To remove the new buffer settings, highlight the channel number you want to remove from the Currently Defined window and click Remove Definition.
    To edit the buffer settings for an existing channel, highlight the channel number you want to edit from the Currently Defined window and click Cut/Update Definition. The channel will be deleted from the Currently Defined window and pasted in the New Definition fields. When you have made the necessary changes, click Define. The specified channel will now appear in the Currently Defined window, but with the new buffer settings.

13. For information on the Statistics tab, see Section 4.3, Viewing the Statistics for the TX 2000/TX 3000 Boards.

14. When every field has been defined, click OK. This will close the NMS TXn000 Configuration window and return you to the Configure/Install/Remove TX dialog box. If you have additional TX boards to install/configure, return to step 4. When every board has been installed and configured, click Exit.

15. You must restart your computer at this time in order to allow the configuration changes to take effect.

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

2. The TX configuration utility (txninst) is located in the /usr/bin/ directory. Type txninst.

3. The following prompt will appear:

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

   This value must match the IRQ setting on the TX board you are installing/configuring. For more information on setting the IRQ on the TX boards, see Section 2.2.2.

4. The memory address prompt appears:

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

   This value must match the memory address setting on the TX board you are installing/configuring. For more information on setting the base memory address on the TX boards, see Section 2.2.1.

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

6. The shared IRQ prompt appears:

      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.
7. You will now be prompted:

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

   If you have additional TX 2000/TX 3000 boards to install/configure, type y and you will be prompted for the information described in steps 3 to 6.
   When every board has been installed and configured, type n to continue.

8. The following prompt appears:

      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 now reboot the system for the configuration changes to take effect.

• If you are running a version of SS7 2.0x or earlier, refer to Section 3.4.1 for instructions on configuring your software.

• If you are running a version of SS7 2.1x or later, refer to Section 3.4.2 for instructions on configuring your software.

  
  3.4.1	 Configuring the Software (SS7 2.0x or Earlier)
  
  

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

2. The TX configuration utility (txninst) is located in the /usr/bin/ directory. Type txninst.

3. The following prompt appears:

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

   Type r to remove the existing board configurations. You will add back the configuration information for existing boards in a moment.

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

      txninst
   
   

5. When the add/remove board prompt appears, type a to add the new configuration settings.

6. The following prompt will appear:

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

   This value must match the IRQ setting on the TX board you are installing/configuring. For more information on setting the IRQ on the TX boards, see Section 2.2.2.

7. The memory address prompt appears:

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

   This value must match the memory address setting on the TX board you are installing/configuring. For more information on setting the base memory address on the TX boards, see Section 2.2.1.

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

9. The shared IRQ prompt appears:

      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.
10. You will now be prompted:

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

    If you have additional TX 2000/TX 3000 boards to install/configure, type y and you will be prompted for the information described in steps 3 to 6.
    When every board has been installed and configured, type n to exit.

11. You must now reboot the system for the configuration changes to take effect.

    
    3.4.2	 Configuring the Software (SS7 2.1x or Later)
    
    

Note: The ISA driver automatically numbers its boards sequentially, starting at 0. If you have a system that includes both PCI and ISA boards, the PCI boards must use CPIDs starting at 1 plus the highest CPID used by the ISA boards. Furthermore, adding an ISA board assigns a CPID of 1 plus the highest ISA board, NOT the highest CPID overall. This may cause a CPID conflict if a PCI board is already assigned to this CPID. If a PCI board is already assigned to this CPID, nmshwcfg will not allow the ISA board to be added.

1. Login as root.

2. Run the nmshwcfg utility, located in the /usr/bin/ directory. The following prompt will appear:

   
    Natural MicroSystems, Inc
   
   
    Tx Hardware Configuration Utility
   
   
    =================================
   
   
     
   
   
        CPID    Board Type
   
   
        ----    ----------
   
   
        1.      Tx2000
   
   
        2.      Tx3000
   
   
     
   
   
      Valid Commands:
   
   
        [A]dd an ISA Board
   
   
        [C]onfigure a Board
   
   
        [D]elete a Board
   
   
        Co[n]fig PCI Driver
   
   
        [E]xit & Accept Changes
   
   
        [Q]uit & Discard Changes
   
   
      Command:
   
   
    
   
   

3. Type A to select the Add an ISA Board command.

4. You are now prompted to enter the configuration information for the new board:

   
       Enter Board Type [2000 or 3000]:
   
   
    
   
   

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

5. The following prompt appears:

   
              Enter IRQ:
   
   
    
   
   

   This value must match the IRQ setting on the TX board you are installing/configuring. For more information on setting the IRQ on the TX boards, see Section 2.2.2.

6. The memory address prompt appears:

   
       Enter IO Addr:
   
   
    
   
   

   This value must match the memory address setting on the TX board you are installing/configuring. For more information on setting the base memory address on the TX boards, see Section 2.2.1.

7. The shared IRQ prompt appears:

   
       Enable IRQ Sharing?
   
   
    
   
   

   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.
8. You will now be prompted to accept or decline the changes you made. Type y to accept or n to decline them.

9. If you have additional TX 2000/TX 3000 boards to add, repeat steps 3 through 8.

10. If you would like to change the configuration settings of any TX ISA boards, type C at the nmshwcfg prompt.

11. You will be prompted for the board number. If you enter a valid CPID, you will be prompted for the configuration appropriate to board you selected. See steps 3 through 8 for instructions on entering specific TX ISA board information.

12. If you want to delete a TX ISA board, type D at the nmshwcfg prompt.

13. You will be prompted for the board number. If you enter a valid board number, the configuration of the board you selected will be displayed.

    
    Note:	 If you are deleting an ISA board, the CPIDs of the ISA boards whose CPIDs are greater than the board you are deleting will automatically shift down by one. Therefore, if you have ISA boards 1 & 2, and you delete board 1, board 2 will become board 1 when the driver is reloaded or at boot.
    
    
     Enter board number to delete: 1
    
    
     Configuration for CP1:
    
    
        Board Type: Tx2000
    
    
        IRQ: 5
    
    
        IO Addr: 0xd4000
    
    
        IRQ Sharing Enabled: No
    
    
     WARNING:  The ISA driver numbers the boards sequentially.
    
    
               Deleting this board will cause the CPIDs of
    
    
               ISA boards greater than 1 to shift down by 1.
    
    
     Do you really want to Delete this board?
    
    
     
    
    

    Type y at the prompt to delete the selected TX ISA board.

14. Once you are satisfied with the configuration, type E to issue the Exit & Accept Changes command.

15. The following prompt will appear:

    
     Configuration Files will be overwritten with new data.
    
    
     Overwrite config files? 
    
    
     
    
    

    The driver must be reloaded for the changes in the configuration to take effect. However, it may not be possible to reload the driver if any processes currently have channels open on it. In this case, the reload will fail, and the changes will not take effect until the next reboot. Should this happen, you will receive the following prompt:

    
     The ISA driver must be reloaded for the new configuration to take effect.
    
    
     However, if any processes currently have the driver open, the reload will fail.
    
    
     In that case, the changes will take effect at the next reboot.
    
    
     Reload the ISA driver?
    
    
     
    
    

    Type Y to reload the ISA driver.