|
|
This chapter provides a description of Dial-Up Frame Relay Command Line Interface (CLI), also known as the INS_CLI. It includes the following sections:
This Command Line Interface is used to view and configure the PRIs providing ISDN signalling information to the DAS Server Shelf and the DAS (INS) Daemon software running on the StrataView Plus Workstation. (Note that INS was an early name for DAS.) In other words, the Dial-Up Frame Relay Command Line Interface provides a way to link the PRIs terminated on the Cisco wide-area switch to the INS Daemon software on the StrataView Plus Workstation. This CLI also provides status information about the DAS Server Shelf and statistics for the ISDN Q.931 (layer 3) and Q.921 (layer 2) messages and frames passed between the DAS Server Shelf and the PRI.
The Dial-Up Frame Relay CLI, which is not integrated with StrataView Plus, can be accessed through a remote connection (i.e., a telnet session) or through a terminal directly connected to the DAS Server Shelf.
To access the DAS command line interface:
1 ) Log in to the DAS Server Shelf through either a telnet session or from a terminal directly connected to the DAS Server Shelf. (Chapter 6 provides instructions for connecting a terminal. You can also telnet from StrataView Plus Workstation.)
cd /opt/ins/admin
3 ) If the INS processes are not running, start them:
INS_START
4 ) Type INS_CLI at the prompt. The Dial-Up Frame Relay Command Line Interface main menu appears, as shown in the following example.
DAS (INS) CLI Main Example Menu
********************************************************************************
* cedar *
* *
* DIAL-UP FRAME RELAY COMMAND LINE INTERFACE *
* Rel. 1.4 (Fri Aug 22 15:12:34 PDT 1997). *
* *
* *
* 1 List Active PRIs. 10 Modify CDR Configuration. *
* 2 Display CDR Configuration. 11 Configure a PRI. *
* 3 List Configured PRIs. 12 Delete a PRI Configuration. *
* 4 List Configured INS Daemons. 13 Configure an INS Daemon. *
* 5 Display Current INS Daemon. 14 Delete an INS Daemon Config. *
* 6 Display INS Status. 15 Set INS Admin Status. *
* 7 Display Call Processor Stats. 16 Quit Command Line. *
* 8 Display Layer 3 Stats. *
* 9 Display Layer 2 Stats. *
* *
* Enter number of the command and hit return: *
* *
* *
* *
* *
* *
?******************************************************************************?
As shown in the example, the Dial-Up Frame Relay Command Line Interface main menu presents 16 options. Each option is indexed by a number. You select one of the options by typing its number and pressing Enter. For instance, to display the list of active PRIs, you would type 1 and press Enter. (Throughout the rest of this book, the Dial-Up Frame Relay Command Line Interface main menu will be referred to as the INS CLI main menu.)
Options 1 through 9 select read-only Command Response screens and displays. Options 10 through 15 select configuration screens and menus. Option 16 quits The INS CLI main menu and returns you to the DAS Server Shelf's UNIX prompt.
When you display read-only screens, the following information lines appear on some screens:
When you display the Configuration screens, the following information line appears:
When using these screens to configure an option, type in the value and press Enter to move the cursor to the next field, the square brackets. When you reach the final field, make sure you have entered the desired values in each field, then type c and press Enter to save your changes. If you do not want to save the values you entered, type q and press Enter. You can re-access the configuration menu from the INS CLI main menu.
Some configuration screens will have additional information fields describing a field's parameters.
The rest of this chapter describes the read-only Command Response screens and configuration menus.
To reach any of these screens or menus, follow these steps:
Step 1 From the INS CLI main menu, enter the index number of desired option.
Step 2 Press Enter, the desired screen or menu will appear.
The List Active PRIs Command Response screen, in the following example, lists the current active PRIs.
List Active PRIs Example Screen
********************************************************************************
* cedar *
* *
* LIST ACTIVE PRIs COMMAND RESPONSE *
* ------------------------------------- *
* *
* Session # Call Processor Name DLCI # *
* *
* 1 CallProc_100 100 *
* *
* Hit any key to continue *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
This menu contains the following fields:
The Display CDR Configuration Command Response screen, shown in the example, lists the collection parameters that have been provided for Call Detail Records (CDRs). CDRs are the records of each Frame Relay Dial-Up or Dial-Backup call. A CDR contains the calling Automatic Number Identification (ANI), the called number, the start and stop times for the call, and the cause for the call being terminated.
Display CDR Configuration Command Response Screen
********************************************************************************
* cedar *
* *
* DISPLAY CDR CONFIGURATION COMMAND RESPONSE *
* ---------------------------------------- *
* *
* Cdr Interval 30. *
* *
* Cdr Backup Count 10. *
* *
* Hit any key to continue *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************
The CDR configuration parameters are:
CDR collection parameters are modified by using option 10 (Modify CDR Configuration) on the INS CLI main menu.
The following appendix, Call Detail Records, provides additional information about the format and content of CDRs.
The List Configured PRIs Command Response screen, shown in the example, presents information about the PRI associated with a particular DLCI at the DAS Server Shelf.
List Configured PRIs Screen
********************************************************************************
* cedar *
* *
* LIST CONFIGURED PRIs COMMAND RESPONSE *
* ----------------------------------------- *
* *
* Switch Type: ETSI *
* Interface Type: E1 *
* DLCI #: 100 *
* *
* --More-- *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
For each configured PRI, this menu contains the following fields:
PRIs are configured with option 11 (Configure a PRI) of the INS CLI main menu.
The List Configured INS Daemons Command Response screen, shown in the example, presents information about the INS Daemon software running on the StrataView Plus Workstation.
List Configured INS Daemon Example Screen
********************************************************************************
* cedar *
* *
* LIST CONFIGURED INS DAEMONS COMMAND RESPONSE *
* -------------------------------------- *
* *
* IP Address: 192.168.200.100 *
* Name: cypress *
* Preference: 1 *
* Administration Status: UP *
* *
* Hit any key to continue *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
This menu contains the following fields:
The INS Daemon software is configured with option 13 of the INS CLI main menu.
The Display Current INS Daemon Command Response screen, shown in the example, displays the IP Address of the StrataView Plus Workstation running the currently connected INS Daemon software.
Display Current INS Daemon Example Screen
********************************************************************************
* cedar *
* *
* DISPLAY CURRENT INS DAEMON COMMAND RESPONSE *
* ---------------------------------------- *
* *
* INS Daemon IP Address 192.168.200.100 . *
* Connection Status CONNECTED. *
* *
* Hit any key to continue *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
The Display INS Status Command Response screen, shown in the example, presents the Administration and Operational statuses of the DAS Sever Shelf.
Display INS Status Example Screen
********************************************************************************
* cedar *
* *
* DISPLAY INS STATUS COMMAND RESPONSE *
* -------------------------------- *
* *
* INS Administration Status is ON-LINE. *
* *
* INS Operational Status is ON-LINE. *
* *
* Hit any key to continue *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
This menu includes the following fields:
This option displays call processor statistics. When you select option 7, the following screen appears:
Display Call Processor Stats Example Screen
********************************************************************************
* cedar *
* *
* LIST CALL PROCESSORS STATISTICS COMMAND *
* ------------------------------------------------ *
* *
* DLCI # of the Configured PRI [ ] *
* *
* Enter 'c' to Commit Changes OR 'q' to Quit [ ] *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
Enter the DLCI of a configured PRI for which you want to see activity information. When you enter 'c' to commit, a screen similar to the following will display information about the call processing for that PRI . The Number of Call_In_Progress indicates the number of parallel calls that the Dial-Up Frame Relay application will process. Its default is 1.
Call Processor Statistics Information Example Screen
********************************************************************************
* cedar *
* *
* LIST CALL PROCESSORS STATISTICS COMMAND RESPONSE *
* ------------------------------------------------ *
* *
* Number of Call_In_Progress = 1 *
* Active Calls = 1 *
* Total Calls = 2 *
* *
* *
* End of Statistics. *
* *
* Hit any key to continue *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
The Display Layer 3 Stats option calls up the Display Layer 3 Statistics Menu, shown in the example. With this screen, you specify the DLCI of the configured PRI whose Layer 3 Statistics you want. It has a Clear Stats After [y/n] option. Selecting y (yes) for this option will clear these layer 3 statistic counters after you have viewed them.
Display Layer 8 Statistics Menu
********************************************************************************
* cedar *
* *
* LIST LAYER 3 STATISTICS COMMAND *
* ------------------------------------------------ *
* *
* DLCI # of the Configured PRI [100 ] *
* *
* Clear Stats After [y/n] [n ] *
* *
* Enter 'c' to Commit Changes OR 'q' to Quit [ ] *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
After you have specified the PRI's DLCI, and the Clear Stats After option, type c in the Commit Changes field to display the The List Layer 3 Statistics Command Response screen shown in the following example. Depending on the size of your X-window, this screen may not display all the available statistics at once. Press Enter to see the continuation of the screen.
List Layer 3 Statistics Command Response Screen
********************************************************************************
* cedar *
* *
* LIST LAYER 3 STATISTICS COMMAND RESPONSE *
* ------------------------------------------------ *
* *
* Alerting Msgs Txd = 2 Disconnect Msgs Txd = 0 *
* Call Proc Msgs Txd = 2 Release Msgs Txd = 1 *
* Connect Msgs Txd = 2 Release Complete Msgs Txd = 0 *
* Connect Ack Msgs Txd = 0 Restart Msgs Txd = 0 *
* Progress Msgs Txd = 0 Restart Ack Msgs Txd = 0 *
* Setup Msgs Txd = 0 Segment Msgs Txd = 0 *
* Setup Ack Msgs Txd = 0 Cong Control Msgs Txd = 0 *
* Resume Msgs Txd = 0 Information Msgs Txd = 0 *
* Resume Ack Msgs Txd = 0 Notify Msgs Txd = 0 *
* Resume Reject Msgs Txd = 0 Status Msgs Txd = 0 *
* Suspend Msgs Txd = 0 Status Enquiry Msgs Txd = 0 *
* Suspend Ack Msgs Txd = 0 Facility Msgs Txd = 0 *
* Suspend Reject Msgs Txd = 0 Facility Ack Msgs Txd = 0 *
* User Info Msgs Txd = 0 Facility Reject Msgs Txd = 0 *
* Hold Msgs Txd = 0 Register Msgs Txd = 0 *
* Hold Ack Msgs Txd = 0 Alerting Msgs Rxd = 0 *
* Hold Reject Msgs Txd = 0 Call Proc Msgs Rxd = 0 *
?****Retrieve Msgs Txd = 0***************Connect Msgs Rxd = 0**************?
List Layer 3 Statistics Command Response Screen Continued
********************************************************************************
* cedar *
* *
* LIST LAYER 3 STATISTICS COMMAND RESPONSE *
* ------------------------------------------------ *
* *
* Setup Msgs Rxd = 45 Segment Msgs Rxd = 0
* Setup Ack Msgs Rxd = 0 Cong Control Msgs Rxd = 0
* Resume Msgs Rxd = 49 Information Msgs Rxd = 0
* Resume Ack Msgs Rxd = 0 notify Msgs Rxd = 0
* Resume Reject Msgs Rxd = 0 Status Msgs Rxd = 0
* Suspend Msgs Rxd = 0 Status Enquiry Msgs Rxd = 0
* Suspend Ack Msgs Rxd = 0 Facility Msgs Rxd = 0
* Suspend Reject Msgs Rxd = 0 Facility Ack Msgs Rxd = 0
* user Info Msgs Rxd = 0 Facility Reject Msgs Rxd = 0
* Hold Msgs Rxd = 0 Register Msgs Rxd = 0
* Hold Ack Msgs Rxd = 0 Total Connects = 0
* Hold Reject Msgs Rxd = 0 Total Disconnects = 0
* Retrieve Msgs Rxd = 0 Average # Open Calls = 0
* Retrieve Ack Msgs Rxd = 0
* Retrieve Reject Msgs Rxd = 0
* Disconnect Msgs Rxd = 0
* Release Msgs Rxd = 0
?****Release Complete Msgs Rxd = 45
The List Layer 3 Statistics Command Response screen, shown in the example, displays counts of the various ISDN D-channel Layer 3 messages. These messages, which control the process of establishing, controlling, and terminating an ISDN call, are defined in the ISDN specification, Q.931, and recommendations I.450 and I.451.
Since there are both transmitted (Txd) and received (Rxd) messages listed, they can be useful for pointing to which end of the ISDN signalling channel is not responding.
The Display Layer 2 Stats option calls up the List Layer 2 Statistics Command Menu, shown in the example. With this screen, you specify the DLCI of the configured PRI whose Layer 2 Statistics you want. It has a Clear Stats After [y/n] option. Selecting y (yes) for this option will clear these layer 2 statistic counters after you have viewed them.
List Layer 2 Statistics Command Example Menu
********************************************************************************
* cedar *
* *
* LIST LAYER 2 STATISTICS COMMAND *
* ------------------------------------------------ *
* *
* DLCI # of the Configured PRI [100 ] *
* *
* Clear Stats After [y/n] [n ] *
* *
* Enter 'c' to Commit Changes OR 'q' to Quit [ ] *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
After you have specified the PRI's DLCI and the Clear Stats After option, type c in the Commit Changes field to display the The List Layer 2 Statistics Command Response screen:
List Layer 2 Statistics Command Response Example Screen
********************************************************************************
* cedar *
* *
* LIST LAYER 2 STATISTICS COMMAND RESPONSE *
* ------------------------------------------------ *
* *
* I Frames Xtd = 7 XID Frames Rxd = 0 *
* RR Frames Xtd = 9345 UI Frames Rxd = 0 *
* RNR Frames Xtd = 0 Invalid Frames Rxd = 0 *
* RJ Frames Xtd = 0 Sabm Errors = 0 *
* SABME Frames Xtd = 0 Frame RJ Errors = 0 *
* DISC Frames Xtd = 0 *
* UA Frames Xtd = 4 *
* DM Frames Xtd = 0 *
* Frame RJ Frames Xtd = 0 *
* XID Frames Xtd = 0 *
* UI Frames Xtd = 0 *
* I Frames Rxd = 7 *
* RR Frames Rxd = 9348 *
* RNR Frames Rxd = 0 *
* RJ Frames Rxd = 0 *
* SABME Frames Rxd = 4 *
* DISC Frames Rxd = 0 *
?****UA Frames Rxd = 0*******************************************************?
The List Layer 2 Statistics Command Response screen, shown in the example, displays counts of various ISDN D-channel layer 2 protocol frames. This link-layer protocol, specified in ISDN specification Q.921, is Link Access Protocol D (LAP-D). LAP-D is used to convey user information, i.e., the layer 3 D-channel messages between layer 3 entities, between the DAS Server Shelf and the ISDN switch providing the PRI.
There are transmitted (Xtd) and received (Rxd) frames listed which can be useful for pointing out which side of the ISDN interface is having a problem.
The Modify CDR Configuration Command menu, shown in the example, allows you to configure the collection parameters for Call Detail Records (CDRs). CDRs which are described in detail in the following appendix, Call Detail Records, are the records of each Frame Relay Dial-Up or Dial-Backup call. A CDR contains the calling Automatic Number Identification (ANI), the called number, the start and stop times for the call, and the cause for the call being terminated.
Modify CDR Configuration Menu Example
********************************************************************************
* cedar *
* *
* MODIFY CDR CONFIGURATION COMMAND *
* ------------------------------- *
* *
* CDR Interval [ ] *
* *
* # of backups allowed [ ] *
* *
* Enter 'c' to Commit Changes OR 'q' to Quit [ ] *
* *
* INFO: 30 to 1440 minutes. OPTIONAL *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
The CDR configuration parameters are:
The Configure a PRI Command menu, shown in the following example, allows you to configure the following parameters for a specific PRI:
Configure a PRI Command Menu
********************************************************************************
* cedar *
* *
* CONFIGURE A PRI COMMAND *
* ---------------------------------- *
* *
* DLCI # [ ] *
* Select one of the Variiant Types listed below [ ] *
* [1] ATT 4ESS. *
* [2] ATT 5ESS. *
* [3] NT DMS100. *
* [4] NT DMS250. *
* [5] NTT. *
* [6] ETSI. *
* [7] AUSTEL. *
* Select one of the Interface Types listed below [ ] *
* [1] T1. *
* [2] E1. *
* *
* Enter 'c' to Commit Changes OR 'q' to Quit [ ] *
* *
* INFO: 0 to 1023. REQUIRED. *
* *
?******************************************************************************?
This menu contains the following fields:
(The Switch type depends on the service provider for the ISDN network PRI to the Cisco wide-area switch.)
The Delete a PRI Configuration Command menu, shown in the following example, allows you to delete a configured PRI from the list of configured PRIs. All you have to enter is the DLCI, a number within the range of 0 to 1023, that identifies the PRI you want to delete from the list.
Delete a PRI Configuration Command Example Menu
********************************************************************************
* cedar *
* *
* DELETE A PRI CONFIGURATION COMMAND *
* ---------------------------------- *
* *
* DLCI # [ ] *
* *
* Enter 'c' to Commit Changes OR 'q' to Quit [ ] *
* *
* INFO: 0 to 1023. REQUIRED. *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
The Configure an INS Daemon Command menu, shown in the following example, allows you specify which INS Daemon will be active:
Configure an INS (DAS) Daemon Example Menu
********************************************************************************
* cedar *
* *
* CONFIGURE AN INS DAEMON COMMAND *
* ------------------------------ *
* *
* IP Address [ ] *
* Daemon Name [ ] *
* Preference [ ] *
* Admin Status [1] UP, [2] DOWN [ ] *
* *
* Enter 'c' to Commit Changes OR 'q' to Quit [ ] *
* *
* INFO: Dotted Decimal IP Address. REQUIRED. *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
The Configure an INS Daemon menu contains the following fields:
The Delete an INS Daemon Configuration Command menu, shown in the following example, allows you to delete an INS Daemon from the list of configured INS Daemons. All you have to enter is the IP Address, in dotted decimal notation, for that INS Daemon.
Delete an INS Daemon Example Menu
********************************************************************************
* cedar *
* *
* DELETE AN INS DAEMON CONFIGURATION COMMAND *
* -------------------------------- *
* *
* IP Address # [ ] *
* *
* Enter 'c' to Commit Changes OR 'q' to Quit [ ] *
* *
* INFO: Dotted Decimal IP Address. REQUIRED. *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
The Set INS ADMIN Status Command menu, shown in the following example, allows you to change the Administration Status of the DAS Server Shelf. Enter the index 1 for ON-LINE or 2 for OFF-LINE. You can bring the DAS Server Shelf OFF-LINE for testing or troubleshooting purposes, then bring it back ON-LINE with this command screen.
Set INS Administrative Status Command Example Menu
********************************************************************************
* cedar *
* *
* SET INS ADMIN STATUS COMMAND *
* ----------------------------- *
* *
* Administration Status [1] ON-LINE, [2] OFF-LINE [ ] *
* *
* Enter 'c' to Commit Changes OR 'q' to Quit [ ] *
* *
* INFO: 1 to 2. REQUIRED. *
* *
* *
* *
* *
* *
* *
* *
* *
* *
* *
?******************************************************************************?
The Quit Command Line option, removes you from the INS CLI main menu and returns you to the DAS Server Shelf's UNIX prompt. To quit the INS CLI, type 16 and press Enter.
Quit Command Line Option
********************************************************************************
* cedar *
* *
* DIAL-UP FRAME RELAY COMMAND LINE INTERFACE *
* Rel. 1.4 (Fri Aug 22 15:12:34 PDT 1997). *
* *
* *
* 1 List Active PRIs. 10 Modify CDR Configuration. *
* 2 Display CDR Configuration. 11 Configure a PRI. *
* 3 List Configured PRIs. 12 Delete a PRI Configuration. *
* 4 List Configured INS Daemons. 13 Configure an INS Daemon. *
* 5 Display Current INS Daemon. 14 Delete an INS Daemon Config. *
* 6 Display INS Status. 15 Set INS Admin Status. *
* 7 Display Call Processor Stats. 16 Quit Command Line. *
* 8 Display Layer 3 Stats. *
* 9 Display Layer 2 Stats. *
* *
* Enter number of the command and hit return:16 *
* *
* *
* *
* *
* *
?******************************************************************************?
|
|