Migración manual a ThingWorx 9.x: Windows
Consulte la tabla de actualización para determinar la ruta de actualización. Los siguientes pasos solo son para la migración. Para una actualización local, consulte Actualización manual local: Windows.
A) Antes de la actualización
1. Antes de comenzar la actualización, se recomienda realizar lo siguiente:
◦ Volcado de la base de datos
◦ Realice una copia de seguridad de todos los datos de las carpetas ThingworxStorage y ThingworxPlatform.
◦ Realice una copia de seguridad de la carpeta Tomcat_home. Esto incluye las carpetas bin, conf, lib, temp, webapps y work.
2. Si se utiliza ThingWorx Apps además de ThingWorx Platform:
a. 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.
b. Se deben seguir algunos pasos antes de actualizar la plataforma. Consulte Upgrading ThingWorx Apps antes de continuar con el siguiente paso.
3. Obtenga la versión más reciente de ThingWorx en Descargas de software de PTC.
4. Si también se ha instalado Navigate, verifique la compatibilidad en ThingWorx Navigate Compatibility Matrix.
5. Verifique que se estén ejecutando las versiones requeridas de Tomcat y Java. Consulte la sección Requisitos del sistema para conocer los requisitos de la versión.
 | Si es necesario actualizar la versión de Java, realice la actualización de ThingWorx antes de actualizar Java. |
