WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Systèmes d'exploitation : AIX, HP-UX, Linux, Solaris, Windows

Commande manageprofiles

L'outil de ligne de commande manageprofiles peut être utilisé pour créer tous les environnements d'exécution WebSphere ESB ; il constitue une alternative à l'assistant de création de profils. Cette commande crée des profils, c'est-à-dire les ensembles de fichiers qui définissent l'environnement d'exécution des profils de gestionnaire de déploiement, des profils personnalisés ou des profils de serveur autonome. La commande peut être utilisée pour créer, supprimer, augmenter, réduire, répertorier ou valider des profils.

L'assistant de création de profils est une application ISMP (InstallShield for Multiplatforms). La plupart des paramètres expliqués dans cette rubrique peuvent être utilisés avec l'assistant. Toutefois, certains d'entre eux requièrent la commande manageprofiles. Par exemple, vous devez utiliser la commande manageprofiles pour supprimer un profil ou annuler son augmentation car l'assistant de création de profils ne comporte pas de fonction de suppression.

A l'inverse, l'assistant de création de profils effectue des opérations que la commande manageprofiles ne prend pas en charge. Par exemple, l'assistant peut créer un service Windows pour chaque profil qu'il crée. Il peut également attribuer des ports qui n'entrent pas en conflit, en se basant sur les affectations antérieures.

Lorsque l'assistant de création de profils est utilisé (en mode interactif ou silencieux) pour effectuer une opération initiale de création ou d'augmentation, une version de ligne de commande pour cette opération est consignée dans le fichier journal. Vous pouvez extraire cette ligne de commande, la modifier et l'utiliser pour créer ou augmenter d'autres profils.

Important : Pour créer un nouveau profil WebSphere ESB ou augmenter un profil WebSphere Application Server existant, vous devez d'abord utiliser l'assistant de création de profils ou l'installation en mode silencieux, puis utiliser la commande manageprofiles pour cloner ce profil ou en créer un autre très similaire. La section Utilisation de la commande manageprofiles pour créer et augmenter des profils contient les instructions pas à pas de cette procédure.
Pour plus d'informations, consultez les rubriques suivantes :

Types de profils

Des modèles pour chaque profil sont disponibles dans le répertoire racine_installation/profileTemplates.

Dans ce répertoire se trouvent différents sous-répertoires correspondant aux différents types de profils. Ces répertoires constituent le chemin d'accès que vous indiquez dans la commande manageprofiles avec l'option -templatePath. Vous pouvez également utiliser des modèles de profils situés en dehors de la racine d'installation, le cas échéant.

La commande manageprofiles dans WebSphere ESB permet de créer les types de profils ESB suivants :
  • profil de serveur autonome avec le modèle racine_installation/profileTemplates/default.esbserver,
  • profil de gestionnaire de déploiement avec le modèle racine_installation/profileTemplates/dmgr.esbserver,
  • profil personnalisé avec le modèle racine_installation/profileTemplates/managed.esbserver.

Emplacement du fichier de commandes

Le fichier de commandes se trouve dans le répertoire racine_installation/bin. Le fichier de commandes est un script dénommé manageprofiles.sh (Linux et UNIX) ou manageprofiles.bat (Windows).

L'assistant de création de profils est l'interface graphique correspondant à l'outil de ligne de commande. Le nom du fichier de commandes qui appelle l'assistant de création de profils dépend de la plateforme que vous utilisez.

Journalisation

Chaque appel de la commande manageprofiles crée deux fichiers journaux dans le répertoire racine_installation/logs/wasprofile.
  • Le fichier wasprofile_<mode>_nom_profil.log contient les informations relatives aux actions appelées par la commande manageprofiles.
  • Le fichier manageprofile_<mode>_nom_profil.log contient une description beaucoup plus succincte des modèles appliqués aux appels, ainsi que leurs codes retour.
Par exemple, lorsque la commande manageprofiles est utilisée pour créer un profil appelé profile1, deux fichiers journaux sont créés.
  • racine_installation/logs/wasprofile/wasprofile_create_profile1.log
  • racine_installation/logs/wasprofile/manageprofile-create-profile1.log
LINUX platforms UNIX platforms

Syntaxe de la commande manageprofiles.sh

Utilisez la syntaxe et les paramètres suivants avec la commande manageprofiles pour obtenir des informations sur les profils, pour supprimer ou pour augmenter des profils. Pour créer ou augmenter un profil via manageprofiles, suivez les instructions de la section Utilisation de la commande manageprofiles pour créer et augmenter des profils.

Répertorier les profils existants :
# ./manageprofiles.sh -listProfiles 
                 
Supprimer la dernière augmentation d'un profil :
# ./manageprofiles.sh -unaugment
              -profileName nom_profil 
