Dépannage : migrer des profils de noeud pour un environnement de cluster

Apprenez comment récupérer après une échec lors de la migration de profils de noeud pour un environnement en cluster HCL Digital Experience Portal.

Cette rubrique présente chacune des étapes qui pourra être nécessaire pour la migration des profils de noeud. Ces étapes peuvent varier en fonction de vos sélections et c'est la raison pour laquelle elles ne sont pas numérotées. Recherchez l'étape qui a échoué pour savoir comment corriger l'erreur et effectuer la reprise.

Manual Step: Stop the source deployment manager and node agents

Pourquoi et quand exécuter cette tâche

Puisqu'il s'agit d'une étape manuelle, toute erreur se produit en dehors du contexte de l'assistant.
Tableau 1. Actions appropriées pour l'étape : arrêter le gestionnaire de déploiement source et les agents de noeud

Si vous devez exécuter à nouveau une configuration, vous pouvez vous aider de ce tableau pour déterminer les actions appropriées.
Actions Notes®
Réexécuter l'étape Vous pouvez réexécuter cette étape si elle n'a pas abouti.
Ignorer l'étape Si cette étape a été effectuée, vous pouvez l'ignorer lorsque vous exécutez à nouveau le processus de configuration.
Etape de nettoyage Aucune action requise

Manual Step: Start the target deployment manager

Pourquoi et quand exécuter cette tâche

Puisqu'il s'agit d'une étape manuelle, toute erreur se produit en dehors du contexte de l'assistant.
Tableau 2. Actions appropriées pour l'étape : démarrer le gestionnaire de déploiement.

Si vous devez exécuter à nouveau une configuration, vous pouvez vous aider de ce tableau pour déterminer les actions appropriées.
Actions Notes®
Réexécuter l'étape Vous pouvez réexécuter cette étape si elle n'a pas abouti.
Ignorer l'étape Si cette étape a été effectuée, vous pouvez l'ignorer lorsque vous exécutez à nouveau le processus de configuration.
Etape de nettoyage Aucune action requise

Générez les fichiers pour la migration distante

Pourquoi et quand exécuter cette tâche

Tableau 3. Actions appropriées pour l'étape : Générez les fichiers pour la migration distante

Si vous devez exécuter à nouveau une configuration, vous pouvez vous aider de ce tableau pour déterminer les actions appropriées.
Actions Notes®
Réexécuter l'étape Si cette étape n'aboutit pas, vous pouvez exécuter à nouveau cette étape après avoir résolu le problème.
Ignorer l'étape Si cette étape a été effectuée, vous pouvez l'ignorer lorsque vous exécutez à nouveau le processus de configuration.
Etape de nettoyage

Si cette étape échoue, vérifiez les paramètres et les valeurs que vous avez entrés dans l'assistant de configuration, notamment le chemin d'accès temporaire cible et le chemin d'accès du serveur d'applications.

Si le paramètre et les valeurs que vous avez saisis sont corrects, et que l'étape échoue à nouveau, utilisez l'outil wp-collector pour collecter les fichiers requis pour contacter le support technique afin d'obtenir de l'aide. Voir Collecte de données et analyse des symptômes | HCL Digital Experience pour des informations sur l'utilisation de l'outil wp-collector.

Manual Step: Copy the remote migration package to the source environment

Pourquoi et quand exécuter cette tâche

Puisqu'il s'agit d'une étape manuelle, toute erreur se produit en dehors du contexte de l'assistant.
Tableau 4. Actions appropriées pour l'étape : copier le package de migration à distance dans l'environnement source

Si vous devez exécuter à nouveau une configuration, vous pouvez vous aider de ce tableau pour déterminer les actions appropriées.
Actions Notes®
Réexécuter l'étape Non applicable
Ignorer l'étape Si cette étape a été effectuée, vous pouvez l'ignorer lorsque vous exécutez à nouveau le processus de configuration.
Etape de nettoyage Aucune action requise

Créez une sauvegarde du profil du portail source

Pourquoi et quand exécuter cette tâche

Tableau 5. Actions appropriées pour l'étape : Créez une sauvegarde du profil du portail source

Si vous devez exécuter à nouveau une configuration, vous pouvez vous aider de ce tableau pour déterminer les actions appropriées.
Actions Notes®
Réexécuter l'étape Si cette étape n'aboutit pas, vous pouvez exécuter à nouveau cette étape après avoir résolu le problème.
Ignorer l'étape Si cette étape a été effectuée, vous pouvez l'ignorer lorsque vous exécutez à nouveau le processus de configuration.
Etape de nettoyage Si cette étape échoue, supprimez le chemin d'accès du profil de sauvegarde temporaire, puis exécutez à nouveau l'étape.

For more information about troubleshooting the WASPreUpgrade command, see the WebSphere® Application Server documentation on Troubleshooting migration.

Manual Step: Créez une sauvegarde du profil du portail source distant

Pourquoi et quand exécuter cette tâche

Puisqu'il s'agit d'une étape manuelle, toute erreur se produit en dehors du contexte de l'assistant.
Tableau 6. Actions appropriées pour l'étape : Créez une sauvegarde du profil du portail source distant

