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 hôtes d'origine et cible ?

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

Passez à l'étape 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.

NON : continuez à l'étape 1.2.

1.2

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

OUI :appliquez le correctif le plus récent à votre hôte d'origine pour sa version majeure et installez la dernière version et le correctif correspondants sur votre hôte 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.

Note: You do not need to configure Alteryx Server post installation as this process does not require it to be licensed.

NON : continuez à l'étape 1.3.

1.3

La version d'Alteryx Server sur votre hôte d'origine figure-t-elle dans la liste Hôtes cibles compatibles de la section Conditions préalables ?

OUI : installez ou mettez à niveau l'hôte cible avec la même version majeure et la même version de correctif que celles qui existent sur l'hôte 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.

Note: You do not need to configure Alteryx Server post installation as this process does not require it to be licensed.

NON : continuez à l'étape 1.4.

1.4

Installez la version la plus récente de correctif d'Alteryx Server sur l'hôte cible.

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

Passez à l'étape 2.1.

Note: You do not need to configure Alteryx Server post installation as this process does not require it to be licensed.

2.1

Recherchez la longueur du jeton contrôleur sur l'hôte 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.

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

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 l'hôte 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 hôte cible.

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

Copiez le fichier RuntimeSettings.xml à partir de l'hôte d'origine.

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

Important: Do not copy the file to %ProgramData%\Alteryx on the target host and do not modify the file.

3.1

Ouvrez l'invite de commande dans le dossier bin sur l'hôte 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.

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: C:\Program Files\Alteryx\bin.

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 l'hôte cible.

Renommez le fichier %ProgramData%\Alteryx\RuntimeSettings.xml de l'hôte 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.

Collez le fichier RuntimeSettings.xml copié de votre hôte d'origine à l'étape 2.6 dans le dossier %ProgramData%\Alteryx sur votre hôte cible.

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

Effacez le jeton contrôleur.

Modifiez le fichier %ProgramData%\Alteryx\RuntimeSettings.xml sur votre hôte 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 hôte 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 hôte 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 hôte 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 hôte 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 hôte 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 hôte d'origine vers votre hôte 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ù l'hôte cible ne dispose pas de licence.

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 hôte d'origine vers votre hôte 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ù l'hôte cible ne dispose pas de licence.