(Page 1 of 1 in this chapter) Version

Chapter 3

Configuring the Software

3.1 Introduction

3.2 Configuring the Software Under Windows NT

: 3.2.1 Configuring the Software (SS7 2.0x or Earlier)
: 3.2.2 Configuring the Software (SS7 2.1x or Later)

3.3 Configuring the Software Under UnixWare

3.4 Configuring the Software Under Solaris (Intel and SPARC)

3.1 Introduction

This chapter lists procedures for configuring the TX software under the following operating systems: Windows NT UnixWare Solaris (Intel and SPARC)

3.2 Configuring the Software Under Windows NT

After installing the base/device driver software and TX ISA hardware, you will need to configure the software. There are two ways to configure the software, depending on the version of the software you are running:

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)

Run the CP configuration program (cpcfg), located in the \nms\tx\bin\ 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.
Highlight the first unused board number to configure. On a new installation, this is Board 1.
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.

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.

Click Exit when finished.

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)

Log on as a member of the Administrator group.
Click the Start button, point to Settings, and click Control Panel.
Click NMS TX CPs (shown in step 1). The Configure/Install/Remove TX dialog box displays a list of currently installed TX CPs.
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.
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.
Select the option button that best describes the TX CP you are installing and click OK.
Highlight the CP number with which you want the TX CP to be associated and click OK.
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.

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.

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.

For information on the Statistics tab, see Section 4.3, Viewing the Statistics for the TX 2000/TX 3000 Boards.
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.
You must restart your computer at this time in order to allow the configuration changes to take effect.

3.3 Configuring the Software Under UnixWare

This section provides instructions for configuring the TX software for UnixWare. Log on as the root user or some other user with superuser privileges. The TX configuration utility (txninst) is located in the /opt/nmstx/bin/ directory. Type: txninst. 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. 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. 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. 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. 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. You must now reboot the system for the configuration changes to take effect.

3.4 Configuring the Software Under Solaris (Intel and SPARC)

After installing the base/device driver software and TX ISA hardware, you will need to configure the software. Log on as the root user or some other user with superuser privileges. The TX configuration utility (txninst) is located in the /opt/nmstx/bin/ directory. Type: txninst. 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. At this point, the script exits and must be invoked again by typing: txninst When the add/remove board prompt appears, type a to add the new configuration settings. 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. 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. 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. 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. 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. You must now reboot the system for the configuration changes to take effect.

(Page 1 of 1 in this chapter) Version

tech_support@nmss.com