Management Software AT-S85 and AT-S97 ◆ Command Line Interface User’s Guide AT-MCF2000 Media Converter Series Version 1.3.0 613-000789 Rev.
Copyright © 2007 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 Chapter 4: General System Commands ....................................................................................................... 47 Overview ........................................................................................................................................................... 48 Command Summary................................................................................................................................... 48 SYSTEM SET ASYNCHRONOUS...................
AT-S85 and AT-97 Management Software Command Line Interface User’s Guide Chapter 8: Configuration File Commands ................................................................................................ 129 Overview......................................................................................................................................................... 130 Creating a New Master Configuration File ...........................................................................................
Contents Appendix A: AT-S85 and AT-S97 Management Software Default Settings ............................................ 203 Event Log ....................................................................................................................................................... 204 IP Configuration.............................................................................................................................................. 205 Manager Account .........................................
Figures Figure 1: Chassis ID Jumper on the AT-MCF2000M Management Module.........................................................................19 Figure 2: Connecting the RS-232 Serial Management Cable to the RS-232 Terminal Port.................................................20 Figure 3: Command Line Interface Prompt...........................................................................................................................
Figures 8
Tables Table 1: IP Configuration Commands ..................................................................................................................................41 Table 2: General System Configuration Commands ...........................................................................................................48 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-MCF200M 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 all 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 contains the following sections: “Management Overview” on page 16 “Starting a Local Management Session” on page 20 “Starting a Remote Telnet or Secure Shell Management Session” on page 22 “Quitting a Management Session” on page 24 “Command Line Interface Features” on page 25 “Command Formatting” on page 26 “What to Configure First” on page 27 15
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 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. To access the interface, you must log on to the management module with a valid manager name and password.
Chapter 1: Starting a Command Line Management Session command does is it instructs all the modules in a chassis or stack to update their configuration files to match their current settings. You should always perform this command after adjusting the parameter settings of the modules. Otherwise, your changes will be discarded the next time you reset or power cycle the unit.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Chassis ID Jumper AT-M C F200 0M STACK LINK MANA GEME NT ACT 1000 LINK TERM INA L ACT 10/100 LINK ACT PORT FDX ACTIV HDX ITY 10/100 RESE /1000B ASE-T T BOOT COL RDY FAULT RS-232 SD RDY BUSY MAST ER POWE R Chassis ID 0 (Default) Chassis ID 31 Figure 1.
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 port settings are for a DEC VT100 or ANSI terminal, or an equivalent terminal emulator program. 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.
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 3, “IP Configuration Commands” on page 39.
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 12, “Manager Account Commands” on page 187. The section “What to Configure First” on page 27 has suggestions on what you should configure during the initial management session of the chassis.
Chapter 1: Starting a Command Line Management Session 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 switch. This can prevent unauthorized individuals from making changes to a switch’s configuration if you leave your management station unattended.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Command Line Interface Features The command line interface supports the following features: 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.
Chapter 1: Starting a Command Line Management Session 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. 26 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.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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 10.0.0.1 and subnet mask 255.255.252.
Chapter 1: Starting a Command Line Management Session 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. For instructions, Chapter 9, “File System Commands” on page 149.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide This example of the command creates the new master configuration file “mcf_chassis1.cfg” on a management module in a chassis with the ID number 0: config save filesystem=system://0/m/mcf_chassis1.cfg For further information on this command, refer to “CONFIG SAVE FILESYSTEM” on page 143.
Chapter 1: Starting a Command Line Management Session 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.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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.
Chapter 1: Starting a Command Line Management Session Naming a Chassis Naming a chassis will make 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. In Version 1.3.0, this number is either 0 or 31.
Chapter 2 Basic Commands This chapter contains the following commands: “Question Mark ‘?’ Key” on page 34 “CLEAR” on page 35 “EXIT” on page 36 “HELP” on page 37 “PING” on page 38 33
Chapter 2: 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 (i.e., 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 2: 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 2: 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 3 IP Configuration Commands This chapter contains the following sections: “Overview” on page 40 “IP DHCP DISABLE” on page 42 “IP DHCP ENABLE” on page 43 “IP SET” on page 44 “IP SHOW” on page 46 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 Chapter 8, “Configuration File Commands” on page 129.
Chapter 3: 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 will be performing any of these 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 42 Deactivates the DHCP and BOOTP clients on the management module. IP DHCP ENABLE on page 43 Activates the DHCP and BOOTP clients on the management module. IP SET on page 44 Manually sets the IP configuration.
Chapter 3: 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 44.
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 40 for background information on when to assign an IP configuration to the management module.
Chapter 3: 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 3: 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 5. IP Information: IP Address........... Subnet Mask.......... Gateway.............. DHCP................. 149.25.42.11 255.255.255.0 149.25.42.27 Disable Figure 5.
Chapter 4 General System Commands This chapter contains the following sections: “Overview” on page 48 “SYSTEM SET ASYNCHRONOUS” on page 50 “SYSTEM SET CHASSIS” on page 51 “SYSTEM SET CLOCK” on page 52 “SYSTEM SET CONSOLE” on page 53 “SYSTEM SET CONTACT” on page 54 “SYSTEM SET HOSTNAME” on page 55 “SYSTEM SET LOCATION” on page 56 “SYSTEM SHOW ASYNCHRONOUS” on page 57 “SYSTEM SHOW CLOCK” on page 58 “SYSTEM SHOW CONSOLE” on page 59 “SYSTEM SHOW INFO” on page 60
Chapter 4: 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 Command Description “SYSTEM SHOW CONSOLE” on page 59 Displays the console timeout parameter. “SYSTEM SHOW INFO” on page 60 Displays the stack’s name, the name of the network administrator responsible for managing the units, and the location of the stack.
Chapter 4: 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 115200 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. In version 1.3.0, the chassis ID number is 0 or 31. To view the ID number of a unit, use the SYSTEM SHOW CLUSTER command. For instructions, refer to “SYSTEM SHOW CLUSTER” on page 88. name Specifies a name of up to 20 alphanumeric characters for the chassis.
Chapter 4: 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. This information 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 4: 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 4: 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 6. Asynchronous Port (Console) Information: Baud Rate ............................
Chapter 4: 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 and time of the management module. This information is added to event messages and SNMP traps. To manually set the date and time, use the SYSTEM SET CLOCK command. For information, refer to “SYSTEM SET CLOCK” on page 52.
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 4: 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 7. System Information Hostname ............ Engineering MCF Contact ............. Jane Smith Location ............ Bldg 3, Fl 1, Closet 122 Figure 7.
Chapter 5 Port and Module Commands This chapter contains the following sections: “Overview” on page 62 “SYSTEM RESET CHASSIS” on page 64 “SYSTEM RESET CLUSTER” on page 66 “SYSTEM RESET MODULE” on page 68 “SYSTEM SET INTERFACE” on page 71 “SYSTEM SET MODULE” on page 77 “SYSTEM SET PORT” on page 80 “SYSTEM SHOW CHASSIS” on page 86 “SYSTEM SHOW CLUSTER” on page 88 “SYSTEM SHOW INTERFACE” on page 90 “SYSTEM SHOW MODULE” on page 97 Note Remember to save your parameter
Chapter 5: Port and Module Commands Overview The system commands are divided into two groups in this manual. The first group of commands, described in Chapter 4, “General System Commands” on page 47, 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 Command Description “SYSTEM SHOW CHASSIS” on page 86 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 5: Port and Module Commands SYSTEM RESET CHASSIS Syntax system reset chassis id=chassis Parameters id Identifies the ID number of the chassis to reset. In version 1.3.0 the chassis ID number is 0 or 31. To view a unit’s ID number, use the SYSTEM SHOW CLUSTER command. For instructions, refer to “SYSTEM SHOW CLUSTER” on page 88. 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 5: 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 28 or “CONFIG SAVE FILESYSTEM” on page 143.
Chapter 5: 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 with the module to reset. In version 1.3.0 the chassis ID number is 0 or 31. slot Specifies the letter or ID number of the slot with the module.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Note When reset, a management module will be unresponsive to commands for approximately one minute while it initializes the AT-S97 Management Software. Note When reset, a media converter module immediately resumes forwarding network traffic through its ports and channels using its default settings while it initializes its AT-S85 Management Software, a process that takes approximately one minute to complete.
Chapter 5: Port and Module Commands This command resets the media converter module in slot 1 in a chassis with the ID number 31: system reset module id=31/1 70
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 with the media converter module. In version 1.3.0 the chassis ID number is 0 or 31. slot Specifies the ID number of the slot with the module.
Chapter 5: Port and Module Commands 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. Different channels on the same media converter module can be set to different operating modes.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide the channel, because its link to the media converter would otherwise be unaffected. To explain it another way, the MissingLink mode will not allow a port in a channel to form a link with its network device unless the companion port can also establish a link with its device.
Chapter 5: Port and Module Commands 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 will be of little value if the network devices of a channel cannot react to a lost link. In the latter scenario, the Link Test mode would probably be a better operating mode for a channel during normal network operations.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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. However, you might want to limit its use to diagnosing a link failure, particularly if the network devices connected to the ports are managed devices.
Chapter 5: Port and Module Commands The MissingLink mode is intended for situations where the ports of a channel are connected to managed devices, such as managed Fast Ethernet switches, that can react to the loss of a link and perform a specific action, such as send out an SNMP trap or seek a redundant path using a spanning tree protocol. Allied Telesis does not recommend using the Smart MissingLink mode on a channel connected to managed devices during normal operations of the channel.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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 Specifies the ID number of the chassis. In version 1.3.0, the chassis ID number is 0 or 31. slot Specifies the number or letter of the chassis slot with the module.
Chapter 5: Port and Module Commands 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. Different modules in the same chassis can have different temperature thresholds. To view a module’s current temperature threshold value, refer to “SYSTEM SHOW MODULE” on page 97.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Examples This command assigns the name “mm vata” to a management module in a chassis with the chassis ID 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 the ID 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
Chapter 5: Port and Module Commands SYSTEM SET PORT Syntax system set port id=chassis/slot/[channel/]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. You can configure only one port at a time or all the ports of the same type (i.e.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide port Specifies the letter of a port in a channel on a media converter module. Possible values are: a Specifies the twisted pair port. b Specifies the fiber optic port To view the ID and slot numbers of a chassis, refer to “SYSTEM SHOW CLUSTER” on page 88 or “SYSTEM SHOW CHASSIS” on page 86. To view the ports of a channel, refer to “SYSTEM SHOW INTERFACE” on page 90. port-state auto-neg speed Enables and disables the port.
Chapter 5: Port and Module Commands duplex crossover Sets the duplex mode of a port. Available settings are: full Sets the duplex mode of the port to full-duplex. This is the default setting for a fiber optic port that does not support Auto-Negotiation. half Sets the duplex mode of the port to half-duplex. Sets the wiring configuration of a twisted pair port. AutoNegotiation must be disabled on the port to set this parameter. Available settings are: mdi Sets the wiring configuration to MDI.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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. For example, the twisted pair ports on the AT-MCF2012LC media converter module support speeds of 10 and 100 Mbps, but not 1000 Mbps. The PORT-STATE parameter enables and disables a port.
Chapter 5: Port and Module Commands For example, if the network device connected to the twisted pair port of a media converter channel is only capable of half-duplex mode, than both ports of the channel and the network device connected to the fiber optic port in the channel should be configured to operate in half-duplex mode, too.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide system set port id=0/2/5/a auto-neg=disable speed=100 duplex=half Chassis Slot Port Channel This command disables Auto-Negotiation of the twisted pair port in channel 2 of a media converter module and sets the port’s speed and duplex mode to 10 Mbps, full-duplex, and the MDI/MDI-X setting to MDI.
Chapter 5: Port and Module Commands SYSTEM SHOW CHASSIS Syntax system show chassis id=chassis Parameters id Identifies the ID number of a chassis. You can specify only one chassis at a time. In version 1.3.0, the chassis ID number is 0 or 31. To view a unit’s ID number, use the SYSTEM SHOW CLUSTER command. For instructions, refer to “SYSTEM SHOW CLUSTER” on page 88. Privilege Levels Administrator, read-write and read-only.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide The columns are defined here: Chassis ID - The identification number of the chassis. For information, refer to “Chassis ID Numbers” on page 18. Chassis Name - The name of the chassis, set with the SYSTEM SET CHASSIS command. For information, refer to “SYSTEM SET CHASSIS” on page 51. Chassis Type - The chassis’ model name. MAC Address - The chassis’ MAC address.
Chapter 5: Port and Module Commands 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 power supply or fan modules.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Chassis Chassis Chassis MAC Master ID Name Type Address Chassis -----------------------------------------------------------------0 AQ Traffic AT-MCF2000 11:22:33:44:55:55 Yes Slot ID Module Name Module Type Software Version -----------------------------------------------------------M AT-MCF2000M v1.3.0 1 Reg 1 traf AT-MCF2012LC v1.3.0 2 Reg 2 traf AT-MCF2012LC v1.3.
Chapter 5: Port and Module Commands 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 Specifies the ID number of the chassis. In version 1.3.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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.
Chapter 5: Port and Module Commands 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 11 is an example. Interface 0/2 Information: Chassis ID .......... 0 Slot ID ............. 2 Module Name ......... User Module Module Type .........
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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.
Chapter 5: Port and Module Commands Table 6. Port Status in the Smart MissingLink 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.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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 .......
Chapter 5: Port and Module Commands Disabled - The port was disabled with SYSTEM SET PORT command. For information, refer to “SYSTEM SET PORT” on page 80. Link Status - The status of the link of a port to its network device. For definitions, refer to Table 4, “Port Status in the Link Test Mode” on page 93, Table 5, “Port Status in the MissingLink Mode” on page 93, or Table 6, “Port Status in the Smart MissingLink Mode” on page 93.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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 Specifies the ID number of the chassis with the module. In version 1.3.0, the chassis ID number is 0 or 31. slot Specifies the ID number or letter of the slot with the module. Possible values are: m Specifies the management module slot.
Chapter 5: Port and Module Commands RPSA Information: Module Name ................ Module Type ................ Power OK ................... Module Present ............. 3.3V ....................... 12.0V ...................... Temperature ................ Temperature Threshold ...... Fan A Speed ................ Fan B Speed ................ AT-MCF2000AC Yes Present Good = 3.415V Good = 12.125V 25.821 C 60 C 7105 RPM 7033 RPM Figure 13.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide The information for the AT-MCF2012LC and AT-MCF2012LC/1 Media Converter Modules is shown in Figure 15. CPU Information: Name ....................... Module Type ................ Module Status .............. Module Present ............. 1.2V ....................... 1.8V ....................... 2.5V ....................... 3.3V ....................... 12.0V ...................... Temperature ................ Temperature Threshold .....
Chapter 5: Port and Module Commands Stacking Port - The status of the Stack port on the AT-MCF2000M Management Module. A status of Up indicates the port has established a link with a Stack port in another chassis.
Chapter 6 Network Time Protocol Commands This chapter contains the following sections: “Overview” on page 102 “NTP DISABLE” on page 104 “NTP ENABLE” on page 105 “NTP SET” on page 106 “NTP SHOW” on page 107 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 Chapter 8, “Configuration File Commands” on page 129.
Chapter 6: 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 NTP SHOW on page 107 Description Displays the current settings of the NTP client.
Chapter 6: 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 106.
Chapter 6: Network Time Protocol Commands NTP SET Syntax ntp set server=ipaddress Parameters server Specifies the IP address of an NTP server. Privilege Levels Administrator and read-write. Description This command specifies the IP address of the NTP server on your network or the Internet. Example This command specifies the IP address 149.122.55.77 as the NTP server: ntp set server=149.122.55.
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 16. NTP Information: Status ............. Disable Server ............. 0.0.0.0 Figure 16.
Chapter 6: Network Time Protocol Commands 108
Chapter 7 Event Log and Syslog Client Commands This chapter contains the following sections: “Overview” on page 110 “LOGGING CLEAR EVENTLOG” on page 112 “LOGGING DISABLE EVENTLOG” on page 113 “LOGGING DISABLE SYSLOG” on page 114 “LOGGING ENABLE EVENTLOG” on page 115 “LOGGING ENABLE SYSLOG” on page 116 “LOGGING SET EVENTLOG” on page 117 “LOGGING SET SYSLOG” on page 119 “LOGGING SHOW” on page 120 “LOGGING SHOW EVENTLOG” on page 122 Note Remember to save your parameters
Chapter 7: 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, and so 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 3, “IP Configuration Commands” on page 39. Table 8 summarizes the event log and syslog client commands. Table 8.
Chapter 7: 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 120.
Chapter 7: 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 120.
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 120.
Chapter 7: 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 to the syslog server the event messages generated by the modules in the chassis. The default setting for the syslog client is disabled. The IP address of the syslog server is specified with “LOGGING SET EVENTLOG” on page 117.
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 7: 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 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 is 1. Privilege Levels Administrator and read-write.
Chapter 7: 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 17. EventLog Information Status .................. Enable Severity Level .......... Event Syslog Information Status .................. Enable Server .................. 149.22.122.8 Facility Code ........... 1 Figure 17.
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 116 and “LOGGING DISABLE SYSLOG” on page 114.
Chapter 7: 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 18. 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 - 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 - Major events announce a component failure to a fan or media converter module.
Chapter 7: 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 19. Chassis ID 00/2 Slot Identifier Figure 19. Chassis and Slot IDs For background information on chassis ID numbers, refer to “Chassis ID Numbers” on page 18. For the slot identifiers, refer to Table 10. Table 10. Slot Identifiers Identifier Slot 1, 2, ...
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. (Not supported in version 1.3.0 of the management software.) Report Chassis Managership Acquire The management module is active. Report Chassis Managership Release (Not supported in version 1.3.
Chapter 7: Event Log and Syslog Client Commands Table 11. Event Messages (Continued) Message Definition Classification Minor Level Messages 126 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.
Chapter 7: Event Log and Syslog Client Commands Table 11. Event Messages (Continued) Message Definition Xmodem Session Close The management module completed uploading or downloading a file using Xmodem. (Not supported in version 1.3.0 of the management software.) Report Xmodem Session Open The management module uploaded or downloaded a file during a local management session using Xmodem.
Chapter 8 Configuration File Commands This chapter contains the following sections: “Overview” on page 130 “CONFIG RUN” on page 141 “CONFIG SAVE” on page 142 “CONFIG SAVE FILESYSTEM” on page 143 “CONFIG SET” on page 145 “CONFIG SHOW” on page 147 129
Chapter 8: 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 8: 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 9, “File System Commands” on page 149. 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 a media converter module is removed from a chassis and installed into a different slot, either in the same or a different chassis, it immediately queries the management module to determine whether the slot had been used before and, if it had, whether the previous module had been of the same model.
Chapter 8: Configuration File Commands File Header Lines At the top of the file are three lines of header information, shown in Figure 20. These lines should never be modified or deleted. ## Filename: MM.cfg ## Model Type: AT-MCF2000M ## MAC Address: 00:15:77:70:7A:25 Figure 20. Management Module Configuration Header System Configuration The commands in this section define general information about the management module.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide parameter for the power supply and fan modules. For further information on this command, refer to “SYSTEM SET MODULE” on page 77. IP Configuration The commands in this section define the IP configuration of the management module. ### Ip Configuration ip dhcp disable ip set ip-address=192.168.1.2 ip set subnetmask=255.255.255.0 ip set default-gateway=0.0.0.0 Figure 22.
Chapter 8: Configuration File Commands NTP Configuration This section controls the NTP client for setting the modules date and time from an NTP server on your network or the Internet. ### Ntp Configuration ntp set server=0.0.0.0 ntp disable Figure 24.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Note Do not modify existing manager accounts or add new accounts by editing the master configuration file. Instead, use the command line interface in the management software. You can delete accounts by deleting the corresponding line in the file, but do not delete the predefined manager account (i.e., NAME=MANAGER). For further information, refer to Chapter 12, “Manager Account Commands” on page 187.
Chapter 8: Configuration File Commands Converter Modules represents twisted pair port 1 and fiber optic port 1, PORTID=2 designates channel 2 of twisted pair port 2 and fiber optic port 2, and so on. ### Blade Configuration system system system system system set set set set set interface interface interface interface interface portId=1 portId=2 portId=3 portId=4 portId=5 OpMode=link-test OpMode=link-test OpMode=link-test OpMode=link-test OpMode=link-test Figure 28.
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 port must have its own command line. A port can have more than one command line. A command line cannot exceed eighty characters. If you delete a port’s configuration command from the file, the port operates with the default settings. The ID parameter specifies just the channel number and port letter.
Chapter 8: Configuration File Commands Command Summary Table 12 summarizes the configuration file commands. Table 12. Configuration File Commands Command 140 Description “CONFIG RUN” on page 141 Configures the parameter settings on all the modules using the active master configuration file on the management module CONFIG SAVE on page 142 Updates the active configuration file with the latest changes to the parameter settings. Also creates new master configuration files.
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 8: Configuration File Commands 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. You should enter this command whenever you have made parameter changes that you want the modules to retain even after a reset or a power cycle.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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 with the management module where the file will be stored. The ID number for the chassis with a management module is either 0 or 31.
Chapter 8: Configuration File Commands 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 130. 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. For instructions, refer to “CONFIG SET” on page 145.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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.
Chapter 8: Configuration File Commands 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 141. Do not issue the CONFIG SAVE command.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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 31. Last configuration file ran ............. unit12.cfg Current set configuration file .......... unit12.cfg (Exists) Active master configuration file Figure 31.
Chapter 8: Configuration File Commands Last configuration file ran ............. unit12.cfg Current set configuration file .......... mcf24.cfg (Exists) Figure 32. 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 File System Commands This chapter contains the following sections: “Overview” on page 150 “FILE COPY” on page 153 “FILE DELETE” on page 156 “FILE DOWNLOAD” on page 159 “FILE RENAME” on page 166 “FILE SHOW” on page 169 “FILE UPLOAD” on page 172 149
Chapter 9: 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 1. Upload a master configuration file from the management module to a TFTP server using the FILE UPLOAD command. For instructions, refer to “FILE UPLOAD” on page 172. 2. Edit the file at your workstation. For instructions, refer to “Editing a Master Configuration File” on page 133. 3. Download the file back to the management module using the FILE DOWNLOAD command. For instructions, refer to “FILE DOWNLOAD” on page 159. 4.
Chapter 9: File System Commands Command Summary Table 13 summarizes the file system commands. Table 13. File System Commands Command 152 Description “FILE COPY” on page 153 Creates copies of the configuration files in the file systems of the management and media converter modules. “FILE DELETE” on page 156 Deletes the configuration files from the file systems on the modules.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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. In version 1.3.0, the ID number is 0 or 31. slot Identifies the slot with the module containing the file.
Chapter 9: File System Commands 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”; 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.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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 the ID number 0. The copy is named “BM_backup.cfg”: file copy srcfile=system://0/2/BM.cfg dstfile=system://0/2/"BM_backup.
Chapter 9: File System Commands 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. In version 1.3.0, the chassis 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 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 8, “Configuration File Commands” on page 129.
Chapter 9: File System Commands This command deletes all the configuration files starting with “BM” from a media converter module in slot 2 in a chassis with the ID number 31: file delete filesystem=system://31/2/BM*.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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.
Chapter 9: File System Commands support stacking, you can still use the asterisk as a wildcard to designate the chassis. 0 or 31 slot In version 1.3.0, 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.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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.
Chapter 9: File System Commands This command has the following guidelines: The filename extension of the source file must be “.BIN” and the destination must be BOOTBLOCK. When upgrading both the boot loader and the management software on the modules, you should download the new boot loader file first. Since this command uses the TFTP client on the management module, Allied Telesis recommends reviewing the information in “Guidelines to Using the TFTP Client” on page 151 prior to using the command.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Note A management module resets after receiving a new version of the AT-S97 Management Software. It will be unresponsive to commands for approximately one minute while it initializes the new management software.
Chapter 9: File System Commands Since the asterisk is used to indicate all slots in the chassis, the management module will receive the file as well. But since the AT-S85 boot loader is intended for media converter modules, it will discard the file and generate an error message. You can ignore the message. Note The above example is the preferred command for upgrading the boot loader on the media converter modules in a chassis.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Note The above example is the preferred command for upgrading the management software on the media converter modules in a chassis. Downloading management software onto some but not all of the modules of a chassis may cause compatibility problems. 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.
Chapter 9: File System Commands 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 of the following parts: chassis Specifies the ID number of a chassis. In version 1.3.0, the ID number is 0 or 31. slot Identifies the slot number of a module. Possible values are: filename m Identifies the management module slot.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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.
Chapter 9: File System Commands 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.cfg” in the file system of a media converter module in slot 1 of a chassis with the ID 0: file rename srcfile=system://0/1/BM.cfg dstfile=system://0/1/BM_2.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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. In version 1.3.0, the chassis ID number is 0 or 31. slot Specifies the ID number or letter of the slot with the module.
Chapter 9: File System Commands 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 34. 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.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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 the ID number 0: file show filesystem=system://0/2/*.
Chapter 9: File System Commands 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.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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 “.
Chapter 9: File System Commands 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 the ID number 0: file upload srcfile=system://0/m/traffic_n2.cfg dstfile=tftp://150.24.44.65/traffic_n2.
Chapter 10 Telnet Server Commands This chapter contains the following sections: “Overview” on page 176 “TELNET DISABLE” on page 178 “TELNET ENABLE” on page 179 “TELNET SHOW” on page 180 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 142.
Chapter 10: 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 179 Activates the Telnet application protocol server. TELNET SHOW on page 180 Displays the current settings of the Telnet server.
Chapter 10: 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. This 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 176 for the preconditions for remote Telnet management.
Chapter 10: 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 35. Telnet Status ........ Enable Figure 35.
Chapter 11 Secure Shell Server Commands This chapter contains the following sections: “Overview” on page 182 “SSH DISABLE” on page 184 “SSH ENABLE” on page 185 “SSH SHOW” on page 186 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 142.
Chapter 11: Secure Shell Server 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 3, “IP Configuration Commands” on page 39. 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 11: Secure Shell Server 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 182 for the requirements of remote SSH management.
Chapter 11: Secure Shell Server 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 36. SSH Status ........ Enable Figure 36.
Chapter 12 Manager Account Commands This chapter contains the following sections: “Overview” on page 188 “USER ADD” on page 190 “USER DELETE” on page 191 “USER SET” on page 192 “USER SHOW” on page 194 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 142.
Chapter 12: Manager Account Commands Overview The AT-S97 Management Software comes with 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 the parameters on the modules in a chassis or stack. The management module can support additional manager accounts, a useful feature when more than one administrator will be managing a device.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide Table 16. Manager Account Commands Command Description USER SET on page 192 Modifies the password and privilege level of a manager account. USER SHOW on page 194 Displays the current manager accounts.
Chapter 12: Manager Account Commands USER ADD Syntax user add username=name privilege=read|readwrite Parameters username Specifies a name for the new manager account. The name can be from 1 to 16 alphanumeric characters. The name is case sensitive. Spaces are allowed, but a name with spaces must be enclosed in double quotes. privilege Specifies the privilege level of the account. Options are: read Allows the account user to view but not change the parameter settings of the modules.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide USER DELETE Syntax user delete username=name Parameters username Specifies the name of the manager account to delete. The name is case sensitive and must be enclosed in double quotes if it contains a space. Privilege Levels Administrator Description This command deletes a manager account from the management module. To view the manager accounts, use the USER SHOW command. You cannot delete the predefined manager account.
Chapter 12: Manager Account Commands USER SET Syntax user set username=name password privilege=read|readwrite Parameters username Specifies the name of the manager account to modify. The name is case sensitive and must be enclosed in double quotes if it contains a space. password Changes the password of the account. A prompt for the new password is displayed after the command is entered. A password can be up to 16 alphanumeric characters and is case sensitive.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide 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 193
Chapter 12: Manager Account Commands 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 37. The first entry in the table, “manager,” is the predefined manager account. For background information, refer to “Overview” on page 188.
Chapter 13 Diagnostics Commands This chapter contains the following sections: “Overview” on page 196 “DIAGNOSTICS SHOW CHASSIS” on page 197 “DIAGNOSTICS SHOW MODULE” on page 199 195
Chapter 13: 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 Table 17 summarizes the diagnostics commands. Table 17. Diagnostics Commands Command 196 Description DIAGNOSTICS SHOW CHASSIS on page 197 Displays manufacturing information about a module.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide DIAGNOSTICS SHOW CHASSIS Syntax diagnostics show chassis id=chassis eeprom|software Parameters id Identifies the ID number of a chassis. In version 1.3.0 the chassis ID number is 0 or 31. To view a unit’s ID number, use the SYSTEM SHOW CLUSTER command. For instructions, refer to “SYSTEM SHOW CLUSTER” on page 88. eeprom Displays the serial numbers, hardware revision levels, and MAC addresses of the modules.
Chapter 13: Diagnostics Commands The SOFTWARE parameter displays the information in Figure 39. Slot ID Module Name Module Type Software Version --------------------------------------------------------------M AT-MCF2000M v1.3.0 1 AT-MCF2012LC v1.3.0 2 AT-MCF2012LC v1.3.0 Figure 39. DIAGNOSTICS SHOW CHASSIS SOFTWARE Command The fields are defined here: Slot ID: A slot in the chassis. Possible values are: – C: The chassis.
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. In version 1.3.0 the ID number of a chassis is 0 or 31. slot Specifies the slot number of the media converter module with the port.
Chapter 13: 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 the ID 0: diagnostics show module id=0/m This command displays information about the media converter module in slot 2 of a chassis with the ID 0: diagnostics show module id=0/2 201
Chapter 13: Diagnostics Commands 202
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 Event Log The following table lists the default settings for the event log.
AT-S85 and AT-97 Management Software Command Line Interface User’s Guide IP Configuration The following table lists the default settings for the IP configuration of the management module. IP Configuration Setting Default IP Address 10.0.0.1 Subnet Mask 255.255.252.0 Default Gateway 0.0.0.
Appendix A: AT-S85 and AT-S97 Management Software Default Settings 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.
AT-S85 and AT-97 Management Software Command Line Interface User’s Guide Master Configuration File The following table lists the name of the default master configuration file.
Appendix A: AT-S85 and AT-S97 Management Software Default Settings Network Time Protocol Client The following table lists the default settings for the NTP client. Network Time Protocol Client Setting 208 Default Client Status Disabled NTP Server IP Address 0.0.0.
AT-S85 and AT-97 Management Software Command Line Interface User’s Guide 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 The baud rate is the only adjustable parameter on the port.
Appendix A: AT-S85 and AT-S97 Management Software Default Settings Secure Shell Server The following table lists the SSH server default settings. Telnet Server Setting SSH Server Disabled Protocol Port Number 22 The protocol port number is not adjustable.
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 Telnet Server Disabled Protocol Port Number 23 The protocol port number is not adjustable.
Index Numerics B 10/100/1000Base-T Management port displaying status of 97 setting 80 boot loader files, downloading 159 A active master configuration file described 132 displaying name of 147 running 141 setting 145 updating 17, 142 AT-MCF2000AC Power Supply Modules displaying status of 97 naming 77 setting temperature threshold 77 AT-MCF2000M Management Modules displaying 86, 88, 97 displaying file system on 169 naming 77 resetting 64, 68 setting 10/100/1000Base-T Management port 80 setting temperatu
Index SSH DISABLE 184 SSH ENABLE 185 SSH SHOW 186 SYSTEM RESET CHASSIS 64 SYSTEM RESET CLUSTER 66 SYSTEM RESET MODULE 68 SYSTEM SET ASYNCHRONOUS 50 SYSTEM SET CHASSIS 51 SYSTEM SET CLOCK SYSTEM SET CONSOLE 53 SYSTEM SET CONTACT 54 SYSTEM SET HOSTNAME 55 SYSTEM SET INTERFACE 71 SYSTEM SET LOCATION 56 SYSTEM SET MODULE 77 SYSTEM SET PORT 80 SYSTEM SHOW ASYNCHRONOUS 57 SYSTEM SHOW CHASSIS 86 SYSTEM SHOW CLOCK 58 SYSTEM SHOW CLUSTER 88 SYSTEM SHOW CONSOLE 59 SYSTEM SHOW INFO 60 SYSTEM SHOW INTERFACE 90 SYSTEM
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide media converter ports 90 Network Time Protocol (NTP) client 107 Secure Shell (SSH) server 186 syslog client 120 Telnet server 180 document conventions 12 downloading files 159 E egress rate limits displaying 90 setting 80 enabling Auto-Negotiation 80 event log 115 media converter ports 80 Network Time Protocol (NTP) client 105 Secure Shell (SSH) server 185 syslog client 116 Telnet server 179 event log command summary 111 default set
Index media converter chassis displaying 86, 88, 90 naming 51 media converter modules command summary 62 displaying 86, 88, 90, 97 displaying file systems 169 naming 77 resetting 64, 68 setting operating modes 71 setting ports 80 setting temperature thresholds 77 media converter ports 90 MissingLink operating mode described 72 setting 71 Mode Select button 75 N naming AT-MCF2000AC Power Supply Modules 77 AT-MCF2FAN Fan Modules 77 management and media converter modules 77 media converter chassis 51 stacks
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide disabling 114 displaying status of 120 enabling 116 guidelines 110 setting facility code 119 setting server’s IP address 119 setting severity level 117 system commands, summary 48, 62 system location displaying 60 setting 56 SYSTEM RESET CHASSIS command 64 SYSTEM RESET CLUSTER command 66 SYSTEM RESET MODULE command 68 SYSTEM SET ASYNCHRONOUS command 50 SYSTEM SET CHASSIS command 51 SYSTEM SET CLOCK command 52 SYSTEM SET CONSOLE comma
Index 218
