Network Card User Manual

ManualsBrandsKentrox ManualsNetwork CardAI232

AI232

32-Port High Speed Asynchronous Line Card

User’s Guide

Version 9.6x

Part Number 232UM Rev 4

Summary of content (322 pages)

PAGE 2
Copyright © 2008 by Kentrox, Inc. All Rights Reserved. The material discussed in this publication is the proprietary property of Kentrox, Inc. Kentrox retains all rights to reproduction and distribution of this publication. Kentrox is a registered trademark of Kentrox, Inc. Applied Innovation, Applied Innovation Inc., the AI logo, and other names are the intellectual property of Kentrox. All other product names are trademarks or registered trademarks of their respective owners.
PAGE 3
About this Document This document explains how to install, configure, and operate the AI232 32-port high speed asynchronous line card.
PAGE 4
AI232 Version 9.6x User’s Guide About this Document: Document Conventions Document Conventions Table 1 describes the text conventions used in this document. Table 1 Document Conventions Convention Meaning Screen Text, Menu Items, System Prompts, Messages and Reports This style indicates configuration screen text, menu items, system prompts, messages, and reports. Static Command Text In a command statement, this style indicates text that should be entered exactly as shown at a command line.
PAGE 5
AI232 Version 9.6x User’s Guide About this Document: Document Conventions Table 1 Document Conventions (Continued) Convention Note: Important: Tip: CAUTION: WARNING: LASER DANGER: Meaning Note messages emphasize or supplement important points of the main text. Important messages provide information that is essential to the completion of a task. Tip messages provide information that assists users in operating equipment more effectively.
PAGE 6
AI232 Version 9.6x User’s Guide About this Document: Cautions and Warnings Cautions and Warnings Electrostatic Discharge Caution CAUTION: Kentrox equipment and its peripherals contain electrostatic sensitive components. Proper handling, shipping, and storage precautions must be exercised: z You must remove and install cards in a static-free environment. Wear an antistatic wrist strap that is plugged into the Kentrox equipment so you are grounded at the same point as the equipment.
PAGE 7
AI232 Version 9.6x User’s Guide About this Document: Cautions and Warnings FCC Warning The Federal Communications Commission has set limits for emitted radio interference, and AI232 is constructed with this electromagnetic interference (EMI) limitation in mind. AI232 is classified under FCC regulations as a Class A device, that is, a device for use in commercial environments and not in residential areas. This device has been tested and shown to comply with the following FCC rule: Part 15 Subpart J.
PAGE 8
AI232 Version 9.6x User’s Guide About this Document: Customer Assistance Customer Assistance Kentrox offers technical support 24 hours a day, seven days a week.
PAGE 9
Table of Contents Chapter 1: Product Description ..............................................................1-1 Features ....................................................................................................................... 1-2 Break Propagation ............................................................................................ 1-2 DCD/DSR/RTS/DTR Signal Lead Control ........................................................ 1-2 Dynamic Port Configuration .........................
PAGE 10
Table of Contents Logging Into AI232 ....................................................................................................... 3-4 Using a Telnet Connection for Login ................................................................ 3-4 Using an Asynchronous Port for Login ............................................................. 3-5 Accessing the Local Menu System .............................................................................. 3-7 Navigating the Local Menu System ..........
PAGE 11
Table of Contents Chapter 5: Link Configuration ................................................................5-1 AI232 Link Types ......................................................................................................... 5-2 Asynchronous ................................................................................................... 5-2 Asynchronous PPP .......................................................................................... 5-2 Modem Multiplexer .....................
PAGE 12
Table of Contents Chapter 6: TID Multiplexing ....................................................................6-1 Overview ...................................................................................................................... 6-2 TID Multiplexing Configuration ..................................................................................... 6-4 Configuring the Parent Alias .............................................................................
PAGE 13
Table of Contents debug ......................................................................................................................... 8-31 delete ......................................................................................................................... 8-33 diag-conn ................................................................................................................... 8-34 diag-eth ......................................................................................
PAGE 14
Table of Contents tacacs server summary ............................................................................................ 8-102 tacacs sholog ........................................................................................................... 8-104 tacacs stats .............................................................................................................. 8-105 tail .............................................................................................................
PAGE 15
1 Product Description This chapter provides an overview of the AI232 32-port high speed asynchronous line card.
PAGE 16
AI232 Version 9.6x User’s Guide Product Description: Features Features AI232 is a high-performance asynchronous network interface card used in an AIswitch. AI232 includes the following features: Break Propagation AI232 supports break handling from one end of a connection to another end regardless of the protocols used for data transport. Refer to Chapter 7: Alias and Call Routing Configuration for details about available types of break handling.
PAGE 17
AI232 Version 9.6x User’s Guide Product Description: Features Standalone Configuration AI232 operates as a standalone card when it is installed in the AIswitch series 110 chassis. Standalone mode lets AI232 function without dependence on AI198 for configuration and management. Refer to Appendix B: Standalone Mode and Switch Mode for more details. System Diagnostics AI232 lets users view diagnostic data on existing connections and internal information about serial links.
PAGE 18
AI232 Version 9.6x User’s Guide Product Description: AI232 Hardware Components AI232 Hardware Components AI232 has four high-density connectors that provide 32 EIA-232-E asynchronous ports that support speeds up to and including 115 Kilobits per second. All ports have modem control for host or modem applications and can be used to connect user terminals, personal computers, modems, and other high-speed asynchronous ports.
PAGE 19
AI232 Version 9.6x User’s Guide Product Description: AI232 Hardware Components Front Panel Components Figure 1-1 displays the AI232 front panel components. DC OK LED Illuminates green when +5 Volts is present. FAULT LED Illuminates red if the card fails. PORTS 25-32 Connector Connects ports 25 to 32 to the distribution panel. PORTS 17-24 Connector Connects ports 17 to 24 to the distribution panel. PORTS 9-16 Connector Connects ports 9 to 16 to the distribution panel.
PAGE 20
AI232 Version 9.6x User’s Guide Product Description: Technical Specifications Technical Specifications Table 1-1 lists the AI232 technical specifications. Table 1-1 Technical Specifications 1-6 Component Description 10BaseT Ethernet port on the AI232 front panel. High Density SCSI 32 asynchronous, EIA-232-E (individual ports are accessed by using a distribution panel) Port Speed 300 bps to 115 Kbps Installation Requires one slot in an AIswitch (can be hot swapped) Current Draw 2.
PAGE 21
AI232 Version 9.6x User’s Guide Product Description: Distribution Panels Distribution Panels Distribution panels provide a physical interface for AI232. The following distribution panel models and interfaces are available: z Model DP232-19/23 (16 DB-25/EIA-232-E interfaces) z Model DP232-RJ45 (32 RJ-45/EIA-232-E interfaces) Model DP232-19/23 This distribution panel provides 16 DB-25/EIA-232-E interfaces for AI232. To access all 32 ports on AI232, two distribution panels are required.
PAGE 22
AI232 Version 9.6x User’s Guide Product Description: Distribution Panels Table 1-2 Specifications for DP232-19/23 (Continued) Description Specification Pin Assignments Pin 1 Pin 13 Cables z z 1-8 Pin 14 Pin 25 Pin Signal 2 TXD 3 RXD 4 RTS 5 CTS 6 DSR 7 Signal GND 8 DCD CAB467: Connects one connector (8 ports) on the AI232 to the distribution panel. Each distribution panel requires two cables. CAB469: Connects network elements to the individual connectors on the distribution panel.
PAGE 23
AI232 Version 9.6x User’s Guide Product Description: Distribution Panels Installation Procedure 1. Install the distribution panel(s) on the rack. Figure 1-3 on page 1-9 displays a typical installation. 2. Attach cables from AI232 to the distribution panel.
PAGE 24
AI232 Version 9.6x User’s Guide Product Description: Distribution Panels Table 1-3 Specifications for DP232-RJ45 Description Specification Mounting Mounts to a 19-inch or 23-inch rack I/O Ports 32 RJ-45 ports Weight (approximately) 4.8 lb (2.16 kg) Size Height: 2 in. (5.08 cm) Width: 16.9 in. (42.92 cm) without mounting flanges Depth: 3.5 in. (8.
PAGE 25
AI232 Version 9.6x User’s Guide Product Description: Distribution Panels Installation Procedure 1. Attach the mounting flanges and tie bar as shown in Figure 1-5. (Table 1-4 shows the part list.) 2. Install the distribution panel to the rack. Figure 1-6 shows a typical installation. 1 4 5 8 9 12 PORTS 1 - 8 13 16 29 32 PORTS 9 - 16 DP232-RJ45 WWW.AIINET.
PAGE 26
AI232 Version 9.6x User’s Guide Product Description: Distribution Panels Cable: CAB467 (4 places) DP232-RJ45 1 4 5 8 9 12 PORTS 1 - 8 17 13 16 29 32 PORTS 9 - 16 DP232-RJ45 WWW.AIINET.
PAGE 27
AI232 Version 9.6x User’s Guide Product Description: Typical Applications Typical Applications AI232 is used primarily for connecting to asynchronous network elements and modems. The following applications are discussed in this section: z Asynchronous to TCP/IP Application z Modem Multiplexer Application Asynchronous to TCP/IP Application Figure 1-7 illustrates an asynchronous to TCP/IP application.
PAGE 28
AI232 Version 9.6x User’s Guide Product Description: Typical Applications Modem Multiplexer Application Figure 1-8 illustrates a modem multiplexer application. TCP/IP Operational Support System AI Modem 2 3 2 Modem Ethernet NE Modem NE Modem NE Modem Serial Links Modem Packet Switched Telephone Network Figure 1-8 Modem Multiplexer Application The following events occur in Figure 1-8: z The OSS sends a TCP/IP call to AI232.
PAGE 29
2 Using the AI198 Menu System This chapter provides information on starting, ending, and navigating through an AI198 menu system session.
PAGE 30
AI232 Version 9.6x User’s Guide Using the AI198 Menu System: Accessing the Menu System Accessing the Menu System To access the AI198 menu system: 1. Log into AI198. 2. At the prompt, enter menu. The Main Menu appears.
PAGE 31
AI232 Version 9.6x User’s Guide Using the AI198 Menu System: Navigating the Menu System Navigating the Menu System Menu Numbering Structure All menus accessed from the Main Menu are identified with a numerical reference at the top right corner of the menu screen. This numerical reference specifies the location within the menu system. Each digit in the menu number represents a menu item that was previously selected. For example, Menu 4.2 indicates that menu item 4 and 2 were selected. >2 Menu 4.
PAGE 32
AI232 Version 9.6x User’s Guide Using the AI198 Menu System: Navigating the Menu System 02+Configure as AI232 network interface card Some submenus require a selection from a list and then re-display the previous menu showing the selection. Other submenus have their own submenus that request additional information. After saving the entries, the top-level menu re-appears. Toggles Toggles display two or more values that can be selected for a parameter.
PAGE 33
AI232 Version 9.6x User’s Guide Using the AI198 Menu System: Navigating the Menu System Functions Menu item functions appear at the bottom of each menu. This example displays menu items that can appear and Table 2-1 describes them. 17 Display first page 18 Next page 19 Delete entry 20 Save the changes made 21 Exit this menu with no changes Enter item number and optional ",value" then push key > Table 2-1 Menu Item Descriptions Menu Item Description 17 Displays the first page of a menu.
PAGE 34
AI232 Version 9.6x User’s Guide Using the AI198 Menu System: Exiting the Menu System Exiting the Menu System To exit the menu system: 1. Access the Main Menu. 2. Enter 21. The command prompt appears.
PAGE 35
3 AI232 Local Menu System This chapter provides information on the configuration and navigation of the AI232 menu system. This system offers on-board configuration capabilities similar to those available in the AI198 menu system. The AI232 menu system is available when the card is operating in both switch mode and standalone mode.
PAGE 36
AI232 Version 9.6x User’s Guide AI232 Local Menu System: Identifying AI232 Menu System Security Options Identifying AI232 Menu System Security Options AI232 has a variety of security options, including: z Multilevel User Name and Password Security z RADIUS Authentication z TACACS+ Authentication z PPP Authentication Protocols (PAP and CHAP) Multilevel User Name and Password Security Up to 10 configurable user account profiles can be assigned to an AI232 user.
PAGE 37
AI232 Version 9.6x User’s Guide AI232 Local Menu System: Identifying AI232 Menu System Security Options PPP Authentication Protocols (PAP and CHAP) All asynchronous and synchronous PPP links are configurable to use either PAP or CHAP PPP authentication protocols. PAP establishes peer identity using a 2-way handshake that is done only upon initial link establishment. CHAP performs a 3-way handshake upon initial link establishment, then proceeds to verify the link with 3-way handshakes at random intervals.
PAGE 38
AI232 Version 9.6x User’s Guide AI232 Local Menu System: Logging Into AI232 Logging Into AI232 Log into AI232 with a Telnet connection or with any of AI232’s asynchronous ports that are configured as Login ports. Note: ai is the default user ID and password. AI232 prompts you to create a new user ID and password after the fifth login with the default values. Refer to command useradd on page 8-119 to create a new user ID and password.
PAGE 39
AI232 Version 9.6x User’s Guide AI232 Local Menu System: Logging Into AI232 The following message appears when AI232 is configured to contact a TACACS+ server during authentication, but the contact attempt fails: login: test Password: Contacting TACACS+ server. Please wait. TACACS+ server(s) not responding. Note: Five consecutive failed login attempts generate an SNMP trap and a log message saying that the login failed.
PAGE 40
AI232 Version 9.6x User’s Guide AI232 Local Menu System: Logging Into AI232 The following message appears when AI232 is configured to contact a TACACS+ server during authentication: login: test Password: Contacting TACACS+ server. Please wait. The following message appears when AI232 is configured to contact a TACACS+ server during authentication, but the contact attempt fails: login: test Password: Contacting TACACS+ server. Please wait. TACACS+ server(s) not responding.
PAGE 41
AI232 Version 9.6x User’s Guide AI232 Local Menu System: Accessing the Local Menu System Accessing the Local Menu System To access the AI232 menu session: 1. Log into AI232. Refer to section Logging Into AI232 on page 3-4 for more information. 2. At the destination menu, enter ai. The AI232 shell prompt appears. 3. Enter menu. The AI232 Main Menu appears. AI232 Main Menu + Link Menu + Alias Menu + System Menu + Static Route Menu ....................................................................
PAGE 42
AI232 Version 9.6x User’s Guide AI232 Local Menu System: Navigating the Local Menu System Navigating the Local Menu System Arrow keys and keyboard short cuts can be used to navigate through the local menu system. Refer to Table 3-1 for a list of arrow key movements and keyboard shortcuts. Note: To use the arrow keys in the menu system, make sure the VT100 arrow keys are enabled in either your Telnet settings or your terminal emulation program.
PAGE 43
AI232 Version 9.6x User’s Guide AI232 Local Menu System: Navigating the Local Menu System To save your changes: z Press F2 (or use the up and down arrow keys to highlight [Send]) and ENTER. z Enter y to save. If an error message appears, check your work and make changes as necessary. z Press CTRL-E to save data entries immediately without being queried to save. If an error message appears, check your work and make changes as necessary.
PAGE 44
AI232 Version 9.6x User’s Guide AI232 Local Menu System: Accessing the Help Menu Accessing the Help Menu The AI232 help menu lists all available keyboard codes and function keys with their associated purposes. The help menu can be accessed by doing one of the following things: z Pressing F1 and ENTER z Selecting Help on the menu and ENTER z Pressing ESC-1 and ENTER.
PAGE 45
AI232 Version 9.6x User’s Guide AI232 Local Menu System: Exiting the Local Menu System Exiting the Local Menu System To exit the local menu system and save all changes: 1. Select Send and press ENTER. The following prompt appears: Save changes? (y/n) 2. Save the changes: y 3. Select Close and press ENTER until you are out of the menu system. To exit the local menu system without saving changes, execute step 3. Note: Entering + R takes you directly to the main menu.
PAGE 46
AI232 Version 9.
PAGE 47
4 System Configuration This chapter provides information on configuring AI232 system settings with the AI198 menu system and the AI232 local menu system. To configure AI232 with the AI198 menu system, the AI198 software must be at version 1.90 or later. The AI198 menu system settings take effect only when AI232 is operating in switch mode (non-standalone mode).
PAGE 48
AI232 Version 9.6x User’s Guide System Configuration: General System Properties Configuration General System Properties Configuration General system properties are configurable at the first level of the AI198 and AI232 System menu.
PAGE 49
AI232 Version 9.6x User’s Guide System Configuration: General System Properties Configuration delay_end Defines the amount of time (in seconds) before which you must enter the next character. Valid values are integers from 1 to 9. Note: If you do not enter the next character within the configured time frame, then both the attention_keystroke and next_character values are treated as data and forwarded. next_character Defines the next character in the sequence.
PAGE 50
AI232 Version 9.6x User’s Guide System Configuration: General System Properties Configuration Configuration in the AI232 Local Menu System 1. Access the System Menu. 2. Enter a character sequence for Destination is 44 characters. The default is ^[1,5]x. Menu Break Sequence. The following example displays item Destination Maximum length Menu Break Sequence set to <33>. System Menu System Prompt . . . ................................................. [232] Destination Menu Break Sequence . . . .
PAGE 51
AI232 Version 9.6x User’s Guide System Configuration: General System Properties Configuration Configuration in the AI232 Local Menu System 1. Access the System Menu. 2. For 10 Base T Ethernet, select Off or On. The default is off when running in switch mode. The default is on when running in standalone mode. 3. For Dual Ethernet, select Off or On. The default is Off. This example displays 10 Base T Ethernet set to ON and Dual Ethernet set to OFF. System Menu System Prompt . . . ...................
PAGE 52
AI232 Version 9.6x User’s Guide System Configuration: General System Properties Configuration This example displays 16 FTP port number set to 220. >16,220 Menu 4.2.14 pg 1 01 IP Address (0.0.0.0 - 255.255.255.254)-----------------------000.000.000.000 02 IP Address Range (1 - 255)-----------------------------------------------001 03 IP Subnet Mask (0.0.0.1 - 255.255.255.254) ------------------255.255.255.254 04 Primary IP Router Address (0.0.0.0 - 255.255.255.254) -------000.000.000.
PAGE 53
AI232 Version 9.6x User’s Guide System Configuration: General System Properties Configuration Menu Item Types Data Configuration in the AI198 Menu System 1. Access Menu 4.2.14. 2. For 01 IP Address, enter 1, and the IP address for AI232. The default is 000.000.000.000. 3. For 02 IP Address Range, enter 2, and the number of the IP addresses to be assigned to AI232. The valid range is 1 to 255. 4. For 03 IP Subnet Mask, enter 3, and the IP subnet mask for AI232. The default is 255.255.255.254. 5.
PAGE 54
AI232 Version 9.6x User’s Guide System Configuration: General System Properties Configuration System Prompt Description This item sets the system prompt value in the CLI. Menu Item Type Data Configuration in the AI198 Menu System 1. Access Menu 4.2.14. 2. For 17 Prompt String, enter 17, and the desired system prompt value. There is no default prompt string. The maximum length is 64 characters. This example displays item 17 Prompt String set to NewPrompt. >17,NewPrompt Menu 4.2.
PAGE 55
AI232 Version 9.6x User’s Guide System Configuration: General System Properties Configuration TCP Settings Description The TCP settings are configured using two menu items. The configurable values are: z TCP default window size—Sets the TCP default window size for AI232. The window size specifies how many bytes AI232 will send to another device or how many bytes another device may send to the AI232 before receiving an acknowledgement.
PAGE 56
AI232 Version 9.6x User’s Guide System Configuration: General System Properties Configuration This example displays TCP Enabled. Default Window Size set to 1024 and TCP Send Ahead set to System Menu System Prompt . . . ............................................. NewPrompt Destination Menu Break Sequence . . . . . . . .................. ^[1,5]x TCP Default Window Size . . . . . . . . . . 200 512 [1024] 2048 TCP Send Ahead . . . . . . . . . . . . . . . . . .
PAGE 57
AI232 Version 9.6x User’s Guide System Configuration: General System Properties Configuration This example displays Telnet Port set to 55. System Menu System Prompt . . . ............................................. NewPrompt Destination Menu Break Sequence . . . . . . . .................. ^[1,5]x TCP Default Window Size . . . . . . . . . . 200 512 [1024] 2048 TCP Send Ahead . . . . . . . . . . . . . . . . . . [Enabled] Disabled Telnet Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 58
AI232 Version 9.6x User’s Guide System Configuration: RADIUS Configuration RADIUS Configuration RADIUS authentication verifies user login information against valid user information in a database on a centralized RADIUS authentication server. A primary and secondary RADIUS server are configurable to provide secure access for an entire AI232 network. AI232 RADIUS authentication is available for Telnet, asynchronous, and synchronous ports.
PAGE 59
AI232 Version 9.6x User’s Guide System Configuration: RADIUS Configuration 4. For 03 1812. Primary Server Port, enter 3, and the desired port number. The default is 5. For 04 Primary Server Secret, enter 4, and the desired password. The default is applied. 6. If desired, repeat steps 2 through 5 for the secondary server settings. This example displays: z 01*Primary Server Status z 02 Primary Server z 03 Primary Server z 04 Primary Server set to ENABLED IP Address set to 050.023.156.
PAGE 60
AI232 Version 9.6x User’s Guide System Configuration: RADIUS Configuration Shell/FTP Options Description This item sets the Shell/FTP option for RADIUS as one of the following: z Enabled—Enables z Disabled—Disables z Local fallback—Enables RADIUS login. RADIUS login. RADIUS login, but resorts to local login if the RADIUS login fails. Note: RADIUS and TACACS+ cannot both be configured at the same time. Attempting to do this generates an error.
PAGE 61
AI232 Version 9.6x User’s Guide System Configuration: RADIUS Configuration This example displays the shell RAS option set to RADIUS/Fallback. RAS Configuration Menu RADIUS Primary Server Status . . . . . . . . . . . [Enabled] Disabled IP Address . . . . ....... 0.0.0.0 Port Number . . . . 1812 Secret . . . .............. newone RADIUS Secondary Server Status . . . . . . . . . . Enabled [Disabled] IP Address . . . . ....... 0.0.0.0 Port Number . . . . 1812 Secret . . . .............
PAGE 62
AI232 Version 9.6x User’s Guide System Configuration: TACACS+ Configuration TACACS+ Configuration TACACS+ authentication verifies user login information against the user’s permission level on a TACACS+ server. Up to 9 TACACS+ servers are configurable to provide secure access for an entire AI232 network. AI232 TACACS+ authentication is available for Telnet, asynchronous, and FTP connections.
PAGE 63
AI232 Version 9.6x User’s Guide System Configuration: TACACS+ Configuration 5. For 04 Primary Server Secret, enter 4, and the password. The default is applied. 6. Repeat steps 2 through 5 for the secondary server settings. This example displays: z 01*Primary Server Status z 02 Primary Server IP Address z 03 Primary Server z 04 Primary Server set to ENABLED set to 050.023.156.011 Port set to 122 Secret set to hilltop.
PAGE 64
AI232 Version 9.6x User’s Guide System Configuration: TACACS+ Configuration This example displays 09*Shell/FTP TACACS Option set to LOCAL FALLBACK. >9 Menu 4.2.14-2.4 01*Primary Server Status (Enabled, Disabled)---------------------------DISABLED 02 Primary Server IP Address------------------------------------000.000.000.000 03 Primary Server Port (1..
PAGE 65
AI232 Version 9.6x User’s Guide System Configuration: SNMP Configuration SNMP Configuration This section discusses SNMP configuration options. The following configuration components are available: z Authentication Traps z Community Names z Contact Persons z Node Information z SNMP Manager Authentication Traps Description This item enables or disables the generation of authentication failure traps by AI232.
PAGE 66
AI232 Version 9.6x User’s Guide System Configuration: SNMP Configuration The following example displays the selection of On for menu item Send authentication traps. SNMP Menu Contact person for this managed Node name . . . . . . . . . . . Node location . . . . . . . . . Send authentication traps . . . node . . . . . . . . . . . . . . . . . . . . . . . . . . . . ............... . . . . . . . . . . . . . . . ............... . . . . . . . . . . . . . . .
PAGE 67
AI232 Version 9.6x User’s Guide System Configuration: SNMP Configuration The following example displays: z z z Item 05 Item 06 Item 07 set to ReadComm. MIB2 Read Community Name set to MIB2. Write Community Name set to WriteComm. Read Community Name >7,WriteComm Menu 4.2.14.
PAGE 68
AI232 Version 9.6x User’s Guide System Configuration: SNMP Configuration Contact Persons Description This item defines the name of the person to contact regarding a specific node. Menu Item Types Data Configuration in the AI198 Menu System 1. Access Menu 4.2.14.8. 2. For 01 Contact person for this node, enter 1, and the desired contact person. The maximum length is 40 characters. The following example displays John for this node: Doe configured for menu item 01 Contact person >1,John Doe Menu 4.2.14.
PAGE 69
AI232 Version 9.6x User’s Guide System Configuration: SNMP Configuration Configuration in the AI198 Menu System 1. Access Menu 4.2.14.8. 2. For 02 Node characters. name, enter 2, and the node name. The maximum length is 40 3. For 03 Node location, enter 3, and a node location description. The maximum length is 40 characters. The following example displays the configuration of node name newNode and node location Office B. >3,Office B Menu 4.2.14.
PAGE 70
AI232 Version 9.6x User’s Guide System Configuration: SNMP Configuration Menu Item Types Data AI232 Local Menu Item Configuration 1. Access the SNMP Menu located under the System Menu. 2. For SNMP Manager is 0.0.0.0. #1, enter the IP address of the first SNMP manager. The default 3. For SNMP Manager #2, enter the IP address of the second SNMP manager. The default is 0.0.0.0. 4. For SNMP Manager is 0.0.0.0. #3, enter the IP address of the third SNMP manager. The default 5.
PAGE 71
AI232 Version 9.6x User’s Guide System Configuration: Static Route Configuration Static Route Configuration AI232 allows for the configuration of static routes using both the AI198 and AI232 menu systems. IP Address Settings Description Static routes are configured with a destination and next hop IP address. The destination IP address defines the static IP route you want to configure.
PAGE 72
AI232 Version 9.6x User’s Guide System Configuration: TID to Modem Mux Configuration TID to Modem Mux Configuration The following are available: z Inactivity Timeout z Initialization String z Port Bit Settings z TID to Route Inactivity Timeout Description This menu item defines the amount of time (in seconds) the Modem Mux connection must be inactive before it times out. Menu Item Types Data Configuration in the AI198 Menu System 1. Access Menu 4.2.14-2.6. 2. From Menu 4.2.14-2.
PAGE 73
AI232 Version 9.6x User’s Guide System Configuration: TID to Modem Mux Configuration This example displays Inactivity Timeout set to 1500. TID To Modem Mux Edit Menu TID to route . . . Port Data Bits . . Port Stop Bits . . Port Parity . . . Init String . . . Inactivity Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ..................... . . . . . . Seven [Eight] . . . . . . . .
PAGE 74
AI232 Version 9.6x User’s Guide System Configuration: TID to Modem Mux Configuration This example displays Init String set to conn23. TID To Modem Mux Edit Menu TID to route . Port Data Bits Port Stop Bits Port Parity . Init String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ..................... . . . . . . Seven [Eight] . . . . . . . . [One] Two . . . . [None] Even Odd ...........
PAGE 75
AI232 Version 9.6x User’s Guide System Configuration: TID to Modem Mux Configuration AI232 Local Menu Item Configuration 1. Access the TID to Modem Mux Menu located under the System Menu. 2. From the System Menu, select TID Summary Menu appears. to Modem Mux. The TID to Modem Mux 3. From the TID to Modem Mux Summary Menu, select [Add Modem Mux Edit Menu appears. 4. For Port Data Bits, select 7 or 8. The default is 8. 5. For Port Stop Bits, select 1 or 2. The default is 1. 6.
PAGE 76
AI232 Version 9.6x User’s Guide System Configuration: TID to Modem Mux Configuration AI232 Local Menu Item Configuration 1. Access the TID to Modem Mux Menu located under the System Menu. 2. From the TID to Modem Mux Summary Menu, select [Add Modem Mux Edit Menu appears. 3. For TID to route, TID]. The TID To enter the desired TID. Maximum length is 20 characters. This example displays the TID configured as COLUMBUS-OH. TID To Modem Mux Edit Menu TID to route . . . . . . . . . . . . . . . . . . . . ...
PAGE 77
AI232 Version 9.6x User’s Guide System Configuration: Time Configuration Time Configuration AI232 supports the Simple Network Time Protocol (SNTP). SNTP is a time protocol that maintains a common time among Internet hosts. Note: Time configuration options are only available when AI232 is operating in standalone mode.
PAGE 78
AI232 Version 9.6x User’s Guide System Configuration: Time Configuration SNTP Settings Description SNTP is a time protocol that maintains a common time among Internet hosts. There are 4 menu items available for configuring SNTP settings: z SNTP client on this host is—Enables or disables SNTP. If Enabled is selected, the system attempts to contact the primary and secondary SNTP servers for the exact time.
PAGE 79
AI232 Version 9.6x User’s Guide System Configuration: Time Configuration This following example displays: z SNTP client on this host is z Primary SNTP Server z Secondary z SNTP Poll set to Enabled set to 12.43.167.59 SNTP Server set to 12.43.167.60 Interval (minutes) set to 7. Time Menu Current Time Zone (+/-hh:mm) . . . . . . . . . . . . . . . . . . . . . .+00:00 Daylight Saving Time on this host is . . . . . . . . [Enabled] Disabled SNTP client on this host is . . . . . . . . . . . . .
PAGE 80
AI232 Version 9.
PAGE 81
5 Link Configuration This chapter provides information on configuring AI232 links in the AI198 and AI232 local menu systems.
PAGE 82
AI232 Version 9.6x User’s Guide Link Configuration: AI232 Link Types AI232 Link Types AI232 has 3 configurable link types: z Asynchronous z Asynchronous PPP z Modem Multiplexer Asynchronous Asynchronous links use asynchronous transmission and support multiple baud rates, parity types, stop bits, and software flow or hardware control.
PAGE 83
AI232 Version 9.6x User’s Guide Link Configuration: AI232 Link Types Modem Multiplexer The modem multiplexer gives users access to a modem pool. The modem pool is the list of ModMux links with attached modems. When a call comes in that requires a modem, one is selected from the pool and dials out appropriately. The phone number to dial is configurable for incoming calls that need to be attached to modems.
PAGE 84
AI232 Version 9.6x User’s Guide Link Configuration: Connect Options Configuration Connect Options Configuration Connect options configure the AI232 connection parameters. These options are available for asynchronous links and asynchronous PPP links. The following configuration items are available: z Alias z Call Retry Interval z Connect String z Connection Settings z Link Application Alias Description This menu item specifies an alias name for the connection.
PAGE 85
AI232 Version 9.6x User’s Guide Link Configuration: Connect Options Configuration This example displays 02 set to async.4.1. Alias >2,async.4.1 Menu 4.2.14.12.11 01*Link Application (Login, Destination, Alias)---------------------------ALIAS 02 Alias--------------------------------------------------------------async.4.1 Configuration in the AI232 Local Menu System 1. Access the Async Link Menu. 2. Select Connect 3. For Link Options Menu.
PAGE 86
AI232 Version 9.6x User’s Guide Link Configuration: Connect Options Configuration This example displays 03 Call retry interval set to 134. >3,134 Menu 4.2.14.12.11 01*Link Application (Login, Destination, Alias)---------------------------ALIAS 02 Alias--------------------------------------------------------------async.4.1 03 Call retry interval (0 - 32767 s, 0 = disabled)------------------------00134 Configuration in the AI232 Local Menu System 1. Access the Async Link Menu. 2. Select Connect 3.
PAGE 87
AI232 Version 9.6x User’s Guide Link Configuration: Connect Options Configuration Menu Item Type Data Link Type Availability Async Configuration in the AI198 Menu System 1. Access Menu 4.2.14.12.11. 2. For 08 Connect string, This example displays 08 enter 8, and the connect string. Connect string set to newstring<33>
. >8,newstring<33>
Menu 4.2.14.12.
PAGE 88
AI232 Version 9.6x User’s Guide Link Configuration: Connect Options Configuration Connection Settings Description The connection settings are configured using three menu items: z or disables link connection when DCD is asserted. If Connect when characters are received is also enabled and is satisfied first, then Connect when DCD is on has no effect on the link connection. z Connect when characters are received—Enables or disables the link connection when incoming characters are received.
PAGE 89
AI232 Version 9.6x User’s Guide Link Configuration: Connect Options Configuration This example displays: z 05*Connect when DCD is on z 06*Connect when characters are received z 07*Connect without DSR, DCD or received characters set to ON set to OFF set to OFF. >5 Menu 4.2.14.12.11 01*Link Application (Login, Destination, Alias)---------------------------ALIAS 02 Alias--------------------------------------------------------------async.4.
PAGE 90
AI232 Version 9.6x User’s Guide Link Configuration: Connect Options Configuration Link Application Description This menu item configures the link application type. The following options are available: z Login—Specifies that the link will prompt for a user name and password when connected. Upon successful login, a menu appears showing the available destination alias names.
PAGE 91
AI232 Version 9.6x User’s Guide Link Configuration: Connect Options Configuration Configuration in the AI232 Local Menu System 1. Access the Async Link Menu. 2. Select Connect 3. For Link Options Menu. Application, The Connect Options Menu appears. select Login, Destination, or AppAlias. The default is Login. This example displays Link Application set to Destination. Connect Options Menu Link being configured . . . . . . . . . . . . . . . . . . . . . . . . . Link Application . . . . . . . . . .
PAGE 92
AI232 Version 9.6x User’s Guide Link Configuration: Disconnect Options Configuration Disconnect Options Configuration Disconnect options configure the parameters that are used when AI232 disconnects. These options are available for asynchronous and asynchronous PPP links.
PAGE 93
AI232 Version 9.6x User’s Guide Link Configuration: Disconnect Options Configuration 3. For 05*Inactivity Timer The default is OFF. enabled when link receives call, 4. For 06*Inactivity Timer resets on select ON or OFF. The default is ON. enter 5 to select ON or OFF.
PAGE 94
AI232 Version 9.6x User’s Guide Link Configuration: Disconnect Options Configuration Disconnect Settings Description The disconnect settings are configured using two menu items: z Disconnect when a break character is received—Enables or disables link disconnection when a break character is received. z Disconnect when DCD off—Enables or disables link disconnection when DCD is not asserted. Note: AI232 does not consider the DSR state when disconnecting calls.
PAGE 95
AI232 Version 9.6x User’s Guide Link Configuration: Disconnect Options Configuration This example displays Disconnect when DCD is off set to On and Disconnect character is received set to Off for an async link. when a Break Disconnect Options Menu Link being configured . . . . . . . . . . . . . . . . . . . . . . . . . Disconnect when DSR is off . . . . . . . . . . . . . . . . . . . Disconnect when DCD is off . . . . . . . . . . . . . . . . . . . Disconnect when a Break character is received . . . . .
PAGE 96
AI232 Version 9.6x User’s Guide Link Configuration: Disconnect Options Configuration This example displays 07 Disconnect string set to newString<33>
. >7,newString<33>
01 Disconnect 02*Disconnect 03*Disconnect 04 Disconnect 05*Inactivity 06*Inactivity 07 Disconnect Menu 4.2.14.12.
PAGE 97
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration General Link Properties Configuration General link properties are configurable using menus accessed directly from the link configuration menu.
PAGE 98
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration This ModMux link example displays 08 Auto Disable Error Limit set to 25000. >8,25000 Menu 4.2.14.
PAGE 99
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration Configuration in the AI198 Menu System 1. Access Menu 4.2.14.12. 2. For 09*Flow Control, enter 9 to select None or XonXoff. The default is None. This async link example displays 09*Flow Control set to XonXoff. >9 01 Link 02*Link 03 Link 04*Link 05+Port 06*Port 07*Port 08*Port 09*Flow Menu 4.2.14.
PAGE 100
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration Configuration in the AI198 Menu System 1. Access Menu 4.2.14.12. 2. For 03 Link Description, enter 3, and a description associated with the link. Maximum length is 30 characters. This example displays 03 Link Description set to New Async Link. >3,New Async Link Menu 4.2.14.
PAGE 101
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration This example displays 01 Link number set to 3. >1,3 Menu 4.2.14.12 01 Link Number (1-32)--------------------------------------------------------03 Configuration in the AI232 Local Menu System 1. Access the Link Menu. 2. For Link to configure, enter the link number. The default is 1. This example displays Link to configure set to 3. Async Link Menu Link to configure . . . . . . . . . . . . . . . . . . . . .
PAGE 102
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration This example displays Link state set to Disabled. Async Link Menu Link to configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Link Description . . . . . . . . . . . . . . .................. Async link 3 Link state . . . . . . . . . . . . . . . . . . . . . Enabled [Disabled] Link Type Description This menu item defines the type of link as asynchronous, asynchronous PPP, or ModMux.
PAGE 103
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration Port Data Bits Description This menu item defines the number of databits in a data byte. Menu Item Type Toggle Link Type Availability Async and AsyncPPP Configuration in the AI198 Menu System 1. Access Menu 4.2.14.12. 2. For 06*Port Data Bits, enter 6 to select 7 or 8. The default is 8. This example displays 06*Port Data Bits set to 7. >6 01 Link 02*Link 03 Link 04*Link 05+Port 06*Port Menu 4.2.14.
PAGE 104
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration This example displays Port data bits set to Seven. Async Link Menu Link to configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Link Description . . . . . . . . . . . . . . ................ New Async Link Link state . . . . . . . . . . . . . . . . . . . . . [Enabled] Disabled Link Type . . . . . . . . . . . . . . . . .
PAGE 105
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration This example displays Port parity set to Odd. Async Link Menu Link to configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Link Description . . . . . . . . . . . . . . .................. Async link 3 Link state . . . . . . . . . . . . . . . . . . . . . Enabled [Disabled] Link Type . . . . . . . . . . . . . . . . . [Async] AsyncPPP ModMux Port speed (in bits per second): 300 1200 2400 4800 [9600] 19.
PAGE 106
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration Menu 4.2.14.12.5 appears. >5 Menu 4.2.14.12.5 01 02 03 04 05 06 07 08 09 10 300 Baud 1200 Baud 2400 Baud 4800 Baud 9600 Baud 19200 Baud 38400 Baud 57600 Baud 115200 Baud Auto Baud Note: 10 Auto Baud is not available for AsyncPPP or ModMux. 3. Enter a value from 1 to 10 to select the port speed. Menu 4.2.14.12 reappears with the new port speed selection. This example displays 05+Port speed set to 4800.
PAGE 107
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration Configuration in the AI232 Local Menu System 1. Access the Link Menu. 2. For Port speed, select 300, 1200, 2400, 4800, 9600, 19.2K, 38.4K, 57.6K, 115.2K, or Autobaud. The default is 9600. This example displays Port speed set to 4800. Async Link Menu Link to configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Link Description . . . . . . . . . . . . . . ................ New Async Link Link state . .
PAGE 108
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration Configuration in the AI232 Local Menu System 1. Access the Async Link Menu or AsyncPPP Link Menu. 2. For Port stop bits, select One or Two. The default is One. This example displays Port stop bits set to Two. Async Link Menu Link to configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Link Description . . . . . . . . . . . . . . ................ New Async Link Link state . . . . . . . . . . . . .
PAGE 109
AI232 Version 9.6x User’s Guide Link Configuration: General Link Properties Configuration This example displays 10 Xon Repeat interval set to 30. >10,30 Menu 4.2.14.
PAGE 110
AI232 Version 9.6x User’s Guide Link Configuration: General PPP Properties Configuration General PPP Properties Configuration The following menu items are available for PPP configuration: z IPCP Address Settings z Maximum Unit Settings z Network Control Protocol IPCP Address Settings Description The IPCP address settings are configured using three menu items: z Local IP address—Defines z Remote IP address—Defines z Subnet mask—Defines a valid local IP address for AI232.
PAGE 111
AI232 Version 9.6x User’s Guide Link Configuration: General PPP Properties Configuration This example displays: z 01*Network Control Protocol z 02 Local IP Address z 03 Remote z 04 Subnet set to IPCP set to 099.045.006.033 IP Address set to 106.046.092.004 Mask set to 255.255.255.000. >4,255.255.255.000 Menu 4.2.14.12-2.2 01*Network Control Protocol (IPCP, BCP)------------------------------------IPCP 02 Local IP Address---------------------------------------------099.045.006.
PAGE 112
AI232 Version 9.6x User’s Guide Link Configuration: General PPP Properties Configuration Maximum Unit Settings Description The maximum unit settings are configured using two menu items: z Maximum receive unit z (MTU)—Defines the maximum number of bytes that can be transmitted in a single packet. (MRU)—Defines the maximum number of bytes that can be received in a single packet. Maximum transmit unit Note: During LCP negotiations on a PPP link, AI232 will advertise the MRU configured by the user.
PAGE 113
AI232 Version 9.6x User’s Guide Link Configuration: General PPP Properties Configuration Configuration in the AI232 Local Menu System 1. Access the AsyncPPP or ModMux Link Menu. 2. Select PPP Configuration Menu. The PPP Configuration Menu appears. 3. For Maximum Receive Unit, enter the byte value. The defaults are 1518 for network control protocol BCP and 1500 for network control protocol IPCP. 4. For Maximum Transmit Unit, enter the byte value.
PAGE 114
AI232 Version 9.6x User’s Guide Link Configuration: General PPP Properties Configuration Configuration in the AI198 Menu System 1. Do one of the following: z For an asynchronous PPP link, access Menu 4.2.14.12-2.2. z For a ModMux link, access Menu 4.2.14.12.10. 2. For 01*Network Control Protocol, This example displays 01*Network to BCP. enter 1 to select IPCP or BCP. The default is IPCP. Control Protocol for an asynchronous PPP link set >1 Menu 4.2.14.12-2.
PAGE 115
AI232 Version 9.6x User’s Guide Link Configuration: Modem Option Configuration Modem Option Configuration The following menu items are used for modem option configuration.
PAGE 116
AI232 Version 9.6x User’s Guide Link Configuration: Modem Option Configuration Configuration in the AI232 Local Menu System 1. Access the Async Link Menu or AsyncPPP Link Menu. 2. Select Modem 3. For Modem Setup Menu. string, The Modem Setup Menu appears. enter the modem string. This example displays Modem string set to 6145552002. Modem Setup Menu Link being configured . . . . . . . . . . . . . . . . . . . . . . . . . 3 Modem string . . . . . . . . . . . . ..............................
PAGE 117
AI232 Version 9.6x User’s Guide Link Configuration: Modem Option Configuration This example displays Dialing time-out set to 10. Modem Setup Menu Link being configured . . . . . . . . . . . . . . . . . . . . . . . . . 3 Modem string . . . . . . . . . . . . .............................. 6145552002 Dialing time-out (5 - 300 s). . . . . . . . . . . . . . . . . . . . . . . .
PAGE 118
AI232 Version 9.6x User’s Guide Link Configuration: Modem Option Configuration This example displays Number of dial attempts set to 15. Modem Setup Menu Link being configured . . . . . . . . . . . . . . . . . . . . . . . . . 3 Modem string . . . . . . . . . . . . .............................. 6145552002 Dialing time-out (5 - 300 s). . . . . . . . . . . . . . . . . . . . . . . . 10 Number of dial attempts (0 - 100, 0 = continuous retry) . . . . . . . . . .
PAGE 119
AI232 Version 9.
PAGE 120
AI232 Version 9.6x User’s Guide Link Configuration: PPP Authentication Configuration 2. For 02*Local None. Authentication Method, enter 2 to select None, PAP, or CHAP. The default is 3. For 03 Local PAP/CHAP identity, enter 3, and the user name. Maximum length is 24 characters. The default is applied. 4. For 04 Local PAP Password/CHAP Secret, enter 4, and the password. Maximum length is 24 characters. The default is applied.
PAGE 121
AI232 Version 9.6x User’s Guide Link Configuration: PPP Authentication Configuration RAS Option Description This menu item configures the method AI232 uses to obtain ID and password information for a link. The following options are available: z Disabling RAS causes AI232 to use local ID and password information to validate the ID and password sent from a remote device.
PAGE 122
AI232 Version 9.6x User’s Guide Link Configuration: PPP Authentication Configuration Configuration in the AI198 Menu System 1. Do one of the following: z For an asynchronous PPP link, access Menu 4.2.14.12-2.1. z For a ModMux link, access Menu 4.2.14.12.9. 2. For 01*RAS Option, enter 1 to select DISABLED, RADIUS, RADIUS_FB, TACACS, or TACACS_FB. The default is DISABLED. This example displays 01*RAS Option set to TACACS for an asynchronous PPP link. >1 Menu 4.2.14.12-2.
PAGE 123
AI232 Version 9.6x User’s Guide Link Configuration: PPP Authentication Configuration Remote Authentication Settings Description The remote authentication settings are configured using three menu items: z Remote authentication method—Defines the remote authentication method as one of the following options: z z PAP z CHAP specifies the method that verifies the identity of the peer by using a three-way handshake that is done upon initial link establishment.
PAGE 124
AI232 Version 9.6x User’s Guide Link Configuration: PPP Authentication Configuration This example displays: z 05*Remote Authentication Method z 06 Remote z 07 Remote set to CHAP PAP/CHAP identity set to bri24 PAP Password/CHAP Secret set to documentation. >7,documentation Menu 4.2.14.12.
PAGE 125
AI232 Version 9.6x User’s Guide Link Configuration: RTS/DTR Lead Control Configuration RTS/DTR Lead Control Configuration The following configuration items are available for RTS and DTR lead control configuration: z DTR State Configuration z RTS State Configuration DTR State Configuration Description DTR is an RS-232 signal sent from a computer or terminal to a modem that indicates that it (the computer or terminal) is able to accept data.
PAGE 126
AI232 Version 9.6x User’s Guide Link Configuration: RTS/DTR Lead Control Configuration This example displays 01*DTR to TOGGLE. connect state set to OFF and 02*DTR disconnect state set >2 Menu 4.2.14.12.13 01*DTR connect state---------------------------------------------------------ON 02*DTR disconnect state (On, Off, Toggle)--------------------------------TOGGLE Configuration in the AI232 Local Menu System 1. Access the Async Link Menu or AsyncPPP Link Menu. 2. Select RTS/DTR Lead Menu appears.
PAGE 127
AI232 Version 9.6x User’s Guide Link Configuration: RTS/DTR Lead Control Configuration RTS disconnect state—Sets the RTS disconnect state to one of the following options: z On—Sets z Off—Sets z Toggle—Makes RTS pulse when the link disconnects. The pulse polarity is opposite to the sense specified for the connected state. RTS to on when the link disconnects. RTS to off when the link disconnects.
PAGE 128
AI232 Version 9.6x User’s Guide Link Configuration: RTS/DTR Lead Control Configuration This example displays RTS to Toggle. connect state set to FlowControl and RTS disconnect state set RTS/DTR Control Options Menu Link being configured DTR DTR RTS RTS 5-48 . . . . . . . . . . . . . . . . . . . . . . . . . connect state . . . . . . . . . . . . . . . . . . . . . . . disconnect state . . . . . . . . . . . . . . . . . On connect state . . . . . . . . . . . . . . . . On Off disconnect state . . . . .
PAGE 129
6 TID Multiplexing This chapter provides information on configuring TID multiplexing.
PAGE 130
AI232 Version 9.6x User’s Guide TID Multiplexing: Overview Overview AI232 supports TID multiplexing, which enables a single call from an OSS to fan out into multiple calls to various NEs. The initiating call may be asynchronous or TCP, but cannot originate from a destination menu. Refer to Figure 6-1 for an illustration of TID multiplexing.
PAGE 131
AI232 Version 9.6x User’s Guide TID Multiplexing: Overview z If a connection is not established after four tries or if AI232 receives a TL1 command with an unknown TID, the TL1 command gets discarded and a message gets logged. z If the OSS is disconnected from AI232, all associated children calls to the NEs are disconnected.
PAGE 132
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Configuration TID Multiplexing Configuration Establish TID multiplexing by configuring aliases for calls that will go through AI232. Configure a parent alias to accept the incoming call from the OSS. After doing this, configure children aliases to route calls to the various network elements. For more information about aliases, refer to Chapter 7: Alias and Call Routing Configuration.
PAGE 133
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Configuration 5. For 02+Simple alias translation options. translation, enter 2. Menu 8.2 appears with the available >2 Menu 8.2 01 02 03 04 Simple alias translation Multiplexed connection Multiplexed only translation SLC routing translation 21 Exit this menu with no changes Enter item number and optional ",value" then push key > enter 4. Menu 8 reappears with SLC translation selected for menu item 2. 6.
PAGE 134
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Configuration Configuration in the AI232 Local Menu System Note: To configure aliases in the AI232 local menu system, AI232 must be in standalone mode. 1. Log in to the AI232 Main Menu. 2. From the AI232 Main Menu, select Alias Menu. 3. From the Alias Summary Menu, select Add The Alias Summary Menu appears. Alias. The Alias Edit Menu appears. Alias Edit Menu Alias Name . . . . . Destination . . Caller's Address Called Address .
PAGE 135
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Configuration 7. For Application string, enter: TMUXn [ TID:tid_for_AI232 ] n Defines the maximum number of children connections. Valid values are 1 to 128. tid_for_AI232 Defines the terminal identifier for AI232. 8. For Called protocol, enter ="". 9. (optional) For Caller's protocol, enter the caller's protocol. 10. Save your changes.
PAGE 136
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Configuration 4. For 01 Alias name, enter: parent_name.m parent_name Defines the name you entered for 08 alias configuration. m Defines the child number. Valid values are 1 to n (specified during the parent alias configuration). 5. For 02+Simple alias translation options. translation, Call data during the parent enter 2. Menu 8.2 appears with the available >2 Menu 8.
PAGE 137
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Configuration 11. For 09 App. string, enter: TID:tid tid Defines the TID of the destination NE. Maximum length is 20 characters. 12. (optional) For 10 13. For 11 Called protocol, Caller's protocol, enter 10, and the called protocol. enter 11,="". Configuration in the AI232 Local Menu System Note: To configure aliases in the AI232 local menu system, AI232 must be in standalone mode. 1. Log in to the AI232 Main Menu. 2.
PAGE 138
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Configuration 4. For Alias name, enter: parent_name.m parent_name Defines the name you entered for 08 alias configuration. m Defines the child number. Valid values are 1 to n (specified during the parent alias configuration). Call data during the parent 5. If you are using single alias translation, for Destination, enter the IP address of AI232.
PAGE 139
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Configuration This example displays the parent alias configuration in the AI198 menu system. >11 ="" Menu 8 01 Alias name ------------------------------------------------172.16.30.61#6001 02+Simple alias translation 03 Destination 04 Called address 05 This alias is visible in the destination menu----------------------------YES 06 Link number is (1..
PAGE 140
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Configuration This example displays the parent alias configuration in the AI232 menu system. Note: To configure aliases in the AI232 local menu system, AI232 must be in standalone mode. Alias Edit Menu Alias Name . . . . . ..................................... 172.16.30.61#6001 Destination . . Caller's Address Called Address . Call Data . . . . . . . . . . . ....................................................... ....................
PAGE 141
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Configuration These examples display two of the child alias configurations in the AI198 menu system. >11 ="" Menu 8 01 Alias name --------------------------------------------------------PARENT1.1 02+Simple alias translation 03 Destination ----------------------------------------------------172.16.30.
PAGE 142
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Configuration These examples display two of the child alias configurations in the AI232 menu system. Note: To configure aliases in the AI232 local menu system, AI232 must be in standalone mode. Alias Edit Menu Alias Name . . . . . ............................................. PARENT1.1 Destination . . Caller's Address Called Address . Call Data . . . . . . . . . . . .......................................... 172.16.30.61 ............
PAGE 143
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Troubleshooting TID Multiplexing Troubleshooting If an OSS is not getting a response from an NE, it can send a TL1 retrieve header command (RTRV-HDR) to determine if the problem is with the NE or with AI232. The parent connection on AI232 responds to RTRV-HDR commands that have the same TID as the one configured for the card.
PAGE 144
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Troubleshooting Table 6-1 RTRV-HDR Response Format Description (Continued) Response Item Description YY-MM-DD Specifies the date. HH:MM:SS Specifies the time of day. ctag Specifies the correlation tag. COMPLD Specifies completion. The Input requirement is satisfied. Normal Response Example This example displays the response that appears when RTRV-HDR:AI232:12345; is executed.
PAGE 145
AI232 Version 9.6x User’s Guide TID Multiplexing: TID Multiplexing Troubleshooting Table 6-2 Error Response Format Description (Continued) Response Item Description errcde Specifies the error code. Error Response Example This example displays the response that appears if RTRV-HDR fails. AI232 00-04-14 05:06:39 M 12345 DENY IIAC; Diagnostics for TID Multiplexing To view information on TID multiplexed calls and the associated TIDs, use diag-tconn.
PAGE 146
AI232 Version 9.
PAGE 147
7 Alias and Call Routing Configuration This chapter provides information on configuring aliases and routing calls on AI232.
PAGE 148
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Overview Overview AI232 uses aliases to route calls across the backplane of AIswitch. Each incoming call’s routing information must match an entry in the alias table, or else the call is rejected. When AI232 is in switch mode, the alias table is stored on AI198. When AI232 is in standalone mode, the alias table is stored in AI232’s local memory.
PAGE 149
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Overview 5. The TCP packet is received by AI232 card B. 6. The data travels upstream through the ASY protocol option to preserve packetization. 7. The data packet is converted, travels downstream, and is transmitted out AI232 using an asynchronous protocol with the original packetizing characteristics preserved.
PAGE 150
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Call Routing Call Routing To route calls within AI232, an alias must be configured according to the source protocol and the destination protocol. Note: Aliases created in AI198 are not visible to AI232 when it is running in standalone mode. However, you can configure aliases in the AI232 local menu system when it is in standalone mode.
PAGE 151
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Call Routing 3. To access menu 08+Configure the alias translation table, enter 8. Menu 8 appears: >8 Menu 8 01 Alias name -**************************************************************** 02+Simple alias translation 03 Destination 04 Called address 05 This alias is visible in the destination menu-----------------------------NO 06 Link number is (1..16) 07 Caller's address 08 Call data 09 App.
PAGE 152
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Call Routing 5. To access menu 02+Simple alias translation, enter 2. Menu 8.2 appears: >2 Menu 8.2 01 02 03 04 Simple alias translation Multiplexed connection Multiplexed only translation SLC routing translation 21 Exit this menu with no changes Enter item number and optional ",value" then push key > 6. To select 04 SLC routing translation, enter 4. Menu routing translation configuration items.
PAGE 153
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Call Routing 11. (optional) For 10 Called protocol -, enter 10, and the called protocol type. For more information about protocol types, refer to Protocol Processing Modules on page 7-14. 12. (optional) For 11 Caller's protocol -, enter 11, and the caller’s protocol type. For more information about protocol types, refer to Protocol Processing Modules on page 7-14. 13.
PAGE 154
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Call Routing 5. For Alias Name, enter the alias name for the incoming (source) call. AI232 translates the alias name into a call of the type defined in the remaining alias menu items. Note: The alias name may include leading, trailing, or embedded wildcard matching characters.
PAGE 155
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Call Routing Source/Destination Protocol Tables The following tables are organized according to source protocols.
PAGE 156
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Call Routing Source/Destination Protocol Tables for the AI198 Menu System Table 7-1 Asynchronous Source Without Breaks (AI198) Source Destination Menu Item Information Async Async 01 baseport.asy.link_number Example: 16.asy.3 02 SLC Routing Translation 04 PVC 08 asy.link_number Example: asy.3 Async TCP 01 baseport.asy.link_number Example: 16.asy.
PAGE 157
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Call Routing Table 7-3 TCP/IP Source Without Telnet Breaks (AI198) Source Destination Menu Item Information TCP TCP 01 ip_address#tcp_port_number Example: 198.29.5.6#389 02 SLC Routing Translation 04 Destination IP Address: ip_address#tcp_port_number Example: 198.29.5.6#389 TCP Async 01 ip_address#tcp_port_number Example: 198.29.5.6#389 02 SLC Routing Translation 04 PVC 08 asy.link_number Example: asy.
PAGE 158
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Call Routing Source/Destination Protocol Tables for the AI232 Menu System Table 7-5 Asynchronous Source Without Breaks (AI232) Source Destination Menu Item Information Async Async Alias Name asy.link_number Example: asy.3 Called Address PVC Call Data asy.link_number Example: asy.3 Async TCP Alias Name asy.link_number Example: asy.3 Called Address Destination IP Address: ip_address#tcp_port_number Example: 198.29.5.
PAGE 159
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Call Routing Table 7-7 TCP/IP Source Without Telnet Breaks (AI232) (Continued) Source Destination Menu Item Information TCP Async Alias Name ip_address#tcp_port_number Example: 198.29.5.6#389 Called Address PVC Call Data asy.link_number Example: asy.
PAGE 160
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Protocol Processing Modules Protocol Processing Modules Protocol processing modules are used to process data as it passes through AI232.
PAGE 161
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Protocol Processing Modules -Fd,d,d Sets the filter characters to the numbers entered in each d option. Specify up to 16 characters. It is possible to packetize on a filtered character. -U Prevents the passing of breaks upstream. -D Prevents the passing of breaks downstream. -S Packetizes on a specific sequence of characters. Enter up to 16 characters. The packet module accepts only one -S parameter.
PAGE 162
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Protocol Processing Modules TL1 The Translation Language One module typically works with messages traveling between asynchronous protocols. However, it also works with all other protocols. Some OSSs require that each TL1 command/response be fully contained in one packet. By packetizing on the TL1 termination characters (“;<>”), the TL1 module ensures that each TL1 command/response is transmitted in one packet.
PAGE 163
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Protocol Processing Modules Examples TL1 -T6 Provides TL1 packetizing and sets the packetizing timer to .06 seconds. TL1 -F10,127 Provides TL1 packetizing and filters out the characters for line feed and delete. TL1 -U Provides TL1 packetizing and prevents breaks from passing upstream. TL1 -120 -D Provides TL1 packetizing on TL1 delimiters for 20 seconds of idle time. Prevents breaks from passing downstream.
PAGE 164
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Protocol Processing Modules Examples TN -U Provides Telnet handling, but prevents breaks from being propagated upstream. TN -E Provides Telnet handling and initiates Telnet negotiation for WILL Echo and WILL SGA. TN -E255,1 Provides Telnet handling and causes the Telnet session to send IAC (255) ECHO (1) when the connection is initiated. Initiates WILL SGA.
PAGE 165
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Alias Macros Alias Macros An alias macro is a program within an alias that translates incoming call requests into outgoing call requests. It is a shortcut that allows a programmer to write many aliases by only writing one macro. Macros allow for call routing with fewer aliases. Using them with alternate routing provides multiple routes for a single alias.
PAGE 166
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Alias Macros Comments Comments are added at the programmer’s discretion to explain macro functionality. Comments can be entered either on a blank line or at the end of a line containing a macro. To enter a comment on a blank line, it must begin with two forward slashes (//). To enter a comment in a field with a macro, it must begin with a pound sign (#) at the end of a macro.
PAGE 167
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Alias Macros Wildcard Symbols Macros have two available wildcard symbols: z ? matches any single character. z * matches zero or more characters. Note: Alias names that use wildcards are not really macros. Wildcards are not processed in alias names that start with ‘=’. Operators Operators are used for calculation of mathematical expressions in alias macros.
PAGE 168
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Alias Macros Table 7-10 Operators in Order of Precedence (Continued) Operator Description & Specifies a boolean logical AND evaluation. This requires that two conditions are true before continuing with the evaluation. ^ Specifies a boolean logical exclusive OR evaluation. This requires that one condition or another (not both) is true before continuing with the evaluation. | Specifies a boolean logical OR evaluation.
PAGE 169
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Alias Macros Table 7-11 Alias Macro Functions (Continued) Alias Macro Function Description of Operation left$(string,n) l(string,n) Returns the left-most n characters of string. If n is greater than the length of string, the function returns the entire string. len(string) Returns the length of string.
PAGE 170
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Alias Macros Table 7-11 Alias Macro Functions (Continued) Alias Macro Function Description of Operation val(string) Converts a string to its decimal integer value. For example, =v(”032”) returns integer 32. or v(string) ?(n) Returns the nth wildcard string from the alias match. Alias Macro Configuration Often there are several ways to write a macro and get the same result.
PAGE 171
AI232 Version 9.6x User’s Guide Alias and Call Routing Configuration: Alias Macros This example displays an alias where: z z Alias name 43042* matches source addresses that start with 43042 and may end with zero or more characters Called Address ='ASY.'+D((V(?(1))%6)+1) creates a called address string of ASY.1 through ASY.6. Alias Edit Menu Alias Name . . . . . ................................................ 43042* Destination . . Caller's Address Called Address . Call Data . . . . . . . . . . . .....
PAGE 172
AI232 Version 9.
PAGE 173
AI232 8 AI232 Commands This chapter provides information about each AI232 shell command and all AI198 winslc commands that are supported by AI232. These commands perform AI232 system tasks.
PAGE 174
AI232 Version 9.6x User’s Guide AI232 Commands: Commands Overview Commands Overview AI232 is configurable directly through the local system using shell commands or through AI198 using winslc commands and the menu system.
PAGE 175
AI232 Version 9.6x User’s Guide AI232 Commands: Commands Overview 5. At the login prompt, enter your user name. 6. At the password prompt, enter your password. Notes: ai is the default user name and password. AI232 allows only five logins using the default password. On the sixth login, AI232 will prompt you to change the default password to a new password. Keep a copy of your username and password in a safe place.
PAGE 176
AI232 Version 9.6x User’s Guide AI232 Commands: Commands Overview Using winslc Commands To use winslc commands, the user must be logged into AI198 to receive output from AI232. AI198 relays the command to AI232, which processes the command and sends the result to the system log port (as configured in AI198 Menu 1.1).
PAGE 177
AI232 Version 9.6x User’s Guide AI232 Commands: Commands Overview Table 8-1 Log/Alarm Message Header Elements (Continued) Header Element Description 081104 Specifies the current date. Sev=F Specifies the message severity level. Base=016 Specifies the line card baseport number. Msg Introduces the log/alarm message.
PAGE 178
AI232 Version 9.6x User’s Guide AI232 Commands: aaa account aaa account Description This command enables or disables TACACS+ accounting of user login events and shell command events. An accounting start packet or stop packet is issued each time a user logs into or out of AI232. An accounting start packet is also issued for each shell command that is run. Note: If enabled, accounting is performed for all shell connection types (Async, Telnet, and FTP), even if authentication is disabled.
PAGE 179
AI232 Version 9.6x User’s Guide AI232 Commands: aaa authen aaa authen Description This command enables or disables TACACS+ authentication for AI232 command shell access. TACACS+ authentication may be enabled on all connections, or on a connection type basis. By default, TACACS+ authentication is disabled on all connection types. Command Type shell Formats aaa authen { enable | disable } [ all | async | telnet | ftp ] Parameters enable Enables TACACS+ authentication.
PAGE 180
AI232 Version 9.6x User’s Guide AI232 Commands: aaa author aaa author Description This command configures the TACACS+ authorization method for the AI232 shell. The authorization method can be either privilege level or per-command. Privilege level authorization is based on the priv-lvl returned from the TACACS+ server. Per-command authorization requires AI232 to contact the TACACS+ server for each shell command run by a user. Individual commands are then allowed or denied.
PAGE 181
AI232 Version 9.6x User’s Guide AI232 Commands: aaa chpass aaa chpass Description This command changes the current user’s password on the TACACS+ server. Note: The TACACS+ server may not support, or be configured to support, password changes. Command Type shell Formats aaa chpass Examples This example displays a successful password change on a TACACS+ server.
PAGE 182
AI232 Version 9.6x User’s Guide AI232 Commands: aaa fallback aaa fallback Description This command enables or disables TACACS+ fallback for shell access. If TACACS+ fallback is enabled and attempts to contact all configured TACACS+ servers fail, then AI232’s user database is used for authentication and authorization. The AI232 local log file is used for accounting. Command Type shell Formats aaa fallback { disable | enable } Parameters disable Disables TACACS+ fallback.
PAGE 183
AI232 Version 9.6x User’s Guide AI232 Commands: aaa ppp authen aaa ppp authen Description This command enables or disables TACACS+ authentication and sets the fallback mode for specified AsyncPPP links. Note: The link type must be set to AsyncPPP for this command to have any effect. Command Type shell Formats aaa ppp authen { link_range | * } { disable | enable | fallback } Parameters link_range Defines a link or range of links. Valid values are 1 to 32.
PAGE 184
AI232 Version 9.6x User’s Guide AI232 Commands: aaa profile aaa profile Description This command associates a custom profile with a privilege level or range of privilege levels. The following rules apply: z TACACS+ privilege levels range from 0 to 15. z Custom profiles can be associated with privilege levels 2 through 14. z Privilege levels 2 through 14 default to the management system profile.
PAGE 185
AI232 Version 9.
PAGE 186
AI232 Version 9.6x User’s Guide AI232 Commands: aaa retry aaa retry Description This command configures the number of consecutive connection attempts that are made to a TACACS+ server before the attempt fails. Note: Consecutive attempts are only made if the TACACS+ server responds but refuses a connection. If no response is received from a TACACS+ server before the configured timeout period, then no further connection attempts are made.
PAGE 187
AI232 Version 9.6x User’s Guide AI232 Commands: aaa stats aaa stats Description This command displays or clears AAA specific counters and statistics. Command Type shell Formats aaa stat [ clear ] Parameters clear Clears all counters and statistics. Examples This example displays all AAA specific counters and statistics.
PAGE 188
AI232 Version 9.6x User’s Guide AI232 Commands: aaa stats 8-16 Display Item Description Authorization Attempts Displays the number of TACACS+ authorization attempts. Authorization Failures Displays the number of failed TACACS+ authorization attempts. Authorization Fallbacks Displays the number of TACACS+ authorization fallbacks, where AI232’s user database was used for authorization instead of the TACACS+ server. Accounting Attempts Displays the number of TACACS+ accounting attempts.
PAGE 189
AI232 Version 9.6x User’s Guide AI232 Commands: aaa summary aaa summary Description This command displays a summary of all authentication, authorization, and accounting settings. Command Type shell Formats aaa summary Examples This example displays a summary of all authentication, authorization, and accounting settings.
PAGE 190
AI232 Version 9.6x User’s Guide AI232 Commands: aaa summary Display Item Description FTP Access Displays the status of FTP access as AAA (TACACS+ authentication enabled) or local (TACACS+ authentication disabled). Authorization Displays the TACACS+ authorization method for the AI232 shell as Priv-lvl (based on the user’s privilege level) or Per-command (based on per-command request/reply handling).
PAGE 191
AI232 Version 9.6x User’s Guide AI232 Commands: aaa timeout aaa timeout Description This command configures the number of seconds to wait for a response from a TACACS+ server. If no response is received from the server in the allowed number of seconds, the connection attempt fails. Command Type shell Formats aaa timeout { timeout_value | default } Parameters timeout_value Defines how long (in seconds) AI232 will wait for a response from a TACACS+ server when a connection attempt is made.
PAGE 192
AI232 Version 9.
PAGE 193
AI232 Version 9.6x User’s Guide AI232 Commands: alarm Examples This example displays a list of the alarm groups and the overall alarm severity. [232] alarm Alarm Group Sev Date & Time Message (most recent, most severe in group) ----------- --- ----------- ---------------------------------------------*general 0 00-00 00:00 links 0 06-05 21:19 Link 3 up.
PAGE 194
AI232 Version 9.6x User’s Guide AI232 Commands: alarm This example displays alarms for links 5-8 in group links. [232]alarm links 5-8 Num Sev Date & Time --- --- ----------5 4 06-13 14:40 6 0 06-13 14:40 7 0 06-13 14:40 8 0 06-13 14:40 --- --- ----------'links' alarm group [232] Message -----------------------------------------Link 5 is enabled but has not come up. Link 6 up. Link 7 up. Link 8 up. -----------------------------------------severity: 4 This example displays all alarms by severity level.
PAGE 195
AI232 Version 9.6x User’s Guide AI232 Commands: alarm This example displays the prevention of alarm group links from affecting the overall alarm severity. [232]alarm -mask links Alarm group masked. [232]alarm This example displays the unmasking of alarm group links. [232]alarm -unmask links Alarm group unmasked.
PAGE 196
AI232 Version 9.6x User’s Guide AI232 Commands: arp arp Description This command displays, deletes, or adds entries in the ARP cache. Command Types shell and winslc Formats For the shell: arp -a [ ip_address ] arp -d ip_address arp -s ip_address mac_address For the winslc command: winslc baseport arp -a [ ip_address ] winslc baseport arp -d ip_address winslc baseport arp -s ip_address mac_address Parameters 8-24 -a Displays all entries in the ARP cache table or just the ip_address entry.
PAGE 197
AI232 Version 9.6x User’s Guide AI232 Commands: arp Examples This example displays all ARP cache entries. [232] arp -a Internet Address 172.16.52.16 172.16.2.9 [232] Ethernet Address 00-00-92-90-F2-D9 00-40-72-00-7F-96 Type temp temp Life 5 mins 2 mins Column Description Internet Address Displays the IP address of the destination device. Ethernet Address Displays the MAC address of the destination device. Type Displays the type of ARP cache entry as perm or temp.
PAGE 198
AI232 Version 9.6x User’s Guide AI232 Commands: arp This example displays the deletion of an ARP cache entry with IP address 172.16.30.117. [232] arp -d 172.16.30.117 Mapping for 172.16.30.
PAGE 199
AI232 Version 9.6x User’s Guide AI232 Commands: break break Description This command terminates an asynchronous or shell connection. Use command diagtconn on page 8-55 (not command who on page 8-123) when referencing connections and connection ID numbers. Note: This command only works for calls connected to the shell. CAUTION: This command operates without regard to current activity on the serial port.
PAGE 200
AI232 Version 9.6x User’s Guide AI232 Commands: break Examples This example displays the termination of a shell connection for a device with IP address 10.40.5.11 and port number 1821. [232]break 10.40.5.11#1821 Breaking connection: 10.40.5.11#1821 [232] This example displays the termination of a connection for a device with ID 65.
PAGE 201
AI232 Version 9.6x User’s Guide AI232 Commands: creset creset Description This command resets the error counters for a link or a range of links. There is no output for this command. To see if the error counters were reset for the links you specified, enter command staslc on page 8-92. Command Types shell and winslc Formats For the shell command: creset range For the winslc command: winslc baseport creset range Parameters range Defines the link or a range of links being reset.
PAGE 202
AI232 Version 9.6x User’s Guide AI232 Commands: date date Description This command sets and displays the date and the time for AI232 when it is operating in standalone mode. Command Types shell Formats date Examples This example displays the configuration of date 08-04-2005 and time 10:24:49 for AI232 in standalone mode. [232]date Today is Thursday 05-01-2004 01:09:52 Please enter the date and/or time.
PAGE 203
AI232 Version 9.6x User’s Guide AI232 Commands: debug debug Description This command enables or disables the logging of debugging data. Tip: You have to have logging turned on to view debug information from a shell connection. Command Type shell Formats debug { alias | x25 | pvcfsm | asypvcfsm | nlipvcfsm | tpifsm | modmuxfsm | allfsm | pppfsm | linkChange | bootp | all } { on | off } Parameters alias Enables or disables the logging of alias translation debugging data.
PAGE 204
AI232 Version 9.6x User’s Guide AI232 Commands: debug Examples This example displays the enabling of all debug data logging.
PAGE 205
AI232 Version 9.6x User’s Guide AI232 Commands: delete delete Description This command deletes a specified file that resides on AI232. Command Type shell Formats delete filename Parameters filename Defines the name of the file to delete. Examples This example displays the deletion of file log.txt. [232]delete log.txt Are you sure you want to delete 'log.txt'? (y/n) y log.txt deleted.
PAGE 206
AI232 Version 9.6x User’s Guide AI232 Commands: diag-conn diag-conn Description This command displays a list of enabled links along with connection information for each link. Data can be displayed continuously, one page at a time, or sent to the screen one time only for all connections. The default mode is a continuous display. Command Type shell Formats diag-conn Examples This example displays existing connections across AI232. C O N N E C T I O N S Mode: Continuous 103. ASY.1.1 113. TCP 172.16.2.
PAGE 207
AI232 Version 9.6x User’s Guide AI232 Commands: diag-conn Display Item Description D-etail This option prompts for the ID of the connection to view and displays details for that connection. F-ind This option displays specific types of connections. F-ind indicates text matches that are applied to the display lines. The matching is not case-sensitive. The logic for the matches can be AND or OR. PATTERN 1, LOGIC 2, and PATTERN 3 are evaluated before LOGIC 4 and PATTERN 5 are considered.
PAGE 208
AI232 Version 9.6x User’s Guide AI232 Commands: diag-eth diag-eth Description This command monitors and displays Ethernet diagnostic information. Using Interpretation Mode There are three levels of diagnostic information: z Minimum—Displays minimal diagnostic information (mostly the packet’s source and destination). This is the default interpretation mode setting. z Medium—Displays protocol fields that are likely to change for each packet, as well as those with values that are out of the ordinary.
PAGE 209
AI232 Version 9.6x User’s Guide AI232 Commands: diag-eth 2. Enter promiscuous to toggle between enabling and disabling promiscuous mode. Note: Operating AI232 in the promiscuous mode can reduce performance. The default setting is disabled promiscuous mode. AI232 automatically returns to the default setting (promiscuous mode disabled) when the user quits the diag-eth command. Using the Help Option To obtain command help: 1. At the prompt, enter diag-eth. 2. Enter help. The diag-eth help screen appears.
PAGE 210
AI232 Version 9.6x User’s Guide AI232 Commands: diag-eth 2. Enter go. The system starts capturing data with the user-defined settings and filters. 3. Enter stop to stop capturing data. Exiting the diag-eth Session To exit the diag-eth session, type quit. The [232] prompt appears.
PAGE 211
AI232 Version 9.6x User’s Guide AI232 Commands: diag-eth *#port_number Defines the TCP/UDP port number regardless of the MAC/IP address settings. protocol Adds or deletes a specific protocol filter. Available protocol filters are: z ip z tcp z udp z icmp z arp z osi. all Deletes all the filters or adds a filter to show all Ethernet traffic. list Lists all the filters in the system.
PAGE 212
AI232 Version 9.6x User’s Guide AI232 Commands: diag-eth This example displays Ethernet diagnostic help information. [232]diag-eth help Commands for diag-eth: interpret Turn on data interpretation. quit Exit diag-eth. help Display this help text. data Toggle uninterpreted data display. timestamp Toggle data timestamping. go Begin data capturing. stop Terminate data capturing. filter Add a data filter. promiscuous Toggle promiscuous mode for the ethernet chip.
PAGE 213
AI232 Version 9.6x User’s Guide AI232 Commands: diag-eth This example displays the diagnostic Ethernet display when the following parameters are entered: z interpret max z timestamp z z z z z to set maximum interpretation to enable timestamping promiscuous to enable promiscuous mode filter add src 172.16.2.9 to add a filter for address 172.16.2.9 data to display data go to start the data capture stop to stop capturing data. [232]diag-eth interpret max Interpretation is now set to MAXIMUM.
PAGE 214
AI232 Version 9.6x User’s Guide AI232 Commands: diag-eth This example displays the diagnostic Ethernet display when the following is entered: z filter add src 00:40:72:00:d2:d9 to configure a filter with source MAC address 00:40:72:00:d2:d9 z filter add dst 00:40:72:00:d2:d9 z address 00:40:72:00:d2:d9 go to start the capture stop to end the capture. z to configure a filter with destination MAC [232]diag-eth filter add src 00:40:72:00:d2:d9 New filter added.
PAGE 215
AI232 Version 9.6x User’s Guide AI232 Commands: diag-eth This example displays the diagnostic Ethernet display when filter display all filters. list is entered to [232]diag-eth filter list Filters currently being used by diag-eth: protocol tcp dst 00:40:72:00:d2:d9 src 00:40:72:00:d2:d9 dst 172.16.2.9 src 172.16.2.9 protocol tcp This example displays the deletion of filter protocol tcp. [232]diag-eth filter delete protocol tcp Filter 'protocol tcp' has been deleted.
PAGE 216
AI232 Version 9.6x User’s Guide AI232 Commands: diag-info diag-info Description This command displays diagnostic information for asynchronous, Ethernet, and TCP connections as well as for memory. Different screens of information can be viewed depending on the command option that is entered. The screens display the state of serial links and system updates once per second. The available display options are M, A, E, and T.
PAGE 217
AI232 Version 9.6x User’s Guide AI232 Commands: diag-info Examples This example displays diagnostic information for STREAMS allocation and memory, which are accessed by typing M.
PAGE 218
AI232 Version 9.6x User’s Guide AI232 Commands: diag-info Column Description CNT_HWM Displays the highest number of blocks allocated since AI232 was last reset. USED Displays the number of bytes currently allocated from a region. USED_HWM Displays the highest number of bytes allocated since AI232 was last reset. UNIT_SIZE Displays the size in bytes of the memory units that can be allocated. This example displays diagnostic information for asynchronous connections, which is accessed by typing A.
PAGE 219
AI232 Version 9.6x User’s Guide AI232 Commands: diag-info This example displays diagnostic information for the front panel Ethernet interface, which is accessed by typing E.
PAGE 220
AI232 Version 9.6x User’s Guide AI232 Commands: diag-info 8-48 Display Item Description Rx frames received Displays the number of frames received on the connection. Rx bytes received Displays the number of bytes received on the connection. Tx RL retry limit exceeded Displays the number of times transmitted frames exceeded the retry limit. Tx RC collisions Displays the number of transmit collisions.
PAGE 221
AI232 Version 9.6x User’s Guide AI232 Commands: diag-info This example displays diagnostic information for the Ethernet sonic chip in use on this card (SONIC0), which is accessed by typing E.
PAGE 222
AI232 Version 9.6x User’s Guide AI232 Commands: diag-info 8-50 Display Item Description crc_errors Displays the number of packets received that have had CRC errors. alignment_errors Displays the number of alignment errors. missed_packets Displays the number of missed packets. rx_buffers_exhausted Displays the number of times all receive buffers were used, but more were required. heartbeatlost Displays if there is an error between the Ethernet interface and the Ethernet transceiver.
PAGE 223
AI232 Version 9.6x User’s Guide AI232 Commands: diag-info Display Item Description state Displays the current state of the Ethernet interface. The following values may appear: z 0—The Ethernet interface is uninitialized. z 1—The Ethernet interface is idle. z 2—The Ethernet interface is active. z 3—The Ethernet interface needs to be reset. eth intr stuck Displays the number of times the Ethernet interface interrupt has stuck while servicing the interrupt.
PAGE 224
AI232 Version 9.6x User’s Guide AI232 Commands: diag-line diag-line Description This command monitors incoming and outgoing asynchronous traffic and displays diagnostic information for the traffic. A help screen provides a list of commands available for line monitoring diagnostics. CAUTION: The line monitor degrades the performance of AI232. Do not use this command in heavy traffic situations in which performance is crucial.
PAGE 225
AI232 Version 9.6x User’s Guide AI232 Commands: diag-line Table 8-2 Line Monitor Mode Options (Continued) Option Function interpret [ a | x ] Toggles the display of decoded packet data on the line monitor on or off and optionally selects the format of the data in the data portion of the packet (a or x). z a displays the data in the data portion of the packet in ASCII/hexadecimal format.
PAGE 226
AI232 Version 9.6x User’s Guide AI232 Commands: diag-line Examples This example displays a typical default line monitor display for asynchronous data.
PAGE 227
AI232 Version 9.6x User’s Guide AI232 Commands: diag-tconn diag-tconn Description This command displays a list of enabled links along with connection information for each link. It displays all connections on AI232 in the same format as command diagconn on page 8-34, but it is not interactive. Command Types shell and winslc Formats For the shell command: diag-tconn For the winslc command: winslc baseport diag-tconn Parameters baseport Defines the baseport number for AI232.
PAGE 228
AI232 Version 9.6x User’s Guide AI232 Commands: dir dir Description This command displays a list of files with associated times, dates, permissions, and sizes. Command Type shell Formats dir [ -l ] Parameters -l Displays a list of the available files and file information such as permission, time, date, and file size. The ls command with this option is the same as the dir command. Examples This example displays all available files. [232]dir boot.ini boot.img 232.img log.txt primary.
PAGE 229
AI232 Version 9.6x User’s Guide AI232 Commands: exit exit Description This command ends the current shell session and returns to the login prompt. Command Type shell Formats exit Examples This example displays an exit from the current shell session. [232]exit Writing Configuration ... Goodbye.
PAGE 230
AI232 Version 9.6x User’s Guide AI232 Commands: head head Description This command displays the first few lines of a file. Command Type shell Formats head [ -n lines ] file_name ... Parameters [ -n lines ] Defines the number of lines to display. The default is 20. file_name Defines the name of the file to display. Note: Several filenames can be entered with this command. Examples This example displays the first 30 lines of file core.txt. [232] head -n 30 core.
PAGE 231
AI232 Version 9.6x User’s Guide AI232 Commands: help help Description This command lists all available system commands or information for a specific command. Command Types shell and winslc Formats For the shell command: help [ command ] For the winslc command: winslc baseport help [ command ] Parameters baseport Defines the baseport number for AI232. command Defines the name of the command for which specific information will be displayed.
PAGE 232
AI232 Version 9.6x User’s Guide AI232 Commands: id id Description This command displays the current user name and profile. Command Type shell Formats id Examples This example displays the current user name and profile.
PAGE 233
AI232 Version 9.6x User’s Guide AI232 Commands: ip ip Description This command displays the following system settings: z IP address z Subnet mask z High IP address z Primary router IP address z Backup router IP address Command Type shell Formats ip Examples This example displays the configured IP address information. [232]ip IP Address Subnet Mask High IP Address ------------------------------------------------------010.040.057.012 255.255.000.000 010.040.057.
PAGE 234
AI232 Version 9.6x User’s Guide AI232 Commands: ip init ip init Note: This command is only valid when AI232 is in standalone mode.
PAGE 235
AI232 Version 9.6x User’s Guide AI232 Commands: ip init This example displays the configuration of all the IP settings available with this command: [232] ip init Enter IP Address (xxx.xxx.xxx.xxx):172.16.2.39 Setting IP Address to 172.16.2.39 Enter Subnet Mask (xxx.xxx.xxx.xxx):255.255.000.000 Setting Subnet Mask to 255.255.000.000 Enter Router Address (xxx.xxx.xxx.xxx):172.16.000.1 Setting Router Address to 172.16.000.1 Enter Backup Router Address (default none):172.16.2.
PAGE 236
AI232 Version 9.6x User’s Guide AI232 Commands: link link Description This command is used to: z Force a serial link to connect or disconnect Note: When this command is used to disconnect a serial link, all calls are torn down. The serial link does not come back online until command link start is issued. Important: If you are connected to the AI232 shell using a serial port, remember not to disable that port or else loss of connectivity will result.
PAGE 237
AI232 Version 9.6x User’s Guide AI232 Commands: link Examples This example displays the starting of links 1 through 4 and 6. [232]link 1-4,6 start [232] This example displays the stopping of links 6 and 8.
PAGE 238
AI232 Version 9.6x User’s Guide AI232 Commands: log log Description This command turns the display of log messages on or off. Command Type shell Formats log { on | off } Parameters on Specifies the option that turns the display of log messages on. off Specifies the option that turns the display of log messages off. Examples This example displays the current status of the log message display. [232]log Display of log messages is currently disabled.
PAGE 239
AI232 Version 9.6x User’s Guide AI232 Commands: logout logout Description This command closes a shell session. Command Type shell Formats logout Examples This example displays the closing of a shell session. [232]logout Writing Configuration ... Goodbye.
PAGE 240
AI232 Version 9.6x User’s Guide AI232 Commands: ls ls Description This command displays a list of available files. Command Type shell Formats ls [ -l ] Parameters -l Displays a list of the available files and file information such as permission, time, date, and size. Note: Entering ls with this option is the same as entering dir. Examples This example displays all available files. [232]ls boot.ini boot.img log.txt core.txt primary.
PAGE 241
AI232 Version 9.6x User’s Guide AI232 Commands: menu menu Description This command accesses the AI232 main menu system. Command Type shell Formats menu Examples This example displays the AI232 Main Menu. AI232 Main Menu + Link Menu + Alias Menu + System Menu + Static Route Menu .................................................................... : : : Select the desired menu option using the UP or DOWN arrow key. : : Then press ENTER or RETURN to continue. : :........................................
PAGE 242
AI232 Version 9.6x User’s Guide AI232 Commands: modmux modmux Description This command displays the status of links in the modem pool. Command Type shell Formats modmux Examples This example displays the status of links in the modem pool. [232]modmux Link 1: 3: 5: 6: 19: 24: 29: 30: Current Status Idle Idle Connected Idle Disabled Connected Idle Disabled Conn Up Time Init String 0:06:13 ATDT 555-1212 0:13:09 AT\n|ATDT 555-1234 [232] Column Description Link Displays link numbers.
PAGE 243
AI232 Version 9.6x User’s Guide AI232 Commands: modmux Column Description Init String Displays the phone number that was dialed. Note: This column is only displayed if the link state is Connected.
PAGE 244
AI232 Version 9.6x User’s Guide AI232 Commands: more more Description This command prints the content of a file to the current shell session one page at a time. Note: You cannot use this command to view code image files or configuration files (.img and .cnf extensions). Command Type shell Formats more filename Examples This example displays the contents of file log.txt one page at a time. [232]more log.txt 00:00:17 060100 Sev=F Msg: Starting 232 in CLC mode.
PAGE 245
AI232 Version 9.6x User’s Guide AI232 Commands: panic panic Description This command forces AI232 to crash dump and halt. Command Type winslc Formats winslc baseport panic Parameters baseport Defines the AI232 baseport number.
PAGE 246
AI232 Version 9.6x User’s Guide AI232 Commands: passwd passwd Description This command changes an existing user’s password. Command Type shell Formats passwd Note: After the initial command is entered, AI232 prompts the user for information needed to configure the new password. Examples This example displays the configuration of a new password for existing user pubs. [232]passwd Please enter the login name of the user whose password is being changed.
PAGE 247
AI232 Version 9.6x User’s Guide AI232 Commands: ping ping Description This command sends an ICMP echo request to the specified IP address. If the IP device responds to the echo request, a reply receipt message appears. If a reply is not received within 5 seconds, a no reply message appears. This command can be used to troubleshoot network level problems.
PAGE 248
AI232 Version 9.6x User’s Guide AI232 Commands: pppstatus pppstatus Description This command displays the status of all ModMux and asynchronous PPP-IPCP links. If IPCP is running on the link (the link status is RUNNING), this command also displays the local and remote IP addresses. Command Type shell Formats pppstatus Examples This example displays the status of all PPP-IPCP links. [232] pppstatus Link Phase 1: ESTABLISH 14: SERIALCONN [232] 8-76 Local IP Addr. N/A N/A Remote IP Addr.
PAGE 249
AI232 Version 9.6x User’s Guide AI232 Commands: pppstatus Column Description Local IP Addr. Displays one of the following: z The IP address of AI232 (if the link status is RUNNING) z N/A (if the link status is INITIALIZE, SERIALCONN, ESTABLISH, AUTHENTICATE, or NETWORK) Remote IP Addr.
PAGE 250
AI232 Version 9.6x User’s Guide AI232 Commands: profile profile Description This command allows a user account profile to be customized. The following six system profiles are maintained: z Supervisor z Management z Status z Empty z Destination menu z Connect Profile names are limited to 19 characters. Only 20 user configurable profiles are allowed to be configured at the same time.
PAGE 251
AI232 Version 9.6x User’s Guide AI232 Commands: profile -a Adds commands to a profile and optionally adds write permission. command Defines the name of a command to associate with a user profile. -w Adds write permission for a command that otherwise would not have write permission. -d Deletes commands from a user profile. -remove Removes a user profile. Examples This example displays each of the profile parameter options with associated functionality.
PAGE 252
AI232 Version 9.6x User’s Guide AI232 Commands: pvclist pvclist Description This command lists the PVCs in the system and displays their current state. If there are many PVCs in the system, this command redirects its output to a file named pvc.lst for easier viewing. Command Types shell and winslc Formats For the shell command: pvclist [ link_range | * ] For the winslc command: winslc baseport pvclist [ link_range ] Parameters link_range Defines a link or range of links. Valid values are 1 to 32.
PAGE 253
AI232 Version 9.6x User’s Guide AI232 Commands: pvclist Column Description Second column Displays the timer type for the PVC. Possible values are: z ct—Displays the connect timer if the PVC is active. The number indicates the timer setting in seconds. z it—Displays the inactivity timer if the PVC is a connect-onactivity PVC. The number indicates the timer setting in seconds. z Passive—Appears if the PVC is a passive type of PVC. Third column Defines the state of the PVC.
PAGE 254
AI232 Version 9.6x User’s Guide AI232 Commands: reset reset Description This command resets AI232. CAUTION: All call processing will stop and all connections will be lost during the reboot process. Command Type shell Formats reset Examples This example displays the resetting of AI232.
PAGE 255
AI232 Version 9.6x User’s Guide AI232 Commands: router router Description This command sets a default router in Menu 4.18 of the AI198 menu system. AI232 uses the default router when a static route has not been specified. Note: This address can also be set in Menu 4.2.14 of the AI198 menu system. If the address is entered in both menus, Menu 4.18 takes precedence. Command Type winslc Formats router ip_address Parameters ip_address Defines the IP address of the default router.
PAGE 256
AI232 Version 9.6x User’s Guide AI232 Commands: router Usage Notes The router address takes effect after AI232 is booted. After booting, the address no longer appears in Menu 4.18. However, the address is stored on the AI198 and can be viewed or changed in Menu 4.2.14. Note: View the router IP address with command winslc baseport show router.
PAGE 257
AI232 Version 9.6x User’s Guide AI232 Commands: selcnf selcnf Note: This command is only available for AI232 in standalone mode. Description This command has two forms: One allows for the recovery of an overwritten runtime configuration file and the other allows for the deletion of the specified configuration file. Any configuration file (with a .cnf extension) can be used for system boot up. The configuration file is written to boot.ini.
PAGE 258
AI232 Version 9.6x User’s Guide AI232 Commands: sholog sholog Description This command displays the contents of the log file. The last 32,000 characters of log messages that were sent to the log port are displayed. Note: This command has the same functionality as command show log. Command Type shell Formats sholog -p Parameters -p Displays the content of the file one page at a time. Note: This option is not available with command show log.
PAGE 259
AI232 Version 9.6x User’s Guide AI232 Commands: show show Description This command displays various types of information for AI232.
PAGE 260
AI232 Version 9.6x User’s Guide AI232 Commands: show ip Displays the IP address, subnet mask, and high IP address. router Displays the default and backup gateway IP address. version Displays the version number of AI232. date Displays the date and time. log Displays the contents of the log file, same as command sholog. crash Displays crash dump information. inventory Displays the serial number, product name, and manufacture date.
PAGE 261
AI232 Version 9.6x User’s Guide AI232 Commands: staeia staeia Description This command displays the status of the EIA leads. Command Types shell and winslc Formats For the shell command: staeia { link_range | * } For the winslc command: winslc baseport staeia { link_range | * } Parameters link_range Defines a link or range of links. Valid values are 1 to 32. Individual values are separated by commas (,) and hyphens (-). For example, 1,4-6 specifies links 1, 4, 5, and 6. * Specifies all links.
PAGE 262
AI232 Version 9.6x User’s Guide AI232 Commands: staeia 8-90 Column Description DCD DCD is an incoming EIA lead control signal. The plus symbol (+) indicates that this lead is asserted. The minus symbol (-) indicates that the lead is negated. CTS CTS is an incoming EIA lead control signal. The plus symbol (+) indicates that this lead is asserted. The minus symbol (-) indicates that the lead is negated. DTR DTR is an outgoing EIA lead control signal.
PAGE 263
AI232 Version 9.6x User’s Guide AI232 Commands: standalone standalone Description This command enables or disables standalone mode. For more information about the difference between standalone mode and switch mode, refer to Appendix B: Standalone Mode and Switch Mode. Command Type shell Formats standalone { true | false } Parameters true Puts AI232 in standalone mode. false Takes AI232 out of standalone mode. Examples This example displays the current standalone mode status.
PAGE 264
AI232 Version 9.6x User’s Guide AI232 Commands: staslc staslc Description This command displays the status of the links and the DP232 cable. Command Types shell and winslc Formats For the shell command: staslc { link_range | * } For the winslc command: winslc baseport staslc { link_range | * } Parameters 8-92 link_range Defines a link or range of links. Valid values are 1 to 32. Individual values are separated by commas (,) and hyphens (-). For example, 1,4-6 specifies links 1, 4, 5, and 6.
PAGE 265
AI232 Version 9.6x User’s Guide AI232 Commands: staslc Examples This example displays the link and cable status information for links 1 to 5. [232]staslc 1-5 Link Status Appl.
PAGE 266
AI232 Version 9.6x User’s Guide AI232 Commands: syncflash syncflash Note: This command is only available when AI232 is in standalone mode. Description This command synchronizes the AI232 configuration with the configuration information stored on AI198. Enabling this feature ensures that if AI232 is placed in standalone mode, it will operate as it did in switch mode. Command Type shell Formats syncflash { true | false } Parameters true Enables the update configuration functionality.
PAGE 267
AI232 Version 9.6x User’s Guide AI232 Commands: tacacs info tacacs info Description This command identifies how the current shell session was authenticated. If the current session was authenticated by a TACACS+ server, it will display the IP address of the server. If a TACACS+ server could not be contacted and fallback is enabled, it will display Fallback to local. If TACACS+ authentication was disabled, it will display Local.
PAGE 268
AI232 Version 9.6x User’s Guide AI232 Commands: tacacs server tacacs server Description This command enables, disables, or removes the configuration for specified TACACS+ servers. Command Type shell Formats tacacs server { server_range | * } { disable | enable | default } Parameters server_range Specifies a server number or range of server numbers. The server number represents a server’s priority level. AI232 attempts to contact all servers in the range starting with the lowest numbered ones.
PAGE 269
AI232 Version 9.6x User’s Guide AI232 Commands: tacacs server ip tacacs server ip Description This command configures an IP address for specified TACACS+ servers. Note: AI232 does not prevent users from configuring multiple server entries with the same IP address. Command Type shell Formats tacacs server ip { server_range | * } { ip_address } Parameters server_range Specifies a server number or range of server numbers. Valid values are 1 to 9.
PAGE 270
AI232 Version 9.6x User’s Guide AI232 Commands: tacacs server phase tacacs server phase Description This command configures the AAA phases that are allowed for specified TACACS+ servers. Command Type shell Formats tacacs server phase { server_range | * } { disable | enable } { account | all | authen | author } Parameters server_range Specifies a server number or range of server numbers. Valid values are 1 to 9. Individual values are separated by commas (,) and hyphens (-).
PAGE 271
AI232 Version 9.6x User’s Guide AI232 Commands: tacacs server phase Examples This example displays the disabling of the accounting phase for servers 1 to 5 and 8.
PAGE 272
AI232 Version 9.6x User’s Guide AI232 Commands: tacacs server port tacacs server port Description This command configures the TCP port number for specified TACACS+ servers. Command Type shell Formats tacacs server port { server_range | * } { port_number } Parameters server_range Specifies a server number or range of server numbers. Valid values are 1 to 9. Individual values are separated by commas (,) and hyphens (-). For example, 1,4-6 specifies servers 1, 4, 5, and 6.
PAGE 273
AI232 Version 9.6x User’s Guide AI232 Commands: tacacs server secret tacacs server secret Description This command configures the TACACS+ shared secret, which is similar to a password, for specified TACACS+ servers. Command Type shell Formats tacacs server secret { server_range | * } { shared_secret } Parameters server_range Specifies a server number or range of server numbers. Valid values are 1 to 9. Individual values are separated by commas (,) and hyphens (-).
PAGE 274
AI232 Version 9.6x User’s Guide AI232 Commands: tacacs server summary tacacs server summary Description This command displays a summary of TACACS+ server configuration settings for specified servers. Command Type shell Formats tacacs server summary [ server_range | * ] Parameters server_range Specifies a server number or range of server numbers. Valid values are 1 to 9. Individual values are separated by commas (,) and hyphens (-). For example, 1,4-6 specifies servers 1, 4, 5, and 6.
PAGE 275
AI232 Version 9.6x User’s Guide AI232 Commands: tacacs server summary Display Item Description Port Displays the configured TACACS+ port numbers for the specified TACACS+ servers. Secret Displays the TACACS+ shared secrets (passwords) for specified TACACS+ servers. Phases Displays the AAA phases that are allowed for specified TACACS+ servers.
PAGE 276
AI232 Version 9.6x User’s Guide AI232 Commands: tacacs sholog tacacs sholog Description This command displays the contents of the TACACS+ debug log file. The TACACS+ debug log file records all connection attempts to TACACS+ servers. The following information is displayed for each connection attempt: z A record of the timestamp z The IP address of TACACS+ server z The AAA phase z The success or failure status associated with each connection.
PAGE 277
AI232 Version 9.6x User’s Guide AI232 Commands: tacacs stats tacacs stats Description This command displays or clears TACACS+ specific counters and statistics. Command Type shell Formats tacacs stats [ clear ] Parameters clear Clears all TACACS+ specific counters and statistics. Examples This example displays all TACACS+ specific counters and statistics.
PAGE 278
AI232 Version 9.6x User’s Guide AI232 Commands: tacacs stats 8-106 Display Item Description Wrong Header Sequence Number Displays the number of packets received from the TACACS+ server that had a sequence number that was out of order. Wrong Header Session ID Displays the number of packets received from the TACACS+ server that had an invalid session ID.
PAGE 279
AI232 Version 9.6x User’s Guide AI232 Commands: tail tail Description This command displays the last few lines of a file. Command Type shell Formats tail [ -n lines ] file_name ... Note: More than one file name can be specified in this command. Parameters -n Specifies that a line number value will be entered. lines Defines the number of lines to display. The default is 20. file_name Defines the name of the file to display. Examples This example displays the last 20 lines of file log.txt.
PAGE 280
AI232 Version 9.6x User’s Guide AI232 Commands: tcpoutconn tcpoutconn Description This command controls how long outgoing TCP connections wait for a connection to be established before failing. Command Type shell and winslc Formats For the shell command: tcpoutconn [ timeout ] For the winslc command: winslc baseport tcpoutconn [ timeout ] Parameters timeout Defines the length of the timeout. The range is 2 to 360 seconds. The default is 75. baseport Defines the baseport number for AI232.
PAGE 281
AI232 Version 9.6x User’s Guide AI232 Commands: telnet telnet Description This command changes the port number used to receive incoming telnet connections from default port 23. Important: This command must be executed from CLC Menu 4.18 in the AI198 menu system. When AI232 is booted, Menu 4.18 entries are no longer visible. To see the current telnet port number after AI232 is booted, use the winslc telnet command.
PAGE 282
AI232 Version 9.6x User’s Guide AI232 Commands: tftp tftp Note: This command is only available when AI232 is in standalone mode. Description This command downloads a file from the Trivial File Transfer Protocol (TFTP) server to AI232 or uploads a file to the TFTP server from AI232. The following rules apply when uploading or downloading a file: z File names must contain an extension of .ini, .img, .zmg, .cnf, or .txt. z Configuration files can be downloaded directly to file primary.
PAGE 283
AI232 Version 9.6x User’s Guide AI232 Commands: tftp dest_filename Defines the name of the source file after it has been downloaded from or uploaded to the server. If no destination file name is specified, the file will have the same name as the source file. Note: The destination file name cannot contain spaces or special characters. Examples This example displays the upload of file primary.cnf to file secondary.cnf on TFTP server 10.34.6.13. [232] tftp put 10.34.6.13 primary.cnf secondary.
PAGE 284
AI232 Version 9.6x User’s Guide AI232 Commands: tftpboot tftpboot Description This command displays the BOOTP/TFTP status or aborts attempts to contact the BOOTP server. The AI232 card attempts to contact a BOOTP server if certain conditions are met. These conditions are: z The card is in standalone mode. AND z The card does not have an IP address set or no BOOT.INI file exists.
PAGE 285
AI232 Version 9.6x User’s Guide AI232 Commands: tftpboot This example displays the result of a card booting when no BOOTP or TFTP server is on the net. [232] tftpboot Usage: tftpboot [abort] Displays BOOTP/TFTP status or aborts retry attempts. Waiting for a response from the BOOTP server. [232] tftpboot abort BOOTP/TFTP retry attempts will be aborted.
PAGE 286
AI232 Version 9.6x User’s Guide AI232 Commands: timezone timezone Note: This command is only available when AI232 is in standalone mode. Description This command displays or changes the time zone or adjusts the time to reflect daylight savings. Command Type shell Formats timezone [ -dston | -dstoff ] [ { + | - } hh:mm ] Parameters -dston Enables daylight savings time for AI232. -dstoff Disables daylight savings time for AI232.
PAGE 287
AI232 Version 9.6x User’s Guide AI232 Commands: timezone This example displays the enabling of daylight savings time and the setting of the timezone to -5:00.
PAGE 288
AI232 Version 9.6x User’s Guide AI232 Commands: type type Description This command displays the text of any file other than a code image or configuration file. Note: This command has the same functionality as command cat. Command Types shell Formats type [ -p ] filename Parameters -p Displays text from the file one page at a time. filename Defines the file for which you want to view the contents. Examples This example displays the first page of contents for file log.txt. [232]type -p log.
PAGE 289
AI232 Version 9.6x User’s Guide AI232 Commands: update update Description This command displays information about the image and configuration files. When entered with arguments, this command updates AI232 software. Update the software by copying a new image or configuration file to a destination file.
PAGE 290
AI232 Version 9.6x User’s Guide AI232 Commands: uptime uptime Description This command displays the current time and the amount of time AI232 has been running since it was last booted. Command Type shell Formats uptime Examples This example displays the current time and the amount of time AI232 has been running since it was last booted.
PAGE 291
AI232 Version 9.6x User’s Guide AI232 Commands: useradd useradd Description This command adds a username and password. When the user first logs into AI232, the login name and password are both ai by default. Five grace logins are available before a username and password must be configured. A total of ten users can be added to the database. Command Type shell Formats useradd [ -profile_name ] [ username ] Parameters profile_name Assigns a permission to a username. Table 8-3 describes the permissions.
PAGE 292
AI232 Version 9.6x User’s Guide AI232 Commands: useradd Table 8-3 Description of Permissions (Continued) profile_name Permission status Specifies a user who can only execute the following commands: z z z z z z z z z z z z z z creset debug diag-conn diag-info diag-eth diag-tconn help ip menu ping pvclist show staeia staslc dest Specifies a user who can login into AI232 and access the destination menu. The user cannot connect to destination ai to retrieve status or to change the configuration.
PAGE 293
AI232 Version 9.6x User’s Guide AI232 Commands: userdel userdel Description This command deletes a username and password from the database. Command Type shell Formats userdel Examples This example displays the deletion of user brian from the database. After the command is initially entered, prompts appear that tell the user what information needs to be entered. [232] userdel Please enter the login name of the user to DELETE. newguy Delete user "newguy"? (y/n) y User "newguy" deleted successfully.
PAGE 294
AI232 Version 9.6x User’s Guide AI232 Commands: users users Description This command displays currently configured AI232 users with the associated profile names and destinations. Command Types shell Formats user Examples This example displays all currently configured AI232 users with associated profile names and destinations. In this case, pubs is the only configured user.
PAGE 295
AI232 Version 9.6x User’s Guide AI232 Commands: who who Description This command displays the users currently logged into AI232. It displays the user name, time of login, user ID, the source of the connection, and command currently being used by each user. The destination is shown only if the user has connected to an alias with the destination menu. Important: Do not use the ID displayed with this command to break a connection.
PAGE 296
AI232 Version 9.6x User’s Guide AI232 Commands: xon-interval xon-interval Description This command adjusts the amount of time between consecutive Xons. If inbound flow control is enabled on an asynchronous link, AI232 transmits Xons at regular intervals. Command Type winslc Formats winslc baseport xon-interval link seconds Parameters baseport Defines the baseport number for AI232. link Defines the link number to adjust the XON interval. Valid values are 1 to 32.
PAGE 297
A AI232 Crash Codes This appendix provides information about AI232 crash codes.
PAGE 298
AI232 Version 9.6x User’s Guide AI232 Crash Codes: Crash Codes Crash Codes Crash codes report to the log port when a card crashes and you receive an AIswitch fault message. This message indicates that the system has detected a serious hardware or software fault. Common Crash Codes These codes are common to all software (not just AI products). The first column of Table A-1 displays the hexadecimal code for the error message. The second column displays the decimal value for the same message.
PAGE 299
AI232 Version 9.6x User’s Guide AI232 Crash Codes: Crash Codes AI232 Crash Codes Table A-2 displays crash codes that are specific to AI232. Contact AI Technical Support to report any of the following crash codes. Table A-2 AI232 Crash Codes Error Code Hexadecimal Error Code Decimal Description 0020 32 Specifies a failure to free resource (streams). 0021 33 Specifies a failure to free memory (system). 0022 34 Specifies a failure of resource allocation (streams).
PAGE 300
AI232 Version 9.6x User’s Guide AI232 Crash Codes: Crash Codes Table A-2 AI232 Crash Codes (Continued) Error Code Hexadecimal Error Code Decimal 00AA 170 Specifies a serious memory error (unable to allocate system memory). 00AC 172 Specifies that a serial communication controller is not responding. 00AD 173 Specifies a software download. This is normal to see when doing a software update to AI232.
PAGE 301
AI232 Version 9.6x User’s Guide AI232 Crash Codes: Kentrox Technical Support Kentrox Technical Support Some alarm conditions and crash codes reveal serious problems for which you should contact Kentrox Technical Support. If one of these alarm conditions or crashes should occur, record relevant information associated with the problem and contact Kentrox Technical Support.
PAGE 302
AI232 Version 9.
PAGE 303
B Standalone Mode and Switch Mode This appendix provides information about standalone and switch mode for AI232.
PAGE 304
AI232 Version 9.6x User’s Guide Standalone Mode and Switch Mode: Standalone Mode Standalone Mode Standalone mode refers to the mode where AI232 stores its configuration locally (to flash) or on a TFTP server. The CLC might be used as the TFTP server in some cases. This lets the card operate as a self-contained unit. When operating in standalone mode, AI232 has a local menu system that is used instead of the AI198 menu system for tasks such as alias and IP configuration.
PAGE 305
AI232 Version 9.6x User’s Guide Standalone Mode and Switch Mode: Standalone Mode 6. Exit the FTP utility. 7. Login to the shell with a serial or Telnet connection. 8. Update the existing boot program image with the new software image file: update imagename.img boot.img imagename Defines the software image file name. 9. When the update is complete, reboot AI232.
PAGE 306
AI232 Version 9.6x User’s Guide Standalone Mode and Switch Mode: Switch Mode Switch Mode Switch mode refers to the mode where AI232 is managed by the CLC. When AI232 is in switch mode, the AI198 menu system must be used to configure IP addresses, aliases, IP static routes, and SNMP traps. AI232 must be located in the AI130 or AI180 chassis to operate in switch mode.
PAGE 307
AI232 Version 9.6x User’s Guide Standalone Mode and Switch Mode: Switch Mode 6. Exit the FTP utility. 7. Log in to AI198. 8. At the command prompt, update AI232 with the new software image: winslc baseport update baseport Defines the baseport of AI232. Note: You can watch the download process by entering CTRL+L. 9. Wait for the completion message.
PAGE 308
AI232 Version 9.
PAGE 309
C Commands for AI232 TACACS+ Server Enhancements This appendix provides a list of commands that users need when configuring a TACACS+ server to utilize AI232’s authorization enhancements.
PAGE 310
AI232 Version 9.6x User’s Guide Commands for AI232 TACACS+ Server Enhancements: AI232 Commands AI232 Commands Important: To authorize a command with no additional arguments, remember to enter permit ^$ in the argument list.
PAGE 311
AI232 Version 9.6x User’s Guide Commands for AI232 TACACS+ Server Enhancements: AI232 Menu Aliases AI232 Menu Aliases The following AI232 menu aliases can be included in an authorization set on the TACACS+ server. Authorization occurs when level 1 menu items are traversed: menu Provides access to the menu. menu_link Provides read access to the link menu. menu_link write Provides write access to the link menu. menu_alias Provides read access to the alias menu.
PAGE 312
AI232 Version 9.6x User’s Guide Commands for AI232 TACACS+ Server Enhancements: FTP Sessions FTP Sessions The following AI232 keywords apply to FTP access: C-4 ftplogin Provides FTP read access. ftpwrite Provides FTP write access.
PAGE 313
Acronyms and Abbreviations Table 1 Acronyms and Abbreviations Acronym Meaning ABR Area Border Router ACK Acknowledgement (positive) ACTA Administrative Council for Terminal Attachments AEP Applied Innovation Encapsulation Protocol AEPN Applied Innovation Encapsulated Protocol with the Network option AI Applied Innovation Inc.
PAGE 314
Acronyms and Abbreviations Table 1 Acronyms and Abbreviations (Continued) Acronym Meaning BGP Border Gateway Protocol BOC Bell Operating Company BPDU Bridge Protocol Data Unit BRI Basic Rate Interface C Common CAAML Centralized Autonomous AI Message Logging CALLA Call Accepted Packet CALLC Call Connected Packet CALLR Call Request Packet CCI Command and Control Interface CCITT Consultative Committee on International Telegraphy and Telephony CD Carrier Detect CEV Controlled Environ
PAGE 315
Acronyms and Abbreviations Table 1 Acronyms and Abbreviations (Continued) Acronym Meaning CRT Cathode Ray Tube CSU Channel Service Unit CTS Clear to Send CUD Call User Data DAD Data Acquisition Device DCD Data Carrier Detect DCE Data Circuit Terminating Equipment or Data Communication Equipment DCN Data Communications Network DD Database Description DHCP Dynamic Host Configuration Protocol DLC Data Link Control DLCI Data Link Connection Identifier (Information) DNS Domain Name Se
PAGE 316
Acronyms and Abbreviations Table 1 Acronyms and Abbreviations (Continued) Acronym Meaning ES End System ESD Electrostatic Discharge ES-IS End System to Intermediate System EST Eastern Standard Time FCC Federal Communications Commission FDM Frequency Division Multiplexing FDX Full Duplex FGND Frame Ground FIC Faculty Interface Code FOC Fiber Optics Communications FTAM File Transfer, Access, and Management FTP File Transfer Protocol GMT Greenwich Mean Time GRE Generic Routing Enc
PAGE 317
Acronyms and Abbreviations Table 1 Acronyms and Abbreviations (Continued) Acronym Meaning IRB Inter-repeater Bus IS Intermediate System ISDN Integrated Services Digital Network IS-IS Intermediate System to Intermediate System ISO International Standards Organization ISP Internet Service Provider ITU International Telecommunication Union IXE IP Protocol over X.
PAGE 318
Acronyms and Abbreviations Table 1 Acronyms and Abbreviations (Continued) Acronym Meaning MMF Multimode Fiber Optic Cable MSDP Multicast Source Discovery Protocol MUX Multiplexer NAK Negative Acknowledgment NC Normally Closed NCP Network Control Protocol NE Network Element NEBS Network Equipment Building System NEC National Electrical Code NI Network Interface NLPID Network Layer Protocol Identifier NMS Network Management System NO Normally Opened NOC Network Operations Center
PAGE 319
Acronyms and Abbreviations Table 1 Acronyms and Abbreviations (Continued) Acronym Meaning OSS Operating Support System PAD Packet Assembler Disassembler PAP Password Authentication Protocol PBX Private Branch eXchange PC Personal Computer PDU Protocol Data Unit PID Private ID or password PMC PCI Mezzanine Card POTS Plain Old Telephone Service PPP Point-to-Point Protocol PRI Primary Rate Interface PROM Programmable Read Only Memory PSI Pounds per Square Inch PUC Public Utility C
PAGE 320
Acronyms and Abbreviations Table 1 Acronyms and Abbreviations (Continued) Acronym Meaning RDP Router Discovery Protocol REN Ringer Equivalence Number RF Radio Frequency RIP Routing Information Protocol RMON Remote Network Monitoring Specification ROM Read Only Memory RTS Request to Send RXD Receive Data SAM Serial Alarm Module SAP Service Advertisement Protocol SCC Specialized Common Carrier SCCS Switching Center Control System SCID SONET Circuit ID SDH Synchronous Digital Hier
PAGE 321
Acronyms and Abbreviations Table 1 Acronyms and Abbreviations (Continued) Acronym Meaning SPF Shortest Path First SQL Structured Query Language STP Shielded Twisted Pair STP Spanning Tree Protocol SVC Switched Virtual Connection TACACS Terminal Access Controller Access System TARP TID Address Resolution Protocol TBOS Telemetry Byte Oriented Serial TCP Transmission Control Protocol TCP/IP Transmission Control Protocol over Internet Protocol TCP/UDP User Datagram Protocol TDM Time Di
PAGE 322
Acronyms and Abbreviations Table 1 Acronyms and Abbreviations (Continued) Acronym Meaning UTP Unshielded Twisted Pair VC Virtual Channel VLAN Virtual LAN VPN Virtual Private Network VRRP Virtual Router Redundancy Protocol VT Virtual Terminal WAN Wide Area Network WINSLC Window to a Smart Line Card XKMS XML Key Management Specification XNS Xerox Network Services ZIP Zone Information Protocol Acronyms-10