AIconnect TM Multi-Purpose, Modular Application Line Card Command Reference Guide

Transcription

1 AIconnect TM Multi-Purpose, Modular Application Line Card Command Reference Guide Part Number CG-CON Rev by Kentrox, Inc. All rights reserved.

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. Information published here is current as of this document s date of publication, but is subject to change without notice. You may verify product information by contacting our headquarters in Oregon. Kentrox is an Equal Opportunity/Affirmative Action employer. Kentrox, Inc Innovation Dr. Dublin, Ohio USA Toll Free: (800) International: +1 (614) Fax: +1 (614) NW Tanasbourne Dr. Hillsboro, Oregon USA Toll Free: (800) Direct: (503)

3 About this Document This document provides a reference for all the commands in the AIconnect multi-purpose, modular application line card command line interface (CLI). You should have a working knowledge of the following: Telecommunications networks, system architecture, and network topology Network devices FTP tools DHCP Iptables Radius and/or TACACS+ NTP Bootp/DHCP relay VRRP (standby groups) SNMP i

4 AIconnect Command Reference Guide About this Document: Document Conventions Document Conventions Table 1 describes the text conventions used in this document. Table 1 Document Conventions Convention Screen Text, Menu Items, System Prompts, Messages and Reports Static Command Text Variable Command Text Meaning This style indicates configuration screen text, menu items, system prompts, messages, and reports. In a command statement, this style indicates text that should be entered exactly as shown at a command line. In a command statement, this style indicates user-specified text.... In a command statement, ellipses (...) signify that the preceding parameter can be repeated a number of times. [ ] [ ] In a command statement, square brackets indicate an optional parameter. Two or more parameters in square brackets with a vertical bar ( ) between them indicate a choice of optional parameters. { } In a command statement, two or more parameters in braces with a vertical bar ( ) between them indicate a choice of required parameters. Menus and Menu Commands Dialog Boxes, Tabs, Fields, Check Boxes, and Command Buttons Variable Field Text KEYS Labels This style indicates menu and menu commands. A vertical bar ( ) separates the menus from the submenus or menu commands. The vertical bar also indicates the order in which you should click the menus, submenus, and menu commands. This style indicates dialog boxes, tabs, fields, check boxes, and command buttons. This style indicates variable information you type in a dialog box field. Uppercase body text indicates keys on a keyboard, such as the TAB or ENTER keys. Keys used in combination are connected with a plus symbol (+). This style designates physical components on Kentrox products such as jumpers, switches, and cable connectors. ii

5 AIconnect Command Reference 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. Caution messages indicate that failure to take a specified action could result in loss of data and/or harm to the software or hardware. Warning messages indicate that failure to take a specified action could result in physical harm to the user. Laser danger messages indicate that failure to take a specified action could result in eye damage or blindness to the user due to overexposure to invisible laser radiation. iii

6 AIconnect Command Reference Guide About this Document: Using this Document Using this Document The following information about commands is provided in this document: Formats Parameters Command Defaults Required User Profiles Examples See Also This section includes a detailed description of the command. Formats This section lists all valid format statements for the command. For example, the config timeout command has three valid formats: config timeout minutes config default timeout config no timeout The config, timeout, default, and no parameters, which are shown in bold command font, are all commands or static parameters. Enter these values exactly as shown in the format statements. The minutes parameter, which is shown in italicized command font, is a variable parameter. Substitute the amount of time that can elapse before a AIconnect session expires for this variable parameter. Parameters This section lists and describes possible parameters for the command. Valid values for each parameter are also provided, if applicable. Command Defaults This section provides the default values of the command, if applicable. Required User Profiles This section lists the user profiles needed to execute the command. Examples This section provides screen captures depicting actual command executions. An explanation of each example is provided. iv

7 AIconnect Command Reference Guide About this Document: Using this Document See Also This section lists commands that you may want to reference while executing the command. For example, if you plan to use the config timeout command to configure the session timeout, you may want to use the show timeout command to display the existing session timeout value. v

8 AIconnect Command Reference Guide About this Document: Customer Assistance Customer Assistance Kentrox offers technical support 24 hours a day, seven days a week. Before you contact Kentrox for assistance, please have the following information available: The type of hardware and software you are using The error number and exact wording of any messages that appeared on your screen What happened and what you were doing when the problem occurred How you tried to solve the problem Web Site Support Support is available 24 hours a day using our Web site at: Support support is available 24 hours a day. When you use support, please be sure to include the details of your problem within the . To contact Technical Support, send to: techsupport@aiinet.com Phone Support Phone support is available. When you call Kentrox for support, please be sure you are at your computer and have the details of your problem available. To contact Technical Support, call (866) Kentrox Product Documentation To order documentation, please contact your sales representative at (800) or +1 (614) You can also access and view the most current versions of Kentrox product documentation on our Web site at: vi

9 Using the CLI..... Using the CLI This section explains the structure and use of the CLI. It also explains the CLI navigation keys and methods, as well as the available help screens. Command Types There are four groups of AIconnect commands:! Configuration Commands! Diagnostic Commands! Show Commands! Utility Commands Configuration Commands Configuration commands set up AIconnect. They usually require parameters and generally have default values. To specify configuration, use command config. For example, enter config users add with the following specifications to add a new AIconnect user:! User name userb! Profile supervisor! Password secretword (AI)>config users add userb supervisor secretword secretword (AI)> Diagnostic Commands Diagnostic commands display system-wide diagnostics. They can display information about logged in users and running processes. To specify AIconnect diagnostics, use command diag. For example, enter diag who to display all users logged into AIconnect. (AI)>diag who ai ttyp1 Jan 19 17:51 ( ) brb22 ttyp2 Jan 19 21:01 ( ) (AI)> AIconnect Command Reference Guide 1

