(Page 1 of 1 in this chapter) Version

Chapter 7

Using the NMS Configurator

7.1 Introduction
7.2 Configuring Telephony Boards
7.2.1 Adding Board Configurations
7.2.2 Editing Existing Board Configurations
7.2.3 Importing and Exporting Configuration Information
7.2.4 Removing Board Configuration Entries
7.3 Configuring Advanced System-Level Settings
7.3.1 Specifying Configuration File Names and Locations
7.3.2 Configuring CT Access Tracing
7.3.3 Setting Available CT Access Services
7.3.4 Setting CT Access Parameters
7.3.5 Specifying COMMON Hardware Settings
7.3.6 Testing the Configuration
7.3.7 Configuring the CT Access Server
7.3.8 Configuring SNMP

7.1 Introduction

This chapter describes the NMS Configurator tool provided with CT Access. The NMS Configurator is a Windows NT Control Panel applet that enables you to specify global and board-level configuration settings for telephony boards on your system. Settings specified through the NMS Configurator are written to a configuration file (ag.cfg, qx.cfg, or cta.cfg) and saved in the Windows NT registry.

Later, when you run agmon, these settings are implemented for the specified boards.

Note: Before you start the demonstration programs, ensure that CT Access is properly installed. Additional Information

Refer to the appropriate sections of this manual for more information about:

Refer to the CT Access Developer's Reference Manual for more information about:

7.2 Configuring Telephony Boards

The configurator provides a user interface for configuring telephony boards and specifying settings in specific NMS configuration files. The NMS Configurator enables you to perform the following tasks:

  • Set the clock master for your system. 

    

  • Specify the order in which the telephony boards are booted.

    

    

  • Specify whether configuration information is saved to a file that can be used 
on another machine, or imported from a file created on another machine. 

    

    

  • Set Advanced System-Level configuration information such as:

    

      

    • COMMON settings in the board configuration files

      

      

    • CT Access tracing levels

      

      

    • CT Access services that will be used by applications

      

      

    • CT Access service parameters

      

      

    • File names and locations for the configuration files

      

      

    • SNMP information (when applicable)

      

      

    • Whether applications run in Library or Server mode

      

      

      The Configurator also allows you to test the board configurations that you set.
      

Note:  After using the NMS Configurator, you need to run agmon in order for the configuration settings to take effect.


      To run the NMS Configurator:
      

        


      1. From the Windows NT Start menu, select Settings, then Control Panel.
        

        
The Windows NT Control Panel appears.
        

      2. Double click on the NMS Configurator icon.
        

        
The NMS Configurator main window appears.
        

      3. From the Country list, specify the country where the system is running.
        

      

      • 

      

      7.2.1	 Adding Board Configurations
      

      


      To specify a system telephony board configuration:
      

        


      1. From the NMS Configurator main window, click Add Board. 
        

        
The Board Type dialog box appears.
        

      2. Specify a name for the board (this text string will appear in the Installed Boards list in the NMS Configurator main window):
        

        

      3. Specify a name for the board and select the type of board from the Board Type list. 
        

        

      4. The Board Type dialog box changes depending on the board type you select. Provide the following information: 

        


        
 Board type
        

        		
 Provide the following...
        


        
 E1 or T1
        

        		
 Clock Source: Select the board's clock source.
        

 Line code: Select a trunk line coding algorithm for the board. 
        

 Extended Super Frame: Check to support this transmission format.
        


        
 AG 2000 or QX 2000
        

        		
 Select Impedance: Select the board's line impedance level 
        


        
 AG Resource Board
        

        		
 Line Interface: Select the line interface board to which the resource board connects.
        



        


        

        

        

        

        

      5. From the Protocol list, select the call control protocol (for example, Digital/analog wink start, or Feature Group D) used on the board, and click Next. 
        

        
