HP ProCurve Guest Management Administrator's Guide

ProCurve 5400zl Switches
Installation and Getting Started Guide
HP ProCurve Guest Management Software Administrator Guide
HP ProCurve Guest Management Software
Administrator Guide
HP ProCurve Guest Management Software
Administrator Guide

Copyright and Disclaimer Notices

© Copyright 2010 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice.
This document contains proprietary information, which is protected by copyright. No part of this document may be photocopied, reproduced, or translated into another language without the prior written consent of Hewlett-Packard.
Publication Number
5998-0488 April 2010
Release 5.4
Applicable Products
Guest Management Software MSM710 Access controller J9328A MSM710 Mobility controller J9325A MSM730 Access controller J9329A MSM730 Mobility controller J9326A MSM750 Access controller J9330A MSM750 Mobility controller J9327A MSM760 Access controller J9421A MSM760 Mobility controller J9420A MSM765zl Mobility controller J9370A
Disclaimer
HEWLETT-PACKARD COMPANY MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
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.
Hewlett-Packard assumes no responsibility for the use or reliability of its software on equipment that is not furnished by Hewlett-Packard.
Warranty
A copy of the specific warranty terms applicable to your Hewlett-Packard products and replacement parts can be obtained from your HP Sales and Service Office or authorized dealer.
Trademark Credits
Windows NT®, Windows®, and MS Windows® are US registered trademarks of Microsoft Corporation.
Hewlett-Packard Company
8000 Foothills Boulevard Roseville, California 95747
www.hp.com/go/procurve/

Contents

Chapter 1 Introduction 1
Introducing the Guest Management Software ...................................2
About this guide................................................................................3
Important terms..........................................................................3
Conventions ................................................................................3
Related documentation ...............................................................4
HP ProCurve Networking support .....................................................4
Chapter 2 Installation 5
Typical deployments .........................................................................6
Multiple computer deployment ...................................................6
Installation requirements ..................................................................7
Computer requirements ........................................................7
Controller requirements ........................................................7
Installation ........................................................................................7
Installing on a single computer ...................................................8
Installing on multiple computers ................................................8
Starting for the first time...................................................................8
A. Single or multiple computer installation ...........................9
B. Database selection............................................................9
C. Certificate Authority (CA) certificate creation..................10
D. Addition of a controller to the database..........................12
E. Log in to the Guest Management Software .....................13
F. Define operator accounts.................................................14
G. Enable guest tracking .....................................................14
Chapter 3 Working with the Guest Management Software 15
Key concepts ..................................................................................16
Guest account management .....................................................16
Access levels ............................................................................16
Database options ......................................................................16
Security.....................................................................................16
CA certificate.......................................................................16
User certificates ..................................................................17
Accounts tab ..................................................................................17
Accounts list .............................................................................18
Filters..................................................................................18
Account list.........................................................................18
Account list operations .......................................................19
Buttons .....................................................................................19
Refresh ...............................................................................19
New Account(s) ..................................................................20
Edit .....................................................................................20
Reset Subscription Plan......................................................20
Suspend..............................................................................20
Activate/Resume .................................................................20
Delete..................................................................................20
Print....................................................................................20
Remaining Online Time.......................................................21
New account creation .....................................................................22
Service Controllers tab ...................................................................28
Service Controllers list ..............................................................28
Service Controller list operations........................................30
Service Controller elements menu ......................................32
Buttons .....................................................................................34
Refresh ...............................................................................34
Add Service Controller ........................................................35
Edit Service Controller ........................................................35
Restore Service Controller ..................................................36
Remove Service Controller .................................................36
Customize Login Pages.......................................................36
Events Log tab ...............................................................................37
Events Log list ..........................................................................37
Event Log list operations ....................................................38
Filter..........................................................................................38
Buttons .....................................................................................38
Refresh ...............................................................................38
Delete..................................................................................38
User Tracking tab............................................................................38
Tracking guests.........................................................................39
Setting tracking on controllers ............................................39
Setting tracking on a single station.....................................40
Setting tracking on multiple stations...................................41
User Tracking table ...................................................................42
Guest tracking connection list operations ...........................42
Filter..........................................................................................42
Buttons .....................................................................................43
File menu .......................................................................................43
Password..................................................................................43
Preferences...............................................................................44
Guest List Colors ................................................................44
Application options .............................................................45
Guest accounts ...................................................................46
Predefined durations...........................................................48
Voucher options..................................................................49
Database menu ..............................................................................49
Backup......................................................................................50
Retrieve.....................................................................................50
Administrator menu .......................................................................50
Recreate the CA ........................................................................50
Create User Certificate ..............................................................50
Revoke User Certificate.............................................................50
Guest Management Software Administrator Guide vi Contents

