WebDAV Requirements

Interaction Recording Web Services relies on a Web Distributed Authoring and Versioning (WebDAV) server to store and manage the GIR recording files. WebDAV is an extension of the Hypertext Transfer Protocol (HTTP) that facilitates collaboration between users in editing and managing documents and files stored on World Wide Web servers. A working group of the Internet Engineering Task Force (IETF) defined WebDAV in RFC 4918.

The following information represents examples of what can be done for WebDAV. Follow these procedures to get a better understanding of what needs to be done when you use a Red Hat Enterprise Linux machine with the Apache HTTP Server.

Important

It is recommended that you do not install WebDAV on the same machine as Interaction Recording Web Services (RWS), since numerous deployments already install Cassandra and Elasticsearch on the same host. These are critical components for the operation of RWS. If an additional process such as WebDAV is run on the same machine as RWS, disk I/O operations will be limited and the stability of RWS may be negatively impacted.

Deploying the WebDAV Server

1. Install Apache HTTP Server and 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 Apache HTTP Server 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 Apache HTTP server.
4. Create the directory to keep the recording files, and set the permission to apache, using the following commands:

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

Important

Due to performance concerns, Genesys does not recommend using a remote directory for WebDAV. If you still want to use a remote directory, execute the following two commands:

setsebool -P httpd_use_cifs 1
chcon -R -t httpd_sys_script_rw_t <storage directory>

5. Create an Apache HTTP Server user for httpd, and configure the password. The following example creates a user called "user":
   

   htpasswd -cm /var/www/htpasswd user

   Warning

   If the Recording Muxer is deployed for screen recording, make sure all WebDAV storages of the same contact center region are using the same username and password.
6. Configure the httpd to start on boot up (and start it now) using the following commands:
   

   chkconfig --levels 235 httpd on
   service httpd start



7. Test the Apache HTTP Server installation:
   1. Upload a hello.world file to the Apache HTTP Server using the following command:
      

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

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


8. The Apache HTTP Server is installed.

Configuring TLS for the WebDAV Server

To configure TLS for the Apache HTTP Server on RHEL6:

1. On the WebDAV server, run the following command to install SSL:
   

   yum install mod_ssl

   The certificate/key pair is automatically generated:

   • Certificate: /etc/pki/tls/certs/localhost.crt
   • Key: /etc/pki/tls/private/localhost.key
2. To use your own certificate/key pair, either update the files automatically generated (as above), or edit the /etc/httpd/conf.d/ssl.conf file and modify the following lines:
   • SSLCertificateFile /etc/pki/tls/certs/localhost.crt
   • SSLCertificateKeyFile /etc/pki/tls/private/localhost.key
3. Restart httpd by running the following command:
   

   service httpd restart

   TLS is enabled on the default HTTPS port 443.

Important

If you're using a self-signed certificate and migrating from Web Services to Interaction Recording Web Services, you'll need to complete a few more steps. See Re-importing the Certificate for WebDAV for details.

Next Step

• Initialize Cassandra