The Board Address dialog box appears. This dialog box displays different fields depending whether the board uses an ISA or PCI bus.
        

      6. Specify the following Board Address information (depending on the type of bus), then click Next: 

        


        
 Bus
        

        		
 Information
        


        
 PCI
        

        		
 Select the board from the list in the Boards Available area. This automatically sets the board's Bus and Slot number. You can also set the board's PCI bus number and PCI slot number manually by entering information in the Bus and Slot fields.
        

 To test the selection by flashing the board's LED lights, click 
        Flash LEDs.
        


        
 ISA
        

        		
1.	 Select the board's ISA address from the Address list, or click Change to set the address by individually specifying ISA jumper settings.
        

2.	 Select the board's ISA interrupt number from the Interrupt list (this effects all ISA boards)
        



        


        

        

        

        

        
The Board Functions dialog box appears.
        

      7. Specify the following Board Functions information:
        

          

        

      8. From the Voice Codec area, click checkboxes to indicate the play and record codecs you will use on the board.
        

        

      9. Check the Fax Enabled checkbox if you will support fax on the board. 
        

      


    • If you are configuring an AG Resource board, click Next and proceed to Step 7. Otherwise, click Finish and proceed to Step 8.
      

      

    • If you are configuring an AG Resource Board, the Streams Nail-up dialog box appears. 
      

      
Set the stream and slot mapping for the board by entering stream and timeslot numbers in the Stream, From Slot, and To Slot fields. Click Add to add each set of mappings to the appropriate list. Then click Finish when finished adding stream/timeslot settings.
      
When you click Finish, the NMS Configurator main window appears. The new board appears in the Installed Boards list.
      

    • To select the CT bus master for all telephony boards on the system, select a board from the Installed Boards list, and click Set Master (clicking Reset Master deselects the board). An M icon appears next to the board chosen as the telephony board bus master.
      

      
Note:  When you select a telephony board as bus master, the Enable CT Bus checkbox is automatically checked. If you de-select the board, this checkbox remains checked. Therefore, if you disable the 
      CT Bus, you must manually uncheck the Enable CT Bus checkbox.
      

    • Repeat steps 1 through 8 for each new board.
      

      

    • Click Move Up or Move Down to change a selected board's position in the Installed Boards list. Installed boards are booted in the order in which they appear - the top entry in the list is booted first, and so on.
      

      
Note:  The bus master must be the first board that agmon boots, and should be the top entry in the Installed Boards list (unless you specify parallel booting when running agmon).


    • To specify global configuration settings for your system, click Advanced.   The Advanced System-Level Configuration dialog box appears. For information about setting advanced system-level configuration information, refer to Section 7.3, Configuring Advanced System-Level Settings.
      

      

    • When finished configuring boards, click OK.
      

      

      • 

      

      7.2.2	 Editing Existing Board Configurations
      

      


      To change a board's NMS Configurator entry:
      

        


      1. Select the board in the Installed Boards list of the NMS Configurator main Window.
        

        

      2. Click Configure Board.
        

        
The Configure Board dialog box appears. 
        

      3. Click on the following tabs to edit existing configuration information (these tabs correspond to the dialog boxes used to configure new boards): 

        


        
 Click this tab...
        

        		
 To configure...
        


        
 Board Type
        

        		
 Board type, protocol name, clock source, and line code.
        


        
 Board Address
        

        		
 ISA (address and interrupt) or PCI (bus and slot) address information.
        


        
 Board Functions
        

        		
 Voice codecs used on the board, and whether the board will be used for Fax transmission.
        



        


        

        

        

        

        
Note:  Refer to Section 7.2.1 for more information about using these dialog boxes.


      4. To set configuration file entries not configurable through any other 
        NMS Configurator dialog boxes, click the Configuration Lines tab.
        

        
The Configuration Lines dialog box appears.
        

      5. Select an entry from the Select keywords... list.
        

        
A short description of the selected keyword appears in the area below the Select keywords... list.
        

      6. Specify a value for the selected keyword (for example, by entering =AMI_ZCS for the LineCode entry). Then click Add.
        

        
The edited keyword statement appears in the text box at the top of the dialog box. You can also edit entries within this box. 
        

      7. When finished adding lines to the AG configuration file for the selected board, click OK.
        

        