Chapter 1: Introduction

Contents
Introducing the Guest Management Software - - - - - - - - - - - - - - - 2
About this guide - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 3
1
Introduction
HP ProCurve Networking support - - - - - - - - - - - - - - - - - - - - - 4
Guest Management Software Administrator Guide 2 1 Introduction

Introducing the Guest Management Software

The Guest Management Software makes it easy for office staff to manage guest accounts for an HP ProCurve public access wireless network. Key features include:
Running the Guest Management Software on a single or across multiple computers.
Managing guest accounts connected to APs on either a single or across multiple controllers.
Single or batch guest account creation.
A variety of account options, including specific start and end dates and times, predefined
durations, and support for MSM7xx controller subscription plans.
Ability to quickly activate, edit, and suspend accounts.
Printing of account vouchers.
Copying of guest account information to the clipboard for use in other programs.
Using its own internal database or an external third-party database for guest account data
storage.
Easy customization of the logo on the guest wireless network HTML login page.
Security using X.509 certificates, which the Guest Management Software can automatically
generate.
Guest Management Software Administrator Guide 31 Introduction

About this guide

This guide explains how to install, configure, and operate the Guest Management Software.

Important terms

The following terms are used in this guide.
Term Description
Controller Refers to the MSM7xx controllers, both the Access controllers
and Mobility controllers.
VSC Virtual service community. VSCs are used to define the
characteristics of a wireless network on a controller.
SSID Service set identifier. Also known as the wireless network
name.
Operator account The account used to log in and operate the Guest
Management Software. The Guest Management Software supports two types of accounts: administrator and operator.
Guest account Accounts that are managed by the Guest Management
Guest Management Software station

Conventions

This guide uses specific syntax when directing you to interact with the Guest Management Software user interface and the controller management tool.
Example directions in this guide What to do in the user interface
Select File > Preferences. In the Guest Management Software
For Password, specify secret22. In the Guest Management Software
Select Controller >> Wireless > Radios In the controller management tool, in the
Software and what guests use to log into the wireless network.
A computer on which the Guest Management Software is installed.
interface, on the main menu, select File and then select Preferences on the sub-menu.
interface, in the Password field, enter the text secret22 exactly as shown.
Network Tree, select Controller, select Wireless from the main menu, and then select Radios from the submenu. All elements to the left of the double angle brackets >> are found in the Network Tree.
Guest Management Software Administrator Guide 4 1 Introduction

Related documentation

For information on related documentation, see the HP ProCurve Website at
www.hp.com/go/procurve/manuals.

HP ProCurve Networking support

HP ProCurve Networking offers support 24 hours a day, seven days a week through a number of automated electronic services.
The HP ProCurve Networking Web site, www.hp.com/go/procurve/support, provides up-to-date support information.
Additionally, your HP-authorized network reseller can provide you with assistance, both with services that they offer and with services offered by HP.

Chapter 2: Installation

