Esecuzione dello strumento Preparazione alla migrazione
Prima di iniziare
Lo strumento Preparazione alla migrazione crea una copia in fasi dei dati del flusso di lavoro memorizzati nel database. Durante questo processo, lo strumento Preparazione alla migrazione fornirà una stima dello spazio necessario per procedere. Continua solo se disponi di spazio sufficiente.
Avvertimento
È necessario verificare manualmente che lo spazio disponibile sia sufficiente per completare il processo. Lo strumento Preparazione alla migrazione non è in gradodi verificare lo spazio disponibile.
Passaggio 1: installazione dello strumento Preparazione alla migrazione
Per installare lo strumento Runner, attieniti alla seguente procedura:
# | Passaggio |
---|---|
1.1 | Scarica il programma di installazione da https://downloads.alteryx.com ed eseguilo. |
1.2 | Accetta il Contratto di licenza con l'utente finale (EULA). |
1.3 | Scegli il percorso di installazione o accetta quello predefinito. |
1.4 | Segui le istruzioni per completare l'installazione. |
Passaggio 2: avvio dello strumento Preparazione alla migrazione
Per avviare Strumento Preparazione migrazione, procedere come segue.
# | Passaggio |
---|---|
2.1 | Apri un prompt dei comandi o PowerShell. |
2.2 | Accedi al percorso di installazione scelto (predefinito:
|
2.3 | Invia uno di questi 3 comandi per eseguire lo strumento Preparazione alla migrazione.
Nota:
Se si utilizza PowerShell, aggiungere
Puoi eseguire questa operazione su qualsiasi host che può accedere al server MongoDB e ripeterla più volte in totale sicurezza senza tempi di inattività. #Esempio da utilizzare con MongoDB incorporato o con un singolo server MongoDB gestito dall'utente:
Questo potrebbe essere simile all'esempio seguente. Si noti che '
#Esempio per l'uso con i set di replica MongoDB:
#Esempio per l'uso con MongoDB Atlas:
|
2.4 | All'inizio della migrazione ti verrà chiesto di confermare se hai eseguito il backup del database e del file delle impostazioni di runtime: |
2.5 | Dopo aver confermato l'esecuzione dei backup, l'utilità verifica l'utilizzo dello spazio corrente. Fornisce una stima dello spazio aggiuntivo necessario per la migrazione. Devi controllare il sistema e continuare solo se sei certo di disporre di spazio libero sufficiente per procedere. |
2.6 | Dopo che avrai confermato che lo spazio disponibile è sufficiente, l'utilità inizierà la migrazione dei dati del flusso di lavoro. Appariranno periodicamente messaggi della console che indicano l'ora di inizio e di fine e messaggi di stato. |
Risoluzione dei problemi
Se si verifica un errore durante la migrazione, questo viene visualizzato nella console e acquisito nel file di log.
In caso di errore, attieniti alla procedura di seguito:
Acquisisci uno screenshot del prompt dei comandi.
Oscura o rimuovi i dati sensibili.
Acquisisci il log (consulta la procedura di convalida per la posizione e la denominazione).
Esegui nuovamente la migrazione.
Se la migrazione ha di nuovo esito negativo, contatta l'assistenza e includi lo screenshot e il file di log nel report.
Passaggio 3: aggiornamento a Server 2022.3
Importante
Prima di eseguire l'aggiornamento, crea una copia di backup del database Mongo e del file RuntimeSettings.xml . La crittografia eseguita durante la finestra di manutenzione non è reversibile. Il backup protegge l'installazione da perdite di dati o tempi di inattività aggiuntivi.
Lo stato della migrazione non è visibile durante l'aggiornamento alla versione 2022.3.
Per ulteriori informazioni sull'aggiornamento, consulta Installazione o aggiornamento di Server .
# | Passaggio |
---|---|
3.1 | Scarica ed esegui il programma di installazione 2022.3. |
3.2 | Accetta il contratto di licenza. |
3.3 | Scegli il percorso di installazione o accetta quello predefinito. |
3.4 | Avvia l'installazione. |
3.5 | Attendi la fine dell'installazione. |
3.6 | Al termine dell'installazione, scegli l'opzione Configura Server ora . Nota Dopo l'installazione di Server 2022.3, potrebbe verificarsi un ritardo nell'avvio del servizio. |
3.7 | Vengono visualizzate le impostazioni di sistema di Alteryx . Scorri le impostazioni di sistema per verificare che siano corrette. Quindi, seleziona Fine e Fine per avviare il servizio. |
3.8 | All'avvio del servizio, Server attiva la modalità di manutenzione per migrare RuntimeSettings e i valori del database che non è stato possibile migrare in precedenza. Quando è attiva la modalità di manutenzione, l'istanza di Server non sarà disponibile. |
3.9 | Lo strumento Preparazione alla migrazione esegue un controllo finale delle modifiche effettuate sul database dall'ultima esecuzione. Successivamente, esegue la migrazione (incluse le modifiche trovate di recente) e implementa la migrazione in fasi. |
3.10 | Questa migrazione finale potrebbe richiedere diverse ore. Il tempo varia in base alle dimensioni della configurazione e a seconda che lo strumento Preparazione alla migrazione sia stato o meno eseguito prima dell'aggiornamento. Al termine del processo, Server uscirà dalla modalità di manutenzione e diventerà operativo. |
Risoluzione dei problemi
Se il servizio si arresta dopo un certo periodo di tempo, controlla la presenza di errori di migrazione nei seguenti log.
LastStartupError.txt
AlteryxServiceMigrator_#.log creato dallo strumento Preparazione alla migrazione
AlteryxServiceMigrator_#.log creato durante l'avvio del servizio
Se riscontri errori di migrazione, prova a riavviare AlteryxService. Il riavvio di AlteryxService potrebbe risolvere il problema. Se il problema persiste, raccogli i log e contatta l'assistenza clienti. A seconda degli errori, il riavvio di AlteryxService potrebbe essere risolutivo, poiché tenterà di eseguire di nuovo eventuali passaggi di migrazione incompleti.
Cosa può impedire la migrazione?
I motivi sono due:
Impossibilità di decrittografare il record. Ciò implica la presenza di un record danneggiato che l'utente deve rimuovere dalla tabella (dopo averne eseguito il backup, se necessario).
Impossibilità di crittografare nuovamente il record. La soluzione è la stessa del caso precedente.
Le altre cause sono generalmente imputabili a problemi ambientali e vengono eliminate risolvendo il problema ambientale ed eseguendo di nuovo l'utilità. L'interruzione della connessione a MongoDB e lo spazio su disco insufficiente sono alcuni esempi.
Passaggio 4: convalida della migrazione
Per confermare l'esecuzione dello strumento Preparazione alla migrazione, procedi in uno dei seguenti modi.
Convalida il log dello strumento Preparazione alla migrazione
Vai a
C:\ProgramData\Alteryx\Service\
.Apri AlteryxServiceMigrator_#.log .
Verifica l'eventuale presenza di messaggi di errore nel log. Cerca lo stato 3 visualizzato come " ;3; " nel log.
Convalida il log di avvio del servizio
Accedi alla cartella di registrazione configurata in Impostazioni di sistema di Alteryx > Controller > Generale > Registrazione .
Apri AlteryxServiceMigrator_#.log .
Verifica l'eventuale presenza di messaggi di errore nel log. Cerca lo stato 3 visualizzato come " ;3; " nel log.
Convalida dopo l'aggiornamento alla versione 2022.3 (in seguito alla migrazione finale)
Accedi a Server tramite l'URI Web.
Verifica quanto segue:
Puoi eseguire manualmente flussi di lavoro e app.
Le pianificazioni sono attive e in esecuzione e producono i risultati previsti.
Puoi visualizzare, modificare, creare e utilizzare le credenziali del flusso di lavoro.
Puoi visualizzare, modificare, creare e utilizzare connessioni dati di Server.
Recupera un pacchetto del flusso di lavoro dall'API, importalo in Designer ed esegui il flusso di lavoro in Designer.