The NMS Configurator main window appears.
        

      8. Click OK to save the edited settings.
        

      


      For information about valid AG Runtime configuration file statements, refer to Chapter 3.
      

      

      

      7.2.3	 Importing and Exporting Configuration Information
      

      


      Board and systems settings specified with the NMS Configurator are stored in the Windows NT registry. You can export this information to a file or import another configuration file into the Windows NT registry.
      

      

      

      7.2.4	 Removing Board Configuration Entries
      

      


      To remove existing telephony board configuration entries:
      

        


      1. From the Configurator main window, select a board entry from the Installed Boards list.
        

        

      2. Click Remove Board to delete a selected entry from the Installed Boards list, or Remove All to delete all entries in the list.
        

        

      3. Click OK when the NMS Configurator asks you to verify that you want to delete the items.
        

      

      

      

      7.3	 Configuring Advanced System-Level Settings 
      

      


      With the NMS Configurator you can set advanced system level configuration settings such as:
      

      

      You can also test an existing configuration, by running agmon or qxload.
      


      To configure advanced system-level configuration information, open the 
      NMS Configurator, select an entry from the Installed boards list, and click Advanced.
      


      The Advanced System-Level Configuration dialog box appears. This dialog box provides a set of tab dialog boxes that enable you to modify system-level configuration information: 

      


      
 Use this tab...
      

      		
 To...
      


      
 File Names
      

      		
 Specify names and locations for NMS configuration files.
      


      
 CT Access Tracing 
      

      		
 Enable, disable, and set levels for CT Access tracing.
      


      
 CT Access Services
      

      		
 Specify the CT Access services that will be used on the system and test the services with ctavers.
      


      
 Parameters
      

      		
 Set global parameters for CT Access services.
      


      
 AG Common Lines
      

      		
 Specify global configuration information for all AG boards on the system (in the COMMON section of the ag.cfg file).
      


      
 QX Common Lines
      

      		
 Specify global configuration information for all QX boards on the system (in the COMMON section of the qx.cfg file).
      


      
 Test Configuration
      

      		
 Test the existing configuration by running agmon or qxload.
      


      
 Client Server
      

      		
 Enable, disable, and set tracing and parameters for the CT Access Server.
      


      
 SNMP
      

      		
 Specify chassis type and description for SNMP.
      



      


      

      

      

      

Note:  Settings configured in the Advanced System-Level Configuration dialog box do not take effect until you run agmon. 


      The following sections describe these dialog boxes in detail.
      

      

      

      7.3.1	 Specifying Configuration File Names and Locations
      

      


      NMS hardware and CT Access software use configuration files to specify system settings when the hardware and software are initialized. 
      


      To specify the name and location of NMS configuration files:
      

        


      1. From the Advanced System-Level Configuration dialog box, click the 
        File Names tab.
        

        
The File Names dialog box appears.
        

      2. Enter default configuration file names and locations in the following fields: 

        


        
 In this field...
        

        		
 Enter...
        


        
 AG Hardware Configuration File
        

        		
 The pathname of a file that specifies default global hardware settings for AG telephony boards.
        


        
 CT Daemon Configuration file
        

        		
 The pathname of a file that specifies default global settings for CT Access software.
        


        
 QX Hardware Configuration File
        

        		
 The pathname of a file that specifies default global hardware settings for QX telephony boards.
        



        


        

        

        

        

        
Note:  The location of the SNMP configuration file is shown but cannot be edited because the SNMP agent runs as a Windows NT service.

      


      The default locations of these files are specified by the agload environment variable set during CT Access installation. 

      


      
 For information about...
      

      		
 Refer to...
      


      
 AG hardware configuration files
      

 (ag.cfg)
      

      		
 Chapter 7 (this manual).
      


      
 CT Daemon configuration files
      (cta.cfg)
      

      		
 CT Access Developer's Reference Manual
      


      
 QX hardware configuration files
      

 (qx.cfg)
      

      		
 QX 2000 Installation and Developer's Manual
      


      
 Setting the agload environment variable
      

      		
 CT Access Installation Manual
      



      


      

      

      

      

      

      

      7.3.2	 Configuring CT Access Tracing
      

      


      CT Access tracing provides a method of monitoring specific information about how CT applications run. 
      


      To configure the CT Access tracing configuration:
      

        


      1. From the Advanced System-Level Configuration dialog box, click the 
        CT Access Tracing tab.
        

        