10 Using the CLI Show Commands Show commands display options, statuses, and settings. They do not have default values and generally only require optional parameters. To use show commands, enter command show. For example, enter command show interfaces to display all configured interfaces. (AI)>show interfaces ethernet 0/1 system-name=eth0_1 status=enabled link-state=up address= /16 ethernet 0/2 system-name=eth0_2 status=enabled link-state=down address= /16 ethernet 0/3 system-name=eth0_3 status=enabled link-state=down address= /16 secondary-address= /16 serial 1/1 channel-group=ds0group1 system-name=ser1_1_0 status=enabled link-state=down desc=s1/1 serial 1/2 channel-group=ds0group2 system-name=ser1_2_1 status=enabled link-state=down address= pointopoint= serial 1/3 channel-group=ds0group3 system-name=ser1_3_2 status=enabled link-state=down address= pointopoint= (AI)> Utility Commands Utility commands handle administrative tasks such as copying files, displaying the running configuration, and logging out of AIconnect. All are executable from any level of the CLI. For example, enter trace-route from the interface configuration level to view a traceroute to an address. (AI) config interface ethernet 0/2>trace-route traceroute to ( ), 30 hops max, 40 byte packets ( ) ms ms ms (AI) config interface ethernet 0/2> 2 AIconnect Command Reference Guide

11 Using the CLI..... CLI Navigation and Command Entry Specific keys can be used to navigate backward or forward in the CLI, edit command line entries, or execute command entry shortcuts. Navigation Keys Navigation keys and key combinations are available for quickly moving backward and forward through the CLI. Those that are available for AIconnect appear in Table 1. Table 1 CLI Keystrokes Key Combinations DELETE or BACKSPACE CTRL+a CTRL+e RIGHT ARROW or CTRL+f LEFT ARROW or CTRL+b CTRL+d CTRL+u CTRL+k CTRL+t UP ARROW or CTRL+p DOWN ARROW or CTRL+n CTRL+z TAB exit Action Deletes a previous character. Places the cursor at the beginning of a line. Places the cursor at the end of a line. Moves forward one character. Moves backward one character. Deletes the current character. Deletes the entire line. Deletes to the end of the line. Reverses the order of the current character and the previous character. Moves to the previous line in the history buffer. Moves to the next line in the history buffer. Returns to the root command prompt. Completes the command line entry. Moves to next higher level in the CLI.? Displays related command choices and command usage statements. " Note: Some key combinations might not be available for all types of terminal emulation software. AIconnect Command Reference Guide 3

12 Using the CLI TAB Key The TAB key lets you quickly enter words in a command without typing the full command name. For example, to enter the config command, you can type the first three letters and press TAB to see the entire command name. " Note: For TAB completion to work correctly, enter a unique character set so that the CLI can distinguish the desired command name from other possible command names. When pressed twice at a stopping point, the TAB key displays a list of all commands available from the stopping point along with all available global commands. (AI) config interface ethernet 0/0> description enable no disable ip standby Global Commands config erase logout show copy exit ping telnet debug halt reload trace-route diag help running-config (AI) config interface ethernet 0/0> Parameter Values with Spaces Use quotes to enclose command parameters that contain a space or spaces. " Note: This applies only to parameters that accept alphanumeric values. For example, parameter secret word in command config ras server will generate an error if it is not enclosed in quotes. (AI)>config ras server secret secret word [UCLI0032] Error unknown command "word". (AI)>config ras server secret "secret word" (AI)> " Note: AIconnect accepts either single quotes ( ) or double quotes ( ) for enclosing parameters. 4 AIconnect Command Reference Guide

13 Using the CLI..... Abbreviated Command Entry The CLI recognizes commands by the first few characters entered in the command name. AIconnect recognizes the unique abbreviated entry and executes the command exactly as if it had been entered fully. For example, enter sh us as an abbreviated form of command show users to display all configured AIconnect users. (AI)>sh us Login Name Profile 1. techcomm supervisor 2. userb supervisor (AI)> " Note: Optional parameter names required by some commands can also be abbreviated. Use of abbreviated interface parameter names is also allowed. In the following example, a user configures an Ethernet interface in slot 0/port 0. (AI)>con int eth 0/0 (AI) config interface ethernet 0/0> Command Help Command help is available for navigating the CLI command hierarchy and for assistance with specific commands. Enter help or? for command help. Help Enter help to see the basic AIconnect help information. The following example displays the help screen. (AI)>help You can request help for a command at any time by entering a question mark ('?'). The '?' displays the following types of information for commands and/or command inputs: - Usage statements - Available subcommands - Matching commands for partial inputs - Available local and global commands The type of information displayed depends on where you enter the '?'. For more information on using help, refer to the command reference guide. (AI)> AIconnect Command Reference Guide 5

