/
.Installation with Docker-compose v14.1

.Installation with Docker-compose v14.1

Apr 10, 2023

 

 

Installation Steps

Internet should be available on the machine where the application is being installed and connections on port 9242 should be allowed in the network firewall to carry out the installation steps. 

 

All the commands start with a # indicating that root user privileges are required to execute these commands. Trailing # is not a part of the command.

 

Allow ports in the firewall

To start the firewall (if it isn't started already), execute the following commands:  

# systemctl enable firewalld # systemctl start firewalld

To allow the ports on firewall, you can execute the following commands. (Run on both machines in case of HA). 

# firewall-cmd --add-port=443/tcp --permanent # firewall-cmd --add-port=8088/tcp --permanent # firewall-cmd --add-port=5060/tcp --permanent  # firewall-cmd --add-port=16386-32768/udp --permanent  # firewall-cmd --reload

 

Installation Steps

  1. Follow this guide to install and configure Freeswitch

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

  3. Download the deployment script  and place it in the user home or any desired directory. This script will:

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

    2. clone the required files for deployment

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

    $ chmod 755 deployment.sh $ ./deployment.sh

  5. Execute the following commands inside current directory. 

    # chmod 755 install.sh # ./install.sh

  6. Check if keycloak container is healthy, if it is on restarting, kill  (docker rm keycloak) and remove (docker rm keycloak) the keycloak container then run ./install.sh. Wait for keycloak container to become healthy.

  7. Set up keycloak

  8. Once keyclaok is set up, update below environment variables in recording-solution/docker/config.env file. 

    Name

    Description

    Name

    Description

    VRS_URL

    Update the IP in this variable's value. It should be VRS machine IP.

    https://192.168.1.106

    LOCAL_MACHINE_IP

    VRS machine IP

    FINESSE_URL

    UCCX Finesse URL with port

    https://FINESSE-FQDN:8445

    KEYCLOAK_REALM_NAME

    Realm name created in step 4 of keycloak setup

    KEYCLOAK_CLIENT_ID

    Keycloak client id from step 6 of keycloak setup

    KEYCLOAK_CLIENT_SECRET

    Keycloak client secret from step 8 of keycloak setup

    KEYCLOAK_URL

    keep default

    KEYCLOAK_PERMISSION_GROUP

    Keycloak Group from step 12 of keycloak setup

    CCX_PRIMARY_IP

    Primary/Publisher UCCX IP

    CCX_SECONDARY_IP

    Secondary/Subscriber UCCX IP

    CCX_ADMIN_USERNAME

    UCCX admin username

    CCX_ADMIN_PASSWORD

    UCCX admin password

    TRUST_STORE_PATH

    The SSL truststore path, the truststore on this path must have the Finesse SSL certificate imported.

    Do not change this, instead place the created/updated truststore inside recording-solution/ssl folder.

    TRUST_STORE_PASSWORD

    The password for the truststore that has the Finesse certificate imported.

  9. 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 exactly same.

  10.  Run ./install.sh again

  11. Run the following command to ensure that all the components are up and running. 

    # docker ps

  12. Go to https://VRS-IP/#/login to access the application.

  13. Configure SIP trunk to enable CUCM to send SIP events to VRS for call recordings