Revision as of 07:39, September 28, 2016 by Mlevy (talk | contribs) (Update with the copy of version: DRAFT)
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).

Deploy the WebDAV Storage Server

Start

  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 command: mkdir /mnt/recordings chown apache:apache /mnt/recordings
  5. 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:

    sesetbool -P httpd_use_cifs 1

    chcon -R -t httpd_sys_script_rw_t <storage directory>

  6. Create a 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 command: 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 the http://myserver/recordings/hello.world URL. The browser will request for user credentials.
  9. The Apache HTTP Server is installed.

End

Next Step

Comments or questions about this documentation? Contact us for support!