GETTING STARTED GUIDE

Ruckus Virtual SmartZone

Getting Started Guide

Supporting SmartZone Release 3.6

Part Number: 800-71549-001 Rev A

Publication Date: November 2017
Copyright Notice and Proprietary Information
Copyright 2017 Brocade Communications Systems, Inc. All rights reserved.

No part of this documentation may be used, reproduced, transmitted, or translated, in any form or by any means, electronic, mechanical,
manual, optical, or otherwise, without prior written permission of or as expressly provided by under license from Brocade.

Destination Control Statement

Technical data contained in this publication may be subject to the export control laws of the United States of America. Disclosure to
nationals of other countries contrary to United States law is prohibited. It is the reader’s responsibility to determine the applicable regulations
and to comply with them.

Disclaimer
THIS DOCUMENTATION AND ALL INFORMATION CONTAINED HEREIN (“MATERIAL”) IS PROVIDED FOR GENERAL INFORMATION
PURPOSES ONLY. BROCADE and RUCKUS WIRELESS, INC. AND THEIR LICENSORS MAKE NO WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, WITH REGARD TO THE MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY, NON-INFRINGEMENT AND FITNESS FOR A PARTICULAR PURPOSE, OR THAT THE MATERIAL IS ERROR-FREE,
ACCURATE OR RELIABLE. BROCADE and RUCKUS RESERVE THE RIGHT TO MAKE CHANGES OR UPDATES TO THE MATERIAL AT
ANY TIME.

Limitation of Liability
IN NO EVENT SHALL BROCADE or RUCKUS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL OR CONSEQUENTIAL
DAMAGES, OR DAMAGES FOR LOSS OF PROFITS, REVENUE, DATA OR USE, INCURRED BY YOU OR ANY THIRD PARTY, WHETHER
IN AN ACTION IN CONTRACT OR TORT, ARISING FROM YOUR ACCESS TO, OR USE OF, THE MATERIAL.

Trademarks
Ruckus Wireless, Ruckus, the bark logo, BeamFlex, ChannelFly, Dynamic PSK, FlexMaster, Simply Better Wireless, SmartCell, SmartMesh,
SmartZone, Unleashed, ZoneDirector and ZoneFlex are trademarks of Ruckus Wireless, Inc. in the United States and in other countries.
Brocade, the B-wing symbol, MyBrocade, and ICX are trademarks of Brocade Communications Systems, Inc. in the United States and in
other countries. Other trademarks may belong to third parties.

Ruckus Virtual SmartZone Getting Started Guide

2 Part Number: 800-71549-001 Rev A
Contents
Preface..........................................................................................................................................................................................................5
Document Conventions..........................................................................................................................................................................5
Notes, Cautions, and Warnings.......................................................................................................................................................5
Command Syntax Conventions.............................................................................................................................................................. 5
Document Feedback..............................................................................................................................................................................6
Ruckus resources.................................................................................................................................................................................. 6
Online Training Resources...................................................................................................................................................................... 6
Contacting Ruckus Customer Services and Support..............................................................................................................................7
What Support Do I Need?...............................................................................................................................................................7
Open a Case...................................................................................................................................................................................7
Self-Service Resources................................................................................................................................................................... 7

About This Guide.......................................................................................................................................................................................... 9

About This Guide................................................................................................................................................................................... 9
Notice Conventions.........................................................................................................................................................................9

Installation Preparation................................................................................................................................................................................ 11
Obtaining the vSZ Distribution.............................................................................................................................................................. 11
Preparing the vSZ Interface Settings to Use......................................................................................................................................... 11
Determining the System Resources That the Virtual Machine Requires.................................................................................................12
Clustering Limitations for vSZ-H.................................................................................................................................................... 13
Clustering Limitations for vSZ-E.................................................................................................................................................... 13

Installing the vSZ on a Hypervisor................................................................................................................................................................ 15

Preparing a Hypervisor......................................................................................................................................................................... 15
Installing the vSZ on VMWare vSphere Hypervisor................................................................................................................................15
Before You Begin.......................................................................................................................................................................... 15
Creating a vSZ Instance from the OVA File.................................................................................................................................... 15
Allocating Resources and Assigning Network Interfaces................................................................................................................26
Powering on the vSZ virtual machine.............................................................................................................................................28
Installing the vSZ on Windows Server Hyper V..................................................................................................................................... 28
Installing the vSZ on a Kernel based Virtual Machine Hypervisor...........................................................................................................40
Extracting the vSZ Image.............................................................................................................................................................. 40
Setting Up the vSZ........................................................................................................................................................................43

Installing the vSZ on Microsoft Azure........................................................................................................................................................... 51

Introduction..........................................................................................................................................................................................51
Logging into Microsoft Azure................................................................................................................................................................51
Creating a Storage Account and Container.......................................................................................................................................... 56
Uploading the vSZ Image to Microsoft Azure........................................................................................................................................60
Creating a vSZ Image on Microsoft Azure.............................................................................................................................................62
Creating a Network.............................................................................................................................................................................. 64
Creating a vSZ Virtual Machine.............................................................................................................................................................68
Configuring Port Numbers for Virtual Machines.................................................................................................................................... 74
Assigning a Static Public IP Address to a VM....................................................................................................................................... 78
Assigning a Static Internal IP Address to a Virtual Machine...................................................................................................................82

Installing vSZ on the Google Computing Engine.......................................................................................................................................... 89

Introduction..........................................................................................................................................................................................89

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 3
 Logging into GCE and Selecting a Project............................................................................................................................................ 89
Creating a Storage Bucket................................................................................................................................................................... 93
Uploading the vSZ Image to a Storage Bucket..................................................................................................................................... 97
Creating a vSZ Image for Virtual Machines........................................................................................................................................... 99
Creating a Network and Configuring Firewall Rules.............................................................................................................................102
Creating a Virtual Machine Instance....................................................................................................................................................106

Installing vSZ on Amazon Web Services.................................................................................................................................................... 113

Installing AWS CLI..............................................................................................................................................................................113
Creating a VM Import Service Role.....................................................................................................................................................114
Installing vSZ on AWS........................................................................................................................................................................ 115
Logging into AWS....................................................................................................................................................................... 115
Creating a Storage Bucket.......................................................................................................................................................... 117
Uploading vSZ Image to a Storage..............................................................................................................................................118
AWS Service Policy.....................................................................................................................................................................119
Importing the vSZ Image............................................................................................................................................................. 120
Creating the vSZ Instance.................................................................................................................................................................. 122
Configuring AWS for a vSZ Instance...................................................................................................................................................129
Attach a New Disk Volume.......................................................................................................................................................... 129
Allocate a Public IP Address....................................................................................................................................................... 131
Change Security Group...............................................................................................................................................................132
Deleting a vSZ Instance......................................................................................................................................................................133

Configuring the Virtual Machine Interfaces................................................................................................................................................. 137

Configuring the Virtual Machine Interfaces.......................................................................................................................................... 137
Setting Up the vSZ with One Interface................................................................................................................................................137
Setting Up the vSZ with Three Interfaces............................................................................................................................................141
Important Notes About Selecting the System Default Gateway...........................................................................................................144

Using the Setup Wizard to Install vSZ........................................................................................................................................................ 145

Before You Begin............................................................................................................................................................................... 145
Step 1: Start the Setup Wizard and Set the Language....................................................................................................................... 146
Step 2: Select the Profile Configuration That Corresponds to Your vSZ License................................................................................. 146
Step 3: Configure the Management IP Address Settings.................................................................................................................... 148
Important Notes About Selecting the System Default Gateway................................................................................................... 151
Step 4: Configure Dual Mode IP Address Settings Using CLI..............................................................................................................151
Step 5: Configure the Cluster Settings................................................................................................................................................161
If This vSZ Is Forming a New Cluster...........................................................................................................................................162
If This vSZ Is Joining an Existing Cluster......................................................................................................................................162
Step 6: Set the Administrator Password.............................................................................................................................................163
Step 7: Verify the Settings.................................................................................................................................................................. 164
Logging On to the Web Interface........................................................................................................................................................166

Upgrading the Controller for Microsoft Azure, AWS, and GCE Platforms....................................................................................................167
Upgrading the Controller for Microsoft Azure, AWS, and GCE Platforms............................................................................................ 167
Upgrading the Controller Software..................................................................................................................................................... 167
Verifying the Upgrade......................................................................................................................................................................... 169
Rolling Back to a Previous Software Version.......................................................................................................................................170
Backing Up and Restoring Clusters.............................................................................................................................................171

Ruckus Virtual SmartZone Getting Started Guide

4 Part Number: 800-71549-001 Rev A
Preface
• Document Conventions............................................................................................................................................. 5
• Command Syntax Conventions................................................................................................................................. 5
• Document Feedback................................................................................................................................................. 6
• Ruckus resources......................................................................................................................................................6
• Online Training Resources......................................................................................................................................... 6
• Contacting Ruckus Customer Services and Support................................................................................................. 7

Document Conventions
The following tables list the text and notice conventions that are used throughout this guide.

TABLE 1 Text conventions

Convention Description Example
monospace Identifies command syntax
device(config)# interface ethernet 1/1/6
examples.
bold User interface (UI) components such On the Start menu, click All Programs.
as screen or page names, keyboard
keys, software buttons, and field
names
italics Publication titles Refer to the Ruckus Small Cell Release Notes for more information

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.

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.

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.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 5
Preface
Document Feedback

Convention Description
italic text Identifies a variable.
[] 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.
x|y A 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.

Document Feedback
Ruckus is interested in improving its documentation and welcomes your comments and suggestions.

You can email your comments to Ruckus at: [email protected]

When contacting us, please include the following information:

• Document title and release number
• Document part number (on the cover page)
• Page number (if appropriate)
• For example:
– Ruckus Small Cell Alarms Guide SC Release 1.3
– Part number: 800-71306-001
– Page 88

Ruckus resources
Visit the Ruckus website to locate related documentation for your product and additional Ruckus resources.

Release Notes and other user documentation are available at https://support.ruckuswireless.com/documents. You can locate
documentation by product or perform a text search.

White papers, data sheets, and other product documentation are available at www.ruckuswireless.com.

Online Training Resources

To access a variety of online Ruckus training modules, including free introductory courses to wireless networking essentials, site surveys,
and Ruckus products, visit the Ruckus Training Portal at https://training.ruckuswireless.com.

Ruckus Virtual SmartZone Getting Started Guide

6 Part Number: 800-71549-001 Rev A
 Preface
Contacting Ruckus Customer Services and Support

Contacting Ruckus Customer Services and Support

The Customer Services and Support (CSS) organization is available to provide assistance to customers with active warranties on their
Ruckus Networks products, and customers and partners with active support contracts.

For product support information and details on contacting the Support Team, go directly to the Support Portal using https://
support.ruckuswireless.com, or go to https://www.ruckuswireless.com and select Support.

What Support Do I Need?

Technical issues are usually described in terms of priority (or severity). To determine if you need to call and open a case or access the self-
service resources use the following criteria:
• Priority 1 (P1)—Critical. Network or service is down and business is impacted. No known workaround. Go to the Open a Case
section.
• Priority 2 (P2)—High. Network or service is impacted, but not down. Business impact may be high. Workaround may be available.
Go to the Open a Case section.
• Priority 3 (P3)—Medium. Network or service is moderately impacted, but most business remains functional. Go to the Self-Service
Resources section.
• Priority 4 (P4)—Low. Request for information, product documentation, or product enhancements. Go to the Self-Service
Resources section.

Open a Case
When your entire network is down (P1), or severely impacted (P2), call the appropriate telephone number listed below to get help:
• Continental United States: 1-855-782-5871
• Canada: 1-855-782-5871
• Europe, Middle East, Africa, and Asia Pacific, toll-free numbers are available at https://support.ruckuswireless.com/contact-us and
Live Chat is also available.

Self-Service Resources
The Support Portal at https://support.ruckuswireless.com/contact-us offers a number of tools to help you to research and resolve problems
with your Ruckus products, including:
• Technical Documentation—https://support.ruckuswireless.com/documents
• Community Forums—https://forums.ruckuswireless.com/ruckuswireless/categories
• Knowledge Base Articles—https://support.ruckuswireless.com/answers
• Software Downloads and Release Notes—https://support.ruckuswireless.com/software
• Security Bulletins—https://support.ruckuswireless.com/security

Using these resources will help you to resolve some issues, and will provide TAC with additional data from your troubleshooting analysis if
you still require assistance through a support case or RMA. If you still require help, open and manage your case at https://
support.ruckuswireless.com/case_management

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 7
 Ruckus Virtual SmartZone Getting Started Guide
8 Part Number: 800-71549-001 Rev A
About This Guide
• About This Guide.......................................................................................................................................................9

About This Guide

This Virtual SmartZone (vSZ) Getting Started Guide provides information on how to set up the vSZ virtual appliance on the network. You can
install the vSZ on any of the supported hypervisors.

Topics covered in this guide include preparing your chosen hypervisor, installing the vSZ image on to the hypervisor, and completing the vSZ
Setup Wizard.

This guide is intended for use by those responsible for installing and setting up network equipment. Consequently, it assumes a basic
working knowledge of local area networking, wireless networking, and wireless devices.

NOTE
If release notes are shipped with your product and the information there differs from the information in this guide, follow the
instructions in the release notes.

Most user guides and release notes are available in Adobe Acrobat Reader Portable Document Format (PDF) or HTML on the Ruckus
Wireless Support website at https://support.ruckuswireless.com/documents.

Notice Conventions
The following table lists the notice conventions that are used throughout this guide.

TABLE 2 Notice Conventions

Notice Type Description

NOTE Information that describes important features or instructions

CAUTION! Information that alerts you to potential loss of data or potential damage to
an application, system, or device
WARNING! Information that alerts you to potential personal injury

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 9
 Ruckus Virtual SmartZone Getting Started Guide
10 Part Number: 800-71549-001 Rev A
Installation Preparation
• Obtaining the vSZ Distribution................................................................................................................................. 11
• Preparing the vSZ Interface Settings to Use.............................................................................................................11
• Determining the System Resources That the Virtual Machine Requires.................................................................... 12

Obtaining the vSZ Distribution

You have to download the .OVA file and documentation for the controller from the vSZ download page on the Ruckus Wireless support
website. The vSZ distribution package, which is based on the Open Virtualization Format (OVF) framework, consists of a virtual appliance.

Open Virtualization Format contains the following files:

