Reference

Tasks Common to Virtual Machines

About Creatings VMs

This chapter explains the sequence of tasks for creating virtual machines on each host server.

The sequence is:

  1. Download the OVA files. See Open Virtualization Files.

  2. Create VMs .

  3. After you create all the VMs, perform initial configuration. See the Post Installation Configuration section in the Cisco Packaged Contact Center Enterprise Administration and Configuration Guide at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-maintenance-guides-list.html.

Open Virtualization Files

Open Virtualization Format files define the basic structure of the VMs that are created—including the CPU, RAM, disk space, reservation for CPU, and reservation for memory.

  1. Go to Download Software page on Cisco.com.

  2. Select the required product release version.

  3. Download and extract the file and save the OVAs to your local drive.

Mount ISO Files

Upload ISO image to data store:

  1. Select the host in the vSphere client and click Configuration. Then click Storage in the left panel.

  2. Select the datastore that will hold the ISO file.

  3. Right click and select Browse datastore.

  4. Click the Upload icon and select Upload file.

  5. Browse to the location on your local drive where you saved the ISO file, and upload the ISO to the datastore.

Mount the ISO image:

  1. Right-click the VM in the vSphere client and select Edit virtual machine settings.

  2. Click Hardware and select CD|DVD Drive 1.

  3. Check Connect at power on (Device status panel upper right).

  4. Click the Datastore ISO File radio button and then click Browse.

  5. Navigate to the data store where you uploaded the file.

  6. Select the ISO file and click OK.

Create a Virtual Machine from the OVA

Before you begin

For information on VMs, see the following sections:

Procedure


Step 1

Select the host in the vSphere client.

Step 2

Choose File > Deploy OVF Template.

Step 3

Browse to the location on your local drive where you stored the OVA.

Note

 

For Cisco VVB OVA, an End User License Agreement displays. Click Agree and then click Next.

Step 4

On the Select a name and folder page, enter a name for the virtual machine and then choose the location for the virtual machine.

The name can contain up to 128 characters. Valid characters are period (.), hyphen (-), underscore (_), and alphanumeric. The first character must be alphanumeric.

Step 5

Click Next.

Step 6

On the Select a compute resource page, select the destination compute resource. Click Next.

Step 7

On the Review details page, verify the OVF template details.

Step 8

On the Configuration page, select the applicable configuration from the available list. Click Next.

Note

 

When deploying a CUIC OVF, choose Co-Resident for a 2000 Agent Deployment and Stand-Alone for a 4000 Agent and 12000 Agent Deployment.

Step 9

On the Select storage page, ensure that the virtual disk format is Thick provision Lazy Zeroed and then choose a datastore on which you want to deploy the new virtual machine. Click Next.

For each datastore, the following tables describe the RAID group, the ESXi Host, and the virtual machines for the Cisco UCS C240 M4SX and Cisco UCS C240 M5SX servers.

Note

 

If you are on a Cisco UCS C240 M5SX server, remove the following annotations from the non-core component VMs: Cisco, Finesse, CUIC, and CVP.

RAID configuration for the Cisco UCS C240 M4SX and Cisco UCS C240 M5SX

RAID Group

VM Datastore

ESXi Host

Virtual Machines

VD0

datastore 1

A

ESXi operating system

Unified CCE Rogger Side A

Unified CCE Router Side A

Unified CCE Logger Side A

Unified Communications Manager Publisher

Cisco Finesse Primary

VD1

datastore 2

A

Unified CCE AW-HDS-DDS Side A

VD2

datastore 3

A

Unified Communications Manager Subscriber 1

Unified CVP Server Side A

VD3

datastore 4

A

Unified Intelligence Center Server Publisher

Unified CCE PG Side A

VD0

datastore 1

B

ESXi operating system

Unified CCE Rogger Side B

Unified CCE Router Side B

Unified CCE Logger Side B

Unified Communications Manager Subscriber 2

Cisco Finesse Secondary

VD1

datastore 2

B

Unified CCE AW-HDS-DDS Side B

VD2

datastore 3

B

Unified Customer Voice Portal Reporting Server (optional)

Unified CVP Server Side B

VD3

datastore 4

B

Unified Intelligence Center Server Subscriber

Unified CCE PG Side B

Enterprise Chat and Email Server (optional)

Step 10

On the Select networks page, confirm that the network mapping is correct for the Unfied CCE Rogger and PG:

  1. For the Unifed CCE Rogger and PG:

    • Map Public to UCCE Public Network

    • Map Private to UCCE Private Network

  2. For all other servers, map Public to UCCE Public Network.

Step 11

On the Network Mapping page, select the appropriate network from the Destination drop-down list.

Step 12

On the Ready to complete page, click Finish to create the VM.

Note

 

Do not make any changes to the VM configurations once the VMs are created.


Configure DNS Server

This procedure is for Windows DNS server.


Note


If the deployment uses host files in addition to DNS, use FQDNs in the host file. Live Data requires FQDNs in order to work properly.



Note


If the deployment uses host files in addition to DNS, use FQDNs in the host file. Live Data and single sign-on (SSO) require FQDNs in order to work properly.


Procedure


Step 1

Log in to the DNS server.

Step 2

In Windows, navigate to Administrative Tools > DNS. This opens the DNS Manager.

Step 3

In the Forward lookup zone, navigate to your deployment's domain name.

Step 4

Right-click the domain name and select New Host (A or AAAA).

Step 5

In the New Host dialog box, enter the computer name and IP address (IPv4) of VOS components.


Configure Database Drive


Note


Complete this procedure to create a virtual drive, if the virtual drive was not automatically created in the VM.


Procedure


Step 1

Add a virtual drive as follows:

Using Vsphere client:

  1. Right-click the virtual machine and click Edit Settings.

  2. In the Hardware tab, click on Add.

    The Add Hardware window appears.

  3. You can select the type of device you wish to add. Select Hard Disk, and then click Next.

  4. Select the Create a new virtual disk option, and then click Next.

  5. In the Capacity section, use the Disk Size box to assign the desired disk space, and then click Next.

    Note

     

    Virtual machine templates for Logger, Rogger, AW, and HDS servers do not have a SQL database drive preprovisioned. The following reference table must be used to assign disk space to the virtual machine based on the type of validation errors will occur:

    Virtual Machine Template

    Default Second Disk Size

    Logger

    500 GB

    Rogger

    150 GB

    AW-HDS-DDS

    750 GB

    AW-HDS

    500 GB

    HDS-DDS

    500 GB

    You can custom size the SQL database disk space to meet the data retention requirements on an external AW-HDS-DDS server only, as calculated by the Database Estimator tool.

  6. On the Disk Provisioning section choose Thick provision Lazy Zeroed format. Click Next.

  7. In the Advanced Options section, retain the default options and then click Next.

  8. In the Ready to Complete section, click Finish to create the hard disk.

  9. Click OK to confirm the changes.

    The Recent Tasks window at the bottom of the screen displays the progress.

Using Web client:

  1. Right-click the virtual machine and click Edit Settings.

  2. In the Virtual Hardware tab, click on Add New Device.

  3. You can select the type of device you wish to add. Select Hard Disk. The new hard disk appears. Assign the desired disk space to the hard disk.

  4. Configure the required parameters as specified below:

    Note

     

    Virtual machine templates for Logger, Rogger, AW, and HDS servers do not have a SQL database drive preprovisioned. The following reference table must be used to assign disk space to the virtual machine based on the type of validation errors will occur:

    Virtual Machine Template

    Default Second Disk Size

    Logger

    500 GB

    Rogger

    150 GB

    AW-HDS-DDS

    500 GB

    AW-HDS

    500 GB

    HDS-DDS

    500 GB

    You can custom size the SQL database disk space to meet data retention requirements on an external AW-HDS-DDS server only, as calculated by the Database Estimator tool.

  5. On the Disk Provisioning section, choose Thick provision Lazy Zeroed.

  6. In the VM Options > Advanced Options section, retain the default options.

  7. Click OK to confirm the changes.

    The Recent Tasks window at the bottom of the screen displays the progress.

Step 2

In Windows, navigate to Disk Management.

Step 3

Right-click on the Disk 1 box and select Online.

Step 4

Initialize Disk 1 as follows:

  1. Right-click on the Disk 1 box and select Initialize Disk.

  2. Check the Disk 1 checkbox.

  3. Select the MBR (Master Boot Record) radio button.

  4. Click OK.

Step 5

Create a new disk partition as follows:

  1. Right-click the graphic display of Disk 1 and select New Simple Volume.

  2. Click Next on the first page of the New Simple Volume Wizard.

  3. On the Specify Volume Size page, retain the default volume size. Click Next.

  4. On the Assign Drive Letter or Path page, assign drive letter (E). Click Next.

  5. On the Format Partition page, format the partition as follows:

    1. Select the Format this volume with the following settings radio button.

    2. Click Format Disk.

    3. Select File System as NTFS and click Start.

    4. Select Default from the Allocation unit size drop-down menu.

    5. Enter a value in the Volume label field.

    6. Check the Perform a quick format checkbox.

    7. Click Next.

  6. Click Finish.

    A popup window displays a message that you need to format the disk before you can use it.

    The format is complete when the status changes to Healthy.

Step 6

Format the disk.

  1. Click Format disk.

  2. Click Start.

    A popup displays a warning that formatting will erase all data on the disk.
  3. Click OK.

  4. When the format is complete, click OK to close the popup window.


Install Antivirus Software

Install one of the supported antivirus software products.

See the Contact Center Enterprise Compatibility Matrix at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-device-support-tables-list.html for the list of supported products.


Important


Disable automatic updates. Update antivirus software manually.



Important


The firewall component of Symantec Endpoint Protection 12.1, the Network Threat Protection feature, must be disabled. If the feature remains enabled, which is the default, both sides of a duplexed router come up in simplex mode, thus blocking communication between each side of a router. This blocking impacts all deployment types.


For more information on security guidelines, refer the General Antivirus Guidelines section in the Security Guide for Cisco Unified ICM/Contact Center Enterprise Guide at https://www.cisco.com/c/en/us/support/customer-collaboration/unified-contact-center-enterprise/products-installation-and-configuration-guides-list.html.

To allow required access to installation program files or folders, perform file-blocking exclusions in the antivirus product file-and-folder protection rules. To do this in McAfee VirusScan:

Procedure

  Command or Action Purpose

Step 1

Launch the VirusScan console.

Step 2

Right-click Access Protection and select Properties.

Step 3

In the Anti-virus Standard Protection category, make sure that the rule Prevent IRC communication is unchecked in the Block column.

For more information about changing settings, see the documentation for your antivirus software.

Software Installations for Components

This section holds the consolidated list of software installation procedures that are referenced in the following section:

Install Microsoft Windows Server

Complete the following procedure to install Microsoft Windows Server on the virtual machines deployed.


Note


Before installing 12.5(1) ICM on SQL Server , make sure to install ODBC Driver 13 for SQL Server® manually.


Procedure


Step 1

Mount the Microsoft Windows Server ISO image to the virtual machine.

Check the Connect at power on check box when mounting the ISO.

Step 2

Power on the VM.

Step 3

Enter the Language, Time and Currency Format, and Keyboard settings. Click Next.

Step 4

Click Install Now.

Step 5

If prompted, enter the product key for Windows Server and click Next.

Step 6

Select the Desktop Experience option for the Windows Server and click Next.

Step 7

Accept the license terms and click Next.

Step 8

Select Custom: Install Windows only (advanced), select Drive 0 to install Microsoft Windows Server, and then click Next.

The installation begins. After the installation is complete, the system restarts without prompting.

Step 9

Enter and confirm the password for the administrator account, and then click Finish.

Step 10

