Deploying the Web Application

The final deployment step is to install Interaction Recording Web Services as a service. Complete the following steps for each Interaction Recording Web Services node.

Deploy under Red Hat 6

Start

1. Create a new folder on your Interaction Recording Web Services node. For example, ir-web-services. This is the home folder for the web application.
2. Copy the gir.jar file from the installation CD to your new Interaction Recording Web Services home folder.
3. Copy the installation_CD/rhel6/etc/default/gir file to the /etc/default folder on your Interaction Recording Web Services host.
4. Copy the installation_CD/rhel6/etc/init.d/gir file to the /etc/init.d folder on your host.
5. Open /etc/default/gir on your host and update the following environment variables to values appropriate for your Interaction Recording Web Services node:
   • GWS_HOST — This value should match the Jetty host you'll define later in the jetty section of the application.yaml configuration file.
   • GWS_PORT — This value should match the Jetty port you'll define later in the jetty section of the application.yaml configuration file.
   • GWS_HOME — The Interaction Recording Web Services home folder you created in Step 1.
   • GWS_LOGS — The location where you want Interaction Recording Web Services to store log files. If this folder doesn't exist, Interaction Recording Web Services creates it during application startup.
   • GWS_TEMP — The location where you want Interaction Recording Web Services to store temp files. If this folder doesn't exist, Interaction Recording Web Services creates it during application startup.
   • GWS_CONF — The location where you want to store the Interaction Recording Web Services configuration files. If you do not specify a value for GWS_CONF, Interaction Recording Web Services uses GWS_HOME.
6. Create the GWS_CONF folder you specified in the Step 5. If you didn't set GWS_CONF, create a folder called etc in GWS_HOME — for example, ir-web-services/etc.
7. Create the following configuration files in the folder you created in Step 6. You can simply copy the files from installation_CD/config-templates and remove the .sample extension. You'll learn more about the settings in these files as you go through the configuration steps for Interaction Recording Web Services and its features later in this guide.

• application.yaml
• hystrix.properties
• logback.xml

Create the user group gir.

Create the gir user in the gir user group and provide the user with ownership, and read and write permissions for the following folders:

The folders defined in the GWS_HOME, GWS_LOGS, GWS_TEMP, and GWS_CONF environment variables.

The folder defined in the path configuration item within the logging section in the application.yaml file (/var/log/jetty9 by default).

Set executable permissions on the /etc/default/gir and /etc/init.d/gir files.

Use the following command to register the new service on your host:
chkconfig gir on

Next Step

• Configuring Interaction Recording Web Services