The CT Access Tracing dialog box appears.
        

      2. To enable the CT Access Web Server, check the Start Web Server checkbox and specify an HTTP port.
        

        

      3. Start the CT Access Trace Server by clicking the Start Trace Server checkbox, and providing the following information: 

        


        
 In this field...
        

        		
 Enter...
        


        
 Trace Mask
        

        		
 Default tracing mask
        


        
 Trace Port
        

        		
 TCP port on which trace-server should listen.
        


        
 Max Trace Controllers
        

        		
 Number of clients allowed to set tracemask.
        


        
 Max Trace Monitors
        

        		
 Number of clients allowed to monitor trace messages.
        


        
 Trace Log File name
        

        		
 The pathname of a log file to receive trace information.
        



        


        

        

        

        

      


      For more information about CT Access tracing, refer to the CT Access Developer's Reference Manual.
      

      

      

      7.3.3	 Setting Available CT Access Services
      

      


      The CT Access configuration file (cta.cfg) specifies the names of services that are loaded when the CT Access software environment is initialized. Applications can only use services specified in the Services section of this file. You can use the NMS Configurator to choose the services that appear in the cta.cfg file.
      


      To specify the CT Access services that will be available for applications:
      

        


      1. From the Advanced System-Level Configuration dialog box, click the 
        CT Access Services tab.
        

        
The CT Access Services dialog box appears.
        

      2. To set available services, select one or more entries from the Available Services box, and click the right arrow button. 
        

        
Selected entries appear in the Selected Services box. 
        
Note:  The ADI (or QDI, depending on board type), SWI, and VCE services are automatically initialized. These services do not appear in the Available Services or Selected Services lists, but do not need to be selected. 


      3. To add a new (user-defined) service to the list of selected services:
        

          

        

      4. In the Service Name field, enter the three character abbreviation for the user-defined service name.
        

        

      5. In the Service Manager field, enter the three character abbreviation for the CT Access service manager associated with the user-defined service (this may be a user-defined service manager).
        

        

      6. In the Description field, enter the descriptive text that you want to appear in the Available Services box.
        

        

      7. Click Add.
        

        
The new service description appears in the Available Services box. 
        

      8. Select the new service entry in the Available Services box, and click the right arrow button. 
        

        
The new service appears in the Selected Services box. 
      


    • To test the specified services by running ctavers, click Test.
      

      

      

      To remove a CT Access service, select the service in the Selected Services list, and click the left arrow. The selected service moves to the Available Services list.
      


      For information about the cta.cfg file and setting CT Access parameters, refer to the CT Access Developer's Reference Manual.
      


      

      • 

      

      7.3.4	 Setting CT Access Parameters
      

      


      The CT Access configuration file (cta.cfg) specifies parameters for services that run in the CT Access software environment. These parameters act as default global settings whenever these services are opened by CT Access applications (although applications can change the parameters for specific service instances). 
      


      To specify default parameters for available CT Access services:
      

        


      1. From the Advanced System-Level Configuration dialog box, click the 
        Parameters tab.
        

        
The Parameters dialog box appears. The box in the center of the dialog box shows a tree of available CT Access parameters for any activated (or default) CT Access services. 
        

      2. Click on the + squares to view a list of parameters in a particular category (for example, COLLECT). Click on - squares to collapse a list of parameters.
        

        

      3. Double-click a specific parameter within a selected category.
        

        
The Change Parameters dialog box appears. The default setting for the selected parameter appears in the displayed box.
        

      4. Edit the value assigned for the selected parameter and click OK.
        

        