• Description file (.ovf)
• Manifest file (.mf)
• Virtual machine state file (.vmdk)

Preparing the vSZ Interface Settings to Use

vSZ comes with the option to operate with either one (1) network interface or three (3) network interfaces. Once the network interface
configuration has been made and setup executed, the number of network interfaces can no longer be modified.

CAUTION
If you choose to operate the vSZ with three network interfaces, you must configure the three vSZ interfaces to be on three
different subnets when you run the Setup Wizard. Failure to do so may result in loss of access to the web interface or failure of
system functions and services.

• IP address
• Netmask
• Gateway
• Primary DNS server
• Secondary DNS server

TABLE 3 vSZ interfaces

Interface Description

AP Used for AP configuration and client traffic

Cluster Used for cluster traffic
Management (Web) Used for management traffic. The IP address that
you assign to this interface will be the IP address
at which you can access the vSZ web interface.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 11
Installation Preparation
Determining the System Resources That the Virtual Machine Requires

Determining the System Resources That the Virtual

Machine Requires
The number of APs and clients that vSZ can support depends on the system resources (CPU and memory) that the virtual machine running
vSZ has.

vSZ is capable of automatically scaling to and supporting a higher number of APs and clients if it determines, at system bootup, that there
is sufficient CPU and memory on the virtual machine to support more APs and clients. The two tables below list the maximum
recommended number of APs and clients that the vSZ can support based on the available vCPU and memory available on the virtual
machine.

CAUTION
When either the AP count or the client count reaches the maximum limit specified in the tables, you must allocate additional
system resources to the VM. For example, if a VM is allocated with Level 3 resources to handle 100 APs and the AP count
increases to 101, you must update the VM to Level 4 resources to prevent performance-related issues.

All resource levels in the following tables are provided based on Intel Xeon CPU E5- 2630v2 @2.60 GHz. If the server on which you are
hosting the controller software is using a different CPU generation and/or model, it may perform differently. In this case, CPU adjustments
can be made to generate the same level of performance.

CAUTION
The minimum memory and CPU requirements have changed in this release. You may need to upgrade your infrastructure before
upgrading. Please read carefully. This is the minimum requirement recommended.

vSZ High Scale recommended resources

TABLE 4 vSZ High Scale recommended resources

AP Count Range Maximum Nodes per AP Count vCPU RAM Disk Size Preserved Concurrent Resource
Clients Cluster per Node Events CLI Level
Connection

From To Max Logic Processor GB GB Max Max

[1][2]

10,001 30,000 300,000 4 10,000 24 48 600 3M 4 8

20,000 200,000 3
5,001 10,000 100,000 1-2 10,000 24 48 600 3M 4 7
2,501 5,000 50,000 1-2 5,000 12 28 300 2M 2 6.5
1,001 2,500 50,000 1-2 2,500 6 22 300 1.5 M 2 6
501 1,000 20,000 1-2 1,000 4 18 100 600 K 2 5
101 500 10,000 1-2 500 4 16 100 300 K 2 4
1 100 2,000 1-2 100 2 13 100 60 K 2 3

Ruckus Virtual SmartZone Getting Started Guide

12 Part Number: 800-71549-001 Rev A
 Installation Preparation
Determining the System Resources That the Virtual Machine Requires

vSZ Essentials recommended resources

TABLE 5 vSZ Essentials recommended resources

AP Count Range Maximum Nodes per AP Count vCPU RAM Disk Size Preserved Concurrent Resource
Clients Cluster per Node Events CLI Level
Connection

From To Max Logic Processor GB GB Max Max

[1][2]

1025 3,000 60,000 4 1,024 8 18 250 10 K 2 3

2,000 40,000 3
501 1,024 25,000 1-2 1,024 8 18 250 10 K 2 2
101 500 10,000 1-2 500 4 16 100 5K 2 1.5
1 100 2,000 1-2 100 2 13 100 1K 2 1

NOTE
Logic Processor 1 vCPU requirement is based on Intel Xeon CPU E5- 2630v2 @2.60 GHz.
Logic Processor 2 Azure with low CPU throughput unsupported. The vSZ with the lowest resource plan (2 core CPU, 13 GB
memory) can NOT be supported due to the low CPU throughput on Azure.

Clustering Limitations for vSZ-H

• vSZ-H supports up to 10,000 APs per node or 30,000 APs per cluster, assuming proper system resources are made available. It
supports clustering of up to 4 nodes when using Resource Level 6.
• At 4 nodes, the maximum number of APs and clients that can be supported are 30,000 and 300,000 respectively.

Clustering Limitations for vSZ-E

• vSZ-E supports up to 1,024 APs per node or 3000 APs per cluster, assuming proper system resources are available. It supports
clustering of up to 4 nodes when using Resource Level 2.
• Above 2 nodes in a cluster at Resource Level 2, additional 2 CPU cores need to be added to each node to support the added
search capabilities and replication.
• At 4 nodes, the maximum number of APs and clients that can be supported are 3,000 and 60,000 respectively.
• NAT operation for vSZ cluster: Currently, each node requires its own public IP address for its NAT'ed interface. As such, a 1:1 NAT
is recommended for setting up a cluster behind a NAT environment.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 13
 Ruckus Virtual SmartZone Getting Started Guide
14 Part Number: 800-71549-001 Rev A
Installing the vSZ on a Hypervisor
• Preparing a Hypervisor............................................................................................................................................ 15
• Installing the vSZ on VMWare vSphere Hypervisor................................................................................................... 15
• Installing the vSZ on Windows Server Hyper V.........................................................................................................28
• Installing the vSZ on a Kernel based Virtual Machine Hypervisor.............................................................................. 40

Preparing a Hypervisor
This section lists the hypervisors (and their release versions) on which you can install the vSZ.

TABLE 6 Hypervisors that the vSZ supports

Vendor Hypervisor Version

VMWare ESXi 5.5 and later

Windows Windows Server Hyper-V Windows Server Hyper-V (2012 R2)
KVM CentOS 7.0 (64bit)

Installing the vSZ on VMWare vSphere Hypervisor

You have to install the vSZ on a VMWare vSphere hypervisor.

Before You Begin

You have to complete the prerequisites before installing the vSZ on VMWare vSphere.

Verify that you have the prerequisites before installing the vSZ on VMWare vSphere.
• Verify that vSphere client is installed.
• You can deploy the vSZ only on hosts that are running ESXi version 5.5 and later.
• The vSZ appliance requires at least 100GB of disk space and is limited to a maximum size of 600GB. The vSZ appliance can be
deployed with thinprovisioned virtual disks that can grow to the maximum size of 600GB.

Creating a vSZ Instance from the OVA File

You can create a vSZ instance using the vSphere Web Client.
Before continuing, ensure you have already downloaded the vSZ distribution package from the Ruckus Wireless. See Obtaining the vSZ
Distribution for more information.
Follow these steps to create a vSZ instance from the OVA file.

1. Use the VMWare vSphere client to log on to the ESXi management interface.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 15
Installing the vSZ on a Hypervisor
Installing the vSZ on VMWare vSphere Hypervisor

2. Click File> Deploy OVF Template. The Source screen of the Deploy OVF Template wizard appears.

FIGURE 1 Click Deploy OVF Template

Ruckus Virtual SmartZone Getting Started Guide

16 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on VMWare vSphere Hypervisor

3. Click Browse to locate the .ova file that you downloaded earlier. Select the template.

FIGURE 2 Click Browse, and then locate and select .ova file

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 17
Installing the vSZ on a Hypervisor
Installing the vSZ on VMWare vSphere Hypervisor

4. Click Next. The OVF Template Details screen appears.

FIGURE 3 The OVF Template Details screen

5. Review the OVA virtual appliance details, and then click Next. The End User License Agreement (EULA) screen appears.

Ruckus Virtual SmartZone Getting Started Guide

18 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on VMWare vSphere Hypervisor

6. Click Accept to agree to the EULA terms, and then click Next. The Host/Cluster screen appears.

FIGURE 4 Accept the EULA for the vSZ OVA

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 19
Installing the vSZ on a Hypervisor
Installing the vSZ on VMWare vSphere Hypervisor

7. Select the host or cluster on which you want to run the deployed template, and then click Next. The Resource Pool screen
appears.

FIGURE 5 Select the destination host or cluster

Ruckus Virtual SmartZone Getting Started Guide

20 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on VMWare vSphere Hypervisor

8. Select the resource pool within which you want to deploy the template, and then click Next. The storage screen appears.

FIGURE 6 Select the resource pool for the OVA template

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 21
Installing the vSZ on a Hypervisor
Installing the vSZ on VMWare vSphere Hypervisor

9. Select the destination storage (data store) for virtual machine files, and then click Next. The Disk Format screen appears.

FIGURE 7 Select the data store for the virtual machine files

Ruckus Virtual SmartZone Getting Started Guide

22 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on VMWare vSphere Hypervisor

10. Select the disk format that is appropriate for your deployment scenario. Options include:
• Thick Provision Lazy Zeroed
• Thick Provision Eager Zeroed
• Thin Provision

FIGURE 8 Select the disk format for your deployment scenario

11. Click Next. The Network Mapping screen appears.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 23
Installing the vSZ on a Hypervisor
Installing the vSZ on VMWare vSphere Hypervisor

12. Select the ESXi virtual network interface that you want to use for the control interface, and then click Next. The Ready to Complete
screen appears.
The installation screen only allows you to select the virtual network interface for the control interface. After you complete the
installation (and before you power on and set up the vSZ), you will need to adjust the cluster and management interfaces as
appropriate.

FIGURE 9 Select the virtual network interface that the template will use

Ruckus Virtual SmartZone Getting Started Guide

24 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on VMWare vSphere Hypervisor

13. Review the settings that you have configured on the previous screens. If you find a setting that you want to change, click Back
until you reach the screen where you can edit the setting. Update the setting, and then click Next until you reach the Ready to
Complete screen again.

FIGURE 10 Review the settings that you have configured

14. Make sure that the Power on after deployment check box is clear so you can adjust the network settings before the vSZ
setup.Caution: If you power on the vSZ after installation, you will no longer be able to adjust the network settings.
15. Click Finish.

ESXi deploys the new vSZ instance. When ESXi completes the deployment, the new vSZ instance appears on the list of installed virtual
machines on the target host.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 25
Installing the vSZ on a Hypervisor
Installing the vSZ on VMWare vSphere Hypervisor

FIGURE 11 The vSZ instance appears on the list of installed VMs

You have completed creating a vSZ instance from the OVA file.

Allocating Resources and Assigning Network Interfaces

Before starting the vSZ instance for the first time, edit the virtual machine settings to allocate CPU and memory resources to the vSZ and to
assign the ESXi network interfaces to the remaining vSZ interfaces (cluster and management).

Ensure that you read steps 1-7 before starting the application.
Follow these steps to allocate resources and assign network interfaces to the vSZ.

1. On the list of virtual machines, click the new vSZ instance.

2. Click Actions to display the additional options, and then click Edit Settings.
3. Set the number of CPUs and the amount of RAM to allocate to the vSZ instance. By default, the OVA template is set to 4 CPUs
and 8GB of RAM.
4. Under Network adapter 1, verify that it is the same ESXi network interface that you selected for the control interface during the
OVA import process. Ensure that the Connect at Power On check box is selected.

Ruckus Virtual SmartZone Getting Started Guide

26 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on VMWare vSphere Hypervisor

5. Under Network adapter 2, select the ESXi network interface for the cluster interface from the drop-down list. Ensure that the
Connect at Power On option is selected.
6. Under Network adapter 3, select the ESXi network interface for the management interface from the drop-down list. Ensure that the
Connect at Power On option is selected.

FIGURE 12 Select the interfaces to use

7. Click OK. You have completed allocating resources and assigning network interfaces to the vSZ.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 27
Installing the vSZ on a Hypervisor
Installing the vSZ on Windows Server Hyper V

Powering on the vSZ virtual machine

The next step is to power on the vSZ virtual appliance.

1. From the list of virtual machines on the host, click the vSZ instance.
2. Under Basic Tasks, click Power on the virtual machine.

FIGURE 13 Click Power on the virtual machine

3. Open a console window to monitor the startup process. To do this, click the Action menu, and then click Open Console.
After the vSZ completes its startup process, you are ready to perform the initial IP address setup of the vSZ. You will use the
console connection to perform this task.

Installing the vSZ on Windows Server Hyper V

Before you begin, verify that Hyper-V is enabled on Windows Server. Follow these steps to install the vSZ on Windows Server Hyper-V.

1. Obtain a copy of the vSZ image in VHD format.

2. Extract the vSZ image to the .vhd disk file.
3. Copy the image to the Windows Server on which you are running Hyper-V.
4. On the Windows Server, click Start > Administrative Tools, and then double-click Hyper-V Manager.

Ruckus Virtual SmartZone Getting Started Guide

28 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on Windows Server Hyper V

5. In the Hyper-V Manager, select the Hyper-V core for which you want to create a virtual machine and click Virtual Machine >
Action > New > New Virtual Machine Wizard. The appears and displays the Before You Begin screen.

FIGURE 14 Click Action > New > Virtual Machine

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 29
Installing the vSZ on a Hypervisor
Installing the vSZ on Windows Server Hyper V

6. Click Next. The Specify Name and Location screen appears.

FIGURE 15 The New Virtual Machine Wizard screen

Ruckus Virtual SmartZone Getting Started Guide

30 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on Windows Server Hyper V

7. In Name, type a name for the virtual machine that you are installing (for example, Virtual SmartZone).

FIGURE 16 Specify Name and Location

8. Specify the folder on the server where you want to install the virtual machine.
a) To install the virtual machine in the default location, make sure that the Store the virtual machine in a different location check
box is clear.
b) To install the virtual machine in a location other than the default, select and Store the virtual machine in a different location
check box, and then browse to or type the new location.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 31
Installing the vSZ on a Hypervisor
Installing the vSZ on Windows Server Hyper V

9. Click Next. The Specify Generation screen appears.

FIGURE 17 Specify Generation

10. Select Generation 1 for the virtual machine that you are installing. Hyper-V offers Generation 1 and Generation 2. See the Hyper-V
documentation for more information about these two generations.

Ruckus Virtual SmartZone Getting Started Guide

32 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on Windows Server Hyper V

11. Click Next. The Assign Memory screen appears.

FIGURE 18 Assign Memory

