Jump to: navigation, search
(Update with the copy of version: 8.5.2DRAFT)
 
(17 intermediate revisions by 8 users not shown)
Line 1: Line 1:
−
=Upgrading from 8.5.201.18 to 8.5.201.76=
+
=Upgrading from 8.5.201.18 to 8.5.203.03=
 +
 
 +
Use the following procedure to upgrade from 8.5.201.18.
  
 
# Stop Web Services and Applications on the node.
 
# Stop Web Services and Applications on the node.
−
# Install Java 8 on the node according to [[MigJavaMigration|Migrating from Java 7 to Java 8]].
+
# Migrate to OpenJDK 8 according to [[Documentation:HTCC:MIG:MigOpenJDKMigration:8.5.2|Migrating to OpenJDK 1.8.0]].
−
# 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'''
 
#* '''/etc/init.d/gws'''
 
#* '''/etc/default/gws'''
 
#* '''/etc/default/gws'''
−
#Remove the following service initialization scripts from the host:
+
# Remove the following service initialization scripts from the host:
 
#* '''/etc/init.d/gws'''
 
#* '''/etc/init.d/gws'''
−
#* '''/etc/default/gws'''  
+
#* '''/etc/default/gws'''
 
# [[Documentation:HTCC:Dep:DeployWebApp|Deploy the new version of Web Services and Applications]].
 
# [[Documentation:HTCC:Dep:DeployWebApp|Deploy the new version of Web Services and Applications]].
 
# 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:
 
# 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:
Line 23: Line 24:
 
# Adjust the '''updateOnStartup''' option in the '''application.yaml'''. See  [[MigConfigNewOptions#DeployUpdate|Web Services and Applications deployment update]].
 
# Adjust the '''updateOnStartup''' option in the '''application.yaml'''. See  [[MigConfigNewOptions#DeployUpdate|Web Services and Applications deployment update]].
 
# Update the Cassandra schema:
 
# Update the Cassandra schema:
−
#* If you are using Cassandra 2.x:
+
#* If you are using Cassandra 2.x:  
−
#*# Copy the '''cf-schema-8.5.201.68.cql''' file from <tt>/installation_path/gws/data/updates</tt> to the Cassandra node host.
+
#** 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.
−
#*# Run the following command: <source lang="text">cqlsh cassandra_host --file cf-schema-8.5.201.68.cql</source>
+
#** Run the following command: <source lang="text">cqlsh cassandra_host --file cf-schema-8.5.201.84.cql</source>
 +
#** 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.
 +
#** Run the following command: <source lang="text">cqlsh cassandra_host --file cf-schema-8.5.202.34.cql</source>
 +
#** Copy the <tt>cf-schema-8.5.202.81.cql</tt> file from /installation_path/gws/data/updates to the Cassandra node host.
 +
#** Run the following command: <source lang="text">
 +
cqlsh cassandra_host --file cf-schema-8.5.202.81.cql</source>
 
#* If you are using Cassandra 1.2:
 
#* If you are using Cassandra 1.2:
−
#*# Copy the '''cf-schema-8.5.201.68.txt''' file from <tt>/installation_path/gws/data/updates</tt> to the Cassandra node host.
+
#** 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.
−
#*# 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>
+
#** 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>
 +
#** 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.
 +
#** 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>
 +
#** Copy the <tt>cf-schema-8.5.202.81.txt</tt> file from /installation_path/gws/data/updates to the Cassandra node host.
 +
#** Run the following command: <source lang="text">
 +
cassandra_install_dir/bin/cassandra-cli -h cassandra_host --file cf-schema-8.5.202.81.txt</source>
 
# Start Web Services and Applications according to [[Documentation:HTCC:Dep:StartHTCC|Starting and testing]].
 
# Start Web Services and Applications according to [[Documentation:HTCC:Dep:StartHTCC|Starting and testing]].
−
# After all Web Services and Applications nodes are upgraded and started, update ElasticSearch:
+
# 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: <source lang="text">/installation_path/gws/tools/rebuild-es-index.sh</source>
+
#* 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>
 
#* If you use standalone Elasticsearch:
 
#* If you use standalone Elasticsearch:
−
#*# Copy files from the <tt>/installation_path/gws/elasticsearch/templates</tt> folder to the templates folder on each Elasticsearch node.
+
#** Copy files from the <tt>/installation_path/gws/elasticsearch/templates</tt> folder to the templates folder on each Elasticsearch node.
−
#*# Run the following script on ''one'' Web Services and Applications node: <source lang="text">/installation_path/gws/tools/rebuild-es-index.sh</source>
+
#** Run the following script on ''one'' Web Services and Applications node: <source lang="text">
 +
/installation_path/gws/tools/rebuild-es-index.sh
 +
</source>
  
 
[[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.18 to 8.5.203.03

Use the following procedure to upgrade from 8.5.201.18.

  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!