HP VAN SDN Controller 2.4 Administrator Guide


This guide is intended for network administrators and support personnel involved in:

  • Configuring and managing HP VAN SDN (Virtual Area Network Software-Defined Networking) Controller installations

  • Registering and activating HP VAN SDN Controller licenses

The information in this guide is subject to change without notice.

HP Part Number: 5998-6793
Published: October 2014
Edition: 1

Legal Notice
Open Source Software

1 Introduction
Supported switches and OpenFlow compatibility
OpenFlow requirements
IPv6 traffic
2 Understanding the controller embedded applications
List of controller embedded applications
Link Manager
Link Manager
Link Manager configurable components
Node Manager
Node Manager
Node Manager configurable components
OpenFlow Link Discovery
OpenFlow Link Discovery
OpenFlow Link Discovery configurable components
OpenFlow Node Discovery
OpenFlow Node Discovery
OpenFlow Node Discovery configurable components
Path Diagnostics
Path Diagnostics
Path Diagnostics configurable components
Path Daemon
Path Daemon
Path Daemon configurable components
Topology Manager
Topology Manager
Topology Manager configurable components
Topology Viewer
Topology Viewer
Topology Viewer configurable components
3 Navigating the controller user interface
Starting the SDN controller console UI
About the user interface
Changing column widths
Changing the background and text colors
Navigation menu
About the navigation menu
Navigation menu screen details
Expanding or collapsing the navigation menu
SDN User window
User window screen details
Expanding the SDN user window
Collapsing the SDN user window
Logging out of the controller
Alerts screen
About alerts
About alert policies
Alert notification counter
Alerts screen details
Viewing the ten most severe recent active alerts
Acknowledging an alert
Deleting an alert
Configuring the alert policies
Applications screen
About the application manager
Application manager and controller teams
Embedded applications
Prerequisites for installing an application
Applications screen details
Obtaining applications from the HP SDN AppStore
Adding or upgrading an application
Disabling (stopping) or enabling (starting) an application
Uninstalling an application
Application state and OSGi artifacts
Configurations screen
About the configurable components
About component keys
Summary of configurable controller components
AdminREST Component
Alert manager
Alert post manager
Audit log manager
Authentication manager
Controller manager
OpenFlow link discovery
Log manager
Metric manager component
Node manager
Path diagnostic manager
Path daemon
RestPerf provider
Role assert manager
Service REST component
Trace manager
Team configuration manager
End-Host discovery via ARP protocol
End-Host discovery via DHCP protocol
End-Host discovery via IP Protocol
Configuring a signed application zip file verification
Configurations screen details
Modifying a component configuration
Audit log screen
About the audit log
About audit log policies
Audit log screen details
Deleting a log entry
Configuring audit log policies
Exporting and archiving audit log data
Licenses screen
About licenses
Licenses screen details
Installing, activating, uninstalling, or transferring licenses
Support logs screen
About support logs
Support logs screen details
Configuring the support log queue size
Exporting the support logs
Packet listeners display
Packet listeners display details
4 OpenFlow
OpenFlow monitor screen
OpenFlow monitor screen details
Main display
Summary for data path view
Ports for data path display
Flows for data path display
Discovering changes in the Topology
Viewing information about a specific device
OpenFlow topology screen
Displaying the network Topology
Configuring how the OpenFlow network Topology is displayed
Viewing the shortest path between two nodes
Identifying flow details and flow options
OpenFlow trace display
About the trace log
OpenFlow trace display details
Starting, stopping, or clearing OpenFlow trace
Displaying trace event details
Exporting the OpenFlow trace log
Filtering the OpenFlow trace log in a CSV file
Changing the OpenFlow trace interval
OpenFlow classes display
About OpenFlow classes
Controller enforcement levels for OpenFlow classes
OpenFlow classes display details
Changing the enforcement levels for OpenFlow classes
5 License Registration and Activation
License registration and activation process
License types, usage, and expiration
Preparing for license registration
Verifying registration prerequisites
Identifying the install ID
Registering and activating a license
Registering your license and obtaining a license key
Activating a license on the controller
Managing licenses
Transferring licenses
Uninstalling licenses to prepare for transfer
Transferring licenses
6 SDN Controller security features
SDN Controller security guidelines
SDN Controller authentication
Creating the SDN Controller keystore and truststore
SDN Controller keystore and truststore locations and passwords
OpenFlow Controller
Creating a truststore and keystore for OpenFlow switch communication
OpenFlow Controller keystore and truststore locations and passwords
REST authentication
OpenStack Keystone used for user and token management
Role-Based Access Control (RBAC)
API access requires authentication
Service and admin tokens
Controller code verification
Adding certificates to the jar-signing truststore
Running the SDN Controller Without Jar-Signing Validation
Revoking Trust
Revoking trust via truststore
Revoking trust via CRL
SDN administrative REST API
Virgo admin UI access via localhost only
Virgo console access disabled by default
JMX console enabled for local access only
7 Security practices
Security procedure
Security best practices
8 Hybrid mode for controlling packet-forwarding
Viewing and changing the hybrid mode configuration
Coordinating controller hybrid mode and OpenFlow switch settings
Supporting hybrid mode on OpenFlow switches
Configuring controller settings to support hybrid mode
Controller packet-forwarding when hybrid mode is disabled
Controller packet forwarding when hybrid mode is enabled
Learning more about hybrid mode
9 Team configuration (experimental)
High availability (experimental)
Team management
Requirements for controller teams
Configuring a controller team
Team configuration prerequisites
Configuration procedure
Displaying team configuration
Disbanding a team
Controller fault tolerance
Error log for team configuration
Team alias node
Configuring the alias
Disabling the alias
10 Regional configuration (experimental)
Creating a region
Aquiring a region UID
Updating a region
Refreshing a region
Deleting a region
11 Backing up and restoring
Backing up a controller
Backup operation
Backing up a controller
Downloading a backup from the controller to another location
Recommended backup practices
Restoring a controller from a backup
Restore operation
System restore requirements
Restoring a controller from a backup
Distributed (team) backing up and restoring
Backing up and restoring the keystone configuration and database
12 Troubleshooting
License troubleshooting
Host location not learned by controller
Unexpected network or service problems
Application management exceptions
Performance testing
Application management errors
Path diagnostic application via REST command line API
Communication problems
Packet generator troubleshooting
Packet generator troubleshooting procedure
Run the packet generator process
Viewing metric data
About metrics
About metric values
Metric identifiers
Listing the application IDs for applications that have persisted metrics to disk
Listing the metrics persisted by a specific application
Listing the primary tags for metrics persisted by an application
Listing the secondary tags for metrics persisted by an application
Listing the names of metrics persisted by an application
Listing information about a persisted metric identified by its UID
Listing the time-series values for a persisted metric identified by its UID
Viewing all controller JVM metrics
Viewing current metric data using a JMX client
Connecting to the JMX server using the JConsole JMX client
Selecting and viewing metrics using JConsole JMX
Generating a controller support report
13 Support and other resources
Gather information before contacting an authorized support representative
How to contact HP
Get connected to the HP SDN online user forum
Software technical support and software updates
Care Packs
Obtaining software updates
Related information
14 Documentation feedback
1 cURL commands
Export audit log data as a CSV file
Licensing actions
Obtaining an install ID
Activating a license on the controller
Uninstalling licenses to prepare for transfer
Application manager actions
Listing applications
Listing information about an application
Getting application health status
Uploading an application (new or upgrade)
Installing a new application
Upgrading an application
Disabling an application
Enabling an application
Removing a staged application
Deleting an application
Viewing metric data
2 Scripts
Configuring a controller team
Backing up a controller team
Restoring a controller team
3 Examples of Metrics