12. In Startup memory, type 13GB for vSZ High Scale or 15GB for vSZ Essentials (as relevant), which are the minimum memory that
Ruckus Wireless recommends for deploying vSZ. You can type a higher value if more memory is available on the server. For more
information, see Table 4 and Table 5.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 33
Installing the vSZ on a Hypervisor
Installing the vSZ on Windows Server Hyper V

13. Click Next. The Configure Networking

FIGURE 19 Configuring Network

14. In Connection, select the network adapter that you want the virtual machine to use.

Ruckus Virtual SmartZone Getting Started Guide

34 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on Windows Server Hyper V

15. Click Next. The Connect Virtual Hard Disk screen appears.

FIGURE 20 Connect Virtual Hard Disk

16. Select Use an existing virtual hard disk.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 35
Installing the vSZ on a Hypervisor
Installing the vSZ on Windows Server Hyper V

17. Click Browse to specify the location of the existing virtual hard disk for the virtual machine to use.

FIGURE 21 Selecting Virtual Hard Disk

Ruckus Virtual SmartZone Getting Started Guide

36 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on Windows Server Hyper V

18. Click Next. The Completing New Virtual Machine Wizard screen appears.

FIGURE 22 Completing New Virtual Machine Wizard

19. Review the settings that you can configure for the virtual machine. If you find any setting that need to be changed, click Previous
until you reach the screen where you can update the setting. Update the setting, and then click Next until the Completing New
Virtual Machine Wizard screen appears again.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 37
Installing the vSZ on a Hypervisor
Installing the vSZ on Windows Server Hyper V

20. Click Finish to install the virtual machine. When Windows Server completes installing the virtual machine, the New Virtual Machine
Wizard disappears and the virtual machine you installed appears on the list of virtual machines on Hyper-V Manager.

FIGURE 23 The virtual machine you installed appears on the list of virtual machines on Hyper- V Manager

Ruckus Virtual SmartZone Getting Started Guide

38 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on Windows Server Hyper V

21. Right-click the virtual machine you installed, and then click Start to power on the virtual machine.

FIGURE 24 Right-click the virtual machine, and then click Start

The Virtual Machine Connection screen appears.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 39
Installing the vSZ on a Hypervisor
Installing the vSZ on a Kernel based Virtual Machine Hypervisor

FIGURE 25 Virtual Machine Connection

22. Login to the virtual machine with your credentials.

You have now completed installing the vSZ on Windows Server Hyper-V.

Installing the vSZ on a Kernel based Virtual Machine

Hypervisor
This section describes how to install the vSZ on a KVM hypervisor.

Extracting the vSZ Image

The vSZ image for a kernel-based virtual machine (KVM) is distributed in QCOW2 format.

1. Obtain the vSZ image in QCOW2 format.

2. Copy the image to the KVM.
3. Open the terminal window.

Ruckus Virtual SmartZone Getting Started Guide

40 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on a Kernel based Virtual Machine Hypervisor

4. Make the image bin file executable by entering the following command: chmod +x {file name of the controller QCOW bin} See
Figure for an example.

FIGURE 26 Make the bin file executable

5. Extract the contents of the QCOW2 bin file.

FIGURE 27 Extract the contents of the QCOW2 image

The end user license agreement appears on screen.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 41
Installing the vSZ on a Hypervisor
Installing the vSZ on a Kernel based Virtual Machine Hypervisor

6. At the Accept this agreement? [yes/no] prompt, enter yes.

FIGURE 28 Accept the EULA terms

The KVM continues to extract the contents of the image. When the extraction process is complete, the QCOW2 file appears in the
same directory as the .bin file.

FIGURE 29 The QCOW2 file appears in the same directory as the .bin file

NOTE
If the “uudecode: command not found” error appears during the extraction process, install the “sharutils” package on
the KVM, and then try extracting the image again.

7. Resize the vSZ disk image, if necessary. By default, the vSZ disk size is 50GB. If you want to allocate more disk space to the vSZ,
run the qemu-img command. The complete syntax is as follows: qemu-img resize {file name of the controller QCOW bin} +size

Ruckus Virtual SmartZone Getting Started Guide

42 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on a Kernel based Virtual Machine Hypervisor

Setting Up the vSZ

You can set up the vSZ using the Red Hat Virtual Machine Manager (also known as “virt-manager”). If you are installing the vSZ on a
different hypervisor or virtual machine monitor, the procedure may be slightly different. Refer to the hypervisor documentation for more
information.

1. Start the Virtual Machine Manager by clicking Applications > System Tools > Virtual Machine Manager. Or double-click the Virtual
Machine Manager icon if it appears on the desktop. The Virtual Machine Manager interface appears.

FIGURE 30 The Virtual Machine Manager interface

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 43
Installing the vSZ on a Hypervisor
Installing the vSZ on a Kernel based Virtual Machine Hypervisor

2. In File, click Create New VM. Or click the New VM icon. The New VM screen appears

FIGURE 31 The New VM

Ruckus Virtual SmartZone Getting Started Guide

44 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on a Kernel based Virtual Machine Hypervisor

3. Configure the options on the New VM (Step 1 of 4) screen.

a) In Name, type a name that you want to assign to the virtual machine.
b) In Choose how you would like to install the operating system, click Import existing disk image.

FIGURE 32 Type a name and select how you want to install the operating system

4. Click Forward. The Locate Existing Storage dialog box appears.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 45
Installing the vSZ on a Hypervisor
Installing the vSZ on a Kernel based Virtual Machine Hypervisor

5. Browse to the location of the vSZ QCOW2 image, select the image file, and then click Open. The New VM (Step 2 of 4) screen
reappears and displays the storage path to the QCOW2 image file that you selected.

FIGURE 33 Browse to the vSZ QCOW2 image

Ruckus Virtual SmartZone Getting Started Guide

46 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on a Kernel based Virtual Machine Hypervisor

6. In the lower portion of the New VM (Step 2 of 4) screen, select the operating system type and version.
a) In OS type, select Linux.
b) In Version, select Generic 2.6.x kernel.

FIGURE 34 Select the operating system and version

7. Click Forward. The New VM (Step 3 of 4) screen appears.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 47
Installing the vSZ on a Hypervisor
Installing the vSZ on a Kernel based Virtual Machine Hypervisor

8. Configure the memory and CPU settings of the virtual machine.

a) In Memory (RAM), set to memory (in MB) that you want to allocate to the vSZ.
b) In CPU, set the number of CPUs that you want to allocate to the vSZ.

FIGURE 35 Configure the memory and CPU settings

Ruckus Virtual SmartZone Getting Started Guide

48 Part Number: 800-71549-001 Rev A
 Installing the vSZ on a Hypervisor
Installing the vSZ on a Kernel based Virtual Machine Hypervisor

9. Click Forward. The New VM (Step 4 of 4) screen appears and displays a summary of the settings you configured.

FIGURE 36 A summary of the settings you configured appears

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 49
Installing the vSZ on a Hypervisor
Installing the vSZ on a Kernel based Virtual Machine Hypervisor

10. Verify that the settings you configured on the previous screens are correct. If you need to make changes to any of the settings,
click Back until you reach the screen on which the setting appears, make the change, and then click Forward until you reach the
New VM (Step 4 of 4) screen again.
11. Click Finish to install the vSZ on the virtual machine.
12. After you complete installing the vSZ on the virtual machine, decide how many interfaces you want the vSZ to use. The vSZ
supports either a single interface or three interfaces. By default, a single interface exists after installation.
• If you want the vSZ to use a single interface, you do not need to take action in this step. Continue to the next step.
• If you want the vSZ to use three interfaces, you must create the two additional interfaces before the initial bootup of the vSZ.
Once the vSZ has completed its initial bootup, you will no longer be able to change the number of interfaces.
If you want to add interfaces, you must do so before the initial bootup of the vSZ. After the initial bootup, you will no longer be able
to change the number of interfaces.

FIGURE 37 By default, a single interface exists

13. Power on the virtual machine. The vSZ performs its initial bootup.
14. When the vSZ login prompt appears, enter admin.

You have completed setting up the vSZ on a KVM hypervisor. You are now ready to start the vSZ Setup Wizard. See Using the Setup
Wizard to Install vSZ for more information.

Ruckus Virtual SmartZone Getting Started Guide

50 Part Number: 800-71549-001 Rev A
Installing the vSZ on Microsoft Azure
• Introduction............................................................................................................................................................. 51
• Logging into Microsoft Azure................................................................................................................................... 51
• Creating a Storage Account and Container..............................................................................................................56
• Uploading the vSZ Image to Microsoft Azure........................................................................................................... 60
• Creating a vSZ Image on Microsoft Azure................................................................................................................ 62
• Creating a Network................................................................................................................................................. 64
• Creating a vSZ Virtual Machine................................................................................................................................ 68
• Configuring Port Numbers for Virtual Machines........................................................................................................74
• Assigning a Static Public IP Address to a VM.......................................................................................................... 78
• Assigning a Static Internal IP Address to a Virtual Machine...................................................................................... 82

Introduction
You can install vSZ on Microsoft Azure using the procedure outlined.

NOTE
The minimum memory and CPU requirements have changed in this release. You may need to upgrade your infrastructure before
upgrading. Please read carefully. This is the minimum requirement recommended. Refer to the tables in Determining the System
Resources That the Virtual Machine Requires on page 12 in the Installation Preparation chapter.

Logging into Microsoft Azure

As the first step of installing vSZ on Microsoft Azure, you have to log into Microsoft Azure.

1. Click http://azure.microsoft.com/en-us/ to access the Microsoft Azure site.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 51
Installing the vSZ on Microsoft Azure
Logging into Microsoft Azure

2. Click the Portal tab as shown in the figure.

FIGURE 38 Portal Tab

Ruckus Virtual SmartZone Getting Started Guide

52 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Logging into Microsoft Azure

3. Click Azure Classic Portal.

FIGURE 39 Azure Classic Portal

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 53
Installing the vSZ on Microsoft Azure
Logging into Microsoft Azure

4. The Microsoft Azure login page appears and redirects you to the Ruckus Wireless login page as shown in the figure.

FIGURE 40 Microsoft Azure login page

If the page does not redirected to the Ruckus Wireless login page and asks to you choose a user account, select the Work or
school account as shown in the figure.

FIGURE 41 Microsoft Azure Account

Ruckus Virtual SmartZone Getting Started Guide

54 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Logging into Microsoft Azure

The Ruckus Wireless login page appears.

5. Enter your User name and Password to login.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 55
Installing the vSZ on Microsoft Azure
Creating a Storage Account and Container

Creating a Storage Account and Container

To create a Microsoft Azure storage account, perform the steps outlined in this section.

1. From the Microsoft Azure page, click Create a storage account. The Create a storage screen appears.

FIGURE 42 Creating a storage account

2. In URL, type the URL.

3. In Location/Affinity Group, type the location of the storage.
4. In Replication, select an option from the drop-down list.

Ruckus Virtual SmartZone Getting Started Guide

56 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Creating a Storage Account and Container

5. Click Create Storage Account. The Storage screen appears listing the new storage account.

FIGURE 43 New storage account listed

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 57
Installing the vSZ on Microsoft Azure
Creating a Storage Account and Container

6. Select the storage account and click Containers > Create a Container.

FIGURE 44 Creating a storage container

The New Container screen appears.

Ruckus Virtual SmartZone Getting Started Guide

58 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Creating a Storage Account and Container

FIGURE 45 The New Container screen

7. In Name, type the name of the storage container.

8. In Access, select an option from the drop-down list.
9.
Click the icon . The new container is listed in the Containers tab.

FIGURE 46 Containers

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 59
Installing the vSZ on Microsoft Azure
Uploading the vSZ Image to Microsoft Azure

Uploading the vSZ Image to Microsoft Azure

You have to upload the vSZ image to Microsoft Azure. Follow these steps outlined in this section to upload the vSZ image to Microsoft
Azure.

Ensure that you have installed Windows Azure Power Shell (web platform installer) from http://go.microsoft.com/fwlink/p/?
linkid=320376&clcid=0x409.

1. Open Microsoft Azure PowerShell and type the add-azureaccount command. The Microsoft Azure Login screen appears.
2. Type the User name and Password.
3. Click Sign in. A success message appears confirming your Microsoft Azure account is added.

FIGURE 47 Account creation success message

Ruckus Virtual SmartZone Getting Started Guide

60 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Uploading the vSZ Image to Microsoft Azure

4. Type command add-azurevhd to initiate uploading the image.

Ensure that the URL in Destination and Microsoft Azure storage are the same.

FIGURE 48 Verifying URLs match

FIGURE 49 Uploading the vSZ image

After the vSZ image is uploaded, a confirmation message appears.

FIGURE 50 vSZ message indicating image upload is complete

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 61
Installing the vSZ on Microsoft Azure
Creating a vSZ Image on Microsoft Azure

Creating a vSZ Image on Microsoft Azure

ollow these steps to create a vSZ image on Microsoft Azure:

1. From the Microsoft Azure page, click Virtual Machines > Images.

FIGURE 51 Creating an image

Ruckus Virtual SmartZone Getting Started Guide

62 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Creating a vSZ Image on Microsoft Azure

2. Click Create an Image. The Create an Image from VHD screen appears.

FIGURE 52 Create an Image from VHD

3. In Name, type the name of the image.

4. In Description, provide a brief description about the image.
5. Click VHD URL and browse to the cloud storage to select the VHD file.
6. In Operating System Family, select an option from the drop-down list.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 63
Installing the vSZ on Microsoft Azure
Creating a Network

7.
Click the icon. The new image is listed in the Images tab.

FIGURE 53 A new vSZ image is created

Creating a Network
Follow these steps to create a virtual network.

1. From the Microsoft Azure page, click Networks > Virtual Networks.

FIGURE 54 Creating a virtual network

Ruckus Virtual SmartZone Getting Started Guide

64 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Creating a Network

2. Click Create a Virtual Network. The Virtual Network Details screen appears.

FIGURE 55 Virtual Network Details screen

3. In Name, type the name of the virtual network.

4. In Location, select a location from the drop-down list.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 65
Installing the vSZ on Microsoft Azure
Creating a Network

5.
Click the icon. The DNS Servers and VPN Connectivity screen appears.

FIGURE 56 DNS Servers and VPN Connectivity screen

6. In DNS Server, type the name of the server and IP address.

7. Configure the VPN connectivity. You can choose between a point-to-site or site-to-site connectivity.

