Preparazione al ripristino di emergenza
Importante
Throughout this document, 2 hosts will be referenced:
Original: The current host running Alteryx Server.
Target: The backup host to be used for disaster recovery. This host does not require an Alteryx Server license to be used as a backup host.
Scope
This document covers the procedures needed to prepare for a Disaster Recovery scenario where the original Alteryx Server Controller node is no longer accessible. The items in this guide can be used in conjunction with the Server Host Recovery Guide to restore a Server host in a Disaster Recovery scenario.
This document is not intended for High Availability environments. For more details, refer to the High-Availability Best Practices page.
Prerequisites
Backup of the Alteryx Server Persistence layer (MongoDB or SQL Server) stored independently from the current Alteryx Server environment.
Nota
This guide does not cover creating a backup of the Persistence layer required for disaster recovery. For more information on Server backup and recovery for embedded MongoDB, see Server Backup & Restore Best Practices: Part 1 and Part 2. For user-managed MongoDB or SQL Server instances, please contact your MongoDB or SQL Server administrator.
Prepared RuntimeSettings.xml located. See Prepare RuntimeSettings.xml.
Optional
The following items might be leveraged on the original Server. Check if the functionality is being used on your original Server. If applicable, make sure copies of the following files and resources are available independent of your current Server environment.
AlteryxService Log On user credentials
Run-As User credentials
SMTP server credential
Connector Tools found in
%ProgramData%\Alteryx\Tools
.Alteryx System-Based and In-DB Connection aliases:
System Data Connections:
%ProgramData%\Alteryx\Engine\SystemAlias.xml
In-DB Data Connections:
%ProgramData%\Alteryx\Engine\SystemConnections.xml
Alteryx User-Based and In-DB Connection Aliases from the original Server – the items below might be relevant for each Run-As or workflow credential user account:
User Data Connections:
C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserConnections.xml
User In-DB Data Connections:
C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserAlias.xml
Importante
Se utilizzi una versione di Server elencata nella tabella seguente, la procedura descritta in questa guida non è necessaria e puoi attenerti alla Guida al ripristino dell'host di Server per il ripristino di emergenza se è disponibile una copia di RuntimeSettings.xml e del database del tuo host.
Versioni di Alteryx Server per l'utilizzo della Guida al ripristino dell'host di Server |
---|
2021.4.2.47792 (patch 4) o versioni o patch precedenti |
2022.1.1.42590 (patch 1 e 2) |
Preparazione al ripristino di emergenza - RuntimeSettings.xml
A causa delle modifiche recenti apportate ai metodi di crittografia (TGAL-6764), gli utenti devono ora prepararsi in modo proattivo per uno scenario di ripristino di emergenza in cui il nodo del controller di Alteryx Server originale non è più disponibile. Questa guida illustra la procedura per preparare il file RuntimeSettings.xml su un nodo del controller di backup da utilizzare per il ripristino di emergenza.
Prerequisiti
Accesso come amministratore all'host originale e a quello di destinazione.
L'host originale deve essere in funzione e Alteryx Service deve essere in esecuzione.
Host originale | Host di destinazione compatibili |
---|---|
2021.4.2.47792 (patch 5) o patch più recente | 2021.4.2.47884 (patch 11) o patch più recente della versione 2021.4 |
2022.1.1.42590 (patch 3) o patch più recente | 2022.1.1.42691 (patch 9) o patch più recente della versione 2022.1 |
2022.3.1.430 (Server GA) o patch più recente | 2022.3.1.553 (patch 6) o patch più recente della versione 2022.3 |
2023.1.1.123 (Server GA) o patch più recente | 2023.1.1.247 (patch 2) o patch più recente della versione 2023.1 |
Tutte le versioni più recenti e future di Alteryx Server | Qualsiasi release di GA o patch, purché l'host originale e quello di destinazione abbiano la stessa versione e patch. |
Passaggio 1: Installazione di Alteryx Server
# | Passaggio | Dettagli |
---|---|---|
1.1 | Puoi aggiornare o installare la versione e la patch più recenti di Alteryx Server sull'host originale e su quello di destinazione? | SÌ: aggiorna o installa la versione e la patch più recenti di Alteryx Server sull'host originale e su quello di destinazione. Configura l'host originale come di consueto. Vai al passaggio 2.1. Note: You do not need to configure Alteryx Server post installation on your target host as this process does not require it to be licensed. |
NO: continua al passaggio 1.2. | ||
1.2 | Puoi aggiornare l'host originale e quello di destinazione alla patch più recente per la versione specificata? | SÌ:applica all'host originale la patch più recente per la versione principale e installa sull'host di destinazione la versione e la patch corrispondenti più recenti. Ad esempio, se disponi della versione 2022.3 patch 3, installa la patch più recente disponibile per tale versione. Vai al passaggio 2.1. Note: You do not need to configure Alteryx Server post installation as this process does not require it to be licensed. |
NO: continua al passaggio 1.3. | ||
1.3 | La versione di Alteryx Server sull'host originale appare nell'elenco Host di destinazione compatibili della sezione Prerequisiti? | SÌ: installa o aggiorna l'host di destinazione con la stessa versione principale e patch dell'host originale. Utilizza il file di installazione completo anziché l'installazione della patch. Se necessario, contatta fulfillment@alteryx.com per richiedere il file di installazione necessario. Vai al passaggio 2.1. Note: You do not need to configure Alteryx Server post installation as this process does not require it to be licensed. |
NO: continua al passaggio 1.4 | ||
1.4 | Installa la versione più recente della patch di Alteryx Server sull'host di destinazione. | Installa o aggiorna l'host di destinazione alla patch più recente disponibile per la versione principale sull'host originale (ad esempio, se sull'host originale è installata la patch 3 versione 2022.3, installa la patch più recente della versione 2022.3 sull'host di destinazione). Vai al passaggio 2.1. Note: You do not need to configure Alteryx Server post installation as this process does not require it to be licensed. |
Passaggio 2: Preparazione e copia del token del controller e del file RuntimeSettings.xml
# | Passaggio | Dettagli |
---|---|---|
2.1 | Individua la lunghezza del token del controller sull'host originale. | In Impostazioni di sistema di Alteryx > Controller > Generale, seleziona Visualizza. Registra la lunghezza del token del controller. Note: In some versions, the Controller Token is partially obscured. Double-click on the Token to highlight it in its entirety, then copy and paste into a text document to determine its length. |
2.2 | Il token del controller è lungo 40 caratteri? | SÌ: vai in Impostazioni di sistema di Alteryx > Controller > Generale > seleziona Rigenera. |
NO: vai al passaggio 2.5. | ||
2.3 | Riavvia AlteryxService. | Sfoglia le altre Impostazioni di sistema di Alteryx e seleziona Fine. AlteryxService verrà riavviato. |
2.4 | Ricollega i nodi aggiuntivi (se applicabile). | Se disponi di una configurazione multinodo, utilizza il token del controller appena rigenerato per ricollegare tutti i nodi al nodo del controller. |
2.5 | Salva e copia il token del controller dall'host originale. | Per il token del controller, seleziona Impostazioni di sistema di Alteryx > Controller > Generale > Token > Visualizza. Copia e salva il token del controller in un documento di testo. Quindi, copia il documento di testo in una posizione a scelta sull'host di destinazione. Note: In some versions, the Controller Token is partially obscured. Double-click on the Token to highlight it in its entirety, then copy and paste into a text document. |
2.6 | Copia RuntimeSettings.xml dall'host originale. | Copia il file RuntimeSettings.xml da %ProgramData%\Alteryx sull'host originale in una posizione a scelta sull'host di destinazione. Important: Do not copy the file to |
Passaggio 3. Ripristino di RuntimeSettings.xml
# | Passaggio | Dettagli |
---|---|---|
3.1 | Apri il prompt dei comandi nella cartella bin sull'host di destinazione. | Apri un prompt dei comandi come amministratore e accedi alla cartella di installazione Alteryx\bin. Tutti i comandi in questa sezione devono essere eseguiti da questa cartella. Note: If you’re unsure of the location of this folder, check the properties of the ‘Alteryx System Settings’ shortcut, as the file it points to is in the desired folder. Default location: |
3.2 | Arresta AlteryxService. | Immetti il comando:
Se AlteryxService era in esecuzione, al termine dell'operazione dovresti visualizzare il messaggio "Arresto del servizio AlteryxService completato". Se AlteryxService è stato interrotto, dovresti visualizzare il messaggio "il servizio AlteryxService non è stato avviato". Lascia aperta questa finestra. |
3.3 | Esegui il backup del file RuntimeSettings.xml sull'host di destinazione. | Rinomina %ProgramData%\Alteryx\RRuntimeSettings.xml sull'host di destinazione in RuntimeSettings_BACKUP.xml come backup. Se RuntimeSettings.xml non esiste, vai al passaggio 3.4. |
3.4 | Ripristina RuntimeSettings.xml. | Copia e incolla il file RuntimeSettings.xml copiato dall'host originale al passaggio 2.6 in %ProgramData%\Alteryx nell'host di destinazione. Note: Make sure to copy file. Do not move and cut it as the file will be needed in its original state throughout this guide. |
3.5 | Cancella il token del controller | Modifica %ProgramData%\Alteryx\RRuntimeSettings.xml sull'host di destinazione. Elimina tutto ciò che si trova tra i tag <ServerSecretEncrypted>, lasciando solo i tag come mostrato di seguito: ![]() |
3.6 | Salva RuntimeSettings.xml. | Salva RuntimeSettings.xml sull'host di destinazione. |
3.7 | Ripristina il token del controller. | Nel prompt dei comandi aperto al passaggio 3.1, immetti il seguente comando utilizzando il token del controller dell'host originale riportato al passaggio 2.5:
Risoluzione dei problemi: la versione 2021.3+ può generare l'errore: "Impossibile impostare il server secret: Errore inCryptImportKey(3): dati errati. (-2146893819)". Per correggere questo problema, consulta i passaggi 3.5 - 3.6 per assicurarti di aver rimosso il valore tra i tag. |
3.8 | Cancella le chiavi di memorizzazione. | Modifica di nuovo %ProgramData%\Alteryx\RRuntimeSettings.xml sull'host di destinazione. Elimina tutto ciò che si trova tra i tag <StorageKeysEncrypted>, lasciando solo i tag come mostrato di seguito: ![]() |
3.9 | Ripristina le chiavi di memorizzazione. | Copia il valore <StorageKeysEncrypted> dal file RuntimeSettings.xml al passaggio 2.6 e incollalo tra i tag <StorageKeysEncrypted> in RuntimeSettings.xml sull'host di destinazione. La lunghezza di questo valore varia a seconda della versione. Vedi gli esempi riportati di seguito: ![]() |
3.10 | Salva RuntimeSettings.xml. | Salva RuntimeSettings.xml sull'host di destinazione. |
3.11 | Ripristina Utente run-as | Se sulla versione originale di Server era presente un utente run-as, immetti il comando seguente, altrimenti salta questo passaggio:
|
3.12 | Ripristina la password SMTP. | Se hai compilato Impostazioni di sistema di Alteryx > Interfaccia utente di Server > SMTP > Password (anche con la casella di spunta SMTP deselezionata), immetti il seguente comando, altrimenti salta questo passaggio:
|
3.13 | Ripristina la chiave di crittografia | La procedura descritta in Procedura di trasferimento delle chiavi di crittografia consente di trasferire la chiave di crittografia dall'host originale a quello di destinazione. L'ultima fase della procedura di trasferimento delle chiavi di crittografia richiede il riavvio del servizio, che non è possibile in alcuni casi in cui l'host di destinazione non dispone di licenza. La procedura descritta in Procedura di trasferimento delle chiavi di crittografia consente di trasferire la chiave di crittografia dall'host originale a quello di destinazione. L'ultima fase della procedura di trasferimento delle chiavi di crittografia richiede il riavvio del servizio, che non è possibile in alcuni casi in cui l'host di destinazione non dispone di licenza. |
Fatto. Il file RuntimeSettings.xml sull'host di destinazione ora può essere utilizzato in uno scenario di ripristino di emergenza in cui l'host originale non è più disponibile. Tieni presente che il fileRuntimeSettings.xml preparato nel passaggio 3 funzionerà sull'host di destinazione solo con un MongoDB o DB SQL utilizzato sull'host originale.
Considerazioni future
Al termine di questo processo, mentre aggiorni l'host originale a versioni più recenti di Server, dovrai anche aggiornare l'host di destinazione alla stessa versione e patch per garantire risultati ottimali in uno scenario di ripristino di emergenza.
Se cambi il token del controller sull'host originale, dovrai ripetere il passaggio 2 e quelli successivi per assicurarti che i token del controller dell'host di destinazione e di quello originale corrispondano.