Contents Chapter 1: About this Document..................... 5 .......................... 5 Purpose .......................... 5 Conventions ....................... 5 Text Conventions ..................... 7 Documentation and Training .......................... 8 Getting Help ......................... 9 Providing Feedback Chapter 2: New in this document.................. 10 Chapter 3: Command Line Interface (CLI) ................ 11 .................. 11 Command Line Interface Fundamentals ......................
Page 4
Contents ...................... 49 Using shortcut menus .................... 49 Navigating around EDM ....................... 50 Undocking tabs ........................ 50 Docking tabs ...................... 50 Editing a dialog box .................. 51 Inserting an entry in a dialog box ................... 51 Deleting an entry from a dialog box .................
Purpose This document describes how to use the Command Line Interface (CLI) and Enterprise Device Manager (EDM) interfaces to configure the following products: • Extreme Networks Ethernet Routing Switch 4900 Series • Extreme Networks Ethernet Routing Switch 5900 Series Conventions This section discusses the conventions used in this guide.
Page 6
About this Document Icon Alerts you to... Risk of severe personal injury or critical loss of data. Warning: Risk of personal injury, system damage, or loss of Caution: data. Table 2: Text Conventions Convention Description Angle brackets ( < > ) Angle brackets ( <...
Documentation and Training Convention Description also used when referring to publication titles that are not active links. Plain Courier Text Plain Courier text indicates command names, options, and text that you must enter. Plain Courier text also indicates command syntax and system output, for example, prompts and system messages.
About this Document Getting Help If you require assistance, contact Extreme Networks using one of the following methods: Extreme Search the GTAC (Global Technical Assistance Center) knowledge base; manage Portal support cases and service contracts; download software; and obtain product licensing, training, and certifications.
Providing Feedback Providing Feedback The Information Development team at Extreme Networks has made every effort to ensure the accuracy and completeness of this document. We are always striving to improve our documentation and help you work better, so we want to hear from you. We welcome all feedback, but we especially want to know about: •...
Chapter 3: Command Line Interface (CLI) This chapter describes the Command Line Interface (CLI). CLI is an industry standard command line interface that you can use for single-device management. Command Line Interface Fundamentals The following sections contain conceptual information about the Command Line Interface (CLI). CLI Command Modes Command Line Interface (CLI) command modes provide specific sets of CLI commands.
Page 12
Command Line Interface (CLI) The following table describes the various command modes, including the CLI commands to access and to exit each mode. Table 3: CLI command modes Command mode and sample Command to access mode Command to exit mode prompt User EXEC No entrance command, default...
Command Line Interface Fundamentals Command mode and sample Command to access mode Command to exit mode prompt • ISIS To configure VRRP, enter router To exit CLI completely, enter vrrp. logout. To configure IS-IS, enter router isis. Application Configuration From Global, Interface or Router To return to Global Configuration Configuration mode, enter mode, enter...
Page 14
Command Line Interface (CLI) ? command completion The ? command completion is available for any valid command. By typing a command and using a ? as the last argument in the command, the system returns a list of possible command completions from the point of the ?.
Command Line Interface Fundamentals If you type the following without pressing Enter: Switch:1(config-ospf)#redistribute direct m and press the Tab key, the system completes the command to the following point: redistribute direct metric Two possible completions exist. You can type -t, and then press Tab to finish the command: Switch:1(config-ospf)#redistribute direct metric-type default command operator You can reset the modified configuration of a command to the default configuration by using the...
Page 16
Command Line Interface (CLI) Switch:1(config-isis)#default csnp-interval Switch:1(config-isis)#show isis ======================================================================================== ISIS General Info ======================================================================================== AdminState : disabled RouterType : Level 1 System ID : e45d.523c.6484 Max LSP Gen Interval : 900 Metric : wide Overload-on-startup : 20 Overload : false Csnp Interval : 10 PSNP Interval : 2 Rxmt LSP Interval : 5 spf-delay : 100...
Command Line Interface Fundamentals no command operator You can use the no operator in a command to negate a configuration. Based on the functionality of the command, you can perform negations, such as disable, delete, remove, or reset to the default configuration.
Command Line Interface (CLI) The following GREP filter commands are supported: Filter function Description count Counts the number of lines in the output of a command. match Displays only the output lines which match the given pattern. except Displays only the output lines which do not match the given pattern. find Displays the output of a command starting from the first line which matches the given pattern.
Page 19
Command Line Interface Fundamentals Command options To obtain a list of all options for a command, at the prompt enter a portion of a command followed by a space and a question mark (?). Command names To obtain a correct command name, at the prompt enter a portion of the command name, and then press the Tab key.
Command Line Interface (CLI) Command Line Interface Procedures The following sections contain information about common Command Line Interface (CLI) tasks. You can access CLI during runtime to manage the switch. CLI Access Procedures Before you begin • Connect to the switch with a console cable, connected directly to the console port, or use Telnet.
Command Line Interface Procedures configure terminal 2. At the command prompt, enter the following command: edm help-file-path <path name> {tftp <address> {<A.B.C.D> | <IPv6- Address>} | usb unit <1-8>} Variable definitions Use the definitions in the following table to use the edm help-file-path command. Variable Definition path name...
Page 22
Command Line Interface (CLI) Procedures to manage binary configuration files are included in the Enterprise Device Manager section. Viewing current configuration using CLI Use this procedure to view the current configuration. Procedure 1. Enter Privileged EXEC mode: enable 2. At the command prompt, enter the following command: show running-config Saving current configuration to TFTP server using CLI Procedure...
Page 23
Command Line Interface Procedures Saving current configuration to SFTP server using CLI Procedure 1. Enter Privileged EXEC mode: enable 2. At the command prompt, enter the following command: copy running-config sftp [verbose] [module<applicationModules>] [filename <WORD>] ([address {<A.B.C.D> | <ipv6addr>}]) username <WORD>...
Page 24
Command Line Interface (CLI) 2. At the command prompt, enter the following command: copy tftp config address <A.B.C.D> filename <name> Variable definitions The following table describes the parameters for the copy tftp config command. Variable Value address <A.B.C.D> Specifies the address of the TFTP server. •...
Page 25
Command Line Interface Procedures enable 2. At the command prompt, enter the following command: configure network load-on-boot {disable | use-bootp | use-config} address <A.B.C.D> filename <name> Variable definitions The following table describes the parameters for the copy running-config command. Variable Value address <A.B.C.D>...
Page 26
Command Line Interface (CLI) show usb-files 3. To display files on a USB device inserted in a stack unit, enter the following command : show usb-files unit <unit_number> Displaying USB file information using CLI Before you begin Insert USB device in the switch. Procedure 1.
Command Line Interface Procedures Variable Value address <A.B.C.D> Specifies the address of the TFTP server. • A.B.C.D — specifies the IPv4 address • WORD - specifies the IPv6 address filename <Word> Specifies the name of the file to be retrieved. block <1–2>...
Page 28
Command Line Interface (CLI) Examples #show interfaces | match 1000 header 3 Status Auto Flow Port Trunk Admin Oper Link LinkTrap Negotiation Speed Duplex Control ---- ----- ------- ---- ---- -------- ----------- -------- ------ ------- Enable Disabled Enabled 1000Mbps Full Asymm Enable Enabled...
Page 29
Command Line Interface Procedures Parameter Description pattern Specifies the regular expression to be matched against each line of output. Quotations are required if the parameter contains spaces. field <number> Specifies the field in each line to be matched against the pattern. Fields are separated by white spaces and are counted starting with 1 for the left-most field.
Page 30
Command Line Interface (CLI) Enable Down Down Enabled Enabled Enable Disabled Enabled 1000Mbps Full Asymm Enable Down Down Enabled Enabled Enable Down Down Enabled Enabled Display only the last few lines of output The tail filter limits the output of a command to the last few lines. If a number is not specified, then the last 10 lines are shown.
Command Line Interface Procedures Pattern parameter Description include a literal `]' in the sequence, make it the first character (following a possible `^'). To include a literal `-', make it the first or last character. If the pattern includes white spaces then it must be enclosed in quotation marks.
Command Line Interface (CLI) Disabling the Web server using CLI Use this procedure to disable the Web server using CLI. After you disable the Web server, you cannot start EDM. Procedure 1. Enter Global Configuration mode: enable configure terminal 2. At the command prompt, enter the following commands: no web-server web-server disable Displaying the Web server status using CLI...
Enterprise Device Manager (EDM) EDM functions Embedded version Plug-in version • user-based Device Access Control (read only and read- write) • authentication through third party (RADIUS, Microsoft AD, Sun AM) Centralized EDM plug-in management (downloadable install and uninstall, upgrade, patch, and inventory view) User activity log and audit trail Device performance monitoring Limited...
Online help Related links Enterprise Device Manager (EDM) on page 33 Online help Online help is context-sensitive and appears in a separate window in the Web browser. To obtain help for the current topic, click the help button on the toolbar in the work area. If you are not using EDM through COM, you need to download the help file to a TFTP server and configure the EDM Help file path.
Enterprise Device Manager (EDM) Following is a list of the fields on the Switch Summary tab: • hardware model • hardware version • firmware version • software version • system uptime • system object identifier • system contact • system name •...
Interface components The conventions on the device view are similar to the actual switch appearance except that LEDs in Device Physical View do not blink. The LEDs and the ports are color-coded to reflect hardware status. Green indicates the port is up and running; red indicates that the port is disabled. From the menu bar you can click the Device Physical View tab to open the Device Physical View any time during a session.
Page 38
Enterprise Device Manager (EDM) Figure 2: EDM window Navigation tree The navigation tree displays available command topics as folders in a tree, as described in the table below. Table 5: Folders and subfolders in the navigation tree Folder Description Administration Use the selections in the Administration folder to perform the following functions: •...
Page 39
Interface components Folder Description • ADAC • Diagnostics: Port Mirrors, Topology, System Log. 802.1AB: LLDP, Port MED, Vendor Specific • SNTP/Clock • Fabric Attach • Snmp Server: MIB View, User, Community, Host, Notification Control • Storm Control Security Use the selections in the Security folder to view or change security settings.
Page 40
Enterprise Device Manager (EDM) Folder Description • MLT/LACP • SLPP Use the selections in the IP folder to set up IP functions on tabs in the following sub-folders: • IP • TCP/UDP • RIP • IGMP • DHCP Relay • DHCP Server •...
Page 41
Interface components To open a folder or sub-folder, you can click the arrowhead to the left of the folder or double-click the folder to display the available commands tabs. To close a folder, click the arrowhead once. To access a command tab, double-click the selection in the navigation tree. Navigation tree toolbar You can use the toolbar above the navigation tree to perform common functions more easily.
Page 42
Enterprise Device Manager (EDM) Menu bar The menu bar appears above the work area and consists of two rows of tabs. The top row displays tabs that were accessed from the navigation tree during the active session. The tabs in this row, called primary tabs, are docked and available to reopen on demand. The docked tabs appear in the sequence that you accessed them.
Page 43
Interface components Table 6: Common tool bar buttons Button Name Description Apply Executes parameter changes Refresh Refreshes screen data Help Displays context-sensitive online help for the current dialog box Insert Opens an insert dialog box Submits the entry from the insert dialog box The insert buttons appear only on panes where you can insert entries.
Enterprise Device Manager (EDM) Note: Depending on your hardware model, information displayed may appear different than the figure shown in this section. Single port configuration for EDM Note: Depending on your hardware model, information displayed may appear different than the figures shown in this section.
Page 45
Interface components Figure 9: Port edit -VLAN tab • From the Navigation tree you can select any tab from the Edit, Chassis, Ports work flow and double-click a cell under an editable parameter column heading in the appropriate port row of the table.
Enterprise Device Manager (EDM) Figure 11: VLAN, VLANs - Ports tab Multiple Port Configuration for EDM Note: Depending on your hardware model, information displayed may appear different than the figures shown in this section. When you need to apply the same configuration changes to more than one port, you can use the Multiple Port Configuration function available on all tabs in the Edit, Chassis, Ports work flow, or on port-related tabs for specific, applicable feature work areas (for example, VLAN, VLANs, Ports).
Page 47
Interface components • Select all ports from the Port Editor. • Double-click any or all of the editable fields to change the configuration parameter. • Clear your selections. • Apply your selections. • Undo the application of your selections. You can expand or collapse the Multiple Port Configuration pane by clicking the Multiple Port Configuration task bar.
Enterprise Device Manager (EDM) Figure 14: Toolbar Apply button Online help Online help is context-sensitive and appears in a separate window in the Web browser. To obtain help for the current topic, click the help button on the toolbar in the work area. If you are not using EDM through COM, you need to download the help file to a TFTP server and configure the EDM Help file path.
Enterprise Device Manager procedures Procedure 1. In a supported Web browser, enter the IP address of the switch using one of the following formats: • http://<IP Address> • https://<IP Address> 2. Enter the user name. 3. Enter the password. 4. Click Log On. Using shortcut menus In the EDM Device Physical View you can use shortcut menus to edit objects and apply changes.
Enterprise Device Manager (EDM) Procedure 1. In the navigation pane, click the arrowhead to the left of a folder to display the sub-level folders in the tree. 2. If there is a sub-folder, double-click the folder or click the arrowhead beside it, to open the sub-folder.
Enterprise Device Manager procedures Important: Enter an IP address in decimal format: <xxx> <xxx> <xxx> <xxx>. Enter a MAC address in hexadecimal format: xx:xx:xx:xx:xx:xx. Time is a value based on the delta from the switch boot-up time. 3. Click Apply. Inserting an entry in a dialog box Use this procedure to insert an entry in a dialog box.
Enterprise Device Manager (EDM) • click and drag to select a group of objects, then right click • click an entire device, then right click 2. From the list, click Edit. 3. Edit the applicable tab in the work area. 4.
Enterprise Device Manager procedures 5. To change the configuration of the selected ports, in the Multiple Port Configuration pane, double-click the cell beneath the column heading that represents the parameter you want to change and do one of the following: •...
Enterprise Device Manager (EDM) Graphing statistics You can graph statistics for an entire device, a group of ports, or a single port. Before you begin On a Device Physical View select one of the following: • a port • a group of ports •...
Enterprise Device Manager configuration files Procedure 1. From the navigation tree, click Edit. 2. Click File System. 3. Click the USB Files tab. Saving current configuration to flash memory manually using Use this procedure to save the current configuration to flash memory manually. Procedure 1.
Page 56
Enterprise Device Manager (EDM) After the file transfer is complete, the status displays as either manualDownloadPassed or manualDownloadFailed. You can also designate an ASCII configuration file to download automatically at switch startup. To control which ASCII configuration files load automatically, at switch startup use the fields in the table on the Edit >...
Enterprise Device Manager configuration files ASCII and binary configuration file procedures Perform the procedures in this section to use EDM to manage ASCII and binary configuration files. For more information about fields on the Config/ImageDiag file tab, used to manage binary configuration files, see Config Image Diag file tab field descriptions job aid on page 61.
Page 58
Enterprise Device Manager (EDM) 3. Click the Ascii Config Script Files tab. 4. Double-click the ScriptSource field and type: usb://<filename> to store the configuration file on a USB device in a stand-alone unit usb://<unit number>/<filename> to store the configuration file on a USB device in a unit in a stack.
Page 59
Enterprise Device Manager configuration files 3. Click the Ascii Config Script Files tab. 4. Double-click the ScriptSource field and type the configuration file name in the following format: usb://<filename> for a USB device in a standalone unit usb://<unit number>/<filename> for a USB device in a unit in a stack 5.
Page 60
Enterprise Device Manager (EDM) 8. In the Action box, click upldConfig. 9. On the toolbar, click Apply. Storing a binary configuration file on a USB device using EDM Procedure 1. From the navigation tree, double-click Edit . 2. Click File System. 3.
Page 61
Enterprise Device Manager configuration files 6. In the UsbTargetUnit field, enter the stack unit number where the USB resides. 7. In the Action field, click dnldConfigFromUsb. 8. On the toolbar, click Apply. Job aid—Config/Image/Diag file tab field descriptions The following table provides information about fields on the Config/Image/Diag file tab. Field name Description TftpServerInetAddressType...
Enterprise Device Manager (EDM) Field name Description software image on the switch regardless of whether it is newer or older than the current image. • dnldFwFromSftp—Downloads a new diagnostic software image to the switch from the SFTP server. This option replaces the image regardless of whether it is newer or older than the current image.
Page 63
Getting EDM online help files for embedded EDM Procedure 1. To obtain EDM help files for the embedded element manager, do one of the following; • Go to https://extremeportal.force.com and locate the help file for the appropriate product. • Select the help file from the software CD ROM contained in the Base Software License Kit.
Need help?
Do you have a question about the 4900 Series and is the answer not in the manual?
Questions and answers