Supprimer des profils :
Remarque : Avant de supprimer un profil, vous devez supprimer toutes les augmentations qui lui sont associées. Exécutez la commande unaugment deux fois avant de lancer la commande delete pour les profils WebSphere ESB. Ainsi, le profil et tous les artefacts associés sont supprimés. Ensuite, supprimez manuellement le contenu du répertoire racine_profil avant d'entreprendre la nouvelle création du profil.
# ./manageprofiles.sh -unaugment
              -profileName nom_profil
# ./manageprofiles.sh -unaugment
              -profileName nom_profil
# ./manageprofiles.sh -delete
                -profileName nom_profil | -profilePath chemin_profil
                
Obtenir le nom d'un profil existant à partir de son chemin d'accès :
# ./manageprofiles.sh -getName
                 -profilePath chemin_profil
                
Obtenir le chemin d'accès d'un profil existant à partir de son nom :
# ./manageprofiles.sh -getPath
                 -profileName nom_profil
                
Vérifier l'intégrité du registre des profils :
# ./manageprofiles.sh -validateRegistry
                
Vérifier l'intégrité du registre des profils et supprimer les profils introuvables :
# ./manageprofiles.sh -validateAndUpdateRegistry
                 [-backup nom_fichier]
                
Obtenir de l'aide sur la commande :
# ./manageprofiles.sh -help

# ./manageprofiles.sh -nom_option -help
For Windows platforms

Syntaxe de la commande manageprofiles.bat

Répertorier les profils existants :
manageprofiles -listProfiles
             
Supprimer la dernière augmentation d'un profil :
manageprofiles -unaugment
               -profileName nom_profil 
Supprimer des profils :
Remarque : Avant de supprimer un profil, vous devez supprimer toutes les augmentations qui lui sont associées. Exécutez la commande unaugment deux fois avant de lancer la commande delete. Ainsi, le profil et tous les artefacts associés sont supprimés. Ensuite, supprimez manuellement le contenu du répertoire racine_profil avant d'entreprendre la nouvelle création du profil.
manageprofiles -unaugment
               -profileName nom_profil
manageprofiles -unaugment
               -profileName nom_profil
manageprofiles -delete
              -profileName nom_profil | -profilePath chemin_profil
            
Obtenir le nom d'un profil existant à partir de son chemin d'accès :
manageprofiles -getName
               -profilePath chemin_qualifié_complet_profil
             
Obtenir le chemin d'accès d'un profil existant à partir de son nom :
manageprofiles -getPath
               -profileName nom_profil
             
Vérifier l'intégrité du registre des profils :
manageprofiles -validateRegistry
             
Vérifier l'intégrité du registre des profils et supprimer les profils introuvables :
manageprofiles -validateAndUpdateRegistry
             [-backup nom_fichier]
             
Obtenir de l'aide sur la commande :
manageprofiles -help

manageprofiles -nom_option -help

Paramètres

La commande manageprofiles de WebSphere ESB utilise les mêmes paramètres que la commande manageprofiles de WebSphere Process Server.

Voir Paramètres de la commande manageprofiles pour la liste et la description des paramètres utilisables avec la commande manageprofiles pour WebSphere ESB.

Résultat de la commande

Lorsqu'une commande de création ou d'augmentation est exécutée, l'un des résultats suivants s'affiche sur la ligne de commande (la formulation peut varier en fonction du mode de gestion de profils appelé) :
  • INSTCONFSUCCESS: La création de profils a abouti.
  • INSTCONFFAILED: La création de profils a échoué.
  • INSTCONFPARTIALSUCCESS: Certaines opérations de configuration post-installation mineures n'ont pas abouti.
Parfois, ce résultat apparaît plusieurs fois. Par exemple, pour un profil WebSphere ESB, la ligne INSTCONFSUCCESS apparaît trois fois sur la ligne de commande.

Exemples

UnaugmentLINUX platforms UNIX platforms
racine_installation/bin manageProfiles.sh -unaugment –profileName nom_profil
For Windows platforms
racine_installation\bin manageProfiles -unaugment –profileName nom_profil
DeleteLINUX platforms UNIX platforms
racine_installation/bin manageProfiles.sh -delete –profileName nom_profil
For Windows platforms
racine_installation\bin  manageProfiles -delete –profileName nom_profil
Référence associée
Paramètres de la commande manageprofiles

Reference topic

Conditions d'utilisation | Evaluez cette page

Timestamp iconDernière révision :
../timestamp 4 Mar 2006 http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\ref\rwesb_manageprofile.html

(C) Copyright IBM Corporation 2006. All Rights Reserved. Copyright IBM France, 2006. Tous droits réservés.
Ce centre de documentation a été réalisé grâce à la technologie Eclipse. (http://www.eclipse.org)