Port Mirror Configuration Within Chronicall

Please note that Xima Support will not setup or manage your network switch.

Additionally, Port Mirror will only record external calls. Internal call recording via Port Mirror is not possible or supported.

Port Mirrors are another way for Chronicall to receive the audio and metadata it needs to create call recordings without the need for a VRTX device, which is not viable in some situations. 

• Note: For Port Mirror to work, we need a SPAN Port Mirror (Layer 1 mirroring - In VMWare it is called Distributed Port Mirroring)
  • NOTE:  We DO NOT support
    • RSPAN (Layer 2 mirroring - In VMWare it is called Remote Mirroring Source or layer)
    • ESPRAN (Layer 3 mirroring - in VmWare it is called Encapsulated Remote Mirroring)
• For pre-existing configurations:  If you already had a working Port Mirror successfully capturing recordings and it stopped working, please see the article Port Mirror Capture No Longer Working.  

Steps:

1. Provision a port on your network switch to have all SIP network data mirrored to it.
   • Typically you would mirror the SIP line going to the IP Office/Aura CM, though in certain environments you may need to mirror the traffic coming from the DMarc
     • NOTE: If you are using an SBC (Session Border Controller), Xima Software requires that the Port Mirror must be monitoring the external traffic on the WAN / far side / outside network to the service provider
   • In the example below, you would typically mirror the traffic on 26 to 48, but in some instances, you may need to mirror from 25 to 27 instead
     
     
2. The Recording Library server will need a secondary NIC to be connected to the mirrored port with an ethernet cable
   • This secondary NIC needs a statically set IPv4 address, with data from the mirrored port flowing to it
   • NOTE:  The IP address cannot be the same as the Chronicall Server or Recording Library Server.
     • You can also use a MAC address if necessary, though the NIC will still need an IPv4 address assigned to it
   • NOTE: If using a USB NIC, please install all drivers and then reboot the server for them to go into effect fully
3. Configure the Recording Library to look at the port mirrored NIC
   1. Go to Admin (System) > System Settings > Recording Libraries > Recording Libraries Configuration
   2. Set the Port Mirror NIC Address to have the IP/MAC Address of the secondary NIC
      • See screenshot below for annotated steps
        
   3. Click "OK" through all of the menus and save the changes
4. Restart the Chronicall services
5. Assign the port mirror to the appropriate trunk
   1. Go to Admin (System) > System Settings > Recording Libraries >Trunk Configuration
   2. Select the appropriate SIP trunk to be monitored and select "Edit"
   3. If the port mirror was already set up (Step 3 above), you should be able to select the IP/MAC address from the drop-down menu next to VRTX Serial
      •  You can also manually type in the address if it does not appear
      • See screenshot below for annotated steps
        
        
        
        
   4. Click "OK" through all of the menus and save the changes
   5. Set up your recording rules to select which agents are recorded

Note:

On version 3.8.2 and above, if you are receiving an error message that says "Data Stopped Verify Connection" in the Recording Library logs, and have not seen anything in the live folder, double-check the jpcap.dll file in the recording library directory if you have a Windows installation

It should be an 88 KB file if Windows 4.0 and up, but if not, you can get the jpcap.dll (Windows) or the jpcap.jar (Linux) from the bottom of the Port Mirror Capture No Longer Working article.