Upgrade für Wartungsversion
Upgrade-Prozess für Wartungsversionen
Beim Upgrade auf eine Wartungsversion (beispielsweise 9.0.0 auf 9.0.1 oder 9.3.1 auf 9.3.2) wird der folgende vereinfachte Pfad für direkte Upgrades verwendet. Upgrade-Skripte sind für diese Upgrades nicht erforderlich.
 |
Dies setzt voraus, dass Sie ein Upgrade auf dieselbe Datenbank durchführen.
|
|
|
Wenn Sie ThingWorx Apps zusätzlich zu ThingWorx Platform verwenden, überprüfen Sie, ob die Version von ThingWorx, auf die Sie aktualisieren, von der ThingWorx Apps Version unterstützt wird. Weitere Informationen finden Sie im englischen Dokument ThingWorx Apps Upgrade Support Matrix (Support-Matrix für ThingWorx Apps Upgrade).
|
1. Wenn Sie auf eine ThingWorx Version aktualisieren, die die Content Security Policy (CSP) unterstützt, kopieren Sie web.xml aus "<tomcat_install_dir>/webapps/Thingworx/WEB-INF" zur späteren Verwendung in einen anderen Ordner.
3. Verifizieren Sie, ob die Datei "platform-settings.json" die folgenden ExtensionPackageImportPolicy-Parameter enthält, die auf "wahr" festgelegt sind, um das Importieren von Erweiterungen zuzulassen. Informationen zu optimalen Vorgehensweisen für die Konfiguration finden Sie in diesem Thema.
"ExtensionPackageImportPolicy": { "importEnabled": <true or false>, "allowJarResources": <true or false>, "allowJavascriptResources": <true or false>, "allowCSSResources": <true or false>, "allowJSONResources": <true or false>, "allowWebAppResources": <true or false>, "allowEntities": <true or false>, "allowExtensibleEntities": <true or false> },
4. Halten Sie Tomcat an.
5. Wechseln Sie zur Tomcat-Installation unter \Apache Software Foundation\Tomcat x.x\webapps, und löschen Sie die Datei Thingworx.war und den Ordner Thingworx.
6. Platzieren Sie die neue Thingworx.war unter \Apache Software Foundation\Tomcat x.x\webapps.
7. Starten Sie Tomcat.
8. Wenn das Upgrade mit dem folgenden Fehler fehlschlägt, fahren Sie mit dem nächsten Schritt fort. Dieser Fehler tritt auf, wenn ein benutzerdefinierter Indexwert 64 oder mehr Zeichen hat.
Unable to Invoke Service Reindex on Data Table : com.microsoft.sqlserver.jdbc.SQLServerException: String or binary data would be truncated in table 'thingworx.thingworx.data_table_indexes', column 'mskey'. Truncated value: '<with_actual_field_Value_from_mskey_field>'.
9. Führen Sie thingworxMssqlSchemaUpdate<vorherige Version>-to-<aktuelle Version>.bat/.sh (für MSSQL) oder thingworxAzureSchemaUpdate<vorherige Version>-to-<aktuelle Version>.bat/.sh (für Azure) aus.
sqlcmd -S server\\serverinstance,port -U db_user -P password -d databaseName -i <schemaUpdateFile.sql>
Durch Ausführung dieses Skripts wird die mskey-Spalte länger und Indizes werden aktualisiert.
Content Security Policy konfigurieren
1. Halten Sie Tomcat an.
2. Wenn Sie ein Upgrade auf ThingWorx 9.5.1 und höher durchführen, konfigurieren Sie die CSP, und fügen Sie in der Datei platform.settings.json im Abschnitt "BasicSettings" "EnableContentSecurityPolicyFilter": false, wie folgt hinzu:
{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/ThingworxBackupStorage",
"DatabaseLogRetentionPolicy": 7,
"DatabaseWriteRetryAttempts": 10,
"EnableBackup": true,
"EnableClusteredMode": false,
"EnableContentSecurityPolicyFilter": false,
"EnableSystemLogging": false,
"EnableSSO": false,
"FileRepositoryRoot": "/ThingworxStorage",
"FileTransferLockType" : "LOCAL"
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"InternalAesCryptographicKeyLength": 128,
"MetricsLoggingFrequency": 30,
"MetricsLoggingLevel": "WARN",
"MetricsReportingEnabled": true,
"NonceKeyTimeout": 15,
"SessionUpdateDelay": 60,
"Storage": "/ThingworxStorage",
"ScriptTimeout": 30,
"MaxSearchItems": 100000
},
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/ThingworxBackupStorage",
"DatabaseLogRetentionPolicy": 7,
"DatabaseWriteRetryAttempts": 10,
"EnableBackup": true,
"EnableClusteredMode": false,
"EnableContentSecurityPolicyFilter": false,
"EnableSystemLogging": false,
"EnableSSO": false,
"FileRepositoryRoot": "/ThingworxStorage",
"FileTransferLockType" : "LOCAL"
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"InternalAesCryptographicKeyLength": 128,
"MetricsLoggingFrequency": 30,
"MetricsLoggingLevel": "WARN",
"MetricsReportingEnabled": true,
"NonceKeyTimeout": 15,
"SessionUpdateDelay": 60,
"Storage": "/ThingworxStorage",
"ScriptTimeout": 30,
"MaxSearchItems": 100000
},
.
|
|
Die CSP wird in der neuen Installation deaktiviert, wenn das obige Flag nicht hinzugefügt wird oder wenn der Wert des Flags ausdrücklich auf false festgelegt wird. Die CSP wird aktiviert, indem das Flag auf true festgelegt wird.
Weitere Informationen zur CSP finden Sie in den anderen CSP-Themen im Hilfe-Center.
|
3. Führen Sie die nachfolgenden Schritte aus, um die Clickjack-Filterkonfigurationen wiederherzustellen.
a. Kopieren Sie die Konfigurationen des Clickjack-Filters aus der Sicherungsdatei web.xml.
b. Fügen Sie die Clickjack-Filter-Konfigurationen in die neu erstellte Datei web.xml unter <tomcat_install_dir>/webapps/Thingworx/WEB-INF ein.
|
|
Beachten Sie Folgendes:
• Ersetzen Sie die Datei web.xml nicht durch die ältere Version. Kopieren Sie die Konfigurationen manuell aus der Sicherungsdatei in die neue Datei web.xml.
• ThingWorx wird mit deaktiviertem CSP-Filter aktualisiert, wenn das Flag EnableContentSecurityPolicyFilter nicht ausdrücklich angegeben oder auf false festgelegt ist.
• Unter Content Security Policy finden Sie Informationen dazu, wie Sie die CSP zu einem späteren Zeitpunkt aktivieren oder deaktivieren können.
|
4. Starten Sie Tomcat.