Actualización de la versión de mantenimiento
Proceso de actualización de la versión de mantenimiento
La actualización de una versión de mantenimiento (por ejemplo, de 9.0.0 a 9.0.1 o de 9.3.1 a 9.3.2) utiliza la siguiente ruta de actualización local simplificada. No se necesitan scripts de actualización para estas actualizaciones.
 |
Con ello se supone que se está actualizando a la misma base de datos.
|
|
|
Si se utiliza ThingWorx Apps, además de ThingWorx Platform, verifique que la versión de ThingWorx a la que se está actualizando se soporta con la versión de ThingWorx Apps. Consulte ThingWorx Apps Upgrade Support Matrix.
|
1. Si se está actualizando a una versión de ThingWorx que soporte la directiva de seguridad del contenido (CSP), copie web.xml de "<directorio_de_instalación_de_tomcat>/webapps/Thingworx/WEB-INF" en otra carpeta para su uso posterior.
3. Verifique que en el fichero platform-settings.json se incluyen los siguientes parámetros ExtensionPackageImportPolicy definidos en verdadero para permitir la importación de las extensiones. Consulte este tema para conocer las prácticas recomendadas sobre la configuración.
"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. Detenga Tomcat.
5. Vaya a la instalación de Tomcat en \Apache Software Foundation\Tomcat x.x\webapps y borre el fichero Thingworx.war y la carpeta Thingworx.
6. Coloque el nuevo fichero Thingworx.war en \Apache Software Foundation\Tomcat x.x\webapps.
7. Inicie Tomcat.
8. Si la actualización falla con el siguiente error, vaya al paso siguiente. Este error se producirá si algún valor de índice personalizado es mayor o igual que 64 caracteres.
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. Ejecute thingworxMssqlSchemaUpdate<versiónAnterior>-to-<verisónActual>.bat/.sh (para MSSQL) o thingworxAzureSchemaUpdate<versiónAnterior>-to-<versiónActual>.bat/.sh (para Azure).
sqlcmd -S server\\serverinstance,port -U db_user -P password -d databaseName -i <schemaUpdateFile.sql>
Si se ejecuta este script, aumentará la longitud de la columna de mskey y se actualizarán los índices.
Configuración de la directiva de seguridad del contenido
1. Detenga Tomcat.
2. Si se está actualizando a ThingWorx 9.5.1 y versiones posteriores, configure CSP y añada "EnableContentSecurityPolicyFilter": false, a platform.settings.json en BasicSettings de la siguiente manera:
{
"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
},
|
|
CSP se desactivará en la nueva instalación si no se añade el señalizador anterior o si el señalizador se ha definido específicamente en false. Si el señalizador se define en true, se activará el CSP.
Para obtener más información sobre CSP, consulte los otros temas del centro de ayuda de CSP.
|
3. Siga los siguientes pasos para restaurar las configuraciones del filtro de secuestro de pulsaciones.
a. Copie las configuraciones del filtro de secuestro de pulsaciones de la copia de seguridad del fichero web.xml.
b. Pegue las configuraciones del filtro de secuestro de pulsaciones en el fichero web.xml recién creado en <directorio_de_instalación_de_tomcat>/webapps/Thingworx/WEB-INF.
|
|
Debe tenerse en cuenta lo siguiente:
• No reemplace el fichero web.xml por la versión anterior. Copie las configuraciones manualmente del fichero de copia de seguridad en el nuevo fichero web.xml.
• ThingWorx se actualizará con el filtro de CSP desactivado si el señalizador EnableContentSecurityPolicyFilter no se especifica o no se define en false explícitamente.
• Para activar o desactivar CSP en un momento posterior, consulte Directiva de seguridad del contenido.
|
4. Inicie Tomcat.