Brocade Communications Systems 5600 vRouter User manual

53-1003725-03
14 September 2015
Brocade 5600 vRouter
Quick Start Guide
Supporting Brocade 5600 vRouter 3.5R6

© 2015, Brocade Communications Systems, Inc. All Rights Reserved.
ADX, Brocade, Brocade Assurance, the B-wing symbol, DCX, Fabric OS, HyperEdge, ICX, MLX, MyBrocade, OpenScript, The Effortless
Network, VCS, VDX, Vplane, and Vyatta are registered trademarks, and Fabric Vision and vADX are trademarks of Brocade
Communications Systems, Inc., in the United States and/or in other countries. Other brands, products, or service names mentioned may be
trademarks of others.
Notice: This document is for informational purposes only and does not set forth any warranty, expressed or implied, concerning any
equipment, equipment feature, or service offered or to be offered by Brocade. Brocade reserves the right to make changes to this document
at any time, without notice, and assumes no responsibility for its use. This informational document describes features that may not be
currently available. Contact a Brocade sales office for information on feature and product availability. Export of technical data contained in
this document may require an export license from the United States government.
The authors and Brocade Communications Systems, Inc. assume no liability or responsibility to any person or entity with respect to the
accuracy of this document or any loss, cost, liability, or damages arising from the information contained herein or the computer programs that
accompany it.
The product described by this document may contain open source software covered by the GNU General Public License or other open
source license agreements. To find out which open source software is included in Brocade products, view the licensing terms applicable to
the open source software, and obtain a copy of the programming source code, please visit http://www.brocade.com/support/oscd.

Contents
Preface.....................................................................................................................................5
Document conventions......................................................................................5
Text formatting conventions.................................................................. 5
Command syntax conventions.............................................................. 5
Notes, cautions, and warnings.............................................................. 6
Brocade resources............................................................................................ 7
Contacting Brocade Technical Support.............................................................7
Document feedback.......................................................................................... 8
About This Guide.......................................................................................................................9
Welcome................................................................................................................................ 11
This guide........................................................................................................11
Additional resources........................................................................................11
Deploying the Brocade vRouter............................................................................................... 13
Run from LiveCD.............................................................................................13
Install on hardware..........................................................................................13
Install into a virtualized environment or cloud................................................. 14
VMware............................................................................................... 14
XenServer........................................................................................... 14
Hyper-V............................................................................................... 14
RedHat KVM....................................................................................... 15
Amazon machine image......................................................................15
Creating and Using LiveCD...................................................................................................... 17
About LiveCD.................................................................................................. 17
Creating LiveCD..............................................................................................17
Specifying the boot device in the system BIOS.............................................. 17
Testing the system.......................................................................................... 18
Verifying the release and system type................................................ 18
Verifying connectivity.......................................................................... 18
CLI and Web GUI.....................................................................................................................21
CLI...................................................................................................................21
Vyatta CLI and system shell................................................................21
Command modes................................................................................21
CLI help...............................................................................................22
Command completion......................................................................... 23
Viewing long output (“more”)...............................................................24
Showing support information...............................................................24
Web GUI......................................................................................................... 25
Enabling access to the web GUI......................................................... 25
Logging in to the web GUI...................................................................26
Basic navigation in the web GUI......................................................... 27
Brocade 5600 vRouter Quick Start Guide 3
53-1003725-03

Dashboard.........................................................................................27
Statistics............................................................................................29
Configuration.....................................................................................29
Operation.......................................................................................... 31
Quick Start Configuration Scenarios......................................................................................33
Configuration Basics in the CLI.....................................................................33
Configuration hierarchy.....................................................................33
Adding and modifying configuration..................................................33
Deleting configuration....................................................................... 34
Committing configuration changes....................................................35
Discarding configuration changes.....................................................35
Saving configuration..........................................................................36
Loading a configuration.....................................................................37
Changing the default configuration file..............................................37
Scenario: Basic System Configuration..........................................................38
Overview........................................................................................... 38
Logging in..........................................................................................39
Entering configuration mode............................................................. 39
Setting the host name....................................................................... 40
Setting the domain name.................................................................. 40
Changing the password.................................................................... 40
Configuring interfaces....................................................................... 41
Configuring access to a DNS server.................................................42
Saving the configuration....................................................................42
Scenario: Internet Gateway...........................................................................42
Overview........................................................................................... 43
Configuring interfaces....................................................................... 44
Enabling SSH access........................................................................44
Configuring the DHCP server............................................................44
Configuring NAT................................................................................45
Configuring firewall............................................................................46
Saving the system configuration....................................................... 47
4Brocade 5600 vRouter Quick Start Guide
53-1003725-03