Enable Remote Desktop connections as follows:

  1. Navigate to Control Panel > System and Security > System.

  2. Click Remote Settings.

  3. Click the Remote tab.

  4. Select the Allow remote connections to this computer radio button. The Remote Desktop Connection dialog displays a notification that the Remote Desktop Firewall exception is enabled. Click OK.

Step 11

Install VMWare tools. See Install VMware Tools.

Step 12

Open the Network and Sharing Center, and in the View your basic network info and set up connections section, click Ethernet.

Step 13

In the Ethernet Status window, click Properties.

Step 14

In the Ethernet Properties dialog box, configure the network settings and the Domain Name System (DNS) data:

  1. Uncheck Internet Protocol Version 6 (TCP/IPv6).

  2. Select Internet Protocol Version 4 (TCP/IPv4) and click Properties.

  3. Select Use the following IP Address.

  4. Enter the IP address, subnet mask, and default gateway.

  5. Select Use the following DNS Server Address.

  6. Enter the preferred DNS server address, and click OK.


Microsoft Windows Server is installed. In addition, Internet Explorer 11 is installed automatically.

Note


If you want to install Unified CCE on a multilingual version of Windows Server, run the Multilingual User Interface (MUI) language pack. See https://software.cisco.com/download/release.html?mdfid=268439622&flowid=46046&softwareid=280840583.

If Unified CCE language pack is applied on Chinese Windows OS machine, set the screen resolution to 1600 x 1200.


Install Microsoft SQL Server

Install Microsoft SQL Server and store the SQL Server log and temporary files on the same vDisk as the operating system when using default (two) vDisk design. If you choose to use more than two virtual disks, then the tempDB cannot be on the same vDisk as the solution database.

For further information about the database placement and performance tuning the SQL installation, see the Microsoft documentation.


Note


For information about supported editions, see the Contact Center Enterprise Compatibility Matrix at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-device-support-tables-list.html.


Before you begin


Note


Microsoft SQL Server does not contain SQL Server Management Studio in the default toolkit. To rerun the SQL Server setup to install Management Studio, navigate to: SQL Selection Center > Installation > Install SQL Server Management Tools. If your computer has no internet connection, download and install SQL Server Management Studio manually.


Add the virtual machine to a domain before installing SQL Server.

Procedure


Step 1

Mount the Microsoft SQL Server ISO image to the virtual machine. For more information, see Mount ISO Files.

Step 2

Select Installation in the left pane and then click New SQL Server stand-alone installation or add features to an existing installation. Click OK.

Step 3

On the Product Key page, enter the product key and then click Next.

Step 4

Accept the License Terms and then click Next.

Step 5

Optional: On the Microsoft Update page, check the Use Microsoft Update to check for updates check box, and then click Next.

Note

 

If you do not check the Use Microsoft Update to check for updates option, click Next on the Product Updates page.

Step 6

On the Install Rules page, click Next.

In this step, the installation program checks to see that your system meets the hardware and software requirements. If there are any issues, warnings or errors appear in the Status column. Click the links for more information about the issues.

Step 7

On the Feature Selection page, select only the following, and click Next:

  • Database Engine Services

  • SQL Server Replication

  • Client Tools Connectivity

  • Client Tools Backwards Compatibility

  • Client Tools SDK

  • SQL Client Connectivity SDK

Step 8

On the Instance Configuration page, select Default Instance and click Next.

Step 9

On the Server Configuration page, click the Services Account tab.

  1. Associate the SQL services with the virtual account.

    • For the SQL Server Agent service, in the Account Name field, select NT Service\SQLSERVERAGENT. If you have enabled Outbound Option High Availability, this account must have the system administrator privilege.

    • For the SQL Server Database Engine, in the Account Name field, select NT Service\MSSQLSERVER.

    Note

     

    While you can use the Network or Local Services account instead of the Virtual account, using the Virtual account provides security.

  2. For the remaining services, accept the default values.

  3. In the Start Up Type column, for the SQL Server Agent service account, select Automatic from the list.

  4. Enable Grant Perform Volume Maintenance Task privilege to SQL Server Database Engine Service.

    Note

     

    Unified ICM Installer automatically enables the Grant Perform Volume Maintenance Task for the NT service account.If it is not enabled automatically then you must enable Grant Perform Volume Maintenance Task privilege to SQL Server Database Engine Service manually on the SQL server.

Step 10

On the Server Configuration page, click the Collation tab.

  1. In the Database Engine section, click Customize.

  2. Select the Windows Collation designator and sort order radio button.

  3. Select the appropriate collation. Typically, you choose the SQL Server collation that supports the Windows system locale most commonly used by your organization; for example, "Latin1_General" for English.

    Note

     

    See the Contact Center Enterprise Compatibility Matrix at https://www.cisco.com/c/en/us/support/customer-collaboration/unified-contact-center-enterprise/products-device-support-tables-list.html for details about collations used for other languages.

    The database entry is related to the collation that you select. For example, if you set the collation for Latin1_General, but you select Chinese language at sign-in. When you enter field values in Chinese, the application displays the unsupported character error, because the database does not support the characters.

    Important

     

    It is critical to select the correct collation setting for the language display on your system. If you do not select the correct collation during installation, you must uninstall and reinstall Microsoft SQL Server.

  4. Check the Binary check box.

  5. Click OK, and then click Next.

Step 11

On the Database Engine Configuration page:

  1. On the Server Configuration tab, click the Mixed Mode radio button.

  2. Enter the password for the SQL Server system administrator account, and confirm by reentering it.

  3. Click Add Current User to add the user who is installing the SQL Server as an administrator.

  4. On the TempDB tab, set the Initial size and Autogrowth for Rogger, Logger, AW-HDS-DDS, AW-HDS, and HDS-DDS. For information about values for respective components Increase Database and Log File Size for TempDB.

    For more information about the SQL Server TempDB Database and its use, see the Microsoft SQL Server documentation.

  5. Click Next.

Step 12

On the Ready to Install page, click Install.

Step 13

On the Complete page, click Close.

Step 14

Enable Named Pipes and set the sort order as follows:

  1. Open the SQL Server Configuration Manager.

  2. In the left pane, navigate to SQL Native Client 11.0 Configuration (32bit) > Client Protocols.

  3. In the right pane, confirm that Named Pipes is Enabled.

  4. Right-click Client Protocols and select Properties.

  5. In the Enabled Protocols section of the Client Protocols Properties window, use the arrow buttons to arrange the protocols in the following order:

    1. Named Pipes

    2. TCP/IP

  6. Check the Enable Shared Memory Protocol and then click OK.

  7. In the left pane, navigate to SQL Server Network Configuration > Protocols for MSSQLSERVER.

  8. In the right pane, right-click Named Pipes and select Enable.

Note

 

By default, Microsoft SQL Server dynamically resizes its memory. The SQL Server reserves the memory based on process demand. The SQL Server frees its memory when other processes request it, and it raises alerts about the memory monitoring tool.

Cisco supports the Microsoft validation to dynamically manage the SQL Server memory. If your solution raises too many memory alerts, you can manually limit SQL Server’s memory usage. Set the maximum and minimum limit of the SQL memory using the maximum memory usage settings in the SQL Server Properties menu.

For more information about the SQL Server memory settings and its use, see the Microsoft SQL Server documentation.

Step 15

Set the SQL Server's default language to English as follows:

  1. Launch SQL Server Management Studio.

  2. In the left pane, right-click the server and select Properties.

  3. Click Advanced.

  4. In the Miscellaneous section, set the Default Language to English.

  5. Click OK.

Important

 

Set the SQL Server default language to English because Cisco Unified Contact Center Enterprise requires a US date format (MDY). Many European languages use the European date format (DMY) instead. This mismatch causes queries such as select * from table where date = '2012-04-08 00:00:00' to return data for the wrong date. Handle localization in the client application, such as Cisco Unified Intelligence Center.

Step 16

Restart the SQL Server service as follows:

  1. Navigate to the Windows Services tool.

  2. Right-click SQL Server (MSSQLSERVER) and click Stop.

  3. Right-click SQL Server (MSSQLSERVER) and click Start.

Step 17

Ensure that the SQL Server Browser is started, as follows:

  1. Navigate to the Windows Services tool.

  2. Navigate to the SQL Server Browser.

  3. Right-click to open the Properties window.

  4. Enable the service, change the startup type to Automatic, and click Apply.

  5. To start the service, click Start, and then click OK.


Increase Database and Log File Size for TempDB

To get the benefits of TempDB multiple data files support in CCE components, configure the following values as suggested for respective components.

CCE Component vCPU TempDB Data Files TempDB Transaction Log File
Number of Files Initial Size Autogrowth Initial Size Autogrowth
Rogger 4 4 800MB 100MB 600MB 10MB
Logger 4 4 800MB 100MB 600MB 10MB
AW-HDS-DDS 4 4 800MB 100MB 600MB 10MB
AW-HDS 8 8 400MB 100MB 600MB 10MB
HDS-DDS 8 8 400MB 100MB 600MB 10MB

Set Users as System Administrators

Any users who are involved in installing or upgrading a Unified ICM/CCE solution must be added as part of SQL Server Security login and associated with the System Administrator role. Complete the following steps to set a user as a System Administrator:

Procedure

Step 1

Open the Microsoft SQL Server Management Studio using the System Administrator login credentials.

Step 2

In the Object Explorer pane, click the Security folder.

The Security folder expands.

Step 3

Right-click the Logins folder, and then click New Login.

The Login-New view appears.

Step 4

In the Login name field, enter the Domain login name of the user whom you want to associate with the System Administrator role.

Use the following format:

<domain>\<username>

Step 5

In the Object Explorer pane, click the Server Roles folder.

The Server Roles view appears.

Step 6

Check the sysadmin check box.

Note

 
This step is mandatory.

System administrator is a predefined fixed server-level role in the Microsoft SQL Server. The system administrator performs operations on a site-level. System administrators manage jobs, role definitions, and shared schedules that are used to run reports.

You must be a system administrator to create, modify, and delete individual records in the Configuration Manager tool.

For details about the sysadmin role, see the Microsoft SQL documentation.

Step 7

Click OK.

The user is now a part of the SQL Security login and is also associated with the System Administrator role.


Collation and Locale Settings for Localization

Microsoft SQL Server Collation Settings for Languages

You select a collation when you install Microsoft SQL Server, and it must be the collation that maps to the customer's language display.


Remember


If your initial collation selection is incorrect, you must uninstall Microsoft SQL Server and reinstall it with the correct collation configuration.


For the languages supported by Packaged CCE and the SQL Server Collation setting for each language, see the Contact Center Enterprise Compatibility Matrix at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-device-support-tables-list.html.

Windows System Locale

The Windows system locale must match the display language; otherwise some characters appear incorrectly in the user interface and are saved incorrectly to the database. For example, if the system locale is English and you are working in Spanish, characters such as the acute a appear incorrectly.

Perform this procedure at both CCE Roggers, both CCE PGs, both CCE AWs, and any external HDS systems.

  1. Open Control Panel > Clock, Language, and Region > Language.

  2. Add the required language in the Change your language preferences page.

  3. In the left pane, select Advanced settings.

  4. Select the language for the Override for Windows display language option.

  5. Select the language for the Override for default input method option.

  6. Save your work and restart the virtual machine.

Install VMware Tools

Use this procedure to install and upgrade VMware tools from the VMware vSphere Client.

To install or upgrade VOS for Cisco Finesse, Cisco Unified Intelligence Center, and Cisco Unified Communications Manager:

  1. Ensure that your virtual machine is powered on.

  2. Right-click the VM in the virtual machine menu. Select Guest > Install / Upgrade VMware tools

  3. Choose the automatic tools update and press OK.

The process takes a few minutes. When the process is complete, the tools are listed as Running (Current) on the VM's Summary tab in vSphere.