14 Using the CLI? Help Command The? displays information for individual commands and command inputs. Displaying Command Usage Statements Use the? directly following a command name to display that command s usage statement. For example, enter config interface? at the main prompt to display the following usage statement. (AI)>config interface Usage: interface { ethernet 0/<port number> serial <slot number>/<port number> } no interface { ethernet 0/<port number> ethernet * serial <slot number>/<port number> serial * * } ethernet Configures Ethernet interfaces. 0 Slot number <port number> Port location for the interface Port number labels are on the front panel. The IRB is port 0. serial Configures serial interfaces. <slot number> Slot location for the interface Valid Values: 1 specifies that the interface is located in PMC slot 1. 2 specifies that the interface is located in PMC slot 2. no Initiates the deletion of one or more interfaces from the configuration. * Deletes all interfaces of a specified type or all interfaces from the configuration. (AI)>config interface Displaying Available Subcommands Use the? after a command that requires subcommands to display all its corresponding subcommands. There must be a space between the? and the preceding command name. " Note: A + after a command specifies that a subcommand is required. For example, enter show ip? to list all subcommands under show ip. (AI)>show ip Commands (AI)>show ip arp domain-name forward name-server route Displays the ARP cache. Displays the domain name. Displays the state of IP forwarding. Displays DNS servers. Displays routes. 6 AIconnect Command Reference Guide

15 Using the CLI..... Displaying Matching Commands for Partial Inputs Use the? at any point in a partially entered command to display a list of matching command names. For example, enter i? at the prompt after command config to display all commands that begin with i and can be entered at the prompt. (AI)>config i Commands (AI)>config i interface(+) ip(+) iptables irb-combine Configures an interface. Configures IP settings. Configures IP tables. Combines or splits the IRB and interface Ethernet 0/3. Displaying Available Local and Global Commands Enter a? at a stopping point to display a list of local commands that can be issued from that stopping point. (AI) config interface ethernet 0/0 ip -> Commands address Configures the IP address for an interface. no Negates an IP configuration command for an interface. Enter? to see available global commands. (AI) config interface ethernet 0/0 ip -> AIconnect Command Reference Guide 7

16 Using the CLI Enter another? from the stopping point to display a list of all global commands. (AI) config interface ethernet 0/0 ip -> Global Commands config(+) Configures parameters. copy Creates a copy of a configuration file. debug(+) Enables or disables session log output. diag(+) Displays system diagnostics. erase Erases (removes) a configuration file. exit Exits up one level in the command hierarchy. halt Shuts down the system. help Describes how to access help. logout Logs out and terminates the session. ping Tests network connectivity to a remote host. reload Resets the system. running-config Displays the current operating configuration. show(+) Displays parameters. telnet Establishes a Telnet session. trace-route Traces network routing to a remote host. (AI) config interface ethernet 0/0 ip -> 8 AIconnect Command Reference Guide

17 config banner..... config banner This command configures the banner for AIconnect. The banner appears when connecting to AIconnect. Formats config banner delimiting_character config default banner Parameters delimiting_character default Defines the beginning and ending of the banner. Most characters, such (, ), #, ~, %, and *, can be applied as the delimiting character. Important: Do not use the following characters for the delimiting character: d, s, l, m, n, o, r, t, u, U, V,,, and \ Resets the banner to the default AI banner. This command accepts escape codes that are used to include variable text within the banner. For more information on the escape codes, refer to Table 2. Table 2 Escape Codes Codes s \d Includes the current date in the banner. \s Includes the name of the operating system in the banner. \l Includes the name of the logical terminal from which the user is operating. \m Includes the architecture of the system (for example, i686), in the banner. \n Includes the host name of the system (for example, localhost) in the banner. \o Includes the domain name of the system in the banner. \r Includes the release number of the Linux kernel in the banner. \t Includes the current time in the banner. \u Includes the number of users currently logged into AIconnect in the banner. AIconnect Command Reference Guide 9

18 config banner Table 2 Escape Codes (Continued) Codes s \U Includes the number of users currently logged into AIconnect with the addition of the words user or users (for example, 10 users) following the number in the banner. \v Includes the build date of the Linux kernel in the banner. Command Default AI banner. _ / Applied Innovation Inc. _ / _ _ AIconnect login: Required User Profiles management, supervisor Examples This example displays the configuration of the delimiting character as #, the banner text as This is my banner., the current date (\d), and the time (\t). (AI)>config (AI) config>banner # Enter the banner text. End the banner with a # character. This is my banner. \d \t # (AI) config> See Also show banner 10 AIconnect Command Reference Guide

19 config bootp..... config bootp This command enables or disables the BOOTP protocol on AIconnect. When the BOOTP protocol is enabled, AIconnect obtains its IP address from a BOOTP server and the BOOTP server sends AIconnect the IP address of the TFTP server. AIconnect then contacts the TFTP server and automatically downloads its configuration. When the BOOTP protocol is disabled, AIconnect does not contact the TFTP server to download its configuration. Important: When configuring a remote BOOTP server (BOOTP server that is not an AI198 common logic controller), locate and use the MAC address listed on the sticker affixed to the AIconnect motherboard as the MAC address for interface Ethernet 0/0 (for example, 00:40:72:01:62:00). Add 1 to this address for interface Ethernet 0/1 (for example, 00:40:72:01:62:01). Add 2 to this address for interface Ethernet 0/2 (for example, 00:40:72:01:62:02). Add 3 to this address for interface Ethernet 0/3 (for example, 00:40:72:01:62:03). Tip: In many cases, AI198 acts as the TFTP server for AIconnect. In this situation, the AIconnect configuration must be saved to AI198 (using command copy on page 78) before AIconnect is hot-swapped. AIconnect is not supported by all versions of AI198. AIconnect cannot be hot-swapped when the BOOTP protocol is disabled. Formats config bootp { disable enable } Command Default Disabled Required User Profiles management, supervisor Example This example displays the enabling of the BOOTP protocol on AIconnect. (AI)>config (AI) config>bootp (AI) config bootp>enabling (AI) config bootp> AIconnect Command Reference Guide 11

