Aggiornamento tramite migrazione
Installare ThingWorx Foundation
Prima di eseguire l'aggiornamento a ThingWorx Navigate 9.x, assicurarsi di avere installato la versione compatibile di ThingWorx Foundation. Per determinare la versione compatibile di ThingWorx Foundation consultando il documento ThingWorx Navigate Product Compatibility Matrix. Per informazioni sull'installazione, fare riferimento all'argomento Programma di installazione di ThingWorx Foundation in ThingWorx Help Center .
Preparazione all'aggiornamento tramite migrazione
Prima di iniziare è necessario preparare il sistema per l'aggiornamento ed esportare i file dal sistema di origine. Le sezioni che seguono forniscono istruzioni per l'esecuzione di queste esportazioni.
Aggiornare l'estensione per la gestione della configurazione
1. Rimuovere innanzitutto l'estensione per la gestione della configurazione.
a. In ThingWorx Composer, fare clic su 
Gestione, quindi su Estensioni installate.
Gestione, quindi su Estensioni installate.b. Selezionare thingworx-navigate-configuration-manager, quindi fare clic su 
.
.2. Riavviare Apache Tomcat.
3. Impostare quindi l'estensione di ThingWorx Navigate per la gestione della configurazione dalla cartella upgrade del file decompresso ThingWorx-Navigate-Supplemental-Files-<versione>-bundle.zip.
a. In ThingWorx Composer, fare clic su 
> .
> .b. Nella finestra Importazione, fare clic su Sfoglia e selezionare thingworx-navigate-configuration-manager-upgrade<versione>.zip.
c. Fare clic su Importa.
4. Riavviare Apache Tomcat.
Esportare tutte le entità non Navigate
Il passo successivo consiste nell'esportazione di tutte le entità da ThingWorx.
1. In ThingWorx Composer, cercare e aprire DataConfigurationAPI. Viene visualizzata la pagina Informazioni generali.
2. Fare clic su Servizi.
3. Per ExportEntities, fare clic su 
. Viene visualizzata la finestra Esegui servizio: ExportEntities.
. Viene visualizzata la finestra Esegui servizio: ExportEntities.4. Per Input, in filename, immettere un nome per il file in cui sono memorizzate le entità esportate.
5. Fare clic su Esegui. Viene visualizzato un messaggio di esito positivo e le entità vengono esportate nella seguente posizione: $<dirinstall\ThingWorxStorage\repository\NavigateFileRepository\.
Esportare la configurazione
Esportare la configurazione di ThingWorx Navigate dal sistema di origine. Sarà necessario importarla successivamente nel sistema di destinazione.
Per esportare il file in ThingWorx, attenersi alla procedura descritta di seguito.
1. In ThingWorx Composer, cercare e aprire DataConfigurationAPI. Viene visualizzata la pagina Informazioni generali.
2. Fare clic su Servizi.
3. Per ExportDataToFile, fare clic su 
. Viene visualizzata la finestra Esegui servizio: ExportDataToFile.
. Viene visualizzata la finestra Esegui servizio: ExportDataToFile.4. Per Input, in filename, immettere un nome per il file in cui è memorizzata la configurazione esportata.
5. Fare clic su Esegui. Viene visualizzato un messaggio di esito positivo e le entità vengono esportate nella seguente posizione: $<dirinstall\ThingWorxStorage\repository\NavigateFileRepository\.
Esportare la configurazione per I miei task
 | Questo passo è applicabile solo se si esegue l'aggiornamento da ThingWorx Navigate 8.5.x alla versione 9.x. |
Esportare la configurazione per I miei task dal sistema di origine. Sarà necessario importarla successivamente nel sistema di destinazione.
Per esportare il file in ThingWorx Composer, eseguire i passi riportati di seguito.
1. In ThingWorx Composer, cercare e aprire DataConfigurationAPI. Viene visualizzata la pagina Informazioni generali.
2. Fare clic su Servizi.
3. Per ExportDBEntries, fare clic su 
. Viene visualizzata la finestra Esegui servizio: ExportDBEntries.
. Viene visualizzata la finestra Esegui servizio: ExportDBEntries.4. Per Input, in filename, immettere un nome per il file in cui è memorizzata la configurazione esportata.
5. Fare clic su Esegui. Viene visualizzato un messaggio di esito positivo e le entità vengono esportate nella seguente posizione: $<dirinstall\ThingWorxStorage\repository\NavigateFileRepository\.
Eseguire il backup dei task personalizzati
Se si dispone di task personalizzati creati modificando le estensioni predefinite di ThingWorx Navigate, eseguirne i backup in modo che sia possibile ridistribuirli dopo l'aggiornamento. In questo modo si impedisce che i task personalizzati vengano sovrascritti durante il processo di aggiornamento. Per ulteriori informazioni, vedere Best practice per lo sviluppo di soluzioni in ThingWorx Help Center.
Se si esegue l'aggiornamento da ThingWorx Navigate 9.0.0 alla versione 9.1.0, i task personalizzati creati utilizzando i componenti vengono aggiornati automaticamente. Non è necessario eseguire il backup dei task personalizzati. Tuttavia, è consigliabile eseguire il backup dei task personalizzati ed esaminarli dopo l'aggiornamento. Se necessario, ridistribuire i task personalizzati di cui è stato eseguito il backup.
| | Tutti i componenti BETA utilizzati nei mashup personalizzati verranno rimossi quando si esegue l'aggiornamento a ThingWorx Navigate 9.x. Pianificare l'aggiornamento dei mashup dopo l'aggiornamento con la versione 9.x di tali componenti. |
Backup degli attributi inclusi nella blacklist
| | Questo passo è applicabile solo se si esegue l'aggiornamento da ThingWorx Navigate 8.5.x alla versione 9.x. |
Se sono state apportate modifiche agli attributi inclusi nella blacklist, eseguirne il backup in modo da poterle applicare dopo l'aggiornamento. Per informazioni dettagliate sull'inserimento di attributi nella blacklist, vedere l'argomento Attributi inseriti nella blacklist.
Eseguire il backup e disinstallare ThingWorx Navigate
Se è stato utilizzato il programma di installazione per installare la versione esistente di ThingWorx Navigate, prima di eseguire un aggiornamento tramite migrazione nello stesso sistema, eseguire il backup e disinstallare la versione esistente di ThingWorx Navigate attenendosi alla procedura descritta di seguito.
| | Non è necessario disinstallare la versione esistente di ThingWorx Navigate se si esegue un aggiornamento tramite migrazione in un altro sistema. |
1. Eseguire il backup delle cartelle seguenti:
◦ ThingworxPlatform
◦ ThingworxStorage
◦ <Tomcat Home>\webapps\Thingworx
2. Disinstallare la versione esistente di ThingWorx Navigate. Per informazioni sulla disinstallazione, vedere le istruzioni riportate di seguito.
a. Aprire la pagina ThingWorx Navigate Help Center e selezionare l'Help Center per la versione di ThingWorx Navigate esistente.
b. In ThingWorx Navigate Help Center, cercare "Disinstallare ThingWorx Navigate" e attenersi alla procedura fornita.