Preparazione al ripristino di emergenza
Importante
Se utilizzi una versione di Server presente nella tabella di seguito, 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 computer.
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.
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.
Importante
In questo documento, si farà riferimento a 2 computer:
Originale : l'attuale computer sul quale è in esecuzione Alteryx Server.
Destinazione : il computer di backup da utilizzare per il ripristino di emergenza. Questo computer non richiede una licenza Alteryx Server per essere utilizzato come computer di backup.
Prerequisiti
Accesso come amministratore al computer originale e a quello di destinazione.
Il computer originale deve essere in funzione e Alteryx Service deve essere in esecuzione.
Computer originale | Computer 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é il computer 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ù recente di Alteryx Server sul computer originale e su quello di destinazione? | SÌ: aggiorna o installa la versione e la patch più recente di Alteryx Server sul computer originale e su quello di destinazione. Configura il computer originale come di consueto. Vai al passaggio 2.1 . Nota Non è necessario configurare Alteryx Server dopo l'installazione sul computer di destinazione poiché questo processo non richiede la licenza. |
NO: continua al passaggio 1.2 . | ||
1.2 | Puoi aggiornare il computer originale e quello di destinazione alla patch più recente per la versione specificata? | SÌ: applica la patch al computer originale con la patch più recente per la versione principale e installa la versione e la patch più recente corrispondente sul computer di destinazione. 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. |
NO: continua al passaggio 1.3 . | ||
1.3 | La versione di Alteryx Server sul computer originale appare nell'elenco Computer di destinazione compatibili della sezione Prerequisiti ? | SÌ: installa o aggiorna il computer di destinazione alla stessa versione principale e patch del computer 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. |
NO: continua al passaggio 1.4 | ||
1.4 | Installa la versione più recente della patch di Alteryx Server sul computer di destinazione. | Installa o aggiorna il computer di destinazione alla patch più recente disponibile per la versione principale sul computer originale (ad esempio, se sul computer originale è installata la versione 2022.3 patch 3, installa la patch più recente di 2022.3 sul computer di destinazione). Vai al passaggio 2.1 . Nota Non è necessario configurare Alteryx Server dopo l'installazione poiché questo processo non richiede la licenza. |
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 sul computer 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 nella sua interezza, quindi copialo/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 dal computer 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 sul computer di destinazione. Nota In alcune versioni, il token del controller è parzialmente oscurato. Fai doppio clic sul token per evidenziarlo nella sua interezza, quindi copialo/incollalo in un documento di testo. |
2.6 | Copia RuntimeSettings.xml dal computer originale. | Copia il file RuntimeSettings.xml da %ProgramData%\Alteryx sul computer originale in una posizione a scelta sul computer di destinazione. Importante Non copiare il file in %ProgramData%\Alteryx sul computer di destinazione e non modificarlo. |
Passaggio 3. Ripristino di RuntimeSettings.xml
# | Passaggio | Dettagli |
---|---|---|
3.1 | Apri il prompt dei comandi nella cartella bin sul computer 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 sai di sicuro la posizione di questa cartella, controlla le proprietà del collegamento "Impostazioni di sistema di Alteryx", poiché il file a cui punta si trova nella cartella desiderata. La posizione predefinita è: C:\Program Files\Alteryx\bin . |
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 esistente sul computer di destinazione. | Rinomina il computer di destinazione %ProgramData%\Alteryx\RRuntimeSettings.xml 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 dal computer originale al passaggio 2.6 in %ProgramData%\Alteryx nel computer di destinazione. Nota Assicurati di copiare il file. Non spostarlo/tagliarlo poiché in questa guida è necessario che il file sia nel suo stato originale. |
3.5 | Cancella il token del controller | Modifica %ProgramData%\Alteryx\RRuntimeSettings.xml sul computer 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 sul computer di destinazione. |
3.7 | Ripristina il token del controller . | Di nuovo nel prompt dei comandi aperto al passaggio 3.1 , immetti il seguente comando utilizzando il token del controller del computer 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 situato sul computer 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 sul computer 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 sul computer 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 della versione originale di Server e che la nuova versione di Server sia in grado di accedervi tramite la rete. La procedura descritta in Procedura di trasferimento delle chiavi di crittografia consente di trasferire la chiave di crittografia dal computer originale a quello di destinazione. L'ultima fase della Procedura di trasferimento delle chiavi di crittografia richiede di riavviare il servizio, cosa che non è possibile in alcuni casi in cui il computer di destinazione non dispone di licenza. |
Fatto. Il file RuntimeSettings.xml sul computer di destinazione può ora essere utilizzato in uno scenario di ripristino di emergenza in cui il computer originale non è più disponibile. Tieni presente che il file RuntimeSettings.xml preparato nel passaggio 3 funzionerà sul computer di destinazione solo con il MongoDB o DB SQL utilizzato sul computer originale.
Considerazioni future
Al termine di questo processo, mentre aggiorni il computer originale a versioni più recenti di Server, dovrai anche aggiornare il computer di destinazione alla stessa versione e patch per assicurarti i migliori risultati in uno scenario di ripristino di emergenza.
Se cambi il token del controller sul computer originale, dovrai ripetere i passaggi 2 e successivi per assicurarti che i token del computer di destinazione e di quello originale corrispondano.