20 config bootp See Also show bootp 12 AIconnect Command Reference Guide

21 config clock..... config clock This command configures clock settings for AIconnect. Formats config clock daylight-savings ds_string config clock no daylight-savings config clock local-time { hh:mm:ss MM/DD/YYYY hh:mm:ss MM/DD/YYYY } config clock timezone timezone_string hh_offset:mm_offset Parameters daylight-savings ds_string no local-time Enables or disables daylight savings and assigns text to be displayed when the first daylight savings clock adjustment takes place. Daylight savings time is when clocks are set ahead one hour the first Sunday in April and back one hour the last Sunday in October to provide an extra hour of daylight during summer. The default is disabled daylight savings time. Defines a name (up to 10 alphabetic characters) to be displayed when daylight savings time is in effect. Disables daylight savings and the display of the daylight savings time indicator. Configures the date and/or local time in 24-hour format for AIconnect. Local time is defined by the configured timezone and daylight savings. Either the date or local-time must be configured. " Note: Users cannot modify the local time if NTP is enabled. For more information about NTP, refer to config ntp on page 61. hh mm ss Defines the hour value of the local time. This parameter accepts values 0 to 23. Defines the minute value of the local time. This parameter accepts values 0 to 59. Defines the second value of the local time. This parameter accepts values 0 to 59. AIconnect Command Reference Guide 13

22 config clock MM DD YYYY timezone timezone_string hh_offset mm_offset Defines the month value of the date. This parameter accepts values 1 to 12. Defines the day value of the date. This parameter accepts values from 1 to the total number of days in the month specified in MM. Defines the year value of the date. Valid values are 1970 to Configures the timezone for AIconnect. The default is standard GMT +0:00. Defines text to represent the desired timezone, which accepts alphabetic strings of 1 to 10 characters in length. Defines a value to represent the number of hours difference between the desired timezone and default timezone, which is standard GMT Values take the form of hh or -hh and must be between 0 and 12. Defines a value to represent the number of minutes difference between the desired timezone and the default timezone, which is standard GMT Values take the form of mm and must be between 0 and 59. Required User Profiles management, supervisor Example The following clock settings are configured:! Daylight savings indicator DST! Local time 16:45:30 and date 2/1/2006! Timezone EST -5:00. (AI)>config (AI) config>clock (AI) config clock>daylight-savings DST (AI) config clock>local-time 16:45:30 2/1/2006 (AI) config clock>timezone EST -5:00 (AI) config clock> See Also show clock 14 AIconnect Command Reference Guide

23 config controller bridge..... config controller bridge This command configures or deletes a bridge group. A bridge group is a set of switch controllers assigned to a single bridge unit and network interface. Formats config controller bridge bridge_group [ description text ] config controller bridge bridge_group no description config no controller bridge bridge_group Parameters bridge_group Defines the name of the bridge group being configured or deleted. description Configures a bridge group description. Maximum length is 60 characters. There is no default description. text no Defines the text description for a bridge group. Deletes the specified bridge group or description. Required User Profiles management, supervisor Example This example displays the configuration of bridge group vlan1 and description Virtual LAN 1. (AI)>config (AI) config>controller bridge vlan1 (AI) config controller bridge vlan1>description Virtual LAN 1 (AI) config controller bridge vlan1> See Also config controller bridge stp running-config show controllers AIconnect Command Reference Guide 15

24 config controller bridge stp config controller bridge stp This command configures spanning tree protocol (STP) settings for a bridge group. Formats config controller bridge bridge_group stp { disable enable forward-delay seconds hello-time seconds max-age seconds priority priority } config controller bridge bridge_group stp default { forward-delay hello-time max-age priority } Parameters bridge_group disable enable forward-delay Defines the name of the bridge group being configured or deleted. Disables the STP for a bridge group. Enables the STP for a bridge group. Configures the STP forward delay time. Forward delay defines the following settings:! The amount of time a controller spends in the listening state before entering the learning state! The amount of time a controller spends in the learning state before entering the forwarding state! The aging time for dynamic entries in the filtering database during a network topology change. Valid values are 4 to 30 seconds. The default length is 15 seconds. seconds hello-time max-age Defines the duration of a specified setting. Configures the spanning tree protocol hello time. The hello time is the interval between the generation of configuration bridge PDUs when the bridge is either the root bridge or when it is trying to become the root bridge. Valid values are 1 to 10 seconds. The default length is 2 seconds. Configures the maximum age for STP protocol information before it is discarded. Valid values are 6 to 40 seconds. The default length is 20 seconds. 16 AIconnect Command Reference Guide

25 config controller bridge stp..... priority priority default Configures the bridge priority value, which represents the desirability of one bridge group among all others on a network. Valid priority levels are 0 to The highest level is 0. The default level is Defines the bridge priority level. Resets the specified setting to its default value. Required User Profiles management, supervisor Example The following STP settings are configured for bridge group vlan1:! Enabled STP! 15 second forward delay! 4 second hello time! 22 second maximum message age! bridge priority level. (AI)>config (AI) config>controller bridge vlan1 (AI) config controller bridge vlan1>stp (AI) config controller bridge vlan1 stp ->enable (AI) config controller bridge vlan1 stp ->forward-delay 15 (AI) config controller bridge vlan1 stp ->hello-time 4 (AI) config controller bridge vlan1 stp ->max-age 22 (AI) config controller bridge vlan1 stp ->priority (AI) config controller bridge vlan1 stp -> See Also config controller bridge running-config show controllers AIconnect Command Reference Guide 17

26 config controller ethernet config controller ethernet This command configures an AIconnect Ethernet controller and its associated settings. An Ethernet controller describes the hardware and associated system software that manages an Ethernet link. Formats config controller ethernet slot/port { description text disable enable hardware-address mac_address speed controller_speed } config controller ethernet slot/port default { hardware-address speed } config controller ethernet slot/port no description config default controller { ethernet slot/port ethernet * * } config no controller ethernet { ethernet slot/port ethernet * * } Parameters slot port Defines the slot location for the controller on AIconnect. The following values are valid:! 0 specifies that the controller is located on the AIconnect card.! 1 specifies that the controller is located on the PMC in slot 1.! 2 specifies that the controller is located on the PMC in slot 2. Defines the physical connector associated with a controller on AIconnect. Valid values are:! 0 to 3 for the AIconnect card. The IRB is port 0.! 1 to 4 for PMC slots 1 and 2. description Configures a bridge group description. Maximum length is 60 characters. There is no default description. text disable enable Defines the text description for a bridge group. Disables the specified Ethernet controller. Enables the specified Ethernet controller. 18 AIconnect Command Reference Guide

27 config controller ethernet..... hardware-address mac_address speed Configures the hardware address for an AIconnect Ethernet controller. A hardware address is a data-link layer address associated with a particular network device. It is entered in hexadecimal form. The default hardware address is 00:40:72:01:62:18. Defines the hardware (MAC) address value. Enter MAC addresses as 6-byte, hexadecimal formatted values with a colon separating each byte (for example, 00:e0:52:cc:0b:00). This command configures the following settings for an AIconnect Ethernet controller:! Speed (in megabits per second)! Duplex operation Duplex operation refers to the simultaneous transmission and reception of signals by a single device. Half duplex operation allows a controller to transmit and receive, but not at the same time. Full duplex operation allows a controller to transmit and receive simultaneously.! MDI-X capabilities MDI-X refers to a physical connection in a controller that includes an internal crossover of transmit and receive signals. This capability lets like devices communicate with each other directly, without crossover cables or switches. The default controller speed is auto. AIconnect Command Reference Guide 19

28 config controller ethernet controller_speed Defines the controller speed. The following values are valid:! auto Automatically negotiates for the fastest controller speed possible between the controller and the remote device. This is the default controller speed.! 10h Half duplex operation with a speed of 10 Mb/s! 10f Full duplex operation with a speed of 10 Mb/s! 10hx Half duplex operation with a speed of 10 Mb/s and MDI-X capabilities enabled! 10fx Full duplex operation with a speed of 10 Mb/s and MDI-X capabilities enabled! 100h Half duplex operation with a speed of 100 Mb/s! 100f Sets the controller to full duplex operation with a speed of 100 Mb/s! 100hx Half duplex operation with a speed of 100 Mb/s and MDI-X capabilities enabled! 100fx full duplex operation with a speed of 100 Mb/s and MDI-X capabilities enabled. Tip: For full duplex operation, the controller must have full duplex capabilities. no default Deletes a specified parameter. Resets a specified parameter to its default value. * Specifies all controllers or all Ethernet controllers. Required User Profiles management, supervisor Example The following Ethernet controller settings are configured of controller ethernet 0/3:! Enabled controller ethernet 0/3! 00:E0:52:CC:0B:00 for the MAC address! 10h for the speed! Ethernet 3 for the description. (AI)>config (AI) config>controller ethernet 0/3 (AI) config controller ethernet 0/3>enable (AI) config controller ethernet 0/3>hardware-address 00:E0:52:CC:0B:00 (AI) config controller ethernet 0/3>speed 10h (AI) config controller ethernet 0/3>description Ethernet 3 (AI) config controller ethernet 0/3> 20 AIconnect Command Reference Guide

29 config controller ethernet..... See Also config controller ethernet bridge stp config controller ethernet mac-security config controller ethernet proxy-arp config controller ethernet tagged-vlan config controller ethernet tagged-vlan bridge stp config controller ethernet tagged-vlan proxy-arp show controllers AIconnect Command Reference Guide 21