Ruckus Virtual SmartZone Getting Started Guide

66 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Creating a Network

8.
Click the icon. The Virtual Network Address Spaces screen appears.

FIGURE 57 Virtual Network Address Spaces screen

9. Type the address space and subnet information as appropriate.

10.
Click the icon. The virtual network is created and listed in the networks page.

FIGURE 58 The new virtual network is added and listed in the Networks page

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 67
Installing the vSZ on Microsoft Azure
Creating a vSZ Virtual Machine

Creating a vSZ Virtual Machine

Follow these steps to create a vSZ virtual machine.

1. From the Microsoft Azure page, click Virtual Machines > Instances. The New screen appears.

FIGURE 59 New screen

Ruckus Virtual SmartZone Getting Started Guide

68 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Creating a vSZ Virtual Machine

2. Click Compute > Virtual Machine > Quick Create > From Gallery. The Choose an Image screen appears.

FIGURE 60 Choosing an image

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 69
Installing the vSZ on Microsoft Azure
Creating a vSZ Virtual Machine

3. Click My Images. A list of images you created appears.

FIGURE 61 A list of images

4. Select an image.

Ruckus Virtual SmartZone Getting Started Guide

70 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Creating a vSZ Virtual Machine

5.
Click the icon. The Virtual Machine Configuration screen appears.

FIGURE 62 Virtual machine configuration - screen 1

6. In Virtual Machine Name, type the name of the VM.

7. In Tier, select Standard.
8. In Size, select an option from the drop-down list.
9. In New User Name, type the user name.
10. In Authentication, select the Provide a Password option. Type the new password and confirm.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 71
Installing the vSZ on Microsoft Azure
Creating a vSZ Virtual Machine

11.
Click the icon. The next configuration screen appears

FIGURE 63 Virtual machine configuration - screen 2

12. In Cloud Service, select a service from the drop-down list.

13. In Cloud Service DNS Name, type the DNS name.
14. In Region/Affinity Group/Virtual Network, select an option from the drop-down list.
15. In Virtual Network Subnets, select an option from the drop-down list.
16. In Availability Set, select an option from the drop-down list.
17. In End Points, type the values as appropriate. Refer to step 4 of Creating the vSZ Instance on page 122

Ruckus Virtual SmartZone Getting Started Guide

72 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Creating a vSZ Virtual Machine

18.
Click the icon. The next configuration screen appears.

FIGURE 64 Virtual machine configuration - screen 3

19. In VM Agent, select the check-box to enable VM agent.

20.
Click the icon. The new VM is listed in the Virtual Machines page.

FIGURE 65 The new VM is created and listed

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 73
Installing the vSZ on Microsoft Azure
Configuring Port Numbers for Virtual Machines

Configuring Port Numbers for Virtual Machines

Follow these steps to configure port numbers for your VM using Microsoft Azure.

1. From the Microsoft Azure page, click Virtual Machines > Instances.

FIGURE 66 Selecting a VM

2. Select the virtual machine to configure the ports.

3. Click Endpoints.

Ruckus Virtual SmartZone Getting Started Guide

74 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Configuring Port Numbers for Virtual Machines

4. Select Add Endpoint..

FIGURE 67 Adding endpoints

The Add Endpoint screen appears.

FIGURE 68 Add Endpoint - screen

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 75
Installing the vSZ on Microsoft Azure
Configuring Port Numbers for Virtual Machines

5. Select Add a stand-alone end point.

Ruckus Virtual SmartZone Getting Started Guide

76 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Configuring Port Numbers for Virtual Machines

6.
Click the icon. The next configuration screen appears.

FIGURE 69 Adding Endpoint - screen 2

7. In Name, type the name of the endpoint.

8. In Protocol, select the protocol from the drop-down list.
9. In Public Report, type 8443.
10. In Private Report, type 8443.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 77
Installing the vSZ on Microsoft Azure
Assigning a Static Public IP Address to a VM

11.
Click the icon. The endpoint is created and listed in the Endpoints tab for the VM.

FIGURE 70 A new endpoint for the VM is created and listed

Assigning a Static Public IP Address to a VM

Microsoft Azure assigns a dynamic IP address to a VM when it is created. In addition, a static public IP address must be assigned to a VM
as DNS names cannot be configured in a vSZ; resulting in changes to the public IP address. Follow these steps to assign a static public IP
address to a VM:

1. Open the command prompt and create a static IP by typing the New-AzureReservedIP-ReservedIPName <name>-Label <label
name>-Location <location name> command.

FIGURE 71 Creating a static IP address

Ruckus Virtual SmartZone Getting Started Guide

78 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Assigning a Static Public IP Address to a VM

2. Verify that the static IP address is created by typing the Get-AzureReservedIP command.

FIGURE 72 Verifying static IP address is created

3. Select a VM to assign the static public IP by typing the get-azurevm command.

FIGURE 73 Selecting the VM to assign a static IP address

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 79
Installing the vSZ on Microsoft Azure
Assigning a Static Public IP Address to a VM

4. Set the IP address to the VM by typing the Set-AzureReservedIPAssociation-ReservedIPName <name>-ServiceName <name>

command.

FIGURE 74 Setting the IP address

5. Verify that the static public IP address to assigned to the VM by typing the Get-AzureReservedIP command.

FIGURE 75 Verifying that the IP address is assigned

6. From the Microsoft Azure page, click Virtual Machines > Instances and verify that DNS Name.
7. Select the VM.

Ruckus Virtual SmartZone Getting Started Guide

80 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Assigning a Static Public IP Address to a VM

8. Click the Dashboard tab. Verify that you are able to see the updated Public IP address.

FIGURE 76 Verifying the DNS name and static public IP address changes

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 81
Installing the vSZ on Microsoft Azure
Assigning a Static Internal IP Address to a Virtual Machine

Assigning a Static Internal IP Address to a Virtual

Machine
A Virtual machine in a network is assigned an internal IP address. These addresses change when the VM is restarted. Some scenarios such
as the following might require VMs to have a static internal IP address that does not change: If the VM is an internal DNS server, If the VM is
a node within a cluster, and If the VM is part of a site-to-site VPN connection..

Before You Begin:

• Ensure that a vSZ virtual machine is created using Microsoft Azure.
• Ensure that you assign an internal IP for the VM before configuring the virtual network.
Follow these steps to assign an static internal IP to a VM:

1. From the Microsoft Azure page, click Virtual Machines > Instances.
2. From the Virtual Machines page, select the VM.
An internal IP is assigned to the VM by default when it is created.

FIGURE 77 Default IP assigned to the VM

Ruckus Virtual SmartZone Getting Started Guide

82 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Assigning a Static Internal IP Address to a Virtual Machine

3. Click Shutdown.

FIGURE 78 Shutting down the VM

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 83
Installing the vSZ on Microsoft Azure
Assigning a Static Internal IP Address to a Virtual Machine

4. Verify that the VM has stopped running.

FIGURE 79 Verifying VM has stopped running

5. Open command prompt.

6. Enter the Test-AzureStaticVnetIP -VnetName <name> -IPAddress <test IP address> command to verify that the IP address is
available to assign to the VM.

FIGURE 80 Verifying IP address availability

Ruckus Virtual SmartZone Getting Started Guide

84 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Assigning a Static Internal IP Address to a Virtual Machine

7. Assign the available IP (10.250.1.10 in this example) to the VM using the Get-AzureVM -ServiceName vsz03 -Name vsz03 `|
Set-AzureStaticVNetIP -IPAddress 10.250.1.10 `| Update-AzureVM commands.

FIGURE 81 Assigning the static IP to the VM

8. From the Virtual Machines page, select the VM.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 85
Installing the vSZ on Microsoft Azure
Assigning a Static Internal IP Address to a Virtual Machine

9. Click Start.

FIGURE 82 Starting the VM

Ruckus Virtual SmartZone Getting Started Guide

86 Part Number: 800-71549-001 Rev A
 Installing the vSZ on Microsoft Azure
Assigning a Static Internal IP Address to a Virtual Machine

10. Click the VM properties and verify that the IP address has changed.

FIGURE 83 Verifying static IP address is assigned to the VM

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 87
 Ruckus Virtual SmartZone Getting Started Guide
88 Part Number: 800-71549-001 Rev A
Installing vSZ on the Google Computing
Engine
• Introduction............................................................................................................................................................. 89
• Logging into GCE and Selecting a Project............................................................................................................... 89
• Creating a Storage Bucket...................................................................................................................................... 93
• Uploading the vSZ Image to a Storage Bucket........................................................................................................ 97
• Creating a vSZ Image for Virtual Machines...............................................................................................................99
• Creating a Network and Configuring Firewall Rules................................................................................................102
• Creating a Virtual Machine Instance.......................................................................................................................106

Introduction
You can install vSZ on the Google Computing Engine using the steps mentioned in this section.

NOTE
The minimum memory and CPU requirements have changed in this release. You may need to upgrade your infrastructure before
upgrading. Please read carefully. This is the minimum requirement recommended. Refer to the tables in Determining the System
Resources That the Virtual Machine Requires on page 12 in the Installation Preparation chapter.

Logging into GCE and Selecting a Project

This section describes how to log into the GCE and select a project.

Ensure that you have created an account with GCE and have the login details for the same.

1. Click http://cloud.google.com to access the Google Cloud Platform website.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 89
Installing vSZ on the Google Computing Engine
Logging into GCE and Selecting a Project

2. Log in using your user name and password.

FIGURE 84 Login with user credentials

3. Select My console as shown.

FIGURE 85 GCE Page - My console

Ruckus Virtual SmartZone Getting Started Guide

90 Part Number: 800-71549-001 Rev A
 Installing vSZ on the Google Computing Engine
Logging into GCE and Selecting a Project

4. A list of projects you created is displayed. Click to choose a project.

FIGURE 86 Choose the project

NOTE
You can create projects by clicking Create a project in the drop-down.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 91
Installing vSZ on the Google Computing Engine
Logging into GCE and Selecting a Project

5. Click Product and Services icon to view the list of GCE services.

FIGURE 87 Selecting a Project

Ruckus Virtual SmartZone Getting Started Guide

92 Part Number: 800-71549-001 Rev A
 Installing vSZ on the Google Computing Engine
Creating a Storage Bucket

Creating a Storage Bucket

You can create storage for the objects you create. Follow these steps to create storage.

1. From Google Developers Console, click Product and Services icon > Storage. The Cloud Storage Buckets screen appears.

FIGURE 88 Storage Bucket Browser

2. Click Create Bucket. The New bucket screen appears.

FIGURE 89 Creating a Storage Bucket

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 93
Installing vSZ on the Google Computing Engine
Creating a Storage Bucket

3. Complete the following fields,

a) In Name, type the name of the storage bucket
b) In Storage class, select the storage class you want. You can choose from Standard, Durable Reduced Availability (DRA) or
Cloud Storage Nearline in the drop-down list. Use the below table to compare the storage classes.
c) In Location, select the location from the drop-down list.

Storage Class Characteristics Use Cases Bucket Location

Standard Storage High availability, low latency Storing data that requires low Continental locations
(time to first byte is typically latency access or data that is
tens of milliseconds). frequently accessed ("hot"
objects), such as serving
website content, interactive
workloads, or gaming and
mobile applications
Durable Reduced Availability Lower availability than Applications that are Continental and regional
(DRA) Standard Storage and lower particularly cost-sensitive, or locations
cost per GB stored. for which some unavailability
is acceptable such as batch
jobs and some types of data
backup.
Cloud Storage Nearline Slightly lower availability and Data you do not expect to Continental locations
slightly higher latency (time to access frequently (i.e., no
first byte is typically 2 - 5 more than once per month).
seconds) than Standard Typically this is backup data
Storage but with a lower cost. for disaster recovery, or so
called "cold" storage that is
archived and may or may not
be needed at some future
time.

Ruckus Virtual SmartZone Getting Started Guide

94 Part Number: 800-71549-001 Rev A
 Installing vSZ on the Google Computing Engine
Creating a Storage Bucket

FIGURE 90 New Bucket Information

4. Click Create. The storage bucket you created is listed in the browser.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 95
Installing vSZ on the Google Computing Engine
Creating a Storage Bucket

5. To create another storage, click Create bucket as shown.

FIGURE 91 Creating Another Storage Bucket

6. Verify that the storage bucket has been created.

FIGURE 92 Selecting the Storage Bucket

Ruckus Virtual SmartZone Getting Started Guide

96 Part Number: 800-71549-001 Rev A
 Installing vSZ on the Google Computing Engine
Uploading the vSZ Image to a Storage Bucket

Uploading the vSZ Image to a Storage Bucket

Follow these steps to upload a controller image to the storage bucket you created.

1. Extract the vSZ raw.bin file that you obtained from Ruckus Wireless.

NOTE
• If the "Permission denied" error appears, execute the command "chmod +x vscg-3.5.0.0.808.raw.bin" before
extracting the file.
• If the "uudecode: command not found" error appears during the extraction process, install the "sharutils"
package, and then try extracting the image again.

2. Read the Virtual SmartZone (vSZ) Software License agreement that appears when you extract the raw.bin file.
3. When the Accept this agreement? prompt appears, enter yes to accept the license agreement.

When the extraction process is complete, a raw.tar.gz file appears.

4. On the GCE web interface, browse to the storage bucket where you want to upload the vSZ image file.

FIGURE 93 Browse to the storage bucket

5. Click Upload files.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 97
Installing vSZ on the Google Computing Engine
Uploading the vSZ Image to a Storage Bucket

6. Browse to the location of the .raw.tar.gz image file that you extracted, and then select it.

NOTE
You can only select .raw.tar.gz files.

FIGURE 94 Select the .raw.tar.gz image file that you extracted

7. Click Open to upload the image file.

Your browser displays the progress of the file upload process. After the upload process is complete, the image file appears in the
storage bucket.

FIGURE 95 The image file appears in the storage bucket

Ruckus Virtual SmartZone Getting Started Guide

98 Part Number: 800-71549-001 Rev A
 Installing vSZ on the Google Computing Engine
Creating a vSZ Image for Virtual Machines

Creating a vSZ Image for Virtual Machines

Follow these steps to create a vSZ image for virtual machines.

1. From Google Developers Console, click Compute > Compute Engine.

FIGURE 96 Select Compute Engine

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 99
Installing vSZ on the Google Computing Engine
Creating a vSZ Image for Virtual Machines

2. On the menu, click Images, and then cllick Create Image.

