Chapter 1. Installation Preparation

System Requirements

Important Considerations

Chapter 2. Cisco VVB Installation

Install Cisco VVB

Server Configuration Information for Installation

Unattended Installation

Generate Answer File

Perform Unattended Installation Using Answer File

Chapter 3. Postinstallation Tasks

Access Cisco VVB Administration Web Interface

Access Cisco VVB Serviceability Web Page

Chapter 4. Cisco VVB Upgrade

Cisco VVB Upgrade Types

Important Information

Preupgrade Tasks

Cisco VVB Upgrade Scenarios

Upgrade Cisco VVB Using Web Interface

Upgrade Cisco VVB Using CLI

Switch Version

Verify Version

Verify Status of Services

Preface

Change History

About This Guide

Audience

Related Documents

Obtaining Documentation and Submitting a Service Request

Documentation Feedback

Copyright Page

Chapter 1. Installation Preparation

- System Requirements

- Important Considerations

System Requirements

Note

Cisco Virtualized Voice Browser (Cisco VVB) supports installation on virtualized servers. For more information on system requirements and Open Virtualization Archive (OVA) details, see the Virtualization Wiki at: Click Here .

For information on supported versions, see the Solutions Compatibility Matrix at Click Here .

Important Considerations

Read the following information carefully before you proceed with the installation:

- The Cisco VVB can be installed only on virtual machines.

- The Cisco VVB installer formats the hard drive and overwrites all existing data on the drive. It also upgrades the system BIOS and firmware, if they are outdated.

- Ensure that you connect the virtual machine to an uninterruptible power supply (UPS) to protect the Cisco VVB server from unexpected power failure that damages the physical media.

- Configure the server by using a static IP address so that the server IP address remains unchanged.

- Do not perform any configuration tasks during the installation. The installer might exit from the installation process.

- The Cisco VVB is bundled with an evaluation license.

Chapter 2. Cisco VVB Installation

- Install Cisco VVB

- Server Configuration Information for Installation

- Unattended Installation

Install Cisco VVB

Before You Begin

Perform the following tasks before installation:

- Ensure the Network Time Protocol (NTP) and DNS servers are running (mandatory for VMware deployments).

- Download the Cisco VVB ISO image and OVA template.

- Deploy virtual machine using the OVA template.

Procedure

Step 1

Mount the ISO image on the virtual machine.

Step 2

The installer checks the integrity of the ISO image before beginning the installation. Click Yes to perform a media check.

- If the media check fails, download another ISO image.

- If the media check is successful, click OK to proceed with installation.

Step 3

Follow the instructions on the screen to complete the installation. Enter the basic configuration information as described in Server Configuration Information for Installation .

Tip:
When the Apply Patch window appears, click No to begin the basic installation.

Server Configuration Information for Installation

Note

- You can use the configuration table for saving your entries either on a printed paper or online.

- Ensure the hostname and passwords that you enter while running the installation program are case-sensitive.

Tip

Changes to some of the configuration parameters may result in changes to the license MAC, and you may have to rehost the temporary or permanent Cisco Virtualized Voice Browser license.

Configuration Table

Parameter

Your Entry

Time Zone

NIC Duplex

Note:
This parameter is not displayed if automatic negotiation is used.

NIC Speed

Note:
This parameter is not displayed if automatic negotiation is used.

MTU Size

Note:
Maximum Transmission Unit (MTU) value of the server.

Hostname

Tip:
Ensure that the hostname is assigned on the DNS server. The hostname must contain only alphanumeric characters or hyphen. It cannot be "localhost" or an IP address.

IP Address

IP Mask

Gateway Address

Primary DNS

Secondary DNS (optional)

Domain

Administrator ID

Note:
You cannot change the original administrator account user ID; you can create additional administrator accounts.

Caution:
Do not create administrator IDs (for CLI access or Operating System administration) that start with "vvb" or "VVB" because such IDs conflict with system account names that are used internally within the Cisco Virtualized Voice Browser server.

Administrator Password

Note:
This field specifies the password for the administrator account, which you use for secure shell access to the CLI, for logging in to Cisco Unified Communications Operating System Administration, and for logging in to the Disaster Recovery System. Ensure that the password is at least six characters long; it can contain alphanumeric characters, hyphens, and underscores.

