Migration

Upgrading from standalone to embedded Jetty

Complete the steps below for each Web Services node.
Start

1. Stop Web Services on the node.
2. If you installed Jetty as service, disable the service to prevent auto start and potential port conflicts.
3. Deploy the new version of Web Services.
4. Copy settings from your existing server-settings.yaml, onpremise-settings.yaml, and cassandra-cluster.yaml configuration files to the serverSettings, onPremiseSettings, and cassandraCluster sections of the application.yaml configuration file. See Configuring Web Services for more information about this file.
5. Copy settings from your existing Jetty configuration files to the jetty section of the application.yaml configuration file.
6. Adjust the logging section of the application.yaml configuration file.
7. Copy the JMV options from your exiting Jetty initialization script to the JAVA_OPTIONS variable in the /etc/default/gws file.
8. Start the new version of Web Services on the node.

End

Upgrading Cassandra between 8.5.2.x versions

Complete the steps below on the node node where you have installed cassandra-cli:

Start

1. Make note of your current Web Services and Applications version and the version you're planning to upgrade.
2. Copy the install CD/data directory to the Cassandra node.
3. In the data directory, notice that there are text files, cf-schema-<version>.txt, for each version of Web Services and Applications. You'll need to run all the Cassandra upgrade scripts after your currently installed version until your upgrade version. For example, if your previous version was 8.5.200.64 and your current version is 8.5.200.96, you'll need the following scripts:
   • cf-schema-8.5.200.66.txt
   • cf-schema-8.5.200.68.txt
   • cf-schema-8.5.200.81.txt
   • cf-schema-8.5.200.83.txt
   • cf-schema-8.5.200.90.txt
4. For each cf-schema-<version>.txt file, run the following command to update the Cassandra schema:

   cassandra_install_dir/bin/cassandra-cli  -h cassandra_host --file cf-schema-<version>.txt

   • cassandra_install_dir is where Cassandra is installed on the node.
   • cassandra_host is the host name (FQDN) or IP of the Cassandra node.

End

[+] Migrating from 8.5.1 to 8.5.2

Migrating from 8.5.1 to 8.5.2

Start

1. Stop Jetty on all the Web Services nodes.
2. Update Cassandra with all cf-schema-<version>.txt files in the install_CD/data directory.
   1. Copy the install CD/data directory to the Cassandra node host.
   Important
   You must run these scripts in order, beginning with cf-schema-8.5.100.01.txt.
   2. For each cf-schema-<version>.txt file, run the following command to update the Cassandra schema:

cassandra_install_dir/bin/cassandra-cli -h cassandra_host --file cf-schema-<version>.txt

• cassandra_host is the host name (FQDN) or IP of the Cassandra node

For each Web Services node, complete the following steps:

1. Complete the Deploying the web application procedure.
Tip
Make a backup of your configuration folder ($JETTY_HOME/genconfig) to use as a reference for setting configuration options.
2. Review Configuring Web Services and its sub-topics and set the options required for your deployment.
   The following configuration options have been modified in the $JETTY_HOME/genconfig/server-settings.yaml file in 8.5.1:

   Option	Type of Change
   activationTimeout	The default value changed from 1000 to 12000.
   connectionTimeout	The default value changed from 400 to 4000.
   cmeAuthenticationEnabled	Removed

3. Complete Starting and Testing.

End