30 config controller ethernet bridge stp config controller ethernet bridge stp This command associates an Ethernet controller with a specified bridge group and configures STP settings for the Ethernet controller. The bridge group is a set of controllers that act like a single Ethernet network and can be assigned to a single routable interface. Format config controller ethernet slot/port bridge bridge_group stp { cost path_cost priority priority } config controller ethernet slot/port bridge bridge_group stp default { cost priority } config controller ethernet slot/port no { bridge [ bridge_group ] } Parameters slot port bridge_group stp cost path_cost priority Defines the slot location for the controller on AIconnect. The following values are valid:! 0 specifies that the controller is located on the AIconnect card.! 1 specifies that the controller is located on the PMC in slot 1.! 2 specifies that the controller is located on the PMC in slot 2. Defines the physical connector associated with a controller on AIconnect. Valid values are:! 0 to 3 for the AIconnect card. The IRB is port 0.! 1 to 4 for PMC slots 1 and 2. Defines the name of the bridge group being configured. Initiates the configuration of STP settings for the Ethernet controller. Configures path cost for an Ethernet controller in a bridge group. Cost is a metric used in spanning tree calculations to determine the best path for reaching a destination. The higher the cost for a path, the less desirable it is to use that path and the more likely the spanning tree algorithm is to disable the port if a network loop occurs. Defines the path cost. Valid values are 1 to 65,535. The default path cost is 10. Configures the priority level for an Ethernet controller in a bridge group. 22 AIconnect Command Reference Guide

31 config controller ethernet bridge stp..... priority default no Defines the STP port priority. Valid values are 0 to 255. The highest priority is 0. The default priority level is 128. Resets a specified parameter to its default value. Deletes a specified parameter. Required User Profiles management, supervisor Example The following settings are configured of controller ethernet 0/3 on bridge br2:! Path cost 45! Priority level 50. (AI)>config (AI) config>controller ethernet 0/3 (AI) config controller ethernet 0/3>bridge br2 (AI) config controller ethernet 0/3 bridge br2 ->stp (AI) config controller ethernet 0/3 bridge br2 stp ->cost 45 (AI) config controller ethernet 0/3 bridge br2 stp ->priority 50 (AI) config controller ethernet 0/3 bridge br2 stp -> See Also config controller ethernet config controller ethernet mac-security config controller ethernet proxy-arp config controller ethernet tagged-vlan config controller ethernet tagged-vlan bridge stp config controller ethernet tagged-vlan proxy-arp running-config show controllers AIconnect Command Reference Guide 23

32 config controller ethernet mac-security config controller ethernet mac-security This command configures MAC security settings for an Ethernet controller. Formats config controller ethernet slot/port mac-security [ address mac_address { count number start time duration } disable enable ] config controller ethernet slot/port mac-security no address { mac_address * } config controller ethernet slot/port no mac-security Parameters slot port address mac_address count Defines the slot location for the controller on AIconnect. The following values are valid:! 0 specifies that the controller is located on the AIconnect card.! 1 specifies that the controller is located on the PMC in slot 1.! 2 specifies that the controller is located on the PMC in slot 2. Defines the physical connector associated with a controller on AIconnect. Valid values are:! 0 to 3 for the AIconnect card. The IRB is port 0.! 1 to 4 for PMC slots 1 and 2. Configures a MAC address table entry for the Ethernet controller. A MAC address table is a list containing the MAC addresses of all devices permitted access to AIconnect through a controller. A MAC address table can contain a maximum of 32 MAC addresses. Defines the MAC address. Enter MAC addresses as 6-byte, hexadecimal formatted values with a colon separating each byte (for example, 00:e0:52:cc:0b:00). Configures the the number of MAC addresses an Ethernet controller will learn before they are captured and added to the controller's MAC address table. A MAC address table can contain a maximum of 32 MAC addresses. Important: MAC addresses cannot be captured when MAC security is enabled on a controller. number Defines the number of MAC addresses an Ethernet controller will learn before they are captured and added to the controller s MAC address table. Valid values are 1 to AIconnect Command Reference Guide

33 config controller ethernet mac-security..... start time duration disable enable no Configures an Ethernet controller to listen to traffic and capture MAC addresses in the controller s MAC address table. AIconnect captures MAC addresses until CTRL+c is pressed. Configures the amount of time for a Ethernet controller to listen to traffic. " Note: When the MAC address table fills up, a message is displayed that says Maximum number of MAC addresses has been reached. Defines the number of seconds a controller will listen for MAC addresses. Valid values are 1 to 300. Disables MAC security on an Ethernet controller. Enables MAC security on an Ethernet controller. Deletes a specified parameter. * Specifies all MAC addresses. Command Defaults No MAC addresses configured Required User Profiles management, supervisor AIconnect Command Reference Guide 25

34 config controller ethernet mac-security Example The following MAC security settings are configured for controller ethernet 0/2:! MAC security is disabled! MAC address 00:e0:52:cc:0b:00 is added to the MAC address table! Capture count is set to 26! Capture time is set to 55 seconds! The controller starts capturing MAC addresses. (AI)>config (AI) config>controller ethernet 0/2 (AI) config controller ethernet 0/2>mac-security (AI) config controller ethernet 0/2 mac-security ->disable (AI) config controller ethernet 0/2 mac-security ->address 00:e0:52:cc:0b:00 (AI) config controller ethernet 0/2 mac-security ->capture count 26 Existing address:00:e0:52:cc:0b:00 Press ctrl-c to terminate capture [UCLI0063] Interrupted. (AI) config controller ethernet 0/2 mac-security ->capture time 55 Existing address:00:e0:52:cc:0b:00 Press ctrl-c to terminate capture [UCLI0063] Interrupted. (AI) config controller ethernet 0/2 mac-security ->capture start Existing address:00:e0:52:cc:0b:00 Press ctrl-c to terminate capture [UCLI0063] Interrupted. (AI) config controller ethernet 0/2 mac-security -> See Also config controller ethernet config controller ethernet bridge stp config controller ethernet proxy-arp config controller ethernet tagged-vlan config controller ethernet tagged-vlan bridge stp config controller ethernet tagged-vlan proxy-arp running-config show controllers 26 AIconnect Command Reference Guide

