Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Please make sure that Solution Prerequisites are met for the desired deployment type. 

  2. Download the deployment script

    View file
    namedeployment.sh
     and place it in the user’s home or any desired directory. This script will:

    1. delete the recording-solution directory if it exists.

    2. clone the required files for deployment

  3. To execute the script, give it the execute permissions and execute it. This command will clone the skeleton project for the recording solution. the recording-solution directory contains all the required files for deployment.

    Code Block
    languagebash
    $ chmod 755 deployment.sh
    $ ./deployment.sh
  4. Follow the Section 2 for the deployment of HA VRS at the end of this document.

  5. Follow step 5 to 8 for deployment with Cisco UCCX or UCCE in non-HA (non- High Availability) mode.

  6. Follow this guide to install and configure Freeswitch. The recording path should be /usr/share/freeswitch/cucmRecording

  7. Follow this guide to create an application user on CUCM for jtapi-connector.

  8. Open recording-solution/docker/config.env and update the environment variables given below.

...

  1. To update the self-signed certificates for VRS, get the public authority or domain signed certificate .crt and .key files, name them server.crt and server.key, and replace the files in /recording-solution/config/certificates with these two new files. Names should be the same.

  2.  Run ./install-efcx.sh for EFCX Or run ./install-cisco.sh for Cisco UCCX and UCCE.

  3. Run the following command to ensure all the components are running. 

    Code Block
    # docker ps
  4. In case of Cisco go to https : //VRS-IP/#/login to access the application, whereas for EFCX go to https://VRS-IP:444/#/login.

  5. Configure the SIP trunk to enable CUCM to send SIP events to VRS for call recordings. Two sip trunks should be configured in case of HA. (Not for EFCX)

Section 2

For HA (High Availability)

Ask the IT team to provide and configure NFS server for recording storage

  1. Follow this guide to create an application user on CUCM for jtapi-connector.

  2. Open recoding-solution/docker/docker-compose-cisco

  3. Uncomment the Consul Container and save the changes

  4. Open recoding-solution/docker/config.env

  5. Add url for the consul

...

  1. Change the recording path in the following steps which should be /mnt/nfs/vrs-recording/cucmRecording or and other variables as per your configuration.

  2. In the config.env

Code Block
DIRECTORY_PATH_TO_MONITOR= /mnt/nfs/vrs-recordings/cucmRecording/streams/
CUCM_APPLICATION_USER_NAME=rafay
CUCM_APPLICATION_USER_PASSWORD=Expertflow464
  1. Change the following in the docker-compose-cisco

  • Archival Container add the volumes a

Code Block
volumes:
      - /mnt/nfs/vrs-recordings/cucmRecording/streams/:/mnt/nfs/vrs-recordings/cucmRecording/streams/
      - /mnt/nfs/vrs-recordings/cucmRecording/sessions/:/mnt/nfs/vrs-recordings/cucmRecording/sessions/
environment:
      - DB_URL=jdbc:mysql://mysql:3306/vrs?user=root&password=Expertflow464
      - DB_DRIVER=com.mysql.jdbc.Driver
  • In Apis/Backend Container add the following volumevolumes and database configuration

Code Block
volumes:
      - /mnt/nfs/vrs-recordings/cucmRecording/sessions/:/mnt/nfs/vrs-recordings/cucmRecording/sessions/
environment:     
      - DB_DRIVER=com.mysql.cj.jdbc.Driver
      - DB_ENGINE=mysql
      - KEYCLOAK_URL=http://keycloak:8080/
      - DB_HOST=192.168.1.106
      - DB_NAME=vrs
      - DB_USER=root
      - DB_PASSWORD=Expertflow464
  • In Mixer Container add the following volumes and database configuration

Code Block
volumes:
      - /mnt/nfs/vrs-recordings/cucmRecording/streams/:/mnt/nfs/vrs-recordings/cucmRecording/streams/
      - /mnt/nfs/vrs-recordings/cucmRecording/sessions/:/mnt/nfs/vrs-recordings/cucmRecording/sessions/
environment:   
      - DB_HOST=192.168.1.106
      - DB_NAME=vrs
      - DB_USER=root
      - DB_PASSWORD=Expertflow464
  • In Jtapi Container add the database configuration

  • Code Block
    - DB_HOST=192.168.1.106
    - DB_NAME=vrs
    - DB_USER=root
    - DB_PASSWORD=Expertflow464
    - DB_DRIVER=com.mysql.jdbc.Driver
  1. Open the freeswitch script record.lua located in the /usr/share/freeswitch/scripts and make the following changes

...

Since our VRS interacts with local storage, it reads and writes files on the local storage. Pemission to read and write is thus necessary for the VRS to work.

Assign full permission to the mounted directory for all group, users and others to read, write and execute the mounted directory. It can be done with umask.

  1. Open the config.env

  2. run the install script. ./install-cisco.sh

  3. Do the same for the other VRS

...