1. Home
  2. Getting Started
  3. UCCX Cluster Configuration

UCCX Cluster Configuration

Step 1) Creating a password for the Historical Reporting User

  1. Log into the UCCX publisher
  2. Browse to Tools > Password Management

NOTE – If the Historical Reporting Password is unknown or has never been previously set, it will have to be entered new. By Default Cisco does not set a Password for these items.

Cisco recommends using a simple password for HR User password, such as “cisco123” or “variphy”. Special characters are not supported by Cisco.

NOTE – Make sure to change the HR User Password on all nodes of UCCX.

Step 2) Configuring the Real Time Snapshot Config

In this step we will configure the wallboard settings to permit UCCX to send information to Variphy.

  1. Browse to Tools > Real Time Snapshot Config

2. In the Real Time Snapshot config, check

Data Writing Enabled
Data Writing Interval
Cisco Unified CCX CSQ’s Summary
Cisco Unified CCX System Summary

3. Under Wallboard System, add the IP address of the Variphy server. If multiple values exist, separate values with a comma. IE,

This only needs to be done on the UCCX Publisher

Step 3) Configuring the UCCX cluster settings in Variphy

Log into the Variphy server – http://x.x.x.x:8080 or https://x.x.x.x:8443.

Go to the settings menu

Go to UCCX under Clusters

Add UCCX Cluster

In the first section, enter UCCX publisher information

Cluster Name (Only for Variphy Naming)
Enterprise Name
Primary IP of the UCCX Publisher
Primary Server host – Use only only host name of UCCX server. Do not enter the FQDN (Fully Qualified Domain Name). This can typically found in CCX System > Servers.
Password – The password set for the Historical Reporting User created in step 1.
Confirm Password

Add UCCX Subscriber

Make sure use Primary Server is checked

Finesse User Credentials

The Finesse User credentials serve 2 purposes:

  1. We will use Finesse User to connect the Finesse API. This is used to pull things such as custom Ready Reasons defined in Finesse Admin. (https://ccx-server-ip:8445/cfadmin)
  2. We will use Finesse User to subscribe the Finesse XMPP Service. This allows CCX to send real time/live stats to Variphy.
Note: User ID and Password ARE BOTH CaSe-SeNsItIvE. They must match to the corresponding End-User in CUCM

Finesse User Requirements

  1. The Finesse User must be a uniquely named (non-default) user. In this example my ‘dfalt’ user is supplied Administrator and Agent capabilities. Verify in CCX via Tools > User Management > User View.

Common Troubleshooting Steps

Finesse User Cant Connect:

  1. Test if the configured Finesse User has the correct roles to be able to perform API Call to Finesse.
  2. Browse to https://ccx-server-ip:8445/finesse/api/Users
  3. Login with your Finesse User credentials.
  4. If successful, the API will get all Finesse User information and present it within your browser in XML view.

Adding a Finesse User

UCCX Log Analysis

Add log analysis directory (if needed). The path defined will be the directory on the Variphy server in which the app will ook for audit log files.

Set purge Audit Logs settings


Step 4) Check Cluster

If configuration is correct, its will show Cluster License Valid and UCCX Configuration Successful

UCCX information will now be available in the Dashboards & Widgets & Call Analytics and Reporting

Updated on February 1, 2021

Was this article helpful?

Related Articles