Contents
Typical deployments - - - - - - - - - - - - - - - - - - - - - - - - - - - 6
Installation requirements - - - - - - - - - - - - - - - - - - - - - - - - - 7
2
Installation
Installation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 7
Starting for the first time - - - - - - - - - - - - - - - - - - - - - - - - - 8
Guest Management Software Administrator Guide 6 2 Installation

Typical deployments

The Guest Management Software can be installed on one or more computers, and works with any MSM7xx controller with a matching software version.

Multiple computer deployment

The following diagram shows a sample MSM7xx deployment with the Guest Management Software (GMS) installed on multiple computers.
In this scenario, the Guest Management Software is installed on multiple computers at the reception desk in a large hotel. In addition, it is also installed on the hotel manager’s computer. To support this scenario, the Guest Management Software makes use of a third-party database installed on the network. The third-party database can be installed on one of the computers on which the Guest Management Software is also installed. The Guest Management Software must be installed on each computer from where it will be used.
Note: You must use a third-party database when the Guest Management Software is
installed on more than one computer. If the Guest Management Software is installed on only one computer, the additional option of using a local internal database is available.
This scenario uses two VSCs:
Hotspot: Provides free access to information about the hotel in all public spaces.
Guest: Provides paying hotel guests with premium access in their rooms.
Guest Management Software Administrator Guide 72 Installation

Installation requirements

MSM7xx Controllers purchased on April 15, 2010 or later, are entitled to the HP ProCurve Guest Management Software v5.4. Customers who have an active CarePack or Support Contract for an MSM7xx Controller are also entitled to the Guest Management Software. Printed instructions provided with the MSM7xx Controllers describe how to download the Guest Management Software installation package.

Computer requirements

Note: Installing the Guest Management Software on a mobile computer is not
recommended.
To install and run the Guest Management Software, a computer requires the following software and hardware:
Operating system: Windows XP (SP2 recommended), Windows Vista.
Memory: Minimum of 512 MB.
HD space: Minimum of 200 MB free disk space to run the Guest Management Software
program, 2 GB for the station hosting the database.
Processor: Minimum 1 GHz. Pentium 4 (or equivalent).
Network connection to an HP ProCurve MSM7xx controller.
If a third-party database is used, a blank database must be created before running the Guest Management Software and, if required by the third-party database, database driver software must be installed.
For a list of supported databases, see “Database selection” on page 9.

Controller requirements

The Guest Management Software 5.4 requires one of the following controllers at version 5.4 or higher:
• MSM7xx controllers: MSM710, MSM730, MSM750, MSM760 or MSM765zl.
Note: The SOAP interface must be enabled on the port that the controller uses to
communicate with the Guest Management Software. By default, SOAP is enabled for the LAN port on all MSM controllers. To verify that SOAP is enabled on a controller, open the controller management tool and select Controller >> Management > SOAP and verify that SOAP server configuration is checked.

Installation

If running the Guest Management Software on a single computer, you can use its own internal database or a third-party database. If you plan to run the Guest Management Software on multiple computers, you must use a third-party database.
Note: External RADIUS/Active Directory accounts cannot be managed with the Guest
Management Software.
Guest Management Software Administrator Guide 8 2 Installation
Note: The Guest Management Software should be installed from a Windows account that
has administrator rights.

Installing on a single computer

To install the Guest Management Software, double-click the GMS_xxxx_Bxxx_install.exe file, which is located in the downloaded installation package. Follow the on-screen directions. The Guest Management Software will be installed in the folder of your choice. After the installation is completed, you are prompted to either view the README file or to start the Guest Management Software.

Installing on multiple computers

