Instalación y configuración de PostgreSQL (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 en 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 el documento
Requisitos de sistema 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)
b. Seleccione New Object>New Login Role. En la ficha Properties, en el campo Role name, introduzca el nombre de rol de usuario PostgreSQL <nombre del rol de usuario de PostgreSQL> para la administración de PostgreSQL.
c. En la ficha Definition, en el campo Password, introduzca una contraseña única y segura para la administración de PostgreSQL (se solicitará que se escriba dos veces).
|
|
La contraseña, que no se debe poder averiguar fácilmente ni ser una contraseña común conocida, debe tener al menos 14 caracteres e incluir una combinación de mayúsculas y minúsculas, números y caracteres especiales. Será necesario volver a introducir esta contraseña en pasos posteriores.
|
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.
1. Añada la carpeta <postgres-installation>/bin a la variable del sistema PATH.
2. Cree una carpeta denominada ThingworxPostgresqlStorage en la unidad en la que la se encuentra la carpeta ThingworxStorage (en el directorio raíz por defecto). Debe tenerse en cuenta lo siguiente:
◦ Si se crea la carpeta con el comando -d<databasename>, no es necesario utilizar el usuario PostgreSQL.
◦ Se debe especificar la opción -l en una ruta que exista. Por ejemplo, -l D:\ThingworxPostgresqlStorage. El script no crea automáticamente la carpeta.
◦ La carpeta debe tener derechos adecuados de acceso y de propiedad. Debe ser propiedad del mismo usuario que ejecuta el servicio PostgreSQL y se debe haber asignado el control total a dicho usuario, que suele ser NETWORK_SERVICE, pero puede variar según el entorno.
3. Obtenga el script thingworxPostgresDBSetup del paquete de descarga de software de ThingWorx y ábralo. Las descargas de ThingWorx están disponibles en
Descargas de software de PTC.
4. 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
|
|
-h o -H
|
host
|
localhost
|
Nombre del Host.
|
-h localhost
|
|
-l o -L
|
tablespace_location
|
/ThingworxPostgresqlStorage
|
Obligatorio. Ubicación en el sistema de ficheros donde se almacenan los ficheros que representan los objetos de base de datos.
|
-l o -L
|
|
-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
|
5. 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. Este script configurará el esquema público en la base de datos de la instancia de PostgreSQL instalada en el host local.
1. Obtenga thingworxPostgresSchemaSetup.bat del paquete de descarga de software de ThingWorx. 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. Cree la carpeta ThingworxPlatform en la raíz de la unidad en la que se haya instalado Tomcat o defina una variable de entorno del sistema que señale a la carpeta. Debe tenerse en cuenta lo siguiente:
◦ Para especificar la ubicación donde ThingWorx almacena la configuración, la variable de entorno THINGWORX_PLATFORM_SETTINGS se puede definir en la ubicación deseada. Asegúrese de que la carpeta a la que THINGWORX_PLATFORM_SETTINGS hace referencia exista y que el usuario de Tomcat pueda escribir en ella. Esta variable de entorno se debe configurar como parte de las variables de entorno del sistema.
◦ El servidor de ThingWorx no se iniciará si no tiene permiso de lectura y escritura para esta carpeta.
2. Coloque el fichero platform-settings.json en la carpeta ThingworxPlatform. Este fichero está disponible en la descarga de software.
3. Abra platform-settings.json y configure según sea necesario. Consulte las opciones de configuración en
Detalles de configuración de 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.
Instalación de ThingWorx