FIGURE 97 Click Create Image

The Create an image page appears.

Ruckus Virtual SmartZone Getting Started Guide

100 Part Number: 800-71549-001 Rev A
 Installing vSZ on the Google Computing Engine
Creating a vSZ Image for Virtual Machines

3. Configure the properties of the new image by fillng out the boxes below.
a) In Name, type the name of the image.
b) In Description, provide a brief description about the image.
c) In Encryption, select an option from the drop-down list containing Automatic (recommended) and Customer supplied.
d) In Source, select Cloud storage file.
e) In Cloud Storage file, click Browse, and then select the .raw.tar.gz image file that you extracted previously.

FIGURE 98 Creating an image

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 101
Installing vSZ on the Google Computing Engine
Creating a Network and Configuring Firewall Rules

4. Click Create.The new image is listed.

GCE creates the new image. When the process is complete, the image you created from the .raw.tar.gz image file appears on the
Images page.

FIGURE 99 The new image you created appears on the Images page

You have completed creating an image.

Creating a Network and Configuring Firewall Rules

Follow these steps to create a network and configure firewall rules for your network.

1. From Google Developers Console, click Networking > Networks. A page displaying a list of networks appears. Select the default
network.

FIGURE 100 List of networks

Ruckus Virtual SmartZone Getting Started Guide

102 Part Number: 800-71549-001 Rev A
 Installing vSZ on the Google Computing Engine
Creating a Network and Configuring Firewall Rules

2. To create a firewall rule, click Add a firewall rule.

FIGURE 101 Add a Firewall Rule

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 103
Installing vSZ on the Google Computing Engine
Creating a Network and Configuring Firewall Rules

3. The Create a firewall rule screen appears.

a) In Name, type the name of the rule
b) In Description, provide a brief description about the rule.
c) In Network, type the network address.
d) In Source filter, select Allow from any source.
e) In Source IP ranges, type the range.
f) In Allowed protocols and ports, type the protocols and ports that will be allowed
g) In Target tags, specify a tag name. It is recommended that you provide a tag as all network instances with this tag will adhere
to the firewall rule.

FIGURE 102 Creating a Firewall Rule

Ruckus Virtual SmartZone Getting Started Guide

104 Part Number: 800-71549-001 Rev A
 Installing vSZ on the Google Computing Engine
Creating a Network and Configuring Firewall Rules

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 105
Installing vSZ on the Google Computing Engine
Creating a Virtual Machine Instance

4. Click Create. A page displaying the new firewall rule appears.

FIGURE 103 Adding Firewall Rules

Creating a Virtual Machine Instance

Follow these steps to create a new virtual machine (VM_ instance.

1. From Google Developers Console, click Compute > Compute Engine > VM instances.
The VM instances page appears.

FIGURE 104 The VM instances page

Ruckus Virtual SmartZone Getting Started Guide

106 Part Number: 800-71549-001 Rev A
 Installing vSZ on the Google Computing Engine
Creating a Virtual Machine Instance

2. Click Create Instance.

The Create an instance page appears.

FIGURE 105 The Create an instance page

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 107
Installing vSZ on the Google Computing Engine
Creating a Virtual Machine Instance

3. Configure the new VM instance that you are creating by filling out the boxes below.
a) In Name, type the name of the VM instance.
b) In Zone, select a zone from the drop-down list.
c) In Machine type, accept or modify the default values for vCPUs and Memory.
d) Under Boot disk, click Change. The Boot disk page appears. Click Custom images.In Show images from, select the storage
bucket where you uploaded the controller image, and then select the image. Click Select.
e) In Project access, allow API access as appropriate.

FIGURE 106 Creating a new VM instance

f) In Firewall, select the options as appropriate.

g) In Project access, allow API access as appropriate.
h) In Management, ensure that the tag provided is the same as the one provided while creating a firewall rule. This ensures port
mapping happens correctly.

Ruckus Virtual SmartZone Getting Started Guide

108 Part Number: 800-71549-001 Rev A
 Installing vSZ on the Google Computing Engine
Creating a Virtual Machine Instance

FIGURE 107 Management Tab

i) In Disk, select the options as appropriate.

FIGURE 108 VM Disk Configuration

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 109
Installing vSZ on the Google Computing Engine
Creating a Virtual Machine Instance

j) In Networking, select the external options as per the following table.

FIGURE 109 Networking

External IP Options Description

Ephemeral The VM is assigned a dynamic public IP address
None The VM instance is not assigned an external IP address
New static IP address The VM is assigned a static public IP address

k) In Access and security, select the options as appropriate.

FIGURE 110 Access and security

Ruckus Virtual SmartZone Getting Started Guide

110 Part Number: 800-71549-001 Rev A
 Installing vSZ on the Google Computing Engine
Creating a Virtual Machine Instance

l) Click Create. The VM instances page appears listing the new VM that is created.

FIGURE 111 The new VM appears on the list of VMs

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 111
Installing vSZ on the Google Computing Engine
Creating a Virtual Machine Instance

You have completed creating a virtual machine instance.

Ruckus Virtual SmartZone Getting Started Guide

112 Part Number: 800-71549-001 Rev A
Installing vSZ on Amazon Web Services
• Installing AWS CLI................................................................................................................................................. 113
• Creating a VM Import Service Role........................................................................................................................ 114
• Installing vSZ on AWS........................................................................................................................................... 115
• Creating the vSZ Instance..................................................................................................................................... 122
• Configuring AWS for a vSZ Instance......................................................................................................................129
• Deleting a vSZ Instance......................................................................................................................................... 133

Installing AWS CLI

Ensure that you have created an account with AWS and have the login details for the same.

1. Install pip by running the command

# curl-O https://bootstrap.pypa.io/get-pip.py
# sudo python27 get-pip.py

2. Install AWS CLI using pip:# pip install

3. Test the installation by using the command: # aws help
4. To set up AWS CLI you need to get your access and secret key identifier. Follow the instructions and find your identifier keys.
5. Use the following command to configure CLI:

# aws configure
AWS Access Key ID [None]: xxx
AWS Secret Access Key [None]: xxx
Default region name [None]: us-west-2
Default output format [None]: json

6. The default region should be the same as the bucket region. Refer to Table for the mapping details. In addition refer to you can
also refer to latest version.
Region Name Region
us-east-1 US East (N. Virginia)
us-west-2 US West (Oregon)
us-west-1 US West (N. California)
eu-west-1 EU (Ireland)
eu-central-1 EU (Frankfurt)
ap-southeast-1 Asia Pacific (Singapore)
ap-northeast-1 Asia Pacific (Tokyo)
ap-southeast-2 Asia Pacific (Sydney)
ap-northeast-2 Asia Pacific (Seoul)
sa-east-1 South America (Sao Paulo)

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 113
Installing vSZ on Amazon Web Services
Creating a VM Import Service Role

Creating a VM Import Service Role

1. In the AWS web interface navigate to AWS dashboard > Identity & Access Management.
2. Check your account permission by navigating to Users > select your Username > Permissions. Your account should have the
permission - IAMFullAccess.

FIGURE 112 Account Permission

3. Create a JSON file called trust-policy.json using the following commands:

{ "Version":"2012-10-17",
"Statement":[
{
"Sid":"",
"Effect":"Allow",
"Principal":{ "Service":"vmie.amazonaws.com"
},
"Action":"sts:AssumeRole",
"Condition":{
"StringEquals":{
"sts:ExternalId":"vmimport"
}
}
}
]
}

4. Use the following command to create a role. Specify the name as vmimport and give the option VM Import/Export access.

# aws iam create-role --role-name vmimport --assume-role-policy-document file://trust-policy.json

Ruckus Virtual SmartZone Getting Started Guide

114 Part Number: 800-71549-001 Rev A
 Installing vSZ on Amazon Web Services
Installing vSZ on AWS

5. Create a policy for the service role by creating a JSON file called role-policy.json using the following commands. Replace the
bucket name with the storage bucket name that you created.

{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":[
"s3:ListBucket",
"s3:GetBucketLocation"
],
"Resource":[
"arn:aws:s3:::<bucket-name>"
]
},
{
"Effect":"Allow",
"Action":[
"s3:GetObject"
],
"Resource":[
"arn:aws:s3:::<bucket-name>/*"
]
}

6. Run the following command to attach the policy to the service role created. # aws iam put-role-policy --role-name
vmimport --policy-name vmimport --policy-document file://role-policy.json

Installing vSZ on AWS

Follow the steps to install vSZ using the AWS web user interface.

Logging into AWS

Follow these steps to login to the AWS site.

1. Click https://aws.amazon.com, to access the Amazon Web Services website.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 115
Installing vSZ on Amazon Web Services
Installing vSZ on AWS

2. Login with your user credentials of user name and password.

FIGURE 113 Login with user credentials

3. Select My Account > AWS Management Console as shown.

FIGURE 114 AWS management console

Ruckus Virtual SmartZone Getting Started Guide

116 Part Number: 800-71549-001 Rev A
 Installing vSZ on Amazon Web Services
Installing vSZ on AWS

Creating a Storage Bucket

Create storage for the objects you create. Follow these steps to create storage.

1. Navigate to Amazon Web Services > Storage and Content Delivery > S3, click Create Bucket as shown.

FIGURE 115 Create Bucket

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 117
Installing vSZ on Amazon Web Services
Installing vSZ on AWS

2. Type the name of the storage bucket and select a suitable regional endpoint to reduce data latency.

FIGURE 116 Selecting regional endpoint

3. Click Create. The storage bucket you created is listed in the browser.
4. Check the storage bucket has been created.

Uploading vSZ Image to a Storage

Follow these steps to upload a vSZ image to the storage bucket you created.

1. Select the storage bucket to upload the vSZ image.

2. Click Upload as shown.

FIGURE 117 Selecting the Storage

3. Browse to the location of the vSZ image and select vSZ image file.
Only images with file-type *.raw or .ova or vmdk can be selected.
4. Click Start Upload to upload the file. The upload process is displayed.

Ruckus Virtual SmartZone Getting Started Guide

118 Part Number: 800-71549-001 Rev A
 Installing vSZ on Amazon Web Services
Installing vSZ on AWS

5. The image is listed in the storage bucket after the image is uploaded.

FIGURE 118 vSZ Image Uploaded to Storage Bucket

NOTE
The vSZ image should be in the Bucket, which has Region information. Example: Test_bucket

AWS Service Policy

VM Import uses a role in your AWS account to perform certain operations (for example, downloading disk images from an Amazon S3
bucket). You must create a role with the name vmimport with the following policy and trusted entities.

1. Install the AWS CLI by following the instructions at http://docs.aws.amazon.com/cli/latest/userguide/installing.html

2. Enter the following command in the AWS CLI #sudo pip install awscli.
3. Get the access key for the AWS CLI by following the instructions on the AWS website.
4. Add the access key details to the AWS CLI using the following commands

# aws
configureAWS Access Key ID [None]:
AWS Secret Access Key
[None]: Default region name [None]:
us-west-2Default output format
[None]: json

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 119
Installing vSZ on Amazon Web Services
Installing vSZ on AWS

5. Create a file named role-policy.json with the following policy:

{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":[
"s3:ListBucket",
"s3:GetBucketLocation"
],
"Resource":[
"arn:aws:s3:::<disk-image-file-bucket>"
]
},
{
"Effect":"Allow",
"Action":[
"s3:GetObject"
],
"Resource":[
"arn:aws:s3:::<disk-image-file-bucket>/*"
]
},
{
"Effect":"Allow",
"Action":[
"ec2:ModifySnapshotAttribute",
"ec2:CopySnapshot",
"ec2:RegisterImage",
"ec2:Describe*"
],
"Resource":"*"
}
]
}

6. Replace <disk-image-file-bucket> with the appropriate Amazon S3 bucket where the disk files are stored. Run the following
command to attach the policy to the role created above:
7. Replace <disk-image-file-bucket> with the appropriate Amazon S3 bucket where the disk files are stored. Run the following
command to attach the policy to the role created above aws iam put-role-policy --role-name vmimport --policy-name
vsz34-policy --policy-document file://role-policy.json

Importing the vSZ Image

Follow these steps to import the vSZ image into AWS shared AMI.

1. Create a JSON file called import.json using the following commands. Replace the bucket name with the storage bucket name that
you created. In this example, the vSZ image file name is vscg-3.4.0.0.750.ova.

{
"Description": "Import vSZ",
"DiskContainers": [
{
"Description": "vSZ 3.4.0.0.750",
"UserBucket":{
"S3Bucket": "<bucket-name>",
"S3Key": "vscg-3.4.0.0.750.ova"
}
}
]
}

2. Run the following command to attach the policy to the role created. # aws ec2 import-image --cli-input-json file://import.json

Ruckus Virtual SmartZone Getting Started Guide

120 Part Number: 800-71549-001 Rev A
 Installing vSZ on Amazon Web Services
Installing vSZ on AWS

3. The system displays the below response.

{
"Status": "active",
"Description": "Import vSZ",
"Progress": "2",
"SnapshotDetails": [
{
"UserBucket": {
"S3Bucket": "<bucket-name>", "S3Key": "vscg-3.4.0.0.750.ova"
},
"DiskImageSize": 0.0
}
],
"StatusMessage": "pending",
"ImportTaskId": "import-ami-ffgof9w1"
}

4. Check the status of the import vSZ image by running the following command. Ensure to enter the correct import task identifier.#
aws ec2 describe-import-image-tasks --import-task-ids "import-ami-ffgof9w1"
5. You will see the following converting status response. Check the status until the converting is complete. The estimated time for
conversion is 30 minutes.

{
"ImportImageTasks": [
{
"Status": "active",
"Description": "vSZ test",
"Progress": "28",
"SnapshotDetails": [
{
"UserBucket": {
"S3Bucket": "<bucket-name>",
"S3Key": "vscg-3.4.0.0.750.ova"
},
"DiskImageSize": 964430848.0,
"Format": "VMDK"
}
],
"StatusMessage": "converting",
"ImportTaskId": "import-ami-ffgof9w1"
}
]
}

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 121
Installing vSZ on Amazon Web Services
Creating the vSZ Instance

Creating the vSZ Instance

Follow these steps to create a vSZ instance on AWS.

1. From Amazon Web Service, click Compute > EC2.

FIGURE 119 Select EC2

2. Navigate to Images > AMIs to ensure that the imported Amazon Machine Image (AMI) exists. In this example the AMI file is
import-ami-ffgof9w1.

