Programma di installazione di ThingWorx Foundation per Windows
A.) Prerequisiti per il programma di installazione di Windows con Il server Azure PostgreSQL Flex
| 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. |
• Per eseguire il programma di installazione di ThingWorx Foundation per Windows con il server Azure PostgreSQL Flex, è necessario disporre di quanto elencato di seguito. Per ulteriori informazioni sulle versioni supportate, vedere i
Requisiti di sistema.
◦ Java 11 installato
| Java 11 è necessario per 9.3.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.
◦ 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.
Nella tabella seguente sono elencati i prerequisiti applicabili:
Connessione database | Prerequisiti |
---|
Remoto | • Installare il client psql compatibile con la versione di PostgreSQL. • Aggiungere il componente psql installato alla variabile di ambiente PATH attenendosi alla procedura descritta di seguito. 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 PostgreSQL
| 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. |
• 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
◦ 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. b. Installare il client pgadmin. c. Aggiornare la variabile di ambiente PATH da aggiungere al percorso in cui è installato il client pgadmin. |
C.) Prerequisiti per il programma di installazione di Windows con SQL Server
| 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. |
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.3.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. |
D.) Prerequisiti per l'attivazione di SSL/TLS nel programma di installazione: creazione di un keystore
| Impostare i valori di -Xms e -Xmx sul 75% della memoria del sistema operativo disponibile (ad esempio 12 GB per un sistema con 16 GB di RAM). I valori Xms e Xmx devono essere in MB. Per ulteriori informazioni, vedere Ottimizzazione di JVM. |
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. Immettere gli altri valori, ad esempio l'unità organizzativa e l'organizzazione.
5. Quando richiesto, immettere la password keystore.
E.) Installazione di ThingWorx Foundation in Windows
1. Verificare che siano soddisfatti i prerequisiti descritti nelle sezioni precedenti.
2. Per PostgreSQL o il
server Azure PostgreSQL Flexible, 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 o il server Azure PostgreSQL Flex, 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.
F.) Attivazione della Content Security Policy (passo manuale)
Se si installa ThingWorx 5.0.1 e versioni successive, è necessario aggiornare manualmente platform-settings.json per supportare CSP. Il programma di installazione di ThingWorx Foundation non supporta l'attivazione o la disattivazione della funzionalità CSP. Per default, la funzionalità CSP è disattivata finché non viene attivata in platform-settings.json.
Per aggiornare manualmente le impostazioni della piattaforma, aggiungere "EnableContentSecurityPolicyFilter": false, al file platform-settings.json in BasicSettings come indicato di seguito.
{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/ThingworxBackupStorage",
"DatabaseLogRetentionPolicy": 7,
"DatabaseWriteRetryAttempts": 10,
"EnableBackup": true,
"EnableClusteredMode": false,
"EnableContentSecurityPolicyFilter": false,
"EnableSystemLogging": false,
"EnableSSO": false,
"FileRepositoryRoot": "/ThingworxStorage",
"FileTransferLockType" : "LOCAL"
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"InternalAesCryptographicKeyLength": 128,
"MetricsLoggingFrequency": 30,
"MetricsLoggingLevel": "WARN",
"MetricsReportingEnabled": true,
"NonceKeyTimeout": 15,
"SessionUpdateDelay": 60,
"Storage": "/ThingworxStorage",
"ScriptTimeout": 30,
"MaxSearchItems": 100000
},
| Nella nuova installazione, la CSP è disattivata se il flag sopra riportato non è impostato o se è impostato specificamente su false. Per attivare la CSP, impostare il flag su true. Per ulteriori informazioni su CSP, vedere Content Security Policy. |
G.) 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.
H.) 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;.
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.