Documentation:HTCC:MIG:UpgradeFrom29plus:8.5.2DRAFT

Upgrading from 8.5.201.29 to 8.5.202.86

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