Préparation à la récupération après incident

1.1

Pouvez-vous mettre à niveau ou installer la dernière version et le dernier correctif d'Alteryx Server sur vos machines d'origine et cible ?

OUI : mettez à niveau ou installez la dernière version et le correctif d'Alteryx Server sur vos machines d'origine et cible. Configurez votre machine d'origine comme d'habitude.

Passez à l'étape 2.1 .

NON : continuez à l'étape 1.2 .

1.2

Pouvez-vous mettre à niveau vos machines d'origine et cible vers le dernier correctif pour cette version ?

OUI : appliquez le correctif le plus récent à votre machine d'origine pour sa version majeure et installez la dernière version et le correctif correspondants sur votre machine cible. Par exemple, si vous utilisez le correctif 3 de la version 2022.3, installez le correctif le plus récent disponible pour la version 2022.3. 

Passez à l'étape 2.1 .

NON : continuez à l'étape 1.3 .

1.3

La version d'Alteryx Server sur votre machine d'origine figure-t-elle dans la liste Machines cibles compatibles de la section Conditions préalables  ?

OUI : installez ou mettez à niveau la machine cible avec la même version majeure et la même version de correctif que celles qui existent sur la machine d'origine. Utilisez le fichier d'installation complet plutôt que le fichier d'installation du correctif.

Si nécessaire, veuillez contacter fulfillment@alteryx.com pour demander le fichier d'installation nécessaire.

Passez à l'étape 2.1 .

NON : continuez à l'étape 1.4 .

1.4

Installez la version la plus récente de correctif d'Alteryx Server sur la machine cible.

Installez ou mettez à niveau la machine cible avec le correctif le plus récent disponible pour la version majeure de la machine d'origine (par exemple, si la machine d'origine dispose du correctif 3 de la version 2022.3, installez le correctif le plus récent de la version 2022.3 sur la machine cible).

Passez à l'étape 2.1 .

2.1

Recherchez la longueur du jeton contrôleur sur la machine d'origine.

Dans Paramètres système Alteryx > Controller (Contrôleur) > General (Général), sélectionnez View  (Afficher). Enregistrez la longueur du jeton contrôleur.

2.2

Votre jeton contrôleur comporte-t-il 40 caractères ?

OUI : accédez à Paramètres système Alteryx > Controller  (Contrôleur) > General  (Général) > et sélectionnez Regenerate (Régénérer).

NON : passez à l'étape 2.5 .

2.3

Redémarrez AlteryxService .

Parcourez le reste des paramètres système Alteryx et sélectionnez Finish (Terminer). AlteryxService redémarre.

2.4

Reconnectez les nœuds supplémentaires (le cas échéant).

Si vous disposez d'une configuration à plusieurs nœuds, utilisez le jeton contrôleur nouvellement régénéré pour reconnecter tous vos nœuds à votre nœud de contrôleur.

2.5

Enregistrez et copiez le jeton contrôleur à partir de la machine d'origine.

Pour le jeton contrôleur, accédez à Paramètres système Alteryx > Controller (Contrôleur) > General (Général) > Token  (Jeton) > View  (Afficher).

Copiez et enregistrez le jeton contrôleur dans un document texte. Copiez ensuite le document texte à l'emplacement de votre choix sur votre machine cible.

2.6

Copiez le fichier RuntimeSettings.xml à partir de la machine d'origine.

Copiez le fichier RuntimeSettings.xml à partir de %ProgramData%\Alteryx sur votre machine d'origine vers l'emplacement de votre choix sur votre machine cible.

3.1

Ouvrez l' invite de commande dans le dossier bin sur l'ordinateur cible.

Ouvrez une invite de commande en tant qu'administrateur et accédez au dossier d'installation Alteryx\bin . Les commandes de cette section doivent toutes être exécutées à partir de ce dossier.

3.2

Arrêtez AlteryxService .

Saisissez la commande :

net stop alteryxservice