Preface
● Document conventions......................................................................................................5
● Brocade resources............................................................................................................ 7
● Contacting Brocade Technical Support.............................................................................7
● Document feedback.......................................................................................................... 8
Document conventions
The document conventions describe text formatting conventions, command syntax conventions, and
important notice formats used in Brocade technical documentation.
Text formatting conventions
Text formatting conventions such as boldface, italic, or Courier font may be used in the flow of the text
to highlight specific words or phrases.
Format Description
bold text Identifies command names
Identifies keywords and operands
Identifies the names of user-manipulated GUI elements
Identifies text to enter at the GUI
italic text Identifies emphasis
Identifies variables
Identifies document titles
Courier font Identifies CLI output
Identifies command syntax examples
Command syntax conventions
Bold and italic text identify command syntax components. Delimiters and operators define groupings of
parameters and their logical relationships.
Convention Description
bold text Identifies command names, keywords, and command options.
italic text Identifies a variable.
value In Fibre Channel products, a fixed value provided as input to a command
option is printed in plain text, for example, --show WWN.
Brocade 5600 vRouter Quick Start Guide 5
53-1003725-03

Convention Description
[ ] Syntax components displayed within square brackets are optional.
Default responses to system prompts are enclosed in square brackets.
{ x | y | z } A choice of required parameters is enclosed in curly brackets separated by
vertical bars. You must select one of the options.
In Fibre Channel products, square brackets may be used instead for this
purpose.
x | yA vertical bar separates mutually exclusive elements.
< > Nonprinting characters, for example, passwords, are enclosed in angle
brackets.
... Repeat the previous element, for example, member[member...].
\Indicates a “soft” line break in command examples. If a backslash separates
two lines of a command input, enter the entire command at the prompt without
the backslash.
Notes, cautions, and warnings
Notes, cautions, and warning statements may be used in this document. They are listed in the order of
increasing severity of potential hazards.
NOTE
A Note provides a tip, guidance, or advice, emphasizes important information, or provides a reference
to related information.
ATTENTION
An Attention statement indicates a stronger note, for example, to alert you when traffic might be
interrupted or the device might reboot.
CAUTION
A Caution statement alerts you to situations that can be potentially hazardous to you or cause
damage to hardware, firmware, software, or data.
DANGER
A Danger statement indicates conditions or situations that can be potentially lethal or
extremely hazardous to you. Safety labels are also attached directly to products to warn of
these conditions or situations.
Notes, cautions, and warnings
6 Brocade 5600 vRouter Quick Start Guide
53-1003725-03

Brocade resources
Visit the Brocade website to locate related documentation for your product and additional Brocade
resources.
You can download additional publications supporting your product at www.brocade.com. Select the
Brocade Products tab to locate your product, then click the Brocade product name or image to open the
individual product page. The user manuals are available in the resources module at the bottom of the
page under the Documentation category.
To get up-to-the-minute information on Brocade products and resources, go to MyBrocade. You can
register at no cost to obtain a user ID and password.
Release notes are available on MyBrocade under Product Downloads.
White papers, online demonstrations, and data sheets are available through the Brocade website.
Contacting Brocade Technical Support
As a Brocade customer, you can contact Brocade Technical Support 24x7 online, by telephone, or by e-
mail. Brocade OEM customers contact their OEM/Solutions provider.
Brocade customers
For product support information and the latest information on contacting the Technical Assistance
Center, go to http://www.brocade.com/services-support/index.html.
If you have purchased Brocade product support directly from Brocade, use one of the following methods
to contact the Brocade Technical Assistance Center 24x7.
Online Telephone E-mail
Preferred method of contact for non-
urgent issues:
•My Cases through MyBrocade
•Software downloads and licensing
tools
•Knowledge Base
Required for Sev 1-Critical and Sev
2-High issues:
• Continental US: 1-800-752-8061
• Europe, Middle East, Africa, and
Asia Pacific: +800-AT FIBREE
([phone])
• For areas unable to access toll
free number: [phone]
•Toll-free numbers are available in
many countries.
[email protected]
Please include:
• Problem summary
• Serial number
• Installation details
• Environment description
Brocade OEM customers
If you have purchased Brocade product support from a Brocade OEM/Solution Provider, contact your
OEM/Solution Provider for all of your product support needs.
• OEM/Solution Providers are trained and certified by Brocade to support Brocade® products.
• Brocade provides backline support for issues that cannot be resolved by the OEM/Solution Provider.
Brocade resources
Brocade 5600 vRouter Quick Start Guide 7
53-1003725-03