To install or upgrade VMs with Windows guest operating system:

  1. Ensure that your Windows virtual machine is powered on.

  2. Right click the VM in the virtual machine menu. Select Guest > Install / Upgrade VMware tools. Click OK on the popup window.

  3. Log in to the VM as a user with administrative privileges.

  4. Run VMware tools from the DVD drive.

    The installation wizard starts.

  5. Follow the prompts in the wizard to complete the VMware Tools installation. Choose the Typical installation option.

  6. When the VMware Tools installation has finished, restart the virtual machine for the changes to take effect.

When the process is complete, the tools are listed as Running (Current) on the VM's Summary tab in vSphere.

Add Machine to Domain

Procedure


Step 1

Navigate to Control Panel > System and Security > System.

Step 2

Click Change Settings.

Step 3

In the Computer Name tab, click Change.

Step 4

Change the name of the computer from the name randomly generated during Microsoft Windows Server installation. The name does not contain underscores or spaces.

Step 5

Select the Domain radio button to change the member from Workgroup to Domain.

Step 6

Enter qualified domain name and click OK.

Step 7

In the Windows Security dialog, enter the domain credentials and click OK.

Step 8

On successful authentication, click OK.

Step 9

Reboot the server and sign in with domain credentials.


Configure Network Adapters

The Unified CCE Rogger/Router and the Unified CCE PG each have two network adapters. You must identify them by MAC address and Network Label, rename them, configure them, and set the interface metric value.

Procedure


Step 1

Identify the MAC addresses and labels for the network adapters as follows:

  1. From vSphere, select and right-click the VM.

  2. Select Edit Settings. In the Hardware tab, click Network adapter 1. In the right panel, write down the last few digits of MAC addresses and note whether the label is PCCE Public or PCCE Private. For example, Network adapter 1 may have a MAC address that ends in 08:3b and the network label PCCE Public.

  3. Repeat for Network adapter 2, noting its MAC address and label.

  4. From the VM console, type ipconfig /all from the command line. This displays the adapter names and physical addresses.

  5. Note the adapter names and physical addresses and match them with the MAC addresses and labels that you noted in VMware. For example, in ipconfig/all, Local Area Connection 2 may have a physical address that ends in 08-3b.

  6. Match the MAC address of the network adapter that VMware identified as PCCE Public with the corresponding physical address of Local Area Connector. In this example, the physical address of Local Area Connection 2 (08-3b) matches the MAC address (08-3b) of Network adapter 1. This means that Local Area Connection 2 is PCCE Public.

    Note

     

    Adapters may have a different name than Local Area Connection.

Step 2

Locate and rename the network adapters in Windows as follows:

  1. In Windows, open the Control Panel > Network and Sharing Center and click Change adapter settings.

  2. Right-click Local Area Connection and select Rename. Rename it to PCCE Public or PCCE Private, based on the matching you did above.

  3. Right-click Local Area Connection 2 and select Rename. Rename it to PCCE Public or PCCE Private, based on the matching you did above. In the example above, Local Area Connection 2 is renamed to PCCE Public.

Step 3

Set the Properties for PCCE Public as follows:

  1. Right-click PCCE Public and select Properties.

  2. In the Networking tab, uncheck Internet Protocol Version 6 (TCP/IPv6).

  3. Select Internet Protocol Version 4 (TCP/IPv4) and click Properties.

  4. In the General tab for Internet Protocol Version 4, select Use the following IP address and enter IP address, Subnet mask, Default gateway, and DNS servers.

  5. Click OK and Close to exit.

Step 4

Set the Properties for PCCE Private as follows:

  1. Right-click PCCE Private and select Properties.

  2. In the Networking tab, uncheck Internet Protocol Version 6 (TCP/IPv6).

  3. Select Internet Protocol Version 4 (TCP/IPv4) and click Properties.

  4. In the General tab for Internet Protocol Version 4, select Use the following IP address and enter IP address and Subnet mask.

  5. Click Advanced.

  6. Click the DNS tab and uncheck Register this connection's addresses in DNS.

  7. In the DNS server, add a new A record that resolves to the private IP address. Also, create an associated pointer record for reverse lookups.

    Note

     

    For hostnames in A records, append the letter p to indicate that it is a private address.

  8. Click OK to exit.

Step 5

Assign an interface metric value for the network adapter:

  1. Select the network adapter and right-click Properties.

  2. In the Networking tab, select the appropriate Internet Protocol version and click Properties.

  3. In the Internet Protocol Version Properties dialog box, click Advanced.

  4. In the IP Settings tab, uncheck the Automatic metric checkbox and type a low value in the Interface metric text box.

    Note

     

    A low value indicates a higher priority. Make sure that the Public Network card should have a lower value compared to the Private Network card.

    By default, the value of the Interface Metric property for a network adapter is automatically assigned and is based on the link speed.

  5. Click OK to save the settings.

    Repeat the steps to assign an interface metric value for the internal/private cluster communication network adapter.


Configure Network Adapter for Unified CCE AW-HDS-DDS, AW-HDS, HDS-DDS

Procedure


Step 1

Locate and rename the network adapter in Windows as follows:

  1. In Windows, open the Network and Sharing Center and click Change Adapter Settings .

  2. Right-click Local Area Connection and select Rename. Rename it to UCCE Public.

Step 2

Set the Properties for UCCE Public as follows:

  1. Right-click UCCE Public and select Properties.

  2. In the Networking dialog box, uncheck Internet Protocol Version 6 (TCP/IPv6).

  3. In the Networking dialog box, select Internet Protocol Version 4 (TCP/IPv4) and select Properties.

  4. In the General dialog box for Internet Protocol Version 4, select Use the following IP address and enter the IP address, the Subnet mask, the default gateway, and DNS servers.

  5. Click OK and Close to exit.


Set Persistent Static Routes

For geographically distributed Central Controller sites, redundant Rogger, and Peripheral Gateway components typically have a Private IP WAN connection between Side A and Side B. Windows only allows one default gateway for each VM (which sends the Private Network traffic to the Public Network). So, you add a Static Route to all the VMs running the Rogger, and PG applications.

For geographically distributed Central Controller sites, redundant Rogger, logger, router, and Peripheral Gateway components typically have a Private IP WAN connection between Side A and Side B. Windows only allows one default gateway for each VM (which sends the Private Network traffic to the Public Network). So, you add a Static Route to all the VMs running the Rogger, logger, router, and PG applications.

To create a persistent static route with the route add command, you need the destination subnet, the subnet mask, the local gateway IP, and the interface number of the local Private Network interface:

route add <destination subnet> mask <subnet mask> <gateway IP> IF <interface number> -p

You must launch the DOS prompt as an administrator to run the commands in this procedure.

Procedure


Step 1

On each Rogger, or PG VM, run ipconfig /all.

Record the IPv4 Address, Subnet Mask, and Physical Address (MAC address) for the Private Network interface.

Step 2

On each of these VMs, run route print –4.

Record the Interface for the Private Network. You can identify the correct interface by looking for its Physical Address (MAC address).

Step 3

On each of these VMs, run route add <destination subnet> mask <subnet mask> <gateway IP> IF <interface number> -p to add a persistent static route for the remote Private Network.

On Side A VMs, use the gateway IP for Side B. On Side B VMs, use the gateway IP for Side A.


Run Windows Updates

Procedure


Go to Settings > Update & Security and run Microsoft Windows Update.

After the update is complete, click Do not enable automatic updates.


Install Cisco Unified Contact Center Enterprise

Install the Unified Contact Center Release 12.0 software on your Unified CCE virtual machines.


Note


Before installing 12.5(1) ICM on SQL Server , make sure to install ODBC Driver 13 for SQL Server® manually.


Procedure


Step 1

Login as a user with administrative privileges.

Step 2

Mount the Cisco Unified CCE ISO image to the virtual machine. See Mount ISO Files.

Step 3

Run setup.exe from the D:\ICM-­CCE Installer directory.

Step 4

Follow the InstallShield procedures to install Cisco Unified CCE.

Step 5

When the installation completes, restart the computer when prompted.

Step 6

Before applying any ES, you must run the mandatory update for Packaged CCE, if a fresh install is being performed on Windows Server 2016. You can download the CCE 12.0 Mandatory Update for Fresh Install/Tech Refresh from https://software.cisco.com/download/home/268439622/type/280840583/release/12.0(1).

Step 7

Unmount the ISO image.


Configure Permissions in the Local Machine

In this release,Unified CCE defaults to providing user privileges by memberships to local user groups on local machines. This technique moves authorization out of Active Directory. However, it requires a one-time task on each local machine to grant the required permissions.


Note


You can use the ADSecurityGroupUpdate registry key to choose between the new default behavior and the previous behavior. For more information, see the chapter on solution security in the Solution Design Guide.


Before using the Configuration Manager tool, configure the required registry and folder permissions for the UcceConfig group.

Configure Registry Permissions

This procedure only applies to distributor machines. Grant the required registry permissions for the UcceConfig group on the local machine.
Procedure

Step 1

Run the regedit.exe utility.

Step 2

Select HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\ICM.

Step 3

Right-click and select Permissions.

Step 4

If necessary, add UcceConfig in Group or user names.

Step 5

Select UcceConfig and check Allow for the Full Control option.

Step 6

Click OK to save the change.

Step 7

Repeat the previous steps to grant Full Control to the UcceConfig group for HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Cisco Systems, Inc.\ICM.

Step 8

Repeat the previous steps to grant Full Control to the UcceConfig group for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WinSock2.

Note

 
If you have configured the Unified CCE Administration Client, open Local security policy and go to User Rights Assignment. Right click Create Global Object. Go to properties and add the local Group UcceConfig.

Configure AW-HDS Database Permissions

Follow this procedure to grant access to the AWDB-HDS database to UcceConfig group members.
Procedure

In SQL Management Studio, do the following:

  1. Go to Security > Logins.

  2. Locate <Machine name>\UcceConfig. Right-click and select properties.

  3. Go to User Mappings and select one AWDB database. Ensure that GeoTelAdmin, GeoTelGroup, and public are selected.

  4. Repeat step c for the HDS database.


Configure Folder Permissions

Grant the required folder permissions to the UcceConfig group on the local machine.

Procedure

Step 1

In Windows Explorer, select <ICM install directory>\icm.

Step 2

Right-click and select Properties.

Step 3

On the Security tab, select UcceConfig and check Allow for the Full Control option.

Step 4

Click OK to save the change.

Step 5

Repeat the previous steps to grant Full Control to the UcceConfig group for <SystemDrive>:\temp.


Create Outbound Option Database

Outbound Option uses its own SQL database on the Logger. Perform the following procedure on the Side A Logger only.

Procedure


Step 1

Open the ICMDBA tool and click Yes to any warnings.

Step 2

Navigate to Servers > <Logger Server> > Instances > <Unified CCE instance> > LoggerA. Right-click the instance name and select Database > Create.

Step 3

On the Stop Server message, click Yes to stop the services.

Step 4

In the Create Database dialog box, click Add to open the Add Device dialog box.

Step 5

Click Data, and choose the drive on which you want to create the database, for example, the E drive. In the database size field, you can choose to retain the default value or enter a required value.

Step 6

Click OK to return to the Create Database dialog box.

Step 7

In the Add Device dialog box, click Log. Choose the desired drive. Retain the default value in the log size field and click OK to return to the Create Database dialog box.

Step 8

In the Create Database dialog box, click Create, and then click Start. When you see the successful creation message, click OK and then click Close.

For more information about configuring Outbound Options, see the Outbound Option Guide for Unified Contact Center Enterprise guide at https://www.cisco.com/c/en/us/support/customer-collaboration/unified-contact-center-enterprise/products-user-guide-list.html


Configure Network Adapters for Cisco Unified CVP

Unified CVP has only one network adapter to configure. You must rename it and set its properties.

Procedure


Step 1