You can change the password after installation.

Unit

Note:
The value you enter is used to generate a Certificate Signing Request.

Location

State

Note:
The value you enter is used to generate a Certificate Signing Request.

Country

Note:
The value that you enter is used to generate a Certificate Signing Request and self-signed certificates.

NTP Server
Note:
Enter the hostname or IP address of one or more Network Time Protocol (NTP) servers with which you want to synchronize.

You can enter up to 5 NTP servers.

You can change the NTP server after installation.

Security Password
Note:
This password is used to reset your application password. The password must contain at least six alphanumeric characters. It can contain hyphens and underscores, but it must start with an alphanumeric character.

You can change the password after installation by using the following CLI command:

set password user security

SMTP Location

Note:
You must populate this field if you plan to use e-mail notification.

Application User Name
Note:
Use the Application User Name to log in to the Administration Web Portal.

Application User Password

Note:
Use the Application User password as the default password for the application. Ensure that the password is at least six characters long; it can contain alphanumeric characters, hyphens, and underscores.

You can change the password after installation.

Unattended Installation

Unattended installation performs installation silently using a configuration file that includes all the input parameters. Use Cisco Unified Communications Answer File Generator to generate answer files for unattended installations of Cisco VVB.

The Answer File Generator supports the following features:

- Allows simultaneous generation and saving of answer files for unattended installation.

- Provides syntactical validation of data entries.

- Provides online help and documentation.

Note

Unattended installation supports only basic installations and not the upgrades.

- Generate Answer File

- Perform Unattended Installation Using Answer File

Generate Answer File

Procedure

Step 1

Go to Click Here (Cisco Unified Communications Answer File Generator web page).

Step 2

Select the following options:

1. Primary Node Installed On as Virtual Machine

2. Product as Cisco Virtualized Voice Browser

Step 3

Enter the remaining information on Answer File Generator web page and click Generate License Files & License MAC to generate a configuration file.
Note:
On the Answer File Generator web page, make a note of the license MAC that is displayed.

Caution:
License MAC is generated based on the basic configuration information that you provided in the Answer file generator page.

1. Click the Proceed to Download Answer Files button to download the file.

2. Follow the Download Instructions on the page and click the Download File button.

Step 4

Save the platformConfig.xml file on your local system.

Perform Unattended Installation Using Answer File

Procedure

Step 1

Create a floppy drive image adding the Answer file.
Note:
To create a floppy drive image, follow the procedure located at: Click Here .

Step 2

Mount the floppy drive image in VM under the Floppy Drive 1.

Step 3

Select the Connect at power-on option in Floppy Drive 1.

Step 4

After you start the VM, the Cisco VVB ISO boots the system and executes platformConfig.xml automatically.

Chapter 3. Postinstallation Tasks

This chapter describes how to access Cisco Virtualized Voice Browser Administration web interface and to perform Cisco Unified Customer Voice Portal (Unified CVP) interoperability changes for Cisco VVB.

- Access Cisco VVB Administration Web Interface

- Access Cisco VVB Serviceability Web Page

Access Cisco VVB Administration Web Interface

The web pages of the Cisco VVB Administration web interface allow you to configure and manage the Cisco VVB system and its subsystems.

Use the following procedure to navigate to the server and log in to Cisco VVB Administration web interface.

Procedure

Step 1

Open the Cisco VVB Administration Authentication page from a web browser on any computer on your network and enter the case-sensitive URL in the following format:

https://<servername>/appadmin

Replace <servername> with the hostname or IP address of the required Cisco VVB server.

A Security Alert dialog box is displayed.

Step 2

On the Cisco Virtualized Voice Browser Administration web page, enter your Cisco VVB username and password.
Note:
If you are accessing Cisco VVB for the first time, enter the Application User credentials that you specified during installation of the Cisco VVB.

Step 3

Click Login.
A web page is displayed listing information about Cisco Virtualized Voice Browser Administration, and the Cisco Virtualized Voice Browser Administration menu bar appears at the top of the page.

Note:

- For security purposes, Cisco Virtualized Voice Browser Administration logs you out after 30 minutes of inactivity, and you must log back in.

