Instalador de ThingWorx Foundation para Linux

Instalación y actualización > Instalación de ThingWorx > Instalador de ThingWorx Foundation > Instalador de ThingWorx Foundation para Linux

A) Requisitos previos para el instalador de Linux 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.

• 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 Linux con PostgreSQL, se debe disponer de 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.

◦ Red Hat Enterprise Linux (RHEL) con acceso de administrador

En RHEL 8.2 se ha mejorado el endurecimiento de la seguridad. Las instalaciones de ThingWorx Foundation en RHEL 8.2 mediante el instalador deben estar en el directorio /opt para evitar problemas con permisos. Se puede elegir instalar en un directorio de su elección en el directorio /opt.

◦ Java JDK instalado

Incorpore java/bin en la variable de entorno PATH.

◦ Base de datos de PostgreSQL

◦ 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 debe tener acceso a un servidor PostgreSQL. • Se debe tener PostgreSQL instalado y la ruta para PostgreSQL/bin debe encontrarse en la variable de entorno PATH. • 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. • 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. Se puede ejecutar el siguiente comando para instalar el cliente de psql: yum install rh-postgresql96-postgresql-syspaths

Conexión de base de datos

Requisitos previos

Local

• El host en el que se va a instalar ThingWorx Foundation debe tener acceso a un servidor PostgreSQL.

• Se debe tener PostgreSQL instalado y la ruta para PostgreSQL/bin debe encontrarse en la variable de entorno PATH.

• 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.

• 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. Se puede ejecutar el siguiente comando para instalar el cliente de psql:

yum install rh-postgresql96-postgresql-syspaths

B) Requisitos previos para el instalador de Linux con SQL Server

Para ejecutar el instalador de ThingWorx Foundation para Linux 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.

• Red Hat Enterprise Linux (RHEL) con acceso de administrador

• Java JDK instalado

Incorpore java/bin en la variable de entorno PATH.

• Base de datos de Microsoft SQL Server

• 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.

• El host en el que se va a instalar ThingWorx Foundation debe tener acceso a Microsoft SQL Server.

• Un cliente válido de Microsoft SQL (sqlcmd) debe estar instalado y disponible en la variable de entorno PATH.

• Un usuario de Microsoft SQL con derechos de administrador.

• Instale sqlcmd.

Para obtener instrucciones de la instalación, consulte https://docs.microsoft.com/en-us/sql/linux/sql-server-linux-setup-tools?view=sql-server-2017#RHEL.

Después de la instalación, ejecute lo siguiente:

ln -s /opt/mssql-tools/bin/sqlcmd /usr/bin/sqlcmd

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 Leer, escribir y ejecutar al propietario y al grupo del usuario Administrador (por ejemplo, el usuario raíz).

El fichero de keystore también debe ser accesible según los permisos de sus directorios padre. El directorio que contiene el fichero de keystore debe tener permiso de Ejecución para otros usuarios, lo que permite a otros usuarios, además de a los perfiles de propietario y grupo, acceder a las carpetas y sus ficheros. El permiso de Ejecución en el directorio permite que Tomcat acceda a los ficheros y las carpetas, de modo que Tomcat pueda leer el fichero de keystore.

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.) Requisitos previos para ejecutar el instalador en Red Hat Enterprise Linux 9.0

Cuando el instalador se ejecuta en modo GUI a lo largo de Red Hat 9.0, se deben tener dependencias instaladas para soportar la interfaz gráfica del instalador. Antes de ejecutar el instalador, verifique que el paquete gtk2 está instalado en el entorno. Para verificar si el paquete existe en el sistema de operación, ejecute el siguiente comando:

$ rpm -q gtk2

Si se instala el paquete, la salida debe ser el nombre del paquete instalado. Si el paquete no está instalado en el entorno, la salida será la siguiente:

"package gtk2 is not installed"

E.) Instalar ThingWorx Foundation en Linux

1. Asegúrese de que se cumplan los requisitos previos que se describen en las secciones anteriores.

Si ThingWorx se instala en una máquina virtual de Azure, consulte la sección G, Funciones adicionales del instalador y resolución de problemas.

2. Para PostgreSQL, en support.ptc.com en Descargas de software > Pedir o descargar actualizaciones de software > ThingWorx Foundation > Versión <más reciente> > ThingWorx PostgreSQL > Most Recent Datecode, descargue ThingWorx-Platform-Foundation-Installer-x-x-x-Linux-postgres

Para Microsoft SQL Server, en support.ptc.com en Descargas de software > Pedir o descargar actualizaciones de software > ThingWorx Foundation > Versión <más reciente> > ThingWorx Mssql > Most Recent Datecode, descargue ThingWorx-Platform-Foundation-Installer-x–x-x-Linux-mssql

3. Extraiga la compilación.

4. Para PostgreSQL, ejecute ThingWorxFoundationPostgres-x.x.x-x86_64.run.

Para Microsoft SQL Server, ejecute ThingWorxFoundationMSSQL-x.x.x-x86_64.run.

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.

Si se intenta instalar ThingWorx Foundation fuera del directorio /opt, puede que la instalación no se realice correctamente. RHEL aplica restricciones de seguridad para los sistemas operativos que están fuera del control del instalador. En ese caso, se debe instalar en el directorio /opt.

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 en 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 y se puede utilizar.

F.) 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.

G.) Funciones adicionales del instalador y resolución de problemas

