Java 11 Upgrade for Analytics Server - Windows
Before the Upgrade
The Java 11 upgrade procedure can only be started if you have completed the following tasks:
• Upgrade your Analytics Server to release 9.1.
• Install Java 11. For more information, see the Amazon Corretto.
Update the Service Files
Use the steps below to update the necessary service files.
1. Shut down your Analytics Server so that it is not running.
2. Note the following file paths related to your Java 11 installation:
◦ Java 11 bin directory – Sample file path: C:\Program Files\Amazon Corretto\jdk11.0.8_10\bin
◦ Java 11 executable – Sample file path: C:\Program Files\Amazon Corretto\jdk11.0.8_10\bin\java.exe
3. For each of the following service files, launch a command line prompt as an Administrator. When the command line window opens, enter the following command to open the NSSM program: nsmm edit <service name>. Update the variables listed in the table below.
◦ twas-analytics-worker-1
◦ twas-analytics-worker-2
◦ twas-analytics-worker-3
◦ twas-async-ms
◦ twas-sync-ms
◦ twas-twx-adapter
◦ twas-zookeeper
|
Variable
|
What to Update
|
Sample Configuration
|
|---|---|---|
|
Application Path
|
On the Application tab, point to the path of the Java 11 executable.
|
C:\Program Files\Amazon Corretto\jdk11.0.8_10\bin\java.exe
|
|
Startup Directory
|
On the pplication tab, point to the path of the Java 11 bin directory.
|
C:\Program Files\Amazon Corretto\jdk11.0.8_10\bin
|
Import SSL Certificates
If you have enabled SSL support using self-signed certificates, you must import certain certificate files into the Java 11 cacerts file. In some cases, you might need to extract the certificate files from your old Java cacerts before you can import them to the Java 11 file. Follow the instructions in the table below to import the necessary SSL certificate files.
 |
If you are using certificates from a trusted Certificate Authority, they will already be available in the Java 11 cacerts file.
|
|
Files
|
Instructions
|
|---|---|
|
ThingWorx SSL certificate
(a PEM or CER file)
|
Extract command:
keytool -keystore <path to ..\java8\jre\lib\security\cacerts> -alias<assigned certificate alias> -export-file<path and file name of the certificate>.cer
Import command:
keytool -keystore<path to ..\java11\lib\security\cacerts>-alias<assigned certificate alias> -import-trustcacerts -file<path and file name of the certificate>.cer
|
|
Analytics Server keystore
(a JKS file)
|
Import command:
keytool -importkeystore-srckeystore<path to the Analytics Server keystore>-destkeystore<path to ..\java11\lib\security\cacerts>
|
|
ZooKeeper
|
None. The ZooKeeper certificate does not need to be imported to the Java 11 cacerts file.
|
Final Upgrade Steps
1. Configure your JAVA_HOME environment variable to point to the path of the Java 11 installation directory.
2. Restart Analytics Server.