Instalador de ThingWorx Foundation para Windows
A) Requisitos previos para el instalador de Windows con PostgreSQL
 | Si se encuentra una instalación existente durante este proceso, el instalador actualizará ThingWorx Foundation. Para obtener más información, consulte Utilización del instalador para actualizar ThingWorx Foundation. |
| | No se recomienda utilizar espacios en los nombres de fichero para el instalador de ThingWorx. El instalador de ThingWorx encontrará problemas si se intenta instalar ThingWorx mediante una ruta de fichero que incluya caracteres de espacio. Si se deben utilizar espacios, los administradores deben activar el soporte de Windows para 8.3. |
• Se ha revisado la información y los requisitos previos generales que se describen en el tema de ayuda Instalador de ThingWorx Foundation.
• Para ejecutar el instalador de ThingWorx Foundation para Windows con PostgreSQL, se debe tener lo siguiente. Para obtener información sobre las versiones soportadas, consulte Requisitos del sistema.
◦ Java 11 instalado
| | Se requiere Java 11 para 9.2.0 y versiones posteriores. • Defina la variable CARPETA_PRINCIPAL_JAVA para utilizar el directorio de instalación de Java 11. |
◦ Windows con acceso de administrador
◦ Base de datos de ThingWorx configurada con conexiones permitidas y codificación definida en UTF-8
▪ La propiedad de base de datos Connection_LIMIT debe definirse en -1, que es el valor por defecto y permite conexiones ilimitadas a la base de datos para todos los usuarios autenticados.
◦ Un usuario de base de datos configurado como propietario de la base de datos de ThingWorx con lo siguiente:
▪ Todos los permisos concedidos a este usuario en la base de datos de ThingWorx.
▪ La propiedad can login definida en yes.
Este usuario de base de datos se introducirá como nombre de usuario de la base de datos de ThingWorx en el instalador.
◦ Una conexión de base de datos local o remota. En la siguiente tabla se muestran los requisitos previos aplicables:
Conexión de base de datos | Requisitos previos |
|---|---|
Local | • PostgreSQL debe estar instalado y la ruta para PostgreSQL/bin debe encontrarse en la variable de entorno RUTA. • Java JDK instalado Asegúrese de que java/bin se encuentre en la variable de entorno PATH. • Deben permitirse las conexiones a PostgreSQL desde el host de ThingWorx Foundation mediante la actualización del fichero pg_hba.conf. Por ejemplo, si ThingWorx Foundation está instalado en el mismo host que PostgreSQL, se puede actualizar el fichero pg_hba.conf para definir el método de autenticación de contraseña en md5, password o trust. Sin embargo, no se recomienda definirlo en trust. Para obtener más información acerca de los métodos de autenticación de fichero y contraseña de pg_hba.conf, consulte el sitio web de PostgreSQL.org. A continuación se proporciona un ejemplo del fichero pg_hba.conf con la autenticación de contraseña definida en md5: $ Edit pg_hba.conf for following: ... # "local" is for Unix domain socket connections only local all all md5 # IPv4 local connections: host all all 127.0.0.1/32 md5 # IPv6 local connections: host all all ::1/128 md5 |
Remoto | • Instale el cliente de psql que sea compatible con la versión de PostgreSQL. • Añada la instancia de psql instalada a la variable de entorno PATH. Se pueden seguir estos pasos: a. Descargue pgadmin4-4.1-x86.exe desde https://www.postgresql.org/ftp/pgadmin/pgadmin4/v4.1/windows/. b. Instale el cliente de pgadmin. c. Actualice la variable de entorno PATH que se debe incorporar a la ruta donde está instalado el cliente de pgadmin. |
B) Requisitos previos para el instalador de Windows con SQL Server
| | Si se encuentra una instalación existente durante este proceso, el instalador actualizará ThingWorx Foundation. Para obtener más información, consulte Utilización del instalador para actualizar ThingWorx Foundation. |
| | No se recomienda utilizar espacios en los nombres de fichero para el instalador de ThingWorx. El instalador de ThingWorx encontrará problemas si se intenta instalar ThingWorx mediante una ruta de fichero que incluya caracteres de espacio. Si se deben utilizar espacios, los administradores deben activar el soporte de Windows para 8.3. |
• Se ha revisado la información y los requisitos previos generales que se describen en el tema de ayuda Instalador de ThingWorx Foundation.
Para ejecutar el instalador de ThingWorx Foundation para Windows con Microsoft SQL Server, se debe tener lo siguiente. Para obtener información sobre las versiones soportadas, consulte Requisitos del sistema.
• Java 11 instalado
| | Se requiere Java 11 para 9.2.0 y versiones posteriores. • Defina la variable CARPETA_PRINCIPAL_JAVA para utilizar el directorio de instalación de Java 11. |
• Windows con acceso de administrador
• Una base de datos de ThingWorx configurada con la siguiente configuración:
◦ Defina la propiedad Collate en Latin1_General_100_CS_AS_SC.
◦ Defina las siguientes propiedades en ON:
▪ READ_COMMITTED_SNAPSHOT
▪ ALLOW_SNAPSHOT_ISOLATION
• Una conexión para Microsoft SQL Server con autenticación de SQL Server
La contraseña de esta conexión es la contraseña de conexión a la base de datos de ThingWorx.
◦ Un usuario de base de datos para esta conexión configurado como propietario y dentro del rol público.
Este usuario debe tener un esquema por defecto de dbo, un esquema de propiedad db_owner y ser miembro de db_owner.
• Una conexión de base de datos local o remota. En la siguiente tabla se muestran los requisitos previos aplicables:
Conexión de base de datos | Requisitos previos |
|---|---|
Local | • El host en el que se va a instalar ThingWorx Foundation tiene acceso a Microsoft SQL Server. • Debe estar instalado un cliente válido de Microsoft SQL (sqlcmd) y este debe estar disponible en la variable de entorno PATH. • Java JDK instalado. java/bin se encuentra en la variable de entorno PATH. |
Remoto | • sqlcmd está instalado y disponible en la variable de entorno PATH. |
C) Requisitos previos para activar SSL/TLS en el instalador: creación de un keystore
En la pantalla Propiedades de ThingWorx Foundation del instalador, la casilla Utilizar SSL/TLS para una conexión segura está seleccionada por defecto. Para desactivar el uso de SSL/TLS en el instalador, se puede despejar esta casilla. Si se decide conservar la configuración por defecto y utilizar SSL/TLS, se debe generar un fichero de keystore de Java (.jks) antes de ejecutar el instalador. El fichero de keystore de Java (.jks) debe tener los siguientes permisos de seguridad:
• El fichero de keystore debe haber concedido los permisos de Lectura y Lectura y ejecución al perfil de usuario Servicios de red en Windows.
Hay varias maneras de generar un keystore; una de ellas es la siguiente:
1. Ir a Java/bin.
2. Para crear el fichero de keystore Tomcat (fichero .jks), ejecute el siguiente comando: keytool -genkey -alias selfsigned -keyalg RSA -keystore keyStore.jks -keysize 2048 -storetype jks
3. Introduzca una contraseña para keystore. Esta contraseña se necesitará más tarde para configurar el servidor.
| | La contraseña no puede contener ni especificarse entre comillas simples ('), comillas dobles (") o párrafos (§). |
4. Cuando se le solicite, introduzca el nombre de dominio del servidor. Por ejemplo, miservidor.micompañía.com.
5. Introduzca los demás valores, como la unidad organizativa y la organización.
6. Cuando se le solicite, introduzca la contraseña de keystore.
D) Instalación de ThingWorx Foundation en Windows
1. Asegúrese de que se cumplan los requisitos previos que se describen en las secciones anteriores.
2. Para PostgreSQL, en support.ptc.com en > > > > > , descargue ThingWorx-Platform-Foundation-Installer-x-x-x-Windows-postgres.
O
Para Microsoft SQL Server, en support.ptc.com en > > > > > , descargue ThingWorx-Platform-Foundation-Installer-x-x-x-Windows-mssql.
3. Extraiga la compilación.
4. Para PostgreSQL, ejecute ThingWorxFoundationPostgres-9.x.x-x64.exe.
O
Para Microsoft SQL Server, ejecute ThingWorxFoundationMSSQL-9.x.x-x64.exe.
5. Recorra las pantallas del instalador.
| | En la pantalla Propiedades de ThingWorx Foundation, la casilla Utilizar SSL/TLS para una conexión segura está seleccionada por defecto. Para desactivar el uso de SSL/TLS en el instalador, se puede despejar esta casilla. Si se elige utilizar SSL/TLS, introduzca los valores de keystore tal como se han generado en los requisitos previos que se han indicado anteriormente. |
6. En la última pantalla del instalador, la casilla Open License Configurator está seleccionada por defecto. Si se selecciona esta casilla, el configurador de licencias se abre después de que el instalador se complete y se cierre. Si se anula la selección de la casilla Open License Configurator, el instalador se cierra y el configurador de licencias no se abre automáticamente.
a. Pulse en Next de la pantalla Setup: Configure licensing for ThingworxFoundation for Postgres o Setup: Configure licensing for ThingworxFoundation for Mssql.
b. Utilice el configurador de licencias para conectarse al servidor de licencias de PTC o configurar ThingWorx Foundation para utilizar la licencia descargada previamente.
c. Recorra las pantallas de la licencia.
7. La instalación de ThingWorx Foundation se ha completado.
| | Para obtener información sobre cómo aumentar la memoria para Tomcat después de la instalación, consulte Solución nº CS306401 PTC. |
E) Conexión con el servidor ThingWorx Foundation
1. Acceda al URL de ThingWorx Foundation.
Por ejemplo: https://<nombre de host>:<puerto>/Thingworx/Composer.
El URL de ThingWorx Foundation será diferente en función de la configuración de SSL/no SSL y de los puertos utilizados durante la configuración. SSL está activado por defecto; sin embargo, se puede desactivar el uso de SSL/TLS. Consulte la sección anterior Requisitos previos para activar SSL/TLS en el instalador.
2. Proporcione las credenciales de usuario.
El nombre de usuario es Administrator y la contraseña es la que se ha introducido durante la configuración.
F) Funciones adicionales del instalador y resolución de problemas
Inicio/detención de los servicios de ThingWorx Foundation en Windows
1. Navegue hasta Services.msc.
2. Busque el servicio ThingWorx-Foundation.
3. Inícielo o deténgalo.
Ubicación de los ficheros de registro del instalador
• Registros de instalación:
◦ ${DirectorioInstalación}\installer\logs\ThingWorxFoundation_install.log
Por ejemplo: C:\Archivos de programa (x86)\ThingWorxFoundation\installer\logs\ThingWorxFoundation_install.log.
• Registros de ejecución:
◦ ${installdir}\ThingworxStorage\logs\
Por ejemplo: C:\Archivos de programa (x86)\ThingWorxFoundation\ThingworxStorage\logs\.
• Para abortar o fallo:
◦ ${system_temp_directory}\ThingWorxFoundation_Failed_installs\
Por ejemplo: C:\Usuarios\vagrant\AppData\Local\Temp\ThingWorxFoundation_Failed_installs\.
• Desinstalar registros:
◦ ${system_temp_directory}\bitrock_installer_(pid).log
El nombre del fichero de registro tiene el prefijo bitrock. Por ejemplo: C:\Usuarios\vagrant\AppData\Local\Temp\bitrock_installer_3008.log.
Desinstalación de una instalación basada en el instalador de ThingWorx Foundation
1. Navigate a la ubicación de instalación de ThingWorx Foundation.
2. Ejecute ThingWorxFoundation_uninstall.exe.
3. Cuando se le solicite, pulse en Aceptar para confirmar que desea continuar con la desinstalación.
4. Una vez completada la desinstalación, se borra la configuración.
Borrado de la base de datos de ThingWorx de PostgreSQL
1. En la línea de comandos de Windows, abra una conexión con la base de datos de PostgreSQL.
Por ejemplo, introduzca psql -U admin -h dbhost.
2. Si se utiliza el nombre de la base de datos por defecto, ejecute el comando DROP DATABASE thingworx;.
O bien, si se ha personalizado el nombre de la base de datos, ejecute el comando DROP DATABASE <your database name>;.
Borrado de la base de datos de ThingWorx de Microsoft SQL
1. En la línea de comandos de Windows, abra una conexión con la base de datos de Microsoft SQL.
Por ejemplo, introduzca sqlcmd -U admin -s ‘dbhost\dbservicename,port’.
2. Si se utiliza el nombre de la base de datos por defecto, ejecute el comando DROP DATABASE thingworx; GO;.
O bien, si se ha personalizado el nombre de la base de datos, ejecute el comando DROP DATABASE <your database name>; GO;.
Actualización a Java 11 para ThingWorx 9.0 y 9.1
Si se ha utilizado el instalador para instalar o actualizar ThingWorx 9.0.x o 9.1.x con Java 8 y se desea utilizar Java 11.0.8, realice los siguientes pasos:
1. Instale Java 11.
2. Defina el directorio /bin en la variable del sistema RUTA.
3. Defina la variable CARPETA_PRINCIPAL_JAVA para utilizar el directorio de instalación de Java 11.
4. Verifique que la ubicación del fichero jvm.dll se encuentra en el directorio de instalación de Java 11. Por ejemplo: C:\Archivos de programa\Java\jdk-11.0.8\bin\server\jvm.dll.
| | Java 11 no tiene un directorio JRE. Por lo tanto, el fichero jvm.dll no se ubicará en una carpeta JRE como en Java 8. |
5. Detenga el servicio ThingWorx-Foundation.
6. Ejecute CMD como administrador.
7. Navegue al directorio /bin de Tomcat en el directorio de instalación de ThingWorx Foundation. Por ejemplo: cd C:\Archivos de programa (x86)\ThingWorxFoundation\tomcat\apache-tomcat-9.0.37\bin.
8. Para editar la configuración del servicio ThingWorx-Foundation, ejecute lo siguiente: tomcat9w.exe //ES//ThingWorx-Foundation.
Se abre la aplicación GUI.
9. Navegue a la ficha Java de la aplicación y realice lo siguiente:
a. Para la máquina virtual Java, apunte a jvm.dll de la instalación de Java 11. Por ejemplo: C:\Archivos de programa\Java\jdk-11.0.8\bin\server\jvm.dll.
b. Quite lo siguiente de Java Options:
-XX:+UseG1GC
-XX:+PrintGCTimeStamps
-XX:+PrintGCDetails
-Xloggc:${CATALINA_HOME}/logs/tomcat-twx-gc.log
-XX:+PrintGCTimeStamps
-XX:+PrintGCDetails
-Xloggc:${CATALINA_HOME}/logs/tomcat-twx-gc.log
${CATALINA_HOME} hace referencia al directorio de Tomcat.
c. Copie la ruta del directorio de instalación de ThingWorx Foundation. Por ejemplo: C:\Archivos de programa (x86)\ThingWorxFoundation.
d. Añada lo siguiente a Java Options:
-Xlog:gc:file=C:\Program Files
(x86)\ThingWorxFoundation/tomcat/current/logs/gc.log:time,level,tags
(x86)\ThingWorxFoundation/tomcat/current/logs/gc.log:time,level,tags
10. Elija Apply.
11. Elija OK.
La aplicación se cierra.
12. Para actualizar los parámetros de servicio mediante tomcat9.exe, realice lo siguiente:
a. Ejecute CMD como administrador.
b. Ejecute lo siguiente:
tomcat9.exe //US//ThingWorx-Foundation --JavaHome=%JAVA_HOME%
tomcat9.exe //US//ThingWorx-Foundation --Environment="JRE_HOME='%JAVA_HOME%';THINGWORX_PLATFORM_SETTINGS='%THINGWORX_PLATFORM_SETTINGS%';PATH='%PATH%'"
tomcat9.exe //US//ThingWorx-Foundation --Environment="JRE_HOME='%JAVA_HOME%';THINGWORX_PLATFORM_SETTINGS='%THINGWORX_PLATFORM_SETTINGS%';PATH='%PATH%'"
13. Inicie el servicio ThingWorx-Foundation.
14. En el fichero Application.log, confirme que la versión de Java es 11:
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ThingWorx System Environment Settings
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS: Windows Server 2019
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS arch: amd64
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS version: 10.0
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] Total Processors: 2
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] Default encoding: UTF-8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA vendor: Oracle Corporation
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA version: 11.0.8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA install location: C:\Program Files\Java\jdk-11.0.8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JVM Max Memory: 750 (MB)
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ThingWorx System Environment Settings
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS: Windows Server 2019
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS arch: amd64
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS version: 10.0
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] Total Processors: 2
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] Default encoding: UTF-8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA vendor: Oracle Corporation
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA version: 11.0.8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA install location: C:\Program Files\Java\jdk-11.0.8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JVM Max Memory: 750 (MB)
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
Si tiene problemas con los cambios en la configuración del servicio en Windows y desea ver más información, ejecute lo siguiente para registrar más información en el fichero commons-daemon.log en /tomat/current/logs/ directory: tomcat9w.exe //ES//ThingWorx-Foundation --LogLevel Debug.