6. Los requisitos de configuración de la opción de Tomcat Java pueden cambiar entre versiones. Consulte Configuración de la opción de Apache Tomcat Java para verificar que la configuración sea correcta.
7. Si se actualiza MSSQL, Azure SQL o H2, la actualización fallará si falta alguno de los valores de campo de índice personalizado en las tablas de datos. Verifique que todos los campos de índice personalizados tengan valores antes de iniciar el proceso de actualización.
| | Si no lo hace, la actualización no se realizará correctamente y se tendrá que volver a implementar la versión anterior (si se han realizado actualizaciones del esquema, se debe revertir o restaurar la base de datos), añadir los valores de índice que faltan o quitar los índices personalizados de la tabla de datos y, a continuación, realizar la actualización. |
8. Añada lo siguiente a las opciones de Java de Apache Tomcat:
-Dlog4j2.formatMsgNoLookups=true
B) Exportación de datos y entidades
1. Detenga Tomcat: en las propiedades de Tomcat, pulse en Stop. Espere a que Tomcat detenga su ejecución.
2. Se recomienda encarecidamente realizar una copia de seguridad de las siguientes carpetas antes de continuar:
◦ Apache Software Foundation\Tomcat x.x\webapps\Thingworx
◦ <ubicación de instalación de Tomcat>:\\ThingworxStorage
3. Inicie Tomcat: en las propiedades de Tomcat, pulse en Start. Al reiniciar Tomcat se asegura de que la base de datos esté despejada antes de la exportación.
4. Exportar entidades y datos:
a. En Composer, pulse en Importar/Exportar > Exportar > <opción de exportación>.
| | Para obtener más información sobre las opciones de exportación, consulte Importación y exportación de datos, entidades y extensiones. |
b. Si fuera necesario, pulse en Incluir datos.
Los datos y las entidades se exportan a ThingworxStorage/exports.
| | El progreso de la exportación de datos se puede supervisar en el registro de aplicación. |
5. Copie los ficheros de exportación de datos y de entidades, y muévalos a una ubicación segura. Estos ficheros se importarán en un paso posterior.
C) Copia de seguridad y configuración
1. Realice una copia de seguridad y borre el fichero validation.properties del directorio /ThingworxStorage/esapi.
| | El fichero validation.properties se crea al iniciar ThingWorx. Si desea conservar los cambios realizados, guarde el fichero fuera del directorio ThingworxStorage y, a continuación, elimine el directorio esapi. Al iniciar, ThingWorx volverá a crear el fichero y se podrán añadir los regex personalizados de nuevo al fichero validation.properties que se ha generado automáticamente. Consulte este tema para obtener información adicional. |
2. Localice el fichero keystore.jks en la carpeta ThingworxStorage y muévalo a un lugar seguro. Este fichero se volverá a añadir a la carpeta ThingworxStorage después de la migración.
3. Localice el fichero keystore-password en la carpeta ThingworxPlatform y muévalo a un lugar seguro. Este fichero se volverá a añadir a la carpeta ThingworxPlatform después de la migración.
4. Observe las extensiones que están en uso (ubicadas en ThingworxStorage\extensions). Se volverán a importar en un paso posterior.
5. Detenga Tomcat.
6. Borre el contenido de las carpetas ThingworxStorage y ThingworxBackupStorage.
7. Borre el fichero keystore-password de la carpeta ThingworxPlatform.
8. Vaya a la instalación de Tomcat en \Apache Software Foundation\Tomcat x.x\webapps y borre el fichero Thingworx.war.
9. Borre la carpeta Thingworx ubicada en Apache Software Foundation\Tomcat x.x\webapps.
10. Copie el fichero Thingworx.war de esta versión y colóquelo en la siguiente ubicación de la instalación de Tomcat: \Apache Software Foundation\Tomcat x.x\webapps .
11. Active la importación de extensión. Por defecto, la importación de extensión está desactivada para todos los usuarios. Añada lo siguiente al fichero platform-settings.json. Añada o actualice los siguientes parámetros de ExtensionPackageImportPolicy a verdadero para permitir la importación de las extensiones.
"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>
},
"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>
},
12. Si se utiliza H2 como una base de datos con ThingWorx, se debe añadir un nombre de usuario y una contraseña al fichero platform-settings.json.
},
"PersistenceProviderPackageConfigs":{
"H2PersistenceProviderPackage":{
"ConnectionInformation":
{
"password": "<changeme>",
"username": "twadmin"
}
},
"PersistenceProviderPackageConfigs":{
"H2PersistenceProviderPackage":{
"ConnectionInformation":
{
"password": "<changeme>",
"username": "twadmin"
}
},
13. Inicie Tomcat.
14. Si se vuelve a utilizar el fichero keystore.jks anterior, localice los ficheros keystore.jks y keystore-password que se movieron anteriormente desde las carpetas ThingworxStorage y ThingworxPlatform y péguelos en las carpetas correspondientes.
15. Para iniciar ThingWorx, vaya a <nombre_servidor>\Thingworx en un explorador Web. Utilice la siguiente información de conexión:
◦ Nombre de conexión: Administrator
◦ Contraseña: <contraseña de administrador del servidor de origen>
D) Actualización a Java 11
| | Se requiere Java 11 para ThingWorx 9.2.0 y versiones posteriores. Consulte los requisitos del sistema para obtener más información. |
1. Si se actualiza a Java 11, se requieren los siguientes pasos. Omita esta sección si ya se ha instalado Java 11.
b. Descomprima el fichero zip openjdk-11 descargado y copie la carpeta jdk-xxxx en la carpeta sin comprimir.
c. Pegue la carpeta jdk-xxxx en la siguiente ubicación: C:\Archivos de programa\Java.
d. Verifique que la variable del sistema CARPETA_PRINCIPAL_JAVA esté configurada para utilizar la ubicación del directorio de Java 11. Por ejemplo, c:\Archivos de programa\Java\jdk-11.0.7.
e. Edite la variable Path y añada un valor nuevo: %CARPETA_PRINCIPAL_JAVA%\bin.
f. Para verificar la versión de Java, abra un símbolo del sistema y ejecute el siguiente comando: java-versión.
g. Actualice la ruta en la configuración de Java de Tomcat.
h. Reinicie Tomcat.
E) Importación de datos y entidades
1. Mueva los ficheros de exportación de nuevo a ThingworxStorage\exports.
2. Si fuera necesario, obtenga e importe las versiones más recientes de las extensiones. Se deben importar las versiones 9.x de las extensiones. Las extensiones soportadas de PTC están disponibles en la página de descargas de ThingWorx Foundation.
3. Si se ha actualizado de 8.x a 9.x y tiene extensiones de Java, consulte la sección Migración de las extensiones de Java de 8.x a 9.x.
4. Importe entidades y datos.
| | Si se actualiza a ThingWorx 9.2 o una versión posterior, se debe importar el fichero Principals.xml antes de importar el fichero Entities.xml. Si no se hace, se perderán todos los permisos. Para obtener más información, consulte Importación de entidades en 9.2 y versiones posteriores. |
a. En Composer, pulse en Importar/Exportar > Desde fichero.
b. Seleccione los datos y las entidades que desea importar.
| | Seleccione la casilla Incluir subsistemas si desea incluir la configuración del subsistema de las entidades importadas (por ejemplo, si pasa de un entorno de prueba a producción). |
| | El siguiente error aparece en las actualizaciones del registro de aplicación para MSSQL y se muestra si hay algún nombre de servicio, propiedad o evento migrado con permisos de tiempo de ejecución configurados que contiene más de 256 caracteres. Para corregir este error, limite todos los nombres de servicio, propiedad y evento a menos de 256 caracteres. Error occurred while accessing the data provider |
5. Revise los registros de aplicación para verificar que no hay ningún mensaje de aviso de "identidad faltante" en los registros. Si es así, consulte Importación de entidades en 9.2 y versiones posteriores para la resolución de problemas.
F) Actualización de componentes adicionales
• Si se utilizan conectores de integración, se debe obtener e instalar la versión más reciente de Integration Runtime. Para obtener más información, consulte Configuración inicial del servicio Integration Runtime para conectores de integración.
• Si se utiliza ThingWorx Analytics como parte de la solución, hay dos instaladores disponibles para gestionar las actualizaciones de componentes:
◦ Analytics Server: permite instalar o actualizar Analytics Server y Analytics Extension
◦ Platform Analytics: permite instalar o actualizar la analítica descriptiva y las transformaciones de propiedades.
Para obtener más información sobre los procedimientos de actualización, consulte Actualización, modificación o reparación de ThingWorx Analytics.