Navigate to Control Panel > Network and Internet .

Step 2

Click Network and Sharing Center, and then click Change adapter settings in the left panel.

Step 3

Right-click the adapter and select Rename. Change the name to UCCE Public.

Step 4

Right-click UCCE Public and select Properties.

Step 5

In the Networking dialog box, de-select Internet Protocol Version 6 (TCP/IPv6).

Step 6

In the Networking dialog box, select Internet Protocol Version 4 (TCP/IPv4) and select Properties.

Step 7

In the General dialog box for Internet Protocol Version 4 , select Use the following IP address and enter the IP address, the Subnet mask, the default gateway and DNS servers.

Step 8

Click OK and Close to exit.


Install Cisco Unified CVP Server

Procedure


Step 1

Log in to your system as a user with administrative privileges.

Step 2

Mount the Unified CVP ISO image to the virtual machine. For more information, see Mount ISO Files.

Step 3

Run setup.exe from the D:\ CVP\Installer_Windows directory.

Step 4

Follow the InstallShield wizard to Run setup.exe from the D:\CVP\Installer_Windows directory:

  1. Accept the license agreement.

  2. In the Select Packages screen, check the type you are adding.

  3. Click Next.

  4. On the Voice Prompt Encode Format screen, select the codec according to your requirement.

  5. In the Choose Destination Location screen, accept the default. Click Next.

  6. In the X.509 certificate screen, enter the information that you want to include in the certificate.

  7. In the Ready to Install screen, click Install.

  8. Select the option to restart the computer after installation. Click Finish.

Step 5

If Unified CVP Engineering Specials are available, copy them to the local drive. Follow the InstallShield wizard to install them.

Step 6

Unmount the ISO image.


Unified Customer Voice Portal Licenses

Generate a License
Before you begin

Access the product authorization key (PAK) that you received with the Unified CVP software.

Procedure

Step 1

Sign in to the Product License Registration Portal at https://tools.cisco.com/SWIFT/LicensingUI/Home.

Step 2

Click Continue to Product License Registration.

Step 3

In the Get New Licenses field, enter your PAK.

You can enter up to 10 PAKs, separated by commas.

Step 4

Click Fulfill.

Step 5

Select your features and enter the quantity.

Step 6

In the Serial Number field, enter the following:

  • For a Unified CVP Server or Unified CVP Reporting Server, enter the IP address.
  • For Unified Call Studio, enter the MAC address.

Step 7

Click Next.

Step 8

Accept the terms of the License Agreement, enter your Recipient Information, and click Submit.

Your request is processed.

Step 9

Click Download to download your license.

Your license is also sent to you by email.

What to do next

Ensure that the license file is named as cvp.license.

Copy the license file to C:\Cisco\CVP\conf\license. Shut down gracefully and then restart each of the Call Server components for the new license to take effect.

Setup Unified CVP Media Server IIS

Procedure


Step 1

Navigate to Start > Administrative Tools.

Step 2

Choose Server Manager option navigate to Manage > Add Roles and Features.

Step 3

Goto Installation Type tab, choose Role based or featue based installation option and click Next.

Step 4

On Server Selection window, select server from the list and click Next.

Step 5

Check Web Sever(IIS) check box to enable IIS and click Next.

Step 6

No additional features are necessary to install Web Adaptor, click Next.

Displays Web Server Role(IIS) tab.

Step 7

Click Next.

Displays Select Role Services tab.

Step 8

Ensure that the web server components listed below are enabled.

  • Web Server

    • Common HTTP Features

      • Default Document

      • Static Content

    • Security

      • Request Filtering

      • Basic Authentication

      • Windows Authentication

    • Application development

      • .NET Extensibility 4.5

      • ASP.NET 4.5

      • ISAPI Extensions

      • ISAPI Filters

  • Management Tools

    • IIS Management Console

    • IIS Management Compatibility

      • IIS6 Metabase Compatibility

    • IIS Management Scripts and tools

    • Management Service

Step 9

Click Next.

Step 10

Ensure that your settings are correct and click Install.

Step 11

After installation click Close.


Install FTP Server

Procedure


Step 1

Select Start > Administrative Tools.

Step 2

Select Server Manager and click Manage.

Step 3

Select Add Roles and Features and click Next.

Step 4

In the Installation Type tab, select Role-based or feature-based Installation and click Next.

Step 5

Select required server from the list and click Next.

Step 6

On the Server Roles page, expand Web Server (IIS).

Step 7

Check FTP Server and click Next.

Step 8

On the Features page, click Next.

Step 9

On the Configuration page, click Install.


Enable FTP Server

Procedure


Step 1

Go to Start > Programs > Administrative Tools> Server Manager.

Step 2

Expand Roles in the left panel of the Server Manager window.

Step 3

Expand Web Server (IIS) and select Internet Information Services (IIS) Manager.

Step 4

In the Connections panel:

  1. Expand the CVP server to which you are adding the FTP site.

  2. Right-click on Site and choose Add FTP Site.

Step 5

Enter the FTP Site Name.

Step 6

From the Physical Path field, browse to C:\Inetpub\wwwroot and click Next.

Step 7

Choose IP Address of CVP from the drop-down list.

Step 8

Enter the port number.

Step 9

Select the No SSL check box and click Next.

Step 10

Select the Anonymus and Basic check boxes in Authentication panel.

Step 11

Choose All Users from Allow Access To from the drop-down list.

Step 12

Select the Read and Write check box and click Finish.


Install Cisco Unified CVP Reporting Server

This task is required for the installation of the optional Unified CVP Reporting server.

The IBM Informix database server is installed as part of the Unified CVP Reporting Server.

Before installing the Unified CVP Reporting Server, you must configure a database drive.

Complete the following procedure to install the Unified CVP Reporting server:

Procedure


Step 1

Log in to your system as a user with administrative privileges.

Step 2

Mount the Unified CVP ISO image to the virtual machine. For more information, see Mount ISO Files.

Step 3

Run setup.exe from the DVD drive located at the CVP\Installer_Windows directory.

Step 4

Follow the InstallShield wizard to Run setup.exe from the D:\CVP\Installer_Windows directory:

  1. Accept the license agreement.

  2. In the Select Packages screen, check Reporting Server.

  3. In the Choose Destination Folder screen, select the folder location for the CVP installation folder.

  4. In the X.509 certificate screen, enter the information that you want to include in the certificate.

  5. In the Choose the database data and backup drive screen, enter the drive letter (typically, E).

  6. In the Database size selection screen, select Premium (438 GB).

  7. In the Ready to Install screen, click Install.

  8. Enter the Reporting Server password when prompted.

  9. Select the option to restart the computer after installation. Click Finish.

Step 5

If Unified CVP Engineering Specials are available, copy them to the local drive. Follow the InstallShield wizard to install them.

Step 6

Unmount the ISO image.


What to do next

Repeat this procedure if your deployment requires a second, external Unified CVP Reporting Server.

Ensure that you generate a license file and add the license file to C:\Cisco\CVP\conf\license. For more information, see Generate a License. Shut down and then start each of the CVP Reporting Servers for the new license to take effect.

You may see the following error:
CVP_12_0_Infrastructure-2-LICENSING: Evaluation license already expired on 

Manually rename license file and extension to cvp.license.

Ensure you place it in the C:\Cisco\CVP\conf\license filepath.

Install Publishers/Primary Nodes of VOS-Based Contact Center Applications

This task is required for the publisher/primary nodes of the three VOS-based contact center applications: Cisco Finesse, Cisco Unified Communications Manager, and Cisco Unified Intelligence Center.

Before you begin

DNS Configuration is mandatory for installation of Cisco Unified Communications Manager, Cisco Unified Intelligence Center, Cisco Finesse and Cisco Identity Service (IdS). To configure DNS, add the VMs to the forward and reverse lookups of the DNS.

Procedure


Step 1

Create a virtual machine for your VOS-based contact center application using the OVA.

Step 2

Mount the ISO image for the software to the virtual machine.

Step 3

Select the virtual machine, power it on, and open the console.

Step 4

Follow the Install wizard, making selections as follows:

  1. In the Disk Found screen, click OK to begin the verification of the media integrity.

  2. In the Success screen, select OK.

  3. In the Product Deployment Selection screen:

    • If you are installing Finesse or Unified Communications Manager, select OK.

    • If you are installing Unified Intelligence Center, select Cisco Unified Intelligence Center with Live Data and IdS, and then select OK. The Cisco Unified Intelligence Center with Live Data and IdS option installs Cisco Unified Intelligence Center with Live Data, and Cisco Identity Service (IdS) on the same server.

  4. In the Proceed with Install screen, select Yes.

  5. In the Platform Installation Wizard screen, select Proceed.

  6. In the Apply Patch screen, select No.

    Finesse does not have this step.

  7. In the Basic Install screen, select Continue.

  8. In the Timezone Configuration screen, use the down arrow to choose the local time zone that most closely matches where your server is located. Select OK.

    Note

     

    For Live Data servers, use the same timezone for all the nodes.

  9. In the Auto Negotiation Configuration screen, select Continue.

  10. In the MTU Configuration screen, select No to keep the default setting for Maximum Transmission Units.

  11. In the DHCP Configuration screen, select No.

    Finesse does not have this step.

  12. In the Static Network Configuration screen, enter static configuration values. Select OK.

  13. In the DNS Client Configuration screen, click Yes to enable DNS client.

  14. Enter your DNS client configuration. Select OK.

    Important

     

    DNS client configuration is mandatory for Finesse. If you do not perform this step, agents cannot sign in to the desktop and you must reinstall Finesse.

  15. In the Administrator Login Configuration screen, enter the Platform administration username. Enter and confirm the password for the administrator. Select OK.

  16. In the Certificate Information screen, enter data to create your Certificate Signing Request: Organization, Unit, Location, State, and Country. Select OK.

  17. In the First Node Configuration screen, select Yes.

  18. In the Network Time Protocol Client Configuration screen, enter a valid NTP server IP address and select OK.

    Important

     

    Proper NTP configuration is essential.

  19. In the Security Configuration screen, enter the security password and select OK.

  20. In the SMTP Host Configuration screen, select No.

    Finesse does not have this step.

  21. Unified Communications Manager only: On the Smart Call Home Enable screen, select Disable All Call Home on System Start.

  22. In the Application User Configuration screen, enter the application username. Enter, and confirm the application user password. Select OK.

  23. In the Platform Configuration Confirmation screen, select OK. The installation begins and runs unattended.

    • There is a reboot in the middle of the installation.

    • The installation ends at a sign-in prompt.

Step 5

Unmount the ISO image.

Note

 

After successful installation of Cisco Unified Intelligence Center, import the stock templates.


Configure the Cluster for Cisco Unified Intelligence Center

Procedure


Step 1

Direct a browser to the URL https://<hostmame>:8443/oamp, where <hostname> is the hostname of your Cisco Unified Intelligence Center publisher.

Step 2

Sign in using the system application user ID and password that you defined during installation.

Step 3

From the section in the left, select Device Configuration.

Step 4

Click Add Member.

Step 5

On the Device Configuration fields for the Subscriber, enter a name, the hostname or IP address , and a description for the device.

Note

 

All CUIC Subscribers must be entered here before you can install the software.

Step 6

After you complete the cluster configuration, restart the publisher.

Note

 

For 2000 Agents deployment, the system updates the Live Data failover settings.


Unified Communications Manager License


Note


From Release 12.0 onwards, Cisco Smart Licensing replaces Cisco Prime License Manager. To use Cisco Smart Licensing, create and configure a Smart Account before you upgrade or migrate the Unified Communications Manager server. For more information, see Licensing section in Installation Guide for Cisco Unified Communications Manager and IM and Presence Service, at https://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/products-installation-guides-list.html.


Generate and Register License

Procedure

Step 1

