Jump to: navigation, search
(Update with the copy of version: 8.5.2DRAFT)
(Update with the copy of version: 8.5.2DRAFT)
 
(15 intermediate revisions by 8 users not shown)
Line 1: Line 1:
−
=Upgrading from 8.5.201.29 to 8.5.201.84=
+
=Upgrading from 8.5.201.29 to 8.5.203.03=
  
−
<ol>
+
# Stop Web Services and Applications on the node.
−
<li> Stop Web Services and Applications on the node.</li>
+
# Migrate to OpenJDK 8 according to [[Documentation:HTCC:MIG:MigOpenJDKMigration:8.5.2|Migrating to OpenJDK 1.8.0]].
−
<li> Backup your old installation and configuration files.
+
# Backup your old installation and configuration files. 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:
−
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:
+
#* '''/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 <tt>cf-schema-8.5.201.84.cql</tt> 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.84.cql</source>
−
<li> '''GWS_HOST''': This value must match the '''host''' value defined in the '''jetty''' section of the '''application.yaml''' file.</li>
+
#** Copy the <tt>cf-schema-8.5.202.34.cql</tt> file from <tt>/installation_path/gws/data/updates</tt> to the Cassandra node host.
−
<li> '''GWS_PORT''': This value must match '''port''' value defined in the '''jetty''' section of the '''application.yaml''' file.</li>
+
#** Run the following command: <source lang="text">cqlsh cassandra_host --file cf-schema-8.5.202.34.cql</source>
−
</ul></li>
+
#** Copy the <tt>cf-schema-8.5.202.81.cql</tt> file from /installation_path/gws/data/updates to the Cassandra node host.
−
<li> Update the '''application.yaml''' file with the new path to the '''logback.xml''' file.</li>
+
#** Run the following command: <source lang="text">
−
<li> Adjust the '''updateOnStartup''' option in the '''application.yaml'''. See  [[MigConfigNewOptions#DeployUpdate|Web Services and Applications deployment update]].</li>
+
cqlsh cassandra_host --file cf-schema-8.5.202.81.cql</source>
−
<li> Update the Cassandra schema:
+
#* If you are using Cassandra 1.2:
−
<ul>
+
#** Copy the <tt>cf-schema-8.5.201.84.txt</tt> file from <tt>/installation_path/gws/data/updates</tt> to the Cassandra node host.
−
<li> If you are using Cassandra 2.x:
+
#** Run the following command: <source lang="text">cassandra_install_dir/bin/cassandra-cli -h cassandra_host --file cf-schema-8.5.201.84.txt
−
<ol type=a>
+
</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>
+
#** Copy the <tt>cf-schema-8.5.202.34.txt</tt> file from <tt>/installation_path/gws/data/updates</tt> to the Cassandra node host.
−
<li> Run the following command:
+
#** Run the following command: <source lang="text">cassandra_install_dir/bin/cassandra-cli -h cassandra_host --file cf-schema-8.5.202.34.txt
−
<source lang="text">
+
</source>
−
cqlsh cassandra_host --file cf-schema-8.5.201.84.cql
+
#** Copy the <tt>cf-schema-8.5.202.81.txt</tt> file from /installation_path/gws/data/updates to the Cassandra node host.
−
</source></li>
+
#** Run the following command: <source lang="text">
−
</ol></li>
+
cassandra_install_dir/bin/cassandra-cli -h cassandra_host --file cf-schema-8.5.202.81.txt</source>
−
<li> If you are using Cassandra 1.2:
+
# Start Web Services and Applications according to [[Documentation:HTCC:Dep:StartHTCC|Starting and testing]].
−
<ol type=a>
+
# After all Web Services and Applications nodes are upgraded and started, update Elasticsearch:
−
<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>
+
#* If you use embedded Elasticsearch, run the following script on ''one'' Web Services and Applications node: <source lang="text">
−
<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
 
/installation_path/gws/tools/rebuild-es-index.sh
 
</source>
 
</source>
−
<li> If you use standalone Elasticsearch:
+
#* If you use standalone Elasticsearch:
−
<ol type=a>
+
#** Copy files from the <tt>/installation_path/gws/elasticsearch/templates</tt> folder to the templates folder on each Elasticsearch node.
−
<li> Copy files from the <tt>/installation_path/gws/elasticsearch/templates</tt> folder to the templates folder on each Elasticsearch node.</li>
+
#** Run the following script on ''one'' Web Services and Applications node: <source lang="text">
−
<li> Run the following script on ''one'' Web Services and Applications node:  
 
−
<source lang="text">
 
 
/installation_path/gws/tools/rebuild-es-index.sh
 
/installation_path/gws/tools/rebuild-es-index.sh
−
</source></li>
+
</source>
−
</ol></li>
 
−
</ul></li>
 
−
</ol>
 
  
 
[[Category:V:HTCC:8.5.2]]
 
[[Category:V:HTCC:8.5.2]]

Latest revision as of 06:22, July 7, 2023

Upgrading from 8.5.201.29 to 8.5.203.03

  1. Stop Web Services and Applications on the node.
  2. Migrate to OpenJDK 8 according to Migrating to OpenJDK 1.8.0.
  3. Backup your old installation and configuration files. 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:
    • /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:
      • Copy the cf-schema-8.5.201.84.cql file from /installation_path/gws/data/updates to the Cassandra node host.
      • Run the following command: 
        cqlsh cassandra_host --file cf-schema-8.5.201.84.cql
      • Copy the cf-schema-8.5.202.34.cql file from /installation_path/gws/data/updates to the Cassandra node host.
      • Run the following command: 
        cqlsh cassandra_host --file cf-schema-8.5.202.34.cql
      • Copy the cf-schema-8.5.202.81.cql file from /installation_path/gws/data/updates to the Cassandra node host.
      • Run the following command: 
        cqlsh cassandra_host --file cf-schema-8.5.202.81.cql
    • If you are using Cassandra 1.2:
      • Copy the cf-schema-8.5.201.84.txt file from /installation_path/gws/data/updates to the Cassandra node host.
      • Run the following command: 
        cassandra_install_dir/bin/cassandra-cli -h cassandra_host --file cf-schema-8.5.201.84.txt
      • Copy the cf-schema-8.5.202.34.txt file from /installation_path/gws/data/updates to the Cassandra node host.
      • Run the following command: 
        cassandra_install_dir/bin/cassandra-cli -h cassandra_host --file cf-schema-8.5.202.34.txt
      • Copy the cf-schema-8.5.202.81.txt file from /installation_path/gws/data/updates to the Cassandra node host.
      • Run the following command: 
        cassandra_install_dir/bin/cassandra-cli -h cassandra_host --file cf-schema-8.5.202.81.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:
      • Copy files from the /installation_path/gws/elasticsearch/templates folder to the templates folder on each Elasticsearch node.
      • Run the following script on one Web Services and Applications node: 
        /installation_path/gws/tools/rebuild-es-index.sh
This page was last edited on July 7, 2023, at 06:22.
Comments or questions about this documentation? Contact us for support!