Dépannage : Migration d'un serveur autonome

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: 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 1. 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.

Générez les fichiers pour la migration distante

Pourquoi et quand exécuter cette tâche

Tableau 2. Actions appropriées pour l'étape : Générer les fichiers pour la migration à distance
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 3. 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 distant

Pourquoi et quand exécuter cette tâche

Tableau 4. 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.

Créez un profil de 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: 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 6. 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 7. 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. 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` Supprimez le répertoire de profil. Then, run the Create a default profile step again.

Importez le profil de sauvegarde

Pourquoi et quand exécuter cette tâche

Tableau 8. 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. 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` Supprimez le répertoire de profil. 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 9. 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

Mettez à niveau ConfigEngine

Pourquoi et quand exécuter cette tâche

Tableau 10. Actions appropriées pour l'étape : Mettez à niveau ConfigEngine
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.
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 nouveau nom d'hôte, mots de passe, numéros de port et chemin du serveur Portal. 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: Update the ports on the target 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 11. Actions appropriées pour l'étape : mettre à jour les ports à jour dans l'environnement 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	Ne sautez pas cette étape, si vous exécutez à nouveau la configuration.
Etape de nettoyage	Aucune action requise

Manual Step: Mettez à jour les paramètres de base de données

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 12. Actions appropriées pour l'étape : Mettez à jour les paramètres de base de données
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.
Etape de nettoyage	Aucune action requise

Validez les paramètres de base de données

Pourquoi et quand exécuter cette tâche

Tableau 13. Actions appropriées pour l'étape : Validez les paramètres de base de données
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.
Etape de nettoyage	Vérifiez vos fichiers de propriétés pour vous assurer que vous avez tous vos paramètres et les valeurs correctement réglés avant d'exécuter l'étape de nouveau.

Connectez-vous à de nouvelles copies de base de données

Pourquoi et quand exécuter cette tâche

Tableau 14. Actions appropriées pour l'étape : Connectez-vous à de nouvelles copies de base de données
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 échoue, exécutez-la à nouveau.
Ignorer l'étape	Ne sautez pas cette étape, si vous exécutez à nouveau la configuration.
Etape de nettoyage	Néant.

Manual Step: Review database schema changes

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 15. Actions appropriées pour l'étape : réviser les modifications de schéma de base de données
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 échoue, exécutez-la à nouveau.
Ignorer l'étape	Cette étape est facultative. Vous pouvez sauter cette étape si vous ne voulez pas passer en revue les modifications du schéma de base de données.
Etape de nettoyage	Aucune action requise

Mettez à niveau le composant de base de données du portail

Pourquoi et quand exécuter cette tâche

Tableau 16. Actions appropriées pour l'étape : Mettez à niveau le composant de base de données du portail
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.
Etape de nettoyage	Si cette étape échoue, supprimez la base de données, créez une copie, puis exécutez l'étape à nouveau.

Manual Step: Remove check pending statuses from table spaces

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 17. Actions appropriées pour l'étape : supprimer les états de vérification en attente des espaces table
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 échoue, effectuez un nettoyage et revenez à l'étape Mettre à niveau les composants de base de données de portail de base et puis exécutez cette étape à nouveau.
Ignorer l'étape	Ne sautez pas cette étape, si vous exécutez à nouveau la configuration.
Etape de nettoyage	Si cette étape échoue, supprimez la base de données, créez une copie, puis réexécutez l'étape Mettre à niveau le composant de base de données de portail avant d'exécuter cette étape à nouveau.

Mettez à niveau les bases de données du portail restantes

Pourquoi et quand exécuter cette tâche

Tableau 18. Actions appropriées pour l'étape : Mettez à niveau les bases de données du portail restantes
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 échoue, effectuez un nettoyage et revenez à l'étape Mettre à niveau les composants de base de données de portail de base.
Ignorer l'étape	Ne sautez pas cette étape, si vous exécutez à nouveau la configuration. Vous devez effectuer les étapes Mettre à niveau les composants de base de données de portail de base et Supprimer les états de vérification en attente des espaces table avant d'exécuter cette étape à nouveau.
Etape de nettoyage	Si cette étape échoue, supprimez la base de données, créez une copie, puis réexécutez les étapes Mettre à niveau le composant de base de données de portail et Supprimer les états de vérification en attente des espaces table avant d'exécuter cette étape à nouveau.

Mettez à niveau le profil du portail

Pourquoi et quand exécuter cette tâche

Tableau 19. Actions appropriées pour l'étape : Mettez à niveau le profil du portail
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 échoue, vous devez contacter le support. Remarque : Contactez le support avant de démarrer le serveur de portail.
Ignorer l'étape	Ne sautez pas cette étape, si vous exécutez à nouveau la configuration.
Etape de nettoyage	Contactez le service d'assistance.

Lorsque vous exécutez cette étape, la sous-tâche action-deploy-portlets-applyMIGStatic-wp.oob.full s'exécute et se termine correctement. Toutefois, les messages d'erreur suivants apparaissent. mais vous pouvez les ignorer :

EJPXA0161W : le module Web ContactList n'est peut-être pas activé. Please see previous messages for reasons and possible corrective actions.
EJPPH0048W : le mode synchronisation de tous les noeuds dans le cluster de portails n'est pas homogène. L'application de portlet PA_ContactList ne sera pas lancée dans le serveur d'applications. Manual synchronization is assumed for all nodes. Manually start the application after all nodes were synchronized.
EJPXA0067E : Les données de configuration suivantes sont nécessaires pour créer une ressource de noeud de contenu : content-parentref. content-parentref.