Apéndices de instalación
Instalación y configuración de PostgreSQL para Windows
Las instrucciones que se proporcionan a continuación están pensadas para el administrador de PostgreSQL (no para los servidores host de la base de datos). Si se incluye la capa de alta disponibilidad para la implementación, consulte la sección Alta disponibilidad de ThingWorx de este centro de ayuda.
Instalación de PostgreSQL y creación de un rol de usuario nuevo
1. Consulte la sección Requisitos del sistema de ThingWorx para obtener información sobre las versiones de PostgreSQL soportadas.
 |
En los pasos de este procedimiento se utiliza PostgreSQL versión x.x, donde x.x es la versión soportada.
|
2. Descargue la versión correcta de PostgreSQL desde http://www.postgresql.org/download/.
3. Abra PostgreSQL mediante pgAdmin. La herramienta pgAdmin está disponible en la descarga de PostgreSQL.
|
|
pgAdmin es una herramienta de gestión de código abierto para las bases de datos, que se incluye en la descarga de PostgreSQL. La herramienta ofrece soporte completo de Unicode, consulta rápida multiproceso y herramientas de edición de datos para todos los tipos de objeto de PostgreSQL.
|
4. Cree un rol de usuario nuevo:
a. Pulse con el botón derecho en PostgreSQLx.x (<IP o nombre de host de la base de datos>:<Número de puerto de PostgreSQL>). Ejemplo: PostgreSQLx.x (localhost:5432)
|
|
Más adelante en este proceso, se hace referencia a este usuario como thingworxusername.
|
b. Seleccione Create - Login/Group Role. En la ficha General, en el campo Name, introduzca el <nombre de rol de usuario PostgreSQL> para la administración de PostgreSQL.
c. En la ficha Privileges, seleccione Yes para Can login?.
d. En la ficha Definition, en el campo Password, introduzca una contraseña única y segura para PostgreSQL.
5. Pulse en Aceptar. Se debe anotar el nombre de rol de usuario creado en este paso para su uso posterior.
Configuración de una base de datos PostgreSQL ubicada en un servidor independiente de ThingWorx
|
|
Esta sección es opcional para los entornos de desarrollo, pero se debe implementar en todos los entornos de producción.
|
Por defecto, el servidor de PostgreSQL se instala en un estado bloqueado. El servidor solo esperará conexiones desde el ordenador local. Para que ThingWorx se comunique con el servidor de PostgreSQL, es necesario realizar algunos cambios de configuración para que PostgreSQL sepa esperar conexiones de otros usuarios (el usuario de ThingWorx, el valor por defecto es twadmin) u otros ordenadores (ThingWorx instalado en un servidor independiente).
Para estos pasos, será necesario saber dónde reside el directorio de datos de PostgreSQL. En Windows, la carpeta de datos por defecto es C:\Archivos de programa\PostgreSQL.xx\data.
Modifique el fichero pg_hba.conf y añada las siguientes líneas en función de la configuración deseada:
|
Si desea permitir que todas las direcciones IPv4 se conecten:
|
host all all 0.0.0.0/0 md5
|
|
Si desea permitir que solo se conecte una dirección IPv4 específica (reemplace <ipAddress> por la dirección IP del ordenador que realiza la conexión):
|
host all all <ipAddress>/32 md5
|
|
Si desea permitir que todas las direcciones IPv6 se conecten:
|
host all all ::0/0 md5
|
|
Si desea permitir que solo se conecte una dirección IPv6 específica (reemplace <ipv6Address> por la dirección adecuada):
|
host all all <ipv6Address>/128 md5
|
Es posible realizar cualquier otra combinación utilizando líneas de asignación adicionales (IP individuales o rangos) o máscaras de subred adecuadas para los ordenadores que requieran acceso a la base de datos PostgreSQL.
Cualquier cambio en este fichero requiere un reinicio del servicio de la base de datos.
|
|
Para obtener más información sobre la configuración del fichero pg_hba.conf, consulte la documentación oficial de PostgreSQL.
|
Configuración y ejecución del script de base de datos PostgreSQL
Para configurar la base de datos PostgreSQL y el espacio de tabla, se debe configurar y ejecutar el script thingworxPostgresDBSetup.bat.
|
|
Después de ThingWorx 9.3.1, la creación de la carpeta ThingWorxPostgresqlStorage o cualquier paso relacionado con el parámetro -l ya no son necesarios y los datos de ThingWorx se almacenarán en la ubicación por defecto de Postgresql.
|
1. Añada la carpeta <postgres-installation>/bin a la variable del sistema PATH.
2. Obtenga el script thingworxPostgresDBSetup.bat del paquete del software descargado de ThingWorx y ábralo. Las descargas de ThingWorx están disponibles en Descargas de software de PTC. El script se encuentra en la carpeta install.
3. Si es necesario, configure el script. Consulte las opciones en la siguiente tabla.
|
Opción
|
Parámetro
|
Por defecto
|
Descripción
|
Ejemplo
|
||
|---|---|---|---|---|---|---|
|
t o -T
|
tablespace
|
thingworx
|
Nombre del espacio de tabla
|
-t thingworx
|
||
|
-p o -P
|
port
|
5432
|
Número de puerto de PostgreSQL
|
-p 5432
|
||
|
-d o -D
|
database
|
thingworx
|
Nombre de la base de datos PostgreSQL que se va a crear
|
-d thingworx
|
||
|
-l o -L
|
tablespace_location
|
/ThingworxPostgresqlStorage
|
Obligatorio en ThingWorx 9.3.0 y versiones anteriores. Ubicación en el sistema de ficheros donde se almacenan los ficheros que representan los objetos de base de datos. El usuario debe crear manualmente esta carpeta con permisos antes de ejecutar el script y, a continuación, especificar la ruta, por ejemplo, -l D:\ThingworxPostgresqlStorage.
|
-l o -L
|
||
|
-h o -H
|
host
|
localhost
|
Nombre del Host.
|
-h localhost
|
||
|
-a o -A
|
adminusername
|
postgres
|
Nombre del administrador
|
-a postgres
|
||
|
-u o -U
|
thingworxusername
|
twadmin
|
Nombre de usuario que tiene permisos para escribir en la base de datos.
|
-u twadmin
|
4. Ejecute el script.
Configuración y ejecución del script de esquema de proveedor de datos y modelos
Para configurar el esquema de proveedor de datos y modelos PostgreSQL, se debe configurar y ejecutar el script thingworxPostgresSchemaSetup.bat. Este script configurará el esquema público en la base de datos de la instancia de PostgreSQL instalada en el host local.
1. Obtenga el script thingworxPostgresSchemaSetup.bat del paquete de software descargado de ThingWorx en la carpeta install. Las descargas de ThingWorx están disponibles en Descargas de software de PTC.
2. Si es necesario, configure el script. Consulte las opciones en la siguiente tabla.
|
Opción
|
Parámetro
|
Por defecto
|
Descripción
|
Ejemplo
|
||
|---|---|---|---|---|---|---|
|
-h o -H
|
host
|
localhost
|
IP o nombre de host de la base de datos.
|
-h localhost
|
||
|
-p o -P
|
port
|
5432
|
Número de puerto de PostgreSQL.
|
-p 5432
|
||
|
-d o -D
|
database
|
thingworx
|
Nombre de la base de datos que se va a utilizar.
|
-d thingworx
|
||
|
-s o -S
|
schema
|
public
|
Nombre del esquema que se va a utilizar.
|
-s myschema
|
||
|
-u o -U
|
username
|
twadmin
|
Nombre de usuario que va a actualizar el esquema de base de datos.
|
-u twadmin
|
||
|
-o u -O
|
opción
|
all
|
Existen tres opciones:
• all: permite configurar los esquemas de proveedor de modelos y datos en la base de datos especificada.
• model: permite configurar el esquema de proveedor de modelos en la base de datos especificada.
• data: permite configurar el esquema de proveedor de datos en la base de datos especificada.
|
-o data
|
3. Ejecute el script.
Configuración de platform-settings.json
1. Abra el fichero platform-settings.json que se encuentra en la carpeta ThingworxPlatform.
2. Consulte las opciones de configuración de PostgresPersistenceProviderPackage en Detalles de la configuración de platform-settings.json y añádalas a platform-settings.json.
|
|
Si el servidor de PostgreSQL no es el mismo que el servidor de ThingWorx y tiene problemas con la instalación de ThingWorx, revise los registros de Tomcat y el fichero platform-settings.json. En la instalación por defecto se supone que ambos servidores se encuentran en el mismo ordenador.
|
(Opcional) Codificación de la contraseña de PostgreSQL
Cifre la contraseña siguiendo los pasos que se describen en el tema Cifrado de contraseñas.
(Opcional) Instalación del paquete de cliente de PostgreSQL y el usuario PostgreSQL
Para emitir comandos de PostgreSQL desde el ordenador del cliente al servidor de PostgreSQL, se debe hacer desde un usuario PostgreSQL. El paquete postgresql-client-x.x se puede instalar en el ordenador cliente. Consulte la documentación sobre la distribución de PostgreSQL para obtener información sobre cómo instalarla. En este paquete se proporcionan algunas herramientas administrativas, como psql.