Verify Connection Settings

Shoretel Steps

Diagnosis

Follow these next two steps to navigate to the Shoretel system having issues with logging.

1. Go to Admin (System) > System Settings > Server Edition.  Verify the IP Address of your HQ Server.
   1. 
   2. Shoretel pre Chronicall 3.8.6 has two different spots for IP Addresses, and they have to be identical and to the HQ server.  This is no longer relevant in our most recent builds of Chronicall, 3.8.6 and later.
2. Select the (...) as shown in the screen above on the ECC Integration line.  Verify the below information.  In order to see the ECC groups, Routepoints, and IVR's in Chronicall these settings have to be up to date.
   • 
3. Save the settings again and go back to the home screen.  Give Chronicall around 30 seconds, then click on the bell again to see if it is logging.  Some systems may take longer.
4. Often times when there are network or firewall changes, this can block communication between the Chronicall and your PBX server. 
   • I recommend checking with your Network Administration team or using the Windows service Telnet to verify the following ports are not blocked between then Chronicall server and your local Shoretel server.
5. Restart the Chronicall service on the Chronicall server to retry the connection.  If the issue reoccurs regularly and a restart of the service fixes this, continue to the next step. 
6. This is a known issue and restarting the Chronicall service is a workaround.  The issue is covered in the next step below.
   1. We have detected a common issue between the Shoretel server and Windows server 2012 and 2016. 
   2. It relates to the TAPI connection between the two, and the line information suddenly failing to load.  You will want to contact your Shoretel partner, or Xima to get the Shoretel Multi Line Browser to test this. 
   3. While Chronicall is not logging, run the Shoretel Multi Line Browser tool and click the Green Checkmark shown below. 
   4. 
   5. In the white box above,  you should see the line information start loading if that TAPI connection is working. 
   6. If it freezes and fails to load any lines, this indicates that the issue lies on the Shoretel side as their own tool is also failing to load the line information on your local server.  If we cannot see the line information on the network, we are unable to log live call data. 
   7. We recommend at this point reaching out to a Shoretel TAC to find out why the line information is failing to load in the Shoretel Multi Line Browser.
7. If the line information does load properly in the white box above after clicking the green check mark, and Chronicall is still not logging continue to the next step.
8. If you recently updated Chronicall for Shoretel, please see this article. 
   • Sometimes the license file can get stuck during an update to Chronicall, and the linked article here covers this resolution.
9. The last step we would suggest re-installing the Shoretel Remote TAPI Service Provider on the Shoretel server.

Avaya CM TSAPI Steps

Diagnosis

1. Check the most recent Tomcat Start or Roll logs for relevant errors.  This can help identify what you are hitting an error with regarding your CM and or AES Log in.
2. I would recommend searching for T-LINK and SOAP errors in the tomcat logs in the file paths below. 
   • You can use Cntrl+F to search the tomcat logs in Windows.
   • C:\Program Files (x86)\Xima Software\Chronicall\tomcat\logs
   • C:\Program Files\Chronicall\tomcat\logs
   • /var/lib/Xima\ Software\Chronicall\tomcat\logs
3. Verify you have the correct credentials for Chronicall to communicate with CM by logging into CM and AES with the credentials Chronicall is using.
4. While logged into AES, check the CTI-Link status to verify it is up.  To check this navigate to Status > Status and control > TSAPI service summary on the aes web interface.
5. If the credentials in Step 2 work for logging into CM and AES, try inputting them again into the CM server settings inside Chronicall.  Select OK and save changes.
   • 
6. Wait 45 seconds, then go back to the home screen and select System Status. See if it is green and logging now.  You need to click on the bell to refresh it, and it can take some time to reconnect.
   • 
7. If you are still not logging, the next step would be to reset the TAPI service. 
   • *WARNING, Do not do try this step unless your system isn't live or it is after hours. This will drop all phone calls in the system if you do this step on a live PBX system.* Under Maintenance, open the Service Controller. Here, you will need to select TSAPI Service and click Restart Service.

