Dépannage : migrer le profil de gestionnaire de déploiement pour un environnement de cluster

Apprenez comment migrer le profil de gestionnaire de déploiement pour un environnement de cluster dans HCL Digital Experience Portal.

Remarque : Si vous rencontrez un échec lors du processus de configuration, déterminer si vous pouvez exécuter à nouveau l'étape, sauter l'étape, ou si vous devez nettoyer l'étape. Pour certaines étapes ayant échoué, apprenez à résoudre ce problème et récupérer après un incident.

Chaque étape potentielle de la configuration est incluse. Etant donné que les étapes varient en fonction de vos sélections, elles ne sont pas numérotées. Recherchez l'étape qui a échoué pour savoir comment corriger l'erreur et effectuer la reprise. Si vous devez modifier une valeur que vous avez entrée dans l'assistant, vous devez exécuter la configuration à nouveau.

Conseil : Si vous devez refaire les étapes de l'assistant, téléchargez les sélections de l'assistant que vous avez effectuées pour gagner du temps. Annulez ensuite la configuration. Recommencez le processus et téléchargez vos sélections enregistrées. Corrigez ou entrez les valeurs des paramètres à l'origine de l'échec.

Manual Step: Disable automatic synchronization on all nodes in the cluster

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 : désactiver la synchronisation automatique sur tous les noeuds du cluster.

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: Install the latest fix packs

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 : installer les groupes de correctifs les plus récents.

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 vous rencontrez un problème lors de l'installation du correctif, reportez-vous à la documentation sur le correctif.

Manual Step: Install the Portal and WebSphere® binary files

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 3. Actions appropriées pour l'étape : Installer les fichiers binaires Portal et WebSphere®

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 abouti, n'exécutez pas cette étape.
Etape de nettoyage Effectuez une désinstallation du produit et supprimez la structure de fichier de fichiers restante. Ensuite, démarrez la configuration depuis le début.

Manual Step: Copy required portal binary files to 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 4. Actions appropriées pour l'étape : copier les fichiers binaires du portail requis vers le gestionnaire de déploiement cible

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: Generate files for remote migration on the 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 5. Actions appropriées pour l'étape : générer les fichiers pour la migration distante sur 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 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.

Cette étape est facultative. Vous n'avez pas besoin de suivre cette étape, si le gestionnaire de déploiement se trouve dans le même fichier binaire que le noeud principal.

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

Manual Step: Create a backup of the source 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 7. Actions appropriées pour l'étape : créer une copie de sauvegarde du gestionnaire de déploiement 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.

Pour plus d'informations sur la résolution des problèmes de la commande WASPreUpgrade, voir la documentation de WebSphere® Application Server sur la Résolution des problèmes de migration.

IBMi only : Si cette étape échoue, supprimez le paramètre oldprofile et exécutez l'étape.

Manual Step: Create a default deployment manager 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 : créer un profil de gestionnaire de déploiement 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 de gestionnaire de déploiement par défaut.

Manual Step: Importez le profil de sauvegarde

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 9. 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 de gestionnaire de déploiement 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 de gestionnaire de déploiement par défaut avant de réexécuter cette étape.

Apply the latest Combined Cumulative Fix updates to your system.

Pourquoi et quand exécuter cette tâche

Tableau 10. Actions appropriées pour l'étape : Apply the latest Combined Cumulative Fix updates to your system.

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, contactez le support et signalez-lui le message d'erreur afin d'obtenir de l'aide concernant la résolution de ce problème et pouvoir relancer l'étape.