• Brocade Supplemental Support augments your existing OEM support contract, providing direct
access to Brocade expertise. For more information, contact Brocade or your OEM.
• For questions regarding service levels and response times, contact your OEM/Solution Provider.
Document feedback
To send feedback and report errors in the documentation you can use the feedback form posted with
the document or you can e-mail the documentation team.
Quality is our first concern at Brocade and we have made every effort to ensure the accuracy and
completeness of this document. However, if you find an error or an omission, or you think that a topic
needs further development, we want to hear from you. You can provide feedback in two ways:
• Through the online feedback form in the HTML documents posted on www.brocade.com.
• By sending your feedback to [email protected].
Provide the publication title, part number, and as much detail as possible, including the topic heading
and page number if applicable, as well as your suggestions for improvement.
Document feedback
8 Brocade 5600 vRouter Quick Start Guide
53-1003725-03

About This Guide
This guide gets you started using and configuring the Brocade 5600 vRouter (referred to as a virtual
router, vRouter, or router in the guide). It describes how to deploy the router and introduces you to the
CLI and web GUI interfaces that you can use to access, configure, and manage the router.
Brocade 5600 vRouter Quick Start Guide 9
53-1003725-03

About This Guide
10 Brocade 5600 vRouter Quick Start Guide
53-1003725-03

Welcome
● This guide........................................................................................................................11
● Additional resources........................................................................................................11
This guide
Thank you for choosing the Brocade vRouter.
Brocade has changed the networking world by developing the first commercially supported, open-
source networking, security, and service solution that provides an alternative to over-priced, inflexible
products from proprietary vendors. Brocade solutions offer industry-standard routing and management
protocols, support for most commonly used network interfaces, and configuration through a command-
line interface (CLI) or graphical user interface (GUI).
Brocade vRouter delivers the features, performance, and reliability of an enterprise-class secure router
with the added benefits of flexible deployment options—x86 hardware, blade servers, virtualization—the
freedom to integrate applications, and the economic advantages of commodity hardware and
components.
Use this guide to get the following benefits:
• An overview of the deployment options and help to determine the best way to deploy the Brocade
vRouter in your environment
• An overview of the user interfaces that are available on the system
• A walk-through of fundamental system configuration based on example scenarios
Additional resources
The Brocade vRouter technical library provides full product documentation. To see what documentation
is available for your release, refer to Guide to Brocade 5600 vRouter Documentation. This guide is
posted with every release of Brocade vRouter software and provides a great starting point for locating
the information you need.
Brocade 5600 vRouter Quick Start Guide 11
53-1003725-03

Additional resources
12 Brocade 5600 vRouter Quick Start Guide
53-1003725-03

Deploying the Brocade vRouter
● Run from LiveCD.............................................................................................................13
● Install on hardware..........................................................................................................13
● Install into a virtualized environment or cloud................................................................. 14
Run from LiveCD
LiveCD runs the Brocade vRouter software on a RAM disk that resides on the host system. The system
uses the RAM disk for writeable sections of the file system and uses an external system, such as a
TFTP server or USB memory stick, for the storage of configuration files.
LiveCD runs on a system with an existing operating system without disturbing or changing the
previously installed operating system. Configuration is not stored on the system, but you can save
configuration to a persistent device, such as a USB memory stick. In addition, you cannot upgrade an
installation from LiveCD; each upgrade requires fresh LiveCD. While you are running the system from
LiveCD, you are not able to access other applications or programs on your system.
LiveCD is also required to install the Brocade vRouter to a persistent device, such as a hard disk.
As a method of deployment, running from LiveCD is best suited for evaluation and test scenarios.
You can read about using LiveCD in Installing the System: Using a LiveCD.
Install on hardware
The Brocade vRouter installs and runs on most standard x86 servers and PCs. The system installs from
Brocade vRouter LiveCD onto a variety of persistent devices, including a hard drive, USB memory stick,
and compact Flash.
You install the system from LiveCD, which you create before installation. The installation process uses
LiveCD as the source image, formats the device on which the system is being installed, installs the
system, and, if possible, preserves configuration from previous installations. When the installation is
completed, you reboot your system and the newly installed system begins running.
NOTE
Not all hardware supports the ability to boot from a USB device or compact Flash; check the BIOS of
your hardware to see if it does.
You can read about installing onto a hard disk or other persistent device in Installing and Upgrading
Brocade 5600 vRouter on Hard Disks and Persistent Devices .
Brocade 5600 vRouter Quick Start Guide 13
53-1003725-03

