RTPPM Upgrade Installer
 |
It is recommended to take a snapshot of the server before beginning the upgrade process as a best practice.
|
Upgrade Installation
1. Before beginning, ensure that the timeout setting has been updated within Apache Tomcat. If it has not, click here for instructions.
2. You need to disable the KPI Engine timer. Navigate to the General Information tab in the PTC.SCA.SCO.KPIEngineTimerThing thing in the Composer.
◦ For ThingWorx Platform 8.5.x, clear the Enabled checkbox.
◦ For ThingWorx Platform 9.3.x onwards, clear the Automatically Enable Timer on Startup checkbox.
3. Click on the Save button.
4. If you are using Core version 4.0.0 or earlier, ensure that the steps in Rename SQL Thing and Thing Template When Installing RTPPM are followed until step 4. If you are using a later version of Core, skip this step.
5. If you are using Core version 4.0.0 or earlier, perform the steps below. If you are using a later version of Core, skip this step.
If the current ThingWorx instance has a custom manager or Utils Thing with any of the three Thing Shapes associated below associated, the Thing Shapes must be removed before performing the upgrade. The upgrade will automatically add the Thing Shapes and result in an error if they are not removed prior to beginning.
◦ PTC.SCA.SCO.MnfgCommonDBHelper
◦ PTC.SCA.SCO.DBManagementThingShape
◦ PTC.SCA.SCO.MNFGCommonToolboxHelperThingShape
6. Unzip the installation package.
7. Identify the folder containing the installer files: install-tw-apps-win.exe and install-tw-apps-linux.
8. Launch the installer file for your operating system to run the installer.
9. A question will display asking for the package files location (The default location is the same as the folder identified in step 2). Enter the file location and press Enter.
10. A message will appear displaying the extensions found in the file location. Confirm the files found match what should be installed. Ensure that at least the CORE, CORE-UI, KPI-ENGINE, and RTPPM extension packages are present.
11. Enter the required data for the questions that appear in the UI. Refer to the table below to see the questions, default values, and any extra information you may require to answer the questions.
| | If you have entered your own names during the original installation, rather than accepting the default names, be sure to enter those same names during the upgrade process. |
Installation Questions | Default Value | Notes |
|---|---|---|
ThingWorx url: | Localhost: <port> | The URL of your ThingWorx instance. Note that the port number MUST be included. |
Does ThingWorx use TLS: | N | Does the browser instance of ThingWorx use HTTPS? Y or N. |
ThingWorx admin user name: | Administrator | A user that is in the Administrator user group. |
ThingWorx password: | N/A | No text will display while entering password. |
MSSQL Database server name: | localhost | Hostname of the server where the database is installed. |
MSSQL Database port: | <port> | Communication port to on the server where the database is installed. |
MSSQL Database name: | <databasename> | The database chosen must: • Already exist in the SQL Server. • Have no data populated. • Not be used by Manufacturing Apps, DPM, or any other ThingWorx extension. |
MSSQL Database username: | N/A | The username used to login to the MSSQL database |
MSSQL Database password: | N/A | No text will display while entering password. |
Core Database Thing name: | PTCFSU.CoreSQLThing | Thing containing logic to interact with the database. |
Core Database ThingTemplate name: | PTCFSU.CoreSQLThingTemplate | Thing Template containing logic to interact with the database. |
Core Database Project name: | PTCFSU.DefaultProject | Project to which the Thing and Thing Template belong. |
KPI Engine Database ThingTemplateName: | PTCFSU.KPIEngineSQLThing | Thing Template containing logic to interact with the database. |
KPI Engine Database ThingName | PTCFSU.KPIEngineSQLThingTemplate | Thing containing logic to interact with the database. |
KPI Engine Project name: | PTCFSU.DefaultProject | Project to which the Thing and Thing Template belong. |
12. Once completed, a confirmation message will display "Your configuration is: ..." followed by the configuration discovered by the program, including which extensions will be updated and which will be unchanged. For the extensions that are being updated, the current version (version currently installed) and the new version (version to which you are upgrading) are listed.
Enter Y if correct and to begin the installation or N if incorrect and to repeat the questions.
| | If no value is entered for the confirmation and ENTER is pressed, the questions will restart by default. |
13. The program will begin running. Depending on the version of ThingWorx that you have upgraded from, the installer will ask to restart one or more times to update FSU Document Converter 1.1.0, Mail_Extesions 4.0.0, or both. Confirm the restart when prompted.
14. When the program runs successfully the message ThingWorx Applications installation completed will display.
If any errors occur they will display in red or yellow. Check the ThingWorx Application and Script logs for more details and refer to Installation Troubleshooting for more information on errors.
| | When using the ThingWorx Applications on ThingWorx Platform 8.5.7, the default "Administrator" user may not function properly within the application. To correct this Apache Tomcat must be restarted. |
15. To enable the KPI Engine timer if not already enabled, complete the following steps:
a. In the ThingWorx Composer navigate to PTC.SCA.SCO.KPIEngineTimerThing.
b. In the General Information tab, enable the timer flag as below:
For ThingWorx Platform 8.5.x – Select the Enabled checkbox.
For ThingWorx Platform 9.3.x onwards – Select the Automatically Enable Timer on Startup checkbox.
c. Click Save.
d. In the Properties and Alerts tab, check that the Enabled property is selected.
e. In the Subscriptions tab, navigate to the RefreshCache subscription. Ensure Enabled checkbox is selected.
16. If you are using Core version 4.0.0 or earlier, resume from step 5 in Rename SQL Thing and Thing Template. If you are using a later version of Core, skip this step.