FIGURE 120 Select AMI

Ruckus Virtual SmartZone Getting Started Guide

122 Part Number: 800-71549-001 Rev A
 Installing vSZ on Amazon Web Services
Creating the vSZ Instance

3. Navigate to Network & Security > Security Groups > Create Security Group. Security group acts as a virtual firewall that controls
the traffic for one or more instances.

FIGURE 121 Create Security Group

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 123
Installing vSZ on Amazon Web Services
Creating the vSZ Instance

4. Define the setup group name, description, ports and the firewall rule. The table lists the common service ports. For more
information, see Ports to open for AP-vSZ communication.
Port Number Description
UDP
161 SNMP
12223 ZD AP forward update using FTP (control connection)
TCP
21 ZD AP forward update using FTP (control connection)
22 AP SSH
91 SCG AP forward update using HTTP
443 Allows SCG AP get SSH private key and do AP FW udpate via HTTPs
7443 Public API
8022 SSH for management (mgmt-acl is enabled on 1 nic vSZ)
8080 vSZ setup wizard using the web user interface (User will be redirected to the port 8443)
8443 vSZ web user interface
8090, 8099 WISPr for non-web-proxy user equipment
8100 WISPr for web-proxy user equipment
9998 Tomcat for WISPr (internal WISPr portal uses the port 9998)
9080, 9443 Northbound API (NBI)
16384-65000 ZD AP forward update using FTP (data connection)

FIGURE 122 Define Security Group

Ruckus Virtual SmartZone Getting Started Guide

124 Part Number: 800-71549-001 Rev A
 Installing vSZ on Amazon Web Services
Creating the vSZ Instance

5. Navigate to Instances and click on Launch Instances. Follow these steps.

a) Launch Instance

FIGURE 123 Launch instances

b) Navigate to My AMIs and choose the Amazon Machine Image (AMI) that you imported previously.

FIGURE 124 Choose the imported AMI

c) Click Next.
d) Choose a suitable instance type. In this example the instance type is m4.xlarge. Based on the number of APs and client
counts, select the instance type to fit the recommended system resources.
The minimum memory and CPU requirements have changed in this release. You may need to upgrade your infrastructure
before upgrading. Please read carefully. This is the minimum requirement recommended. Refer to Table 5 and Table 6 in the
chapter Preparing to Install the vSZ.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 125
Installing vSZ on Amazon Web Services
Creating the vSZ Instance

FIGURE 125 Choose the instance type

e) Click Next.
f) Select the required network, subnet, and private IP address.
The private IP address cannot be changed once the vSZ image is launched.

FIGURE 126 Configure the instance

g) Click Next.
h) Change the size of storage as required.

Ruckus Virtual SmartZone Getting Started Guide

126 Part Number: 800-71549-001 Rev A
 Installing vSZ on Amazon Web Services
Creating the vSZ Instance

FIGURE 127 Change the storage size

i) Click Next.
j) Specify the vSZ instance by giving it a name.

FIGURE 128 Specify the vSZ instance

k) Click Next.
l) Create a new security group or select an existing group. Configure the rules if required.

FIGURE 129 Specify the security group

m) Click Next.
n) Review the configuration settings.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 127
Installing vSZ on Amazon Web Services
Creating the vSZ Instance

FIGURE 130 Review the configuration settings

o) Click Launch
p) Select the Proceed without a key pair for vSZ instance.

FIGURE 131 Select existing key pair

q) Verify that the vSZ instance is running. Connect the vSZ instance with the selected key pair using the SSH interface.

Ruckus Virtual SmartZone Getting Started Guide

128 Part Number: 800-71549-001 Rev A
 Installing vSZ on Amazon Web Services
Configuring AWS for a vSZ Instance

Configuring AWS for a vSZ Instance

Follow these steps to configure AWS for creating and launching a vSZ instance.

Attach a New Disk Volume

Follow these steps to add a new disk volume.

1. Navigate to EC2 Dashboard > Elastic Block Store > Volumes and click Create Volume as shown.

FIGURE 132 Create Volume

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 129
Installing vSZ on Amazon Web Services
Configuring AWS for a vSZ Instance

2. Enter the required disk type, size and availability zone.

FIGURE 133 Create Volume

3. Click Create.
4. Right click on the newly created disk and select Attach Volume. Enter the instance identifier and the desired device name.

FIGURE 134 Attach Volume

5. Click Attach.

Ruckus Virtual SmartZone Getting Started Guide

130 Part Number: 800-71549-001 Rev A
 Installing vSZ on Amazon Web Services
Configuring AWS for a vSZ Instance

Allocate a Public IP Address

Follow these steps to allocate a public IP address.

1. Navigate to EC2 Dashboard > Network & Security > Elastic IPs. Click Allocate New Address as shown.

FIGURE 135 Allocate New IP Address

2. Click Create.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 131
Installing vSZ on Amazon Web Services
Configuring AWS for a vSZ Instance

3. Right click on the newly created IP address and select Associate Address. Enter the instance identifier or network interface and
the desired device name.

FIGURE 136 Associate Address

4. Click Associate.

Change Security Group

Follow these steps to change the security group.

1. Navigate to Instances and right click the target instance.

2. Select Network > Change Security Group.

Ruckus Virtual SmartZone Getting Started Guide

132 Part Number: 800-71549-001 Rev A
 Installing vSZ on Amazon Web Services
Deleting a vSZ Instance

3. Select the security groups.

FIGURE 137 Allocate New IP Address

4. Click Assign Security Groups.

Deleting a vSZ Instance

Follow these steps to delete a vSZ instance on AWS.

1. Navigate to Instances and right click to select the vSZ instance that you want to delete.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 133
Installing vSZ on Amazon Web Services
Deleting a vSZ Instance

2. Select Instance State > Terminate.

FIGURE 138 Select terminate

Ruckus Virtual SmartZone Getting Started Guide

134 Part Number: 800-71549-001 Rev A
 Installing vSZ on Amazon Web Services
Deleting a vSZ Instance

3. Confirm deletion of the vSZ instance by clicking on Yes, Terminate. The vSZ instance is deleted from AWS.

FIGURE 139 Confirm termination of vSZ instance

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 135
 Ruckus Virtual SmartZone Getting Started Guide
136 Part Number: 800-71549-001 Rev A
Configuring the Virtual Machine
Interfaces
• Configuring the Virtual Machine Interfaces............................................................................................................. 137
• Setting Up the vSZ with One Interface................................................................................................................... 137
• Setting Up the vSZ with Three Interfaces............................................................................................................... 141
• Important Notes About Selecting the System Default Gateway..............................................................................144

Configuring the Virtual Machine Interfaces

The vSZ comes with the option to operate with either one (1) network interface or three (3) network interfaces. Therefore the procedure for
setting up the vSZ interface depends on the number of interfaces that it has.

Follow the procedure below that corresponds to the number of interfaces that the vSZ you are installing has:
• Setting Up the vSZ with One Interface on page 137
• Setting Up the vSZ with Three Interfaces on page 141

NOTE
By default, the VMWare ESXi package comes with three network interfaces. If you want to deploy the vSZ with only one interface,
you can edit the virtual machine settings to remove the extra interfaces. The KVM package, on the other hand, comes with a
single interface. If you want to deploy the vSZ with three interfaces, edit the virtual machine settings to create two additional
interfaces.

Setting Up the vSZ with One Interface

Follow these steps to set up the vSZ with a single network interface

1. Log on to the console using; User name: admin Password: admin

2. At the vSZ> prompt, enter en to enable privileged mode.
3. At the Password prompt, enter admin. The vSZ# prompt appears.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 137
Configuring the Virtual Machine Interfaces
Setting Up the vSZ with One Interface

4. Enter setup. The console displays the current network settings (if any), and then displays the following prompt: Do you want to
setup network? [YES/no]

FIGURE 140 At the vSZ> prompt, enter setup

5. Enter YES. The next screen prompts you to select the profile configuration that you want to use for this instance of vSZ. The
options include: (1) High-Scale (2) Essentials
6. Enter the number that corresponds to the profile configuration that you want to deploy.
If you selected Essentials and the virtual machine has insufficient memory resources available (for example, the VM has only 8GB
of RAM when the minimum RAM requirement is 12GB), you will be unable to continue with the setup process.

FIGURE 141 Enter the number that corresponds to the profile that you want to deploy

7. At the Select IP Version Support prompt, enter one of the following options: 1: IPv4 Only 2: IPv4 and IPv6

Ruckus Virtual SmartZone Getting Started Guide

138 Part Number: 800-71549-001 Rev A
 Configuring the Virtual Machine Interfaces
Setting Up the vSZ with One Interface

8. At the Select IP configuration prompt, enter 1 to set up the single vSZ interface (for Control [AP], Cluster, and Management [Web])
manually.
9. Configure the IP address, netmask, and gateway of the control interface, and then press <Enter>. The IP address configuration
that you entered appears.
10. When the prompt Are these correct? (y/n) appears, enter y to confirm the IP address configuration.

FIGURE 142 Configure the IP address settings of the single interface

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 139
Configuring the Virtual Machine Interfaces
Setting Up the vSZ with One Interface

11. When the prompt Select system default gateway (Control, Cluster, Management)? appears, enter Control.
This entry is case-sensitive. Make sure you enter the system default gateway exactly as shown at the prompt.

FIGURE 143 When prompted for the system default gateway, enter Control

12. At the Primary DNS Server prompt, enter the primary DNS server on the network.
13. At the Secondary DNS Server prompt, enter the secondary DNS server (if any) on the network.

Ruckus Virtual SmartZone Getting Started Guide

140 Part Number: 800-71549-001 Rev A
 Configuring the Virtual Machine Interfaces
Setting Up the vSZ with Three Interfaces

14. At the Control NAT IP prompt, enter the public IP address of the NAT server on the network. If you are not deploying the vSZ
behind a NAT server, press <Enter> without typing an IP address.
Ensure that each vSZ is associated with a dedicated NAT device.

FIGURE 144 Enter the public IP address of the NAT server (if any)

15. Enter restart network.

You have completed configuring the vSZ interfaces. You are now ready to run the vSZ Setup Wizard. See Using the Setup Wizard to Install
vSZ.

Setting Up the vSZ with Three Interfaces

1. Log on to the console using the following credentials: User name: admin Password: admin
2. At the vSZ> prompt, enter en to enable privileged mode.
3. At the Password prompt, enter admin. The vSZ# prompt appears.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 141
Configuring the Virtual Machine Interfaces
Setting Up the vSZ with Three Interfaces

4. Enter setup. The console displays the current network settings (if any), and then displays the prompt: Do you want to setup
network? [YES/no]

FIGURE 145 At the vSZ> prompt, enter setup

Ruckus Virtual SmartZone Getting Started Guide

142 Part Number: 800-71549-001 Rev A
 Configuring the Virtual Machine Interfaces
Setting Up the vSZ with Three Interfaces

5. At the Select IP configuration prompt, enter 1 to set up the control interface manually.
a) Configure the IP address, netmask, and gateway of the control interface, and the press <Enter>. The IP address configuration
that you entered appears.
a) When the message Are these correct? appears, enter y to confirm the IP address configuration.

FIGURE 146 Configure the IP address settings of the control interface

6. At the Select IP configuration prompt, enter 1 to set up the cluster interface manually.
a) Configure the IP address, netmask, and gateway of the cluster interface, and then press <Enter>. The IP address
configuration that you entered appears.
b) When the message Are these correct? appears, enter y to confirm the IP address configuration.
7. At the Select IP configuration prompt, enter 1 to set up the management interface manually.
a) Configure the IP address, netmask, and gateway of the management interface, and the press <Enter>. The IP address
configuration that you entered appears.
Take note of the IP address that you assign to the management interface – you will use this IP address to log on to the vSZ
web interface.
b) When the message Are these correct? appears, enter y to confirm the IP address configuration.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 143
Configuring the Virtual Machine Interfaces
Important Notes About Selecting the System Default Gateway

8. When the message Select system default gateway (Control, Cluster, Management)?, enter Control or Management, depending on
your network topology (see Important Notes About Selecting the System Default Gateway on page 144).
This entry is case-sensitive. Make sure you enter the system default gateway exactly as shown at the prompt.

FIGURE 147 When prompted for the system default gateway, enter either Management or Control (depending on your network design)

9. When prompted, enter the primary and secondary DNS server IP addresses.
10. Enter restart network.

You have completed configuring the vSZ interfaces. You are now ready to run the vSZ Setup Wizard. See Using the Setup Wizard to Install
vSZ on page 145.

Important Notes About Selecting the System Default

Gateway
Depending on your network topology, you may select either the Management or Control interface as the system default gateway.

• If all of the managed APs are located in different locations on the Internet, the vSZ may not know all of the IP subnets of these
APs. In this case, the control interface should be set as the default gateway for the vSZ and you will need to add a static route to
reach the management network.
• If all of the managed APs belong to a single subnet or to multiple subnets on which you can set the route statically, then you can
set the management interface as the default gateway users can set default gateway for the vSZ and set static routes for the vSZ to
reach all of its managed APs.

Ruckus Virtual SmartZone Getting Started Guide

144 Part Number: 800-71549-001 Rev A
Using the Setup Wizard to Install vSZ
• Before You Begin...................................................................................................................................................145
• Step 1: Start the Setup Wizard and Set the Language...........................................................................................146
• Step 2: Select the Profile Configuration That Corresponds to Your vSZ License.....................................................146
• Step 3: Configure the Management IP Address Settings....................................................................................... 148
• Step 4: Configure Dual Mode IP Address Settings Using CLI.................................................................................151
• Step 5: Configure the Cluster Settings...................................................................................................................161
• Step 6: Set the Administrator Password................................................................................................................ 163
• Step 7: Verify the Settings..................................................................................................................................... 164
• Logging On to the Web Interface...........................................................................................................................166

Before You Begin

The Setup Wizard helps you perform the initial configuration of the vSZ by presenting the vSZ configuration options in a set of easy-to-
complete screens.

The Setup Wizard will prompt you to select one of the two available profile configurations (High-Scale profile and Essentials profile). You
must select the profile configuration that corresponds to the vSZ license that you purchased. Before you start the Setup Wizard, make sure
you know the profile configuration that you need to select. If you are unsure which profile configuration you need to select, contact Ruckus
Wireless Support.

