La presente guida ha lo scopo di coadiuvare un amministratore di Server nel ripristino di un'istanza di Server in caso di errore di uno o più host originali durante il passaggio a un nuova versione di Server aggiornata, il passaggio da un server locale a un server cloud e in altri casi di modifica dell'infrastruttura.
Failure of the original host*
Migration to a new Server machine
Transition from an on-premises to a cloud Server
Other infrastructure changes
Il ripristino consente di eseguire una nuova versione di Server con gli utenti, i flussi di lavoro e le pianificazioni originali se si dispone dei seguenti elementi della versione originale:
Token controller
RuntimeSettings.xml
del nodo del controllerBackup di MongoDB
* To fully recover a Server instance in a disaster recovery scenario where the original host is no longer accessible, the RuntimeSettings.xml must be prepared in advance, while the original host is in a fully functioning state. For more details refer to the Disaster Recovery Preparation help page.
Di seguito sono riportati i dettagli di ogni passaggio del processo:
2 - Ripristino di RuntimeSettings.xml
4 - Ripristino di altri file e impostazioni
Ripristino in seguito all'errore di una singola installazione predefinita di Server tramite MongoDB integrato.
Backup disponibile con le informazioni necessarie intatte.
Possibilità di sovrascrivere i computer di destinazione.
Ambiente Server multinodo, MongoDB o SQL Server gestito dall'utente. Contatta l'assistenza clienti per chiedere supporto.
Backup o ripristino dei driver ODBC.
Backup o ripristino dei DSN dell'utente o di sistema.
Backup o ripristino di altri alias memorizzati in Windows che esistono al di fuori di Alteryx.
Version Compatibility:
Original Host | Compatible Target Hosts |
---|---|
2021.4.2.47792 (Patch 5) or newer patch | 2021.4.2.47884 (Patch 11) or newer patch of 2021.4 version |
2022.1.1.42590 (Patch 3) or newer patch | 2022.1.1.42691 (Patch 9) or newer patch of 2022.1 version |
2022.3.1.430 (Server GA) or newer patch | 2022.3.1.553 (Patch 6) or newer patch of 2022.3 version |
2023.1.1.123 (Server GA) or newer patch | 2023.1.1.247 (Patch 2) or newer patch of 2023.1 version |
All newer and future versions of Alteryx Server | Any GA or patch release as long as the original host and target host are on the same version and patch. |
Install all database drivers and necessary software for workflow operation before completing the steps outlined in this guide to ensure minimal downtime.
Administrator rights on the target host.
Access to all credentials used for impersonation including, the service account (if not Local System), the Run As user, and any defined/used workflow credentials.
Controller Token from the original host.
A direct line of sight is needed to restore your encryption key as part of the recovery. Your new Server will need access to the AlteryxService running on your original Server Controller node over your network. Contact Customer Support if you are unable to meet this prerequisite.
Backup of MongoDB from the original host. Learn how to perform a backup.
For more information on Server Backup & Recovery, please see the Server Backup & Restore Best Practices: Part 1 and Part 2.
Verify the target host is set to the same time zone as the original host in Windows time zone settings. If not set to the same time zone, errors might occur in schedule views.
The following items might not have been leveraged in the original Server. Check if the functionality is being used on your original Server and if so, complete the corresponding steps marked (Optional) in this guide.
Ambiente Server multinodo, MongoDB o SQL Server gestito dall'utente. Contatta l'assistenza clienti per chiedere supporto.
Unione di database di file di connessione.
Domain
Username
Password
Backup o ripristino dei driver ODBC.
Backup o ripristino dei DSN dell'utente o di sistema.
Backup o ripristino di altri alias memorizzati in Windows che esistono al di fuori di Alteryx.
System In-DB Data Connections see
%ProgramData%\Alteryx\Engine\SystemConnections.xml
System Data Connections see
%ProgramData%\Alteryx\Engine\SystemAlias.xml
Alteryx User-Based and In-DB Connection Aliases from the original Server – the below might be relevant for each run-as or workflow credential user account
User Data Connections see
C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserConnections.xml
User In-DB Data Connections see
C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserAlias.xml
Alteryx Predictive Tools and any R libraries used by workflows in the original Server.
Predictive Tools should be installed as part of the initial Alteryx Server installation (Step 2) to ensure proper version is installed.
# | Passaggio | Dettagli |
---|---|---|
1.1 | Imposta il fuso orario del computer | Il fuso orario di Windows del nuovo computer deve corrispondere a quello del computer originale. |
1.2 | Verifica l'accesso a Alteryx | Assicurati che il computer sia in grado di contattare il dominio whitelist.alteryx.com utilizzato dal sistema di licenze Alteryx. |
# | Step | Details |
---|---|---|
2.1 | Is the version of Alteryx Server on your original host any of the following versions?
| YES: Install or upgrade the target host to the exact same major and patch version that exists on the original host. Use the full install file opposed to the patch install. If needed, please contact fulfillment@alteryx.com to request the needed install file. Go to step 2.4. NO: Continue to step 2.2. |
2.2 | Is the version of Alteryx Server on your original host listed in the Compatible Target Hosts columns of the Version Compatibility table in the Prerequisites section? | YES: Install or upgrade the target host to the exact same major and patch version that exists on the original host. Use the full install file opposed to the patch install. If needed, please contact fulfillment@alteryx.com to request the needed install file. Go to step 2.4. NO: Continue to step 2.3. |
2.3 | Install the newest patch version of Alteryx Server on target host | Install or upgrade the target host to the newest patch available for the major version the original host is on (for example, if original host is on 2022.3 Patch 3, install the newest patch of 2022.3 on the target host). |
2.4 | Configure Alteryx Server | Configure Alteryx Server using default settings and confirm the Server UI appears in a browser. You do not need to log in. |
2.5 | Troubleshoot License key "in use" error | If your license key is still tied to your old server, you will need to deactivate it on that machine. If that machine is inaccessible, contact your License Administrator to release the license. |
# | Passaggio | Dettagli |
---|---|---|
3.1 | Apri il prompt dei comandi 1 nella cartella bin | Apri un prompt dei comandi come amministratore, accedi alla cartella Alteryx\bin e immetti i comandi riportati di seguito (in base alla posizione di installazione).
|
3.2 | Arresta il servizio | Immetti il comando
Al termine dell'operazione, dovresti visualizzare il messaggio |
3.3 | Backup esistente RuntimeSettings.xml | Immetti il comando
|
3.4 | Ripristina RuntimeSettings.xml | YES: Your RuntimeSettings.xml from the Disaster Recovery Process should already be located in your target host’s Go to step 3.13. Copia il file RuntimeSettings.xml dalla versione originale di Server nella directory corrente Continue to step 3.5. |
3.5 | Elimina il token del controller | Modifica il file RuntimeSettings.xml appena copiato ed elimina tutto ciò che è compreso tra i tag <ServerSecretEncrypted, lasciando solo i tag come mostrato di seguito: ![]() Salva e chiudi il file. |
3.6 | Ripristina il token del controller | Immetti il comando utilizzando il token del controller della versione originale di Server
Risoluzione dei problemi: In questo passaggio, la versione 2021.3+ può generare l'errore "Impossibile impostare il server secret. Errore in CryptImportKey(3): dati errati. (-2146893819)". Per risolvere il problema, consulta il passaggio precedente per assicurarti che il valore tra i tag sia stato rimosso. |
3.7 | Ripristina chiavi di archiviazione crittografate | Il valore ![]() |
3.8 | Ripristina l'utente run-as | Se sulla versione originale di Server era presente un Utente run-as, immetti il comando seguente, altrimenti salta questo passaggio: |
3.9 | Ripristina la password SMTP | Se hai compilato Impostazioni di sistema Alteryx > Interfaccia utente di Server > SMTP > Password (anche con la casella di spunta SMTP deselezionata), immetti il seguente comando, altrimenti salta questo passaggio. |
3.10 | Salva RuntimeSettings.xml | Salva il file RuntimeSettings.xml. |
3.11 | Is the version of Alteryx Server on your original host any of the following versions?
| YES: Go to step 3.13. NO: Continue to step 3.12. |
3.12 | Trasferisci chiave di crittografia Questa funzionalità è disponibile solo nelle seguenti versioni:
| Important: Please note that this requires the AlteryxService to be running on your original host and your target host will need to be able to access it over the network. La procedura descritta in Procedura di trasferimento delle chiavi di crittografia consente di trasferire la chiave di crittografia dal controller esistente a quello nuovo. |
3.13 | Resta sulla riga di comando | Il passaggio 3 presuppone che ti trovi in una riga di comando dell'amministratore nella cartella |
# | Passaggio | |
---|---|---|
4.1 | Copia il backup di MongoDB | Copia il backup di Mongo dalla versione originale di Server in una cartella |
4.2 | Esegui il ripristino in una nuova cartella | Ripristina il database Mongo dalla cartella di backup in una nuova cartella di ripristino. Controlla il file mongoRestore.log come descritto di seguito per assicurarti che il ripristino sia stato eseguito. Consulta la sezione Ripristino da un backup MongoDB nel documento Backup MongoDB per trovare il comando di ripristino adatto alla versione di Server in uso. |
4.3 | Conferma l'esito positivo del ripristino | Conferma l'esito positivo del ripristino. Attenzione Questa operazione è necessaria in quanto un errore di ripristino non verrà segnalato nel passaggio precedente e può causare una mancanza di dati su Server. Per eseguire l'operazione, controlla il file mongoRestore.log nella cartella MongoDB in cui sono stati ripristinati i dati. Apri mongoRestore.log e attieniti alla seguente procedura:
Se il ripristino non è riuscito o se trovi dei risultati durante la ricerca delle parole chiave sopra elencate, contatta il supporto e fornisci tutte le informazioni di cui disponi. Non continuare se il ripristino di MongoDB non è riuscito. |
4.4 | Imposta il percorso Mongo in RuntimeSettings.XML | Modifica RuntimeSettings.xml e immetti il percorso di Esempio: ![]() Salva e chiudi l'editor di testo. |
4.5 | Avvia MongoDB | Immetti il comando
Esempio
|
Non chiudere la finestra del prompt dei comandi. Se chiudi la finestra al passaggio 3.5, nessuna delle fasi successive funzionerà. | ||
<< Begin second Command Prompt section >> | ||
4.6 | Apri un secondo prompt dei comandi nella cartella bin | Apri un SECONDO prompt dei comandi come amministratore, accedi alla cartella
|
4.7 | Recupera la password Mongo non amministratore | Immetti il comando e copia la NON_ADMIN_MONGO_PASSWORD in Blocco note
|
4.8 | Avvia la riga di comando Mongo | Immetti il comando
Esempio
Una volta eseguita l'operazione, dovrebbe apparire il prompt " |
4.9 | Elimina i blocchi impostati dalla versione originale di Server | Immetti il comando Mongo
Al termine dell'operazione, dovrebbe apparire " |
4.10 | Switch to AlteryxService database | Enter the Mongo command |
4.11 | Delete AlteryxService locks set by original Server | Enter the Mongo command On success you should see: " |
4.12 | Esci dalla riga di comando di Mongo e dal prompt dei comandi 2 | Immetti il comando
Chiudi Command_Prompt_2 |
<< Fine della seconda sezione del prompt di comando >> | ||
4.13 | Arresta il database Mongo | Nel prompt dei comandi originale, immetti il comando da tastiera
una o più volte fino a uscire da MongoDB e a tornare a un normale prompt dei comandi. Chiudi il prompt dei comandi. |
# | Passaggio | Dettagli |
---|---|---|
5.1 | Avevi un Utente di accesso al servizio sulla versione originale di Server? | Imposta l'Utente di accesso al servizio sulla nuova versione di Server. App Servizi Windows > fai clic con il pulsante destro del mouse su AlteryxService > Proprietà > Accesso |
5.2 | Aggiungi driver dati e DSN di sistema. | Aggiungi driver della stessa versione e DSN di sistema con lo stesso nome per garantire la corrispondenza con la versione originale di Server, https://downloads.alteryx.com/. |
Problemi complessi che potrebbero non essere applicabili al ripristino: | ||
5.3 | In ambienti più sicuri, configura le autorizzazioni utente run-as richieste. | Assicurati che tutte le credenziali utilizzate per eseguire i flussi di lavoro (Run As, Accesso al servizio o le credenziali impostate al momento del salvataggio del flusso di lavoro) abbiano l'accesso appropriato e configura le autorizzazioni utente run-as richieste. |
5.4 | Ripristina gli alias di connessione In-DB e basati sul sistema | Connessioni dati di sistema:
Connessioni dati In-DB di sistema:
|
5.5 | Ripristina gli alias di connessione In-DB utente e basati sull'utente | Connessioni dati utente:
Connessioni dati In-DB utente:
|
5.6 | I flussi di lavoro utilizzano i connettori? | Copia le cartelle del connettore dalla versione originale di Server in
Contatta l'assistenza clienti per attivare i connettori sulla nuova versione di Server. |
5.7 | I flussi di lavoro utilizzano lo strumento Python? | Reinstalla tutti i pacchetti Python installati sui flussi di lavoro. Consulta Server Upgrade Python Tool Environment Checklist. |
5.8 | Usi il protocollo SSL? | Se stai eseguendo il ripristino su un server Sandbox a scopo di test, utilizza HTTP. Se stai eseguendo la migrazione a una nuova versione di Server, ripristina il protocollo SSL: Configurazione di SSL/TLS per Server Configurazione di Alteryx Server per SSL: recupero e installazione dei certificati (15577) |
# | Passaggio | Dettagli |
---|---|---|
6.1 | Rivedi le impostazioni di sistema di Alteryx e, se necessario, sospendi le pianificazioni. | Esegui le impostazioni di sistema di Alteryx e leggi ogni pagina per confermare che le impostazioni (come il token del controller) contengono i valori previsti. Se non desideri eseguire le pianificazioni all'avvio del servizio, deseleziona: Worker > Generale > Consenti al computer di eseguire i flussi di lavoro Alteryx pianificati Quando selezioni Fine, AlteryxService dovrebbe avviarsi e Server dovrebbe essere disponibile in un browser. |
Importante
Presta particolare attenzione alle impostazioni di Configurazione interfaccia utente di Server poiché una nuova versione di Server potrebbe avere un URL diverso o non disporre di un certificato SSL.

# | Passaggio | Dettagli |
---|---|---|
7.1 | Test di base | AlteryxService è in esecuzione? È possibile:
|
7.2 | Test specifici del flusso di lavoro | Puoi eseguire flussi di lavoro che contengono estensioni o connessioni esterne, ad esempio
|