The Parameters dialog box appears. The new value appears next to the selected parameter (changed entries appear in blue text).
        

      5. Repeat Steps 3 and 4 for each parameter you want to edit.
        

      


      For information about the cta.cfg file and setting CT Access parameters, refer to the CT Access Developer's Reference Manual.
      

      

      

      7.3.5	 Specifying COMMON Hardware Settings 
      

      


      The COMMON section in AG and QX configuration files (ag.cfg and qx.cfg) specifies global settings for all boards initialized on the system. You can use the NMS Configurator to specify settings that appear into the COMMON section of the these files.
      


      To specify COMMON section entries in AG and QX board configuration files:
      

        


      1. From the Advanced System-Level Configuration dialog box, click the 
        AG Common Lines or QX Common lines tab.
        

        
The AG Common Lines (shown) or QX Common lines dialog box appears.
        

      2. Select a specific entry from the Select keywords... list.
        

        
A short description of the selected keyword appears in the area below the Select keywords... list.
        

      3. Specify settings for the selected keyword (for example, adding = MU-LAW or = A-LAW for the IdleCode entry), then click Add.
        

        
The edited keyword statement appears in the text box at the top of the dialog box. You can also edit entries within this box.  

        


        
 For information about...
        

        		
 Refer to...
        


        
 Valid configuration file statements
        

        		
 Chapter 3 (this manual)
        


        
 AG configuration file COMMON section
        

        		
 Chapter 2 (this manual)
        


        
 QX configuration file COMMON section
        

        		
 QX 2000 Installation and Developer's Manual
        



        


        

        

        

      

      

      

      7.3.6	 Testing the Configuration
      

      


      You can test the configuration you have set with the NMS Configurator through the Test Configuration dialog box. This runs either agmon or qxload (depending on your hardware) in order to see if the specified settings are valid, and displays status information about particular devices.
      


      To test the configuration information specified with the NMS Configurator:
      

        


      1. From the Advanced System-Level Configuration dialog box, click the 
        Test Configuration tab.
        

        
The Test Configuration dialog box appears.
        

      2. Click Test Configuration.
        

        
Status information about the test initialization is displayed in the status box, and the results of the initialization are displayed in the Results of Test box.
      


      For more information about running agmon, refer to Chapter 4. For more information about running qxload, refer to the QX 2000 Installation and Developer's Manual.
      

      

      

      7.3.7	 Configuring the CT Access Server
      

      


      When you run the CT Access Server, multiple applications can use CT Access service instances running on the same CT Access contexts. Entries in the cta.cfg file specify whether the CT Access Server runs, and also:
      

      

      To set CT Access Server configuration information through the NMS Configurator:
      

        


      1. From the Advanced System-Level Configuration dialog box, click the 
        Client Server tab.
        

        
The Client Server dialog box appears.
        

      2. To enable the CT Access Server, click the Use CT Access Server checkbox.
        

        

      3. Check the Allow Context Name Modification by CTA Server... checkbox if you want CT Access to modify CT Access context names so that different applications do not specify the same name (this is used as the object descriptor when sharing a context). If you do not enable this feature, applications that try to specify a context name already used by another application receive an error message.
        

        

      4. Select an entry from the Manages Global Parameters list to specify where CT Access keeps global service parameters (ctdaemon or CT Access Server).
        

        

      5.  Select an entry from the Client Server Tracing list to specify how 
        CT Access performs tracing when the CT Access Server is running.
        

      


      For more information about the CT Access Server, ctdaemon, and tracing, refer to the CT Access Developer's Reference Manual.
      

      

      

      7.3.8	 Configuring SNMP
      

      


      To set SNMP configuration information through the NMS Configurator:
      

        


      1. From the Advanced System-Level Configuration dialog box, click the 
        SNMP tab.
        

        
The SNMP dialog box appears.
        

      2. From the Chassis Type list, select the host system chassis type (CompactPCI, PC motherboard, or Sun motherboard).
        

        

      3. Enter a chassis description in the Chassis Description field (by default, the system's existing network name appears in the field).
        

      


      For more information about configuring SNMP, refer to the AG SNMP Developer's Reference Manual.
      


      

      

      


      
 
    (Page 1 of 1 in this chapter)  Version
      


      
 



      
tech_support@nmss.com

      

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