Preparazione al ripristino di emergenza
Importante
In questo documento si farà riferimento a 2 host:
Originale: l'attuale host su cui è in esecuzione Alteryx Server.
Di destinazione: l'host di backup da utilizzare per il ripristino di emergenza. Questo host non richiede una licenza Alteryx Server per essere utilizzato come host di backup.
Prerequisiti
Backup del livello di persistenza di Alteryx Server (MongoDB o SQL Server) memorizzato indipendentemente dall'ambiente Alteryx Server attuale.
Nota
Questa guida non tratta la creazione di un backup del livello di persistenza richiesto per il ripristino di emergenza. Per ulteriori informazioni sul backup e sul ripristino di Server per MongoDB incorporato, consulta le best practice per il backup e il ripristino di Server: Parte 1 e Parte 2. Per le istanze di MongoDB o SQL Server gestite dall'utente, contatta l'amministratore di MongoDB o di SQL Server.
File RuntimeSettings.xml individuato. Consulta Preparazione di RuntimeSettings.xml.
Facoltativo
Nell'istanza originale di Server potrebbero essere stati utilizzati gli elementi che seguono. Verifica se la funzionalità è in uso nell'istanza originale di Server. Se applicabile, assicurati che le copie dei seguenti file e risorse siano disponibili, indipendentemente dall'ambiente server attuale.
Credenziali di accesso utente per AlteryxService
Credenziali dell'Utente run-as
Credenziali del server SMTP
Strumenti di connessione disponibili in
%ProgramData%\Alteryx\Tools.Alias di connessione basati sul sistema Alteryx System-Based e In-DB:
Connessioni dati di sistema:
%ProgramData%\Alteryx\Engine\SystemAlias.xmlConnessioni dati In-DB:
%ProgramData%\Alteryx\Engine\SystemConnections.xml
Alias di connessione basati sull'utente Alteryx e In-DB dell'istanza originale di Server. Gli elementi che seguono potrebbero essere pertinenti per ogni account utente con credenziali del flusso di lavoro o per l'Utente run-as.
Connessioni dati utente:
C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserConnections.xmlConnessioni dati In-DB utente:
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, qualora disponessi di una copia di RuntimeSettings.xml e del database del tuo host, per il ripristino di emergenza puoi seguire le istruzioni della Guida al ripristino dell'host di Server.
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.40869 (Patch 2) o patch più recente |
Preparazione di 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 AlteryxService 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. Nota: non è necessario configurare Alteryx Server dopo l'installazione sull'host di destinazione, poiché questo processo non richiede la licenza relativa. |
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. Nota: non è necessario configurare Alteryx Server dopo l'installazione, poiché questo processo non richiede la licenza relativa. |
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. Nota: non è necessario configurare Alteryx Server dopo l'installazione, poiché questo processo non richiede la licenza relativa. |
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. Nota: non è necessario configurare Alteryx Server dopo l'installazione, poiché questo processo non richiede la licenza relativa. |
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. Nota: in alcune versioni, il token del controller è parzialmente oscurato. Fai doppio clic sul token per evidenziarlo interamente, quindi copialo e incollalo in un documento di testo per determinarne la lunghezza. |
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. Nota: in alcune versioni, il token del controller è parzialmente oscurato. Fai doppio clic sul token per evidenziarlo nella sua interezza, quindi copialo e incollalo in un documento di testo. |
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. Importante: non copiare il file in |
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. Nota: se non conosci con certezza la posizione di questa cartella, controlla le proprietà del collegamento "Impostazioni di sistema di Alteryx", che punta a un file incluso in tale cartella. La posizione predefinita è: |
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. Nota: assicurati di copiare il file. Non spostarlo o tagliarlo, poiché per le operazioni illustrate in questa guida è necessario che tale file si trovi nel suo stato originale. |
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 | Importante: è necessario che AlteryxService sia in esecuzione sul nodo del controller dell'istanza originale di Server e che la nuova istanza di Server sia in grado di accedervi attraverso la rete. 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, ma negli scenari in cui l'host di destinazione non dispone di licenza non è possibile, e può essere ignorata. |
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.