How do I configure the FTP built into VMPRO for Chronicall? (Linux to Windows)

Answer

Note:  If you are using Avaya Call Reporting, please see this article on setting up Active Recording for ACR which is the recommended ACR recording solution.  This article is for Chronicall 3.10.2d or later.

Note:  this Please follow all steps IN ORDER! This is a step by step process. If you skip one step, it will not work! 

Steps:

1. Install Chronicall & Recording Library 3.10.2d or later. If you are updating from version 3.9.4 or earlier you will need to run our Apps installer in order to update Recording Library.  If you need your serial key to get the Apps installer, you can find it under Help > About Chronicall on the Chronicall Home Screen
2. If you were using the freeFTPd program, make sure to disable it in the Windows Services menu and to stop all active processes of it. (Having this installed previously will also likely cause the "Error: Key is Invalid" issue later)
3. Open the Chronicall UI
4. Navigate to Recording Libraries in the settings menu in Chronicall (Admin System > System Settings) and edit the settings for the recording library you want
5. Click the ellipsis to the right of the "Recording Library FTP Server Configuration" setting
   
   
   
   
   • Note: In this menu, you should also ensure that the Monitored Recording Directory is pointed to the Live folder, as the / on the Remote FTP Location will tell VMPRO to put the recordings into the Live folder.
   • Note: change the Recording Library IP Address to its actual IP address, not 127.0.0.1 if it isn't already.
6. Check the "Enable Recording Library FTP Server" box. Then enter a username and password for the FTP to use
   
   
   
   
7. Restart the Recording Library service

Test FTP and Configure the VM Pro

1. From the Linux terminal of the Voicemail Pro you can test that it can connect to the FTP by using the following command:

   sftp Administrator@0.0.0.0
   

   
   
   
   
   
   

   • Replace the Administrator and the IP with the username created in step 6, and the IP address of the recording library machine

     • If you receive an error saying the key is invalid (as below), navigate to the known_hosts file at the location specified in the error. Remove any lines with the IP address of the recording library server, save the file, then try the SFTP command again
       
       
       
       

2. Open Voicemail Pro Client and log in
3. Click the Administration drop-down menu at the top of the screen, then go to Preferences, and then General
   
   
   
   
4. Go to the Voicemail Recording tab and enter the following settings:
   • FTP User Name: Username configured in step 6
   • FTP Password: Password configured in step 6
   • Remote FTP Location: /
   • Remote FTP Host: IP Address of the recording library server
     
     
     
     
5. Click "Test Connection"
   • If the connection is successful, then you should be good to go
     • You can double-check this by monitoring the Live folder for a newly created test folder
       • It will usually have a long string of numbers in its name, e.g. 0706112157.318
     • If it shows as successful but no folder is created, try substituting the / for the full file path to the Live folder and test again
       
       • E.g. C:\Program Files\Chronicall\Recording Library\live
   • If the connection is not successful, review the above steps and check the "Other Errors" section below
6. You will most likely need to schedule an after-hours reboot of the VMPro server in order for these changes to take effect
7. You may need to restart all the Chronicall services in order if it still is not working

Other Errors

• If you run into a "Connection timed out" error, make sure that all of the Recording Library changes were saved properly. Also, check that the Recording Library service was restarted and that it came back up after the changes
  
  
  
  
  
  
• Next, make sure that they have the proper version of Recording Library installed and configured. (E.g. Chronicall Recording Library VS Avaya Call Reporting Recording Library, or running the Apps installer if they updated from 3.9.4 or earlier)
• If the VMPro Client refuses to test successfully, per Avaya, try deleting the Chronicall RSA key from the /root/.ssh/known_hosts file using nano to read the file first, then delete the entry we just made and retry Step 8 (screenshots below)
  • Note: The .ssh folder is hidden, so using the ll or ls commands to see it in the root directory won't work, you will need to change directory (cd) into it
  • Navigate to the .ssh folder then open with nano
    
    
    
    
  • Once open it should look like this, with one or more entries.  Try removing the entry for Chronicall
    
    
    
    
• If the Voicemail Pro "Test Connection" shows the test is successful, but you still aren't getting recordings, check the tomcat logs. In the latest log, you may find this line: "RecordingFtpPasswordAuthenticator:39 - Invalid login attempt by user Voicemail." 
  • In Chronicall version 3.10.2d and higher, you do NOT need to have the correct password for the "Test Connection" in Voicemail Pro to work
  • If it says this error you will need to put in the correct password but it can be confusing seeing that the "Test Connection" works
• ERROR FtpServerLauncher:59 - Problem starting Recording Library FTP Server! java.net.BindException: Address already in use found in the tomcat log
  • Recreate the RSA key from steps above
  • You may need to restart the actual server that is hosting the Recording Library