To install the Guest Management Software on multiple computers, do the following:
1. Install a third-party database to store Guest Management Software data. The database must
be installed on a server that is accessible to all computers that will run the Guest Management Software. This can include a computer on which the Guest Management Software is also installed.
2. Create a blank database using the third-party database software before installing the Guest
Management Software.
Make note of the following parameters when configuring the third-party database for the Guest Management Software.
Username/password that has read/write/create privileges for the database.
Database name.
Database IP or hostname.
Database port number.
3. To ensure that the database is correctly initialized, the Guest Management Software must be
installed, started, and configured on a single computer. The administrator account, of which there can be only one, is created during the initial installation.
4. You can then install the Guest Management Software on all other computers. To install the Guest Management Software, double-click the GMS_xxxx_Bxxx_install.exe file, which is located in the downloaded installation package. Follow the on-screen directions. The Guest Management Software will be installed in the folder of your choice. After the installation is completed, you are prompted to either view the README file or to start the Guest Management Software.

Starting for the first time

To start the Guest Management Software, select Start > All Programs > Colubris > Visitor Management Tool > Visitor Management Tool.
The first time you start the Guest Management Software, the configuration wizard guides you through the following procedures.
Guest Management Software Administrator Guide 92 Installation

A. Single or multiple computer installation

Choose whether the Guest Management Software will be configured to run on a single or multiple computers and select Next.

B. Database selection

Choose the database that the Guest Management Software will use to store guest account information and select Next to configure its settings.
Guest Management Software Administrator Guide 10 2 Installation
If running the Guest Management Software on a single computer, you can select Local (to use its own internal database) or a third-party database. If you plan to run the Guest Management Software on multiple computers, select a third-party database.
See “Installing on multiple computers” on page 8 for more information.
The Guest Management Software has been tested with the following third-party database engines:
PostGRE SQL 8.3.7 (Linux). This is the recommended external database.
Microsoft SQL Server 9.0.1399 (Windows)
Oracle XE 10.2.0.1-1.0 (Linux)
MySQL Standard 5.0.51 (Linux).
Note: To use the MySQL database, you must first install the driver. Proceed as
follows:
1. Acquire a commercial license for the Connector/J (JDBC driver) component of MySQL,
version 5.0.2 or greater.
2. Copy the driver file (which should be called mysql-connector-java-x.x.x-bin.jar where x.x.x is the version number of the driver) to the lib subdirectory of where you installed
the Guest Management Software.
3. Modify the file VisitorManagementTool.cmd to reflect the exact version of the driver used. Look for the line starting with @set MYSQL and change the version number there.
Note: The Guest Management Software may work with the listed databases under
other operating systems, provided the same version is used. However, you assume the risks of running the Guest Management Software on any non-tested platform or database.
Note: The database type cannot be changed without re-installing the Guest
Management Software.

C. Certificate Authority (CA) certificate creation

After the database selection is complete, the Certificate Authority Creation Wizard starts. The Certificate authority is used as follows:
When a controller is added to the Guest Management Software database, the CA
certificate is automatically installed on the controller. This certificate is used to validate the identities of the Guest Management Software and the controller when they exchange information.
The CA certificate is used to sign the certificates for operator accounts.
The username and password defined for the CA certificate are used as the login
credentials for the administrator account.
Guest Management Software Administrator Guide 11 2 Installation
To create a certificate:
1. Complete the certificate properties and select Next.
2. Define the certificate password and select Finish.
Caution: The certificate password is also the administrator password. If you
lose this password, you must re-install the software.
Guest Management Software Administrator Guide 12 2 Installation

D. Addition of a controller to the database

This step is optional. Controllers can be added later if desired.
Note: Before adding a controller, make sure that no user is currently logged in to the
controller management tool.
After the CA certificate has been created, the Add Service Controller Wizard starts. Define the settings for a controller on your network and select Finish. The HTTPS TCP port and SOAP TCP port fields are both predefined, at 443 and 448 respectively.
When selected, Display and confirm the service controller’s certificate ensures increased security. For example, you can create certificates and digitally sign them. Because this signature appears on each certificate when it is displayed, a different signature appearing on a certificate would indicate suspicious behavior, such as a compromised or hacked device being used to connect to the service.
If you specify a static IP address in the Specify Service Controller information window, a Warning appears:
Select Yes to continue.
Loading...
+ 40 hidden pages