Si AlteryxService est en cours d'exécution, vous devriez voir le message « The AlteryxService service was stopped successfully. » en cas de succès.

Si AlteryxService est arrêté, vous devriez voir le message « The AlteryxService service is not started. ».

Gardez cette fenêtre ouverte.

3.3

Sauvegardez le fichier RuntimeSettings.xml existant sur la machine cible.

Renommez le fichier %ProgramData%\Alteryx\RuntimeSettings.xml de la machine cible en RuntimeSettings_BACKUP.xml pour le sauvegarder.  

Si le fichier RuntimeSettings.xml n'existe pas, passez à l'étape 3.4 .

3.4

Restaurez le fichier RuntimeSettings.xml .

Copiez-collez le fichier RuntimeSettings.xml copié depuis votre machine d'origine à l'étape 2.6 dans le dossier %ProgramData%\Alteryx sur votre machine cible.

3.5

Effacez le jeton contrôleur .

Modifiez le fichier %ProgramData%\Alteryx\RuntimeSettings.xml sur votre machine cible.

Supprimez tout ce qui se trouve entre les balises <ServerSecretEncrypted> , en ne laissant que les balises comme indiqué ci-dessous :

3.6

Enregistrez le fichier RuntimeSettings.xml .

Enregistrez le fichier RuntimeSettings.xml sur votre machine cible.

3.7

Restaurez le jeton contrôleur .

Revenez à l'invite de commande ouverte à l'étape 3.1 , saisissez la commande suivante en utilisant le jeton contrôleur de votre machine d'origine récupéré à l' étape 2.5  :

AlteryxService.exe setserversecret=CONTROLLER_TOKEN_FROM_ORIGINAL_SERVER

Dépannage  : lors de cette étape, la version 2021.3+ peut produire l'erreur « Set server secret failed: Error in CryptImportKey(3): Bad Data. (-2146893819) ». Pour corriger ce problème, reportez-vous aux étapes 3.5 à 3.6 pour vous assurer que vous avez supprimé la valeur entre les balises.

3.8

Effacez les clés de stockage .

Modifiez à nouveau le fichier %ProgramData%\Alteryx\RuntimeSettings.xml situé sur votre machine cible.

Supprimez tout ce qui se trouve entre les balises <StorageKeysEncrypted> , en ne laissant que les balises comme indiqué ci-dessous :

3.9

Restaurez les clés de stockage .

Copiez la valeur <StorageKeysEncrypted> à partir du fichier RuntimeSettings.xml récupéré à l' étape 2.6 et copiez-la entre les balises <StorageKeysEncrypted> dans le fichier RuntimeSettings.xml sur votre machine cible . La longueur de cette valeur varie selon les versions. Voir les exemples ci-dessous :

3.10

Enregistrez le fichier RuntimeSettings.xml .

Enregistrez le fichier RuntimeSettings.xml sur votre machine cible.

3.11

Restaurez la fonction Exécuter en tant qu'utilisateur .

Si vous disposiez de la fonction Exécuter en tant qu'utilisateur sur le Server d'origine, saisissez la commande ci-après. Sinon, ignorez cette étape.

AlteryxService.exe setexecuteuser=NAME,DOMAIN,PASSWORD

3.12

Restaurez le mot de passe SMTP .

Si vous avez renseigné Paramètres système Alteryx > Interface utilisateur Server > SMTP > Mot de passe (même si la case à cocher SMTP n'a pas été cochée), saisissez la commande ci-après. Sinon, ignorez cette étape.

AlteryxService.exe setsmtppassword=PASSWORD

3.13

Restaurez la clé de chiffrement .

Les étapes décrites dans la section Processus de transfert de la clé de chiffrement vous permettent de transférer la clé de chiffrement de votre machine d'origine vers votre machine cible. Notez que la dernière étape du processus de transfert de la clé de chiffrement nécessite le redémarrage du service, ce qui n'est pas possible dans certains cas où la machine cible ne dispose pas de licence.