Guida al ripristino dell'host di Server

1.1

Impostazione del fuso orario dell'host

Il fuso orario di Windows dell'host di destinazione deve corrispondere a quello dell'host originale.

1.2

Verifica l'accesso a Alteryx

Assicurati che l'host sia in grado di contattare il dominio whitelist.alteryx.com utilizzato dal sistema di gestione delle licenze Alteryx.

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

c:

cd \Program Files\Alteryx\bin

3.2

Arresta il servizio

Immetti il comando

net stop alteryxservice

Al termine dell'operazione, dovresti visualizzare il messaggio "Arresto del servizio AlteryxService completato".

3.3

Backup esistente RuntimeSettings.xml

Immetti il comando

c:

cd \ProgramData\Alteryx ren RuntimeSettings.xml RuntimeSettings_BACKUP.xml

3.4

Nell'host di destinazione è disponibile un file RuntimeSettings.xml preparato in precedenza, nell'ambito della preparazione al ripristino di emergenza?

SÌ: il file RuntimeSettings.xml per il processo di ripristino di emergenza dovrebbe essere già presente nella directory %ProgramData%\Alteryx\ dell'host di destinazione. In caso contrario, copia in %ProgramData%/Alteryx il file RuntimeSettings.xml che hai preparato.

Vai al Passaggio 3.13.

NO: copia il file RuntimeSettings.xml dall'host originale alla directory %ProgramData%\Alteryx\ dell'host di destinazione.

Continua con il Passaggio 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

AlteryxService.exe setserversecret=CONTROLLER_TOKEN_FROM_ORIGINAL_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 <StorageKeysEncrypted> potrebbe essere cambiato quando il token del controller è stato reimpostato nel Passaggio 3.6. In tal caso, deve essere sostituito con il valore corrispondente a quello del file RuntimeSettings.xml originale. Questo è il file RuntimeSettings.xml di origine copiato nel Passaggio 3.4. È più facile copiare anche i tag in modo da garantire che l'intero valore incluso tra loro venga copiato dal file RuntimeSettings.xml originale. Puoi lasciare il file RuntimeSettings.xml aperto in un editor di testo mentre apporti le altre modifiche nel Passaggio 4.

3.8

Ripristina l'utente run-as

Se nella versione originale dell'host era presente un Utente run-as, immetti il comando seguente, altrimenti salta questo passaggio.AlteryxService.exe setexecuteuser=NAME,DOMAIN,PASSWORD

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.AlteryxService.exe setsmtppassword=PASSWORD

3.10

Salva RuntimeSettings.xml

Salva il file RuntimeSettings.xml.

3.11

La versione di Alteryx Server sull'host originale è una delle seguenti?

SÌ: vai al Passaggio 3.13.

NO: continua con il Passaggio 3.12.

3.12

Trasferisci chiave di crittografia

Questa funzionalità è disponibile solo nelle seguenti versioni:

Importante: è necessario che AlteryxService sia in esecuzione nell'host originale e che sia accessibile in rete all'host di destinazione.

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 4 presuppone che ti trovi in una riga di comando amministrativa nella cartella \Alteryx\bin.

4.1

Copia il backup di MongoDB

Copia il backup di MongoDB dall'host originale a una cartella MONGO_BACKUP nel nuovo host.

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:

Qualora il ripristino non fosse riuscito, o se la ricerca delle parole chiave elencate sopra restituisse risultati, contatta l'assistenza clienti e fornisci tutte le informazioni raccolte.

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 MONGO_RESTORE_FOLDER nel tag <EmbeddedMongoDBRootPath>.

Esempio:

Salva e chiudi l'editor di testo.

4.5

Avvia MongoDB

Immetti il comando

mongod ––dbpath "MONGO_RESTORE_FOLDER" ––auth ––port 27018

Esempio

mongod ––dbpath "%ProgramData%\Alteryx\Service\Persistence\Mongo_Restore" ––auth ––port 27018

Non chiudere la finestra del prompt dei comandi.

Qualora chiudessi la finestra durante il Passaggio 4.5, i passaggi successivi non funzioneranno.

<< 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 Alteryx\bin e immetti i comandi riportati di seguito (in base alla posizione di installazione).

c:

cd \Program Files\Alteryx\bin

4.7

Recupera la password Mongo non amministratore

Immetti il comando e copia la NON_ADMIN_MONGO_PASSWORD in Blocco note

AlteryxService.exe getemongopassword

4.8

Avvia la riga di comando Mongo

Immetti il comando

mongosh mongodb://SERVER:PORT/AlteryxGallery -u user -p NON_ADMIN_MONGO_PASSWORD

Esempio

mongosh mongodb://localhost:27018/AlteryxGallery -u user -p CCEC***33C0

Una volta eseguita l'operazione, dovrebbe apparire il prompt ">".

4.9

Eliminazione dei blocchi AlteryxGallery impostati dall'istanza originale di Server

Immetti il comando Mongo

db.locks.remove({})

Al termine dell'operazione, dovrebbe apparire "writeResult({ “nRemoved” : N })", dove N è un numero compreso tra 0 e 3.

4.10

Passa al database AlteryxService

Immetti il comando Mongo

use AlteryxService

4.11

Elimina i blocchi AlteryxService impostati dall'istanza originale di Server

Immetti il comando Mongo

db.locks.remove({})

Al termine dell'operazione, dovrebbe apparire "writeResult({ "nRemoved" : N })", dove N è un numero compreso tra 0 e 3.

4.12

Esci dalla riga di comando di Mongo e dal prompt dei comandi 2

Immetti il comando

exit

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

ctrl-c

una o più volte fino a uscire da MongoDB e a tornare a un normale prompt dei comandi.

Chiudi il prompt dei comandi.

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.Configurazione delle autorizzazioni obbligatorie per gli utenti run-as

5.4

Ripristina gli alias di connessione In-DB e basati sul sistema

Connessioni dati di sistema:

%ProgramData%\Alteryx\Engine\SystemAlias.xml

Connessioni dati In-DB di sistema:

%ProgramData%\Alteryx\Engine\SystemConnections.xml

5.5

Ripristina gli alias di connessione In-DB utente e basati sull'utente

Connessioni dati utente:

C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserConnections.xml

Connessioni dati In-DB utente:

C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserAlias.xml

5.6

I flussi di lavoro utilizzano i connettori?

Copia le cartelle del connettore dalla versione originale di Server in

%ProgramData%\Alteryx\Tools

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 Ambiente dello strumento Python negli upgrade di Server.

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

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.

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