Jump to: navigation, search
(Update with the copy of version: 8.5.2DRAFT)
(Update with the copy of version: 8.5.2DRAFT)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
= Deploying the web application=
 
= Deploying the web application=
 +
{{NoteFormat|
 +
*If you're deploying Web Services and Applications version 8.5.201.50 or earlier, complete the steps on [[DeployWebAppLegacy50|Deploying the web application for 8.5.201.50 or later]] instead.
 +
*If you're deploying Web Services and Applications version 8.5.201.09 or earlier, complete the steps on [[DeployWebAppLegacy|Deploying the web application for 8.5.201.09 or earlier]] instead.}}
  
−
{{NoteFormat|The Web Services web application uses the Jetty root context. If other web applications served by the same instance of Jetty also use the root context, this can prevent the Web Services web application from getting routed requests. If you are working with a fresh install of Jetty, you should remove the default Jetty files from the '''$JETTY_HOME/webapps''' and '''$JETTY_HOME/contexts''' folders.}}
 
  
 
Complete the following steps for each Web Services node.
 
Complete the following steps for each Web Services node.
  
−
'''Start'''
+
'''Start'''  
−
<br/>
+
 
−
<ol>
+
# Copy the '''installation_CD/ gws-<version>.noarch.rpm''' file to a local folder.
−
<li>Stop Jetty.</li>
+
# Perform the installation using the RPM package manager:
−
<li>Copy the '''jetty.xml''' file from '''''installation_CD''/jetty''' to '''$JETTY_HOME/etc'''.</li>
+
#: <tt>rpm -ivh [--prefix installation_location] gws-<version>.noarch.rpm</tt>
−
<li>Copy the '''cloud-web.xml''' file from '''''installation_CD''/jetty''' to '''$JETTY_HOME/webapps'''.</li>
+
#: If  --prefix is not specified, the default installation location is '''/usr/share''' folder.
−
<li>Copy the '''logback.xml''' file from '''''installation_CD''/jetty''' to '''$JETTY_HOME/resources'''.</li>
+
# Copy the <nowiki>*.sample</nowiki> files from the '''/installation_path/gws/config/config-templates''' directory to the '''/installation_path/gws/config''' directory and remove the '''.sample''' extension.  
−
<li>Copy the '''cloud-web.war''' file from '''''installation_CD''/webapp''' to '''$JETTY_HOME/webapps'''.</li>
+
# Run following command to register the new service on your host: <tt>chkconfig gws on</tt>
−
<li>Copy the configuration files from '''''installation_CD''/conf''' to a local folder of your choosing. For example, '''$JETTY_HOME/genconfig'''. </li>  
+
 
−
</ol>
 
−
<br/>
 
 
'''End'''  
 
'''End'''  
  
−
==Next Step==
+
==Next Steps==
−
*[[ConfigurationPremise|Configuring Web Services and Applications]]
+
# [[ConfigurationPremise|Configuring Web Services]]
 +
# [[InitializingCassandra|Initializing Cassandra]]
 +
# [[Documentation:HTCC:Dep:StartHTCC|Starting and Testing Web Services]]
 +
 
 +
==Installation package files==
 +
 
 +
=== Web Services configuration and initialization files (Red Hat Enterprise Linux 6)===
 +
 
 +
{| border="1"
 +
|-
 +
! File/folder name
 +
! Description
 +
|-
 +
| /etc/default/gws
 +
| The configuration file for the Web Services service.
 +
|-
 +
| /etc/init.d/gws
 +
| The initialization script for the Web Services service.
 +
|}
 +
 
 +
 
 +
===Web Services configuration and initialization files (Red Hat Enterprise Linux 7)===
 +
 
 +
{| border="1"
 +
|-
 +
! File/folder name
 +
! Description
 +
|-
 +
|-
 +
| /usr/bin/gws
 +
| The initialization script for the Web Services service.
 +
|-
 +
| /usr/lib/systemd/system/gws.service
 +
| The default configuration file for the Web Services service.
 +
 
 +
The following scripts extend service functionality on the Red Hat Enterprise Linux 7 platform:
 +
 
 +
* /usr/libexec/initscripts/legacy-actions/gws/config
 +
* /usr/libexec/initscripts/legacy-actions/gws/version
 +
|-
 +
| /usr/lib/systemd/system/gws.service.d/gws.conf
 +
| The custom configuration file for the Web Services service. The settings defined in this file override the default settings.
 +
|}
 +
 
 +
===Web Services and Applications files===
 +
 
 +
{| border="1"
 +
|-
 +
! File/folder name
 +
! Description
 +
|-
 +
| /installation_path/gws
 +
| The home directory of Web Services and Applications.
 +
|-
 +
| /installation_path/gws/gws.jar
 +
| The application .jar file.
 +
|}
 +
 
 +
===GWS Configuration files===
 +
 
 +
{| border="1"
 +
|-
 +
! File/folder name
 +
! Description
 +
|-
 +
| /installation_path/gws/config
 +
| The folder containing configuration files of Web Services and Applications, including:
 +
* /installation_path/gws/config/feature-definitions.json
 +
* /installation_path/gws/config/hystrix.properties
 +
* /installation_path/gws/config/logback.xml
 +
|-
 +
| /installation_path/gws/config-templates
 +
| The folder that contains templates of the Web Services and Applications configuration files. After installation, files from the folder must be modified according to ''Web Services and Applications Configuration Guide'' and moved to '''/installation_path/gws/config'''. The templates include:
 +
* /installation_path/gws/config-templates/application.yaml.sample
 +
* /installation_path/gws/config-templates/elasticsearch.yml.sample
 +
* /installation_path/gws/config-templates/statistics.yaml.sample
 +
|}
 +
 
 +
===Cassandra schema===
 +
 
 +
{| border="1"
 +
|-
 +
! File/folder name
 +
! Description
 +
|-
 +
| /installation_path/gws/data
 +
| The folder that contains scripts to deploy database schema. Files include:
 +
* Scripts for Cassandra schema deployment using the '''cqlsh''' tool:
 +
** /installation_path/gws/data/ks-schema-local.cql
 +
** /installation_path/gws/data/ks-schema-prod.cql
 +
** /installation_path/gws/data/ks-schema-prod_HA.cql
 +
** /installation_path/gws/data/cf-schema.cql
 +
* Scripts for Cassandra schema deployment using the '''cassandra-cli''' tool:
 +
** /installation_path/gws/data/ks-schema-local.txt
 +
** /installation_path/gws/data/ks-schema-prod.txt
 +
** /installation_path/gws/data/ks-schema-prod_HA.txt
 +
** /installation_path/gws/data/cf-schema.txt
 +
|}
 +
 
 +
===Elastic search templates and routing templates===
 +
 
 +
* /installation_path/gws/elasticsearch
 +
* /installation_path/gws/routing-templates
 +
 
  
 
[[Category:V:HTCC:8.5.2]]
 
[[Category:V:HTCC:8.5.2]]

Latest revision as of 07:40, June 25, 2019

Deploying the web application

Important


Complete the following steps for each Web Services node.

Start

  1. Copy the installation_CD/ gws-<version>.noarch.rpm file to a local folder.
  2. Perform the installation using the RPM package manager:
    rpm -ivh [--prefix installation_location] gws-<version>.noarch.rpm
    If --prefix is not specified, the default installation location is /usr/share folder.
  3. Copy the *.sample files from the /installation_path/gws/config/config-templates directory to the /installation_path/gws/config directory and remove the .sample extension.
  4. Run following command to register the new service on your host: chkconfig gws on

End

Next Steps

  1. Configuring Web Services
  2. Initializing Cassandra
  3. Starting and Testing Web Services

Installation package files

Web Services configuration and initialization files (Red Hat Enterprise Linux 6)

File/folder name Description
/etc/default/gws The configuration file for the Web Services service.
/etc/init.d/gws The initialization script for the Web Services service.


Web Services configuration and initialization files (Red Hat Enterprise Linux 7)

File/folder name Description
/usr/bin/gws The initialization script for the Web Services service.
/usr/lib/systemd/system/gws.service The default configuration file for the Web Services service.

The following scripts extend service functionality on the Red Hat Enterprise Linux 7 platform:

  • /usr/libexec/initscripts/legacy-actions/gws/config
  • /usr/libexec/initscripts/legacy-actions/gws/version
/usr/lib/systemd/system/gws.service.d/gws.conf The custom configuration file for the Web Services service. The settings defined in this file override the default settings.

Web Services and Applications files

File/folder name Description
/installation_path/gws The home directory of Web Services and Applications.
/installation_path/gws/gws.jar The application .jar file.

GWS Configuration files

File/folder name Description
/installation_path/gws/config The folder containing configuration files of Web Services and Applications, including:
  • /installation_path/gws/config/feature-definitions.json
  • /installation_path/gws/config/hystrix.properties
  • /installation_path/gws/config/logback.xml
/installation_path/gws/config-templates The folder that contains templates of the Web Services and Applications configuration files. After installation, files from the folder must be modified according to Web Services and Applications Configuration Guide and moved to /installation_path/gws/config. The templates include:
  • /installation_path/gws/config-templates/application.yaml.sample
  • /installation_path/gws/config-templates/elasticsearch.yml.sample
  • /installation_path/gws/config-templates/statistics.yaml.sample

Cassandra schema

File/folder name Description
/installation_path/gws/data The folder that contains scripts to deploy database schema. Files include:
  • Scripts for Cassandra schema deployment using the cqlsh tool:
    • /installation_path/gws/data/ks-schema-local.cql
    • /installation_path/gws/data/ks-schema-prod.cql
    • /installation_path/gws/data/ks-schema-prod_HA.cql
    • /installation_path/gws/data/cf-schema.cql
  • Scripts for Cassandra schema deployment using the cassandra-cli tool:
    • /installation_path/gws/data/ks-schema-local.txt
    • /installation_path/gws/data/ks-schema-prod.txt
    • /installation_path/gws/data/ks-schema-prod_HA.txt
    • /installation_path/gws/data/cf-schema.txt

Elastic search templates and routing templates

  • /installation_path/gws/elasticsearch
  • /installation_path/gws/routing-templates
This page was last edited on June 25, 2019, at 07:40.
Comments or questions about this documentation? Contact us for support!