Deploying Web Services for GIR

GIR needs web servics for blah blah blah

Web Services uses three major components:

• WebDAV Server—The file management device that stores and manages the GIR recording files
• Cassandra Database—The java-based cluster-schemed database for Web Services to store interaction metadata.
• Web Services Server—A REST API server that pushes and pulls the interaction metadata to and from the Cassandra database.

The following steps describe how to deploy the Web Services component.

Deploy the WebDAV Storage Server

1. Install WebDAV, run the following command:

   yum install httpd

2. Edit the /etc/httpd/conf/httpd.conf file, and append the following to the end of the file:

   Alias /recordings /mnt/recordings
   <Directory /mnt/recordings>
      Options Indexes MultiViews FollowSymLinks
      EnableSendfile off
      AllowOverride None
      Order allow,deny
      allow from all
   </Directory>
   <Location "/recordings">
      DAV On
      AuthType Basic
      AuthName "user"
      AuthUserFile /var/www/htpasswd
      Require valid-user
   </Location>

3. Open the firewall. Because WebDAV is an HTTP server, the incoming default HTTP and/or HTTPS ports (80 and/or 443) must be open to the server.
   Important

   It is possible to use custom ports by changing the permitted incoming ports in the firewall, the virtual host configuration file, and the URL used to reach the WebDAV server.
4. Create the directory to keep the recording files, and set the permission to apache, using the following command:

   mkdir /mnt/recordings
   chown apache:apache /mnt/recordings

5. Create a WebDAV user for httpd, and configure the password. The following example creates a user called "user":
   htpasswd -c /var/www/htpasswd user
6. Configure the httpd to start on boot up (and start it now) using the following command:

   chkconfig --levels 235 httpd on
   service httpd start

7. Test the WebDAV installation"
   1. Upload a hello.world file to the WebDAV server using the following command:

      curl -T hello.world -u user:password http://myserver/recordings/hello.world

   2. Using a browser, open the the http://myserver/recordings/hello.world URL. The browser will request for user credentials.
8. The WebDAV server is installed.

Deploy the Cassandra Database

Web Services stores the information about call recordings in a Cassandra database. For each contact center, the distinct column families with unique names exist for storing call recording information. These column families are created when the contact center is created, and deleted when contact center is deleted.

To deploy the Cassandra database for GIR, see the Installing and Configuring Cassandra section of the Workspace Web Edition & Web Services Deployment Guide.

Important

Web Services deletes column families only if they do not contain any call recordings; otherwise they should be deleted manually from Cassandra using the cassandra-cli tool.

Deploy Web Services

To install Web Services, see the ''Workspace Web Edition & Web Services Deployment Guide''.