Si vous devez exécuter à nouveau une configuration, vous pouvez vous aider de ce tableau pour déterminer les actions appropriées.
Actions Notes®
Réexécuter l'étape Si cette étape n'aboutit pas, vous pouvez exécuter à nouveau cette étape après avoir résolu le problème.
Ignorer l'étape Si cette étape a été effectuée, vous pouvez l'ignorer lorsque vous exécutez à nouveau le processus de configuration.
Etape de nettoyage Si cette étape échoue, supprimez le chemin d'accès du profil de sauvegarde temporaire, puis exécutez à nouveau l'étape.

For more information about troubleshooting the WASPreUpgrade command, see the WebSphere® Application Server documentation on Troubleshooting migration.

Manual Step: Update the deployment manager settings

Pourquoi et quand exécuter cette tâche

Puisqu'il s'agit d'une étape manuelle, toute erreur se produit en dehors du contexte de l'assistant.
Tableau 7. Actions appropriées pour l'étape : mettre à jour les paramètres du gestionnaire de déploiement

Si vous devez exécuter à nouveau une configuration, vous pouvez vous aider de ce tableau pour déterminer les actions appropriées.
Actions Notes®
Réexécuter l'étape Non applicable
Ignorer l'étape Si cette étape a été effectuée, vous pouvez l'ignorer lorsque vous exécutez à nouveau le processus de configuration.
Etape de nettoyage Aucune action requise

Manual Step: If the backup profile is larger than 2 GB, clean up the backup profile

Pourquoi et quand exécuter cette tâche

Puisqu'il s'agit d'une étape manuelle, toute erreur se produit en dehors du contexte de l'assistant.
Tableau 8. Actions appropriées pour l'étape : si le profil de sauvegarde est supérieur à 2 Go, nettoyer le profil de sauvegarde

Si vous devez exécuter à nouveau une configuration, vous pouvez vous aider de ce tableau pour déterminer les actions appropriées.
Actions Notes®
Réexécuter l'étape Non applicable
Ignorer l'étape Si vous exécutez une nouvelle fois la configuration vous pouvez ignorer cette étape uniquement si vous avez fait l'impasse sur toutes les étapes précédentes.
Etape de nettoyage Aucune action requise

Créez un profil par défaut

Pourquoi et quand exécuter cette tâche

Tableau 9. Actions appropriées pour l'étape : Créez un profil par défaut

Si vous devez exécuter à nouveau une configuration, vous pouvez vous aider de ce tableau pour déterminer les actions appropriées.
Actions Notes®
Réexécuter l'étape Si cette étape n'aboutit pas, vous pouvez exécuter à nouveau cette étape après avoir résolu le problème.
Ignorer l'étape Si cette étape a été effectuée, vous pouvez l'ignorer lorsque vous exécutez à nouveau le processus de configuration.
Etape de nettoyage Si une erreur irrémédiable se produit et si l'étape de création de profil par défaut échoue, supprimez le profil.
  1. Utilisez la commande manageprofiles pour supprimer le profil.

    The command file is in the app_server_root/bin directory. Le fichier de commandes est un script nommé manageprofiles.sh|bat.

    Exemple :
     /opt/IBM/WebSphere/AppServer/bin/manageprofiles.sh -delete 
 -profileName profile_name
  2. Supprimez le répertoire de profil.
  3. Ensuite, exécutez à nouveau l'étape Créer un profil par défaut.

Importez le profil de sauvegarde

Pourquoi et quand exécuter cette tâche

Tableau 10. Actions appropriées pour l'étape : Importez le profil de sauvegarde

Si vous devez exécuter à nouveau une configuration, vous pouvez vous aider de ce tableau pour déterminer les actions appropriées.
Actions Notes®
Réexécuter l'étape Si cette étape n'aboutit pas, vous pouvez exécuter à nouveau cette étape après avoir résolu le problème.
Ignorer l'étape Ne sautez pas cette étape, si vous exécutez à nouveau la configuration. Si vous recréez le profil par défaut à partir de l'étape Créer un profil par défaut, vous devez exécuter à nouveau cette étape pour importer le nouveau profil par défaut.
Etape de nettoyage Si une erreur irrémédiable se produit et si l'étape de d'importation de profil de secours échoue, supprimez le profil.
  1. Utilisez la commande manageprofiles pour supprimer le profil.

    The command file is in the app_server_root/bin directory. Le fichier de commandes est un script nommé manageprofiles.sh|bat.

    Exemple :
     /opt/IBM/WebSphere/AppServer/bin/manageprofiles.sh -delete 
 -profileName profile_name
  2. Supprimez le répertoire de profil.
  3. Ensuite, exécutez à nouveau l'étape Créer un profil par défaut avant de réexécuter cette étape.

Manual Step: If you cleaned up the backup profile, restore the JCR content

Pourquoi et quand exécuter cette tâche

Puisqu'il s'agit d'une étape manuelle, toute erreur se produit en dehors du contexte de l'assistant.
Tableau 11. Actions appropriées pour l'étape : si vous avez nettoyé le profil de sauvegarde, restaurez le contenu JCR

Si vous devez exécuter à nouveau une configuration, vous pouvez vous aider de ce tableau pour déterminer les actions appropriées.
Actions Notes®
Réexécuter l'étape Non applicable
Ignorer l'étape Ne sautez pas cette étape, si vous exécutez à nouveau la configuration. Vous devez restaurer le contenu JCR, si vous avez terminé l'étape précédente manuelle pour nettoyer le profil de sauvegarde qui est supérieur à 2 Go.
Etape de nettoyage Aucune action requise