Jump to: navigation, search
(Update with the copy of version: 8.5.2DRAFT)
Line 1: Line 1:
−
=Upgrading from 8.5.201.18 to 8.5.201.76=
+
=Upgrading from 8.5.201.18 to 8.5.201.84=
  
−
# Stop Web Services and Applications on the node.
+
<ol>
−
# Install Java 8 on the node according to [[MigJavaMigration|Migrating from Java 7 to Java 8]].
+
<li> Stop Web Services and Applications on the node.</li>
−
# Backup your old installation and configuration files.
+
<li> Install Java 8 on the node according to [[MigJavaMigration|Migrating from Java 7 to Java 8]].</li>
−
#: You might need the files if you need to rollback your upgrade at a later date. Make sure to back up the following files if you configured the previous version as a service:
+
<li> Back up your old installation and configuration files in case you need to rollback your upgrade at a later date. Make sure to back up the following files if you configured the previous version as a service:
−
#* '''/etc/init.d/gws'''
+
<ul>
−
#* '''/etc/default/gws'''
+
<li> '''/etc/init.d/gws'''</li>
−
#Remove the following service initialization scripts from the host:
+
<li> '''/etc/default/gws'''</li>
−
#* '''/etc/init.d/gws'''
+
</ul></li>
−
#* '''/etc/default/gws'''  
+
<li> Remove the following service initialization scripts from the host:
−
# [[Documentation:HTCC:Dep:DeployWebApp|Deploy the new version of Web Services and Applications]].
+
<ul>
−
# Copy the following configuration files from the configuration folder in your previous installation into the '''config''' folder in the home directory of the new installation:
+
<li> '''/etc/init.d/gws'''</li>
−
#* '''application.yaml'''
+
<li> '''/etc/default/gws'''</li>
−
#* '''elasticsearch.yml'''
+
</ul></li>
−
#* '''hystrix.properties'''
+
<li> [[Documentation:HTCC:Dep:DeployWebApp|Deploy the new version of Web Services and Applications]].</li>
−
#* '''logback.xml'''
+
<li> Copy the following configuration files from the configuration folder in your previous installation into the '''config''' folder in the home directory of the new installation:
−
#* '''statistics.yaml'''
+
<ul>
−
# On the Red Hat Linux 6 platform, open the '''/etc/default/gws''' file and update the following environment variables to values appropriate for your Web Services and Applications node:  
+
<li> '''application.yaml'''</li>
−
#* '''GWS_HOST''': This value must match the '''host''' value defined in the '''jetty''' section of the '''application.yaml''' file.
+
<li> '''elasticsearch.yml'''</li>
−
#* '''GWS_PORT''': This value must match '''port''' value defined in the '''jetty''' section of the '''application.yaml''' file.
+
<li> '''hystrix.properties'''</li>
−
# Update the '''application.yaml''' file with the new path to the '''logback.xml''' file.
+
<li> '''logback.xml'''</li>
−
# Adjust the '''updateOnStartup''' option in the '''application.yaml'''. See  [[MigConfigNewOptions#DeployUpdate|Web Services and Applications deployment update]].
+
<li> '''statistics.yaml'''</li>
−
# Update the Cassandra schema:
+
</ul></li>
−
#* If you are using Cassandra 2.x:
+
<li> On the Red Hat Linux 6 platform, open the '''/etc/default/gws''' file and update the following environment variables to values appropriate for your Web Services and Applications node:  
−
#*# Copy the '''cf-schema-8.5.201.68.cql''' file from <tt>/installation_path/gws/data/updates</tt> to the Cassandra node host.
+
<ul>
−
#*# Run the following command: <source lang="text">cqlsh cassandra_host --file cf-schema-8.5.201.68.cql</source>
+
<li> '''GWS_HOST''': This value must match the '''host''' value defined in the '''jetty''' section of the '''application.yaml''' file.</li>
−
#* If you are using Cassandra 1.2:
+
<li> '''GWS_PORT''': This value must match '''port''' value defined in the '''jetty''' section of the '''application.yaml''' file.</li>
−
#*# Copy the '''cf-schema-8.5.201.68.txt''' file from <tt>/installation_path/gws/data/updates</tt> to the Cassandra node host.
+
</ul></li>
−
#*# Run the following command: <source lang="text">cassandra_install_dir/bin/cassandra-cli -h cassandra_host --file cf-schema-8.5.201.68.txt</source>
+
<li> Update the '''application.yaml''' file with the new path to the '''logback.xml''' file.</li>
−
# Start Web Services and Applications according to [[Documentation:HTCC:Dep:StartHTCC|Starting and testing]].
+
<li> Adjust the '''updateOnStartup''' option in the '''application.yaml'''. See  [[MigConfigNewOptions#DeployUpdate|Web Services and Applications deployment update]].</li>
−
# After all Web Services and Applications nodes are upgraded and started, update ElasticSearch:
+
<li> Update the Cassandra schema:
−
#* If you use embedded Elasticsearch, run the following script on ''one'' Web Services and Applications node: <source lang="text">/installation_path/gws/tools/rebuild-es-index.sh</source>
+
<ul>
−
#* If you use standalone Elasticsearch:
+
<li> If you are using Cassandra 2.x:
−
#*# Copy files from the <tt>/installation_path/gws/elasticsearch/templates</tt> folder to the templates folder on each Elasticsearch node.
+
<ol type=a>
−
#*# Run the following script on ''one'' Web Services and Applications node: <source lang="text">/installation_path/gws/tools/rebuild-es-index.sh</source>
+
<li> Copy the '''cf-schema-8.5.201.84.cql''' file from <tt>/installation_path/gws/data/updates</tt> to the Cassandra node host.</li>
 +
<li> Run the following command:
 +
<source lang="text">
 +
cqlsh cassandra_host --file cf-schema-8.5.201.84.cql
 +
</source></li>
 +
</ol></li>
 +
<li> If you are using Cassandra 1.2:
 +
<ol type=a>
 +
<li> Copy the '''cf-schema-8.5.201.84.txt''' file from <tt>/installation_path/gws/data/updates</tt> to the Cassandra node host.</li>
 +
<li> Run the following command:
 +
<source lang="text">
 +
cassandra_install_dir/bin/cassandra-cli -h cassandra_host --file cf-schema-8.5.201.84.txt
 +
</source></li>
 +
</ol></li>
 +
</ul></li>
 +
<li> Start Web Services and Applications according to [[Documentation:HTCC:Dep:StartHTCC|Starting and testing]].</li>
 +
<li> After all Web Services and Applications nodes are upgraded and started, update ElasticSearch:
 +
<ul>
 +
<li> If you use embedded Elasticsearch, run the following script on ''one'' Web Services and Applications node: <source lang="text">
 +
/installation_path/gws/tools/rebuild-es-index.sh
 +
</source></li>
 +
<li> If you use standalone Elasticsearch:
 +
<ol type=a>
 +
<li> Copy files from the <tt>/installation_path/gws/elasticsearch/templates</tt> folder to the templates folder on each Elasticsearch node.</li>
 +
<li> Run the following script on ''one'' Web Services and Applications node:  
 +
<source lang="text">
 +
/installation_path/gws/tools/rebuild-es-index.sh
 +
</source></li>
 +
</ol></li>
 +
</ul></li>
 +
</ol>
  
 
[[Category:V:HTCC:8.5.2]]
 
[[Category:V:HTCC:8.5.2]]

Revision as of 16:41, July 14, 2017

Upgrading from 8.5.201.18 to 8.5.201.84

  1. Stop Web Services and Applications on the node.
  2. Install Java 8 on the node according to Migrating from Java 7 to Java 8.
  3. Back up your old installation and configuration files in case you need to rollback your upgrade at a later date. Make sure to back up the following files if you configured the previous version as a service:
    • /etc/init.d/gws
    • /etc/default/gws
  4. Remove the following service initialization scripts from the host:
    • /etc/init.d/gws
    • /etc/default/gws
  5. Deploy the new version of Web Services and Applications.
  6. Copy the following configuration files from the configuration folder in your previous installation into the config folder in the home directory of the new installation:
    • application.yaml
    • elasticsearch.yml
    • hystrix.properties
    • logback.xml
    • statistics.yaml
  7. On the Red Hat Linux 6 platform, open the /etc/default/gws file and update the following environment variables to values appropriate for your Web Services and Applications node:
    • GWS_HOST: This value must match the host value defined in the jetty section of the application.yaml file.
    • GWS_PORT: This value must match port value defined in the jetty section of the application.yaml file.
  8. Update the application.yaml file with the new path to the logback.xml file.
  9. Adjust the updateOnStartup option in the application.yaml. See Web Services and Applications deployment update.
  10. Update the Cassandra schema:
    • If you are using Cassandra 2.x:
      1. Copy the cf-schema-8.5.201.84.cql file from /installation_path/gws/data/updates to the Cassandra node host.
      2. Run the following command: 
        cqlsh cassandra_host --file cf-schema-8.5.201.84.cql
    • If you are using Cassandra 1.2:
      1. Copy the cf-schema-8.5.201.84.txt file from /installation_path/gws/data/updates to the Cassandra node host.
      2. Run the following command: 
        cassandra_install_dir/bin/cassandra-cli -h cassandra_host --file cf-schema-8.5.201.84.txt
  11. Start Web Services and Applications according to Starting and testing.
  12. After all Web Services and Applications nodes are upgraded and started, update ElasticSearch:
    • If you use embedded Elasticsearch, run the following script on one Web Services and Applications node: 
      /installation_path/gws/tools/rebuild-es-index.sh
    • If you use standalone Elasticsearch:
      1. Copy files from the /installation_path/gws/elasticsearch/templates folder to the templates folder on each Elasticsearch node.
      2. Run the following script on one Web Services and Applications node: 
        /installation_path/gws/tools/rebuild-es-index.sh
Comments or questions about this documentation? Contact us for support!