35 config controller ethernet proxy-arp..... config controller ethernet proxy-arp This command enables or disables proxy ARP on an Ethernet controller. Proxy ARP is the technique by which a host answers ARP requests intended for another machine. By doing this, the host accepts responsibility for routing packets to a destination. Proxy ARP can help machines on a subnet reach remote subnets without configuring routing or a default gateway. Formats config controller ethernet slot/port proxy-arp { disable enable } Parameters slot port disable enable Defines the slot location for the controller on AIconnect. The following values are valid:! 0 specifies that the controller is located on the AIconnect card.! 1 specifies that the controller is located on the PMC in slot 1.! 2 specifies that the controller is located on the PMC in slot 2. Defines the physical connector associated with a controller on AIconnect. Valid values are:! 0 to 3 for the AIconnect card. The IRB is port 0.! 1 to 4 for PMC slots 1 and 2. Disables proxy ARP on an Ethernet controller. Enables proxy ARP on an Ethernet controller. Command Default Disabled Required User Profiles management, supervisor Example This example displays the disabling of proxy ARP on controller ethernet 0/2. (AI)>config (AI) config>controller ethernet 0/2 (AI) config controller ethernet 0/2>proxy-arp (AI) config controller ethernet 0/2 proxy-arp ->disable (AI) config controller ethernet 0/2 proxy-arp -> AIconnect Command Reference Guide 27

36 config controller ethernet proxy-arp See Also config controller ethernet config controller ethernet bridge stp config controller ethernet mac-security config controller ethernet tagged-vlan config controller ethernet tagged-vlan bridge stp config controller ethernet tagged-vlan proxy-arp running-config show controllers 28 AIconnect Command Reference Guide

37 config controller ethernet tagged-vlan..... config controller ethernet tagged-vlan This command configures a tagged VLAN controller which follows the IEEE 802.1Q standard. A tagged VLAN controller describes the system software that manages an Ethernet link within an IEEE 802.1Q VLAN. Identifier tags are assigned to the ports which participate in a VLAN. Assigning the same identifier tag to VLAN ports on multiple pieces of equipment creates a larger network. A maximum of 32 tagged VLANs can be configured per port and a maximum of 80 tagged VLANs can be configured per AIconnect. Formats config controller ethernet slot/port tagged-vlan vlan_id { description descriptive_text disable enable } config controller ethernet slot/port tagged-vlan vlan_id no description config controller ethernet slot/port no tagged-vlan { vlan_id * } config controller ethernet slot/port default tagged-vlan vlan_id Parameters slot port Defines the slot location for the controller on AIconnect. The following values are valid:! 0 specifies that the controller is located on the AIconnect card.! 1 specifies that the controller is located on the PMC in slot 1.! 2 specifies that the controller is located on the PMC in slot 2. Defines the physical connector associated with a controller on AIconnect. Valid values are:! 0 to 3 for the AIconnect card. The IRB is port 0.! 1 to 4 for PMC slots 1 and 2. vlan_id Defines the VLAN identifier tag. Valid values are 1 to description descriptive_text disable Configures a description for the tagged VLAN Ethernet controller. Defines a description for the controller. The maximum length for the controller description is 60 characters. Disables a tagged VLAN Ethernet controller. AIconnect Command Reference Guide 29

38 config controller ethernet tagged-vlan enable default no Enables a tagged VLAN Ethernet controller. Resets a tagged VLAN controller to its default value. Deletes a specified parameter. * Selects all tagged VLANs. " Note: Tagged VLAN interfaces are deleted when their associated tagged VLAN controllers are reset or deleted. Required User Profiles management, supervisor Example The following settings are configured for tagged VLAN 1592 on controller ethernet 0/3:! Enabled tagged VLAN functionality! Virtual LAN 3. (AI)>config (AI) config>controller ethernet 0/3 (AI) config controller ethernet 0/3>tagged-vlan 1592 (AI) config controller ethernet 0/3 tagged-vlan >enable (AI) config controller ethernet 0/3 tagged-vlan >description Virtual LAN 3 (AI) config controller ethernet 0/3 tagged-vlan > See Also config controller ethernet config controller ethernet bridge stp config controller ethernet mac-security config controller ethernet proxy-arp config controller ethernet tagged-vlan bridge stp config controller ethernet tagged-vlan proxy-arp running-config show controllers 30 AIconnect Command Reference Guide

