Jump to: navigation, search

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
  5. Important
    Due to performance concerns, Genesys does not recommend using a remote directory for WebDAV.
  6. 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.
  7. Configure the httpd to start on boot up (and start it now) using the following commands:
    chkconfig --levels 235 httpd on
    service httpd start
  8. 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.
  9. 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

Feedback

Comment on this article:

blog comments powered by Disqus
This page was last modified on 18 January 2018, at 01:53.