Upgrading Java software

After an initial Voice Platform deployment, you can upgrade the Java installation to newer releases (so long as they are supported as described in the Release Notes).

General upgrade practices:

  • Install and configure Java on each Voice Platform host.
  • Import certificates for Voice Browser service into the new keystore on each host.

This procedure upgrades Java on a single Linux system. Repeat for each host as needed. You can use this procedure as a model for upgrading Windows systems.

  1. Download your desired Java.
  2. Install Java on the host. For example, Zulu OpenJDK:
    sudo yum install zulu8.66.0.15-ca-jdk8.0.352-linux.x86_ 64.rpm
  3. Edit these files and provide the new JAVA_HOME path:

    /etc/profile.d/500-SETUP-nuance-vbs32.csh

    /etc/profile.d/500-SETUP-nuance-vbs32.sh

    /etc/profile.d/950-SETUP-nuance-voice-platform.csh

    /etc/profile.d/950-SETUP-nuance-nuance-voice-platform.sh

  4. Confirm that your bash profile file uses the new JAVA_HOME path. (The bash profile takes precedence over the new path in JAVA_HOME.)

  5. Import the certificates for Voice Browser service to the new keystore. (By default, it's not necessary to import certificates to Voice Browser service. It's only needed when the service is configured to use secure connections as described in Configuring Voice Platform security. Specifically, repeat these commands: 

    > keytool -importcert -keystore server.jks -alias clientcert -file client-public.cer -storepass storepassword -noprompt
    > keytool -importcert -keystore client.jks -alias servercert -file server-public.cer -storepass storepassword -noprompt
  6. Restart the host

  7. Confirm that the Java path is correct from the command line: echo $JAVA_HOME
  8. Check the configuration of the JAVA_HOME path in: /etc/profile.d/900-SETUP-nuance-speech-suite.sh
  9. Start services and confirm they are running.