Brocade Communications Systems 5600 Installation Manual

53-1003702-02
14 September 2015

Installing and Upgrading
Brocade 5600 vRouter on
XenServer

Installation 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

Installing the System...............................................................................................................11

Overview of installing on Citrix XenServer...................................................... 11

Preparing for installation................................................................................. 11

Downloading the Brocade vRouter files for XenServer...................................12

Installing the Brocade vRouter XenServer template....................................... 12

Importing the Brocade vRouter template............................................ 12

Creating the Brocade vRouter virtual machine................................... 13

Installing the Brocade vRouter ISO on XenServer..........................................14

Operating a Brocade vRouter virtual machine................................................ 15

Testing your installation.................................................................................. 15

Verifying the release and system type................................................ 15

Verifying connectivity.......................................................................... 16

Upgrading the System.............................................................................................................17

Installation and Upgrade Commands.......................................................................................19

List of Acronyms......................................................................................................................29

Installing and Upgrading Brocade 5600 vRouter on XenServer Installation Guide
53-1003702-02

Release-specific upgrade information.............................................................17

Before upgrading.............................................................................................17

Upgrading the system by using the add system image command..................17

Sample session: “add system image”................................................. 18

Recreating virtual machines by using the new template................................. 18

add system image........................................................................................... 20

clone system image........................................................................................ 22

delete system image....................................................................................... 23

install image.................................................................................................... 24

rename system image.....................................................................................25

set system image default-boot........................................................................ 26

show system image.........................................................................................27

3

4 Installing and Upgrading Brocade 5600 vRouter on XenServer Installation Guide

53-1003702-02

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

bold text

italic text

Courier font

Description

Identifies command names

Identifies keywords and operands

Identifies the names of user-manipulated GUI elements

Identifies text to enter at the GUI

Identifies emphasis

Identifies variables

Identifies document titles

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

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

Description

option is printed in plain text, for example, --show WWN.

Installing and Upgrading Brocade 5600 vRouter on XenServer Installation Guide 5
53-1003702-02

Notes, cautions, and warnings

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

x | y A vertical bar separates mutually exclusive elements.

< > Nonprinting characters, for example, passwords, are enclosed in angle

...

\

vertical bars. You must select one of the options.

In Fibre Channel products, square brackets may be used instead for this
purpose.

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.

6 Installing and Upgrading Brocade 5600 vRouter on XenServer Installation Guide

53-1003702-02

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

Brocade resources

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.

[e-mail]

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.

Installing and Upgrading Brocade 5600 vRouter on XenServer Installation Guide 7
53-1003702-02

Document feedback

• 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 [e-mail].

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.

8 Installing and Upgrading Brocade 5600 vRouter on XenServer Installation Guide

53-1003702-02

About This Guide

This guide describes how to install and upgrade Brocade 5600 vRouter (referred to as virtual router,
vRouter, or router in the guide) running on XenServer systems.

Installing and Upgrading Brocade 5600 vRouter on XenServer Installation Guide 9
53-1003702-02

About This Guide

10 Installing and Upgrading Brocade 5600 vRouter on XenServer Installation Guide

53-1003702-02