Install into a virtualized environment or cloud
The Brocade vRouter runs as a software appliance in a virtual or cloud computing environment,
allowing you to virtualize your network. The Brocade vRouter software appliance is optimized for a
number of virtual environments. These environments provide a great deal of flexibility as to how the
virtual machine is configured, especially with respect to memory and Ethernet interfaces. Multiple
Brocade vRouter systems run simultaneously on a single hardware platform that is configured for
multiple virtual machines.
The Brocade vRouter software runs in the following virtual environments:
•VMware on page 14
•XenServer on page 14
•Hyper-V on page 14
•RedHat KVM on page 15
•Amazon machine image on page 15
VMware
Like other virtualization platforms, VMware products provide the ability to run multiple virtual systems
on a single hardware platform. The Brocade vRouter can be run on VMware ESX and ESXi. VMware
ESX and ESXi are virtualization platforms that run directly on system hardware in a 64-bit
environment.
Brocade provides a prebuilt VMware template that can be used to create Brocade vRouter virtual
machines on VMware ESX or ESXi. Brocade also provides an ISO that can be installed on VMware
ESX or ESXi.
You can read about installing onto VMware in Installing and Upgrading Brocade 5600 vRouter on
VMware.
XenServer
Citrix XenServer is a server virtualization platform. Like other virtualization platforms, XenServer
provides the ability to run multiple virtual machines on a single hardware platform.
XenCenter is the management system for XenServer. XenCenter allows you to manage multiple
physical servers running XenServer in addition to all the virtual machines running on each physical
server.
You can read about installing onto XenServer in Installing and Upgrading Brocade 5600 vRouter on
XenServer.
Hyper-V
Hyper-V is a hypervisor-based virtualization platform running in a Microsoft Windows Server role. Like
other virtualization platforms, it provides the ability to run multiple virtual machines on a single
hardware platform.
A Hyper-V system is managed by either Hyper-V Manager or Virtual Machine Manager (VMM). VMM
allows you to manage multiple physical machines running Hyper-V in addition to all virtual machines
running on each physical server.
Install into a virtualized environment or cloud
14 Brocade 5600 vRouter Quick Start Guide
53-1003725-03

You can read about installing onto Hyper-V in Installing and Upgrading Brocade 5600 vRouter on
Hyper-V.
RedHat KVM
The Brocade vRouter supports the Red Hat Kernel-based Virtual Machine (KVM) hypervisor on Red Hat
Enterprise Linux (RHEL). Like other virtualization platforms, the Red Hat KVM provides the ability to run
multiple virtual systems on a single hardware platform. Brocade provides a prebuilt system image that
runs on the KVM on RHEL.
You can read about installing onto RedHat KVM in Installing and Upgrading Brocade 5600 vRouter on
Linux KVM.
Amazon machine image
Amazon Web Services (AWS) is the cloud computing service for Amazon. AWS provides the tools and
infrastructure required by businesses to run computing environments “within the cloud.”
At the core of AWS is an Amazon Machine Image (AMI). An AMI is a virtual machine template. You
instantiate virtual-machine instances from the template within the AWS cloud. A variety of AMIs are
available from a number of vendors.
You can read about installing and using a Brocade vRouter AMI in AWS in Installing and Upgrading
Brocade 5600 vRouter AMI.
RedHat KVM
Brocade 5600 vRouter Quick Start Guide 15
53-1003725-03

Amazon machine image
16 Brocade 5600 vRouter Quick Start Guide
53-1003725-03

Creating and Using LiveCD
● About LiveCD.................................................................................................................. 17
● Creating LiveCD..............................................................................................................17
● Specifying the boot device in the system BIOS.............................................................. 17
● Testing the system.......................................................................................................... 18
About LiveCD
LiveCD runs the Brocade vRouter software on a RAM disk that resides on the host system. The system
uses the RAM disk for writeable sections of the file system and uses an external system, such as a
TFTP server or USB memory stick, for the storage of configuration files.
LiveCD runs on a system with an existing operating system without disturbing or changing the
previously installed operating system. Configuration is not stored on the system, but you can save
configuration to a persistent device, such as a USB memory stick. In addition, you cannot upgrade an
installation from LiveCD; each upgrade requires fresh LiveCD. While you are running the system from
LiveCD, you are not able to access other applications or programs on your system.
LiveCD is also required to install the Brocade vRouter to a persistent device, such as a hard disk.
As a method of deployment, running from LiveCD is best suited for evaluation and test scenarios.
Creating LiveCD
LiveCD must be bootable. Refer to documentation for your CD-burning utility for information on how to
burn a bootable ISO image.
To create a bootable LiveCD disk:
1. Download an ISO software image.
2. Use CD-burning software to create a bootable ISO image. Note the following requirements:
• The CD must be an ISO image; just copying files onto the CD does not work.
• The CD must be bootable.
Specifying the boot device in the system BIOS
Insert the LiveCD disk into the CD drive of the system on which you want to run it. If your system is not
already configured to boot from a CD or DVD, if one is present, you must configure it to boot from
LiveCD.
To specify the boot device:
Brocade 5600 vRouter Quick Start Guide 17
53-1003725-03

1. During the boot sequence, press the appropriate key (for example, <F2>) to interrupt the boot
sequence and enter the BIOS setup program for your system.
2. In the boot sequence menu, arrange the boot devices such that the device name for the CD or DVD
drive is first in the list. This arrangement allows the system to boot from a CD or DVD, if one is
present.
3. Save the settings and reboot the system. When the system restarts, it boots from LiveCD.
After the system has booted, confirm that you can access it from your network.
Testing the system
After the system has successfully booted, you see the vyatta login: prompt. This prompt indicates
that the system is operational.
Perform the following procedures:
•Verifying the release and system type on page 18
•Verifying connectivity on page 18
Verifying the release and system type
We must confirm that the correct release version is running on the system.
To verify the release and system type:
1. Log in with the username and password that you provided during installation. During installation, if
the default user of vyatta was not chosen and a new user was created, then use the new
username and password to log in. Use the default password of vyatta unless you have changed
it.
2. Run the show version command.
• The Version: line displays the version number of the system that is running. Make sure that the
displayed result is the version you require.
• The System type: line displays the type of hardware on which the system is running and
whether it is in a virtual environment. Make sure that the displayed result is the version you
require.
• The Boot via: line displays the type of system that is running.
Verifying connectivity
After you confirm that the correct vRouter version is running, you must confirm that the Brocade
vRouter can be accessed on the local network. A quick-and-easy way to do this is to configure an
Ethernet interface on the system and then ping the interface from another host on the network.
NOTE
In the Brocade vRouter, a dataplane interface is an abstraction that represents the underlying physical
or virtual Ethernet interface of the systems. The terms Ethernet interface and dataplane interface are
synonymous in this guide.
To test system connectivity:
Testing the system
18 Brocade 5600 vRouter Quick Start Guide
53-1003725-03

1. At the command prompt, enter the commands that are shown in the example, substituting an IP
address from your existing subnet. The example uses the following network and IP address.
• The network is 192.168.1.0/24.
• The IP address of the interface is 192.168.1.81.
Make the appropriate substitutions for your network, as shown in the following example.
vyatta@vyatta:~$ configure
vyatta@vyatta# set interfaces dataplane dp0sN address 192.168.1.81/24
vyatta@vyatta# commit
vyatta@vyatta# save
vyatta@vyatta# exit
vyatta@vyatta:~$
2. From another host on the same subnet, ping the interface to ensure that it is up. From a Linux or
Windows command prompt, enter the following command, substituting the IP address you assigned
to the interface.
ping 192.168.1.81
If the Brocade vRouter can be reached, you see replies from it in response to the pings. If so, your
system is installed and can be accessed on your network.
Creating and Using LiveCD
Brocade 5600 vRouter Quick Start Guide 19
53-1003725-03

Verifying connectivity
20 Brocade 5600 vRouter Quick Start Guide
53-1003725-03