HP VAN SDN Controller Installation Guide
HP VAN SDN Controller 2.4 Installation Guide
Abstract
HP VAN SDN Controller This guide describes the steps for installing the HP VAN SDN (Virtual Area Network Software-Defined
Networking) Controller software on a system running Ubuntu version 12.04 LTS 64-bit server. The intended audience is
administrators who are familiar with installing and using the Keystone server, experienced in using and configuring the
OpenStack Keystone authentication software, and familiar with configuring an OpenFlow network to operate with a controller.
HP Part Number: 5998-6794a
Published: November 2014
Edition: 2
© Copyright 2013, 2014 Hewlett-Packard Development Company, L.P.
Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial
Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under
vendor's standard commercial license.
The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express
warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall
not be liable for technical or editorial errors or omissions contained herein.
The HP VAN SDN Controller license text is in /opt/sdn/legal/EULA.txt. The HP VAN SDN Controller incorporates materials from several Open
Source software projects. Therefore, the use of these materials by the HP VAN SDN Controller is governed by different Open Source licenses. Refer
to /opt/sdn/legal/HP-SDN-CONTROLLER-OPENSOURCE-LIST.pdf for a complete list of the materials used.
Acknowledgments
UNIX is a registered trademark of the Open Group.
Java and Oracle are registered trademarks of Oracle and/or its affiliates.
OpenFlow is a trademark of the Open Networking Foundation. Open Source is a trademark of the Open Source Initiative. Linux is a trademark of
Linus Torvalds. Ubuntu is a trademark of Canonical Group Limited.
Warranty
For the software end user license agreement and the hardware limited warranty information for HP Networking products, visit http://www.hp.com/
networking/support.
Open Source Software
For information on licenses for the open source software used by the HP VAN SDN Controller, see the HP VAN SDN Controller Open Source and
Third-Party Software License Agreements.
For information on acquiring the open source code for the HP VAN SDN Controller, send an email to HPN-Open-Source-Query@lists.hp.com.
Contents
1 Getting Started..........................................................................................5
1.1 Controller authentication.......................................................................................................5
1.2 Controller Licensing.............................................................................................................5
1.3 Before installing the controller...............................................................................................5
1.4 Downloading the controller software......................................................................................7
1.5 Next steps..........................................................................................................................8
2 Installing a new controller with a local Keystone server....................................9
2.1 Installing the Keystone server.................................................................................................9
2.2 Unpacking the controller software.......................................................................................10
2.3 Installing and verifying the controller...................................................................................10
2.4 Configuring a user on a local Keystone server......................................................................11
3 Upgrading the controller from version 2.3 to version 2.4................................12
4 Using the controller with a remote Keystone server........................................13
4.1 Setting the provider type to UUID on the remote Keystone server..............................................13
4.2 Unpacking the controller software on your local machine.......................................................14
4.3 Installing and verifying the controller on your local machine...................................................14
4.4 Configuring the controller on a local machine to operate with a remote Keystone server.............15
5 Verifying the NTP configuration..................................................................16
6 Operating the HP VAN SDN Controller.......................................................17
6.1 Access a controller interface...............................................................................................17
6.1.1 Using the controller console UI.....................................................................................17
6.2 Changing a user password................................................................................................18
6.3 Obtaining a software license..............................................................................................19
6.4 Related documentation......................................................................................................19
7 Uninstalling the controller and the Keystone server........................................20
7.1 Uninstalling the controller....................................................................................................20
7.2 Uninstalling the Keystone server..........................................................................................20
8 Troubleshooting........................................................................................21
8.1 The SDN Controller service (SDNC) failed to start.................................................................21
8.1.1 Problem description....................................................................................................21
8.1.2 Solution....................................................................................................................21
8.2 Port 35357 being used by non-Keystone processes................................................................21
8.2.1 Problem description...................................................................................................21
8.2.2 Solution...................................................................................................................21
8.3 Controller installation failed................................................................................................22
8.3.1 Problem description...................................................................................................22
8.3.2 Solution...................................................................................................................22
8.4 Install verification command shows incorrect output...............................................................22
8.4.1 Problem description...................................................................................................22
8.4.2 Solution...................................................................................................................22
8.5 Error message indicating the controller installation failed due to web proxy settings...................22
8.5.1 Problem description...................................................................................................22
8.5.2 Solution...................................................................................................................22
8.6 Local Keystone server installation failure...............................................................................23
8.6.1 Problem description...................................................................................................23
8.6.2 Solution...................................................................................................................23
8.7 NTP not operating............................................................................................................23
8.7.1 Problem description....................................................................................................23
Contents 3
8.7.2 Solution...................................................................................................................23
8.8 Wrong provider type (PKI) on the Keystone server.................................................................23
8.8.1 Problem description...................................................................................................23
8.8.2 Solution...................................................................................................................23
8.9 The controller ceases to operate when running Network Protector...........................................24
8.9.1 Problem description....................................................................................................24
8.9.2 Solution...................................................................................................................24
9 Support and other resources......................................................................26
9.1 Gather information before contacting an authorized support representative...............................26
9.2 How to contact HP............................................................................................................26
9.3 Get connected to the HP SDN online user forum...................................................................26
9.4 Software technical support and software updates..................................................................26
9.4.1 Care Packs................................................................................................................27
9.4.2 Obtaining software updates.......................................................................................27
9.4.3 Warranty.................................................................................................................27
9.5 Related information...........................................................................................................27
10 Documentation feedback.........................................................................28
4 Contents
1 Getting Started
The HP VAN SDN Controller provides an extensive platform for developing and running SDN
applications. It features:
• A base controller platform for Linux/Java/OSGi, OpenFlow 1.0/1.3, built-in services, and a
device driver framework
• Operation with either a local or a remote Keystone server
• Embedded Java applications, an extensible REST API and UI, and an Intelligent Management
Center (IMC) management interface
As an HP VAN SDN Controller administrator, you should be familiar with OpenFlow, and have
OpenFlow configured and enabled on the network switches to be managed by the controller.
1.1 Controller authentication
Beginning with controller software release 2.3, the HP VAN SDN Controller supports both local
and remote Keystone authentication servers. When upgrading from a previous controller version,
the established local Keystone server is used. For a new controller installation, install and configure
a Keystone server on either a local or remote machine, then install the controller.
1.2 Controller Licensing
For controller software licensing and registration information, see the chapter covering licensing
in the HP VAN SDN Controller Administrator Guide.
1.3 Before installing the controller
1. Ensure that a minimum of 8 GB of RAM is available on your system for controller operation.
For more information on minimum and recommended hardware, supported OpenFlow versions
and network switches, and other controller support information, see the HP VAN SDN Controller
and Applications Support Matrix. To download the Support Matrix and other HP VAN SDN
Controller documentation, go to the SDN Information Library. Click on the Resources tab, then
scroll down to Technical Guides.
2. Install the Ubuntu 12.04 LTS 64–bit Server (Linux 3.2 kernel). The controller installation process
installs the remaining software requirements listed for the controller in the HP VAN SDN
Controller and Applications Support Matrix.
3. See Figure 1 (page 6) for an overview of the controller installation process.
NOTE: The controller supports v2.0 of the Keystone REST API.
1.1 Controller authentication 5
Figure 1 HP VAN SDN Controller installation overview
No
No
No
Yes
Yes
Yes
Check Support
Matrix for notes on
device support
Download the controller
software and read
Release Notes
Set UUID provider type
on remote Keystone
server
Unpack the controller
software on the local
machine
Install the controller
software with apt-get
Configure controller
sdnctl.conf file for
Keystone server
variables
Unpack the software
Install the software
with apt-get
Verify sdnc service
started
Verify NTP
Upgrading
from version 2.3
controller
?
Use provided script to
configure user on local
Keystone server
Install Keystone server
on local machine with
apt-get
Verfy sdnc service started
on the local machine
Using
a local Keystone
server
?
Using
a local Keystone
server
?
6 Getting Started
1.4 Downloading the controller software
In the HP VAN SDN Controller release 2.4, the software download includes:
• Controller product software
• A “Read Me First” file
• Controller software version 2.4 release notes
To download the HP VAN SDN Controller software:
1. Go to the HP Networking support site at www.hp.com/networking/support.
2. Enter the HP VAN SDN base product number J9863AAE in the Auto Search field, as shown
in Figure 2.
Figure 2 HPN Networking support site
3. Select the check box next to the HP VAN SDN Controller product, and then click Display
selected.
4. In the lower right quadrant of the product display screen, click Software downloads, as shown
in Figure 3.
Figure 3 Software downloads pane
1.4 Downloading the controller software 7
5. On the My Networking Download software screen, select and download the
VAN_SDN_Controller_v2.4.3 software package (.zip file) to your local machine running
Ubuntu.
6. Unzip the software package.
7. Read the latest HP VAN SDN Controller Release Notes included with the software package.
8. If you are upgrading from an earlier version of the controller, see also the ReadMe file included
in the software package.
1.5 Next steps
Select one of the following procedures to continue the controller installation:
• To install a controller that will use a local Keystone server, go to the chapter titled “Installing
a new controller with a local Keystone server” (page 9)
• To upgrade from an installed controller version 2.3 to version 2.4, go to the chapter titled
“Upgrading the controller from version 2.3 to version 2.4” (page 12).
• To install a controller that will use a remote Keystone server, go to the chapter titled “Using
the controller with a remote Keystone server” (page 13)
8 Getting Started
2 Installing a new controller with a local Keystone server
This chapter describes installing a Keystone server and the controller on the same (local) machine
and running the configuration script included in the controller download package. Using this option
automatically configures the Keystone server. (If you want your controller to operate with a previously
configured, remote Keystone server, then skip this chapter and go to “Using the controller with a
remote Keystone server” (page 13).)
NOTE: For most controller installations, Hewlett-Packard recommends using a local Keystone
server as described in this chapter. Doing so avoids the need to address certain security implications
associated with using a remote Keystone server. For more information, see “Using the controller
with a remote Keystone server” (page 13).
NOTE: Downloading the controller software package as described under “Downloading the
controller software” (page 7) is required before using this chapter.
The configured keystone server must be accessible and responsive to basic Keystone REST API
queries.
The controller supports v2.0 of the Keystone REST API.
Although the HP VAN SDN Controller operates with the Folsom, Grizzly, Havana, or Icehouse
releases of OpenStack Keystone, HP recommends that you use the Icehouse version with release
2.4 of the controller.
Where a command in this procedure is shown with multiple lines, the line breaks are inserted at
the points where a space occurs in the actual command.
2.1 Installing the Keystone server
1. Point the Ubuntu system to the most recent package meta-data:
~$ sudo apt-get update
2. Use the following commands to install the Keystone server on the local machine.
~$ sudo apt-get install python-software-properties
ubuntu-cloud-keyring
~$ sudo add-apt-repository cloud-archive:icehouse
NOTE: Hewlett-Packard recommends using the “icehouse” version of the
OpenStack Keystone server, as shown in the above command. However, you can
use any of the following Keystone server options:
• icehouse (recommended)
• havana
• grizzly
• folsom
~$ sudo apt-get update
~$ sudo apt-get install keystone
For information on a specific Keystone version, visit http://docs.openstack.org/developer/
keystone/ and see the documentation for the OpenStack Keystone version you are using.
2.1 Installing the Keystone server 9
Loading...