Avaya CM CDR Steps

Diagnosis

1. We need to make a note of what Remote Port you have in use.  While we are here we can also check to see if Reliable Protocol has been disabled.
   • Open GEDI and navigate to Start Emulation
   • 
2. After launching the Emulator, type change ip-services
3. On the first page, make note of what Remote Port you have configured.
4. Navigate to the 3rd page too see if Reliable Protocol is set to Y.  If so we need to set it to N.
5. Ensure the Chronicall Orient services are running.
6. If you are on Chronicall 3.94 or earlier, check for conflicting Orient Jar files in the Chronicall Directory.  Sometimes updating Java can create duplicate .jar files inside the Chronicall Directory.  If so, delete the older .jar files that have the exact name of another .jar file, as shown in this article.
7. Verify IP Address and CM Mode as shown below reflects your current setup.  The below screen shows a CM configuration that is logging both CDR And TSAPI data, but you may just be logging one or the other.
   •  
8. Check your CDR Config as covered in the installation guide here.  The article linked contains CDR setup in section 1.3 which covers the configuration. 
   1. While here you should also verify the Node is configured to send to Chronicall.
   2. Double check the remote port that was configured in 1.3 of the installation guide as well.  With missing CDR data, you will want to verify that port matches the CDR port in Chronicall's hidden settings under Admin(System) > System Settings > *hold Shift* and select Advanced Settings.
9. Access the GEDI Emulator and check the CDR Link Status with the command "status cdr-link" to verify it is up and running.
10. You only want to try this step outside of normal business hours. Restart the CDR Link via this article.  

Cisco Steps

Diagnosis

1. Chronicall logs data with Cisco via a few different data streams.  We use the CDR and JTAPI data to log call details and events.  We use Unity to track voicemail and auto attendants.  Chronicall connects to UCCX to monitor Realtime data on agents and groups.
2. When you selected the Bell on the home screen, it will indicate if you are having a connection issue with the CDR or JTAPI connection.
3. If these are not connecting and they were before, navigate to the server settings inside Chronicall.  Go to Admin (System) > System Settings > Cisco UCM (site #).
4. Verify the correct UCM IP Address and Credentials are correct.  There is no way to test this on Cisco's end, but it is easy to reset on Cisco's side.
   • 
     • Tomcat logs in the Chronicall directory will also display authentication errors if the IP or Password is incorrect.
     • You can also pull up CMD prompt to see if you can ping this IP addresses.
5. Verify that the Cisco Application User shown above has access to the required roles inside the Cisco system.
6. One of the most common reasons for Cisco to stop logging stems from not enough memory (RAM) on the Chornicall server, or not enough memory dedicated to Chronicall.  The Chronicall server requires at least 8 gigabytes of memory (RAM), and an 8 core processor.  Verify your server meets these suggested specs for Cisco.
7. If you have plenty of memory and do not see unusually high memory utilization on the Chronicall server, the next step would be to allocate more memory directly to Chronicall.  The easiest way to do this is to upgrade to the most recent build (3.95 or higher) as it will have Java 64 bit built in, and be able to allocate up to 4 gigs of memory directly to Chronicall.
   • If you are on Chronicall 3.94 or earlier and do not wish to upgrade at this time, you can follow this guide to update Java to 64 bit.  This document covers manually updated Java 32 and 64 bit, and then manually running an update for the current version you are on is available from our website.  This is a much more complex step that is not required if you update to our most recent build.  It should also be noted that each time you run your current versions update, it will stop and restart the services, causing a gap in the call logs while it is down.
8. If you notice Voicemail and Auto Attendant events are not showing in Call Detail or Cradle to Grave, you will want to verify your Unity IP Address.  You can also pull up CMD prompt to see if you can ping this IP address.  While here also ensure