Follow these steps to run and complete the vSZ Setup Wizard:
• Start the Setup Wizard and Set the Language
• Select the Profile Configuration That Corresponds to Your vSZ License
• Configure the Management IP Address Settings
• Configure Dual Mode IP Address Settings Using CLI
• Configure the Cluster Settings
• Set the Administrator Password
• Verify the Settings

NOTE
This guide describes the Setup Wizard screens that appear when you select the High-Scale profile configuration. If you select the
Essentials profile configuration, the screens that appear may be slightly different.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 145
Using the Setup Wizard to Install vSZ
Step 1: Start the Setup Wizard and Set the Language

Step 1: Start the Setup Wizard and Set the Language

1. Start your web browser, and then enter the following in the address bar: https://{management-IP-address}:8443, where
management-IP-address is the address you assigned to the management interface. The vSZ Setup Wizard appears, displaying
the Language page.

FIGURE 148 The Language page

2. Select your preferred language for the vSZ web interface. Available options include:

• English
• Traditional Chinese
• Simplified Chinese
3. Click Next. The Profile page appears.

Step 2: Select the Profile Configuration That

Corresponds to Your vSZ License
1. Select the profile configuration that corresponds to the vSZ license that you purchased. Available profile configurations include:

• High Scale
• Essentials

Ruckus Virtual SmartZone Getting Started Guide

146 Part Number: 800-71549-001 Rev A
 Using the Setup Wizard to Install vSZ
Step 2: Select the Profile Configuration That Corresponds to Your vSZ License

2. Click Apply. The message Applying profile appears, and then the Management IP page appears.

FIGURE 149 Select a profile configuration that matches your vSZ license

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 147
Using the Setup Wizard to Install vSZ
Step 3: Configure the Management IP Address Settings

Step 3: Configure the Management IP Address

Settings
The vSZ comes in either a single network interface or three network interfaces (one interface each for Control (AP), Cluster, and
Management (Web) traffic). The following procedure assumes that the vSZ you are installing uses a single network interface.

If the vSZ that you are installing comes with three network interfaces, you must configure each of the three interfaces to be on three different
subnets. Failure to do so may result in loss of access to the web interface or failure of system functions and services.

1. In IP Version Support, select one of the following options:

IPv4 Only: Click this option if you want the controller to obtain an IPv4 address from a DHCP server on the network.
IPv4 and IPv6: Click this option if you want the controller to obtain both IPv4 and IPv6 addresses from DHCP and DHCPv6 servers
on the network. Refer to Step 4: Configure Dual Mode IP Address Settings Using CLI for configuring dual setup using CLI. This is
an alternative method for configuring IPv4 and IPv6 manually if the DHCP server is not available on the network.

FIGURE 150 Select the IP version support

Ruckus Virtual SmartZone Getting Started Guide

148 Part Number: 800-71549-001 Rev A
 Using the Setup Wizard to Install vSZ
Step 3: Configure the Management IP Address Settings

2. Configure the IP address settings of the Control (AP/DataPlane) interface.

a) Under the IPv4 section, click Static, and then enter the network settings that you want to assign to the AP/DataPlane
interface, through which client traffic and configuration data are sent and received.
Although it is possible to use DHCP to assign IP address settings to the Control interface automatically, Ruckus Wireless
strongly recommends assigning a static IP address to this interface.The following network settings are required (others are
optional):
• IP address
• Netmask
• Default gateway
a) If you clicked IPv4 and IPv6 at the beginning of this procedure, under the IPv6 section, click Auto Configuration if you want
the controller to obtain its IP address from Router Advertisements (RAs) or from a DHCPv6 server on the network. If you want
to manually assign the IPv6 network address, click Static, and then set the values for the following: IP address (IPv6): Enter an
IPv6 address (global only) with a prefix length (for example, 1234::5678:0:C12/123). Link-local addresses are
unsupported.Gateway: Enter an IPv6 address (global or link-local) without a prefix length. Here are examples:

Global address without a prefix length: 1234::5678:0:C12

Link-local address without a prefix length: fe80::5678:0:C12

a) Click the Cluster tab when done.

FIGURE 151 The Cluster tab

3. On the Cluster tab, click Static under the IPv4 section, and then enter the network settings that you want to assign to the cluster
interface, through which cluster data will be sent and received.
Although it is possible to use DHCP to assign IP address settings to the Cluster interface automatically, Ruckus Wireless strongly
recommends assigning a static IP address to this interface. The following network settings are required (others are optional):
• IP address
• Netmask
• Default gateway

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 149
Using the Setup Wizard to Install vSZ
Step 3: Configure the Management IP Address Settings

4. Click the Management (Web) tab when done.

FIGURE 152 The Management (Web) tab

5. On the Management (Web) tab, configure the IP address settings of the management interface.
a) Under the IPv4 section, click Static, and then enter the network settings that you want to assign to the AP/DataPlane
interface, through which client traffic and configuration data are sent and received.
Although it is possible to use DHCP to assign IP address settings to the Control interface automatically, Ruckus Wireless
strongly recommends assigning a static IP address to this interface. The following network settings are required (others are
optional):
• IP address
• Netmask
• Default gateway
b) If you clicked IPv4 and IPv6 at the beginning of this procedure, under the IPv6 section, click Auto Configuration if you want
the management (web) interface to obtain its IP address from Router Advertisements (RAs) or from a DHCPv6 server on the
network. If you want to manually assign the IPv6 network address, click Static, and then set the values for the following: IP
address (IPv6): Enter an IPv6 address (global only) with a prefix length (for example, 1234::5678:0:C12/123). Link-local
addresses are unsupported.Gateway: Enter an IPv6 address (global or link-local) without a prefix length. Here are examples:

Global address without a prefix length: 1234::5678:0:C12

Link-local address without a prefix length: fe80::5678:0:C12

6. At the bottom of the screen, select the interface that you want to set as the default system gateways for IPv4 and IPv6 (if enabled),
and then type the primary and secondary DNS server addresses.
The appropriate interface to use as the default system gateway depends on the topology of your network. See Important Notes
About Selecting the System Default Gateway on page 144 for more information.
7. Check the network settings that you have configured on the Control, Cluster, and Management tabs and the default gateway that
you have selected. Verify that they are all correct.
8. Click the Apply to continue. The controller validates and applies the network settings that you have configured.

Ruckus Virtual SmartZone Getting Started Guide

150 Part Number: 800-71549-001 Rev A
 Using the Setup Wizard to Install vSZ
Step 4: Configure Dual Mode IP Address Settings Using CLI

9. Update the IP address settings of the administrative computer with the same subnet settings that you assigned to the
Management (Web) interface (see Step 4). Continue to Step 5: Configure the Cluster Settings on page 161

Important Notes About Selecting the System Default Gateway

Depending on your network topology, you may select either the Management or Control interface as the system default gateway.

• If all of the managed APs are located in different locations on the Internet, the vSZ may not know all of the IP subnets of these
APs. In this case, the control interface should be set as the default gateway for the vSZ and you will need to add a static route to
reach the management network.
• If all of the managed APs belong to a single subnet or to multiple subnets on which you can set the route statically, then you can
set the management interface as the default gateway users can set default gateway for the vSZ and set static routes for the vSZ to
reach all of its managed APs.

Step 4: Configure Dual Mode IP Address Settings

Using CLI
The following are the steps to configure the dual setup using CLI. This is an alternative method of configuring IPv4 and IPv6 manually if the
DHCP server is not available on the network.

1. Using CLI execute the setup command: vSZ# setup

2. In vSZ Profile, choose either 1. Essentials or 2. High Scale.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 151
Using the Setup Wizard to Install vSZ
Step 4: Configure Dual Mode IP Address Settings Using CLI

3. In IP Version Support, choose 2. IPv4 and IPv6.

FIGURE 153 Choose 2. IPv4 and IPv6 to use dual mode IP addresses

Ruckus Virtual SmartZone Getting Started Guide

152 Part Number: 800-71549-001 Rev A
 Using the Setup Wizard to Install vSZ
Step 4: Configure Dual Mode IP Address Settings Using CLI

4. Configure the IPv4 address settings that you want to assign to the AP/DataPlane interface, through which client traffic and
configuration data are sent and received.
a) Enter the setup for Control as either:
1. Manual
2. DHCP
b) Enter the IP configuration as 2 (DHCP).
c) Enter following network settings as required:

• IP address
• Netmask
• Default gateway
d) Save the networking configuration of Control settings.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 153
Using the Setup Wizard to Install vSZ
Step 4: Configure Dual Mode IP Address Settings Using CLI

FIGURE 154 IPv4 Control Settings

e) Enter the setup for Cluster as either: 1. Manual 2. DHCP

f) Enter the IP configuration as 1 (Manual)
g) Enter following network settings as required: IP address, Netmask, and Default gateway
h) Save the networking configuration of Cluster settings.

FIGURE 155 IPv4 Cluster Settings

Ruckus Virtual SmartZone Getting Started Guide

154 Part Number: 800-71549-001 Rev A
 Using the Setup Wizard to Install vSZ
Step 4: Configure Dual Mode IP Address Settings Using CLI

i) Enter the setup for Management as either: 1. Manual 2. DHCP

j) Enter the IP configuration as 2 (DHCP)
k) Enter following network settings as required:

• IP Address
• Netmask
• Gateway

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 155
Using the Setup Wizard to Install vSZ
Step 4: Configure Dual Mode IP Address Settings Using CLI

l) Save the networking configuration of Management settings

FIGURE 156 IPv4 Management Settings

The available gateway for Control, Cluster and Management will be displayed. You can select the system default gateway.

FIGURE 157 Default Gateway Settings

Ruckus Virtual SmartZone Getting Started Guide

156 Part Number: 800-71549-001 Rev A
 Using the Setup Wizard to Install vSZ
Step 4: Configure Dual Mode IP Address Settings Using CLI

5. If the controller is behind a NAT server, add the control NAT server IP address, and then hit Enter.

FIGURE 158 NAT server IP address

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 157
Using the Setup Wizard to Install vSZ
Step 4: Configure Dual Mode IP Address Settings Using CLI

6. Configure the IPv6 address settings that you want to assign to the AP/Data Plane interface, through which client traffic and
configuration data are sent and received.

NOTE
The cluster interface setting does not support IPv6 addresses.

a) Enter the setup for Control as either: 1. Manual 2. Auto Configuration

b) Enter the IP configuration as 1 (Manual).
c) Enter following network settings as required:

• IPv6 Address
• Gateway
d) Save the networking configuration of Control settings.

FIGURE 159 IPv6 Control Settings

Ruckus Virtual SmartZone Getting Started Guide

158 Part Number: 800-71549-001 Rev A
 Using the Setup Wizard to Install vSZ
Step 4: Configure Dual Mode IP Address Settings Using CLI

e) Enter the setup for Management as either: 1. Manual2. Auto Configuration

f) Enter the IP configuration as 1 (Manual)
g) Enter following network settings as required: IP addressDefault gateway
h) Save the networking configuration of Management settings.

FIGURE 160 IPv6 Management Settings

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 159
Using the Setup Wizard to Install vSZ
Step 4: Configure Dual Mode IP Address Settings Using CLI

The available gateway for Control and Management will be displayed. You can select the system default gateway.

FIGURE 161 Default Gateway Settings

7. Enter "restart network".

Ruckus Virtual SmartZone Getting Started Guide

160 Part Number: 800-71549-001 Rev A
 Using the Setup Wizard to Install vSZ
Step 5: Configure the Cluster Settings

8. Go back to the controller's web interface, and then go to System > Cluster > Control Planes. Then, expand the node, select the
Cluster plane, and click Configure.

The Edit Control Plane Network Settings page appears.

FIGURE 162 Control Plane Network Settings

9. Verify that the Control Plane network settings display the IPv4 and IPv6 addresses that you configured.
10. Continue to Step 5: Configure the Cluster Settings on page 161

Step 5: Configure the Cluster Settings

The next step is to configure the vSZ cluster settings. The actions that you need to perform in this step depend on whether you are creating
a new cluster (with this vSZ as the first node) or you are setting up this vSZ to join an existing cluster.

• If This vSZ Is Forming a New Cluster on page 162

• If This vSZ Is Joining an Existing Cluster on page 162

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 161
Using the Setup Wizard to Install vSZ
Step 5: Configure the Cluster Settings

FIGURE 163 The Cluster Information page, showing the New Cluster option

If This vSZ Is Forming a New Cluster

Follow these steps if you want to use this vSZ to create a new cluster.

On the Cluster Information page, configure the following settings:

1. In vSZ Cluster Setting, select New Cluster.

2. In Cluster Name, type a name for the new cluster that you are creating.