- Cisco VVB Administration detects web-based cross-site request forgery attacks and rejects malicious client requests. It displays the error message, "The attempted action is not allowed because it violates security policies."

Access Cisco VVB Serviceability Web Page

Cisco VVB Serviceability is used to view alarm and trace definitions for Cisco VVB services, to start, stop, and monitor Cisco VVB Engine activity, and to activate and deactivate services.

After you log in to Cisco Virtualized Voice Browser Administration web page, you can access Cisco VVB Serviceability in two ways:

- From the Navigation drop-down list, select Cisco Virtualized Voice Browser Serviceability and click GO

- From a web browser, enter: https://<server name or IP address>/uccxservice/

Chapter 4. Cisco VVB Upgrade

- Cisco VVB Upgrade Types

- Important Information

- Preupgrade Tasks

- Cisco VVB Upgrade Scenarios

- Upgrade Cisco VVB Using Web Interface

- Upgrade Cisco VVB Using CLI

- Switch Version

- Verify Version

- Verify Status of Services

Cisco VVB Upgrade Types

Upgrade files are available as ISO images.

You can upgrade Cisco VVB from:

- Cisco VVB OS Administration web interface

- Command Line Interface (CLI)

You can apply the ISO images from:

- Local DVD

- FTP/SFTP server

Note

For information about supported upgrades, see Compatibility Matrix for Cisco VVB, available here: Click Here

Cisco VVB provides the following upgrade options:

Types of Upgrade

Upgrade Type

Upgrade Path

Description

Maintenance Release (MR)

11.0.x to 11.0.x

There is service interruption during the upgrade and subsequent server restart.

Important Information

- Install Cisco VVB only on virtual machines. Cisco VVB will not run on bare metal.

- DNS is mandatory. Before you upgrade, ensure that the domain name and DNS server IPs are configured. Also verify that forward and reverse lookups on the DNS server are correct.

- Do not make any configuration changes during the upgrade, because the changes are lost after the upgrade.

- Upgrade Cisco VVB during off-peak hours or during a maintenance window to avoid service interruptions.

- You may experience a delay of approximately 30 minutes for the services to start during the first restart of the Cisco VVB system post the switch version. This is due to the application of Security policies post upgrade. This delay will not appear in subsequent restarts.

- It takes approximately 90 minutes to upgrade.

- Cisco VVB versions include a feature in the VMware Installation information line to indicate whether the disk partitions are aligned. If the disk partitions are aligned, the VMware installation information line will indicate Partitions aligned. After upgrading, if the VMware installation information line indicates ERROR-UNSUPPORTED: Partitions unaligned, it means Cisco cannot provide support for performance issues.

Preupgrade Tasks

Procedure

Step 1

Ensure that you have the Secure File Transfer Protocol (SFTP) server product.

Step 2

Obtain the appropriate ISO file from http://www.cisco.com.

Step 3

Create an ISO image of the upgrade file and follow the steps:

1. Write the ISO image on a DVD. Do not copy the ISO file to a DVD.

2. Copy the ISO image on an FTP/SFTP server on which your server has access.

Cisco VVB Upgrade Scenarios

The following table lists the required tasks to upgrade the Cisco VVB.

Upgrade Scenarios

Upgrade Scenario

Task

11.0.x_1 to 11.0.x_2

To upgrade, follow these procedures:

1. Upgrade Cisco VVB Using Web Interface or Upgrade Cisco VVB Using CLI.

2. Switch Version.

3. Verify Version

4. Verify Status of Services

Upgrade Cisco VVB Using Web Interface

You can upgrade Cisco VVB either from a local DVD or from a FTP/SFTP server.

Procedure

Step 1

Log in to Cisco VVB OS Administration using administrator username and password.

Step 2

Choose Software Upgrades > Install/Upgrade.

Step 3

Choose source as either DVD/CD or Remote Filesystem from the Source list.

Step 4

Enter the path of the upgrade file in the Directory field. For Remote Filesystem, enter a forward slash (/) followed by the directory path.

Step 5

If you chose Remote Filesystem, follow the instructions on the screen; otherwise, skip to Step 6.

Step 6

Click Next to see the list of upgrades that are available.

Step 7

Choose the appropriate upgrade file, and click Next.

Step 8

Enter relevant information in the Email Destination and SMTP server fields to use the Email Notification feature.

