Dépannage : Création d'un profil HCL Portal

View troubleshooting information for creating a HCL profile.

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.
If you are on HCL Version 8.5 without a Combined Cumulative Fix applied, then you can use this option in the Configuration Wizard to create an additional profile.
Important : You cannot complete this configuration option, if you have CF01 or a later Combined Cumulative Fix applied.

Create the target profile for HCL in the WebSphere® Application Server

Pourquoi et quand exécuter cette tâche

If the step fails, see the logs for the manageprofiles command to determine why the step failed. L'assistant utilise les modèles de profil de portail pour créer le profil de gestionnaire de déploiement. Une erreur peut résulter d'un problème lié aux modèles de profil. Le message d'erreur du journal contient pour plus d'informations.

The log files are in the app_server_root/logs/manageprofiles directory.

Important : WebSphere® Application Server version 8.5.5.5 requiert que le correctif PI37248 soit appliqué lors de la création du profil de portail géré. Cette étape échoue si le correctif PI37248 n'est pas installé.
Tableau 1. Actions appropriées pour l'étape : Créer le profil cible pour HCL dans WebSphere® Application Server

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 é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 dmgr01

Supprimez le répertoire de profil uniquement si la commande manageprofiles aboutit.

Ensuite, exécutez à nouveau Créer le profil cible pour HCL Portal.

Install the ConfigEngine into the target HCL profile

Pourquoi et quand exécuter cette tâche

Si vous avez effectué une installation binaire, il s'agit de votre première étape.

Tableau 2. Actions appropriées pour l'étape : Installer ConfigEngine dans le profil WebSphere® Portal 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 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, recherchez les incidents dans configtrace.log.

Register the HCL components with the ConfigEngine

Pourquoi et quand exécuter cette tâche

Tableau 3. Actions appropriées pour l'étape : Enregistrez les composants avec 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 Si cette étape a abouti, vous pouvez l'ignorer lorsque vous exécutez à nouveau le processus de configuration à condition de conserver le même nom de profil.
Etape de nettoyage Si cette étape échoue, recherchez les incidents dans configtrace.log.

Consolidate the properties files for HCL components used in this configuration into a single properties file

Pourquoi et quand exécuter cette tâche

Tableau 4. Actions appropriées pour l'étape : Consolider les fichiers de propriétés pour les composants WebSphere® utilisés dans cette configuration en un fichier de propriétés unique

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, recherchez les incidents dans configtrace.log.

Préparez le profil pour la configuration de base

Pourquoi et quand exécuter cette tâche

Tableau 5. Actions appropriées pour l'étape : Préparez le profil pour la configuration de base

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, recherchez les incidents dans configtrace.log.

Validez la connexion et l'environnement de base de données

Pourquoi et quand exécuter cette tâche

Tableau 6. Actions appropriées pour l'étape : Validez la connexion et l'environnement 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 Si cette étape a été effectuée, vous pouvez l'ignorer lorsque vous exécutez à nouveau le processus de configuration.
Etape de nettoyage Contactez le service d'assistance.

Déployez des applications dans le profil du portail

Pourquoi et quand exécuter cette tâche

Tableau 7. Actions appropriées pour l'étape : Déployez des applications dans 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 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, recherchez les incidents dans configtrace.log.

Configurez les composants JCR, de thème et d'exécution principaux de votre serveur de portail

Pourquoi et quand exécuter cette tâche

Tableau 8. Actions appropriées pour l'étape : Configurer les composants JCR, de thème et d'exécution principaux de votre serveur de 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 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, recherchez les incidents dans configtrace.log.

Déployez les portlets et les pages d'administration sur le portail

Pourquoi et quand exécuter cette tâche

Tableau 9. Actions appropriées pour l'étape : Déployez les portlets et les pages d'administration sur le 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 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, recherchez les incidents dans configtrace.log.

Déployez les pages et les portlets prêts à l'emploi sur le portail

Pourquoi et quand exécuter cette tâche

Tableau 10. Actions appropriées pour l'étape : Déployez les pages et les portlets prêts à l'emploi sur le 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 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, recherchez les incidents dans configtrace.log.

Supprimez le serveur d'applications (server1) du profil

Pourquoi et quand exécuter cette tâche

Tableau 11. Actions appropriées pour l'étape : Supprimez le serveur d'applications (server1) du profil

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 vous avez déjà supprimé serveur1, il n'est pas nécessaire d'exécuter cette étape à nouveau
Etape de nettoyage Si cette étape échoue, recherchez les incidents dans configtrace.log.

Arrêtez le serveur de portail

Pourquoi et quand exécuter cette tâche

Tableau 12. Actions appropriées pour l'étape : Arrêtez le serveur de 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 Recherchez les incidents dans les journaux systemout et systemerror concernant le démarrage ou l'arrêt du serveur de portail.

Collectez les fichiers d'augmentation du gestionnaire de déploiement et les modèles de profil requis pour générer une cellule

Pourquoi et quand exécuter cette tâche

Tableau 13. Actions appropriées pour l'étape : Collectez les fichiers d'augmentation du gestionnaire de déploiement et les modèles de profil requis pour générer une cellule

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, recherchez les incidents dans configtrace.log.

Restart the HCL server

Pourquoi et quand exécuter cette tâche

Tableau 14. Actions appropriées pour l'étape : Redémarrer WebSphere® Portal Server

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 Recherchez les incidents dans les journaux systemout et systemerror concernant le démarrage ou l'arrêt du serveur de portail.