NOTE
The Cluster Name and Controller Name boxes only accept alphanumeric characters, hyphens (-), and underscores (_).
They do not accept the space character or other special characters (for example, $, *, #, !).

3. In Controller Name, type a name for the vSZ controller in this new cluster.
4. In Controller Description, type a brief description for the vSZ controller.
5. In NTP Server, type the address of the NTP server from which members of the cluster will obtain and synchronize time. The default
NTP server isntp.ruckuswireless.com
6. If you want ZoneDirector APs that are in factory default settings to be converted to SmartZone APs automatically, select the AP
Conversion check box.
7. Click Next to continue to the Administrator page.

If This vSZ Is Joining an Existing Cluster

If this is not the first vSZ cluster on the network, you can set up this vSZ virtual appliance to join an existing cluster.

A vSZ cluster supports a maximum of four nodes. If you are building a vSZ-E cluster with more than two nodes, two (2) additional cores
must be added to each node to support the added search and replication capabilities.

Ruckus Virtual SmartZone Getting Started Guide

162 Part Number: 800-71549-001 Rev A
 Using the Setup Wizard to Install vSZ
Step 6: Set the Administrator Password

NOTE
To add this vSZ to an existing cluster, the entire target cluster must be in a healthy state (no node must be in “out of service”
state). If any member node is out of service, the join request will fail. You will need to remove any out-of-service node from the
cluster before you can add a new node successfully.

Follow these steps to configure this to join an existing cluster.

1. In vSZ Cluster Setting, select Join Existing Cluster.

2. In Cluster Name, type the name of the cluster that this vSZ is joining.
The Cluster Name and Controller Name boxes only accept alphanumeric characters, hyphens (-), and underscores (_). They do
not accept the space character or other special characters (for example, $, *, #, !).
3. In Controller Name (optional), type a name that you want to assign to this new controller.
4. In Controller Description, type a description for this new controller.
5. In Join Exist vSZ Cluster IP, type the IP address of the leader in the existing cluster.
6. In Admin Password, type the administrator password to the web interface of the leader node.
7. Click Next to continue to the Administrator page. See Step 6: Set the Administrator Password on page 163.

FIGURE 164 The Cluster Information page, showing the Join Existing Cluster option

If the firmware version on this vSZ (shown in the bottom-left area of the Cluster Information page) does not match the firmware version of
the cluster, a message appears and prompts you to upgrade the vSZ firmware. Click Upgrade, and then follow the prompts to perform the
upgrade.

Step 6: Set the Administrator Password

Set the administrator passwords for the web interface and command line interface (CLI).

Follow these steps to set the web interface and CLI passwords.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 163
Using the Setup Wizard to Install vSZ
Step 7: Verify the Settings

NOTE
The web interface and CLI passwords must be at least eight (8) characters in length and must include one number, one letter, and
one special character (for example, $, *, #, !).

1. In Admin Pasword, type a password that you want to use to access the web interface.
2. In Confirm Password, retype the password above to confirm.
3. In Enable Password, type a password that you want to use to enable CLI access to the vSZ.
4. In Confirm Password, retype the password above to confirm.
5. Click Next to continue. The Confirmation page appears and displays all the controller settings that you have configured using the
Setup Wizard.

FIGURE 165 Set the web interface and CLI passwords

Step 7: Verify the Settings

After you complete setting the web interface and CLI passwords, check the Confirmation page and review all of the controller settings that
you have configured using the Setup Wizard.

Follow these steps to verify the controller settings that you have configured.

1. Verify that all the settings displayed on the Confirmation page are correct.

Ruckus Virtual SmartZone Getting Started Guide

164 Part Number: 800-71549-001 Rev A
 Using the Setup Wizard to Install vSZ
Step 7: Verify the Settings

2. If they are all correct, click Finish to apply the settings and activate the controller on the network.

FIGURE 166 The Confirmation page

NOTE
If you find an incorrect setting, click the Back button until you reach the related page, and then edit the settings. When
you finish editing the settings, click the Next button until you reach the Confirmation page again.

A progress bar appears and displays the progress of applying the settings, starting the vSZ services, and activating the vSZ on the
network.

When the process is complete, the progress bar shows the message 100% Done. The page also shows the IP address through
which you can access the vSZ web interface to manage the controller.

FIGURE 167 Setup is complete when the progress bar shows “100% Done”

Congratulations! You have completed the Setup Wizard. You are now ready to log on to the web interface. Go to https://{management-IP-
adddress}:8443, and then log on with the user name and password that you assigned to the web interface.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 165
Using the Setup Wizard to Install vSZ
Logging On to the Web Interface

Logging On to the Web Interface

You can access the web interface from any computer that is on the same subnet as the management (web) interface. Follow these steps to
log on to the vSZ web interface.

1. On a computer that is on the same subnet as the Management (Web) interface, start a web browser.
2. In the address bar, enter the IP address that you assigned to the Management (Web) interface and append a colon and 8443 (vSZ
management port number) at the end of the address. The vSZ web interface logon page appears.

If the IP address that you assigned to the Management (Web) interface is 10.10.101.1, then you should enter:

https://10.10.101.1:8443

The vSZ logon page appears.

FIGURE 168 The vSZ logon page

3. In User Name, type admin.

4. In Password, type the administrator password that you assigned to the web interface earlier.
5. Click Log On. The web interface refreshes, and then displays the vSZ dashboard page, which indicates that you have logged on
successfully.

You are now ready to configure the controller. For information on how to configure the controller, refer to the Administrator Guide for the
controller platform that you have installed.

Ruckus Virtual SmartZone Getting Started Guide

166 Part Number: 800-71549-001 Rev A
Upgrading the Controller for Microsoft
Azure, AWS, and GCE Platforms
• Upgrading the Controller for Microsoft Azure, AWS, and GCE Platforms................................................................167
• Upgrading the Controller Software.........................................................................................................................167
• Verifying the Upgrade............................................................................................................................................ 169
• Rolling Back to a Previous Software Version.......................................................................................................... 170

Upgrading the Controller for Microsoft Azure, AWS,

and GCE Platforms
Ruckus Wireless may periodically release controller software updates that contain new features, enhancements, and fixes for known issues.

These software updates may be made available on the Ruckus Wireless support website or released through authorized channels.

CAUTION
Although the software upgrade process has been designed to preserve all controller settings, Ruckus Wireless strongly
recommends that you back up the controller cluster before performing an upgrade. Having a cluster backup will ensure that you
can easily restore the controller system if the upgrade process fails for any reason.

CAUTION
Ruckus Wireless strongly recommends that you ensure that all interface cables are intact during the upgrade procedure.

CAUTION
Ruckus Wireless strongly recommends that you ensure that the power supply is not disrupted during the upgrade procedure.

NOTE
If you are managing a vSZ, you can also perform system configuration backup, restore, and upgrade from the controller
command line interface.

Upgrading the Controller Software

This section outlines the procedure to upgrade the controller software for Microsoft Azure, Amazon Web Services, Google Computing
Engine platforms.

Follow these steps to upgrade the controller software.

CAUTION
®
Ruckus Wireless strongly recommends backing up the controller cluster before performing the upgrade. If the upgrade process
fails for any reason, you can use the latest backup file to restore the controller cluster.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 167
Upgrading the Controller for Microsoft Azure, AWS, and GCE Platforms
Upgrading the Controller Software

NOTE
®
Before starting this procedure, you should have already obtained a valid controller software upgrade file from Ruckus Wireless
Support or an authorized reseller.
®
1. Copy the software upgrade file that you received from Ruckus Wireless to the computer where you are accessing the controller
web interface or to any location on the network that is accessible from the web interface.
2. Go to Administration > Upgrade.
3. In the Upload section, click the Browse button, and then browse to the location of the software upgrade file.

Typically, the file name of the software upgrade file is scg-installer_{version}.ximg.

Select the Run Pre-Upgrade Validations check box to verify if the data migration was successful. This option allows you to verify
data migration errors before performing the upgrade. If data migration was unsuccessful, the following error is displayed:
Exception occurred during the validation of data migration. Please apply the system
configuration backup and contact system administrator.

FIGURE 169 Click Browse in the Upload section to upload the software upgrade file

4. Select the software upgrade file, and then click Open.

5. Click Upload to upload the software upgrade file. The controller uploads the file to its database, and then performs file verification.
After the file is verified, the Upgrade Pending Patch Information section is populated with information about the upgrade file.
6. Start the upgrade process by clicking one of the following buttons:
• Upgrade: Click this button to start the upgrade process without backing up the current controller cluster or its system
configuration.
• Backup & Upgrade: Click this button to back up the controller cluster and system configuration before performing the
upgrade.

CAUTION
®
Ruckus Wireless strongly recommends using Backup & Upgrade when performing the upgrade. If the upgrade
process fails for any reason, you can use the latest backup file to restore the controller cluster.

A confirmation message appears.

Ruckus Virtual SmartZone Getting Started Guide

168 Part Number: 800-71549-001 Rev A
 Upgrading the Controller for Microsoft Azure, AWS, and GCE Platforms
Verifying the Upgrade

7. Click Yes.

The controller starts the process that you selected. The screens that appear next will depend on the process that you selected to
upgrade immediately or to back up and then upgrade the controller.

FIGURE 170 The System Upgrade page displays the status of the upgrade process

When the upgrade (or backup-and-upgrade) process is complete, the controller logs you off the web interface automatically. Wait for a few
minutes until the web interface log on page appears.

FIGURE 171 The controller web interface may display the following message as it completes the upgrade process

When the controller logon page appears again, you have completed upgrading the controller.

Continue to the Verifying the Upgrade task to check if the upgrade was completed successfully.

Verifying the Upgrade

Follow these steps to verify that the controller upgrade was completed successfully.

1. Log on to the controller web interface.

2. Go to Administration > Upgrade.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 169
Upgrading the Controller for Microsoft Azure, AWS, and GCE Platforms
Rolling Back to a Previous Software Version

3. In the Current System Information section, check the value for Controller Version.

If the firmware version is newer than the firmware version that controller was using before you started the upgrade process, then
the upgrade process was completed successfully.

NOTE
APs periodically send scheduled configuration requests to the controller, including the firmware version. Therefore, when
an AP joins a zone for the first time, the firmware version is verified by the controller. If the firmware version is different
from that which is configured for the zone, the controller responds with a request to upgrade it, after which the AP
initiates a request to upgrade the firmware using HTTP.

FIGURE 172 Check the value for Controller Version

Rolling Back to a Previous Software Version

There are two scenarios in which you may want to roll back the controller software to a previous version:

1. You encounter issues during the software upgrade process and the controller cannot be upgraded successfully. In this scenario,
you can only perform the software rollback from the CLI using the restore local command. If you have a two-node controller
cluster, run the restore local command on each of the nodes to restore them to the previous software before attempting to
upgrade them again.

2. You prefer a previous software version to the newer version to which you have upgraded successfully. For example, you feel that
the controller does not operate normally after you upgraded to the newer version and you want to restore the previous software
version, which was more stable. In this scenario, you can perform the software rollback either from the web interface or the CLI. If
you have a two-node controller cluster, you must have cluster backup on both of the nodes.
®
To ensure that you will be able to roll back to a previous version, Ruckus Wireless strongly recommends the following before attempting to
upgrade the controller software:
• Always back up the controller before attempting a software upgrade. If you are managing a multi-node cluster, back up the entire
cluster, and then verify that the backup process completes successfully. See Creating a Cluster Backup on page 171 for more
information.
• If you have an FTP server, back up the entire cluster and upload the backup files from all the nodes in a cluster to a remote FTP
server.

Ruckus Virtual SmartZone Getting Started Guide

170 Part Number: 800-71549-001 Rev A
 Upgrading the Controller for Microsoft Azure, AWS, and GCE Platforms
Rolling Back to a Previous Software Version

Backing Up and Restoring Clusters

Back up the controller cluster periodically to ensure that you can restore the control plane, data plane, and AP firmware versions as well as
the system configuration in the cluster if is a system failure occurs.

This section covers the following topics:

NOTE
You can also perform these procedures from the vSZ command line interface. Note, however, that you will need to execute the
commands on each node.

Creating a Cluster Backup

Follow these steps to back up an entire controller cluster.

1. Take note of the current system time.

To view the current system time, go to System > General Settings > Time.
2. Go to Administration > Backup & Restore.
3. Click Backup Entire Cluster.

The following confirmation message appears: Are you sure you want to back up the cluster?
4. Click Yes.

The following message appears: The cluster is in maintenance mode. Please wait a few minutes.

When the cluster backup process is complete, a new entry appears in the Cluster Backups section with a Created On value that is
approximate to the time when you started the cluster backup process.

NOTE
If you have an FTP server, back up the entire cluster and upload the backup files from all the nodes in a cluster to a remote FTP
server.

You have completed backing up the controller cluster.

FIGURE 173 A new entry appears in the Cluster Backups section

Restoring a Cluster Backup

When restoring a cluster backup, remember that you must perform the restore procedure on the exact same node which you generated the
cluster backup.

Follow these steps to restore a cluster backup

1. Go to Administration > Backup & Restore.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 171
Upgrading the Controller for Microsoft Azure, AWS, and GCE Platforms
Rolling Back to a Previous Software Version

2. In the Cluster Backups History section, locate the cluster backup that you want to restore.
3. Select the backup file that you want to restore, and then click Restore.

FIGURE 174 Select the backup file, and then click Restore

4. The following confirmation message appears: Are you sure you want to restore the cluster?. Click Yes.

FIGURE 175 Confirm Restore

The page refreshes, and then the following message appears: System is restoring! Please wait...

NOTE
The cluster restore process may take several minutes to complete.
When the restore process is complete, the controller logs you off the web interface automatically.
Do not refresh the controller web interface while the restore process is in progress. Wait for the restore process to
complete successfully.

5. Log back on to the controller web interface.

NOTE
If the web interface displays the message Cluster is out of service. Please try again in a few
minutes. appears after you log on to the controller web interface, wait for about three minutes. The dashboard will
appear shortly. The message appears because the controller is still initializing its processes.

6. Go to Administration > Upgrade, and then check the Current System Information section and verify that all nodes in the cluster
have been restored to the previous version and are all in service.
7. Go to Diagnostics > Application Logs .
8. Check the Health Status column and verify that all of the controller processes are online.

Ruckus Virtual SmartZone Getting Started Guide

172 Part Number: 800-71549-001 Rev A
 Upgrading the Controller for Microsoft Azure, AWS, and GCE Platforms
Rolling Back to a Previous Software Version

You have completed restoring the cluster backup. After the upgrade is complete, go to the Application Logs page and verify that all of the
controller processes are online.

FIGURE 176 On the Application Logs page, verify that all controller processes are online

Restoring a Cluster Backup Using the CLI

Follow these steps to restore a cluster backup using the CLI.

1. Enter the vSZ CLI.

2. Enter the following command and enter the password to log into the CLI.

VSCG35> en
Password:

3. Enter the following command to restore a cluster backup:

VSCG35> restore

All the cluster backups are listed in an order of the cluster backup created date.
4. Specify the number mentioned against the cluster backup that you wish to restore.

You have restored the cluster backup.

Ruckus Virtual SmartZone Getting Started Guide

Part Number: 800-71549-001 Rev A 173
Upgrading the Controller for Microsoft Azure, AWS, and GCE Platforms
Rolling Back to a Previous Software Version

FIGURE 177 Cluster Backup Restore Using CLI

Deleting a Cluster Backup

Follow these steps to delete a cluster backup.

1. Go to Administration > Backup & Restore.

2. In the Cluster Backups History section of the Cluster tab, locate the cluster backup that you want to delete, and then click it.

The cluster backup becomes highlighted, which indicates that you have selected it.
3.
Click .

A confirmation message appears.

FIGURE 178 After you click the Delete button, a confirmation message appears

4. Click Yes.

The page refreshes, and then the cluster backup that you deleted disappears from the Cluster Backups History section.

You have completed deleting a cluster backup.

Ruckus Virtual SmartZone Getting Started Guide

174 Part Number: 800-71549-001 Rev A
Copyright © 2006-2017. Ruckus Wireless, Inc.
350 West Java Dr. Sunnyvale, CA 94089. USA
www.ruckuswireless.com