ThingWorx Flow > Installazione e configurazione > Installazione di ThingWorx Flow > Risoluzione dei problemi relativi all'installazione
Risoluzione dei problemi relativi all'installazione
È possibile utilizzare i file di log per risolvere i problemi relativi all'installazione. I file di log vengono salvati nelle posizioni seguenti:
• Log di installazione o aggiornamento di ThingWorx Flow
<Percorso_installazione_ThingWorx_Flow>\installer\logs\
• Log di esecuzione di ThingWorx Flow
<Percorso_installazione_ThingWorx_Flow>\.pm2\logs\
• Log di RabbitMQ
Windows: <Percorso_installazione_ThingWorx_Flow>\modules\RabbitMQ\log
Linux: /var/log/rabbitmq
• Log di NGinx
Windows: C:\Programmi\nginx-<versione>\logs
Linux: /var/log/nginx
• Log di ThingWorx Foundation
<Percorso_installazione_ThingWorx_Foundation>\ThingworxStorage\logs\
• Log delle interruzioni e degli errori
<directory_temp_sistema>/ThingWorxFlow_Failed_installs/
Esempio: /tmp/ThingWorxFlow_Failed_installs/
• Log di disinstallazione
<directory_temp_sistema>/bitrock_installer_<pid>.log
Il nome del file di log ha il prefisso bitrock.
Esempio: /tmp/bitrock_installer_3008.log
Scenario
Risoluzione
Per convalidare la connettività con ThingWorx Flow
Eseguire il servizio ValidateFlowSetup.
Se l'URL del server ThingWorx Flow non è accessibile o restituisce un codice di errore 502 o 504
Se l'host ThingWorx Foundation non è accessibile dalla macchina virtuale ThingWorx Flow
1. Accedere ai file di log RabbitMQ nella cartella <Posizione_installazione_ThingWorx_Flow>\modules\RabbitMQ\log.
2. Aprire il file di log e controllare se la riga seguente è disponibile nel file di log:
user 'flowuser' authenticated and granted access to vhost 'orchestration'
3. Se la riga non è disponibile, effettuare le operazioni descritte di seguito.
◦ Controllare la connessione al firewall nella macchina virtuale ThingWorx Foundation.
◦ Assicurarsi che la porta RabbitMQ sia accessibile in entrambi gli host.
Controllare se gli host ThingWorx Foundation e ThingWorx Flow possono raggiungersi reciprocamente utilizzando il nome DNS o il nome host.
Se l'esecuzione del flusso nel motore si arresta bruscamente
Esaminare il software prima di apportare qualsiasi modifica.
• Impostare le porte temporanee per i servizi sul sistema operativo su un numero compreso tra 5000 e 65535.
Per informazioni sulle porte temporanee e sul relativo intervallo, vedere The Ephemeral Port Range.
• Ridurre TIME_WAIT sui socket a 30 secondi.
Se è stata aggiornata la password dell'amministratore del database di ThingWorx Flow
È necessario aggiornare la stessa password in ThingWorx Flow. A questo scopo completare la procedura descritta in Aggiornamento della password dell'amministratore del database di ThingWorx Flow.
Se si desidera aggiornare la password di RabbitMQ
Completare la procedura descritta in Aggiornamento della password crittografata di RabbitMQ.
Se la password dell'utente che ha eseguito il programma di installazione di ThingWorx Flow è cambiata
È necessario riavviare ThingWorx Flow. A questo scopo attenersi alla procedura descritta di seguito.
Windows
1. Arrestare il servizio ThingWorx-Flow.
2. Fare clic con il pulsante destro del mouse sulla cartella di installazione di ThingWorxFlow e fornire tutti i permessi al gruppo NETWORK SERVICE.
3. In Servizi Windows fare clic con il pulsante destro del mouse sul servizio ThingWorx-Flow e scegliere Proprietà. Selezionare la scheda Connessione e aggiornare la password per l'account Network Service.
4. Avviare il servizio ThingWorx-Flow.
5. Se il servizio ThingWorx-Foundation utilizza lo stesso utente, ripetere la stessa procedura.
Linux
1. Riavviare il servizio ThingWorx-Flow.
2. Se il servizio ThingWorx-Foundation utilizza lo stesso utente, riavviare il servizio ThingWorx-Foundation.
Se non si riesce a eseguire ThingWorx Flow nel caso in cui ThingWorx Analytics sia stato installato prima di ThingWorx Flow
Il problema può essere dovuto al fatto che i servizi RabbitMQ per entrambi ThingWorx Analytics e ThingWorx Flow sono in ascolto della stessa porta di default. In questo caso è necessario riconfigurare la porta di RabbitMQ per ThingWorx Flow per l'ascolto di una porta diversa da quella di default.
Dopo l'installazione, se ThingWorx Flow non sta caricando e viene visualizzato il codice di errore 502
• Durante l'installazione, se viene utilizzato HTTP_PROXY o HTTPS_PROXY per la connessione a Internet, questa impostazione viene prelevata dal file dump.pm2 e aggiunta nella variabile di ambiente.
In questo caso, eliminare le impostazioni HTTP_PROXY e HTTPS_PROXY nel file dump.pm2 e dalla variabile di ambiente.
• Verificare che le porte utilizzate per la comunicazione tra Foundation e Flow non siano bloccate a livello del server o del firewall. Le porte in uso sono disponibili nei file platform-settings.json, vhost-flow.conf, nginx.conf e nei file di configurazione della distribuzione.
Se nei log di nginx viene registrato il messaggio di errore riportato di seguito, significa che la porta simile alla 443 è bloccata da un'altra applicazione. Questa situazione si verifica quando si prova a installare molte applicazioni su un solo computer. Ad esempio, Foundation, Flow, Windchill e così via.
2021/11/30 15:42:15 [emerg] 47544#47116: bind() to 0.0.0.0:443 failed (10013: An attempt was made to access a socket in a way forbidden by its access permissions)
Check if the URLs and ports mentioned in vhost-flow.conf and deployment.config files are correct. (Backup the files before changing)
• Se si utilizzano certificati commerciali o se sono state apportate modifiche ai certificati, attenersi alla procedura descritta nell'articolo Configuring SSL for ThingWorx Flow.
Se l'accesso a ThingWorx Flow ha esito positivo dopo la configurazione del certificato firmato dall'autorità di certificazione, ma ThingWorx non è in grado di connettersi a ThingWorx Flow
È possibile che nel keystore Java (cacerts) non siano presenti la radice dell'autorità di certificazione e i certificati intermedi. Per ulteriori informazioni, vedere la sezione "Notes" nell'articolo Configuring SSL for ThingWorx Flow
Se ThingWorx Flow non riesce a creare righe nel database MSSQL con l'errore Invalid column name "id".
ThingWorx Flow presuppone che nelle tabelle MSSQL sia presente una colonna id come chiave principale per default. Se la colonna id non è una chiave principale:
• Utilizzare id come chiave principale.
OPPURE
• Non utilizzare id come nome di colonna.
In caso di problemi di connettività tra ThingWorx e i servizi ThingWorx Flow, vengono visualizzati i codici e i messaggi di errore seguenti:
Codice di errore
Messaggio di errore
[FLOW-CONFIG-01]
ThingWorx Flow is not enabled. Add the OrchestrationSettings section to the platform-settings.json file to enable ThingWorx Flow.
[FLOW-RABBIT-01]
Failed to connect to RabbitMQ. Check whether the RabbitMQ service is running and is accessible.
[FLOW-API-01]
Failed to connect to ThingWorx Flow. Check ThingWorx logs for more detail.
[FLOW-API-02]
Failed to connect to ThingWorx Flow. Ensure that you are accessing an Nginx-hosted ThingWorx instance. ThingWorx Flow is not supported on a Tomcat-hosted ThingWorx. Ensure that all ThingWorx Flow services are running and are healthy. In case of self-signed certificate, make sure that correct CN is provided.
[FLOW-KEY-01]
OAuth admin key not found in the ThingWorx KeyStore.
[FLOW-KEY-02]
Exchange admin key not found in the ThingWorx KeyStore.
[FLOW-KEY-03]
Failed to get ThingWorx Flow keys from the ThingWorx KeyStore.
[FLOW-KEY-04]
Failed to get ThingWorx Flow keys from the ThingWorx KeyStore.
[FLOW-EXCHANGE-01]
Failed to connect to ThingWorx Flow exchange service. Check ThingWorx logs for more details.
[FLOW-EXCHANGE-02]
Failed to connect to ThingWorx Flow exchange service. Check whether ThingWorx Flow exchange service is up and running.
[FLOW-OAUTH-01]
Failed to connect to ThingWorx Flow OAuth service. Check ThingWorx logs for more details.
[FLOW-OAUTH-02]
Failed to connect to ThingWorx Flow OAuth service. Check whether ThingWorx Flow OAuth service is up and running.
È stato utile?