and the Alcatel-Lucent logo are registered trademarks of Alcatel-Lucent. Xylan®,
®
, OmniStack®, and Alcatel-Lucent OmniVista® are registered trademarks of Alcatel-Lucent.
OmniAccess™, Omni Switch/Router™, PolicyView™, RouterView™, SwitchManager™, VoiceView™,
WebView™, X-Cell™, X-Vision™, and the Xylan logo are trademarks of Alcatel-Lucent.
This OmniSwitch product contains components which may be covered by one or more of the following
U.S. Patents:
This OmniSwitch 6800/6850/9000Switch Management Guide describes basic attributes of your switch and
basic switch administration tasks. The software features described in this manual are shipped standard with
your OmniSwitch 6800 Series, OmniSwitch 6850 Series, and OmniSwitch 9000 Series switches. These
features are used when readying a switch for integration into a live network environment.
Supported Platforms
This information in this guide applies to the following products:
• OmniSwitch 9000 Series
• OmniSwitch 6850 Series
• OmniSwitch 6800 Series
Note. This OmniSwitch Switch Management Guide covers Release 6.1.5, which is supported on
OmniSwitch 6800 Series, OmniSwitch 6850 Series, and OmniSwitch 9000 Series switches and 6.2.1,
which is supported on the OmniSwitch 6850 Series switches. OmniSwitch 6600 Family, OmniSwitch
7700/7800, and OmniSwitch 8800 switches use Release 5.x. Please refer to the 5.x user guides for those
switches.
Unsupported Platforms
The information in this guide does not apply to the following products:
• OmniSwitch (original version with no numeric model name)
The audience for this user guide are network administrators and IT support personnel who need to configure, maintain, and monitor switches and routers in a live network. However, anyone wishing to gain
knowledge on how fundamental software features are implemented in the OmniSwitch 6800 Series,
OmniSwitch 6850 Series, and OmniSwitch 9000 Series switches will benefit from the material in this
configuration guide.
When Should I Read this Manual?
Read this guide as soon as your switch is up and running and you are ready to familiarize yourself with
basic software functions. You should have already stepped through the first login procedures and read the
brief software overviews in the OmniSwitch 6800 Series Getting Started Guide, OmniSwitch 6850 Series Getting Started Guide, or OmniSwitch 9000 Series Getting Started Guide.
You should have already set up a switch password and be familiar with the very basics of the switch software. This manual will help you understand the switch’s directory structure, the Command Line Interface
(CLI), configuration files, basic security features, and basic administrative functions. The features and
procedures in this guide will help form a foundation that will allow you to configure more advanced
switching features later.
What is in this Manual?
This configuration guide includes information about the following features:
• Basic switch administrative features, such as file editing utilities, procedures for loading new software,
and setting up system information (name of switch, date, time).
• Configurations files, including snapshots, off-line configuration, time-activated file download.
• The CLI, including on-line configuration, command-building help, syntax error checking, and line edit-
ing.
• Basic security features, such as switch access control and customized user accounts.
• SNMP
• Web-based management (WebView)
What is Not in this Manual?
The configuration procedures in this manual primarily use Command Line Interface (CLI) commands in
examples. CLI commands are text-based commands used to manage the switch through serial (console
port) connections or via Telnet sessions. This guide does include introductory chapters for alternative
methods of managing the switch, such as web-based (WebView) and SNMP management. However the
primary focus of this guide is managing the switch through the CLI.
Further information on WebView can be found in the context-sensitive on-line help available with that
application.
This guide does not include documentation for the OmniVista network management system. However,
OmniVista includes a complete context-sensitive on-line help system.
This guide provides overview material on software features, how-to procedures, and tutorials that will
enable you to begin configuring your OmniSwitch. However, it is not intended as a comprehensive reference to all CLI commands available in the OmniSwitch. For such a reference to all OmniSwitch 6800/
6850/9000 CLI commands, consult the OmniSwitch CLI Reference Guide.
How is the Information Organized?
Each chapter in this guide includes sections that will satisfy the information requirements of casual readers, rushed readers, serious detail-oriented readers, advanced users, and beginning users.
Quick Information. Most chapters include a specifications table that lists RFCs and IEEE specifications
supported by the software feature. In addition, this table includes other pertinent information such as minimum and maximum values and sub-feature support. Some chapters include a defaults table that lists the
default values for important parameters along with the CLI command used to configure the parameter.
Many chapters include Quick Steps sections, which are procedures covering the basic steps required to get
a software feature up and running.
In-Depth Information. All chapters include overview sections on software features as well as on selected
topics of that software feature. Topical sections may often lead into procedure sections that describe how
to configure the feature just described. Many chapters include tutorials or application examples that help
convey how CLI commands can be used together to set up a particular feature.
Documentation Roadmap
The OmniSwitch user documentation suite was designed to supply you with information at several critical
junctures of the configuration process. The following section outlines a roadmap of the manuals that will
help you at each stage of the configuration process. Under each stage, we point you to the manual or
manuals that will be most helpful to you.
Stage 1: Using the Switch for the First Time
Pertinent Documentation: Getting Started Guide
Release Notes
A hard-copy Getting Started Guide is included with your switch; this guide provides all the information
you need to get your switch up and running the first time. It provides information on unpacking the switch,
rack mounting the switch, installing NI modules, unlocking access control, setting the switch’s IP address,
and setting up a password. It also includes succinct overview information on fundamental aspects of the
switch, such as hardware LEDs, the software directory structure, CLI conventions, and web-based
management.
At this time you should also familiarize yourself with the Release Notes that accompanied your switch.
This document includes important information on feature limitations that are not included in other user
guides.
Stage 2: Gaining Familiarity with Basic Switch Functions
Pertinent Documentation: Hardware Users Guide
Switch Management Guide
Once you have your switch up and running, you will want to begin investigating basic aspects of its hardware and software. Information about switch hardware is provided in the Hardware Guide. This guide
provide specifications, illustrations, and descriptions of all hardware components, such as chassis, power
supplies, Chassis Management Modules (CMMs), Network Interface (NI) modules, and cooling fans. It
also includes steps for common procedures, such as removing and installing switch components.
The Switch Management Guide is the primary users guide for the basic software features on a single
switch. This guide contains information on the switch directory structure, basic file and directory utilities,
switch access security, SNMP, and web-based management. It is recommended that you read this guide
before connecting your switch to the network.
When you are ready to connect your switch to the network, you will need to learn how the OmniSwitch
implements fundamental software features, such as 802.1Q, VLANs, Spanning Tree, and network routing
protocols. The Network Configuration Guide contains overview information, procedures, and examples on
how standard networking technologies are configured in the OmniSwitch.
The Advanced Routing Configuration Guide includes configuration information for networks using
advanced routing technologies (OSPF and BGP) and multicast routing protocols (DVMRP and PIM-SM).
Anytime
The OmniSwitch CLI Reference Guide contains comprehensive information on all CLI commands
supported by the switch. This guide includes syntax, default, usage, example, related CLI command, and
CLI-to-MIB variable mapping information for all CLI commands supported by the switch. This guide can
be consulted anytime during the configuration process to find detailed and specific information on each
CLI command.
The following are the titles and descriptions of all the related OmniSwitch 6800/6850/9000 user manuals:
• OmniSwitch 6800 Series Getting Started Guide
Describes the hardware and software procedures for getting an OmniSwitch 6800 Series switch up and
running. Also provides information on fundamental aspects of OmniSwitch software and stacking
architecture.
• OmniSwitch 6850 Series Getting Started Guide
Describes the hardware and software procedures for getting an OmniSwitch 6850 Series switch up and
running. Also provides information on fundamental aspects of OmniSwitch software and stacking
architecture.
• OmniSwitch 6800 Series Hardware Users Guide
Detailed technical specifications and procedures for the OmniSwitch 6800 Series chassis and components. Also includes comprehensive information on assembling and managing stacked configurations.
• OmniSwitch 6850 Series Hardware User Guide
Complete technical specifications and procedures for all OmniSwitch 6850 Series chassis, power
supplies, and fans. Also includes comprehensive information on assembling and managing stacked
configurations.
• OmniSwitch 9000 Series Getting Started Guide
Describes the hardware and software procedures for getting an OmniSwitch 9000 Series up and
running. Also provides information on fundamental aspects of OmniSwitch software architecture.
• OmniSwitch 9000 Series Hardware Users Guide
Complete technical specifications and procedures for all OmniSwitch 9000 Series chassis, power
supplies, fans, and Network Interface (NI) modules.
• OmniSwitch CLI Reference Guide
Complete reference to all CLI commands supported on the OmniSwitch 9000 Series. Includes syntax
definitions, default values, examples, usage guidelines and CLI-to-MIB variable mappings.
Includes procedures for readying an individual switch for integration into a network. Topics include
the software directory architecture, image rollback protections, authenticated switch access, managing
switch files, system configuration, using SNMP, and using web management software (WebView).
Includes network configuration procedures and descriptive information on all the major software
features and protocols included in the base software package. Chapters cover Layer 2 information
(Ethernet and VLAN configuration), Layer 3 information (routing protocols, such as RIP), security
options (authenticated VLANs), Quality of Service (QoS), and link aggregation.
Includes network configuration procedures and descriptive information on all the software features and
protocols included in the advanced routing software package. Chapters cover multicast routing
(DVMRP and PIM-SM), and OSPF.
• OmniSwitch Transceivers Guide
Includes information on Small Form Factor Pluggable (SFPs) and 10 Gbps Small Form Factor Pluggables (XFPs) transceivers.
• Technical Tips, Field Notices
Includes information published by Alcatel-Lucent’s Customer Support group.
• Release Notes
Includes critical Open Problem Reports, feature exceptions, and other important information on the
features supported in the current release and any limitations to their support.
All user guides are included on the User Manual CD that accompanied your switch. This CD also includes
user guides for other Alcatel-Lucent data enterprise products. In addition, it contains a stand-alone version
of the on-line help system that is embedded in the OmniVista network management application.
Besides the OmniVista documentation, all documentation on the User Manual CD is in
requires the Adobe Acrobat Reader program for viewing. Acrobat Reader freeware is available at
www.adobe.com.
Note. In order to take advantage of the documentation CD’s global search feature, it is recommended that
you select the option for searching PDF files before downloading Acrobat Reader freeware.
To verify that you are using Acrobat Reader with the global search option, look for the following button in
the toolbar:
Note. When printing pages from the documentation PDFs, de-select Fit to Page if it is selected in your
print dialog. Otherwise pages may print with slightly smaller margins.
PDF format and
Technical Support
An Alcatel-Lucent service agreement brings your company the assurance of 7x24 no-excuses technical
support. You’ll also receive regular software updates to maintain and maximize your Alcatel-Lucent product’s features and functionality and on-site hardware replacement through our global network of highly
qualified service delivery partners. Additionally, with 24-hour-a-day access to Alcatel-Lucent’s Service
and Support web page, you’ll be able to view and update any case (open or closed) that you have reported
to Alcatel-Lucent’s technical support, open a new case or access helpful release notes, technical bulletins,
and manuals. For more information on Alcatel-Lucent’s Service Programs, see our web page at
service.esd.alcatel-lucent.com, call us at 1-800-995-2696, or email us at support@ind.alcatel.com.
This chapter describes the several methods of transferring software files onto the OmniSwitch and how to
register those files for use by the switch. This chapter also describes several basic switch management
procedures and discusses the Command Line Interface (CLI) commands used.
CLI commands are used in the configuration examples; for more details about the syntax of commands,
see the OmniSwitch CLI Reference Guide.
In This Chapter
Configuration procedures described in this chapter include:
• “Loading Software onto the Switch” on page 1-21
• “Creating a File Directory on the Switch” on page 1-33
• “Registering Software Image Files” on page 1-29
• “Setting the System Clock” on page 1-38
For related information about connecting a terminal to the switch, see your Getting Started Guide. For
information about switch command privileges, see Chapter 8, “Managing Switch Security.”
File Management SpecificationsManaging System Files
File Management Specifications
The following table lists specifications for the OmniSwitch flash directory and file system as well as the
system clock.
Note. The functionality described in this chapter is supported on the OmniSwitch 6800, 6850, and 9000
switches unless otherwise stated in the following Specifications table or specifically noted within any
section of this chapter.
File Transfer MethodsFTP, Zmodem
Switch Software UtilityOmniSwitch as an FTP Client
Configuration RecoveryThe flash/certified directory holds configurations that are certified as
the default start-up files for the switch. They will be used in the event of
a non-specified reload.
Switch /flash Directory
• 64 MB flash memory available for switch files and directories
(OmniSwitch 6800 and 6850)
• 128 MB flash memory available for switch files and directories
(OmniSwitch 9000)
• Contains the /certified and /working directories
File/Directory Name Metrics
File/Directory Name CharactersCharacter types are limited to a-z, A-Z, 0-9, dashes (-), dots (.), and
Maximum Number of
Files/Directories
Sub-DirectoriesUp to seven sub-directories allowed including /flash.
Text EditingVi standard UNIX editor. The Ed standard UNIX editor is available in
System ClockSet local date, time and time zone, Universal Time Coordinate (UTC),
System Date Default ValueTHU JAN 01 1970 (Thursday, January 1, 1970)
• 32 characters maximum for directory and file names
(OmniSwitch 6800 and 6850)
• 128 characters maximum for directory and file names
(OmniSwitch 9000)
• 255 character maximum for a fully qualified path
underlines (_).
Maximum of 244 files and/or directories allowed in the root (flash)
directory.
Managing System FilesSwitch Administration Overview
Switch Administration Overview
The OmniSwitch has a variety of software features designed for different networking environments and
applications. Over the life of the switch, it is very likely that your configuration and feature set will change
because the needs of your network are likely to expand. Also, software updates become available from
Alcatel-Lucent. If you change your configuration to upgrade your network, you must understand how to
install switch files and to manage switch directories.
The OmniSwitch 6800 and 6850 switches have 64 MB and the OmniSwitch 9000 switches have 128 MB
of usable flash memory. You can use this memory to store files, including executable files (used to operate switch features and applications), configuration files, and log files.
You need to understand the various methods of loading files onto the switch for software upgrades and
new features. Once the files are on the switch, the CLI has commands that allow you to load, copy, and
delete these files. The CLI also has commands for displaying, creating, and editing ASCII files directly on
the switch. You may also want to establish a file directory structure to help organize your files on the
switch.
All the files and directories on the switch bear a time stamp. This is useful for switch administration
because the time stamp allows you to tell at a glance which files are the most recent. You can set the
system clock that controls these time stamps as well as other time based switch functions.
File Transfer
The switch can receive and send files by using industry standard local and remote transfer methods. Each
of these methods is defined and explained. Because file transfers can involve logging onto the switch from
a remote host, security factors, such as DNS resolver and Authenticated Switch Access requirements
should be considered.
User’s Host
File Transfer from User’s
Host to the OmniSwitch
File Transfer to OmniSwitch
It is not enough to simply transfer a file onto the switch. Once files are on the switch, they must be
registered in order to become functional. The OmniSwitch has a directory structure that allows you to
install new software while maintaining a backup copy of your old configuration. This directory structure is
explained in the “Switch Directories” section on page 1-4 and instructions are given on how to execute the
install command in the “Registering Software Image Files” section on page 1-29.
Switch Administration OverviewManaging System Files
Switch Directories
You can create your own directories in the switch flash directory. This allows you to organize your configuration and text files on the switch. You can also use the vi command to create files. This chapter tells you
how to make, copy, move, and delete both files and directories.
Managing System FilesFile and Directory Management
File and Directory Management
A number of CLI commands allow you to manage files on your switch by grouping them into subdirectories within the switch’s flash directory. These commands perform the same functions as file
management software applications (such as Microsoft Explorer) perform on a workstation. For
documentation purposes, we have categorized the commands into the following three groups.
• Directory commands allow you to create, copy, move, remove, rename, and display directories.
• File commands allow you copy, secure copy, edit, rename, remove, change, and display file attributes.
• Utility commands display memory and system diagnostic information.
The following illustration represents a sample flash directory that contains three directories and six files at
the top level. The sample working directory and the certified directory both hold five files. The sample
network directory holds one file.This sample flash directory is used in the explanations of the directory,
file and utility CLI commands described in the following section.
The switch may show files and directories different from the ones shown in this example.
File and Directory ManagementManaging System Files
To list all the files and directories in your current directory, use the ls command. Here is a sample display
of the flash directory.
-> ls
Listing Directory /flash:
-rw 315 Jan 5 09:38 boot.params
drw 2048 Jan 5 09:22 certified/
drw 2048 Jan 5 09:22 working/
-rw 12 Dec 18 2030 boot.slot.cfg
drw 2048 Dec 27 2030 switch/
-rw 64000 Jan 5 09:37 swlog1.log
-rw 64000 Dec 27 2030 swlog2.log
-rw 256 Dec 27 2030 random-seed
drw 2048 Dec 18 2030 network/
40208384 bytes free
The following information describes the screen displayed by the ls command:
• The first column consists of three text characters. The first character indicates whether the row entry is
a file (-) or a directory (d). The second and third characters indicate the user’s read/write permissions.
drw 512 Oct 25 14:17 WORKING/
-rw 321 Oct 25 14:39 boot.params
Here, the first entry shows a directory (d) for which the user has read and write (rw) permissions. The
second entry shows a file (-) for which the user has read and write (rw) permissions.
• The second column indicates the number of bytes of flash memory the row entry occupies.
drw 512 Oct 25 14:17 WORKING/
-rw 321 Oct 25 14:39 boot.params
Here, the first entry shows that the directory uses 512 bytes of flash memory. The second entry shows
that the file occupies 321 bytes of flash memory.
• The third, fourth and fifth columns show the date and time the row entry was created or copied into the
flash directory.
drw 512 Oct 25 14:17 WORKING/
-rw 321 Oct 25 14:39 boot.params
Here, the first entry indicates the file was created or copied on April 22 at 05:23 hours. The second
entry indicates that the directory was created or copied on April 19 at 06:12 hours.
• The column on the right lists the file or directory name. Note that directory names end with a slash (/)
character.
drw 512 Oct 25 14:17 WORKING/
-rw 321 Oct 25 14:39 boot.params
Here, the first entry shows a directory named WORKING, the second entry shows a file named
boot.params.
• The value shown at the bottom of the display indicates the amount of flash memory remaining for use
in this directory (9.47 megabytes in the above example).
Managing System FilesFile and Directory Management
Using Wildcards
Wildcards allow you to substitute symbols (* or ?) for text patterns while using file and directory
commands. The asterisk (*) takes the place of multiple characters and the question mark character (?)
takes the place of single characters. More than one wildcard can be used within a single text string.
Multiple Characters
An asterisk (*) is used as a wildcard for multiple characters in a text pattern. The following command will
list all entries in the current directory that end with the .log extension:
-> ls *.log
Listing Directory /flash:
-rw 64000 Sep 21 19:49 swlog1.log
-rw 64000 Aug 12 19:06 swlog2.log
The following command lists all entries in the current directory that contain the i character.
-> ls *i*
Listing Directory /flash:
drw 2048 Aug 21 17:49 certified/
drw 2048 Aug 12 18:51 working/
The question mark (?) is used as a wildcard for a single character in a text pattern. The following
command will locate all entries containing swlog followed by any single character and the .log extension.
-> ls swlog?.log
Listing Directory /flash:
-rw 64000 Jul 21 19:49 swlog1.log
-rw 64000 Aug 12 19:06 swlog2.log
The single and multiple character wildcards can be used in combination. The following command lists all
entries containing the letter i followed by any two single characters.
File and Directory ManagementManaging System Files
Directory Commands
The directory commands are applied to the switch file system and to files contained within the file system.
When you first enter the flash directory, your login is located at the top of the directory tree. You may
navigate within this directory by using the pwd and cd commands (discussed below). The location of your
login within the directory structure is called your current directory. You need to observe your login
location because when you issue a command, that command applies only to directories and files in your
current directory unless another path is specified.
The following drawing is an OmniSwitch 6800 logical representation of the file directory shown in the
illustration on page 1-5.
Note. The directory tree on OmniSwitch 6850 and OmniSwitch 9000 switches is similar.
Determining Your Location in the File Structure
Use the pwd command to display the path to your current directory. When you first log into the switch,
your current directory is the flash directory. If you enter the pwd command, the following will be
displayed:
-> pwd
/flash
->
The display shows the name of the current directory and its path. If your current directory is the certified
directory and you enter the pwd command, the following will be displayed:
-> pwd
/flash/certified
->
The display shows the path to your current directory.
Managing System FilesFile and Directory Management
Changing Directories
Use the cd command to navigate within the file directory structure. The cd command allows you to move
“up” or “down” the directory tree. To go down, you must specify a directory located in your current directory. The following command example presumes your current directory is the /flash file directory as
shown in the directory on page 1-8 and that you want to move down the directory tree to the certified
directory.
->pwd
/flash
->cd certified
->
To verify that your current directory has changed to /flash/certified, use the pwd command and the
following will be displayed:
->pwd
/flash/certified
To move “up” the directory tree, use the cd command. Enter cd.. (cd dot dot) without specifying a direc-
tory name and your current directory will move up one directory level. If you enter cd without the dots,
your current directory will move to the top of the tree. The following example shows the cd command
used where the current directory is /flash/certified.
->pwd
/flash/certified
-> cd
->
To verify that your current directory has moved up the directory tree, use the pwd command to display
your location. The display shows you have moved up one level from the /flash/certified directory and that
your current directory is /flash.
-> pwd
/flash
If you use the cd command while you are at the top of the directory tree, the cd command will have no
effect on the location of your login. In other words, if you use cd while your current directory is /flash,
your current directory will remain /flash after you execute the cd command.
File and Directory ManagementManaging System Files
Displaying Directory Contents
The ls and dir commands have the same function. These two commands display the contents of the current
directory. If you use the ls or dir command while logged into the /flash file directory of the switch as
shown on page 1-8, the following will be displayed:
-> dir
Listing Directory /flash:
drw 512 Oct 25 14:39 certified/
drw 512 Jul 15 14:59 NETWORK/
drw 512 Oct 25 14:17 WORKING/
-rw 321 Oct 25 14:39 boot.params
-rw 163258 Oct 2 11:04 cs_system.pmd
-rw 11 Jul 30 14:09 boot.slot.cfg
-rw 693 Oct 9 11:55 boot.cfg.1.err
-rw 0 Oct 28 11:14 swlog1.log
-rw 64000 Oct 29 09:12 swlog2.log
9467904 bytes free
If you specify a path as part of the ls or dir command, your screen will list the contents of the directory at
the specified path.
-> ls /flash/certified
Listing Directory /flash/certified:
drw 2048 Oct 12 11:16 ./
drw 2048 Oct 12 15:58 ../
-rw 2636 Oct 12 11:16 boot.cfg
-rw 860086 Oct 26 11:07 Kos.img
-rw 123574 Oct 14 10:54 Ksecu.img
-rw 123574 Oct 14 10:54 Krelease.img
If you use the ls or dir command while logged into the /flash file directory of OmniSwitch 9000 Series,
the following will be displayed.
-> dir
Listing Directory /flash:
drw 1024 Nov 8 08:30 WORKING/
-rw 276 Nov 8 09:59 boot.params
-rw 4890749 Oct 21 21:43 cs_system.pmd
-rw 256 Nov 8 09:57 random-seed
-rw 64000 Nov 8 09:59 swlog1.log
drw 1024 Nov 8 08:31 certified/
drw 1024 Nov 8 08:29 NETWORK/
drw 1024 Nov 8 08:29 SWITCH/