Inicio/detención de los servicios de ThingWorx Foundation en Linux

1. Conéctese al host de ThingWorx como usuario con derechos administrativos (ejecute sudo).

2. Para iniciar los servicios, introduzca sudo systemctl start ThingWorx-Foundation.

3. Para detener los servicios, introduzca sudo systemctl stop ThingWorx-Foundation.

Ficheros de registro del instalador

◦ Registros de instalación:

▪ ${DirectorioInstalación}/installer/logs/ThingWorxFoundation_install.log

Por ejemplo: /opt/ThingWorxFoundation/installer/logs/ThingWorxFoundation_install.log.

◦ Registros de ejecución:

▪ ${installdir}/ThingworxStorage/logs/

Por ejemplo: /opt/ThingWorxFoundation/ThingworxStorage/logs/.

◦ Para abortar o fallo:

▪ ${system_temp_directory}/ThingWorxFoundation_Failed_installs/

Por ejemplo: /tmp/ThingWorxFoundation_Failed_installs/.

◦ Desinstalar registros:

▪ ${system_temp_directory}/bitrock_installer_(pid).log

El nombre del fichero de registro tiene el prefijo bitrock. Por ejemplo: /tmp/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.dat.

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 Linux, 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 Linux, 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. Copie la ruta del directorio de instalación de Java 11 en la ubicación del ejecutable de Java.

Se puede ejecutar alternatives --display java | grep 'family java-11' | cut -d' ' -f1. En la salida se debe mostrar la ubicación del ejecutable de Java, por ejemplo: /usr/lib/jvm/java-11-openjdk-11.0.8.10-0.el8_2.x86_64/bin/java. Aquí se ha copiado /usr/lib/jvm/java-11-openjdk-11.0.8.10-0.el8_2.x86_64, que se utiliza para configurar el servicio ThingWorx-Foundation.

3. Detenga el servicio ThingWorx-Foundation mediante systemctl stop ThingWorx-Foundation.service.

4. Haga copia de seguridad del servicio ThingWorx-Foundation. Por ejemplo: /etc/systemd/system/ThingWorx-Foundation.service.backup.

5. Para editar la configuración del servicio ThingWorx-Foundation, edite el entorno de ThingWorx-Foundation.service, tal como se indica a continuación:

a. En JAVA_HOME, apunte al directorio de instalación de Java 11. Por ejemplo: Environment='CARPETA_PRINCIPAL_JAVA=/usr/lib/jvm/java-11-openjdk-11.0.8.10-0.el8_2.x86_64'.

b. En CATALINA_OPTS, quite lo siguiente:

-XX:+UseG1GC
-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: /opt/ThingWorxFoundation.

d. Para CATALINA_OPTS, añada lo siguiente:

-Xlog:gc:file=/opt/ThingWorxFoundation/tomcat/current/logs/gc.log:time,level,tags

Asegúrese de que no haya espacios en la cadena de parámetros; de lo contrario, Tomcat no podrá utilizar Java.

6. Ejecute lo siguiente:

# systemctl daemon-reload

7. Inicie el servicio ThingWorx-Foundation mediante systemctl start ThingWorx-Foundation.service.

8. En el fichero Application.log, confirme que la versión de Java es 11:

[L: INFO] [O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[L: INFO] [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: Linux
[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: 4.18.0-193.6.3.el8_2.x86_64
[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: N/A
[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: /usr/lib/jvm/java-11-openjdk-11.0.8.10-0.el8_2.x86_64
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JVM Max Memory: 2048 (MB)
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================

9. Quite la copia de seguridad ThingWorx-Foundation.service.backup.

Instalación de ThingWorx en una máquina virtual de Azure

Para los usuarios que se preparan para instalar ThingWorx en una máquina virtual de Azure, es posible que se produzca el siguiente error:

Script stderr:
Errors during downloading metadata for repository 'rhel-8-for-x86_64-baseos-eus-rhui-rpms':
- Curl error (56): Failure when receiving data from the peer for https://rhui-3.microsoft.com/pulp/repos/content/eus/rhel8/rhui/8.2/x86_64/baseos/os/repodata/repomd.xml [OpenSSL SSL_read: error:14094415:SSL routines:ssl3_read_bytes:sslv3 alert certificate expi red, errno 0]
- Curl error (56): Failure when receiving data from the peer for https://rhui-1.microsoft.com/pulp/repos/content/eus/rhel8/rhui/8.2/x86_64/baseos/os/repodata/repomd.xml [OpenSSL SSL_read: error:14094415:SSL routines:ssl3_read_bytes:sslv3 alert certificate expi red, errno 0]
- Curl error (56): Failure when receiving data from the peer for https://rhui-2.microsoft.com/pulp/repos/content/eus/rhel8/rhui/8.2/x86_64/baseos/os/repodata/repomd.xml [OpenSSL SSL_read: error:14094415:SSL routines:ssl3_read_bytes:sslv3 alert certificate expi red, errno 0]
Error: Failed to download metadata for repo 'rhel-8-for-x86_64-baseos-eus-rhui-rpms': Cannot download repomd.xml: Cannot download repodata/repomd.xml: All mirrors were tried

If you do, you must first disable the lookup of the package metadata before running the installation by executing the following command:

dnf update --disablerepo=* --enablerepo='*microsoft*' rhui-azure-rhel8-eus

¿Fue esto útil?