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

Utilisation de la commande manageprofiles pour créer et augmenter des profils

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.

Afin de pouvoir utiliser la commande manageprofiles avec WebSphere ESB, vous devez déjà avoir utilisé l'assistant de création de profils (en mode interactif ou silencieux, via les fichiers de réponses) pour créer un nouveau profil ou augmenter un profil existant. (N'utilisez pas manageprofiles pour procéder à une opération initiale de création ou d'augmentation.)
La ligne de commande résultant de l'exécution de l'assistant ou de l'installation en mode silencieux sera capturée dans un fichier journal. Vous utiliserez le contenu du fichier journal pour créer une ligne de commande similaire, que vous utiliserez alors pour créer ou augmenter des profils via la commande manageprofiles.

Une ligne de commande capturée qui a été utilisée pour créer un profil contiendra le paramètre -create (généralement sous la forme manageprofiles -create). Une ligne de commande capturée qui a été utilisée pour augmenter un profil contiendra le paramètre -augment (généralement sous la forme manageprofiles -augment). N'intervertissez pas ces paramètres dans la ligne de commande. Par exemple, n'entrez pas -create à la place de -augment. Les scripts qui en résulteraient ne seraient pas corrects car d'autres paramètres et d'autres arguments seraient incorrects.

Remarque : WebSphere ESB ne prend pas en charge l'augmentation d'un profil fédéré dans un gestionnaire de déploiement. Vous devez d'abord annuler la fédération de ce type de profil, puis l'augmenter, et exécuter l'outil de ligne de commande addNode pour le refédérer.
  1. Après avoir créé ou augmenté un profil via l'assistant de création de profils ou une installation en mode silencieux, ouvrez le fichier journal qui a été généré. Le chemin d'accès et le nom de ce fichier sont de la forme : racine_profil/logs/pcatLogNNNNNNNNNNNNN.txt, (racine_profil est le répertoire dans lequel le profil a été créé et NNNNNNNNNNNNN correspond à la valeur d'horodatage).
  2. Dans le fichier journal, recherchez la ligne qui commence par "CAPTURED COMMAND LINE" et enregistrez-la (elle peut en fait tenir sur plusieurs lignes) dans un nouveau fichier.
    1. Sélectionnez le texte commençant par "CAPTURED COMMAND LINE" et ce, jusqu'à la fin du fichier.
    2. Copiez ce texte dans un nouveau fichier.
    3. Dans le nouveau fichier, supprimez les mots "CAPTURED COMMAND LINE", ainsi que tous ceux qui le précèdent.
    4. Sauvegardez le fichier. (Vous pouvez lui attribuer le nom de votre choix, pourvu qu'il soit unique.) Dans ce nouveau fichier, vous disposez désormais de la ligne de commande équivalente à l'exécution de l'assistant de création de profils.
  3. Modifiez la ligne de commande. A l'aide d'un éditeur de texte, vous pouvez modifier la commande enregistrée en fonction de la création ou de l'augmentation de profils que vous souhaitez réaliser. La modification des valeurs suivantes est soit facultative, soit obligatoire.
    Remarque : Ne modifiez pas d'autres valeurs et n'ajoutez pas d'autres paramètres qui ne figurent pas déjà dans la ligne de commande ou qui ne sont pas spécifiés dans la rubrique Paramètres de la commande manageprofiles.
    .
    Si vous souhaitez... Alors...
    Créer ou augmenter un profil Vous devez remplacer toutes les occurrences de la chaîne "MASKED_PARAMETER_VALUE" par des mots de passe valides. La chaîne "MASKED_PARAMETER_VALUE" est insérée au lieu du mot de passe défini pour des raisons de sécurité. Vous devez remplacer ces chaînes. Pour plus d'informations, voir Paramètres de la commande manageprofiles.
    Augmenter un profil existant Veillez à ce que les valeurs des paramètres -profileName, -profilePath, -cellName et -nodeName correspondent exactement à ceux du profil que vous souhaitez augmenter. Vous devrez peut-être modifier les valeurs en fonction de l'origine de la ligne de commande et du profil que vous souhaitez modifier.
    Augmenter un profil existant Veillez à ce que le modèle de profil (autonome, personnalisé ou de gestionnaire de déploiement) correspond à celui du profil à augmenter. Si tel n'était pas le cas, cela produirait un résultat incorrect.
    Créer un nouveau profil Modifiez les valeurs des paramètres -profileName, -profilePath, -cellName et -nodeName pour qu'elles soient uniques.
    Créer un nouveau profil Redéfinissez les ports que vous avez spécifiés dans l'assistant de création de profils. La ligne de commande n'inclut pas les ports que vous avez définis la première fois que vous avez utilisé l'assistant. Ajoutez le paramètre -portsFile ou -startPort à la fin de la ligne de commande, associé à une valeur de port correcte. Pour plus d'informations sur la spécification de ces ports, consultez la page de la commande wasprofile dans le centre de documentation WebSphere Application Server.
    Utiliser cette ligne de commande pour une autre installation de WebSphere ESB (qu'elle soit sur le même poste que le profil d'origine ou non) Si nécessaire, modifiez les chemins d'accès pour qu'ils correspondent à l'emplacement de l'autre installation WebSphere ESB et modifiez le chemin qualifié de cette ligne de commande.
  4. Utilisez la ligne de commande modifiée pour créer un nouveau profil ou augmenter un profil existant.
    1. Rendez le fichier exécutable.
      • UNIX platforms LINUX platforms Sous UNIX et Linux, attribuez au fichier l'extension .sh et les permissions d'exécution.
      • For Windows platforms Sous Windows, attribuez au fichier l'extension .bat.
    2. Exécutez le fichier depuis la ligne de commande. Le statut est affiché pendant l'exécution de la commande. Attendez la fin du processus.

Voici un exemple d'une ligne de commande capturée (non modifiée) afin de créer un nouveau profil. Dans ce cas, la commande a été utilisée pour créer un nouveau profil, comme le montre le paramètre -create :


(Nov 3, 2005 9:24:08 AM), Install, com.ibm.ws.install.wbiserver.ismp.actions.
CalculateManagedProfileInvocationAction, msg1, CAPTURED_COMMAND_LINE:
 /opt/o0544.1 2/bin/manageprofiles.sh -create -profileName "ESB01" -profilePath
"/opt/o054 4.12/profiles/ESB01" -templatePath "/opt/o0544.12/profileTemplates/default.  wbiserver"
 -federateLater "true" -hostName  "eexfvt99.rchland.ibm.com" -nodeName "eexfvt99Node28"
 -cellName  "eexfvt99Node26Cell" -dmgrHost  "localhost" -dmgrP ort  "8879" -OS_NAME  "Linux"
-winserviceCheck  "true" -winserviceAccountType  " localsystem" -winserviceUserName  "root"
 -winservicePassword  "MASKED_PARAMETER_ VALUE" -winserviceStartupType  "manual" -dbJDBCClasspath
 "null" -dbType  "CLOUD SCAPE" -ceiSampleJmsUser  "root" -ceiSampleJmsPwd  "MASKED_PARAMETER_VALUE"
 -cei SampleServerName  "server1" -ceiDbProduct  "CLOUDSCAPE_V51_1" -ceiDbName  ""
-ce iDbUser  "" -ceiDbPwd  "MASKED_PARAMETER_VALUE" -ceiDbSysUser  ""
 -ceiDbSysPwd "MASKED_PARAMETER_VALUE" -ceiDbJdbcDriverClasspath  ""
-ceiDbJdbcDriverType  "" -ceiDbServerName  "" -ceiDbServerPort  ""
 -ceiDbNodeName  "" -ceiDbExecuteScript s  "" -configureScaSecurity  "true" -scaSecurityUserId
 "root" -scaSecurityPassword  "MASKED_PARAMETER_VALUE" 

Voici un exemple de ligne de commande dans laquelle les informations d'en-tête ont été supprimées et les mots de passe masqués remplacés.
/opt/o0544.1 2/bin/manageprofiles.sh -create -profileName "myProfile"
 -profilePath "/opt/o054 4.12/profiles/myProfile"
-templatePath "/opt/o0544.12/profileTemplates/default.  wbiserver"
-federateLater "true" -hostName  "eexfvt99.rchland.ibm.com"
 -nodeName "myNodeName" -cellName  "myCellName" -dmgrHost  "localhost"
-dmgrPort  "8879" -OS_NAME  "Linux" -winserviceCheck  "true" -winserviceAccountType
 " localsystem" -winserviceUserName  "root" -winservicePassword  "rootPassword"
-winserviceStartupType  "manual" -dbJDBCClasspath  "null" -dbType  "CLOUD SCAPE"
 -ceiSampleJmsUser  "root" -ceiSampleJmsPwd  "myRootPwd"
-cei SampleServerName  "server1" -ceiDbProduct  "CLOUDSCAPE_V51_1" -ceiDbName  ""
-ce iDbUser  "" -ceiDbPwd  "myPassword" -ceiDbSysUser  "" -ceiDbSysPwd "myPassword"
 -ceiDbJdbcDriverClasspath  "" -ceiDbJdbcDriverType  "" -ceiDbServerName  ""
 -ceiDbServerPort  "" -ceiDbNodeName  "" -ceiDbExecuteScript s  "" -configureScaSecurity
  "true" -scaSecurityUserId  "root" -scaSecurityPassword  "myRootPwd" 

UNIX platforms LINUX platforms Voici un exemple de script exécuté sous Unix. Ici, "myCommandline.sh" est le nom du script créé :
/opt/IBM/WebSphere/ESB/bin>myCommandline.sh
INSTCONFSUCCESS: Le profil existe.
INSTCONFSUCCESS: L'augmentation du profil a abouti.
INSTCONFSUCCESS: L'augmentation du profil a abouti.

/opt/IBM/WebSphere/ESB/bin>

For Windows platforms Voici un exemple de script exécuté sous Windows. Ici, "myComnmandline.bat" est le nom du script créé :
C:\Program Files\IBM\WebSphere\ESB\bin>myCommandline.bat
INSTCONFSUCCESS: Le profil existe.
INSTCONFSUCCESS: L'augmentation du profil a abouti.
INSTCONFSUCCESS: L'augmentation du profil a abouti.


C:\Program Files\IBM\WebSphere\ESB\bin>


Task 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\doc\tins_manageprofiles.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)