Management Software AT-S85 and AT-S97 ◆ Command Line Interface User’s Guide AT-MCF2000 Media Converter Series Version 2.0.0 613-000789 Rev.
Copyright © 2008 Allied Telesis, Inc. All rights reserved. No part of this publication may be reproduced without prior written permission from Allied Telesis, Inc. Allied Telesis and the Allied Telesis logo are trademarks of Allied Telesis, Incorporated. All other product names, company names, logos or other designations mentioned herein are trademarks or registered trademarks of their respective owners. Allied Telesis, Inc.
Contents Preface ............................................................................................................................................................ 11 Document Conventions .................................................................................................................................... 12 Where to Find Web-based Guides ................................................................................................................... 13 Contacting Allied Telesis .
Contents HELP................................................................................................................................................................. 45 PING ................................................................................................................................................................. 46 Chapter 4: IP Configuration Commands ...................................................................................................... 47 Overview ...........
AT-S85 and AT-97 Management Software Command Line Interface User’s Guide LOGGING ENABLE EVENTLOG ................................................................................................................... 127 LOGGING ENABLE SYSLOG........................................................................................................................ 128 LOGGING SET EVENTLOG ..........................................................................................................................
Contents SSH ENABLE .................................................................................................................................................213 SSH SHOW ....................................................................................................................................................214 Chapter 14: Manager Account Commands ................................................................................................215 Overview ...................................
Figures Figure 1: Chassis ID Jumper on the AT-MCF2000M Management Module.........................................................................18 Figure 2: Connecting the RS-232 Serial Management Cable to the RS-232 Terminal Port.................................................20 Figure 3: Command Line Interface Prompt...........................................................................................................................21 Figure 4: Displaying the Chassis Modules.......................
Figures 8
Tables Table 1: IP Configuration Commands ..................................................................................................................................49 Table 2: General System Configuration Commands ...........................................................................................................56 Table 3: Port and Module Commands .................................................................................................................................
Tables 10
Preface The AT-S85 and AT-S97 Management Software programs are the operating systems for the AT-MCF2000 Media Converter Modules and the AT-MCF2000M Management Module, respectively. This guide explains how to use the management programs to control and monitor the operating parameters of the media converter channels and modules of the AT-MCF2000 Series.
Preface Document Conventions This document uses the following conventions: Note Notes provide additional information. Caution Cautions inform you that performing or omitting a specific action may result in equipment damage or loss of data. Warning Warnings inform you that performing or omitting a specific action may result in bodily injury.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Where to Find Web-based Guides The installation and user guides for Allied Telesis products are available in portable document format (PDF) on our web site at www.alliedtelesis.com. You can view the documents online or download them onto a local workstation or server.
Preface Contacting Allied Telesis This section provides Allied Telesis contact information for technical support as well as sales and corporate information. Online Support You can request technical support online by accessing the Allied Telesis Knowledge Base: www.alliedtelesis.com/support/kb.aspx. You can use the Knowledge Base to submit questions to our technical support staff and review answers to previously asked questions.
Chapter 1 Starting a Command Line Management Session This chapter describes the basic characteristics of the management software.
Chapter 1: Starting a Command Line Management Session Management Overview The discussions in this section review the basic characteristics of the management software for the AT-MCF2000 Media Converter Series. AT-S85 and AT-S97 Management Software The modules in the AT-MCF2000 Series use two different operating systems.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide AT-S97 Command Line Interface Event log for monitoring the operations of the modules. Syslog client for transmitting event messages to a Syslog server. The AT-S97 Management Software has a command line interface which can be accessed either locally through the RS-232 Terminal Port on the management module or remotely from your network using the Telnet or Secure Shell application protocol.
Chapter 1: Starting a Command Line Management Session settings of the modules when a unit is power cycled or reset. Without the files, you would have to reconfigure the modules whenever you reset a device. The modules do not automatically update their configuration files and the active master configuration file when you change a device’s parameter, such as the speed of a port on a media converter module. Instead, you must initiate the update with the CONFIG SAVE command.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide The ID number for a chassis is set with a jumper on the management module, shown in Figure 1 on page 18. The chassis ID number for a management module is either 0 or 31. The default setting is 0. Within a stack, you assign the management module on the master unit with a chassis ID of 0. You assign all of the AT-MCF2000S Stacking modules on the slave chassis with a chassis ID of 1 through 30.
Chapter 1: Starting a Command Line Management Session Starting a Local Management Session Note Local management sessions do not require an IP configuration on the AT-MCF2000M Management Module. To start a local management session on the chassis, perform the following procedure: 1. Connect the DIN-8 connector on the RS-232 Serial Management Cable included with the AT-MCF2000M Management Module to the RS-232 Terminal port on the module, as shown in Figure 2.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Note The prompt “Hit any key to stop autoboot,” displayed on the console when the management module is reset or power cycled, is for manufacturing purposes only and should be ignored. If you inadvertently display the manufacturing prompt (=>), type “bootapp” to launch the management software on the management module. 4. Press Enter. You are prompted for a user name and password. 5. Enter a user name and password.
Chapter 1: Starting a Command Line Management Session Starting a Remote Telnet or Secure Shell Management Session Review the following guidelines before starting a remote Telnet or Secure Shell (SSH) management session: The AT-MCF2000M Management Module must have an IP configuration. For instructions, refer to Chapter 4, “IP Configuration Commands” on page 47.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide For information on the three manager privilege levels of the AT-S97 Management Software, refer to “Manager Privilege Levels” on page 17. For instructions on how to change a password or create additional manager accounts, refer to Chapter 14, “Manager Account Commands” on page 215. The section “What to Configure First” on page 28 has suggestions on what you should configure during the initial management session of the chassis.
Chapter 1: Starting a Command Line Management Session SNMP Management Session You can also manage the AT-MCF2000 chassis remotely using an Simple Network Management Protocol (SNMP) management program such as HP Openview. This method, however, does not use the management interface. To manage the chassis from a management workstation using an SNMP management program, you need to load the Management Information Base (MIB) file, atMCF2000.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Quitting a Management Session To quit a management session, enter Exit at the command prompt. You should always exit from a management session when you are finished managing a media converter. This can prevent unauthorized individuals from making changes to a unit’s configuration if you leave your management station unattended.
Chapter 1: Starting a Command Line Management Session Command Line Interface Features The command line interface supports the following features: 26 Command history - You can scroll through a history of your commands with the up and down arrow keys. Context-specific help - Typing a question mark against the command line prompt displays a list of the command keywords. Additionally, typing a question mark when entering a command displays a list of legal parameters.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Command Formatting The following formatting conventions are used in this manual: screen text font - This font illustrates the format of a command and command examples. screen text font - Italicized screen text indicates a variable for you to enter. [ ] - Brackets indicate optional parameters. | - Vertical line separates parameter options for you to choose from.
Chapter 1: Starting a Command Line Management Session What to Configure First This section has a few suggestions on what to configure when you are managing the chassis for the first time. The initial management session must be a local session. For instructions on how to start a local management session, refer to “Starting a Local Management Session” on page 20. Note Although the management module comes with the default IP address of 10.0.0.1 and subnet mask of 255.255.252.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Note To avoid possible compatibility problems between the management module and the media converter modules, Allied Telesis recommends that all modules in a chassis or stack use the same version of the AT-S85 and AT-S97 Management Software. If the modules shown in the SYSTEM SHOW CLUSTER command have different versions, you should upgrade the operating software on the modules.
Chapter 1: Starting a Command Line Management Session And, finally, filename.cfg is the filename for the new master configuration file. The name can be up to 15 alphanumeric characters, not including the extension. Spaces are allowed, but a name with spaces must be enclosed in double quotes. This example of the command creates the new master configuration file “mcf_chassis0.cfg” on a management module in a chassis with an ID number of 0: config save filesystem=system://0/m/mcf_chassis0.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Assigning an IP Configuration Will you be remotely managing the chassis with the Telnet or Secure Shell (SSH) application protocol? Or, will the management module be performing any of the following management tasks? Uploading or downloading files to its file system from a TFTP server.
Chapter 1: Starting a Command Line Management Session Setting the Date and Time The management module adds the date and time to the event messages logged in its event log. You can set the date and time manually or with a Network Time Protocol (NTP) server on your network or the Internet.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Naming a Chassis Naming a chassis makes it easier for you to identify it in the management software and may help you avoid the common mistake of performing a command or procedure on the wrong device. The command is SYSTEM SET CHASSIS and the format is: system set chassis id=chassis name=name The chassis variable is the ID number of the chassis.
Chapter 1: Starting a Command Line Management Session 34
Chapter 2 Stacking This chapter describes how to set up an AT-MCF2000 stack.
Chapter 2: Stacking Overview The AT-MCF2000 chassis and the media converter modules interconnect Ethernet networking devices over large distances by transferring Ethernet packets between twisted pair and fiber optic cables. The chassis can accommodate two multi-channel media converter modules as well as the optional AT-MCF2000M Management Module for either local (out-ofband) or remote (in-band) network management of the ports on the media converter modules.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Required Modules To be part of a stack, the master chassis in the stack must have the AT-MCF2000M Management Module installed. See Figure 5. In addition, each member chassis in the stack must have the AT-MCF2000S Stacking Module installed. See Figure 6. Both modules are installed in the management module slot on the front panel of the chassis.
Chapter 2: Stacking AT-S85 and AT-S97 Management Software Versions To create a stack, the management, stacking, and media converter modules require Version 1.4.0 or later of the AT-S97 and AT-S85 Management Software. Earlier versions of the management software do not support this feature. A stack supports all of the features described in “Command Line Interface Features” on page 26.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Setting Up Stacking When creating a stack, you need to designate a master chassis and from one to seven member chassis. The management module has a chassis id of 0 which automatically designates this chassis as the master chassis of the stack by default. For instructions about how to move the jumper, see “Setting Chassis ID Numbers” on page 18.
Chapter 2: Stacking 40
Chapter 3 Basic Commands This chapter describes basic AT-S97 software commands.
Chapter 3: Basic Commands Question Mark ‘?’ Key Syntax ? Parameters None. Privilege Levels Administrator, read-write, and read-only. Description Entering a question mark at the command line prompt displays a list and a brief description of the command line keywords. Entering a question mark after a keyword displays the available keyword parameters. Additionally, entering a question mark after a parameter displays the parameter’s class (that is, integer, string, etc.).
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide CLEAR Syntax clear Parameters None. Privilege Levels Administrator, read-write, and read-only. Description This command clears the screen.
Chapter 3: Basic Commands EXIT Syntax exit Parameters None. Privilege Levels Administrator, read-write, and read-only. Description This command ends a management session.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide HELP Syntax help Parameters None. Privilege Levels Administrator, read-write, and read-only. Description This command displays information about how you can use the “?” and tab keys to simplify the entry of commands.
Chapter 3: Basic Commands PING Syntax ping ipaddress Parameter ipaddress Specifies the IP address of the device to ping. Privilege Levels Administrator and read-write. Description This command tests for a network connection between the management module and a remote device by sending three TCP/IP ping requests. The results of the requests are displayed on your workstation. The following guidelines apply to this command: The management module must have an IP configuration.
Chapter 4 IP Configuration Commands This chapter describes how to assign an IP address to the AT-MCF2000M Management Module. This chapter contains the following sections: “Overview” on page 48 “IP DHCP DISABLE” on page 50 “IP DHCP ENABLE” on page 51 “IP SET” on page 52 “IP SHOW” on page 54 Note Remember to save your parameters changes in the active master configuration file with the CONFIG SAVE command.
Chapter 4: IP Configuration Commands Overview The IP commands assign an IP configuration to the AT-MCF2000M Management Module consisting of an IP address, subnet mask, and default gateway address. An IP configuration is required if the module performs any of the following functions: Remote management using the Telnet and Secure Shell (SSH) application protocols.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Command Summary Table 1 summarizes the IP configuration commands. Table 1. IP Configuration Commands Command Description IP DHCP DISABLE on page 50 Deactivates the DHCP and BOOTP clients on the management module. IP DHCP ENABLE on page 51 Activates the DHCP and BOOTP clients on the management module. IP SET on page 52 Manually sets the IP configuration.
Chapter 4: IP Configuration Commands IP DHCP DISABLE Syntax ip dhcp disable Parameters None. Privilege Levels Administrator and read-write. Description This command deactivates the DHCP and BOOTP clients on the management module. When the clients are deactivated, the module’s IP configuration immediately returns to the default values. The default setting for the DHCP and BOOTP clients is disabled. To manually assign an IP configuration to the management module, refer to “IP SET” on page 52.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide IP DHCP ENABLE Syntax ip dhcp enable Parameters None. Privilege Levels Administrator and read-write. Description This command activates the management module’s DHCP and BOOTP clients for setting the module’s IP configuration from a DHCP or BOOTP server on your network. Refer to “Overview” on page 48 for background information on when to assign an IP configuration to the management module.
Chapter 4: IP Configuration Commands IP SET Syntax ip set ip-address=ipaddress subnetmask=mask default-gateway=ipaddress Parameters ip-address Specifies an IP address for the AT-MCF2000M Management Module. The default value is 10.0.0.1. subnetmask Specifies a subnet mask for the management module’s IP address. The mask can be of variable length. The default value is 255.255.252.0. default-gateway Specifies a default gateway for the management module.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide This command assigns the default gateway address 149.44.55.22 to the management module: ip set default-gateway=149.44.55.22 This command removes the current IP address and subnet mask values without assigning new values: ip set ip-address=0.0.0.0 subnetmask=0.0.0.
Chapter 4: IP Configuration Commands IP SHOW Syntax ip show Parameters None. Privilege Levels Administrator, read-write, and read-only. Description This command displays the management module’s IP address, subnet mask, and default gateway address, as shown in Figure 7. IP Information: IP Address........... Subnet Mask.......... Gateway.............. DHCP................. 149.25.42.11 255.255.255.0 149.25.42.27 Disable Figure 7.
Chapter 5 General System Commands This chapter describes the commands that control and display basic parameters on the management module.
Chapter 5: General System Commands Overview The system commands are divided into two groups in this manual. The first set of commands, described in this chapter, control and display the basic parameters on the management module, such as the chassis’ name and the date and time. The commands in the second group control the individual ports and channels on the media converter modules.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Table 2. General System Configuration Commands (Continued) Command Description “SYSTEM SHOW CONSOLE” on page 67 Displays the console timeout parameter. “SYSTEM SHOW INFO” on page 68 Displays the stack’s name, the name of the network administrator responsible for managing the units, and the location of the stack.
Chapter 5: General System Commands SYSTEM SET ASYNCHRONOUS Syntax system set asynchronous baudrate=2400|4800|9600|19200|115200 Parameters baudrate Sets the baud rate of the RS-232 Terminal port on the AT-MCF2000M Management Module. The default is 115,200 bits per second (bps). Privilege Levels Administrator and read-write. Description This command sets the baud rate of the RS-232 Terminal port on the AT-MCF2000M Management Module. This port is used for local management of the chassis.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SYSTEM SET CHASSIS Syntax system set chassis id=chassis name=name Parameters id Identifies the ID number of the chassis which depends on the module installed in the management slot of the chassis. On a management module, the chassis ID number is 0 or 31. On a stacking module, the chassis ID can be from 1 to 30. To view the ID number of a unit, use the SYSTEM SHOW CLUSTER command.
Chapter 5: General System Commands SYSTEM SET CLOCK Syntax system set clock date=mm/dd/yyyy time=hh:mm:ss Parameters date Specifies the current date in month/day/year format. time Specifies the current time in 24-hour, hour:minute:second format. You must include all three parts of the time. Privilege Levels Administrator and read-write. Description This command manually sets the management module’s date and time which is added to events messages and SNMP traps.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SYSTEM SET CONSOLE Syntax system set console timeout=value Parameter timeout Specifies the console timer in minutes. The range is 0 to 60 minutes. The default is 10 minutes. Privilege Levels Administrator and read-write. Description This command sets the amount of time (in minutes) the management software waits before automatically ending an inactive local or remote management session.
Chapter 5: General System Commands SYSTEM SET CONTACT Syntax system set contact=contact Parameter contact Specifies the name of the network administrator responsible for maintaining the chassis. The contact can be up to 25 alphanumeric characters. Spaces are allowed, but a name with spaces must be enclosed in double quotes (“ “). To remove the current value without specifying a new value, enter “none.” Privilege Levels Administrator and read-write.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SYSTEM SET HOSTNAME Syntax system set hostname=name Parameter hostname Specifies a name of up to 25 alphanumeric characters for the stack. The host name is also used as the command line prompt. Spaces are permitted, but a host name with spaces must be enclosed in double quotes (“ “). To remove the current value without specifying a new value, enter “none.” Privilege Levels Administrator and read-write.
Chapter 5: General System Commands SYSTEM SET LOCATION Syntax system set location=location Parameters location Specifies a location of up to 25 alphanumeric characters for the chassis or stack. Spaces are allowed, but a location with spaces must be enclosed in double quotes (“ “). To remove the current value without specifying a new value, enter “none.” Privilege Levels Administrator and read-write. Description This command sets the location of the chassis or stack.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SYSTEM SHOW ASYNCHRONOUS Syntax system show asynchronous Parameters None. Privilege Levels Administrator, read-write, and read-only. Description This command displays the baud rate setting of the management module’s RS-232 Terminal port, used for local management of the media converter chassis or stack. An example is shown in Figure 8. Asynchronous Port (Console) Information: Baud Rate ............................
Chapter 5: General System Commands SYSTEM SHOW CLOCK Syntax system show clock Parameters None Privilege Levels Administrator, read-write, and read-only Description This command displays the current date, time, and Real Time Clock (RTC) setting of the management module. This information is added to event messages and SNMP traps. See Figure 9. System Clock Information Date ............. 06/04/2007 Time ............. 03:35:25 RTC Source......... none Figure 9.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SYSTEM SHOW CONSOLE Syntax system show console Parameters None. Privilege Levels Administrator, read-write, and read-only. Description This command displays the setting for the console timer. This parameter controls the amount of time (in minutes) that the management software waits before automatically ending an inactive local or remote management session.
Chapter 5: General System Commands SYSTEM SHOW INFO Syntax system show info Parameters None. Privilege Levels Administrator, read-write, and read-only. Description This command displays the stack’s name, the name of the network administrator responsible for managing the units, and the location of the stack, as shown in Figure 10. System Information Hostname ............ Engineering MCF Contact ............. Jane Smith Location ............ Bldg 3, Fl 1, Closet 122 Figure 10.
Chapter 6 Port and Module Commands This chapter describes the system commands that control the parameters on the ports and channels on the media converter modules.
Chapter 6: Port and Module Commands Overview The system commands are divided into two groups in this manual. The first group of commands, described in Chapter 5, “General System Commands” on page 55, display and control the basic parameters on the management module, such as the chassis’ name and the date and time. The system commands described in this chapter control the parameters on the ports and channels on the media converter modules.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Table 3. Port and Module Commands (Continued) Command Description “SYSTEM SHOW CHASSIS” on page 96 Displays the model names and slot assignments of the management and media converter modules in a chassis, as well as the chassis’ module name and MAC address.
Chapter 6: Port and Module Commands SYSTEM RESET CHASSIS Syntax system reset chassis id=chassis Parameters id Identifies the ID number of the chassis to reset. To view a unit’s ID number, use the SYSTEM SHOW CLUSTER command. For instructions, see “SYSTEM SHOW CLUSTER” on page 99. Privilege Levels Administrator and read-write.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Note the following before performing this command: The command does not affect power supply or fan modules. Resetting the chassis ends your management session. To continue managing the unit, you must reestablish the session after the management module has initialized its AT-S97 Management Software. The initialization process takes approximately one minute to complete.
Chapter 6: Port and Module Commands SYSTEM RESET CLUSTER Syntax system reset cluster Parameters None. Privilege Level Administrator. Description This command returns the parameter settings on the management and media converter modules in a chassis or stack to the default values. Note This command deletes all of the master and auxiliary configuration files in the file systems of the modules in the chassis, and so should be used with caution.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide After performing this command, you must do the following before you can save new parameter changes: 1. Create a new master configuration file using the CONFIG SAVE FILESYSTEM command or download a previously saved file from a TFTP server. For instructions on the former, refer to “Creating a Master Configuration File” on page 29 or “CONFIG SAVE FILESYSTEM” on page 158.
Chapter 6: Port and Module Commands SYSTEM RESET MODULE Syntax system reset module id=chassis/slot Parameters id Identifies the media converter module or management module to reset. The ID number consists of the following parts: chassis Identifies the ID number of the chassis. The chassis ID number depends on which module is installed in the management slot of the chassis. When a management module is installed in this slot, the chassis ID number is 0 or 31.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Note Resetting a media converter module may result in the loss of some network traffic. Note When reset, a management module is unresponsive to commands for approximately one minute while it initializes the AT-S97 Management Software.
Chapter 6: Port and Module Commands This command resets the AT-MCF2000M Management Module installed: system reset module id=0/m This command resets the media converter module in slot 1 in a chassis with an ID number of 30: system reset module id=30/1 78
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SYSTEM SET INTERFACE Syntax system set interface id=chassis/slot[/channel] opmode=link-test|ml|sml Parameters id Specifies a media converter module or a channel. The ID consists of the following parts: chassis Identifies the ID number of the chassis. The chassis ID number depends on which module is installed in the management slot of the chassis. When a management module is installed in this slot, the chassis ID number is 0 or 31.
Chapter 6: Port and Module Commands opmode Specifies the operating mode for the channel. Available settings are: link-test Specifies the Link Test mode. This is the default setting. ml Specifies the MissingLink™ mode. sml Specifies the Smart MissingLink mode. Privilege Levels Administrator and read-write. General Description This command sets the operating mode of the media converter channels on a media converter module.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide ports, it replicates the loss on the companion port in the same channel by disabling the transmitter on the companion port. This notifies the network device connected to the port of the loss of the link on the other channel port.
Chapter 6: Port and Module Commands a link, then their Link LEDs will both be off and their status in the SYSTEM SHOW INTERFACE command will be Offline. This operating mode is useful when the network devices connected to the ports of a channel can react to a loss of a link on a port, such as managed Fast Ethernet switches running SNMP or a spanning tree protocol. Conversely, the MissingLink mode is of little value if the network devices of a channel cannot react to a lost link.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide The operating mode functions the same if the failure starts on the twisted pair port. Here, the mode pulses the transmitter on the fiber optic port. As with the other two channel operating modes, this mode does not interfere with the flow of network traffic through the ports of a channel and so can be used during normal network operations of a media converter channel.
Chapter 6: Port and Module Commands Operating Mode Guidelines The following guidelines apply to using the channel operating modes: The channels on a media converter module can be set to different operating modes. The operating modes do not block or interfere with the flow of traffic between the two ports of a channel during normal network operations.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SYSTEM SET INTERFACE PORTNAME Syntax system set interface id=c|b|pp portname=string Parameters id Specifies a media converter module or a channel. The ID consists of the following parts: c Identifies the ID number of the chassis. The chassis ID number depends on which module is installed in the management slot of the chassis. When a management module is installed in this slot, the chassis ID number is 0 or 31.
Chapter 6: Port and Module Commands SYSTEM SET MODULE Syntax system set module id=chassis/slot name=name temperature-threshold=value Parameters id Specifies a module in the chassis. The command can configure only one module at a time. The ID consists of the following parts: chassis Identifies the ID number of the chassis. The chassis ID number depends on which module is installed in the management slot of the chassis. When a management module is installed in this slot, the chassis ID number is 0 or 31.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SHOW INTERFACE” on page 101, “SYSTEM SHOW CHASSIS” on page 96 or “SYSTEM SHOW CLUSTER” on page 99. temperature-threshold Specifies a temperature threshold for the module. The range is 0° C to 75° C (32° F to 167° F). The default value is 60° C. The management module logs an event in the event log if a module’s temperature exceeds the threshold or if, after exceeding it, falls below it.
Chapter 6: Port and Module Commands Examples This command assigns the name “mm vata” to a management module in a chassis with the chassis ID of 0: system set module id=0/m name="mm vata" This command sets the temperature threshold to 55° C for a media converter module in slot 2 in a chassis with an ID of 0: system set module id=0/2 temperature-threshold=55 This command assigns the name “124 mod-ab” and a temperature threshold of 70° C to the media converter module in slot 1 of a chassis with an ID of 0:
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SYSTEM SET PORT Syntax system set port id=c/m|b/[pp]/[port] port-state=disable|enable auto-neg=disable|enable speed=10|100|1000 duplex=half|full crossover=mdi|mdix ingress-rate-limit=none|128k|256k|512k|1m|2M|4M|8M egress-rate-limit=none|128k|256k|512k|1m|2M|4M|8M Parameters id Specifies a twisted pair or fiber optic port on a media converter module.
Chapter 6: Port and Module Commands port Specifies the letter of a port in a channel on a media converter module. Possible values are: a Specifies a twisted pair port. If you specify only a port and not a channel, then all of the twisted pair ports are specified. b Specifies a fiber optic port. If you specify only a port and not a channel, then all of the fiber ports are specified.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 1000 duplex crossover Sets the speed of the port to 1000 Mbps. This setting is applicable to the 10/100/1000Base-T port on the management module. This setting is not supported on the twisted pair and fiber optic ports on the AT-MCF2012LC and AT-MCF2012LC/1 Media Converter Modules. Sets the duplex mode of a port. Available settings are: full Sets the duplex mode of the port to full-duplex.
Chapter 6: Port and Module Commands This command can also set the operating parameters of the 10/100/ 1000Base-T Management port on the management module. To view the current settings of a port, refer to “SYSTEM SHOW INTERFACE” on page 101. Note You should refer to the media converter module’s documentation for operating specifications before configuring the port parameters. This is to avoid the possibility of applying an inappropriate setting to a port.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide connected to the ports, should be using the same duplex mode. A media converter channel may have to discard packets if its two ports are operating in different modes, one half-duplex and the other full-duplex. This could result in a decrease of network performance if the network devices have to frequently retransmit packets.
Chapter 6: Port and Module Commands Examples This command disables Auto-Negotiation of the twisted pair port in channel 5 of a media converter module and sets the port’s speed and duplex mode to 100 Mbps, half-duplex. The module is in slot 2 of a chassis with an ID number of 1. Call-outs in the example identify the parts of the ID number: system set port id=0/2/5/a auto-neg=disable speed=100 duplex=half Chassis Slot Port Port Pair (Channel) This command enables twisted port 5.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide This command disables all the twisted pair ports in the media converter module in slot 1. The chassis has the ID number of 1: system set port id=1/1/a port-state=disable This command sets the duplex mode to half-duplex for all the fiber optic ports in the media converter module in slot 2.
Chapter 6: Port and Module Commands SYSTEM SHOW CHASSIS Syntax system show chassis id=chassis Parameters chassis Identifies the ID number of the chassis. The chassis ID number depends on which module is installed in the management slot of the chassis. When a management module is installed in this slot, the chassis ID number is either 0 or 31. When a stacking module is installed in this slot, the range of the chassis ID is from 1 to 30. To view the ID number of a unit, use the SYSTEM SHOW CLUSTER command.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide An example of the information is shown in Figure 11. Chassis Chassis Chassis MAC Master ID Name Type Address Chassis -----------------------------------------------------------------0 AT-MCF2000 11:22:33:44:55:55 Yes Slot ID Module Name Module Type Cfg Overwrite Software Version --------------------------------------------------------------------M AT-MCF2000M v2.0.0 1 AT-MCF2012LC Disable v2.0.0 2 AT-MCF2012LC Disable v2.0.
Chapter 6: Port and Module Commands Example The following command displays information about a chassis with an ID number of 0: system show chassis id=0 98
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SYSTEM SHOW CLUSTER Syntax system show cluster Parameters None. Privilege Levels Administrator, read-write and read-only. Description This command displays the model names and slot assignments of the management and media converter modules in a chassis or stack, as well as the chassis’ module name and MAC address. This command does not display stacking, power supply, or fan modules.
Chapter 6: Port and Module Commands Chassis Chassis Chassis MAC Master ID Name Type Address Chassis ----------------------------------------------------------------0 AQ Traffic AT-MCF2000 11:22:33:44:55:55 Yes AT-MCF2000 Slot ID Module Name Module Type Cfg Overwrite Software Version ---------------------------------------------------------------------M AT-MCF2000M v2.0.0 1 Reg 1 traf AT-MCF2012LC Enable v2.0.0 2 Reg 2 traf AT-MCF2012LC/1 Enable v2.0.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SYSTEM SHOW INTERFACE Syntax - Chassis Only system show interface id=chassis Syntax - Chassis and Slot system show interface id=chassis/slot Syntax - Chassis, Slot and Channel system show interface id=chassis/slot/channel Parameters id Specifies the chassis, slot or channel to display. The command can display only one device at a time. The ID consists of the following parts: chassis Identifies the ID number of the chassis.
Chapter 6: Port and Module Commands Privilege Levels Administrator, read-write, and read-only. General Description This command can display a variety of status information about a media converter chassis and the media converter modules. You can limit the information to just the model names of the media converter modules in a chassis or view more detailed information about the devices, such as the current operating parameters of the two ports of a media converter channel.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Description of the Chassis and Slot Command To view the current status of the channel ports on a media converter module, including the status of the links between the channel ports and the network devices, specify in the command both a chassis ID number and the slot number of the module. Figure 14 is an example. Interface 0/2 Information: Chassis ID .......... 1 Slot ID ............. 2 Module Name ......... User Module Module Type ..
Chapter 6: Port and Module Commands Table 4. Port Status in the Link Test Mode Channel Port Status Copper Offline Fiber Offline Copper Online Fiber Online Copper Online Fiber Offline Copper Offline Fiber Online Description Neither port in the channel has established a link with a network device. Both ports in the channel have established a link with a network device.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Table 6. Port Status in the Smart Missing Link Mode (Continued) Channel Port Status Copper Online Fiber Online Copper TX SML Fiber Offline Copper Offline Fiber TX SML Twisted Pair Port TX or RX SML Fiber Optic Port TX or RX SML Description Both ports in the channel have established a link with a network device.
Chapter 6: Port and Module Commands Interface 0/2/7 Information Chassis ID ............... 0 Slot ID .................. 2 Module Name .............. User Module Module Type .............. AT-MCF2012LC Port Name ................ User Port OpMode ................... Link Test Port Copper Link Port State .......... Enabled Link Status ......... Online Auto Negotiation .... Enabled Speed ............... 100 Mbps Duplex .............. Full MDI Crossover ....... MDI Ingress Rate Limit ..
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Port State - The state of the port: Enabled - The port is enabled. Disabled - The port was disabled with SYSTEM SET PORT command. For information, refer to “SYSTEM SET PORT” on page 89. Link Status - The status of the link of a port to its network device.
Chapter 6: Port and Module Commands SYSTEM SHOW MODULE Syntax system show module id=chassis/slot Parameters id Identifies a module. You can specify only one module at a time. The ID number consists of the following parts: chassis Identifies the ID number of the chassis. The chassis ID number depends on which module is installed in the management slot of the chassis. When a management module is installed in this slot, the chassis ID number is 0 or 31.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Description This command displays status information about the media converter, power supply, fan, and management modules in a chassis. The information varies depending on the module. Figure 16 is an example of the information for the AT-MCF2000AC Power Supply Module or the AT-MCF2KFAN Fan Module. RPSA Information: Module Name ................ Module Type ................ Power OK ................... Module Present ............. 3.
Chapter 6: Port and Module Commands Figure 17 illustrates the information for the management Module. CPU Information: Name ....................... Module Type ................ AT-MCF2000M Module Status .............. Active Module Present ............. Present 1.2V ....................... Good = 1.212V 1.8V ....................... Good = 1.818V 2.5V ....................... Good = 2.535 3.3V ....................... Good = 3.336V 12.0V ...................... Good = 12.187 Temperature ................ 29.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Module Type - The model name. Power OK - A status of Yes signifies the input power is within the module’s operating range. A status of No signals that the input power is less or greater than the permitted range. This parameter only applies to the power supply and fan modules. Voltages - Operating voltages. These are output voltages for the AT-MCF2000AC Power Supply Module and input voltages for all other modules.
Chapter 6: Port and Module Commands 112
Chapter 7 Network Time Protocol Commands This chapter describes how to set the internal clock and calender from an NTP server on your network or the Internet. This chapter contains the following sections: “Overview” on page 114 “NTP DISABLE” on page 116 “NTP ENABLE” on page 117 “NTP SET” on page 118 “NTP SHOW” on page 119 Note Remember to save your parameters changes in the active master configuration file with the CONFIG SAVE command.
Chapter 7: Network Time Protocol Commands Overview The AT-S97 Management Software comes with a Network Time Protocol (NTP) client for setting its internal clock and calender from an NTP server on your network or the Internet. The date and time are added to the events stored in the event log and to SNMP traps. The commands described in this chapter control the NTP client.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Table 7. NTP Client Commands (Continued) Command Description NTP SET on page 118 Specifies the IP address of the NTP server on the network or the Internet. NTP SHOW on page 119 Displays the current settings of the NTP client.
Chapter 7: Network Time Protocol Commands NTP DISABLE Syntax ntp disable Parameters None. Privilege Levels Administrator and read-write. Description This command deactivates the NTP client on the management module. This is the client’s default setting.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide NTP ENABLE Syntax ntp enable Parameters None. Privilege Levels Administrator and read-write. Description This command activates the NTP client on the management module. The client polls for the NTP server, making fifteen attempts over twenty seconds to contact the device. The default setting for the client is disabled. To set the IP address of the NTP server, use “NTP SET” on page 118.
Chapter 7: Network Time Protocol Commands NTP SET Syntax ntp set server=ipaddress utcoffset=integer Parameters server Specifies the IP address of an NTP server. utcoffset Specifies the time difference, in hours, between Universal Time Coordinated (UTC) and local time. The range is between -12 and +12 hours. The default is 0 hours. Privilege Levels Administrator and read-write. Description This command specifies the IP address of the NTP server on your network or the Internet.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide NTP SHOW Syntax ntp show Parameters None. Privilege Levels Administrator, read-write, and read-only. Description This command displays the status of the NTP client on the management module and the IP address of the NTP server, as shown in Figure 19. NTP Information: Status ............. Disable Server ............. 0.0.0.0 Figure 19.
Chapter 7: Network Time Protocol Commands 120
Chapter 8 Event Log and Syslog Client Commands This chapter describes how to log events with the event log and syslog client commands.
Chapter 8: Event Log and Syslog Client Commands Overview The management, media converter, power supply, and fan modules generate event messages with vital information about system activity. If a network problem occurs, the messages can help you determine the sequence of events that led to the problem as well as identify and resolve it.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Command Summary If the management module and syslog server are on different networks, the IP configuration on the management module must include a default gateway specifying the IP address of the first hop to reaching the server. For instructions, refer to Chapter 4, “IP Configuration Commands” on page 47. Table 8 summarizes the event log and syslog client commands. Table 8.
Chapter 8: Event Log and Syslog Client Commands LOGGING CLEAR EVENTLOG Syntax logging clear eventlog Parameters None. Privilege Level Administrator Description This command deletes all the entries in the event log. If the log is activated, the management module immediately begins to store new events.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide LOGGING DISABLE EVENTLOG Syntax logging disable eventlog Parameters None. Privilege Levels Administrator and read-write Description This command disables the event log. This stops the management module from storing any further events, but any events already stored in the log are retained. To display the current state of the event log or the event messages, refer to “LOGGING SHOW” on page 132.
Chapter 8: Event Log and Syslog Client Commands LOGGING DISABLE SYSLOG Syntax logging disable syslog Parameters None. Privilege Levels Administrator and read-write Description This command stops the management module from transmitting events to a syslog server by disabling the syslog client. This is the default state of the client. To display the current state of the syslog client, refer to “LOGGING SHOW” on page 132.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide LOGGING ENABLE EVENTLOG Syntax logging enable eventlog Parameters None. Privilege Levels Administrator and read-write Description This command activates the event log. The management module immediately begins to store the events as they are generated by the modules in the chassis. This is the log’s default setting. To display the log’s current state, refer to “LOGGING SHOW” on page 132.
Chapter 8: Event Log and Syslog Client Commands LOGGING ENABLE SYSLOG Syntax logging enable syslog Parameters None. Privilege Levels Administrator and read-write Description This command activates the syslog client on the management module. The module immediately begins to send the event messages generated by the modules in the chassis to the syslog server. The default setting for the syslog client is disabled. The IP address of the syslog server is specified with “LOGGING SET EVENTLOG” on page 129.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide LOGGING SET EVENTLOG Syntax logging set eventlog severity-level=critical|major|minor| event Parameters severity-level Specifies the severity level of the event messages displayed in the event log and sent to a syslog server. The same level applies to both the event log and the syslog client. The levels from highest to lowest severity are: critical Critical events signal the loss of power to or the failure of a power module.
Chapter 8: Event Log and Syslog Client Commands Description Event messages are categorized into four severity levels of Critical, Major, Minor, and Event. The severity levels are defined in the Parameters section of this command. You can use this command to control which of the events in the log you want to view based on their severity levels, and so focus your efforts on particular messages.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide LOGGING SET SYSLOG Syntax logging set syslog [host=ipaddress] [facility-code=value] Parameters host Specifies the IP address of a syslog server. To remove an IP address without assigning a new address, specify the default value of 0.0.0.0. facility-code Specifies a facility level for the event messages as they are sent to a syslog server. The range is 0 to 23. The default value is 1.
Chapter 8: Event Log and Syslog Client Commands LOGGING SHOW Syntax logging show Parameters None. Privilege Levels Administrator, read-write, and read-only. Description This command displays the status of the event log and the syslog client, as shown in Figure 20. EventLog Information Status .................. Enable Severity Level .......... Event Syslog Information Status .................. Enable Server .................. 149.22.122.8 Facility Code ........... 1 Figure 20.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide The fields in the Syslog Information section are: Status - The status of the syslog client. When the status of the client is Enable, the management module can send events to a syslog server. When the status is Disable, the management module cannot send events to a syslog server. To set this parameter, refer to “LOGGING ENABLE SYSLOG” on page 128 and “LOGGING DISABLE SYSLOG” on page 126.
Chapter 8: Event Log and Syslog Client Commands LOGGING SHOW EVENTLOG Syntax logging show eventlog Parameters None. Privilege Levels Administrator, read-write, and read-only Description This command displays the event messages in the event log. An example is shown in Figure 21. The events are displayed in reverse-chronology, with the newest entries listed first. The event log, in its default setting, displays all of its messages.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Table 9. Severity Level Definitions Severity Level Definition CR Critical - Indicates critical events signal the loss of power to or the failure of a power module. Messages of this level can also reflect a physical change to the stacking feature, such as the removal of a stacking cable or the introduction of new chassis to a stack. MJ Major - Indicates major events announce a component failure to a fan or media converter module.
Chapter 8: Event Log and Syslog Client Commands Chassis and Slot IDs - The chassis ID and slot identifier of the source module of the message. The first number is the chassis ID number and the second is the slot number or letter, as shown in Figure 22. Chassis ID 00/2 Slot Identifier Figure 22. Chassis and Slot IDs For background information on chassis ID numbers, refer to “Setting Chassis ID Numbers” on page 18. For the slot identifiers, refer to Table 10. Table 10.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Table 11. Event Messages (Continued) Message Stacking Port Link Definition Classification A Stack port on the management module or the AT-MCF2000S Stacking Module established or lost its link to another Stack port. Report Chassis Managership Acquire A media converter module has acquired the second priority to the CMN_Grant which allows access to the I2C bus.
Chapter 8: Event Log and Syslog Client Commands Table 11. Event Messages (Continued) Message Definition Classification Minor Level Messages 138 Authentication Failure The management software denied access to an individual who attempted to locally or remotely log on to the management module with an invalid user name or password. Report Copper|Fiber Port # Offline A port in a media converter channel lost its link to the network device.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Table 11. Event Messages (Continued) Message Port # Mode Set to Definition Classification A channel’s operating mode was changed to Link Test, Missing Link, or Smart Missing Link. “Port #” refers to the channel number. For example, the message “Port 1 Mode Set to Smart MissingLink” signals that channel 1 on a media converter module was set to the Smart MissingLink mode. Report BM update its BM.
Chapter 8: Event Log and Syslog Client Commands Table 11. Event Messages (Continued) Message Definition TFTP Session Open The management module uploaded or downloaded a file during a local or remote management session using TFTP. For example, you would see this message if you downloaded new management software onto the modules using TFTP. Report TFTP Session Close The management module completed uploading or downloading a file to a TFTP server.
Chapter 9 Configuration File Commands This chapter describes commands that control the master configuration and the auxiliary configuration files.
Chapter 9: Configuration File Commands Overview The management and media converter modules store their parameter settings in a series of files called configuration files. These files enable the modules to retain their parameter settings even when they are moved to a different slot or chassis or when the chassis is reset or power cycled. This saves you from having to reconfigure the parameter settings when you power cycle a chassis or move a module.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 2. The media converter modules transmit a copy of their updated auxiliary configuration files to the management module through the backplane in the chassis. 3. When the management module stores an auxiliary configuration file in its file system, it adds the chassis ID number and the slot number of the source module to the filename in order to distinguish between the various files. An example is “BM_0_1.CFG.
Chapter 9: Configuration File Commands file copy srcfile=system://0/m/mcf_ai_traffic.cfg dstfile=system://0/m/mcf_24a_traffic.cfg This command is described in Chapter 10, “File System Commands” on page 165. Specifying the Active Master Configuration File A management module can have more that one master configuration file in its file system, but only one file can be active at a time. This file is referred to as the active master configuration file.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide When you remove a media converter module from a chassis and install it into a different slot, either in the same or a different chassis, it immediately queries the management module to determine whether: the slot was used before and, if it was, if the previous module was the same model.
Chapter 9: Configuration File Commands Editing a Master Configuration File You can edit the master configuration file on the management module with a text editor at your management station by uploading the file from the management module using a TFTP server. You cannot edit it directly on the management module. After you have edited the file, you can download it to the management module and designate it as the active master configuration file on the module.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide The section accepts the following AT-S97 Management Software commands: “SYSTEM SET ASYNCHRONOUS” on page 58 “SYSTEM SET CONSOLE” on page 61 “SYSTEM SET CONTACT” on page 62 “SYSTEM SET HOSTNAME” on page 63 “SYSTEM SET LOCATION” on page 64 “SYSTEM SET MODULE” on page 86 The module’s name is set with a modified version of the SYSTEM SET MODULE command, where the MODULE keyword is replaced with MYMODULE and the ma
Chapter 9: Configuration File Commands Log Configuration This section controls the event log and the syslog client. ### Log logging logging logging logging logging Configuration enable eventLog enable sysLog set sysLog host=0.0.0.0 set sysLog facility-code=1 set eventLog severity-level=event Figure 26.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Telnet and SSH Configuration This section controls the Telnet and SSH servers for remote management of the chassis from a Telnet or SSH client. ### Telnet & SSH Configuration telnet disable ssh disable Figure 28.
Chapter 9: Configuration File Commands The section is prefaced with three header lines that identify the media converter module in the chassis controlled by the commands in the section. An example is shown in Figure 30. ## Filename: BM_0_2.cfg ## Model Type: AT-MCF2012LC ## MAC Address: 00:15:77:70:7A:2C Figure 30.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Note the following guidelines when modifying the commands in this section: Each channel must have its own command line. If you delete a command, the corresponding channel’s operating mode will be Link Test, the default value. As previously mentioned, the PORTID parameter must specify just the channel number. Do not include a chassis ID or slot number.
Chapter 9: Configuration File Commands The name of a media converter module and the temperature threshold are controlled with the commands in the final part of a Blade Configuration section, shown in Figure 33. system system system system set set set set mymodule mymodule mymodule mymodule id=1/0 id=1/0 id=1/a id=1/b name="none" temperature-threshold=60 temperature-threshold=60 temperature-threshold=60 Figure 33.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Table 12. Configuration File Commands (Continued) Command Description CONFIG SAVE on page 157 Updates the active configuration file with the latest changes to the parameter settings. Also creates new master configuration files. “CONFIG SAVE FILESYSTEM” on page 158 Creates a new master configuration file. CONFIG SET on page 160 Selects a new active master configuration file.
Chapter 9: Configuration File Commands CONFIG OVERWRITE Syntax config overwrite enable|disable Id=c/s Parameters enable Enables the configuration overwrite command. This is the default value. disable Disables the configuration overwrite command. c/s Indicates the chassis and slot. Privilege Levels Administrator and read-write. Description This command enables or disables the Management module to overwrite the configuration on the specified Blade module.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide CONFIG RUN Syntax config run Parameters None. Privilege Levels Administrator and read-write. Description This command configures the parameters settings on the modules in the chassis according to the settings in the active master configuration file on the management module. This command is typically used to configure the modules after you have designated a new active master configuration file on the management module.
Chapter 9: Configuration File Commands Example The following command sets the configuration on the modules according to the master configuration file: config run 156
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide CONFIG SAVE Syntax config save Parameters None. Privilege Levels Administrator and read-write. Description This command updates the active master configuration file on the management module and the auxiliary configuration files on the media converter modules with the current parameter settings of the devices.
Chapter 9: Configuration File Commands CONFIG SAVE FILESYSTEM Syntax config save filesystem=system://chassis/slot/filename.cfg Parameter filesystem Specifies the location and name for the new master configuration file. This parameter consists of the following parts: chassis Specifies the ID number of the chassis that houses the management module where the file will be stored. The ID number for the chassis with a management module is either 0 or 31.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Description This command creates a new master configuration file with the current parameter settings of the modules in the chassis. The file is stored in the file system on the management module. For background information, refer to “Overview” on page 142. If, after creating a new master configuration file, you want to designate it as the active file on the management module, perform the CONFIG SET command.
Chapter 9: Configuration File Commands CONFIG SET Syntax config set filesystem=system://chassis/slot/filename.cfg Parameter filesystem Specifies the location and name of a master configuration file. This parameter consists of the following parts: chassis Specifies the ID number of the chassis with the management module where the file is stored. The ID number for a chassis with a management module is 0 or 31. slot Identifies the slot with the module and the master configuration file.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide After designating an active master configuration file, do one of the following: To configure the modules in the chassis or stack according to the settings in the newly designated active master configuration file, issue the CONFIG RUN command. For instructions, refer to “CONFIG RUN” on page 155. Do not issue the CONFIG SAVE command.
Chapter 9: Configuration File Commands CONFIG SHOW Syntax config show Parameters None Privilege Levels Administrator, read-write, and read-only. Description This command displays the names of the current and active master configuration files on the management module. An example is shown in Figure 34. Last configuration file ran ............. unit12.cfg Current set configuration file .......... unit12.cfg (Exists) Active master configuration file Figure 34.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Last configuration file ran ............. unit12.cfg Current set configuration file .......... mcf24.cfg (Exists) Figure 35. CONFIG SHOW Command with a New Active Master File If you were to issue the CONFIG SAVE command at this point, the settings in the “mcf24.cfg” file would be overwritten by the current settings of the modules.
Chapter 9: Configuration File Commands 164
Chapter 10 File System Commands This chapter describes the commands that allow you to manipulate the file system.
Chapter 10: File System Commands Overview The following sections describe the functions of the commands in this chapter. Managing a Module’s File System You can use the commands in this chapter to display the configuration files in the file system on a management module, as well as copy, rename, and delete files.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Uploading or Downloading a Master Configuration File The master configuration file on the management module can be modified with a text editor at your management workstation by uploading the file from the file system on the management module to a TFTP server. After you have edited the file, you can download it to the management module. Uploading and downloading the configuration file is achieved with the commands in this chapter.
Chapter 10: File System Commands The 10/100/1000Base-T Management port on the AT-MCF2000M Management Module must be connected to the network. The management module communicates with the TFTP server through this port. The AT-MCF2000M Management Module must have an IP configuration. For instructions, refer to Chapter 4, “IP Configuration Commands” on page 47. The TFTP server must be a member of the same network as the management module or have access to it through Layer 3 routing devices.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Table 13. File System Commands (Continued) Command Description “FILE DELETE” on page 173 Deletes the configuration files from the file systems on the modules. “FILE DOWNLOAD” on page 176 Downloads new versions of the AT-S85 and AT-S97 Management Software from a TFTP or Xmodem server to the management and media converter modules. You can also download a modified master configuration file to the management module.
Chapter 10: File System Commands FILE COPY Syntax file copy srcfile=system://chassis/slot/filename.cfg dstfile=system://chassis/slot/filename.cfg Parameter srcfile=system Specifies the location and name of the master configuration file to copy. This parameter consists of the following parts: chassis Specifies the ID number of the chassis with the file. The value of the ID number is either 0 or 31. slot Identifies the slot with the module containing the file. Possible values are: filename.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide must be enclosed in double quotes. The filename must be unique from all other files in the file system of the module and it must include the “.CFG” extension. The filename cannot start with the letters “mm” or “bm” because these are restricted by the management software. Privilege Levels Administrator and read-write. Description This command creates a copy of a master configuration file in the file system of the management module.
Chapter 10: File System Commands Note The next example creates a copy of an auxiliary configuration file on a media converter module. This function should never be necessary. This command creates a copy of the “BM.cfg” auxiliary configuration file on a media converter module in slot 2 in a chassis with an ID number of 0. The copy is named “BM_backup.cfg:” file copy srcfile=system://0/2/BM.cfg dstfile=system://0/2/"BM_backup.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide FILE DELETE Syntax file delete filesystem=system://chassis/slot/filename.cfg Parameter system Specifies the location of the file to delete. This parameter has the following parts: chassis Specifies the ID number of the chassis with the file. The value of the ID number is either 0 or 31. slot Identifies the slot with the module containing the file. Possible values are: filename.
Chapter 10: File System Commands Description This command deletes files from the file systems of the management and media converter modules. You can use the command to remove unnecessary or obsolete configuration files from the modules. For background information on configuration files, refer to Chapter 9, “Configuration File Commands” on page 141. Review the following before using this command: Allied Telesis does not recommend deleting the management module’s active master configuration file.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide This command deletes the configuration file “BM.cfg” from the media converter module in slot 2 in a chassis with an ID number of 0: file delete filesystem=system://0/2/BM.cfg” This command deletes all the configuration files starting with “BM” from a media converter module in slot 2 in a chassis with an ID number of 0: file delete filesystem=system://0/2/BM*.
Chapter 10: File System Commands FILE DOWNLOAD Syntax 1: Downloading the AT-S85 and AT-S97 Boot Loaders file download srcfile=tftp://ipaddress/filename.bin dstfile=system://chassis/slot/bootblock Syntax 2: Downloading the AT-S85 and AT-S97 Management Software (Image Files) file download srcfile=tftp://ipaddress/filename.img dstfile=system://chassis/slot/appblock Syntax 3: Downloading a Master Configuration File file download srcfile=tftp://ipaddress/filename.cfg dstfile=system://chassis/slot/filename.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 0 or 31 slot The chassis ID numbers are limited to these values. Identifies the slot number of a module. Possible values are: * (asterisk) Indicates all slots in a chassis. m Identifies the management module slot. 1 or 2 Specifies a slot number of a media converter module. In the AT-MCF2000 Chassis, the left slot is 1 and the right slot is 2.
Chapter 10: File System Commands General Description This command downloads new versions of the AT-S85 and AT-S97 boot loaders and management software to the management and media converter modules in a chassis from a TFTP server. Allied Telesis may post new versions of these files on our web site so our customers can update their equipment with the latest files. You can also use this command to download a master configuration file that you edited at your management workstation to the management module.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Since this command uses the TFTP client on the management module, Allied Telesis recommends reviewing the information in “Guidelines to Using the TFTP and Xmodem Client” on page 167 prior to using the command. Note A management module resets after receiving a new bootloader. The module is unresponsive to commands for approximately one minute while it initializes its AT-S97 Management Software.
Chapter 10: File System Commands Note A media converter module resets after receiving a new version of the AT-S85 Management Software, but immediately resumes forwarding network traffic through its ports and channels using its default settings while it initializes the new software. This process takes approximately one minute to complete. The module is unresponsive to management commands during the initialization process.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide The asterisk is used to indicate all slots in the chassis which means the management module receives the file as well. Since the AT-S85 boot loader is intended for media converter modules, it discards the file and generates an error message. You can ignore the message. This command downloads a new version of the AT-S97 boot loader onto the management module in a chassis. The IP address of the TFTP server is 162.101.11.
Chapter 10: File System Commands This command downloads a new version of the AT-S97 Management Software onto the AT-MCF2000M Management Module in a chassis. The name of the file is “ats97.img:” file download srcfile=tftp://149.72.23.5/ats97.img dstfile=system://*/m/appblock This command downloads a new version of the AT-S85 Management Software onto the media converter module in slot 1 of a chassis with ID of 0. The IP address of the TFTP server is 150.24.44.65 and the name of the file is “ats85.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide FILE FASTDOWNLOAD Syntax file fastdownload appblock|bootblock srcfile=tftp|xmodem:// ipaddress/filename Parameters appblock Designates the area of flash memory reserved for the AT-S85 and AT-S97 Management Software. bootblock Designates the area of flash memory reserved for the AT-S85 and AT-S97 boot loader files.
Chapter 10: File System Commands configuration, and image files on to individual media converter modules. As a result, you have to specify the chassis id and slot number for each command. For more information about the FILE DOWNLOAD command, see “FILE DOWNLOAD” on page 176. Examples The following commands provides a fast download of a Bootloader file from a remote server to all media converter modules. The IP address of the TFTP server is 192.100.10.1 and the file name is S85.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide FILE RENAME Syntax file rename srcfile=system://chassis/slot/filename dstfile=system://chassis/slot/filename Parameters srcfile=system Specifies the location and name of the master configuration file to rename. This parameter has the following parts: chassis Specifies the ID number of the chassis with the file. The value of the ID number is 0 or 31. slot Identifies the slot number of a module.
Chapter 10: File System Commands Privilege Levels Administrator and read-write. Description This command is used to rename master configuration files in the file system of the management module. Observe the following guidelines when using this command: If you rename the active master configuration file, the management software recreates it the next time you issue the CONFIG SAVE command. To view the name of the active master configuration file, refer to “CONFIG SHOW” on page 162.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide This command renames the media converter configuration file “BM_0_1.cfg” to “BM_0_1 backup.cfg” in the file system on the management module which has a chassis ID number of 0: file rename srcfile=system://0/m/BM_0_1.cfg dstfile=system://0/m/"BM_0_1 backup.cfg" This command renames the configuration file “BM.cfg” to “BM_2.
Chapter 10: File System Commands FILE SHOW Syntax file show filesystem=system://chassis/slot/filename Parameters system Specifies the chassis and module with the file system to display. This parameter has the following parts: chassis Specifies the ID number of the chassis with the file. The value of the ID number is 0 or 31. slot Specifies the ID number or letter of the slot with the module. Possible values are: filename m Identifies the slot with the AT-MCF2000M Management Module.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Module 0/M File System: -rw-r--r-1 0 -rw-r--r-1 0 -rw-r--r-1 0 -rw-r--r-1 0 -rw-r--r-1 0 0 0 0 0 0 2747 2652 402 849 5612 File Size Apr Apr Apr Apr Apr 12 12 12 12 12 14:52 14:52 14:52 14:52 14:52 BM_0_1.cfg BM_0_2.cfg file.inf MM.cfg Chassis12a.cfg Date and Time Filename Figure 37. FILE SHOW Command The first four columns can be ignored. The remaining columns are defined here: File size - The size of the file in bytes.
Chapter 10: File System Commands Note The following examples illustrate how to display the files in the file system on a media converter module. This function should never be necessary. This command displays all the filenames on a media converter module in slot 2 in a chassis with an ID number of 0: file show filesystem=system://0/2/*.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide FILE UPLOAD Syntax 1: Uploading a Configuration File to a TFTP Server file upload srcfile=system://chassis/slot/filename.cfg dstfile=tftp://ipaddress/filename.cfg Syntax 2: Uploading a Configuration File from a Media Converter Module to the Management Module file upload srcfile=system://chassis/slot/filename.cfg dstfile=system://chassis/m/filename.cfg Parameters srcfile=system Specifies the location and name of the file to upload.
Chapter 10: File System Commands dstfile=tftp Specifies the TFTP server to receive the file. This parameter uploads a configuration file from a management or media converter module to a TFTP server. This parameter has the following parts: ipaddress Specifies the IP address of the TFTP server. filename.cfg Specifies a name for the file when uploaded to the FTP server. Enclose the filename in double quotes if it contains a space. The filename extension must be “.CFG.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Description of Syntax 2 This command syntax is reserved for future versions of the management software. Examples of Uploading a Configuration File to a TFTP Server This command uploads the master configuration file “traffic_n2.cfg” from a management module to a TFTP server with the IP address of 150.24.44.65. The chassis has an ID number of 0: file upload srcfile=system://0/m/traffic_n2.cfg dstfile=tftp://150.24.44.65/traffic_n2.
Chapter 10: File System Commands 194
Chapter 11 Telnet Server Commands This chapter describes commands that control the management module’s Telnet application protocol server. This chapter contains the following sections: “Overview” on page 196 “TELNET DISABLE” on page 198 “TELNET ENABLE” on page 199 “TELNET SHOW” on page 200 Note Remember to save your parameters changes in the active master configuration file with the CONFIG SAVE command.
Chapter 11: Telnet Server Commands Overview The commands in this chapter control the management module’s Telnet application protocol server, used for remote management of the chassis from a Telnet client on your network. The commands TELNET ENABLE and TELNET DISABLE enable and disable the server, while the TELNET SHOW command displays the current status of the server. The server’s default setting is disabled.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Table 14. Telnet Server Commands (Continued) Command Description TELNET ENABLE on page 199 Activates the Telnet application protocol server. TELNET SHOW on page 200 Displays the current settings of the Telnet server.
Chapter 11: Telnet Server Commands TELNET DISABLE Syntax telnet disable Parameters None. Privilege Levels Administrator and read-write. Description This command disables the Telnet server on the management module. It is the server’s default setting. To protect the management module from unauthorized access, leave the server disabled if the unit will not be managed with the Telnet application protocol.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide TELNET ENABLE Syntax telnet enable Parameters None. Privilege Levels Administrator and read-write. Description This command activates the Telnet server on the management module for remote Telnet management of the chassis. The default setting for the server is disabled. Note Review “Telnet Server Guidelines” on page 196 for the preconditions for remote Telnet management.
Chapter 11: Telnet Server Commands TELNET SHOW Syntax telnet show Parameters None. Privilege Levels Administrator, read-write, and read-only. Description This command displays the current status of the Telnet server on the management module, as shown in Figure 38. Telnet Status ........ Enable Figure 38.
Chapter 12 Simple Network Management Protocol (SNMP) Commands This chapter describes the commands that permit you to manage the media converter using the SNMPv1 and SNMPv2c protocols. This chapter contains the following sections: “Overview” on page 202 “SNMP SET” on page 205 “SNMP SHOW” on page 207 Note Remember to save your parameters changes in the active master configuration file with the CONFIG SAVE command.
Chapter 12: Simple Network Management Protocol (SNMP) Commands Overview The AT-S97 Management Software has a Simple Network Management Protocol (SNMP) feature that enables you to manage a media converter by viewing and changing the management information base (MIB) objects on the device.The AT-S97 software supports SNMPv1 and SNMPv2c. With the SNMPv1 and SNMPv2c protocols, you can create community strings and define up to four SNMP manager IP addresses.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Activities that generate the SNMP traps are listed below: module has been installed or removed port link status is offline or online port link status is RX (receive) SML or TX (transmit) SML port operational mode is changed to Missing Link or SML port operational mode is changed to OAM Bypass, OAM visible, or link test TFTP session is opened or closed XMODEM session is opened or closed TELNET session is
Chapter 12: Simple Network Management Protocol (SNMP) Commands If does not matter which community strings you assign to the trap receivers. When a media converter sends a trap, it looks at all the community strings and sends the trap to all of the trap receivers on all of the community strings. If you are not interested in receiving traps, you do not need to enter the IP addresses of trap receivers.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SNMP SET Syntax snmp set mgrip1=ipaddress mgrip2=ipaddress mgrip3=ipaddress mgrip4=ipaddress Get-community=string Set-community=string Trap-community=string Parameters mgrip1 - mrip4 Indicates the SNMP manager IP address for SNMP manager 1 through SNMP manager 4. Specifies up to four IP addresses of network management stations that will receive SNMP traps from the unit. The default value is 000.000.000.000.
Chapter 12: Simple Network Management Protocol (SNMP) Commands Examples The following command sets the IP address of network manager 1 to 168.12.1.1 and the value of the set-community to “snmpsecret1.” snmp mgrip=168.12.1.1 set-community=snmpsecret1 The following command sets the IP address of network manager 2 to 168.12.1.3 and the value of the trap-community to “sanjosenetmgr2.” snmp mgrip=168.12.1.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SNMP SHOW Syntax snmp show Parameters None. Privilege Levels Administrator, read-write and read-only Description This command displays the current status of the SNMP feature on the media converter. An example is shown in Figure 39. SNMP Information: Get Community...............public Set Community...............private TrapCommunity...............public Manager Manager Manager Manager 1 2 3 4 IP IP IP IP address........0.0.0.
Chapter 12: Simple Network Management Protocol (SNMP) Commands 208
Chapter 13 Secure Shell Server (SSH) Commands This chapter provides a description of the Secure Shell Server (SSH) feature. In addition, it describes commands that enable and disable SSH and display SSH information. This chapter contains the following sections: “Overview” on page 210 “SSH DISABLE” on page 212 “SSH ENABLE” on page 213 “SSH SHOW” on page 214 Note Remember to save your parameters changes in the active master configuration file with the CONFIG SAVE command.
Chapter 13: Secure Shell Server (SSH) Commands Overview The AT-S97 Management Software has a Secure Shell (SSH) application protocol server for remote management of the chassis with an SSH client. Compared to remote Telnet management, this form of management is more secure because it uses encryption during the management sessions.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Command Summary The management module must have an IP configuration. For instructions, refer to Chapter 4, “IP Configuration Commands” on page 47. The remote SSH management workstation must be a member of the same network as the management module or have access to it through Layer 3 routing devices.
Chapter 13: Secure Shell Server (SSH) Commands SSH DISABLE Syntax ssh disable Parameters None. Privilege Levels Administrator and read-write Description This command disables the SSH server on the management module. This is the default setting for the server.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide SSH ENABLE Syntax ssh enable Parameters None. Privilege Levels Administrator and read-write Description This command activates the SSH server on the management module for remote management with the SSH application protocol. The default setting for the SSH server is disabled. Note Refer to “SSH Server Guidelines” on page 210 for the requirements of remote SSH management.
Chapter 13: Secure Shell Server (SSH) Commands SSH SHOW Syntax ssh show Parameters None. Privilege Levels Administrator, read-write and read-only Description This command displays the current status of the SSH server on the management module. An example is shown in Figure 40. SSH Status ........ Enable Figure 40.
Chapter 14 Manager Account Commands This chapter describes how to create additional manager accounts. This chapter contains the following sections: “Overview” on page 216 “USER ADD” on page 218 “USER DELETE” on page 220 “USER SET” on page 221 “USER SHOW” on page 223 Note Remember to save your parameters changes in the active master configuration file with the CONFIG SAVE command. For information, refer to “Saving Your Configuration Changes” on page 17 or “CONFIG SAVE” on page 157.
Chapter 14: Manager Account Commands Overview By default, the AT-S97 Management Software has one predefined manager account with a privilege level of administrator. This account, with its login name of “manager” and default password of “friend,” provides a network manager with complete access to all of the commands. The management module can support additional manager accounts, a useful feature when more than one administrator manages a device.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Table 17. Manager Account Commands (Continued) Command Description USER SET on page 221 Modifies the password and privilege level of a manager account. USER SHOW on page 223 Displays the current manager accounts.
Chapter 14: Manager Account Commands USER ADD Syntax user add username=name privilege=read|readwrite Parameters username Specifies a name between 1 and 16 alphanumeric characters in length. The name is case sensitive. Special characters are permitted with the exception of the question mark (?) and quotation marks (“). However, to specify spaces in a user name, you must enclose the name in quotation marks. privilege Specifies the privilege level of the account.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide This command creates the new manager account “Eric Jones” with a privilege level of read: user add username="Eric Jones" privilege=read This command creates the new manager account “** Marker ” with a privilege level of readwrite: user add username="** Marker " privilege=readwrite 219
Chapter 14: Manager Account Commands USER DELETE Syntax user delete username=name Parameters username Specifies a name between 1 and 16 alphanumeric characters. The name is case sensitive. Special characters are permitted with the exception of the question mark (?) and quotation marks (“). However, to specify spaces in a user name, you must enclose the name in quotation marks. Privilege Levels Administrator Description This command deletes a manager account from the management module.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide USER SET Syntax user set username=name password privilege=read|readwrite Parameters username Specifies a name between 1 and 16 alphanumeric characters. The name is case sensitive. Special characters are permitted with the exception of the question mark (?) and quotation marks (“). However, to specify spaces in a user name, you must enclose the name in quotation marks. password Changes the password of the account.
Chapter 14: Manager Account Commands This command changes the privilege level of the manager account “Smith” to read-write: user set username=Smith priviledge=readwrite This command changes the password and privilege level of the “Tom Adams” account: user set username="Tom Adams" password priviledge=read This command changes the password of the “Owen” account: user set username=Owen password 222
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide USER SHOW Syntax user show Parameters None. Privilege Levels Administrator, read-write, and read-only. Description This command displays the manager accounts on the AT-MCF2000M Management Module. An example of the information is shown in Figure 41. The first entry in the table, “manager,” is the predefined manager account. For background information, refer to “Overview” on page 216.
Chapter 14: Manager Account Commands 224
Chapter 15 Diagnostics Commands This chapter describes the diagnostic commands.
Chapter 15: Diagnostics Commands Overview The diagnostics commands display manufacturing information which you may be asked to provide if you contact Allied Telesis Technical Support for assistance. They do not test any of the components on the modules in a chassis. Command Summary 226 Table 18 summarizes the diagnostics commands. Table 18. Diagnostics Commands Command Description “DIAGNOSTICS SHOW BOOTLOADER” on page 227 Displays the version number of the software bootloader.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide DIAGNOSTICS SHOW BOOTLOADER Syntax diagnostics show bootloader Parameters none Privilege Levels Administrator, read-write, and read-only. Description This command displays the version number of the software bootloader. If you contact Allied Telesis Technical Support for assistance, you need to provide this information. Figure 43 is an example of the DIAGNOSTIC SHOW BOOTLOADER command.
Chapter 15: Diagnostics Commands The fields are defined here: Slot ID: A slot in the chassis. Possible values are: – C: Indicates the chassis. – M: Indicates the management slot for the AT-MCF2000M Management Module. – number: A media converter slot number (for example, 1, 2, etc.). Empty slots are not included in the tables. Note The AT-MCF2000S Stacking Module is not displayed. Module Name - Indicates the name of the module.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide DIAGNOSTICS SHOW CHASSIS Syntax diagnostics show chassis id=chassis eeprom Parameters id Identifies the ID number of a chassis. The range of chassis ID numbers is from 0 to 31. To display a unit’s ID number, use the SYSTEM SHOW CLUSTER command. For instructions, see “SYSTEM SHOW CLUSTER” on page 99. eeprom Displays the serial numbers, hardware revision levels, and MAC addresses of the modules.
Chapter 15: Diagnostics Commands Note The AT-MCF2000S Stacking Module is not displayed. Module Name - Indicates the name of the module. Refer to “SYSTEM SET MODULE” on page 86 for instructions on assigning a name to a module. Module Type - Indicates the model name. Serial Number - Indicates the chassis or module’s serial number. HW Rev. - Indicates the chassis or module’s hardware revision level. MAC Address - Indicates the chassis or module’s MAC address.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide DIAGNOSTICS SHOW MODULE Syntax diagnostics show module id=chassis/slot Parameters id Specifies a module. You can view only one module at a time. The ID consists of the following parts: chassis Specifies the ID number of a chassis. The range of a chassis ID is from 0 to 31. slot Specifies the slot number of the media converter module with the port. Possible values are: 1 or 2 Specifies a slot number of a media converter slot.
Chapter 15: Diagnostics Commands Eeprom Information Name ....................... Model ...................... MAC ........................ SN ......................... HW Rev ..................... CPU Software Information: Software Version ........... CPU Information: Name ....................... Module Type ................ Module Status .............. Module Present ............. 1.2V ....................... 1.8V ....................... 2.5V ....................... 3.3V ....................... 12.0V ....
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Examples This command displays information about the management module in a chassis with an ID of 0: diagnostics show module id=0/m This command displays information about the media converter module in slot 2 of a chassis with an ID of 0: diagnostics show module id=0/2 233
Chapter 15: Diagnostics Commands DIAGNOSTICS SHOW SOFTWARE Syntax diagnostics show software Parameters none Privilege Levels Administrator, read-write, and read-only. Description This command displays the version number of the AT-S85 and AT-S97 software. If you contact Allied Telesis Technical Support for assistance, you need to provide this information. Figure 43 is an example of the DIAGNOSTIC SHOW SOFTWARE command.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide The fields are defined here: Slot ID: A slot in the chassis. Possible values are: – C: Indicates the chassis. – M: Indicates the management slot for the AT-MCF2000M Management Module. – number: A media converter slot number (for example, 1, 2, etc.). Empty slots are not included in the tables. Note The AT-MCF2000S Stacking Module is not displayed. Module Name - Indicates the name of the module.
Chapter 15: Diagnostics Commands 236
Appendix A AT-S85 and AT-S97 Management Software Default Settings This appendix lists the factory default settings for the features in the AT-S85 and AT-S97 Management Software.
Appendix A: AT-S85 and AT-S97 Management Software Default Settings Configuration File The following table lists the default settings for the configuration file.
AT-S85 and AT-97 Management Software Command Line Interface User’s Guide Event Log The following table lists the default settings for the event log.
Appendix A: AT-S85 and AT-S97 Management Software Default Settings IP Configuration The following table lists the default settings for the IP configuration of the management module. IP Configuration Setting 240 Default IP Address 10.0.0.1 Subnet Mask 255.255.252.0 Default Gateway 0.0.0.
AT-S85 and AT-97 Management Software Command Line Interface User’s Guide Manager Account The following table lists the default settings for the manager account. Manager Account Setting Default Manager Login Name manager Manager Password friend Console Timer 10 minutes Note Login names and passwords are case sensitive.
Appendix A: AT-S85 and AT-S97 Management Software Default Settings Master Configuration File The following table lists the name of the default master configuration file.
AT-S85 and AT-97 Management Software Command Line Interface User’s Guide Network Time Protocol Client The following table lists the default settings for the NTP client. Network Time Protocol Client Setting Default Client Status Disabled NTP Server IP Address 0.0.0.
Appendix A: AT-S85 and AT-S97 Management Software Default Settings RS-232 Terminal Port The following table lists the default settings for the RS-232 Terminal port. RS-232 Terminal Port Setting Default Data Bits 8 Stop Bits 1 Parity None Flow Control None Baud Rate 115200 bps Note The baud rate is the only adjustable parameter on the port.
AT-S85 and AT-97 Management Software Command Line Interface User’s Guide Secure Shell Server The following table lists the SSH server default settings. Telnet Server Setting Default SSH Server Disabled Protocol Port Number 22 Note The protocol port number is not adjustable.
Appendix A: AT-S85 and AT-S97 Management Software Default Settings Simple Network Management Protocol The following table lists the SNMP default settings. Telnet Server Setting 246 Default get community public set community private trap community public Manager 1 IP address 0.0.0.0 Manager 2 IP address 0.0.0.0 Manager 3 IP address 0.0.0.0 Manager 4 IP address 0.0.0.
AT-S85 and AT-97 Management Software Command Line Interface User’s Guide Syslog Client The following table lists the default settings for the syslog client. Syslog Client Setting Default Syslog Server IP Address 0.0.0.
Appendix A: AT-S85 and AT-S97 Management Software Default Settings Telnet Server The following table lists the Telnet server default settings. Telnet Server Setting Default Telnet Server Disabled Protocol Port Number 23 Note The protocol port number is not adjustable.
Index Numerics C 10/100/1000Base-T Management port displaying status of 108 setting 89 channel operating modes described 80, 85 displaying 101 guidelines 84 setting 79, 85 chassis ID numbers described 18 displaying 96, 99, 101 CLEAR command 43 command line prompt, setting 63 commands CLEAR 43 CONFIG OVERWRITE 154 CONFIG RUN 155 CONFIG SAVE 157 CONFIG SAVE FILESYSTEM 158 CONFIG SET 160 CONFIG SHOW 162 DIAGNOSTICS SHOW CHASSIS 227, 229 DIAGNOSTICS SHOW MODULE 231 EXIT 44 FILE COPY 170 FILE DELETE 173 FILE
Index SSH ENABLE 213 SSH SHOW 214 SYSTEM RESET CHASSIS 72 SYSTEM RESET CLUSTER 74 SYSTEM RESET MODULE 76 SYSTEM SET ASYNCHRONOUS 58 SYSTEM SET CHASSIS 59 SYSTEM SET CLOCK SYSTEM SET CONSOLE 61 SYSTEM SET CONTACT 62 SYSTEM SET HOSTNAME 63 SYSTEM SET INTERFACE 79, 85 SYSTEM SET LOCATION 64 SYSTEM SET MODULE 86 SYSTEM SET PORT 89 SYSTEM SHOW ASYNCHRONOUS 65 SYSTEM SHOW CHASSIS 96 SYSTEM SHOW CLOCK 66 SYSTEM SHOW CLUSTER 99 SYSTEM SHOW CONSOLE 67 SYSTEM SHOW INFO 68 SYSTEM SHOW INTERFACE 101 SYSTEM SHOW MODULE
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide media converter ports 101 Network Time Protocol (NTP) client 119 Secure Shell (SSH) server 214 Simple Network Management Protocol (SNMP) 207 syslog client 132 Telnet server 200 document conventions 12 downloading files 176, 183 E egress rate limits displaying 101 setting 89 enabling Auto-Negotiation 89 event log 127 media converter ports 89 Network Time Protocol (NTP) client 117 Secure Shell (SSH) server 213 syslog client 128 Telnet
Index media converter chassis displaying 96, 99, 101 naming 59 media converter modules command summary 70 displaying 96, 99, 101, 108 displaying file systems 188 naming 86 resetting 72, 76 setting operating modes 79, 85 setting ports 89 setting temperature thresholds 86 media converter ports 101 MissingLink operating mode described 80 setting 79, 85 Mode Select button 83 N naming AT-MCF2000AC Power Supply Modules 86 AT-MCF2KFAN Fan Modules 86 management and media converter modules 86 media converter chass
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide setting with a DHCP server 51 setting, manually 52 syslog client command summary 123 default settings 247 described 122 disabling 126 displaying status of 132 enabling 128 guidelines 122 setting facility code 131 setting server’s IP address 131 setting severity level 129 system commands, summary 56, 70 system location displaying 68 setting 64 SYSTEM RESET CHASSIS command 72 SYSTEM RESET CLUSTER command 74 SYSTEM RESET MODULE command
Index 254
