Jump to: navigation, search

Deploying the web application for 8.5.201.50 or later

Important
If you're deploying Web Services and Applications version 8.5.201.09 or earlier, complete the steps on Deploying the web application for 8.5.201.09 or earlier instead.

As of version 8.5.201.18, you can install Web Services as a service. Complete the following steps for each Web Services node.

Start

  1. Create a new folder on your Web Services node. For example, web-services. This is the home folder for the web application.
  2. Copy the gws.jar file from the installation CD to your new Web Services home folder.
  3. Copy the installation_CD/etc/default/gws file to the /etc/default folder on your Web Services host.
  4. Copy the installation_CD/etc/init.d/gws file to the /etc/init.d folder on your host.
  5. Open /etc/default/gws on your host and update the following environment variables to values appropriate for your 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 Web Services home folder you created in Step 1.
    • GWS_LOGS — The location where you want Web Services to store log files. If this folder doesn't exist, Web Services creates it during application startup.
    • GWS_TEMP — The location where you want Web Services to store temp files. If this folder doesn't exist, Web Services creates it during application startup.
    • GWS_CONF — The location where you want to store the Web Services configuration files. If you don't specify a value for GWS_CONF, Web Services uses GWS_HOME/etc.
  6. Create the GWS_CONF folder you specified in Step 5. If you didn't set GWS_CONF, create a folder called etc in GWS_HOME — for example, 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 Web Services and its features later in this guide.
    • application.yaml
    • elasticsearch.yml
    • hystrix.properties
    • logback.xml
    • statistics.yaml
  8. Copy the routing-templates folder from installation_CD/routing-templates to your GWS_HOME folder.
  9. Create the user group gws.
  10. Create the gws user in the gws user group. The user should have read and write permissions for the folders defined in the GWS_HOME, GWS_LOGS, GWS_TEMP, and GWS_CONF environment variables.
  11. Use the following command to register the new service on your host: chkconfig gws on

End

Next Step

This page was last edited on October 31, 2023, at 13:33.
Comments or questions about this documentation? Contact us for support!