Step 9

Click Next to initiate the upgrade process.

Upgrade Cisco VVB Using CLI

Procedure

Step 1

Log in to Cisco Unified Communications OS Platform CLI using administrator username and password.

Step 2

Enter the command show version active and check the current version.

Step 3

Enter the command utils system upgrade status and check that the node is ready for upgrade.

Step 4

Enter the command utils system upgrade initiate to initiate the upgrade process.

Step 5

Choose the source where the upgrade file is placed.

Step 6

Follow the instructions on the screen.
Your entries are validated and the list of available files is displayed.

Step 7

Select the ISO image you want to apply from the available list, and confirm the installation when you are prompted.

Step 8

Enter the command show version active and check the upgrade version.

Switch Version

Note

- Perform switch version in the same maintenance window to avoid additional downtime.

- The time taken for switch version depends on the size of records in the database.

Procedure

Step 1

To check and perform switch version using the web interface:

1. Log in to Cisco Unified OS Administration using administrator username and password.

2. Choose Settings > Version to check the versions.

3. Click Switch Versions, and click OK to initiate the switch version process.

4. Choose Settings > Version to check the active version.

Step 2

To check and perform switch version using the CLI:

1. Log in to Cisco Unified Communications OS Platform CLI using administrator username and password.

2. Enter the command show version active to check the active version.

3. Enter the command show version inactive to check the inactive version.

4. Enter the command utils system switch-version to initiate the switch version process.

5. Enter the command show version active to check the active version.

Step 3

If switch version is unsuccessful:

1. Log in to Cisco Unified Communications OS Platform CLI using administrator username and password.

2. Enter the command utils vvb switch-version db-check to check if the database is corrupt.

3. Enter the command utils vvb switch-version db-recover to restore the database.

Verify Version

You can verify the current active and inactive versions of Cisco VVB either by using the web interface or using CLI.

Procedure

Step 1

To verify the active and inactive versions of Cisco VVB using the web interface:

1. Log in to Cisco Unified OS Administration using administrator username and password.

2. Choose Settings > Version to check the current active and inactive versions.

Step 2

To verify the active and inactive versions of Cisco VVB using the CLI:

1. Log in to Cisco Unified Communications OS Platform CLI using administrator username and password.

2. Enter the command show version active to check the active version.

3. Enter the command show version inactive to check the inactive version.

Verify Status of Services

You can verify the status of services either by using the web interface or using the CLI.

Procedure

Step 1

To verify the status of services using the web interface:

1. Log in to Cisco VVB Serviceability using administrator username and password.

2. Choose Tools > Control Center - Network Services and verify that all the services are running.

Step 2

To verify the status of services using the CLI:

1. Log in to Cisco Unified Communications OS Platform CLI using administrator username and password.

2. Enter the command utils service list to verify that all the services are running.

Preface

- Change History

- About This Guide

- Audience

- Related Documents

- Obtaining Documentation and Submitting a Service Request

- Documentation Feedback

Change History

This table lists the changes made to this guide and gives the dates those changes were made. Earliest changes appear in the bottom rows.

Change

Date

Initial release of the document.

January 25, 2016

About This Guide

This document explains how to install Cisco Virtualized Voice Browser (Cisco VVB) in a Contact Center deployment. Review all the installation instructions carefully before you install Cisco VVB.

Audience

This guide is intended for administrators who install and upgrade Cisco VVB.

Related Documents

Cisco VVB provides the following documentation:

- Design Guide for Cisco Unified Customer Voice Portal

- Configuration Guide for Cisco Unified Customer Voice Portal

- Port Utilization Guide for Cisco Virtualized Voice Browser

- Operations Guide for Cisco Virtualized Voice Browser

- Developer Guide for Cisco Virtualized Voice Browser

- Troubleshooting Wiki for Cisco Virtualized Voice Browser

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service request, and gathering additional information, see What's New in Cisco Product Documentation, at: Click Here .

Subscribe to What's New in Cisco Product Documentation, which lists all new and revised Cisco technical documentation as an RSS feed and delivers content directly to your desktop using a reader application. The RSS feeds are a free service.

Documentation Feedback

To provide comments about this document, send an email message to Click Here

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: Click Here . Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)