Skip to main content

Esecuzione dello strumento Preparazione alla migrazione

Importante

Utilizza questo strumento solo per eseguire la migrazione da Server 2022.2 o versioni precedenti. Il meccanismo di crittografia è stato aggiornato nella versione 2022.3.

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 grado di verificare lo spazio disponibile.

Passaggio 1: installazione dello strumento Preparazione alla migrazione

  1. Scarica il programma di installazione da downloads.alteryx.com ed eseguilo.

  2. Accetta il Contratto di licenza con l'utente finale (EULA). Seleziona Successivo.

  3. Per cambiare il percorso di installazione, seleziona Cambia. Per accettare il percorso predefinito, seleziona Avanti.

  4. Segui le istruzioni per completare l'installazione.

Passaggio 2: avvio dello strumento Preparazione alla migrazione

  1. Apri un prompt dei comandi o PowerShell.

  2. Accedi al percorso di installazione scelto (predefinito: C:\Program Files\Alteryx Migration Tool\).

  3. Invia uno dei comandi per eseguire lo strumento Preparazione alla migrazione. Nota: se utilizzi PowerShell, aggiungi .\ all'inizio di ciascun comando. Puoi eseguire questa operazione su qualsiasi host che può accedere al server MongoDB e ripeterla più volte in totale sicurezza senza tempi di inattività.

    Per la configurazione multinodo, IP Address/Hostname, Controller Token e NON_ADMIN_MONGO_PASSWORD devono riferirsi al computer in cui è in esecuzione il nodo del controller in base alla configurazione eseguita durante la configurazione multinodo.

    Per il nodo singolo, i dettagli devono riferirsi allo stesso computer in cui è installato Alteryx Server.

Come utilizzare gli esempi:

Sostituisci queste variabili nella stringa di connessione con i valori appropriati per l'ambiente in uso. Si tratta delle stesse credenziali utilizzate per configurare il database di Server, disponibili nelle impostazioni di sistema di Alteryx.

  • {authenticationDB} = il database che autenticherà le credenziali utente specificate.

    • Se Server è configurato per l'utilizzo della versione integrata di MongoDB, utilizza la password MongoDB per gli utenti non amministratori. Nella stringa di connessione, authSource deve essere "AlteryxService".

    • Per MongoDB gestito dall'utente, contatta l'amministratore di MongoDB per confermare authSource e credenziali utente.

  • {port} = la porta di servizio utilizzata da MongoDB per fornire l'accesso al database.

  • {host.domain.tld} = il nome di dominio completo del server MongoDB.

  • {password} = credenziale per l'utente.

  • {user} = nome utente per accedere al database.

  • {atlasCluster.cloudProvider.mongodb.net} = l'indirizzo del cluster MongoDB Atlas.

Database

Esempio

MongoDB integrato

Nota: "NON_ADMIN_MONGO_PASSWORD" "CONTROLLER_TOKEN" e "localhost" dovrebbero essere modificati in base alla configurazione corrente.

Migrazione App Chunk e RunAS_Credentials

AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token>

Solo migrazione App Chunk

AlteryxServiceMigrator22_2.exe --appsonly -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token>

Solo migrazione RunAs_Credential

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token>

MongoDB gestito dall'utente

Nota: i termini "password", "port", "host.domain.tld" e "authenticationDB" devono essere modificati in base all'istanza corrente di MongoDB.

Migrazione App Chunk e RunAS_Credentials

AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

Solo migrazione App Chunk

AlteryxServiceMigrator22_2.exe --appsonly -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

Solo migrazione RunAs_Credential

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

Set di repliche MongoDB

Migrazione App Chunk e RunAS_Credentials

AlteryxServiceMigrator22_2.exe -p -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

Solo migrazione App Chunk

AlteryxServiceMigrator22_2.exe –-appsonly -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

Solo migrazione RunAs_Credential

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

MongoDB Atlas

Migrazione App Chunk e RunAS_Credentials

AlteryxServiceMigrator22_2.exe -p -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token>

Solo migrazione App Chunk

AlteryxServiceMigrator22_2.exe –-appsonly -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token>

Solo migrazione RunAs_Credential

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token>