39 config controller ethernet tagged-vlan bridge stp..... config controller ethernet tagged-vlan bridge stp This command configures the STP settings for a tagged VLAN Ethernet controller in a bridge group. Format config controller ethernet slot/port tagged-vlan vlan_id bridge bridge_group stp [ cost path_cost priority priority ] config controller ethernet slot/port tagged-vlan vlan_id bridge bridge_group stp default { cost path_cost priority priority } config controller ethernet slot/port tagged-vlan vlan_id no bridge Parameters slot port Defines the slot location for the controller on AIconnect. The following values are valid:! 0 specifies that the controller is located on the AIconnect card.! 1 specifies that the controller is located on the PMC in slot 1.! 2 specifies that the controller is located on the PMC in slot 2. Defines the physical connector associated with a controller on AIconnect. Valid values are:! 0 to 3 for the AIconnect card. The IRB is port 0.! 1 to 4 for PMC slots 1 and 2. vlan_id Defines the VLAN identifier tag. Valid values are 1 to bridge_group cost path_cost priority Defines the name of the bridge group being configured. Configures the STP path cost for a tagged VLAN Ethernet controller in a bridge group. Cost is a metric used in spanning tree calculations to determine the best path for reaching a destination. The higher the cost for a path, the less desirable it is to use that path and the more likely the spanning tree algorithm is to disable the port if a network loop occurs. Defines the path cost. Valid values are 1 to 65,535. The default value is 10. Configures the STP port priority for a tagged VLAN Ethernet controller in a bridge group. The port priority is a parameter used by STP to determine which ports will be disabled when a network loop occurs. AIconnect Command Reference Guide 31

40 config controller ethernet tagged-vlan bridge stp priority default no Defines the STP port priority. Valid values are 0 to 255. The highest priority is 0. The default priority is 128. Resets the path cost or port priority to the default value. Deletes the configured bridge group. Required User Profiles management, supervisor Example The following STP settings are configured for tagged VLAN controller ethernet 0/3 on bridge group br1:! Path cost 25! Priority level 5. (AI)>config (AI) config>controller ethernet 0/3 (AI) config controller ethernet 0/3>tagged-vlan 45 (AI) config controller ethernet 0/3 tagged-vlan 45 ->bridge br1 (AI) config controller ethernet 0/3 tagged-vlan 45 bridge br1 ->stp (AI) config controller ethernet 0/3 tagged-vlan 45 bridge br1 stp ->cost 25 (AI) config controller ethernet 0/3 tagged-vlan 45 bridge br1 stp ->priority 5 (AI) config controller ethernet 0/3 tagged-vlan 45 bridge br1 stp -> See Also config controller ethernet config controller ethernet bridge stp config controller ethernet mac-security config controller ethernet proxy-arp config controller ethernet tagged-vlan config controller ethernet tagged-vlan proxy-arp running-config show controllers 32 AIconnect Command Reference Guide

41 config controller ethernet tagged-vlan proxy-arp..... config controller ethernet tagged-vlan proxy-arp This command enables or disables proxy ARP on a tagged VLAN Ethernet controller. Proxy ARP is the technique by which a host answers ARP requests intended for another machine. By doing this, the host accepts responsibility for routing packets to a destination. Proxy ARP can help machines on a subnet reach remote subnets without configuring routing or a default gateway. Formats config controller ethernet slot/port tagged-vlan vlan_id proxy-arp { disable enable } Parameters slot port Defines the slot location for the controller on AIconnect. The following values are valid:! 0 specifies that the controller is located on the AIconnect card.! 1 specifies that the controller is located on the PMC in slot 1.! 2 specifies that the controller is located on the PMC in slot 2. Defines the physical connector associated with a controller on AIconnect. Valid values are:! 0 to 3 for the AIconnect card. The IRB is port 0.! 1 to 4 for PMC slots 1 and 2. vlan_id Defines the VLAN identifier tag. Valid values are 1 to disable enable Disables proxy ARP on a tagged VLAN controller. Enables proxy ARP on a tagged VLAN controller. Command Defaults Enabled Required User Profiles management, supervisor AIconnect Command Reference Guide 33

42 config controller ethernet tagged-vlan proxy-arp Example This example displays the disabling of proxy ARP on controller ethernet 0/2. (AI)>config (AI) config>controller ethernet 0/2 (AI) config controller ethernet 0/2>tagged-vlan 1322 (AI) config controller ethernet 0/2 tagged-vlan >proxy-arp (AI) config controller ethernet 0/2 tagged-vlan 1322 proxy-arp ->disable (AI) config controller ethernet 0/2 tagged-vlan 1322 proxy-arp -> See Also config controller ethernet config controller ethernet bridge stp config controller ethernet mac-security config controller ethernet proxy-arp config controller ethernet tagged-vlan config controller ethernet tagged-vlan bridge stp running-config show controllers 34 AIconnect Command Reference Guide

43 config controller serial..... config controller serial This command configures an AIconnect serial controller. A serial controller describes the hardware and software that communicates on a serial link. Format For T1 controllers: config controller serial slot/port [ buildout level clock { internal loop } description descriptive_text disable enable framing { d4 esf } linecode { ami b8zs } config controller serial slot/port default { buildout clock framing linecode } config controller serial slot/port no description For E1 controllers: config controller serial slot/port [ clock { internal loop } description descriptive_text disable enable framing { crc4 no-crc4 } linecode { ami hdb3 } config controller serial slot/port default { clock framing linecode } config controller serial slot/port no description Parameters slot port buildout Defines the slot location for the controller on AIconnect. The following values are valid:! 1 specifies that the controller is located in PMC slot 1.! 2 specifies that the controller is located in PMC slot 2. Defines the physical connector associated with a controller on AIconnect. Valid values are 1 to 4. Sets the line buildout for an AIconnect serial controller. Buildout refers to the length of the cable (in feet) that is connecting the devices on each end of a T1 line or the level of attenuation (in decibels) required for the devices on each end of a T1 line to communicate. Buildout is usually specified by cable length for local communication and by level of attenuation for non-local wide area communication. AIconnect Command Reference Guide 35