Launch Unified Communications Manager in a browser (https://<IP Address of Unified CM Publisher>).

Step 2

Click Cisco Prime License Manager and navigate to Licenses > Fulfillment.

Step 3

Under Other Fulfillment options, click Generate License Request.

Step 4

When the License Request and Next Steps window opens, copy the text (PAK ID).

Step 5

Click the Cisco License Registration link.

Step 6

Sign in and click Continue to Product License Registration.

Step 7

In the Enter a Single PAK or Token to fulfill field, paste your PAK ID and click Fulfill Single PAK/Token.

You receive the license file in an email message.


Install License

Procedure

Step 1

Unzip the license file from the email message.

Step 2

Under Other Fulfillment Options, select Fulfill Licenses from File.

Step 3

Click Browse and locate your license file.

Step 4

Click Install and close the popup window.

Step 5

Navigate to Product Instances. Then click Add.

Step 6

Fill in the name, hostname/IP address, username, and password for your Cisco Unified Communications Manager Publisher.

Step 7

Select Product type of Unified CM.

Step 8

Click OK.

Step 9

Click Synchronize Now.


Configure the Cluster for Cisco Unified Communications Manager

Procedure


Step 1

Launch Unified Communications Manager Publisher in a browser (https://<IP Addr of CUCM Publisher>/ccmadmin ).

Step 2

Select System > Server > Add New.

Step 3

On the Server Configuration page, select CUCM Voice/Video for the Server Type. Click Next.

Step 4

On the Server Configuration page, enter the IP Address of the subscriber.

Step 5

Click Save.


Create a Unified Communications Manager AXL User Account

Create a Unified Communications Manager AXL user in Unified Communications Manager Administration. First create an Access Control Group with Standard AXL API Access, and then create an Application User with permission for that Access Control Group.

Procedure


Step 1

Launch Unified Communications Manager Administration in a browser (https://<IP Address of Unified Communications Manager Publisher>/ccmadmin ).

Step 2

Create an Access Control Group, as follows:

  1. Navigate to User Management > User Settings > Access Control Group.

  2. Click Add New.

  3. Enter a name for the Access Control Group.

  4. Click Save.

    The Access Control Group Configuration page opens.

  5. From the Related Links drop-down menu, select Assign Role to Access Control Group and click Go.

  6. Click Assign Role to Group.

    The Find and List Roles popup window opens.

  7. Click Find.

  8. Check the Standard AXL API Access check box.

  9. Click Add Selected.

  10. Click Save.

Step 3

Create an Application User, as follows:

  1. Navigate to User Management > Application User.

  2. Click Add New.

  3. Enter a name and password for the Application User.

  4. In the Permissions Information section, click Add to Access Control Group.

    The Find and List Access Control Group popup window opens.

  5. Click Find.

  6. Check the check box for the Access Control Group you created.

  7. Click Add Selected.

  8. Click Save.


Configure the Cluster for Cisco Finesse

Procedure


Step 1

Launch the Cisco Finesse primary node in a browser (https://<FQDN of Finesse Primary node>/cfadmin).

If you are using an IPv6 client, you must include the port number in the URL (https://<FQDN of Finesse Primary node>:8445/cfadmin).

Step 2

Go to Home > Cluster Settings. (This path is based on the default configuration and assumes that you have not changed the page for the Cluster Settings gadget.)

Step 3

Add the hostname for the Cisco Finesse secondary node.

Step 4

Click Save.

Step 5

Restart Cisco Finesse Tomcat as follows:

  1. To stop the Cisco Finesse Tomcat service, enter this CLI command: utils service stop Cisco Finesse Tomcat .

  2. To start the Cisco Finesse Tomcat service, enter this CLI command: utils service start Cisco Finesse Tomcat .


Install Subscribers/Secondary Nodes of VOS-Based Contact Center Applications


Note


This task is required for installation of the subscriber/secondary nodes of the three VOS-based contact center applications: Cisco Finesse, Cisco Unified Communications Manager, and Cisco Unified Intelligence Center.


Before you begin

DNS Configuration is mandatory for installation of Cisco Unified Communications Manager, Cisco Unified Intelligence Center, and Cisco Finesse. To configure DNS, add the VMs to the forward and reverse lookups of the DNS.

Before you install the subscriber/secondary nodes, you must install the publisher/primary nodes and configure the clusters.

Procedure


Step 1

Create a virtual machine for your VOS-based contact center application using the OVA.

Step 2

Mount the ISO image for the software to the virtual machine.

Step 3

Select the virtual machine and power it on, and open the console.

Step 4

Follow the Install wizard, making selections as follows:

  1. In the Disk Found screen, click OK to begin the verification of the media integrity.

  2. In the Success screen, select OK.

  3. In the Product Deployment Selection screen:

    • If you are installing Finesse or Unified Communications Manager, select OK.

    • If you are installing Unified Intelligence Center, select Cisco Unified Intelligence Center with Live Data and IdS, and then select OK. The Cisco Unified Intelligence Center with Live Data and IdS option installs Cisco Unified Intelligence Center, Live Data, and Cisco Identity Service (IdS) on the same server.

Step 5

Follow the Install wizard, making selections as follows:

  1. In the Proceed with Install screen, select Yes.

  2. In the Platform Installation Wizard screen, select Proceed.

  3. In the Apply Patch screen, select No.

    Finesse does not have this step.

  4. In the Basic Install screen, select Continue.

  5. In the Timezone Configuration screen, use the down arrow to choose the local time zone that most closely matches where your server is located. Select OK.

    Note

     

    For Live Data servers, use the same timezone for all the nodes.

  6. In the Auto Negotiation Configuration screen, select Continue.

  7. In the MTU Configuration screen, select No to keep the default setting for Maximum Transmission Units.

  8. In the DHCP Configuration screen, select No.

    Finesse does not have this step.

  9. In the Static Network Configuration screen, enter static configuration values. Select OK.

  10. In the DNS Client Configuration screen, click Yes to enable DNS client.

    Important

     

    DNS client configuration is mandatory for Finesse. If you do not perform this step, agents cannot sign in to the desktop and you must reinstall Finesse.

  11. In the Administrator Login Configuration screen, enter the Platform administration username. Enter and confirm the password for the administrator. Select OK.

  12. In the Certificate Information screen, enter data to create your Certificate Signing Request: Organization, Unit, Location, State, and Country. Select OK.

  13. In the First Node Configuration screen, select No.

  14. In the warning screen, select OK.

  15. In the Network Connectivity Test Configuration screen, select No.

  16. In the First Node Access Configuration screen, enter the host name and IP address of the first node. Enter and confirm the security password. Select OK.

  17. In the SMTP Host Configuration screen, select No.

    Finesse does not have this step.

  18. In the Platform Configuration Confirmation screen, select OK. The installation begins and runs unattended.

    • There is a reboot in the middle of the installation.

    • For Cisco Unified Intelligence Center, you see a Product Licensing screen that shows the URL for obtaining the license and the Media Access Control (MAC) address. Write down the MAC address. You need this information for the license application.

    • The installation ends at a sign-in prompt.

Step 6

Unmount the ISO image.


Activate Services

Complete the following procedure to activate services.

Procedure


Step 1

Open Cisco Unified CM Administration at https://<IP Address of the CUCM Publisher>/ccmadmin.

Step 2

Select Cisco Unified Serviceability from the Navigation menu and click Go.

Step 3

Select Tools > Service Activation.

Step 4

From the Server drop-down list, choose the server on which you want to activate the service, and then click Go.

Step 5

For the Publisher, check the following services to activate and click Save:

  • Cisco CallManager

  • Cisco IP Voice Media Streaming App

  • Cisco CTIManager

  • Cisco Tftp

  • Cisco Bulk Provisioning Service

  • Cisco AXL Web Service

  • Cisco Serviceability Reporter

  • Cisco CTL Provider

  • Cisco Certificate Authority Proxy Function

  • Cisco Dialed Number Analyzer Server

Step 6

For the Subscribers, check the follow services to activate and click Save:

  • Cisco CallManager

  • Cisco IP Voice Media Streaming App

  • Cisco CTIManager

  • Cisco AXL Web Service

  • Cisco CTL Provider

  • Cisco Dialed Number Analyzer Server


Install the External HDS

Install and Configure the External HDS

The default deployment pulls data from the on-box AW-HDS-DDS database on the Unified CCE AW-HDS-DDS, where Real-time, Historical and Call Detail Data are stored.

If you need a longer retention period, you can optionally install the Administration Server, Real Time and Historical Data Server, Detail Data Server (AW-HDS-DDS) on a maximum of two separate, external servers. Each external server is configured as Central Controller Side A Preferred or Central Controller Side B Preferred.

For more information about retention, see the Solution Design Guide for Cisco Packaged Contact Center Enterprise at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-technical-reference-list.html.


Important


The External HDS (AW-HDS-DDS) must be able to connect to the Packaged CCE Side A and Side B ESXi hosts.


Refer to the Virtualization for Cisco Packaged CCE at https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/uc_system/virtualization/pcce_virt_index.html for external HDS server requirements.

Follow this sequence of tasks to install an external HDS.

Sequence

Task

1

Install Microsoft Windows Server

2 Install Antivirus Software
3

Install Microsoft SQL Server

4 Install Cisco Unified Contact Center Enterprise
5 Configure SQL Server for CCE Components. Refer the Cisco Packaged Contact Center Enterprise Administration and Configuration Guide at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-maintenance-guides-list.html.
6

Configure the database drive for the amount of data you want to keep. See Configure Database Drive

7

Create an HDS Database for the External HDS

8

Configure the External HDS

9

Configure Unified Intelligence Center SQL User Account on the External HDS

10

Configure Unified Intelligence Center Data Sources for External HDS.

Refer the Cisco Packaged Contact Center Enterprise Administration and Configuration Guide at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-maintenance-guides-list.html.

11

If you have an IPv6 enabled deployment, configure a Forward lookup AAAA record for the External HDS in DNS. Refer the Configure DNS for IPv6 section in the Cisco Packaged Contact Center Enterprise Administration and Configuration Guide at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-maintenance-guides-list.html.

Create an HDS Database for the External HDS

Create the HDS database using ICMDBA.

Procedure

Step 1

Open Unified CCE Tools > ICMdba.

Note

 

You must add instances to display in the ICMDBA. For more information, see Add a UCCE Instance.

Step 2

Expand the instance tree view on the newly added external HDS until you can see your instance.

Step 3

Right click on the instance and select Create.

Step 4

In the Select component drop-down list, select Administration & Data Server and click OK.

Step 5

In the Select AW type drop-down list, select Enterprise and click OK.

Step 6

From the menu, select Database > Create. Click Add.

Step 7

Click the Data radio button, select the second disk drive, and enter the desired HDS size. Click OK.

Step 8

Click the Log radio button, select the second disk drive, and enter the desired log size. Click OK.

Step 9

Click Create.


Configure the External HDS

Procedure

Step 1

Open Unified CCE Web Setup.

Step 2

Choose Component Management > Administration & Data Servers. Click Add.

Step 3

On the Deployment page, configure as follows:

Step 4

On the Add Administration & Data Servers page, configure as follows:

  1. Choose the current instance.

  2. Choose the deployment type as Enterprise.

  3. Choose the deployment size as Small to Medium.

  4. Click Next.

Step 5

On the Role page, in the Server Role in a Small to Medium Deployment section, select the Administration Server, Real-time and Historical Data Server and Detail Data Server (AW-HDS-DDS) option.

Step 6

On the Administration & Data Servers Connectivity page:

  1. Click the radio button for Primary Administration & Data Server.

  2. In the *Secondary Administration & Data Server field, enter the hostname for the server.

  3. In the *Primary Administration & Data Server field, enter the hostname for the server.

  4. In the *Primary/Secondary Pair (Site) Name field, enter CCE-AW-1 for the first External HDS or CCE-AW-2 for the second External HDS.

  5. Click Next.

Step 7

On the Database and Options page, configure as follows:

  1. In the Create Database(s) on Drive field, choose C.

  2. DO NOT click the Agent Re-skilling web tool. Packaged CCE does not support this tool. Supervisors reskill agents using the Agent tool in Unified CCE Administration.

  3. Click Internet script editor.

  4. Click Next.

Step 8

On the Central Controller Connectivity page, configure as follows:

  1. For Router Side A, enter the IP Address of the Unified CCE Rogger A.

  2. For Router Side B, enter the IP Address of the Unified CCE Rogger B.

  3. For Logger Side A, enter the IP Address of the Unified CCE Rogger A.

  4. For Logger Side B, enter the IP Address of the Unified CCE Rogger B.

  5. Enter the Central Controller Domain Name.

  6. Click Central Controller Side A Preferred or Central Controller Side B Preferred .

  7. Click Next.

Note

 

The Administration & Data Server can connect to the central controller with a hostname of maximum 15 characters.

Step 9

Review the Summary page, and then click Finish.


Configure Unified Intelligence Center SQL User Account on the External HDS

Procedure

Step 1

Launch Microsoft SQL Server Management Studio .

Step 2

Navigate to Security >Logins, right-click Logins and select New Login.

This login is used when you configure the data sources for Cisco Unified Intelligence Center reporting.

Step 3

On the General Screen:

  1. Enter the Login Name.

  2. Select SQL Server authentication.

  3. Enter and confirm the Password.

  4. Uncheck Enforce password policy.

Step 4

Click User Mapping.

  1. Check the databases associated with the AWdb.

  2. Choose each database and associate it with the db_datareader and public role, and click OK.

Step 5

Click OK.


Add a UCCE Instance

Procedure


Step 1

Launch Web Setup in the VM you want installed or upgraded.

Step 2

Sign in as a domain user with local administrator permission.

Step 3

Click Instance Management and then click Add.

Step 4

In the Add Instance dialog box, choose the customer facility and instance.

Step 5

In the Instance Number field, enter 0.

Step 6

Click Save.


Set Live Data Secondary Node

Use the set live-data secondary command to provide the primary node the address of the secondary node.

Procedure


Step 1

Log in to your primary Live Data node.

Step 2

Run the following command to set the secondary node:

set live-data secondary name

name
Specifies the hostname or IP address of the Live Data secondary node.

Set IdS Subscriber Node

You must provide the publisher node the address of the subscriber node. You do this with the set ids subscriber command.

Procedure


Step 1

Log in to your publisher IdS node.

Step 2

Run the following command to set the subscriber node:

set ids subscriber name

name
Specifies the hostname or ip address of the IdS subscriber node address.

What to do next

You can use these Cisco IdS CLI commands only in an IdS standalone deployment. You run these commands on the IdS publisher node.

Required Minimum Privilege Level: Ordinary

Use this command to show IdS subscriber node information.

show ids subscriber

There are no required parameters.

Required Minimum Privilege Level: Advanced

Use this command to unset IdS subscriber node configuration.

unset ids subscriber

There are no required parameters.

Install Enterprise Chat and Email

Enterprise Chat and Email (ECE) is an optional feature that provides chat and email functionality to the contact center. In Packaged CCE 2000 Agents deployment, you can deploy ECE Data Servers on-box for up to 400 agents. Deploy ECE off-box for up to 1500 agents. You can also deploy the ECE Data Servers on a separate server.


Note


Packaged CCE requires that the Context Root Name is set to system while installing ECE. Setting Context Root Name to any name other than system will result in integration failure between Packaged CCE and ECE. Context Root Name can only be set while installing ECE, reinstalling ECE is required to change it.


Deploy the ECE Web Server on an external server. You can place that server either in the same data center as the ECE Data Server or in a DMZ if customer chat interactions require that.

Use OVA file to create a virtual machine for an on-box ECE. For information about creating a virtual machine, see Create a Virtual Machine from the OVA.

ECE 12.0 doesn’t support the archive database. While upgrading from ECE 11.6 to 12.0 in a PCCE 2000 agent deployment, if you choose to refer to the old archive database, keep a copy of the archive database off the PCCE box. For more information, see the Planning Database Upgrade from SQL 2014 to SQL 2016 section in the Enterprise Chat and Email Installation Guide (for Packaged Contact Center Enterprise) at https://www.cisco.com/c/en/us/support/customer-collaboration/cisco-enterprise-chat-email/products-installation-guides-list.html.

For capacity information, see the Solution Design Guide for Cisco Packaged Contact Center Enterprise, available at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-technical-reference-list.html.

Install Cisco Virtualized Voice Browser

Cisco Virtualized Voice Browser (Cisco VVB) provides a platform for interpreting VXML documents. Cisco VVB serves as an alternative to the use of IOS Voice Browsers (VXML gateways). When an incoming call arrives at the contact center, Cisco VVB allocates a VXML port that represents the VoIP endpoint. Cisco VVB sends HTTP requests to the Unified CVP VXML server. The Unified CVP VXML server runs the request and sends back a dynamically generated VXML document.

Cisco VVB is installed off box. Installation and configuration procedures are documented in the Installation and Upgrade Guide for Cisco Virtualized Voice Browser at https://www.cisco.com/c/en/us/support/customer-collaboration/virtualized-voice-browser/products-installation-guides-list.html.

Install the Language Pack

If a customer requires a language other than the default (English), download the Packaged CCE Language Pack executable from the Unified Contact Center Download Software page.

Install Language Pack

Install the Language Pack on the AW machine and on any External HDS servers after upgrading them.

After you install the Language Pack, the Unified CCE Administration Sign In page has a language drop-down menu that lists all available languages. Select a language to display the user interface and the online help in that language.

Uninstall Language Pack

You can uninstall the Language Pack from Windows Control Panel > Programs and Features > Uninstall or change a program.

Common Software Upgrade Procedures

Upgrade Windows Server


Note


To upgrade to Windows Server 2016, select Windows Server 2016 (Desktop Experience) option and then select Keep personal files and apps option. For more information, see the corresponding Microsoft documentation.


For information about supported editions, or service packs, see the Contact Center Enterprise Compatibility Matrix at https://www.cisco.com/c/en/us/support/customer-collaboration/unified-contact-center-enterprise/products-device-support-tables-list.html.

Before you begin

  • Using Unified CCE Service Control, stop all Unified CCE services on the Unified CCE servers that you are upgrading, and set the startup type as Manual.

    If you are upgrading the Logger, ensure that you have disabled configuration changes by performing the following steps:
    1. On the A side of the CallRouter in the system that you are upgrading, set the HKEY_LOCAL_MACHINE\Software\Cisco Systems, Inc.\ICM\<instance_name>\RouterA\Router\CurrentVersion\Configuration\Global\DBMaintenance key to 1.

    2. On the B side of the CallRouter in the system that you are upgrading, set the HKEY_LOCAL_MACHINE\Software\Cisco Systems, Inc.\ICM\<instance_name>\RouterB\Router\CurrentVersion\Configuration\Global\DBMaintenance key to 1.

    3. Verify that configuration changes are prevented. When you attempt to save a configuration change, you should see the following message: Failed to update the database. Exclusive access to the CallRouter denied because configuration changes are currently disabled in the router registry.

  • You must upgrade the hardware version of the VM to the version supported in this release. For more information, see https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/uc_system/virtualization/virtualization-unified-contact-center-enterprise.html.

  • Ensure that the virtual machine has enough space before the upgrade. Operating System upgrade to Windows Server 2016 requires minimum of 32-GB primary hard disk space. If the virtual machine is a Logger/Distributor machine, the upgrade to SQL Server 2017 Standard or Enterprise edition requires an extra 6 GB.

    If the disk space of the CCE or CVP virtual machines is expanded to support this upgrade, you must install ICM 12.0(1) ES26 patch on the system. You can download the CCE 12.0 Mandatory Update for Fresh Install/Tech Refresh from https://software.cisco.com/download/home/268439622/type/280840583/release/12.0(1). Failing to do so displays alerts in the Inventory page of Unified CCE Administration and may result in the Inventory page being inaccessible.

  • Change the guest operating system to Microsoft Windows Server 2016 (64 bit). To do so, right-click the virtual machine, select Edit settings > Options > General Options and select the guest operating system as Microsoft Windows Server 2016 (64 bit) and ensure the VM is powered off during this procedure.


    Note


    To be able to select the Microsoft Windows Server 2016 (64 bit) guest operating system, you must set the VM hardware compatibility to ESXi 6.0 and later. For more information, see VM Hardware Version Upgrade.


What to do next

After upgrading your Windows Server, do the following:

Remove Previous Windows Installation

Before you begin

Enable Desktop Experience feature under User Interfaces and Infrastructure from Server Manager. This step is necessary for the disk cleanup process.

Procedure

Step 1

Click Start, search disk cleanup and then click Disk Cleanup.

Step 2

In the Disk Cleanup Options dialog box, click Files from all users on this computer.

Step 3

In the User Account Control dialog box, click Continue.

Step 4

Click to select the previous Windows Installation check box, and then click OK.


Upgrade SQL Server

Microsoft supports in-place upgrade of operating system and SQL Server. After you upgrade the operating system, upgrade SQL Server.


Note


For information about supported editions, see the Contact Center Enterprise Compatibility Matrix at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-device-support-tables-list.html.


Before you begin

  • Upgrading SQL Server requires a minimum of 6-GB hard disk space. Ensure that the virtual machine has the required space before you begin the upgrade.

  • If the virtual machine has SQL Server Enterprise, then it can be upgraded only to the Enterprise version. However, if the virtual machine has SQL Standard Edition, then it can be upgraded to either SQL Server Standard or Enterprise Edition.

Procedure


Step 1

Run the SQL Server installer. Consult Microsoft documentation as needed.

Step 2

Step through the wizard. As appropriate, accept the default or choose the correct instance for your deployment. Select Rebuild on the Full-Text Search Upgrade Options page.



Note


  • Microsoft SQL Server 2017 does not contain SQL Server Management Studio in the default toolkit. Re-run the SQL Server setup to install Management Studio by going to SQL Selection Center > Installation > Install SQL Server Management Tools. If your computer has no internet connection, download and install SQL server 2017 Management Studio manually.

  • SQL Server Client Tools from the previous version remain on the server along with the same tools of SQL Server 2017. These tools include SQL Server Management Studio, SQL Server Profiler, the Database Engine Tuning Advisor, sqlcmd, and osql.


Run EDMT

Before you begin

  • EDMT requires Microsoft® ODBC Driver 11 for SQL Server® and Visual C++ Redistributable for Visual Studio 2015. The latest version of these packages can be downloaded from the Microsoft website. However, a copy of the same is also available in the Prerequisites folder of EDMT.

  • If you are configuring SQL services to run as Virtual account (NT SERVICE) or Network Service account (NT AUTHORITY\NETWORK SERVICE), you must run EDMT as an administrator.

  • The installer, not the EDMT, upgrades the AW database for the Administration & Data Server.

Procedure


Step 1

Launch EDMT.exe.

Step 2

In the Cisco Unified ICM/Contact Center Enterprise Enhanced Database Migration Tool that appears, click Next.

Step 3

Under Migration Type, click the Common Ground radio button and then click Next.

Step 4

In the Warning dialog box that appears, click Yes.

Step 5

From the Authentication drop down list, choose either Windows Authentication or SQL server Authentication.

Step 6

Click Refresh Database List, and select the database you want to migrate from that list.

Step 7

Click Next.

Step 8

Click Start Migration.

Note

 

The EDMT displays status messages during the migration process, including warnings and errors. Warnings are displayed for informational purposes only and do not stop the migration. Errors stop the migration process and leave the database in a corrupt state. If an error occurs, restore the database from your backup, fix the error, and run the tool again.

Step 9

Click Exit after the data migration is complete.

Note

 

Set the TempDB AutoGrowth of Data files to 100 MB manually.


Upgrade Unified CVP Reporting Server

Before you begin

IBM Informix database server 12.10 FC3 is installed as part of the Unified CVP Reporting Server.
  • Only the actual Local Administrator (should not be renamed) of this system can install CVP Reporting Server.

  • Ensure that Unified CVP Reporting Server is not part of any domain and is part of a work group.

Procedure

  Command or Action Purpose

Step 1

Mount the Unified CVP ISO image, and run setup.exe.

Step 2

Review and accept the license agreement, and click Next.

Step 3

On the Authentication window, enter a password and clickOK.

Step 4

Click Upgrade.

Step 5

Choose to restart the computer right after the upgrade or to restart it later, and click Finish.You cannot upgrade CVP Reporting Server from 12.0 to 12.5 because the version of IBM Informix database server has changed. You need to uninstall CVP Reporting Server 12.0 and install CVP Reporting Server 12.5.

Reimage CVP Server

Procedure


Step 1

Take back up of conf folder from c:\cisco\cvp\conf.

Step 2

Stop all services such as CVP Call Server, CVP VXML Server, and CVP WebServiceManager.

Step 3

From C:/Cisco/CVP/bin/TAC, run reimage.bat as reimage.bat 2>Error.txt.

Ignore any log4j errors.

Step 4

Restart the CVP Server machine.


Reimage CVP Reporting Server

Procedure


Step 1

Take back up of conf folder from c:\cisco\cvp\conf.

Step 2

Stop all services such as CVP Call Server and CVP WebServiceManager.

Step 3

From C:/Cisco/CVP/bin/TAC, run reimage.bat as reimage.bat 2>Error.txt.

Ignore any log4j errors.

Step 4

Restart the CVP Server machine.


Upgrade Cisco Voice Gateway IOS Version

Perform this procedure for each gateway on the side you are upgrading.

Upgrade the Cisco Voice Gateway IOS version to the minimum version required by this release. See the Contact Center Enterprise Compatibility Matrix at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-device-support-tables-list.html for IOS support information.

For more information, see https://www.cisco.com/c/en/us/td/docs/routers/access/1900/software/configuration/guide/Software_Configuration/upgrade.pdf.

Procedure


Step 1

Copy the new image from the remote TFTP server into flash memory, making sure that you specify your own TFTP server's IP address and Cisco IOS filename.

Step 2

Verify that the new image was downloaded.

Step 3

Boot using the new image. Update the gateway config to boot using the new version.

Step 4

Reload the gateway to use the new image.


Install Cisco JTAPI Client on PG

After setting up the Cisco Unified Communications Manager (CUCM) PG, you must install the Cisco JTAPI client. PG uses Cisco JTAPI to communicate with CUCM. Install the Cisco JTAPI client from CUCM Administration.


Note


Continue with the steps provided in this section if you are installing the JTAPI client for CUCM version earlier than Release 12.5.

To install the JTAPI client for CUCM, Release 12.5 and above, see Install Cisco JTAPI Client on PG.


Before you begin

Before you install the JTAPI client, ensure that the previous version is uninstalled.

Procedure


Step 1

Open a browser window on the PG machine.

Step 2

Enter the URL for the Unified Communications Manager Administration utility: http://<Unified Communications Manager machine name>/ccmadmin.

Step 3

Enter the username and password that you created while installing and configuring the Unified Communications Manager.

Step 4

Choose Application > Plugins. Click Find.

Step 5

Click the link next to Download Cisco JTAPI for Windows.We recommend you to download the 64 bit version. However, if you have already downloaded the 32 bit version, you can proceed to step 7.

Download the JTAPI plugin file.

Step 6

Choose Save and save the plugin file to a location of your choice.

Step 7

Open the installer.

Step 8

In the Security Warning box, click Yes to install.

Step 9

Choose Next or Continue through the remaining Setup screens. Accept the default installation path.

Step 10

When prompted for the TFTP Server IP address, enter the CUCM IP address.

Step 11

Click Finish.

Step 12

Reboot the machine.


Install Cisco JTAPI Client on PG

Complete the following procedure only if you are installing JTAPI client to connect to Cisco Unified Communications Manager, Release 12.5 and above.

Before you begin

Before you install the JTAPI client, ensure that the previous version is uninstalled.

Procedure

Step 1

Open a browser window on the PG machine.

Step 2

Enter the URL for the Unified Communications Manager Administration utility: http://<Unified Communications Manager machine name>/ccmadmin.

Step 3

Enter the username and password that you created while installing and configuring the Unified Communications Manager.

Step 4

Choose Application > Plugins. Click Find.

Step 5

Click the link next to Download Cisco JTAPI Client for Windows 64 bit or Download Cisco JTAPI Client for Windows 32 bit.

Download the JTAPI plugin file.

Step 6

Choose Save and save the plugin file to a location of your choice.

Step 7

Unzip the JTAPI plugin zip file to the default location or a location of your choice.

There are two folders in the unzipped folder CiscoJTAPIx64 and CiscoJTAPIx32.

Step 8

Run the install64.bat file in the CiscoJTAPIx64 folder or run the install32.bat file in the CiscoJTAPIx32 folder.

The default install path for JTAPI client is C:\Program Files\JTAPITools.

Step 9

To accept the default installation path, click Enter and proceed.

Follow the instructions. Click Enter whenever necessary as per the instructions.

The JTAPI client installation completes at the default location. The following message is displayed:

Installation Complete.

Step 10

Reboot the machine.


What to do next

Note


The default location, where the JTAPI client is installed, also contains the uninstall64.bat and uninstall32.bat file. Use this file to uninstall this version of the client, if necessary.


Upgrade Cisco JTAPI Client on PG

If you upgrade Unified Communications Manager (Unified CM) in the contact center, also upgrade the JTAPI client that resides on the PG. To upgrade the JTAPI client, uninstall the old version of the client, restart the server, and reinstall a new version. You install the JTAPI client using the Unified Communications Manager Administration application.

To install the JTAPI client for the Unified CM release that you have upgraded to, see the Install Cisco JTAPI Client on PG topic.

Before you begin

Before you perform this procedure, you must:

  • Uninstall the old JTAPI client from the Unified Communications Manager PG

  • Restart the PG server.

Performance Enhancement of TempDB

Perform this procedure on Logger, Rogger, AW-HDS-DDS, AW-HDS and HDS-DDS machines to get the benefits of TempDB features for SQL Server. For more information about the SQL Server TempDB Database and its use, see the Microsoft SQL Server documentation for TempDB Database.


Note


This procedure applies to the Common Ground upgrade process only.


Procedure


Step 1

Use Unified CCE Service Control to stop the Logger and Distributor services.

Step 2

Login to SQL Server Management Studio and run the following queries on the primary database.

  • To modify the existing TempDB Initial size to the recommended value:

    ALTER DATABASE tempdb MODIFY FILE
       (NAME = 'tempdev', SIZE = 800, FILEGROWTH = 100)
    ALTER DATABASE tempdb MODIFY FILE
       (NAME = 'templog', SIZE = 600, FILEGROWTH = 10%)
    
  • To add multiple TempDB files:

    
    USE [master];
    GO
    ALTER DATABASE [tempdb] ADD FILE (NAME = N'tempdev2', FILENAME = N'<SQL Server TempDB path>' , SIZE = 800 , FILEGROWTH = 100);
    ALTER DATABASE [tempdb] ADD FILE (NAME = N'tempdev3', FILENAME = N'<SQL Server TempDB path>' , SIZE = 800 , FILEGROWTH = 100);
    ALTER DATABASE [tempdb] ADD FILE (NAME = N'tempdev4', FILENAME = N'<SQL Server TempDB path>' , SIZE = 800 , FILEGROWTH = 100);
    GO
    

Note

 
  • For example,

    <SQL Server TempDB path> = C:\Program Files\Microsoft SQL Server\MSSQL12.MSSQLSERVER\MSSQL\DATA\tempdev2.ndf
  • Make sure that you modify the values in the query based on the machines. For more information, see Increase Database and Log File Size for TempDB.

Step 3

Restart the SQL Services.

Step 4

Start the Logger and Distributor services.


Reduce Reserved Unused Space for HDS

Enable trace flag 692 on HDS database server to reduce the growth of reserved unused space on the AW-HDS, AW-HDS-DDS, HDS-DDS database servers , after you upgrade or migrate to Microsoft SQL 2017 . For more information about the trace flag 692, see the Microsoft Documentation.

Procedure


Run the following command to enable trace flag 692 on HDS database server :

DBCC TRACEON (692, -1);

GO

Note

 

An increase in the unused space may lead to unexpected purge trigger in HDS , trace flag 692 helps in mitigating this unexpected purge issue. After you enable the trace flag, there will be an increase of 10% to 15% CPU for a short duration.


VM Hardware Version Upgrade

Perform the following procedure to upgrade the hardware version of the virtual machine (VM).


Note


The hardware compatibility of the VM must be set to ESXi 6.0 and later.


Before you begin

Procedure


Step 1

Launch the vSphere Web Client using the browser.

Step 2

Log in to the vCenter Server.

Step 3

Right-click on the VM, and select the menu option Compatibility > Upgrade VM Compatibility.

Note

 

The Upgrade VM Compatibility option appears only if the hardware version on the VM is not the latest version supported.

Step 4

In the Compatible with field, select ESXi 6.0 and later.

This sets the hardware version of the VM to 11.

Step 5

Click Ok.

Step 6

Power on the VM.

Note

 

If the system prompts, upgrade the VMware tools. For more information, see Install VMware Tools.


Simple Network Management Protocol

Simple Network Management Protocol (SNMP) facilitates the exchange of management information among network devices so that administrators can manage network performance and solve network problems. SNMP community strings, users, and network destinations are configured in Cisco Unified Serviceability.

Unified Serviceability is one of the tools that open from the Navigation drop-down in Cisco Unified Communications Solutions tools. You can also access Unified Serviceability by entering http://x.x.x.x/ccmservice/, where x.x.x.x is the IP address of the publisher.

See the Serviceability Guide for Cisco Unified ICM/Contact Center Enterprise at https://www.cisco.com/c/en/us/support/customer-collaboration/unified-contact-center-enterprise/products-installation-and-configuration-guides-list.html for information about configuring SNMP for Unified CCE.

Community Strings

The SNMP agent uses community strings to provide security. You must configure community strings to access any management information base (MIB). Add new community strings in the Cisco Serviceability Administration interface.

A community string is configured with:
  • a server

  • a name of up to 32 characters

  • a setting to accept SNMP packets from any host or from specified hosts

  • access privileges (readonly, readwrite, readwritenotify, notifyonly, readnotifyonly, and none)

  • a setting to apply the community string to all nodes in the cluster

Notification Destinations

Add notification destinations for delivery of SNMP notification events when events occur. Add and maintain notification destinations in the Cisco Serviceability Administration interface.

A notification destination is configured with:
  • a server

  • the host IP addresses of the trap destination

  • a port number

  • the SNMP version (V1 or V2c)

  • the community string name to be used in the notification messages that the host generates

  • the notification type

  • a setting to apply to the notification destination configuration to all nodes in the cluster

Upgrade Mapping

The following table lists the editable parameters and the respective property file names. You can find the property files in the location C:\Cisco\CVP\conf.

Configuration Type

OAMP

Unified CCE ADMIN

File Name and Properties

Location

System > Location

Call Settings > Route Settings > Location

%CVP_home%\location.properties

Location Name

Location Name

Location.1name

Location ID

Location Routing Code

Location.1.siteid

Associate Gateways

Gateways

Location.1.ip

Insert Site Identifier

Properties

Location.1.SiteIdInsertionPoint

SIP Server Group

System > SIP Server Group

Call Settings > Route Settings > SIP Server Group > General

sip.properties

SRV Domain Name FQDN

Domain Name FQDN

host name

System > SIP Server Groups

Call Settings > Route Settings > SIP Server Group > Members

%CVP_home%\srv.xml

IP Address/Hostname

Hostname/IP

destination

Port

Port

Port

Secure Port

Secure Port

Secure Port

Priority

Priority

Priority

Weight

Weight

Weight

System > SIP Server Groups > Heartbeat Properties

Call Settings > Route Settings > SIP Server Group > Properties

%CVP_home%\sip.properties

Use Heartbeats to Endpoints

Use Heartbeats to Endpoints

SIP.ServerGroupHeartbeats

Number of Failed Heartbeats for Unreachable Status

Number of Failed Heartbeats for Unreachable Status

SIP.ServerGroupHBNumTries

Heartbeat Timeout

Heartbeat Timeout

SIP.ServerGroupHBTimeout

Up Endpoint Heartbeat Interval

Up Endpoint Heartbeat Interval

SIP.ServerGroupUpInterval

Down Endpoint Heartbeat Interval

Down Endpoint Heartbeat Interval

SIP.ServerGroupDownInterval

Heartbeat Local Listen Port

Heartbeat Local Listen Port

SIP.ServerGroupHBLocalListenPort

Heartbeat SIP Method

Heartbeat SIP Method

SIP.ServerGroupHBMethod

Heartbeat Transport Type

Heartbeat Transport Type

SIP.ServerGroupHBTransportType

Overloaded Response Codes

Overloaded Response Codes

SIP.ServerGroupOverloadedResponseCodes

Options Override Host

Options Override Host

SIP.OptionsOverrideHost

Dialed Number

System > Dialed Number Pattern > General Configuration

Call Settings > Route Settings

%CVP_home%\sip.properties

Dialed Number Pattern

Routing Pattern

SIP.System.Proxy.Route

Dialed Number Pattern Types > Enable Local Static Route

- -

Route to Device

Routing Pattern > Destination

SIP.System.Proxy.Route

Route to SIP Server Group

Routing Pattern > Destination

SIP.System.Proxy.Route

IP Address/Hostname/Server Group Name

Routing Pattern > Destination

SIP.System.Proxy.Route

Dialed Number Pattern Types > Enable RNA Timeout for Outbound Calls

- -

Timeout

Routing Pattern > RNA Timeout

SIP.System.SendToOrigin

Dialed Number Pattern Types > Enable Custom Ringtone

-

-

Ringtone media file name

Dialed Number > Ringtone Media File

System.RingtonePatterns

Enable Post Call Survey for Incoming Calls

Dialed Number > Routing Type

SIP.System.PostCallSurvey.DN

Survey Dialed Number Pattern

Dialed Number > PCS Enabled Dialed Number Patterns

SIP.System.PostCallSurvey.DN

Cisco Unified CVP Server

Device Management > Unified CVP Call Server

Device Configuration > CVP Server

%CVP_home%\icm.properties

ICM > General Configuration

ICM

%CVP_home%\icm.properties

VRU Connection Port

VRU Connection Port

ICM.vruConnectionPort

Maximum Length of DNIS

Maximum Length of DNIS

ICM.maxLengthDNIS

ICM > Advanced Configuration

-

%CVP_home%\icm.properties

Enable Gateway Trunk Reporting

Enable Gateway Trunk Reporting

ICM.enableTrunkUtilization

Maximum Gateway Ports

Maximum Gateway Ports

ICM.maxGatewayPorts

Associate Gateway(s)

Monitored Gateways

ICM.Gateway.1.ipAddress

ICM.Gateway.1.trunkGroupID

SIP > Configuration

SIP

%CVP_home%\sip.properties

Enable outbound proxy

Enable Outbound Proxy

SIP.UseOutboundProxy

Use DNS SRV type query

Enable DNS SRV Type Query

SIP.UseSRV

Resolve SRV records locally

Resolve DNS SRV Locally

SIP.UseLocalSRV

Outbound proxy Host

Outbound Proxy Host

SIP.Proxy.Host

Outbound SRV domain name/Server group name (FQDN)

Outbound Proxy Port

SIP.Proxy.Port

SIP > Advanced Configuration > General

-

%CVP_home%\sip.properties

Outgoing transport type

Outgoing transport type

SIP.Outgoing.Transport

Port number for incoming SIP requests

Port number for incoming SIP requests

SIP.Incoming.Port

SIP info tone duration

SIP Info Tone Duration

SIP.Tone.Duration

SIP info comma duration

SIP Info Comma Duration

SIP.Comma.Duration

Prepend digits

Prepend digits

SIP.SigDigits

Use Error Refer

Use Error Refer

SIP.UseErrorRefer

SIP > Advanced Configuration > Security Properties

-

%CVP_home%\sip.properties

Incoming Secure Port

Incoming Secure Port

SIP.Incoming.Secure.Port

Supported TLS Versions

Supported TLS Versions TLSv1 TLSv1.1 TLSv1.2

SIP.Secure.Tlsv1Enabled, SIP.Secure.Tlsv1dot1Enabled, SIP.Secure.Tlsv1dot2Enabled

Supported Ciphers

Supported Ciphers

SIP.Secure.Ciphers

SIP Header Passing (to ICM)

SIP Header Passing to ICM

SIP.HeaderValue

IVR > IOS Voice Browser Configuration

IVR

%CVP_home%\sip.properties

Use Backup Media/VXML Servers

Use Backup Media/VXML Servers

IVR.UseBackupMediaServers

Use hostnames for default Media/VXML servers

Use Host Names for Default Media/VXML Servers

IVR.UseMediaServerHostNames

Use Security For Media Fetches

Use Security for Media Fetches

IVR.GenerateHttpsURL

IVR > Advance Configuration

- -

Call timeout

Call Timeout

IVR.VBCallTimeout

IVR > Infrastructure

Infrastructure

-

Log File Properties

Log File Properties

%CVP_home%\system.properties

Max Log File Size

Max Log File Size

MaxLogFileSizeMB

Max Log Directory Size

Max Log Directory Size

MaxLogDirSizeMB

Configuration: Primary Syslog Settings

Configuration: Primary Syslog Settings

%CVP_home%\system.properties

Primary Syslog Server

Primary Syslog Server

Syslog.Server

Primary Syslog Server Port Number

Primary Syslog Server Port Number

Syslog.ServerPort

Primary Backup Syslog Server

Primary Backup Syslog Server

Syslog.BackupServer

Primary Backup Syslog Server Port Number

Primary Backup Syslog Server Port Number

Syslog.BackupServerPort

Configuration: Secondary Syslog Settings

Configuration: Secondary Syslog Settings

%CVP_home%\system.properties

Secondary Syslog Server

Secondary Syslog Server

Syslog.SecondaryServer

Secondary Syslog Server Port Number

Secondary Syslog Server Port Number

Syslog.SecondaryServerPort

Secondary Backup Syslog Server

Secondary Backup Syslog Server

Syslog.SecondaryBackupServer

Secondary Backup Syslog Server Port Number

Secondary Backup Syslog Server Port Number

Syslog.SecondaryBackupServerPort

Unified CVP VXML Server

Device Management > Unified CVP VXML Server

Device Conguration > CVP Server > VXML Server

%CVP_home%\vxml.properties

Enable reporting for this Unified CVP VXML Server

Enable Reporting for this Unified CVP VXML Server

VXML.ReportingOn

Enable reporting for VXML application details

Enable Reporting for VXML Application Details

VXML.ReportingDetail

VXML Applications Details: Filters

VXML Applications Details: Filters

%CVP_home%\vxml.properties

Inclusive Filters

Inclusive Filters

VXML.ElementFilterInclude

Exclusive Filters

Exclusive Filters

VXML.ElementFilterExclude

Unified CVP Reporting Server

Device Management > Unified CVP Reporting Server

Device Conguration > CVP Reporting Server

%CVP_home%\reporting.properties

Reporting Properties

Properties

-

Enable Reporting

Change Enable Reporting

RPT.ReportingOn

Max. File Size (MB)

Maximum File Size (MB)

RPT.MaxFileSize

Database Administration > Data Delete

Database Configuration

-

Schedule Daily Backups

Schedule Daily Backups

-

Database Admin Password

DB Admin Password

RPT.DBAdminPassword

Call

Call

RPT.CallRetentionPeriod

Call Event

Call Event

RPT.CallEventRetentionPeriod

VXML Session

VoiceXML Session

RPT.VXMLSessionRetentionPeriod

VXML Element

VoiceXML Element

RPT.VXMLElementRetentionPeriod

VXML ECC Variable

VoiceXML ECC Variable

RPT.VXMLECCVariablesRetentionPeriod

VXML Voice Interact Detail

VoiceXML Voice Interact Detail

RPT.VXMLVoiceInteractDetailRetentionPeriod

VXML Session Variable

VoiceXML Session Variable

RPT.VXMLSessionVariablesRetentionPeriod

VXML Element Detail

VoiceXML Element Detail

RPT.VXMLElementDetailRetentionPeriod

Callback

Callback

RPT.CallbackRetentionPeriod

Trunk Utilization Usage

Trunk Utilization Usage

RPT.TrunkUtilizationRetentionPeriod

Infrastructure

Infrastructure

%CVP_home%\system.properties

Configuration: Thread Management

Configuration: Thread Management

-

Maximum Threads

Maximum Threads

ThreadManager.totalThreads

Advanced

Advanced

-

Statistics Aggregation Interval

Statistics Aggregation Interval

Stats.Aggregation.Interval

Log File Properties

Log File Properties

-

Max Log File Size

Maximum Log File Size

MaxLogFileSizeMB

Max Log Directory Size

Maximum Log Directory Size

MaxLogDirSizeMB

Configuration: Primary Syslog Settings

Configuration: Primary Syslog Server Settings

-

Primary Syslog Server

Primary Syslog Server

Syslog.Server

Primary Syslog Server Port Number

Primary Syslog Server Port Number

Syslog.ServerPort

Primary Backup Syslog Server

Primary Backup Syslog Server

Syslog.BackupServer

Primary Backup Syslog Server Port Number

Primary Backup Syslog Server Port Number

Syslog.BackupServerPort

Configuration: Secondary Syslog Settings

Configuration: Secondary Syslog Server Settings

-

Secondary Syslog Server

Secondary Syslog Server

Syslog.SecondaryServer

Secondary Syslog Server Port Number

Secondary Syslog Server Port Number

Syslog.SecondaryServerPort

Secondary Backup Syslog Server

Secondary Backup Syslog Server

Syslog.SecondaryBackupServer

Secondary Backup Syslog Server Port Number

Secondary Backup Syslog Server Port Number

Syslog.SecondaryBackupServerPort

Courtesy Callback

System > Courtesy Callback

Features > Courtesy Callback

-

Allow Unmatched Dialed Numbers

Allow unmatched Dialed Numbers

RPT.CCB_ALLOW_UNMATCHED_DN_PATTERN

Allowed Dialed Numbers

Allowed Dialed Number Patterns

RPT.CCB_DN_PATTERN

Denied Dialed Numbers

Denied Dialed Number Patterns

RPT.CCB_DN_PATTERN

Maximum Callbacks Per Calling Number

Maximum Callbacks per Dialed Number

RPT.CCB_MAXIMUM_CALLS_PER_ANI


Note


The OAMP parameters other than those mentioned in the table are not automatically carried over to Packaged CCE. These parameters carry default values.

In Unified CCE Administration, Unified CVP acts as a media server by default. You can add the default media server in Unified CCE Administration at Infrastructure Settings > Device Configuration > CVP Server > IVR