Appendici relative all'installazione
Installare e configurare PostgreSQL per Windows
Le istruzioni fornite di seguito sono destinate all'amministratore di PostgreSQL (non ai server host del database). Se si intende includere il livello di disponibilità elevata nell'implementazione, fare riferimento a ThingWorx a disponibilità elevata di questo Help Center.
Installare PostgreSQL e creare un nuovo ruolo utente
1. Per informazioni sulle versioni di PostgreSQL supportate, fare riferimento ai Requisiti di sistema di ThingWorx.
 |
Per i passi descritti in questa procedura viene utilizzata la versione di PostgreSQL x.x, dove x.x è la versione supportata.
|
2. Scaricare e installare la versione appropriata di PostgreSQL da http://www.postgresql.org/download/.
3. Aprire PostgreSQL utilizzando pgAdmin. Lo strumento pgAdmin è disponibile nel download di PostgreSQL.
|
|
L'utilità pgAdmin è uno strumento di gestione open source per i database incluso nel download di PostgreSQL. Lo strumento offre supporto Unicode completo, interrogazione veloce, multi-thread e strumenti di modifica dei dati, nonché supporto per tutti i tipi di oggetti PostgreSQL.
|
4. Creare un nuovo ruolo utente come descritto di seguito.
a. Fare clic con il pulsante destro del mouse su PostgreSQLx.x (<IP o nome host del database>:<Numero di porta di PostgreSQL>). Esempio: PostgreSQLx.x (localhost:5432)
|
|
Più avanti in questa procedura si fa riferimento a questo utente come a thingworxusername.
|
b. Selezionare Create - Login/Group Role. Nella scheda General, nel campo Name, immettere il <nome ruolo utente PostgreSQL> per l'amministrazione di PostgreSQL.
c. Nella scheda Privileges selezionare Yes per Can login?.
d. Nella scheda Definition, nel campo Password, immettere una password univoca e sicura per PostgreSQL.
5. Fare clic su OK. Annotare il nome del ruolo utente e la password creati in questo passo per l'uso successivo.
Configurare il database PostgreSQL in un server diverso rispetto a ThingWorx
|
|
Questa sezione è facoltativa per gli ambienti di sviluppo, ma deve essere implementata in tutti gli ambienti di produzione.
|
Per default, il server PostgreSQL viene installato in uno stato bloccato. Il server resta in ascolto solo delle connessioni dal computer locale. Affinché ThingWorx comunichi con il server PostgreSQL, è necessario apportare alcune modifiche di configurazione per impostare PostgreSQL per l'ascolto di connessioni da altri utenti (utente ThingWorx, che per default è twadmin) e/o altri computer (ThingWorx installato in un server diverso).
Per eseguire questi passi, è necessario sapere dove risiede la directory di dati di PostgreSQL. In Windows la cartella dei dati di default è C:\Programmi\PostgreSQL\x.x\data.
Modificare il file pg_hba.conf e aggiungere le righe riportate di seguito in base alla configurazione desiderata.
|
Se si desidera consentire a tutti gli indirizzi IPv4 di connettersi:
|
host all all 0.0.0.0/0 md5
|
|
Se si desidera consentire solo a un indirizzo IPv4 specifico di connettersi (sostituire <ipAddress> con l'indirizzo IP del computer che effettua la connessione):
|
host all all <ipAddress>/32 md5
|
|
Se si desidera consentire a tutti gli indirizzi IPv6 di connettersi:
|
host all all ::0/0 md5
|
|
Se si desidera consentire solo a un indirizzo IPv6 specifico di connettersi (sostituire <ipv6Address> con l'indirizzo appropriato):
|
host all all <ipv6Address>/128 md5
|
Qualsiasi altra combinazione è possibile utilizzando righe di consenso aggiuntive (singoli IP o intervalli di IP) o maschere di sottorete appropriate ai computer che richiedono accesso al database PostgreSQL.
Qualsiasi modifica a questo file richiede il riavvio del servizio di database.
|
|
Per informazioni aggiuntive sulla configurazione del file pg_hba.conf, vedere la documentazione relativa a PostgreSQL.
|
Configurare ed eseguire lo script del database PostgreSQL
Per impostare lo spazio tabelle e il database PostgreSQL, è necessario configurare ed eseguire lo script thingworxPostgresDBSetup.bat.
|
|
Dopo ThingWorx 9.3.1, la creazione della cartella ThingworxPostgresqlStorage o qualsiasi procedura relativa al parametro -l non è più necessaria e i dati ThingWorx vengono memorizzati nella posizione di default di Postgresql.
|
1. Aggiungere la cartella <postgres-installation>/bin alla variabile di sistema PATH.
2. Scaricare e aprire lo script thingworxPostgresDBSetup.bat dal package di download del software di ThingWorx. I download di ThingWorx sono disponibili nella pagina PTC Software Download. Questo script si trova nella cartella install.
3. Se necessario, configurare lo script. Fare riferimento alle opzioni nella tabella riportata di seguito.
|
Opzione
|
Parametro
|
Default
|
Descrizione
|
Esempio
|
||
|---|---|---|---|---|---|---|
|
t o -T
|
tablespace
|
thingworx
|
Nome dello spazio tabelle
|
-t thingworx
|
||
|
-p o -P
|
port
|
5432
|
Numero di porta di PostgreSQL.
|
-p 5432
|
||
|
-d o -D
|
database
|
thingworx
|
Nome del database PostgreSQL da creare
|
-d thingworx
|
||
|
-l o -L
|
tablespace_location
|
/ThingworxPostgresqlStorage
|
Richiesto in ThingWorx 9.3.0 e versioni precedenti. Posizione nel file system in cui sono archiviati i file che rappresentano oggetti di database. L'utente deve creare manualmente questa cartella con i permessi prima di eseguire lo script e quindi specificare il percorso, ad esempio -l D:\ThingworxPostgresqlStorage.
|
-l o -L
|
||
|
-h o -H
|
host
|
localhost
|
Nome dell'host
|
-h localhost
|
||
|
-a o -A
|
adminusername
|
postgres
|
Nome dell'amministratore
|
-a postgres
|
||
|
-u o -U
|
thingworxusername
|
twadmin
|
Nome utente dotato dei permessi di scrittura nel database.
|
-u twadmin
|
4. Eseguire lo script.
Configurare ed eseguire lo script dello schema del provider di modelli/dati
Per impostare lo schema del provider di dati/modelli PostgreSQL, è necessario configurare ed eseguire lo script thingworxPostgresSchemaSetup.bat. Questo script imposta lo schema pubblico nel database nell'istanza di PostgreSQL installata in localhost.
1. Ottenere lo script thingworxPostgresSchemaSetup.bat dal package di download del software di ThingWorx nella cartella install. I download di ThingWorx sono disponibili nella pagina PTC Software Download.
2. Se necessario, configurare lo script. Fare riferimento alle opzioni nella tabella riportata di seguito.
|
Opzione
|
Parametro
|
Default
|
Descrizione
|
Esempio
|
||
|---|---|---|---|---|---|---|
|
-h o -H
|
host
|
localhost
|
IP o nome host del database.
|
-h localhost
|
||
|
-p o -P
|
port
|
5432
|
Numero di porta di PostgreSQL.
|
-p 5432
|
||
|
-d o -D
|
database
|
thingworx
|
Nome del database da utilizzare.
|
-d thingworx
|
||
|
-s o -S
|
schema
|
pubblico
|
Nome dello schema da utilizzare.
|
-s myschema
|
||
|
-u o -U
|
username
|
twadmin
|
Nome utente per aggiornare lo schema del database.
|
-u twadmin
|
||
|
-o o -O
|
opzione
|
tutti
|
Sono disponibili le tre opzioni elencate di seguito.
• all: imposta gli schemi del provider di modelli e dati nel database specificato.
• model: imposta lo schema del provider di modelli nel database specificato.
• data: imposta lo schema del provider di dati nel database specificato.
|
-o data
|
3. Eseguire lo script.
Configurare platform-settings.json
1. Aprire il file platform-settings.json, che si trova nella cartella ThingworxPlatform.
2. Fare riferimento alle opzioni di configurazione PostgresPersistenceProviderPackage in Dettagli di configurazione platform-settings.json e aggiungere a platform-settings.json.
|
|
Se il server PostgreSQL non è lo stesso del server ThingWorx e si verificano problemi con l'installazione di ThingWorx, esaminare i log di Tomcat e il file platform-settings.json. L'installazione di default presuppone che entrambi i server si trovino nello stesso computer.
|
(Facoltativo) Crittografare la password di PostgreSQL
Crittografare la password eseguendo i passi descritti in Crittografia delle password.
(Facoltativo) Installazione del package client di PostgreSQL e dell'utente PostgreSQL
Per inviare comandi PostgreSQL dal computer client al server PostgreSQL, utilizzare un utente PostgreSQL. Il package postgresql-client-x.x può essere installato nel computer client. Per informazioni sull'installazione, fare riferimento alla documentazione della distribuzione di PostgreSQL in uso. Questo package include alcuni strumenti di amministrazione, ad esempio psql.