Allied Telesis AT-S97 User Manual
◆
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. C
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. reserves the right to make changes in specifications and other information contained in this document without prior
written notice. The information provided herein is subject to change without notice. In no event shall Allied Telesis, Inc.be liable for any
incidental, special, indirect, or consequential damages whatsoever, including but not limited to lost profits, arising out of or related to this
manual or the information contained herein, even if Allied Telesis, Inc. has been advised of, known, or should have known, the possibility of
such damages.
Contents
Preface ............................................................................................................................................................ 11
Document Conventions .................................................................................................................................... 12
Where to Find Web-based Guides ................................................................................................................... 13
Contacting Allied Telesis .................................................................................................................................. 14
Online Support ........................................................................................................................................... 14
Email and Telephone Support.................................................................................................................... 14
Warranty..................................................................................................................................................... 14
Returning Products .................................................................................................................................... 14
Sales or Corporate Information.................................................................................................................. 14
Management Software Updates................................................................................................................. 14
Chapter 1: Starting a Command Line Management Session .................................................................... 15
Management Overview..................................................................................................................................... 16
AT-S85 and AT-S97 Management Software.............................................................................................. 16
Features of the AT-S97 Management Software......................................................................................... 16
AT-S97 Command Line Interface............................................................................................................... 17
Manager Privilege Levels........................................................................................................................... 17
Saving Your Configuration Changes.......................................................................................................... 17
Setting Chassis ID Numbers ...................................................................................................................... 18
Starting a Local Management Session............................................................................................................. 20
Starting a Remote Telnet or Secure Shell Management Session .................................................................... 22
SNMP Management Session ........................................................................................................................... 24
Quitting a Management Session ...................................................................................................................... 25
Command Line Interface Features ................................................................................................................... 26
Command Formatting....................................................................................................................................... 27
What to Configure First..................................................................................................................................... 28
Displaying the Chassis Modules ................................................................................................................ 28
Changing the Manager Password.............................................................................................................. 29
Creating a Master Configuration File ......................................................................................................... 29
Assigning an IP Configuration.................................................................................................................... 31
Setting the Date and Time ......................................................................................................................... 32
Enabling the Telnet or Secure Shell Server ............................................................................................... 32
Naming a Chassis ...................................................................................................................................... 33
Saving Your Changes ................................................................................................................................ 33
Chapter 2: Stacking ....................................................................................................................................... 35
Overview........................................................................................................................................................... 36
Stacking Guidelines ................................................................................................................................... 36
Required Modules ............................................................................................................................................ 37
AT-S85 and AT-S97 Management Software Versions ..................................................................................... 38
Setting Up Stacking .......................................................................................................................................... 39
Chapter 3: Basic Commands ........................................................................................................................ 41
Question Mark ‘?’ Key ...................................................................................................................................... 42
CLEAR.............................................................................................................................................................. 43
EXIT.................................................................................................................................................................. 44
3
Contents
HELP................................................................................................................................................................. 45
PING .................................................................................................................................................................46
Chapter 4: IP Configuration Commands ...................................................................................................... 47
Overview ........................................................................................................................................................... 48
Command Summary................................................................................................................................... 49
IP DHCP DISABLE ........................................................................................................................................... 50
IP DHCP ENABLE ............................................................................................................................................ 51
IP SET............................................................................................................................................................... 52
IP SHOW .......................................................................................................................................................... 54
Chapter 5: General System Commands ....................................................................................................... 55
Overview ........................................................................................................................................................... 56
Command Summary................................................................................................................................... 56
SYSTEM SET ASYNCHRONOUS.................................................................................................................... 58
SYSTEM SET CHASSIS .................................................................................................................................. 59
SYSTEM SET CLOCK...................................................................................................................................... 60
SYSTEM SET CONSOLE................................................................................................................................. 61
SYSTEM SET CONTACT................................................................................................................................. 62
SYSTEM SET HOSTNAME .............................................................................................................................. 63
SYSTEM SET LOCATION................................................................................................................................ 64
SYSTEM SHOW ASYNCHRONOUS ...............................................................................................................65
SYSTEM SHOW CLOCK..............................................................................................................
.................... 66
SYSTEM SHOW CONSOLE ............................................................................................................................ 67
SYSTEM SHOW INFO ..................................................................................................................................... 68
Chapter 6: Port and Module Commands ...................................................................................................... 69
Overview ........................................................................................................................................................... 70
Command Summary................................................................................................................................... 70
SYSTEM RESET CHASSIS .............................................................................................................................72
SYSTEM RESET CLUSTER ............................................................................................................................74
SYSTEM RESET MODULE .............................................................................................................................. 76
SYSTEM SET INTERFACE.............................................................................................................................. 79
SYSTEM SET INTERFACE PORTNAME......................................................................................................... 85
SYSTEM SET MODULE................................................................................................................................... 86
SYSTEM SET PORT ........................................................................................................................................89
SYSTEM SHOW CHASSIS ..............................................................................................................................96
SYSTEM SHOW CLUSTER ............................................................................................................
................. 99
SYSTEM SHOW INTERFACE........................................................................................................................ 101
SYSTEM SHOW MODULE............................................................................................................................. 108
Chapter 7: Network Time Protocol Commands ......................................................................................... 113
Overview ......................................................................................................................................................... 114
NTP Client Guidelines ..............................................................................................................................114
Command Summary................................................................................................................................. 114
NTP DISABLE................................................................................................................................................. 116
NTP ENABLE..................................................................................................................................................117
NTP SET......................................................................................................................................................... 118
NTP SHOW..................................................................................................................................................... 119
Chapter 8: Event Log and Syslog Client Commands ...............................................................................121
Overview ......................................................................................................................................................... 122
Syslog Client Guidelines........................................................................................................................... 122
Command Summary................................................................................................................................. 123
LOGGING CLEAR EVENTLOG......................................................................................................................124
LOGGING DISABLE EVENTLOG .................................................................................................................. 125
LOGGING DISABLE SYSLOG .......................................................................................................................126
4
AT-S85 and AT-97 Management Software Command Line Interface User’s Guide
LOGGING ENABLE EVENTLOG ................................................................................................................... 127
LOGGING ENABLE SYSLOG........................................................................................................................ 128
LOGGING SET EVENTLOG .......................................................................................................................... 129
LOGGING SET SYSLOG ............................................................................................................................... 131
LOGGING SHOW........................................................................................................................................... 132
LOGGING SHOW EVENTLOG ...................................................................................................................... 134
Chapter 9: Configuration File Commands ................................................................................................ 141
Overview......................................................................................................................................................... 142
Creating a New Master Configuration File ............................................................................................... 143
Specifying the Active Master Configuration File....................................................................................... 144
Auxiliary Configuration Files..................................................................................................................... 144
Editing a Master Configuration File .......................................................................................................... 146
Command Summary ................................................................................................................................ 152
CONFIG OVERWRITE................................................................................................................................... 154
CONFIG RUN................................................................................................................................................. 155
CONFIG SAVE ............................................................................................................................................... 157
CONFIG SAVE FILESYSTEM........................................................................................................................ 158
CONFIG SET.................................................................................................................................................. 160
CONFIG SHOW ............................................................................................................................................. 162
Chapter 10: File System Commands ......................................................................................................... 165
Overview......................................................................................................................................................... 166
Managing a Module’s File System ........................................................................................................... 166
Updating the AT-S85 and AT-S97 Management Software ...................................................................... 166
Uploading or Downloading a Master Configuration File........................................................................... 167
Guidelines to Using the TFTP and Xmodem Client ................................................................................. 167
Command Summary ................................................................................................................................ 168
FILE COPY..................................................................................................................................................... 170
FILE DELETE ................................................................................................................................................. 173
FILE DOWNLOAD.......................................................................................................................................... 176
FILE FASTDOWNLOAD................................................................................................................................. 183
FILE RENAME................................................................................................................................................ 185
FILE SHOW.................................................................................................................................................... 188
FILE UPLOAD ................................................................................................................................................ 191
Chapter 11: Telnet Server Commands ...................................................................................................... 195
Overview......................................................................................................................................................... 196
Telnet Server Guidelines.......................................................................................................................... 196
Command Summary ................................................................................................................................ 196
TELNET DISABLE.......................................................................................................................................... 198
TELNET ENABLE........................................................................................................................................... 199
TELNET SHOW.............................................................................................................................................. 200
Chapter 12: Simple Network Management Protocol (SNMP) Commands .............................................. 201
Overview......................................................................................................................................................... 202
Community String Attributes .................................................................................................................... 202
Command Summary ................................................................................................................................ 204
SNMP SET ..................................................................................................................................................... 205
SNMP SHOW ................................................................................................................................................. 207
Chapter 13: Secure Shell Server (SSH) Commands ................................................................................. 209
Overview......................................................................................................................................................... 210
SSH Server Guidelines ............................................................................................................................ 210
Command Summary ................................................................................................................................ 211
SSH DISABLE ................................................................................................................................................ 212
5
Contents
SSH ENABLE .................................................................................................................................................213
SSH SHOW .................................................................................................................................................... 214
Chapter 14: Manager Account Commands ................................................................................................ 215
Overview ......................................................................................................................................................... 216
Manager Account Guidelines ................................................................................................................... 216
Command Summary................................................................................................................................. 216
USER ADD ..................................................................................................................................................... 218
USER DELETE ............................................................................................................................................... 220
USER SET ......................................................................................................................................................221
USER SHOW ..................................................................................................................................................223
Chapter 15: Diagnostics Commands ......................................................................................................... 225
Overview ......................................................................................................................................................... 226
Command Summary................................................................................................................................. 226
DIAGNOSTICS SHOW BOOTLOADER ......................................................................................................... 227
DIAGNOSTICS SHOW CHASSIS ..................................................................................................................229
DIAGNOSTICS SHOW MODULE...................................................................................................................231
DIAGNOSTICS SHOW SOFTWARE..............................................................................................................234
Appendix A: AT-S85 and AT-S97 Management Software Default Settings ............................................237
Configuration File............................................................................................................................................238
Event Log........................................................................................................................................................239
IP Configuration .............................................................................................................................................. 240
Manager Account............................................................................................................................................241
Master Configuration File................................................................................................................................ 242
Network Time Protocol Client .........................................................................................................................243
RS-232 Terminal Port .....................................................................................................................................244
Secure Shell Server ........................................................................................................................................ 245
Simple Network Management Protocol .......................................................................................................... 246
Syslog Client ...................................................................................................................................................247
Telnet Server .................................................................................................................................................. 248
6
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............................................................................................................................28
Figure 5: AT-MCF2000M Management Module ...................................................................................................................37
Figure 6: AT-MCF2000S Stacking Module ...........................................................................................................................37
Figure 7: IP SHOW Command .............................................................................................................................................54
Figure 8: SYSTEM SHOW ASYNCHRONOUS Command ..................................................................................................65
Figure 9: SYSTEM SHOW CLOCK Command.....................................................................................................................66
Figure 10: SYSTEM SHOW INFO Command ......................................................................................................................68
Figure 11: SYSTEM SHOW CHASSIS Command ...............................................................................................................97
Figure 12: SYSTEM SHOW CLUSTER Command ............................................................................................................100
Figure 13: SYSTEM SHOW INTERFACE Command - Chassis ID Only............................................................................102
Figure 14: Chassis ID and Slot ID ......................................................................................................................................103
Figure 15: SYSTEM SHOW INTERFACE Command - Chassis ID, Slot ID, and Channel.................................................106
Figure 16: SYSTEM SHOW MODULE Command for a Power Supply or Fan Module ......................................................109
Figure 17: SYSTEM SHOW MODULE Command for the Management Module................................................................110
Figure 18: SYSTEM SHOW MODULE Command for a Media Converter Module .............................................................110
Figure 19: NTP SHOW Command......................................................................................................................................119
Figure 20: LOGGING SHOW Command............................................................................................................................132
Figure 21: LOGGING SHOW EVENT-LOG Command ......................................................................................................134
Figure 22: Chassis and Slot IDs .........................................................................................................................................136
Figure 23: Management Module Configuration Header......................................................................................................146
Figure 24: System Configuration Section ...........................................................................................................................146
Figure 25: IP Configuration Section....................................................................................................................................147
Figure 26: Log Configuration Section .................................................................................................................................148
Figure 27: NTP Configuration Section................................................................................................................................148
Figure 28: Telnet and SSH Configuration Section..............................................................................................................149
Figure 29: User Configuration Section................................................................................................................................149
Figure 30: Blade Configuration Header ..............................................................................................................................150
Figure 31: Blade Configuration - Operating Mode Section .................................................................................................150
Figure 32: Blade Configuration - Port Operating Parameters .............................................................................................151
Figure 33: Blade Configuration - Module Name and Temperature Threshold Section.......................................................152
Figure 34: CONFIG SHOW Command...............................................................................................................................162
Figure 35: CONFIG SHOW Command with a New Active Master File...............................................................................163
Figure 36: CONFIG SHOW Command with a New Current and Active Master File...........................................................163
Figure 37: FILE SHOW Command .....................................................................................................................................189
Figure 38: TELNET SHOW Command...............................................................................................................................200
Figure 39: SNMP SHOW Command ..................................................................................................................................207
Figure 40: SSH SHOW Command .....................................................................................................................................214
Figure 41: USER SHOW Command...................................................................................................................................223
Figure 42: DIAGNOSTICS SHOW BOOTLOADER Command..........................................................................................227
Figure 43: DIAGNOSTICS SHOW CHASSIS EEPROM Command...................................................................................229
Figure 44: DIAGNOSTICS SHOW MODULE Command....................................................................................................232
Figure 45: DIAGNOSTICS SHOW SOFTWARE Command...............................................................................................234
7
Figures
8
Tab le s
Table 1: IP Configuration Commands ..................................................................................................................................49
Table 2: General System Configuration Commands ...........................................................................................................56
Table 3: Port and Module Commands .................................................................................................................................70
Table 4: Port Status in the Link Test Mode ........................................................................................................................104
Table 5: Port Status in the Missing Link Mode ..................................................................................................................104
Table 6: Port Status in the Smart Missing Link Mode ........................................................................................................104
Table 7: NTP Client Commands ........................................................................................................................................114
Table 8: Event Log and Syslog Client Commands ............................................................................................................123
Table 9: Severity Level Definitions ....................................................................................................................................135
Table 10: Slot Identifiers ....................................................................................................................................................136
Table 11: Event Messages ................................................................................................................................................136
Table 12: Configuration File Commands ...........................................................................................................................152
Table 13: File System Commands .....................................................................................................................................168
Table 14: Telnet Server Commands ..................................................................................................................................196
Table 15: SNMP Commands .............................................................................................................................................204
Table 16: Secure Shell Server Commands .......................................................................................................................211
Table 17: Manager Account Commands ...........................................................................................................................216
Table 18: Diagnostics Commands .....................................................................................................................................226
9
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.
This Preface contains the following sections:
“Document Conventions” on page 12
“Where to Find Web-based Guides” on page 13
“Contacting Allied Telesis” on page 14
Caution
The software described in this documentation contains certain
cryptographic functionality and its export is restricted by U.S. law. As
of this writing, it has been submitted for review as a “retail encryption
item” in accordance with the Export Administration Regulations, 15
C.F.R. Part 730-772, promulgated by the U.S. Department of
Commerce, and conditionally may be exported in accordance with
the pertinent terms of License Exception ENC (described in 15
C.F.R. Part 740.17). In no case may it be exported to Cuba, Iran,
Iraq, Libya, North Korea, Sudan, or Syria. If you wish to transfer this
software outside the United States or Canada, please contact your
local Allied Telesis sales representative for current information on
this product’s export status.
11
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.
12
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.
For details about the features and functions of the AT-MCF2000 media
converter, see the following installation guides on our web site:
AT-MCF2000 Multi-channel Media Converter Chassis Installation
Guide (part number 613-000573)
AT-MCF2000M Management Module Installation Guide (part number
613-000709)
AT-MCF2000S Stacking Module Installation Guide (part number 613-
000708)
13
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.
Email and
Telephone
Support
Warranty All of the products in the AT-MCF2000 Media Converter Series have a 5
Returning
Products
Sales or
Corporate
Information
Management
Software Updates
For Technical Support via email or telephone, refer to the Support section
of the Allied Telesis web site: www.alliedtelesis.com.
Year Warranty. All Allied Telesis warranties are subject to the terms and
conditions set out in the Allied Telesis Limited Warranties on our web site
at www.alliedtelesis.com/warranty/default.aspx.
Products for return or repair must first be assigned a return materials
authorization (RMA) number. A product sent to Allied Telesis without an
RMA number will be returned to the sender at the sender’s expense. For
instructions on how to obtain an RMA number, go to the Support section
on our web site at www.alliedtelesis.com.
You can contact Allied Telesis for sales or corporate information through
our web site at www.alliedtelesis.com.
New releases of the management software for our managed products are
available from the following Internet sites:
14
Allied Telesis web site: www.alliedtelesis.com
Allied Telesis FTP server: ftp://ftp.alliedtelesis.com
If the FTP server prompts you to log on, enter “anonymous” as the user
name and your email address as the password.
Chapter 1
Starting a Command Line Management Session
This chapter describes the basic characteristics of the management
software. It 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
“SNMP Management Session” on page 24
“Quitting a Management Session” on page 25
“Command Line Interface Features” on page 26
“Command Formatting” on page 27
“What to Configure First” on page 28
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
Features of the
AT-S97
Management
Software
The modules in the AT-MCF2000 Series use two different operating
systems. The AT-MCF2000M Management Module uses the AT-S97
Management Software and the AT-MCF2000 Media Converter Module
Series, such as the AT-MCF2012LC and AT-MCF2012LC/1 Modules, use
the AT-S85 Management Software.
All of your commands must be entered through the AT-S97 Management
Software on the management module. Commands intended for a media
converter module are automatically transferred by the management
module to the appropriate module in the chassis or stack.
Version 2.0.0 of the AT-S97 Management Software has the following
features:
Control over the operating parameters of the twisted pair and fiber
optic ports of the media converter channels, including:
– Auto-Negotiation
– Speed
– Duplex mode
– MDI/MDI-X configuration
Selection of a channel’s operating mode:
16
– MissingLink™
– Smart MissingLink
– Link Test
Rate limits for the ingress and egress packets on the ports of the
media converter channels.
Network Time Protocol (NTP) client for setting the system’s date and
time from a NTP server on your network or the Internet.
Stacking of up to eight AT-MCF2000 Chassis and 16 media converter
modules.
Telnet server for remote management without encryption from a
management station on your network.
Simple Network Management Protocol (SNMP) to manage a media
converter by viewing and changing the management information base
(MIB) objects on the device
Secure Shell (SSH) server for remote management with encryption.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide
Event log for monitoring the operations of the modules.
Syslog client for transmitting event messages to a Syslog server.
AT-S97
Command Line
Interface
Manager
Privilege Levels
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.
Note
The first management session of the chassis must be from a local
management session. For instructions, refer to “Starting a Local
Management Session” on page 20.
The management software has three manager privilege levels:
administrator
read-write
read-only
The privilege level of administrator is restricted to the management
module’s predefined manager account, which has the user name of
“manager” and the default password “friend.”
Saving Your
Configuration
Changes
The management module can support ten additional manager accounts
with the privilege level of read-write and another ten accounts of read-only.
The read-write level is nearly identical to the administrator level of the
predefined manager account. It provides access to almost all of the same
parameters settings, with a few exceptions, detailed in Chapter 14,
“Manager Account Commands” on page 215. In contrast, the read-only
privilege level restricts a network administrator to just viewing the
parameter settings.
The privilege level required to perform a command is included in the
descriptions of the commands in this manual.
Note
Only the predefined manager account can have the privilege level of
administrator.
The configuration settings of the management and media converter
modules of a chassis or stack are stored in a series of files called
configuration files in the modules’ file systems. The most important of
these files is the active master configuration file on the management
module, which, as its name implies, contains all of the settings of a chassis
or stack. What the configuration files do is they retain the parameter
17
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. This command
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 are discarded when you reset or power
cycle the unit.
Note
Many of the chapters in this guide have a note on the first page
reminding you to update the configuration files with the CONFIG
SAVE command after entering your parameter changes.
Setting Chassis
ID Numbers
For further information on configuration files and the CONFIG SAVE
command, refer to Chapter 9, “Configuration File Commands” on page
141.
Commands that configure or display the parameters on a media converter
module must include a chassis ID number. This parameter identifies the
chassis with the media converter module. For example, to configure a port
on a media converter module with the SYSTEM SET PORT command,
you must include in the command the chassis ID of the unit with the
module. See Figure 1.
Chassis ID Jumper
AT-MCF2000M
ST
A
C
K
L
IN
K
AC
T
M
A
N
AG
E
M
1
E
000
N
T
L
INK
AC
T10
/10
T
E
0 L
R
M
IN
IN
KAC
A
L
T
F
P
D
O
X
R
T
H
A
D
C
X
T
IV
IT
C
Y
O
L
1
0
/1
0
0
/
1
0
0
0
B
A
S
E
-T
R
E
S
E
T
BOO
T
R
D
Y
FA
U
L
RS-232
T
SD
M
R
D
A
Y
S
T
E
R
B
USY
POW
E
R
18
Chassis ID 0
Chassis ID 31
(Default)
Figure 1. Chassis ID Jumper on the AT-MCF2000M Management Module
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. For more
information about stacking, see Chapter 2, “Stacking” on page 35.
To view the ID number of a chassis, issue this command:
system show cluster
For further information, see “Displaying the Chassis Modules” on page 28
or “SYSTEM SHOW CLUSTER” on page 99.
19
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-MC F2000M
STACK M
ID
LINK ACT
A
N
AGE
M
1000 LINK
EN
T
ACT 10/100 LINK ACT
TERMIN
AL
0
3
1
10/100/1000BASE-T
RS-232
FDX
P
ORT
HDX
A
C
TIV
IT
COL
Y
RESET
SD
R
DY BUSY
AT-MCF2KFAN
BOOT
RDY
FAULT
M
A
S
T
E
R
1261
STATUS
N
O
R
M
A
L
F
A
U
L
T
POW
E
R
Figure 2. Connecting the RS-232 Serial Management Cable to the RS-232
Terminal Port
2. Connect the other end of the cable to an RS-232 port on a terminal or
PC with a terminal emulator program.
3. Configure the terminal or terminal emulation program as follows:
Baud rate: 115,200 bps (The RS-232 Terminal port has a baud
rate range of 9600 to 115,200 bps. The default is 115,200 bps. To
adjust the baud rate, refer to “SYSTEM SET ASYNCHRONOUS”
on page 58.)
Data bits: 8
Parity: None
Stop bits: 1
Flow control: None
Note
The port settings are for a DEC VT100 or ANSI terminal, or an
equivalent terminal emulator program.
20
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. The management module has a
predefined manager account with the privilege level of administrator.
The account provides unlimited access to all the parameters on the
management and media converter modules. To log in using this
account, enter “manager” as the user name. The default password for
the account is “friend.” The user name and password are case
sensitive.
After you have logged in, the management software displays the
command line interface, shown in Figure 3.
Allied Telesis Media Converter- Version 2.0.0
#
<No System Name>
Figure 3. Command Line Interface Prompt
The symbol in the command line prompt reflects the access level of
your manager account. The predefined manager account has the
pound symbol (#) prompt. A read-write or read-only account has a
dollar symbol ($) prompt. 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.
You can now begin to manage the chassis. For suggestions on what to
configure during the initial configuration, refer to “What to Configure
First” on page 28.
21
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.
The 10/100/1000Base-T Management port on the management
module must be connected to a device on your network, such as a
Fast Ethernet or Gigabit Ethernet switch. Remote management
sessions are conducted through this port.
The Telnet server or SSH server on the management module must be
enabled. For instructions, refer to Chapter 11, “Telnet Server
Commands” on page 195 or Chapter 13, “Secure Shell Server (SSH)
Commands” on page 209.
The remote Telnet or SSH client must be a member of the same
network as the management module or have access to it through
Layer 3 routing devices.
If the management module and the remote Telnet or SSH client reside
on different networks, the IP configuration on the module must include
a default gateway address specifying the IP address of the routing
interface of the first hop to reaching the remote client. For instructions,
refer to Chapter 4, “IP Configuration Commands” on page 47.
The management module can support 20 Telnet and 20 SSH
management sessions, simultaneously.
To start a remote Telnet or SSH management session, perform the
following procedure:
1. Enter the IP address of the AT-MCF2000M Management Module in the
Telnet or SSH client on the remote workstation.
The management software prompts you for a user name and
password.
2. Enter a user name and password. The management module has a
predefined manager account with the privilege level of administrator
and unlimited access to all of the parameters on the management and
media converter modules. To log in using this account, enter
“manager” as the user name. The default password for the account is
“friend.” The user name and password are case sensitive.
22
The local management session starts and the command line interface
prompt is displayed, as shown in Figure 3 on page 21.
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.
23
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.mib, that was included with the AT-S85 and
AT-S97 software onto the management workstation. (The MIB file is
available from the Allied Telesis web site.)
This requires that you use a MIB compiler to compile the file. A familiarity
with MIB objects is necessary for this type of management. To load the
MIB file onto a management workstation, follow the instructions included
with your MIB compiler. For instructions on how to compile the MIB file
with your SNMP program, refer to your SNMP management
documentation.
To establish a SNMP management session for a unit that is remotely
managed, the chassis must have a management card and an IP address.
Before performing the SNMP management session, note the followings:
The 10/100Base-TX port on the management card must be connected
to the network.
The remote management workstation must reach the chassis through
the subnet of the management card.
24
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. For information about how to use the
console timer to automatically disconnect a management session, refer to
“SYSTEM SET CONSOLE” on page 61.
Note
Failure to properly exit from a management session may block future
management sessions until the console timer times out. For
information on the console timer, refer to “SYSTEM SET
CONSOLE” on page 61.
AT-S85 and AT-S97 Management Software Command Line Interface User’s Guide
25
Chapter 1: Starting a Command Line Management Session
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.
Keyword abbreviations - Keywords can be recognized by typing an
unambiguous prefix, for example, “sy” for “system.”
Tab key - Pressing the Tab key fills in the rest of the keyword. For
example, typing “mo” and pressing the Tab key enters “module.”
26
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
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
- Italicized screen text indicates a variable for you
27
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.0, the initial
configuration must be a local session because the module’s Telnet
and SSH servers are initially disabled.
Displaying the
Chassis Modules
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 Software Version
-----------------------------------------------------------M AT-MCF2000M v2.0.0
1 AT-MCF2012LC v2.0.0
2 AT-MCF2012LC v2.0.0
After logging on, enter this command:
system show cluster
The command displays the management and media converter modules in
the chassis. You can use this information to verify the modules in the unit.
An example is shown in Figure 4.
Management and media converter module information
Chassis information
28
Figure 4. Displaying the Chassis Modules
For information about this command, refer to “SYSTEM SHOW
CLUSTER” on page 99.
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. For instructions, Chapter 10, “File System Commands” on
page 165.
Changing the
Manager
Password
Creating a
Master
Configuration
File
Because the default password for the predefined manager account is
included in this document, which is posted on our web site where anyone
with a web browser can see it, you should change the password as part of
the initial configuration to protect the unit from unauthorized access. To
change the password, enter this command:
user set username=manager password
You are prompted to change the password. A password can be up to 16
alphanumeric characters and is case sensitive. Special characters,
including spaces, question marks, and quotation marks, are permitted.
You are prompted twice to verify the new password.
For information on how to create additional manager accounts, refer to
Chapter 14, “Manager Account Commands” on page 215.
This step creates a master configuration file in the file system on the
management module. The module uses the file to store your parameter
changes. Without the file, the module cannot save your parameter settings
and you will have to reenter them if you reset or power cycle the chassis.
This task has two steps. The first step creates the file with the CONFIG
SAVE FILESYSTEM command. The format of the command is:
config save filesystem=system://
The chassis variable is the ID number of the chassis. A chassis with a
management module installed has a chassis ID of 0 or 31. This value is
set with a jumper on the circuit board of the module. The chassis ID of a
chassis with a stacking module is 1 through 30. The value is also set
manually on the stacking module.To view this number, use the SYSTEM
SHOW CLUSTER command.
The slot variable specifies the chassis slot that has the management
module, signified by the letter “m.”
chassis/slot/filename
.cfg
29
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.cfg
For further information on this command, refer to “CONFIG SAVE
FILESYSTEM” on page 158.
Now that you have created the master configuration file, you are ready to
perform the second step and designate it as the module’s active master
configuration file. This directs the management module to the appropriate
master configuration file when saving your changes. (In some cases, the
management module might have more than one master configuration file,
such as a history of past configuration files, but only one of the files can be
active at a time.) The command for designating the active master
configuration file is the CONFIG SET command. Here is the format:
config set filesystem=system://
chassis/slot/filename
.cfg
The definitions of the variables in this command are the same as in the
CONFIG SAVE FILESYSTEM command. Here is an example of the
command that designates the “mcf_chassis1.cfg” file created in the
previous command as the management module’s active configuration file:
config set filesystem=system://0/m/mcf_chassis1.cfg
Configuration filenames in both the CONFIG SAVE FILESYSTEM and
CONFIG SET commands are case sensitive. For more information on this
command, refer to “CONFIG SET” on page 160.
This completes the procedure for creating and designating a new active
master configuration file on the management module. The management
module can now save your parameter changes when you issue the
CONFIG SAVE command.
30
Loading...