Programma di installazione di ThingWorx Foundation per Windows
A.) Prerequisiti per il programma di installazione di Windows con PostgreSQL
 | Se durante questo processo viene rilevata un'installazione esistente, il programma di installazione aggiorna ThingWorx Foundation. Per ulteriori informazioni, vedere Utilizzo del programma di installazione per aggiornare ThingWorx Foundation. |
| | Non è consigliabile utilizzare spazi nei nomi di file per il programma di installazione di ThingWorx. Se si tenta di installare ThingWorx utilizzando un percorso di file che include spazi, il programma di installazione di ThingWorx non riesce. Se è necessario utilizzare spazi, gli amministratori devono attivare il supporto Windows per 8dot3. |
• Sono state esaminate le informazioni e i prerequisiti generali illustrati nell'argomento della guida Programma di installazione di ThingWorx Foundation.
• Per eseguire il programma di installazione di ThingWorx Foundation per Windows con PostgreSQL, è necessario disporre di quanto elencato di seguito. Per informazioni sulle versioni supportate, vedere Requisiti di sistema.
◦ Java 11 installato
| | Java 11 è necessario per 9.2.0 e versioni successive. • Impostare la variabile JAVA_HOME per l'uso della directory di installazione di Java 11. |
◦ Windows con accesso come amministratore
◦ Database ThingWorx configurato con le connessioni consentite e la codifica impostata su UTF-8
▪ La proprietà del database Connection_LIMIT deve essere impostata su -1, che rappresenta il valore di default e consente connessioni illimitate al database per tutti gli utenti autenticati.
◦ Un utente del database configurato come proprietario del database ThingWorx con gli elementi riportati di seguito.
▪ Tutti i privilegi concessi all'utente nel database ThingWorx.
▪ La proprietà can login impostata su yes.
Questo utente del database verrà immesso come nome utente del database ThingWorx nel programma di installazione.
◦ Connessione a database locale o remoto. Nella tabella seguente sono elencati i prerequisiti applicabili:
Connessione database | Prerequisiti |
|---|---|
Locale | • PostgreSQL è installato e il percorso della cartella PostgreSQL/bin deve essere incluso nella variabile di ambiente PATH. • Java JDK installato Assicurarsi che java/bin sia nella variabile di ambiente PATH. • Connessioni a PostgreSQL consentite dall'host ThingWorx Foundation mediante l'aggiornamento del file pg_hba.conf. Ad esempio, se ThingWorx Foundation viene installato nello stesso host di PostgreSQL, è possibile aggiornare il file pg_hba.conf per impostare il metodo di autenticazione della password su md5, password oppure trust. È tuttavia sconsigliabile impostarlo su trust. Per ulteriori informazioni sul file pg_hba.conf e sui metodi di autenticazione della password, vedere il sito Web PostgreSQL.org. Di seguito è riportato un esempio del file pg_hba.conf con il metodo di autenticazione della password impostato su 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 | • Installare il client psql compatibile con la versione di PostgreSQL. • Aggiungere il client psqul installato alla variabile di ambiente PATH. È possibile attenersi alla procedura descritta di seguito. a. Scaricare il file pgadmin4-4.1-x86.exe da https://www.postgresql.org/ftp/pgadmin/pgadmin4/v4.1/windows/. b. Installare il client pgadmin. c. Aggiornare la variabile di ambiente PATH da aggiungere al percorso in cui è installato il client pgadmin. |
B.) Prerequisiti per il programma di installazione di Windows con SQL Server
| | Se durante questo processo viene rilevata un'installazione esistente, il programma di installazione aggiorna ThingWorx Foundation. Per ulteriori informazioni, vedere Utilizzo del programma di installazione per aggiornare ThingWorx Foundation. |
| | Non è consigliabile utilizzare spazi nei nomi di file per il programma di installazione di ThingWorx. Se si tenta di installare ThingWorx utilizzando un percorso di file che include spazi, il programma di installazione di ThingWorx non riesce. Se è necessario utilizzare spazi, gli amministratori devono attivare il supporto Windows per 8dot3. |
• Sono state esaminate le informazioni e i prerequisiti generali illustrati nell'argomento della guida Programma di installazione di ThingWorx Foundation.
Per eseguire il programma di installazione di ThingWorx Foundation per Windows con Microsoft SQL Server, è necessario disporre di quanto elencato di seguito. Per informazioni sulle versioni supportate, vedere Requisiti di sistema.
• Java 11 installato
| | Java 11 è necessario per 9.2.0 e versioni successive. • Impostare la variabile JAVA_HOME per l'uso della directory di installazione di Java 11. |
• Windows con accesso come amministratore
• Un database ThingWorx configurato con le impostazioni riportate di seguito.
◦ Impostare la proprietà Collate su Latin1_General_100_CS_AS_SC.
◦ Impostare le proprietà seguenti su ON:
▪ READ_COMMITTED_SNAPSHOT
▪ ALLOW_SNAPSHOT_ISOLATION
• Accesso per Microsoft SQL Server con l'autenticazione SQL Server
La password per questo accesso è la password di accesso al database ThingWorx.
◦ Un utente del database per questo accesso configurato come proprietario e all'interno del ruolo pubblico.
Questo utente deve disporre di uno schema di default di dbo e uno schema di proprietà di db_owner ed essere membro di db_owner.
• Connessione a database locale o remoto. Nella tabella seguente sono elencati i prerequisiti applicabili:
Connessione database | Prerequisiti |
|---|---|
Locale | • L'host in cui deve essere installato ThingWorx Foundation deve avere accesso a Microsoft SQL Server. • Un client Microsoft SQL valido (sqlcmd) installato e disponibile nella variabile di ambiente PATH. • Java JDK installato. java/bin si trova nella variabile di ambiente PATH. |
Remoto | • sqlcmd è installato e disponibile nella variabile di ambiente PATH. |
C.) Prerequisiti per l'attivazione di SSL/TLS nel programma di installazione: creazione di un keystore
Nella schermata Proprietà di ThingWorx Foundation del programma di installazione la casella di controllo Utilizza SSL/TLS per una connessione protetta è selezionata per default. È possibile disattivare l'utilizzo di SSL/TLS nel programma di installazione deselezionando questa casella di controllo. Se si sceglie di mantenere l'impostazione di default e si utilizza SSL/TLS, è necessario generare un file Java keystore (. JKS) prima di eseguire il programma di installazione. Il file Java keystore (.jks) deve essere dotato dei permessi di protezione riportati di seguito.
• Per il file keystore devono essere stati concessi i permessi di Lettura e Lettura ed esecuzione al profilo utente Servizio di rete in Windows.
È possibile generare un keystore in diversi modi, tra cui il metodo riportato di seguito.
1. Passare a Java/bin.
2. Per creare il file keystore Tomcat (file .jks), eseguire il comando seguente: keytool -genkey -alias selfsigned -keyalg RSA -keystore keyStore.jks -keysize 2048 -storetype jks
3. Immettere una password per il keystore. Questa password sarà necessaria in un secondo momento per configurare il server.
| | La password non può contenere o essere racchiusa tra virgolette singole ('), virgolette doppie ('') o sezione (§). |
4. Quando richiesto, immettere il nome di dominio per il server. Ad esempio, myserver.mycompany.com.
5. Immettere gli altri valori, ad esempio l'unità organizzativa e l'organizzazione.
6. Quando richiesto, immettere la password keystore.
D.) Installazione di ThingWorx Foundation in Windows
1. Verificare che siano soddisfatti i prerequisiti descritti nelle sezioni precedenti.
2. Per PostgreSQL, dal sito support.ptc.com, in > > > > > , scaricare il file ThingWorx-Platform-Foundation-Installer-x-x-x-Windows-postgres.
OPPURE
Per Microsoft SQL Server, dal sito support.ptc.com, in > > > > > , scaricare il file ThingWorx-Platform-Foundation-Installer-x-x-x-Windows-mssql.
3. Estrarre la build.
4. Per PostgreSQL, eseguire il file ThingWorxFoundationPostgres-9.x.x-x64.exe.
OPPURE
Per Microsoft SQL Server, eseguire ThingWorxFoundationMSSQL-9.x.x-x64.exe.
5. Completare la procedura guidata del programma di installazione.
| | Nella schermata Proprietà di ThingWorx Foundation la casella di controllo Utilizza SSL/TLS per una connessione protetta è selezionata per default. È possibile disattivare l'utilizzo di SSL/TLS nel programma di installazione deselezionando questa casella di controllo. Se si sceglie di utilizzare SSL/TLS, immettere i valori del keystore generati nei prerequisiti indicati in precedenza. |
6. Nell'ultima schermata del programma di installazione la casella di controllo Open License Configurator è selezionata per default. Se questa casella di controllo è selezionata, dopo il completamento e la chiusura del programma di installazione si apre il Configuratore licenza. Se si deseleziona la casella di controllo Open License Configurator, il programma di installazione viene chiuso e il Configuratore licenza non si apre automaticamente.
a. Fare clic su Next nella schermata Setup : Configure licensing for ThingworxFoundation for Postgres o Setup : Configure licensing for ThingworxFoundation for Mssql.
b. Utilizzare License Configurator per connettersi a PTC License Server o configurare ThingWorx Foundation per utilizzare la licenza prescaricata.
c. Completare la procedura guidata per la configurazione della licenza.
7. L'installazione di ThingWorx Foundation è completata.
| | Per informazioni su come aumentare la memoria per Tomcat dopo l'installazione, vedere l'articolo CS306401 del supporto PTC. |
E.) Connessione al server ThingWorx Foundation
1. Accedere all'URL di ThingWorx Foundation.
Ad esempio: https://<nomehost>:<porta>/Thingworx/Composer.
L'URL di ThingWorx Foundation sarà diverso a seconda della configurazione del protocollo SSL o non SSL e delle porte utilizzate durante l'installazione. SSL è attivato per default, tuttavia è possibile disattivare l'utilizzo di SSL/TLS. Vedere la sezione Prerequisiti per l'attivazione di SSL/TLS nel programma di installazione sopra.
2. Fornire le credenziali dell'utente.
Il nome utente è Administrator e la password è quella immessa durante l'installazione.
F.) Funzioni di installazione aggiuntive e risoluzione dei problemi
Avvio o arresto dei servizi ThingWorx Foundation in Windows
1. Accedere al file Services.msc.
2. Trovare il servizio ThingWorx-Foundation.
3. Avviarlo o arrestarlo.
Individuazione dei file di log del programma di installazione
• Log di installazione:
◦ ${installdir}\installer\logs\ThingWorxFoundation_install.log
Ad esempio: C:\Programmi (x86)\ThingWorxFoundation\installer\logs\ThingWorxFoundation_install.log.
• Log di esecuzione:
◦ ${installdir}\ThingworxStorage\logs\
Ad esempio: C:\Programmi (x86)\ThingWorxFoundation\ThingworxStorage\logs\.
• Per interruzione o errore:
◦ ${system_temp_directory}\ThingWorxFoundation_Failed_installs\
Ad esempio: C:\Users\vagrant\AppData\Local\Temp\ThingWorxFoundation_Failed_installs\.
• Log di disinstallazione:
◦ ${system_temp_directory}\bitrock_installer_(pid).log
Il nome del file di log ha il prefisso bitrock. Ad esempio: C:\Users\vagrant\AppData\Local\Temp\bitrock_installer_3008.log.
Disinstallazione di un'installazione basata sul programma di installazione di ThingWorx Foundation
1. Passare alla posizione di installazione di ThingWorx Foundation.
2. Eseguire ThingWorxFoundation_uninstall.exe.
3. Quando richiesto, fare clic su OK per confermare che si desidera continuare con la disinstallazione.
4. Al termine della disinstallazione, il programma di installazione viene eliminato.
Eliminazione del database ThingWorx da PostgreSQL
1. Dalla riga di comando in Windows aprire una connessione al database PostgreSQL.
Ad esempio, immettere psql -U admin -h dbhost.
2. Se si utilizza il nome del database di default, eseguire il comando DROP DATABASE thingworx;.
Se invece il nome del database è stato personalizzato, eseguire il comando DROP DATABASE <your database name>;.
Eliminazione del database ThingWorx da Microsoft SQL
1. Dalla riga di comando in Windows aprire una connessione al database Microsoft SQL.
Ad esempio, immettere sqlcmd -U admin -s ‘dbhost\dbservicename,port’.
2. Se si utilizza il nome del database di default, eseguire il comando DROP DATABASE thingworx; GO;.
Se invece il nome del database è stato personalizzato, eseguire il comando DROP DATABASE <your database name>; GO;.
Aggiornamento a Java 11 per ThingWorx 9.0 e 9.1
Se è stato utilizzato il programma di installazione per installare o aggiornare ThingWorx 9.0.x o 9.1.x con Java 8 e si desidera utilizzare Java 11.0.8, attenersi alla procedura descritta di seguito.
1. Installare Java 11.
2. Impostare la directory /bin nella variabile di sistema PATH.
3. Impostare la variabile JAVA_HOME per l'uso della directory di installazione di Java 11.
4. Verificare che il file jvm.dll si trovi nella directory di installazione di Java 11. Ad esempio: C:\Programmi\Java\jdk-11.0.8\bin\server\jvm.dll.
| | In Java 11 non è presente una directory JRE. Di conseguenza, il file jvm.dll non si trova in una cartella JRE come in Java 8. |
5. Arrestare il servizio ThingWorx-Foundation.
6. Eseguire CMD come amministratore.
7. Accedere alla directory Tomcat /bin nella directory di installazione di ThingWorx Foundation. Ad esempio: cd C:\Programmi (x86)\ThingWorxFoundation\tomcat\apache-tomcat-9.0.37\bin.
8. Per modificare la configurazione del servizio ThingWorx-Foundation, eseguire le operazioni descritte di seguito tomcat9w.exe //ES//ThingWorx-Foundation.
Viene visualizzata l'applicazione GUI.
9. Accedere alla scheda Java nell'applicazione ed eseguire le operazioni descritte di seguito.
a. Per la Java Virtual Machine, puntare al file jvm.dll dell'installazione di Java 11. Ad esempio: C:\Programmi\Java\jdk-11.0.8\bin\server\jvm.dll.
b. Rimuovere quanto segue da 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} si riferisce alla directory Tomcat.
c. Copiare il percorso della directory di installazione per ThingWorx Foundation. Ad esempio: C:\Programmi (x86)\ThingWorxFoundation.
d. Aggiungere quanto segue 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. Scegliere Applica.
11. Scegliere OK.
L'applicazione viene chiusa.
12. Aggiornare i parametri del servizio utilizzando tomcat9.exe attenendosi alla procedura descritta di seguito.
a. Eseguire CMD come amministratore.
b. Eseguire le operazioni descritte di seguito.
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. Avviare il servizio ThingWorx-Foundation.
14. Nel file Application.log verificare che la versione di Java sia 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] ========================================
Se in presenza di problemi con le modifiche apportate alla configurazione del servizio in Windows si desidera visualizzare informazioni aggiuntive, eseguire le operazioni descritte di seguito per registrare altri dettagli nel file commons-daemon.log nella directory /tomcat/current/logs/: tomcat9w.exe //ES//ThingWorx-Foundation --LogLevel Debug.