Imagicle Call Analytics

How to failover/failback the processing node in a HA cluster for CUCM

Introduction

This article explains Call Analytics failover and failback procedures to make a backup UCX suite node the processing node and later return to normal operation, when configured to work with a CUCM pbx.

This manual procedure is worth doing only for long outages of the primary node.

Applies to

On premise Call Analytics of all UCX Suite versions supporting HA.

Failover and Failback Procedure


Prerequisites

CDR reception

Before starting, please confirm that CUCM CDR files are already being delivered successfully to both Imagicle nodes.

If CDRs are not reaching both nodes, please configure and validate this first following the instructions available here. The failover procedure relies on both servers receiving the CDR files in advance; otherwise, call data may be missing after the role switch.

License

Ensure that the secondary server has a valid redundant Call Analytics license.

Failover: Primary Server to Secondary Server

  1. Confirm that new CUCM CDR files are present on the secondary server in:

    <StonevoiceAS>\Apps\BillyBlues\Engine\ccm5cdr
    
  2. If the primary server is still reachable, stop the Call Analytics Service Host service from:
    Call Analytics > Administrative Pages > Service Manager

  3. On the secondary server, open:

    <StonevoiceAS>\System\SvSasPlatforms.ini
    

    Copy the value of:

    InstallationAddress=
    
  4. On the secondary server, open:

    <StonevoiceAS>\Apps\BillyBlues\Engine\BillingCluster.ini
    

    Set:

    MasterHostName=<secondary server InstallationAddress>
    
  5. Save the file and wait approximately one minute.

  6. Open Call Analytics > Administrative Pages > Service Manager and confirm that Recorder, Miner, and Scheduler are running on the secondary server.

  7. Verify that new calls are imported and displayed correctly in Call Analytics reports.

Failback: Secondary Server to Restored Primary Server

  1. Confirm that the primary server has been restored and that CUCM CDR files are arriving successfully on it.

  2. On the restored primary server, open:

    <StonevoiceAS>\System\SvSasPlatforms.ini
    

    Copy the value of:

    InstallationAddress=
    
  3. On the currently active secondary server, open:

    <StonevoiceAS>\Apps\BillyBlues\Engine\BillingCluster.ini
    
  4. Set:

    MasterHostName=<primary server InstallationAddress>
    
  5. Save the file and wait approximately one minute.

  6. Login the Primary server and navigate Call Analytics > Administrative Pages > Service Manager, then:

    1. Start the Call Analytics Service Manager and wait 1 minute.

    2. confirm that Recorder, Miner, and Scheduler are running on the primary server.

  7. Confirm that the secondary server has returned to standby mode.

  8. Place a test call and verify that its CDR is imported correctly.

Please perform the failover within 10 days of the primary server outage, as older CDR files may no longer be retained on the secondary server.


Last updated: