Table Of Contents
Quick Start Guide for BBSM 5.3 with Cisco 1190
Revised: May 2006, 78-17687-01
This guide is designed to help you quickly set up and configure a Building Broadband Service Manager (BBSM) 5.3 server.
Caution Follow these steps carefully to ensure a successful BBSM configuration. If critical items such as IP addresses are not configured correctly, the system will become unstable and you will have to reinstall the BBSM software.
The basic setup process consists of five steps:
•Preparing the Site—Provides information on designing your network and configuring your network devices to work with the BBSM server.
•Connecting the BBSM Hardware—Describes how to set up a BBSM appliance and connect it to your network.
•Preparing the BBSM Server for Configuration—Provides information about running the BBSM wizards to prepare the BBSM server for configuration.
•Configuring the BBSM Server—Describes how to use WEBconfig from the Dashboard to configure the minimum items needed to activate Site 1.
•BBSM System Checkout—Provides steps on how to test your new BBSM network to determine if all items are properly configured.
After the basic setup is complete, you can perform these optional steps can be performed:
•Advanced Configuration—Describes how to configure advanced options such as multiple sites, dual VLANs, and SSL-enabled page sets.
•Troubleshooting—Provides suggestions on how to troubleshoot and resolve the most common configuration issues.
•Restoring the BBSM Image—Describes the basic steps to restore your BBSM server to its initial state if it fails to function properly; for example, because of a virus.
You can find additional information in these sections:
•BBSM Documentation—Provides information and links to online BBSM documents.
•Obtaining Technical Assistance—Provides links to the Cisco website and technical support.
Refer to the Cisco BBSM 5.3 Configuration Guide and the Cisco BBSM 5.3 Operations Guide for additional information, processes, and advanced BBSM topics.
Basic BBSM 5-Step Setup Process
Follow these steps to prepare a BBSM server for use.
Preparing the Site
To prepare the site for BBSM, Cisco recommends that you:
1. Work with your ISP to determine your needs.
2. Complete the Cisco BBSM 5.3 Configuration Requirements Checklist document located in the BBSM 5.3 Documents folder on the server desktop. The file is named Checklist.html.
3. Prepare a network diagram with a detailed IP address scheme for internal and external networks that connect to the BBSM.
4. Mount, install, power on, and configure all the internal network devices.
5. Mount, install, power on, and configure the external router and any other network devices used to connect the BBSM to the Internet.
Ensure that the NIC that connects the BBSM to the external router is properly configured with a public or private IP address. A NAT pool with overload is necessary for private IP addresses.
For the internal network to support plug-and-play functionality that provides support for clients with static configurations, a bridged network connection must be installed between the BBSM server and the client ports. If you do not plan to support plug-and-play functionality, you can use any type of network.
At a minimum, configure the internal subnet managed by the BBSM with these IP address ranges:
•Management Devices—These are network devices such as Ethernet switches that do not require authentication to gain Internet access.
•DHCP Clients—These are client computers that must be issued an IP address using the Dynamic Host Configuration protocol (DHCP).
•Foreign (Static) Clients—These are client computers that have a static IP address configuration. Such devices are handled by a special BBSM adaptive NAT feature that manages the one-to-one relationship between the client and the BBSM-issued IP address from this range of addresses.
Sample Network Design
Figure 1 is an example of a BBSM network showing different building areas and how they can connect through the BBSM server.
Figure 1 Sample BBSM Network
Connecting the BBSM Hardware
The BBSM 5.3 server is a rack-mounted platform. It comes with the BBSM software already installed.
Caution Do not change the physical location of the NIC card. This card must remain in the upper PCI slot, as it appears in Figure 3.
Caution Before you begin, ensure that the BBSM server is off. Do not attach external devices to the server while teh server is up and running.
Review the following four diagrams before proceeding with the setup and connection of your BBSM server hardware.
Figure 2 BBSM 5.3, front
Table 1 Explanation of callouts in Figure 2
No. Switch or LED Indicator Description 1
DVD-ROM drive activity LED
On = Activity
Off = No Activity
Power On/Off LED
Green = Power On
Amber = Standby Mode
Off = Power Off
System health LED
Green = Good
Amber = Degraded
Red = Critical Error
Indicates that there is activity on the hard drive.
Unit Identification button
To enable the Unit Identification LED, push the Unit Identification button. This button is a toggle: to turn off the flashing LED, press the Unit Identification buttonagain.
Unit Identification LED
When switched on, the Unit Identification LEDs on both the front and back panels flash blue. Turn off the flashing LED on the back of the unit off by pressing the Unit Identification button.
Universal serial bus port
BBSM 5.3, back
Table 2 Explanation of callouts in Figure 3
No. Description 1
AC power receptacle
Serial connector (see Figure 4)
Ethernet connector (disabled)
Internal NIC connector
External NIC connector
Ethernet connector (disabled)
Unit Identification Button and LED
Figure 4 Pin Numbers for the Serial Port Connector
Table 3 Pin Numbers for the Serial Port Connector (Figure 4)
Pin Signal I/O Definition 1
Data carrier detect
Data terminal ready
Data set ready
Request to send
Clear to send
Physical Assembly and Connection of the BBSM Server
Follow these steps to assemble and connect the BBSM server:
1. Mount the server into your rack by using the appropriate brackets and screws. Use the four-post rack-mounting kit and instructions that came with the server.
2. Refer to Figure 3 to connect the external devices to the BBSM back panel:
a. Plug an Ethernet straight-through cable to the internal NIC connector (7) on the back of the BBSM server.
b. Plug the other end of the cable to the highest port (uplink) available on the base switch, power injector, or wireless access point.
c. Plug an Ethernet crossover cable to the external NIC connector (8) on the back of the BBSM server.
d. Plug the other end of the cable to a port on the router used to connect to the Internet.
3. Connect any of this optional equipment to the BBSM server:
–Attach a keyboard to the keyboard connector on the back.
–Attach a mouse to the mouse connector on the back.
5. To start the server, press the Power button (2 in Figure 2).
You are now ready to prepare the BBSM server for configuration.
Preparing the BBSM Server for Configuration
After all the network devices are installed and configured, you must set the BBSM server up to communicate with the various network devices.
Caution For security reasons, you should change all passwords and install all service packs before configuring anything else on the BBSM server.
1. Enter the security passwords for the BBSM server.
You are prompted to do this the first time you turn the server on. For more information, see the section on "Getting Started" in the Cisco BBSM 5.3 Configuration Guide, available at http://www.cisco.com/en/US/products/sw/netmgtsw/ps533/
2. Verify that the latest service packs are installed on the BBSM server by comparing the versions listed in WEBpatch to the versions listed on the BBSM software download site.
You also can find more information on WEBpatch in the section on "Installing Service Packs or Patches (WEBpatch)" in the Cisco BBSM 5.3 Configuration Guide, available at http://www.cisco.com/en/US/products/sw/netmgtsw/ps533/products_user_guide_book
09186a00801dc764.html. The URL for thBBSM software download site is http://www.cisco.com/pcgi-bin/tablebuild.pl/bbsm53. There also is a link to the site on the link toolbar in Internet Explorer.
3. To configure the internal and external IP addresses for BBSM, choose Start > BBSM Configuration Wizards > Address Change Wizard.
If you are using dual VLANs, you use this wizard to also select which one is for clients and which one is for management IP addresses.
4. To add all network devices to the BBSM configuration, choose Start > BBSM Configuration Wizards > Switch Discovery Wizard.
This step also creates Site 1 and selects the default page set.
5. Enter the required configuration information for your DNS server by enabling forwarders and entering the DNS addresses in the BBSM properties, located under Start > Programs > Administrative Tools > DNS.
Configuring the BBSM Server
Now you are ready to configure the BBSM server for your site. The steps shown are necessary for hospitality environments that use PMS billing. Your configuration may require additional steps or settings. Refer to the Cisco BBSM 5.3 Configuration Guide for details and advanced options.
Note To prevent billing your PMS during the room-activation process, ensure that you have performed activation (Step 1) before setting up PMS billing (Step 2). However, to test PMS billing by having the rooms billed during activation, reverse Steps 1 and 2.
To configure the BBSM server:
1. For a wired network, activate each port location by entering each room, connecting to the BBSM server, and accessing Map Rooms. Perform a Port Test to verify the success of the activation.
If configuring a CMTS network, refer to the Cisco BBSM 5.3 Configuration Guide.
2. Configure the server for PMS billing by configuring the Settings and the Call Type under Billing > PMS or Printer.
BBSM System Checkout
When you have completed the required basic BBSM configuration, verify that the BBSM system functions correctly:
1. Verify a successful BBSM Administrative logon and full access to the desktop.
2. Verify that all expected ports have been mapped by creating a Mapping report. Choose Dashboard > Reporting Pages > Mapping.
3. If using a PMS system, run WEB PMS Test from the Dashboard.
4. Log on as a client from several different locations and confirm that you can access the Internet.
–Use the same type of access that the clients will use, such as RADIUS or access codes.
–If a mixed network is configured, test the wired and wireless connections.
5. Test any additional options that you configured, such as a walled garden or bandwidth reservations.
Your BBSM system is now activated.
After you complete the basic configuration steps and BBSM is working, you can configure additional BBSM features to meet your specific needs. To take advantage of the power of BBSM, consider some of the following options. Details are available in the Cisco BBSM 5.3 Configuration Guide. These options include:
•Using multiple sites to better control Internet access—By configuring different sites to manage different rooms or areas, it is easier to assign the type of page set for each site to control the appropriate type of access.
•Configuring dual VLANs to better manage site traffic—Use this feature to put the management traffic and equipment on one VLAN and end-user clients on the other VLAN.
•Enabling Secure Sockets Layer (SSL) security to use SSL-enabled page sets—Use this option if your page set requires the end user to enter sensitive information, such as credit card numbers or RADIUS usernames and passwords. Use the Security/SSL web page on WEBconfig to specify the associated domain name. You also must install a security certificate.
•Setting up special bandwidth reservation packages—This feature typically is used for meeting rooms that will be used by groups with bandwidth-intensive applications. Bandwidth can be reserved for the meeting to meet the needs of your end users.
•Creating a walled garden—By designing your connect page with links that users can access for free, you create an opportunity to generate incremental revenue while offering the end user valuable services.
Customizing Web Pages
BBSM uses page sets that contain a collection of active server page (ASP) files. These files execute when the end user opens a browser. These page sets define the access and accounting methods for the end user's session.
A Page Set wizard is available from the dashboard. You can use the wizard to create a basic DailyHotel page set in seven easy steps.
Page set templates also are provided for the most common BBSM applications. They can be used to create customized page sets that are then activated by using Custom Page Sets in WEBconfig.
Refer to the Cisco BBSM 5.3 Configuration Guide and the Cisco BBSM 5.3 SDK Developer Guide for details and examples.
This section describes a few of the most common BBSM configuration problems and how to resolve them. Refer to the Cisco BBSM 5.3 Operations Guide for more detailed information.
Note The most common reason that end users cannot connect to the Internet is having one or more incorrectly configured network devices. Always check network device configurations before troubleshooting the BBSM server.
No Connection to the BBSM Server
One of the following error messages appears on client's computer:
•Cannot Find Host
•Could not open search page
•Page not available
•DHCP Server Unavailable
Resolution: Verify all connections and IP configurations. The jack, patch cable, and network hardware frequently cause this behavior. Also verify that the IP addresses were changed correctly through the Address Change wizard.
Browser Reset to Work Offline
If no good connection to the BBSM exists, the browser resets to Work Offline when the user enters an address. The setting for working offline is in the browser File menu.
The following error messages appear on client's computer:
•No Internet connection available
Resolution: Verify that all connection settings, such as IP addresses or NICs, are correct, and then change this setting by unchecking the Work Offline check box.
No BBSM Connect Page Error (RME 19+7)
When opening the browser, the end user receives a Sorry, a network error has occurred error message instead of the BBSM connect page. This error also is known as the RME 19+7 error because this code appears at the bottom of the error message.
Resolution: While many possible causes for this condition exist, the most common is an unsupported or incorrectly configured network device. Refer to the Cisco BBSM 5.3 Operations Guide for other possible solutions.
Users Cannot Reach the Internet But the BBSM Server Can
DNS Forwarding is not configured or has cached bad information.
Resolution: Configure or restart DNS Forwarding in Windows. Refer to the Cisco BBSM 5.3 Configuration Guide for additional information.
VPN Client Not Working
A PIX firewall is blocking VPN access to Internet.
Resolution: Follow the PIX instructions for allowing access through a firewall.
Windows XP Takes a Long Time to Display a Web Page
XP is trying to register with its corporate domain server.
Resolution: Turn off client for Microsoft Networks by using the Network and Dial-up Connections properties dialog box.
Poor Internet Performance
End users are experiencing poor Internet performance.
Resolution: Run Port Test or ping the BBSM server from the room. If packet loss is high, check wiring for loose connections.
E-mail Not Working
Users cannot send or receive e-mail by using their ISP account while connected to BBSM.
Resolution: The network provider must add the BBSM external IP address to the SMTP server list of IP addresses from which the provider's server is allowed to receive SMTP packets. The network provider's server's address then must be configured in the SMTP Forwarding IP Address field on the Server Settings web page.
Restoring the BBSM Image
Should the BBSM server stop functioning for any reason, such as a major virus infection, use the restore CD that came with the appliance to restore the server to its initial state.
Caution If you restore the image on your BBSM server, you will lose all data on the hard drive, including port mappings, usage history, and server configuration. The image can be loaded only onto the hardware platform that it originally accompanied.
1. Depending on your appliance, insert the proper restore CD into the CD-ROM drive and reboot the server.
2. From the image loading screen, press any key to continue.
Wait while the image loads.
3. When the image finishes loading, remove the CD from the CD-ROM drive, and reboot the computer.
Wait while the server reboots.
4. Log in as Administrator.
5. From the System Settings Change dialog box, select Yes to restart the BBSM server.
This server is now back to the factory-installed configuration. You must reconfigure the software for your specific environment.
Cisco provides information online to assist you with setting up or troubleshooting your BBSM server. Check the following documents in the order listed to find the information that you need:
1. To ensure that you have the latest information on BBSM, refer to the release notes on Cisco.com website before installing, configuring, or upgrading the BBSM server. All BBSM release notes are available at http://www.cisco.com/en/US/products/sw/netmgtsw/ps533/
2. Open the Internet Explorer browser to view ReadMeFirst. It contains other key links to documents such as the BBSM 5.3 Configuration Requirements Checklist.
3. Click the Help button on the wizard and Dashboard screens. The BBSM 5.3 online help contains all the key information from the manuals.
4. Use the link on the Internet Explorer Links toolbar to access the Cisco BBSM Documentation website at http://www.cisco.com/en/US/products/sw/netmgtsw/ps533/prod_technical_documentation.html, which contains the latest versions of these documents:
–Cisco BBSM 5.3 Configuration Guide, available at http://www.cisco.com/en/US/products/sw/netmgtsw/ps533/
–Cisco BBSM 5.3 Operations Guide, available at http://www.cisco.com/en/US/products/sw/netmgtsw/ps533/
–Cisco BBSM 5.3 Software Installation Guide, available at http://www.cisco.com/en/US/products/sw/netmgtsw/ps533/
–Quick Start Guide for BBSM 5.3 with Cisco 1190, available at http://www.cisco.com/en/US/products/sw/netmgtsw/ps533/
5. If Internet service is not available, PDF versions of these documents are provided in the BBSM 5.3 Documents folder. A shortcut to this folder is located on the BBSM server desktop. The folder contains these documents:
–Cisco BBSM 5.3 Configuration Guide (order DOC-7815807=)
–Cisco BBSM 5.3 Operations Guide (order DOC-7816161=)
–Cisco BBSM 5.3 Software Installation Guide (order DOC-7815714=)
–All Cisco BBSM 5.3 Release Notes
Cisco.com contains two additional documents to support BBSM:
–Cisco BBSM 5.3 SDK Developer Guide
–Cisco BBSM 5.3 BBSD User Guide (order DOC-7816120=)
You can find instructions for ordering documentation at
To order Cisco documentation:
•Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from the Ordering tool:
•Nonregistered Cisco.com users can order documentation through a local account representative by calling Cisco Systems Corporate Headquarters (California, USA) at 408 526-7208 or, elsewhere in North America, by calling 800 553-NETS (6387).
You can submit e-mail comments about technical documentation to firstname.lastname@example.org.
You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address:
Attn: Customer Document Ordering
170 West Tasman Drive
San Jose, CA 95134-9883
We appreciate your comments.
Obtaining Technical Assistance
For all customers, partners, resellers, and distributors who hold valid Cisco service contracts, the Cisco Technical Assistance Center (TAC) provides 24-hour-a-day, award-winning technical support services, online and over the phone. Cisco.com features the Cisco TAC website as an online starting point for technical assistance. If you do not hold a valid Cisco service contract, please contact your reseller.
Cisco TAC Website
The Cisco TAC website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The Cisco TAC website is available 24 hours a day, 365 days a year. The Cisco TAC website is located at this URL:
Accessing all the tools on the Cisco TAC website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a login ID or password, register at this URL:
Opening a TAC Case
Using the online TAC Case Open Tool is the fastest way to open P3 and P4 cases. (P3 and P4 cases are those in which your network is minimally impaired or for which you require product information.) After you describe your situation, the TAC Case Open Tool automatically recommends resources for an immediate solution. If your issue is not resolved using the recommended resources, your case will be assigned to a Cisco TAC engineer. The online TAC Case Open Tool is located at this URL:
For P1 or P2 cases (P1 and P2 cases are those in which your production network is down or severely degraded) or if you do not have Internet access, contact Cisco TAC by telephone. Cisco TAC engineers are assigned immediately to P1 and P2 cases to help keep your business operations running smoothly.
To open a case by telephone, use one of the following numbers:
Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227)
EMEA: +32 2 704 55 55
USA: 1 800 553-2447
For a complete listing of Cisco TAC contacts, go to this URL:
© 2006 Cisco Systems, Inc. All rights reserved.