Parametri di comando

  • -h [ --help ] visualizza le informazioni della guida

  • -q [ --quiet ] invia i messaggi di log alla riga di comando (i messaggi di stato ignorano questo indicatore)

  • -s [ --severity ] arg (=7) livello di gravità della registrazione della console (i report sullo stato della migrazione vengono inviati al livello 5)

  • -p [ --perform ] esegui migrazione

  • --appsonly esegue solo la migrazione dei blocchi, senza alcun controllo preliminare

  • --credonly esegue il controllo preliminare senza migrazione dei blocchi

  • -u [ --forcenoprogressupdates ] disabilita la scrittura dei messaggi di aggiornamento dello stato nella console (vengono comunque scritti nel file di log)

  • -c [ --connection ] stringa di connessione (è necessario specificare il database AlteryxService)

  • -i [ --hostname ] arg   nome host|indirizzo ip del controller

  •  -t [ --controllertoken ] arg   token del controller per il recupero delle chiavi

  • -l [ --loggingpath ] (=C:\ProgramData\Alteryx) percorso del file di registrazione, deve contenere %N per la rotazione del log

  • --loggingmaxfilesize (=64) dimensione massima in MB di un file di log prima che venga ruotato

  • -d [ --stagingdirectory ] arg directory in cui i flussi di lavoro decrittografati vengono archiviati temporaneamente prima di essere nuovamente crittografati

Operazioni successive

  • All'inizio della migrazione ti verrà chiesto di confermare se hai eseguito il backup del database e del file delle impostazioni di runtime. 

  • 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.

  • 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:

  1. Acquisisci uno screenshot del prompt dei comandi.

  2. Oscura o rimuovi i dati sensibili.

  3. Acquisisci il log (consulta la procedura di convalida per la posizione e la denominazione).

  4. Esegui nuovamente la migrazione.

  5. Se la migrazione ha di nuovo esito negativo, contatta l'assistenza Alteryx e includi lo screenshot e il file di log nel report.

Nota

Se appare l'errore Errore durante l'inizializzazione della chiave <Errore durante l'importazione delle chiavi nella directory Microsoft\Crypto\RSA\MachineKeys\ in ProgramData: accesso negato. (5)> Migrazione RunAS non riuscita durante l'esecuzione del comando di migrazione, accedi a C:\ProgramData\Microsoft\Crypto\RSA\MachineKeys, Successivamente, fai clic con il pulsante destro del mouse sulla cartella MachineKeys e seleziona Mostra altre opzioni > Concedi accesso a > Persone specifiche. Seleziona Tutti gli utenti con accesso in lettura/scrittura. Infine, seleziona Condividi.

Passaggio 3: aggiornamento a Server 2024.1

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 2024.1.

  • Per ulteriori informazioni sull'aggiornamento, consulta Installazione o aggiornamento di Server.

  1. Scarica Server 2024.1 dal sito downloads.alteryx.com.

  2. Esegui il programma di installazione. Seleziona Sì per continuare l'aggiornamento.

  3. Accetta il Contratto di licenza.

  4. Scegli il percorso di installazione o accetta quello predefinito. Successivamente, seleziona Avanti.

  5. Seleziona Installa per avviare l'installazione (aggiornamento).

  6. Al termine dell'installazione, seleziona Configura Server ora, quindi Fine.

  7. Al termine dell'installazione di Server 2024.1, seleziona l'opzione Inizia backup e migrazione.

  8. Al termine della migrazione, seleziona OK.

Nota: dopo l'installazione, potrebbe verificarsi un ritardo nell'avvio del servizio.

Operazioni successive all'installazione

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.

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.

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.

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 si verificano errori di migrazione, prova a riavviare AlteryxService. Questa operazione eseguirà nuovamente le procedure di migrazione incomplete e 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.

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

  1. Vai a C:\ProgramData\Alteryx\Service\.

  2. Apri AlteryxServiceMigrator_#.log.

  3. 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

  1. Accedi alla cartella di registrazione configurata in Alteryx System Settings > Controller > Generale > Registrazione.

  2. Apri AlteryxServiceMigrator_#.log.

  3. 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 2024.1 (in seguito alla migrazione finale)

  1. Accedi a Server tramite l'URI Web.

  2. 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.

In questa sezione: