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


Paramètres manageprofiles

Utilisez les paramètres suivants avec la commande manageprofiles de WebSphere ESB.

Le fichier de commandes manageprofiles se trouve dans le répertoire racine_installation/bin. Le fichier de commandes est un script appelé manageprofiles sous i5/OS, manageprofiles.sh sous Linux® et UNIX®, ou manageprofiles.bat sous Windows®.

Avant d'utiliser la commande manageprofiles, veillez à bien analyser les conditions préalables à la création et à l'augmentation de profils. Pour plus d'informations sur les conditions préalables, voir Conditions préalables à la création et à l'augmentation de profils. Pour plus d'informations sur la création et l'augmentation de profils, voir Création de profils à l'aide de la commande manageprofiles et Augmentation de profils à l'aide de la commande manageprofiles.

Avertissement : Lorsque vous créez un profil WebSphere ESB, vous devez utiliser exclusivement les paramètres indiqués par le centre de documentation de WebSphere ESB.
Remarque : Tous les paramètres sont dépendants maj/min.

Les options suivantes sont disponibles pour la commande manageprofiles :

-adminUserName adminUser_ID
ID utilisateur utilisé pour la sécurité administrative. Ce paramètre est obligatoire si vous souhaitez augmenter un profil existant pour lequel la sécurité administrative a été activée.
-adminPassword adminPassword
Mot de passe associé à l'ID utilisateur de sécurité administrative qui a été indiqué avec le paramètre -adminUserName. Ce paramètre est obligatoire si vous souhaitez augmenter un profil existant pour lequel la sécurité administrative a été activée.
-augment
Utilisez le paramètre -augment pour apporter des modifications à un profil existant à l'aide d'un modèle d'augmentation. Le paramètre -augment permet à la commande manageprofiles de mettre à jour ou d'augmenter le profil identifié dans le paramètre -profileName à l'aide du modèle inclus dans le paramètre -templatePath. Les modèles d'augmentation que vous pouvez utiliser sont fonction des produits et versions IBM® installés au sein de votre environnement.
Remarque : Ne modifiez pas manuellement les fichiers situés dans le répertoire rép_installationprofileTemplates. Par exemple, si vous modifiez les ports pendant la création de profil, utilisez l'outil de gestion de profil, ou encore les arguments -startingPort ou -portsFile dans la commande manageprofiles au lieu de modifier le fichier dans le répertoire des modèles de profil.
Spécifiez le chemin d'accès qualifié complet pour le paramètre -templatePath. Exemple :
manageprofiles(.bat)(.sh) -augment -profileName nom_profil -templatePath chemin_qualifié_complet
-backupProfile
Effectue la sauvegarde d'un dossier de profils et des métadonnées de profil sur un système de fichiers, à partir du fichier de registre correspondant.

Ce paramètre n'est pas pris en charge avec WebSphere ESB.

-backupFile nom_fichier_sauvegarde
Sauvegarde le fichier de registre du profil dans le fichier spécifié. Vous devez indiquer un chemin qualifié complet dans nom_fichier_sauvegarde.
-cbeServerName
Nom du serveur sur lequel le composant WebSphere ESB Common Base Event Browser est configuré en vue de son exécution.
-ceiBufferPool4k
Indique le nom du pool de mémoire tampon 4K pour l'infrastructure CEI. Ce pool de mémoire tampon doit être actif pour que les scripts DDL de la base de données puissent être exécutés.
Remarque : Obsolète dans la version 6.2 pour toutes les bases de données à l'exception de DB2 for z/OS.
-ceiBufferPool8k
Indique le nom du pool de mémoire tampon 8K pour l'infrastructure CEI. Ce pool de mémoire tampon doit être actif pour que les scripts DDL de la base de données puissent être exécutés.
Remarque : Obsolète dans la version 6.2 pour toutes les bases de données à l'exception de DB2 for z/OS.
-ceiBufferPool16k
Indique le nom du pool de mémoire tampon 16K pour l'infrastructure CEI. Ce pool de mémoire tampon doit être actif pour que les scripts DDL de la base de données puissent être exécutés.
Remarque : Obsolète dans la version 6.2 pour toutes les bases de données à l'exception de DB2 for z/OS.
-ceiDbInstallDir
Répertoire dans lequel est installée la base de données pour Common Event Infrastructure. Ce paramètre n'est obligatoire que si vous avez spécifié la valeur true pour le paramètre dbDelayConfig.
-ceiDbName
Nom de la base de données d'événements CEI à créer. Pour les bases de données DB2, Derby, Informix et Microsoft® SQL Server, la valeur par défaut est event si aucune valeur n'est spécifiée. Pour les bases de données DB2 iSeries (i5/OS) natif, la valeur par défaut est *LOCAL si aucune valeur n'est définie. Pour les bases de données DB2 iSeries (i5/OS) de la boîte à outils, la valeur par défaut est *SYSBAS si aucune valeur n'est définie.

Pour Oracle, le SID (Oracle System Identifier) doit avoir été créé et doit être disponible pour que la commande du service d'événements CEI puisse créer les tables et les remplir à l'aide des données correspondantes. La valeur par défaut est orcl s'il n'est pas défini.

-ceiDbNodeName
Nom de noeud DB2 (il doit être composé de 8 caractères au maximum). Ce noeud doit être catalogué et configuré afin de pouvoir communiquer avec le serveur DB2. Ce paramètre doit être défini si le poste de travail actuel est configuré en tant que client DB2 et que le paramètre dbDelayConfig est défini sur true.
Remarque : Obsolète dans 6.2 pour toutes les bases de données, sauf pour le client DB2.
-ceiDbUser
Remarque : Obsolète dans la version 6.2 pour toutes les bases de données, sauf Microsoft SQL Server.
Spécifie l'ID utilisateur SYSUSER utilisé pour la base de données d'événements Common Event Infrastructure.
Pour les bases de données DB2, la valeur par défaut est db2inst1 si aucune autre valeur n'est spécifiée. Pour les bases de données DB2 for z/OS, ID utilisateur qui a des privilèges de création et de suppression de bases de données. Ce paramètre est obligatoire.
For i5/OS operating system Pour les bases de données iSeries (i5/OS), ID utilisateur qui a des privilèges de création et de suppression de bases de données. Ce paramètre est obligatoire.
Pour les bases de données Derby, ID utilisateur utilisé par la source de données pour l'authentification de la base de données Derby. Ce paramètre est facultatif lorsque la sécurité de domaine WebSphere est désactivée ; il est obligatoire lorsque la sécurité de domaine WebSphere est activée.
Pour les bases de données Informix, spécifie l'ID utilisateur du schéma de base de données Informix possédant les tables de base de données du service d'événements. La source de données WebSphere utilise cet ID utilisateur pour authentifier la connexion à la base de données Informix. Ce paramètre est obligatoire.
Pour les bases de données Oracle, spécifie l'ID utilisateur du schéma Oracle qui possédera les tables Oracle de services d'événements. L'ID utilisateur sera créé durant la création de la base de données ; la source de données WebSphere utilise cet ID utilisateur pour authentifier la connexion à la base de données Oracle. La valeur par défaut est ceiuser s'il n'est pas spécifié.
Pour les bases de données Microsoft SQL Server, spécifie l'ID utilisateur SQL Server qui possédera les tables du service d'événement. La valeur par défaut est ceiuser s'il n'est pas spécifié.
-dbCeiUserId
Par les bases de données Oracle, ce paramètre spécifie l'ID utilisateur de l'infrastructure CEI.
-dbUserId
Spécifie l'ID utilisateur SYSUSER utilisé pour la base de données d'événements Common Event Infrastructure.
Pour les bases de données DB2, la valeur par défaut est db2inst1 si aucune autre valeur n'est spécifiée. Pour les bases de données DB2 for z/OS, ID utilisateur qui a des privilèges de création et de suppression de bases de données. Ce paramètre est obligatoire.
For i5/OS operating system Pour les bases de données iSeries (i5/OS), ID utilisateur qui a des privilèges de création et de suppression de bases de données. Ce paramètre est obligatoire.
Pour les bases de données Derby, ID utilisateur utilisé par la source de données pour l'authentification de la base de données Derby. Ce paramètre est facultatif lorsque la sécurité de domaine WebSphere est désactivée ; il est obligatoire lorsque la sécurité de domaine WebSphere est activée.
Pour les bases de données Informix, spécifie l'ID utilisateur du schéma de base de données Informix possédant les tables de base de données du service d'événements. La source de données WebSphere utilise cet ID utilisateur pour authentifier la connexion à la base de données Informix. Ce paramètre est obligatoire.
Pour les bases de données Oracle, spécifie l'ID utilisateur du schéma Oracle qui possédera les tables Oracle de services d'événements. L'ID utilisateur sera créé durant la création de la base de données ; la source de données WebSphere utilise cet ID utilisateur pour authentifier la connexion à la base de données Oracle. La valeur par défaut est ceiuser s'il n'est pas spécifié.
Pour les bases de données Microsoft SQL Server, spécifie l'ID utilisateur SQL Server qui possédera les tables du service d'événement. La valeur par défaut est ceiuser s'il n'est pas spécifié.
-ceiDiskSizeInMB
Taille de la base de données (exprimée en Mo) à créer pour la base de données d'événements CEI. La valeur minimale qui peut être définie est 10 Mo. Pour DB2 for z/OS, la valeur par défaut est 100 Mo si aucune valeur n'est définie.
Remarque : Obsolète dans la version 6.2 pour toutes les bases de données à l'exception de DB2 for z/OS.
-ceiInstancePrefix
Pour les bases de données Informix, Oracle et Microsoft SQL Server, la commande utilise le nom d'instance de la base de données d'événements CEI pour regrouper les fichiers de la base de données au sein d'un répertoire avec des noms uniques. La valeur par défaut est ceiinst1 s'il n'est pas défini.
Remarque : Obsolète dans la version 6.2 pour toutes les bases de données, sauf Informix, Oracle et Microsoft SQL Server.
-dbLocation
Répertoire de ORACLE_HOME. Ce paramètre est obligatoire quand le paramètre dbDelayConfig est défini sur true.
-ceiOverrideDataSource
Lorsque ce paramètre a la valeur true, la commande supprime une source de données de service CEI existante avant d'en créer une nouvelle. Lorsque ce paramètre a la valeur false, la commande ne crée pas de source de données de service d'événement si une autre source est détectée au même emplacement. La valeur par défaut est false, si aucune valeur n'est spécifiée.
-ceiSaUser
ID Microsoft SQL Server disposant des privilèges nécessaires pour créer des tables, des unités et des mémoires cache pour Common Event Infrastructure. Ce paramètre est obligatoire lorsque le paramètre dbDelayConfig a la valeur true.
Remarque : Obsolète dans la version 6.2 pour toutes les bases de données, sauf Microsoft SQL Server.
-ceiSaPassword
Mot de passe Microsoft SQL Server disposant des privilèges nécessaires pour créer des tables, des unités et des mémoires cache pour Common Event Infrastructure. Ce paramètre est obligatoire si vous spécifiez une valeur pour le paramètre ceiSaUser, sauf si l'ID utilisateur sa ne possède pas de mot de passe associé.
Remarque : Obsolète dans la version 6.2 pour toutes les bases de données, sauf Microsoft SQL Server.
-cellName nom_cellule
Indique le nom de cellule du profil pour l'infrastructure CEI. Utilisez un nom de cellule unique pour chaque profil. Ce paramètre est utilisé pour la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
La valeur par défaut de ce paramètre est basée sur une combinaison du nom d'hôte abrégé, de la constante Cell et d'un numéro de fin, par exemple :
if (DMgr)
	nom_hôte_abrégéCellnuméro_cellule
else
	nom_hôte_abrégéNodenuméro_noeudCell
numéro_cellule représente un numéro séquentiel commençant à 01 et où numéro_noeud représente le numéro de noeud utilisé pour définir le nom de noeud.

La valeur de ce paramètre ne doit pas contenir d'espaces, ni de caractères non valides, tels que les caractères suivants : *, ?, ", <, >, ,, /, \ et |.

-configureBSpace true | false
Configuration de Business Space powered by WebSphere, qui fournit un environnement d'utilisation intégré dans toute la gamme IBM Websphere Business Process Management. La valeur par défaut est true. Business Space est pris en charge avec les produits de base de données suivants : Derby Embedded, Derby Network Server, DB2 Universal, DB2 Universal Runtime Client, DB2 for i5/OS, DB2 for z/OS, Oracle 9i, Oracle 10g et Oracle 11g.
Important : Si la base de données commune que vous utilisez pour WebSphere ESB n'est prise en charge par Business Space, la commande manageprofiles une base de données Derby Embedded pour configurer Business Space. Vous ne pourrez pas fédérer ce profil dans un environnement de déploiement, car Derby Embedded n'est pas pris en charge pour les environnements de déploiement.
Pour plus d'informations sur la configuration de Business Space pour les environnements de déploiement, voir Configuration de Business Space dans Rubriques connexes.
-create
Crée le profil.
Spécifiez manageprofiles -create -templatePath chemin_qualifié_complet_modèle -help pour obtenir des informations spécifiques sur la création d'un profil. Les modèles disponibles sont les suivants :
  • default.esbserver : pour un profil de serveur autonome WebSphere Enterprise Service Bus, qui définit un serveur autonome.
  • dmgr.esbserver : pour un profil de gestionnaire de déploiement WebSphere Enterprise Service Bus, qui définit un gestionnaire de déploiement.
  • managed.esbserver : pour un profil personnalisé WebSphere Enterprise Service Bus, qui définit un noeud géré, s'il est fédéré sur un gestionnaire de déploiement.
-dbCommonForME
Indique si la base de données commune doit être utilisée pour les moteurs de messagerie. Pour les bases de données DB2 for z/OS, la valeur par défaut est true. Pour toutes les autres bases de données, la valeur par défaut est false. Si ce paramètre est défini sur false, les moteurs de messagerie utiliseront un magasin de fichiers/magasin de données.
-dbConnectionLocation
Emplacement de la base de données DB2 for z/OS.
-dbCreateNew
Indique si vous devez créer ou réutiliser une base de données. Les valeurs valides sont true ou false.
-dbDelayConfig
Indique si la création de tables doit être effectuée une fois le profil créé. Les valeurs valides sont true ou false. Par défaut, ce paramètre a la valeur false.
-dbDriverType
Type de pilote de base de données. Pour les bases de données Oracle, les valeurs admises sont ORACLE_THIN ou ORACLE_OCI. Pour les bases de données DB2, les valeurs valides sont 2 ou 4.
-dbHostName
Nom d'hôte ou adresse IP du serveur de base de données. La valeur par défaut est localhost.
-dbInstance
Nom d'instance de base de données pour bases de données Informix.
-dbJDBCClasspath
Emplacement des fichiers du pilote JDBC.
-dbLocation
Indique le répertoire d'installation de la base de données si vous utilisez des bases de données Informix. Vous ne pouvez utiliser ce paramètre que si le paramètre dbCreateNew porte la valeur true.
-dbName
Nom de la base de données. Par défaut, la valeur est WPRCSDB.
-dbOutputScriptDir
Emplacement des scripts de la base de données exportée.
-dbPassword
Mot de passe obligatoire pour l'authentification à la base de données. Ce paramètre est obligatoire pour toutes les bases de données, à l'exception de la base Derby Embedded.
-dbSchemaName
Nom du schéma de base de données pour les bases de données DB2 for iSeries, DB2 for i5/OS et DB2 for z/OS.
Remarque : Ce paramètre n'est pas utilisable avec la base de données DB2 Universal.
-dbServerPort
Numéro de port du serveur de base de données. En fonction de la base de données utilisée, vous pouvez spécifier un autre numéro de port que le numéro par défaut.
-dbStorageGroup
Nom du groupe de stockage pour bases de données DB2 z/OS.
-dbType
Type de la base de données.

Affectez l'une des valeurs suivantes au type de base de données que vous utilisez avec WebSphere ESB.

  • DERBY_EMBEDDED pour les bases de données Derby Embedded
  • DERBY_NETWORKSERVER pour les bases de données Derby Network Server
  • DB2_UNIVERSAL pour les bases de données DB2 Universal
  • DB2UDBOS390_V8_1 pour une base de données DB2 for z/OS v8
  • DB2UDBOS390_V9_1 pour une base de données DB2 for z/OS v9
  • DB2UDBISERIES_NATIVE pour une base de données DB2 UDB for iSeries ou DB2 for i5/OS avec un pilote natif
  • DB2UDBISERIES_TOOLBOX pour une base de données DB2 UDB for iSeries ou DB2 for i5/OS avec un pilote Toolbox
  • INFORMIX pour les bases de données Informix Dynamic Server
  • MSSQLSERVER_EMBEDDED pour les bases de données Microsoft SQL Server utilisant un pilote intégré
  • MSSQLSERVER_DATADIRECT pour les bases de données Microsoft SQL Server utilisant un pilote DataDirect
  • MSSQLSERVER_MICROSOFT pour les bases de données Microsoft SQL Server utilisant un pilote Microsoft
    Remarque : Le support du pilote JDBC version 1.2 de Microsoft SQL Server a été ajouté dans WebSphere Process Server version 6.2.0.1.
  • ORACLE9I pour les bases de données Oracle 9i
  • ORACLE10G pour une base de données Oracle 10g ou Oracle 11g
-debug
Active la fonction de débogage de l'utilitaire Apache Ant qu'utilise la commande manageprofiles.
-defaultPorts
Affecte les valeurs de port par défaut ou de base au profil.

N'utilisez pas ce paramètre avec le paramètre -startingPort ou avec le paramètre -portsFile.

Pendant la création de profil, la commande manageprofiles utilise un ensemble de ports recommandés créés automatiquement, si vous ne spécifiez pas le paramètre -startingPort, le paramètre-defaultPorts ou le paramètre -portsFile. Les valeurs des ports recommandées peuvent être différentes de celles des ports par défaut, en fonction de la disponibilité de ceux-ci.

Remarque : N'utilisez pas ce paramètre si vous utilisez le modèle de profil géré.
-delete
Supprime le profil.

La suppression d'un profil ne supprime pas le répertoire des profils. Par exemple, si vous créez un profil dans le répertoire /usr/WebSphere/ESB/profiles/managedProfile ou dans le cas d'une plateforme i5/OS, dans le répertoire QIBM/UserData/WebSphere/ESB/profiles/managedProfile, le répertoire est conservé après la suppression du profil.

Vous pouvez soit supprimer, soit conserver ce répertoire. Toutefois, le répertoire racine_profil/logs contient des informations relatives à la désinstallation du profil. Vous pouvez par exemple conserver le fichier _nodeuninst.log afin de déterminer la cause d'un incident survenu pendant la procédure de désinstallation.

Si vous supprimez un profil pour lequel des modèles d'augmentation ont été enregistrés dans le registre des profils, des actions de réduction sont automatiquement appliquées.

-deleteAll
Supprime tous les profils enregistrés.

La suppression d'un profil ne supprime pas le répertoire des profils. Supposons par exemple que vous ayez créé un profil dans le répertoire /usr/WebSphere/ESB/profiles/managedProfile ou, dans le cas des plateformes i5/OS, dans le répertoire QIBM/UserData/WebSphere/ESB/profiles/managedProfile. Ce répertoire sera conservé une fois que vous aurez supprimé le profil.

Vous pouvez soit supprimer, soit conserver ce répertoire. Toutefois, le répertoire racine_profil/logs contient des informations relatives à la désinstallation du profil. Vous pouvez par exemple conserver le fichier _nodeuninst.log afin de déterminer la cause d'un incident survenu pendant la procédure de désinstallation.

Si vous supprimez un profil pour lequel des modèles d'augmentation ont été enregistrés dans le registre des profils, des actions de réduction sont automatiquement appliquées.

-dmgrHost nom_hôte_dmgr
Identifie le poste de travail sur lequel le gestionnaire de déploiement est exécuté. Spécifiez ce paramètre et le paramètre dmgrPort pour fédérer un profil personnalisé lors de sa création ou de son augmentation. Ce paramètre est disponible avec le modèle de profil managed.esbserver.

Le nom d'hôte peut être un nom DNS long ou court ou l'adresse IP du poste de travail du gestionnaire de déploiement.

Si vous précisez ce paramètre facultatif, la commande manageprofiles tente de fédérer le noeud personnalisé dans la cellule du gestionnaire de déploiement, lors de la création du profil personnalisé. Ce paramètre est ignoré lors de la création d'un profil de gestionnaire de déploiement ou de serveur autonome.

Si vous fédérez un noeud personnalisé alors que le gestionnaire de déploiement n'est pas en cours d'exécution, l'indicateur d'installation figurant dans les journaux est INSTCONFFAILED, indiquant un échec complet. Le profil personnalisé résultant n'est pas utilisable. Vous devez déplacer le répertoire de profil personnalisé hors du référentiel de profils (le répertoire racine de l'installation de profils) avant de créer un autre profil personnalisé ayant le même nom de profil.

Si vous avez activé la sécurité ou modifié le type de connecteur JMX par défaut, vous ne pouvez pas procéder à la fédération avec la commande manageprofiles. Utilisez la commande addNode à la place.

La valeur par défaut de ce paramètre est localhost. La valeur de ce paramètre doit se composer d'un nom d'hôte au format correct et ne doit pas contenir d'espaces, ni de caractères non valides, tels que les caractères suivants : *, ?, ", <, >, ,, /, \, |, etc. Une connexion au gestionnaire de déploiement est également requise pour le paramètre dmgrPort.

-dmgrPort numéro_port_dmgr
Identifie le port SOAP du gestionnaire de déploiement. Spécifiez ce paramètre et le paramètre dmgrHost pour fédérer un profil personnalisé lors de sa création ou de son augmentation. Le gestionnaire doit être en cours d'exécution et accessible.

Si vous avez activé la sécurité ou modifié le type de connecteur JMX par défaut, vous ne pouvez pas procéder à la fédération avec la commande manageprofiles. Utilisez la commande addNode à la place.

La valeur par défaut de ce paramètre est 8879. Le port indiqué doit être un entier positif ; en outre, une connexion au gestionnaire de déploiement est également requise pour le paramètre dmgrHost.

-enableAdminSecurity true | false
Active la sécurité administrative. Les valeurs admises sont true ou false. La valeur par défaut est false. Si vous créez des profils pour un environnement de déploiement, vous devez définir ce paramètre sur la valeur true. Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
Lorsque le paramètre enableAdminSecurity a la valeur true, vous devez également utiliser les paramètres -adminUserName et -adminPassword et spécifier les valeurs correspondantes. Si les exemples ont été installés au cours de l'installation du serveur d'applications, vous devez également spécifier le paramètre -samplesPassword lorsque vous créez un profil pour lequel la sécurité administrative est activée. Si le paramètre -samplesPassword n'est pas spécifié alors que la sécurité administrative est activée, la création du profil aboutit, mais lorsque vous tentez d'exécuter les exemples, des exceptions et des échecs sont consignés dans le fichier journal de sortie du serveur.
For Linux operating system -enableService true | false
Permet de créer un service Linux. Les valeurs admises sont true ou false. La valeur par défaut de ce paramètre est false. Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.

Lorsque la commandemanageprofiles est exécutée alors que l'option -enableService a la valeur true, le service Linux est créé avec le profil lorsque la commande est exécutée par l'utilisateur root. Si un utilisateur non root exécute la commande manageprofiles, le profil est créé, mais le service Linux n'est pas créé. Le service Linux n'est pas créé, car l'utilisateur non root ne dispose pas des droits suffisants pour configurer le service. Le résultat INSTCONPARTIALSUCCESS est affiché à la fin du processus de création de profil ; le fichier journal de création de profil (racine_installation/logs/manageprofiles/nom_profil_create.log contient un message qui indique que l'utilisateur actuel ne dispose pas des droits suffisants pour la configuration du service Linux.

-federateLater true | false
Indique si le profil géré doit être fédéré au cours de la création de profil ou s'il sera fédéré ultérieurement à l'aide de la commande addNode. Si vous créez un profil WebSphere ESB, n'indiquez aucune valeur, utilisez la valeur par défaut true.
-federateLaterWESB true | false
Indique si le profil géré sera fédéré ultérieurement à l'aide du modèle géré wesbserver. Les valeurs valides sont true ou false. Si les paramètres dmgrHost, dmgrPort, dmgrAdminUserName et dmgrAdminPassword ne sont pas définis, la valeur par défaut de ce paramètre est true.
-fileStoreForME true | false
Si ce paramètre porte la valeur true, le magasin de fichiers/magasin de données sera utilisé pour les moteurs de messagerie. La valeur par défaut de ce paramètre est false.
Remarque : Les paramètres -dbCommonForME et -fileStoreForME ne peuvent pas porter la valeur true. En effet, cela entraînerait une erreur de validation.
-getDefaultName
Renvoie le nom du profil par défaut.
-getName
Permet d'obtenir le nom d'un profil enregistré pour un paramètre -profilePath spécifique.
-getPath
Permet d'obtenir l'emplacement système d'un nom de profil spécifique. Nécessite l'utilisation du paramètre –profileName.
-help
Affiche la syntaxe de commande.
-hostName nom_hôte
Spécifie le nom d'hôte sur lequel vous créez le profil. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant. Il doit correspondre au nom d'hôte indiqué lors de l'installation du produit initial. La valeur par défaut de ce paramètre est la forme longue du système de noms de domaines. Ce paramètre n'est obligatoire que pour la création de profil. La valeur de ce paramètre doit être un nom d'hôte IPv6 valide et ne doit pas contenir d'espaces, ni de caractères non valides, tels que les caractères suivants : *, ?, ", <, >, ,, /, \ et |.
-ignoreStack
Paramètre facultatif utilisé avec le paramètre -templatePath pour réduire un profil spécifique qui avait été préalablement augmenté.
Remarque : L'utilisation de profils ayant été réduits (paramètre -unaugment) n'est pas prise en charge pour WebSphere ESB.
-isDefault
Indique que profil identifié par le paramètre -profileName associé représentera le profil par défaut une fois qu'il sera enregistré. Lorsque vous exécutez des commandes relatives au profil par défaut, il est inutile d'utiliser l'attribut-profileName de la commande.
-isDeveloperServer
Indique si le serveur doit être utilisé à des fins de développement uniquement. Ce paramètre est utile lorsque vous créez des profils pour tester des applications sur un serveur autre qu'un serveur de production, avant de déployer les applications sur leurs serveurs d'applications de production respectifs. Ce paramètre est valide pour la création de profils sous WebSphere ESB uniquement.
Si -isDeveloperServer est défini lors de la création d'un profilWebSphere ESB, un référentiel VMM préconfiguré est installé.
-listProfiles
Répertorie tous les profils définis.
-ndtopology
Indique si vous avez choisi d'utiliser le chemin d'environnement de déploiement pour la création du profil. Les valeurs valides sont true ou false.
-nodeName nom_noeud
Spécifie le nom de noeud du noeud créé avec le nouveau profil. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant. Utilisez une valeur unique dans la cellule ou sur le poste de travail. Chaque profil qui partage le même ensemble de binaires de produit doivent posséder un nom de noeud unique. Ce paramètre n'est obligatoire pour la création de profil qu'avec les modèles default.wbiserver, dmgr.wbiserver et managed.wbiserver.
For Linux operating systemFor UNIX operating systemFor Windows operating system La valeur par défaut de ce paramètre prend comme base une combinaison du nom d'hôte abrégé, du type de profil et d'un numéro de fin de ligne, comme par exemple :
if (DMgr)
	nom_hôte_abrégégestionnaire_cellulesnuméro_noeud
else
	nom_hôte_abrégénoeudnuméro_noeud
numéro_noeud représente un numéro séquentiel commençant à 01.
For i5/OS operating system Les noms de noeud par défaut sont les suivants :
  • modèle dmgr : gestionnaire_noms_profils
  • modèle par défaut : nom_hôte_abrégé_nom_profil
  • modèle géré : nom_hôte_abrégé_nom_profil
  • cellule : consultez les exemples précédents de modèle dmgr et de modèle par défaut, puis appliquez les valeurs appropriées aux deux profils créés.

La valeur de ce paramètre ne doit pas contenir d'espaces, ni de caractères non valides, tels que les caractères suivants : *, ?, ", <, >, ,, /, \ et |.

-omitAction fonction1 fonction2... fonctionN
Paramètre facultatif permettant d'exclure des fonctions de profil.
Chaque modèle de profil est prédéfini et contient certaines fonctions facultatives. L'option samplesInstallAndConfig n'est disponible que lorsque des exemples d'applications ont été sélectionnés lors de l'installation du produit. Les fonctions facultatives suivantes peuvent être utilisées avec le paramètre -omitAction pour les modèles de profil suivants :
  • default - Serveur d'applications
    • deployAdminConsole
    • samplesInstallAndConfig
    • defaultAppDeployAndConfig
  • dmgr - Gestionnaire de déploiement
    • deployAdminConsole
-portsFile chemin_fichier
Paramètre facultatif qui spécifie le chemin d'accès à un fichier définissant les paramètres de port applicables au nouveau profil. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.

N'utilisez pas ce paramètre avec le paramètre -startingPort ou avec le paramètre -defaultPorts.

Pendant la création de profil, la commande manageprofiles utilise un ensemble de ports recommandés créés automatiquement, si vous ne spécifiez pas le paramètre -startingPort, le paramètre-defaultPorts ou le paramètre -portsFile. Les valeurs des ports recommandées peuvent être différentes de celles des ports par défaut, en fonction de la disponibilité de ceux-ci.

-profileName nom_profil
Spécifie le nom du profil. Utilisez une valeur unique lors de la création d'un profil.
Chaque profil qui partage le même ensemble de binaires de produit doit posséder un nom unique. Le nom de profil par défaut prend comme base une combinaison du type de profil et d'un numéro de fin de ligne, comme par exemple :
type_profil numéro_profil
type_profil représente une valeur telle que ProcSrv, Dmgr ou Custom et oùnuméro_profil représente un numéro séquentiel qui crée un nom de profil unique.

La valeur de ce paramètre ne doit pas contenir d'espaces, ni de caractères non valides, tels que les caractères suivants : *, ?, ", <, >, ,, /, \ et |. Le nom de profil choisi ne doit pas correspondre à un profil en cours d'utilisation.

-profilePath racine_profil
Indique le chemin qualifié complet d'accès au profil, appelé dans le centre de documentation racine_profil.
Exemple :
-profilePath racine_profil
Utilisez ce paramètre lors de la création de profil uniquement. Ne définissez pas ce paramètre pour l'augmentation d'un profil existant.

For Windows operating system Sur les plateformes Windows : Si le chemin qualifié complet contient des espaces, entourez la valeur de guillemets.

La valeur par défaut prend comme base le répertoire racine_installation, le sous-répertoire de profils et le nom du fichier.

Par exemple, la valeur par défaut utilisée pour la création de profil est la suivante :
REP_PROFIL_DEFAUT_WSPROFILE_WS/nom_profil
REP_PROFIL_DEFAUT_WSPROFILE_WS est défini dans le fichier wasprofile.properties, qui se trouve dans le répertoire racine_installation/properties.

La valeur de ce paramètre doit être un chemin valide d'accès au système cible et ne doit pas être en cours d'utilisation.

Vous devez disposer des droits en écriture sur ce répertoire.

-response fichier_réponses
Permet d'accéder à toutes les fonctions de l'interface de programme d'application (API) à partir de la ligne de commande, via l'exécution de la commandemanageprofiles.
L'interface de ligne de commande peut être gérée par un fichier de réponses qui regroupe les arguments d'entrée d'une commande spécifique dans le fichier de propriétés, au format de clés et de valeurs. Un exemple de fichier de réponses utilisé pour une opération de création figure ci-après :
create
profileName=testResponseFileCreate
profilePath=racine_profil
templatePath=racine_installation/profileTemplates/default
nodeName=myNodeName
cellName=myCellName
hostName=myHostName
omitAction=myOptionalAction1, myOptionalAction2
For Windows operating system Sur les plateformes Windows : L'instruction de chemin Windows peut utiliser soit les barres obliques (/), soit les barres obliques inversées (\). Si l'instruction de chemin utilise les barres obliques inversées, le fichier de réponses doit utiliser des barres obliques inversées doubles pour pouvoir comprendre correctement le chemin. Voici un exemple de fichier de réponses utilisé pour une opération de création qui utilise les barres obliques inversées doubles :
create
templatePath=C:\\WebSphere\\ESB\\profileTemplates\\default

Pour déterminer les arguments d'entrée requis pour les différents types de modèles de profil et d'actions, utilisez la commande manageprofiles avec le paramètre -help.

-restoreProfile
Restaure une sauvegarde de profil. Il doit être utilisé avec le paramètre -backupFile. Ce paramètre n'est pas pris en charge avec WebSphere ESB.
-samplesPassword mot_de_passe_exemples
Crée un mot de passe qui sera utilisé pour les exemples. Le mot de passe est utilisé pour limiter l'accès aux exemples d'applications Web installées en même temps que le serveur d'applications.
For Linux operating system -serviceUserName ID_utilisateur_service
ID utilisateur utilisé lors de la création du service Linux afin que le service Linux fonctionne avec cet ID. Le service Linux est exécuté lorsqu'une session est ouverte avec cet ID utilisateur.
-setDefaultName
Définit comme profil par défaut l'un des profils existants. Il doit être utilisé avec le paramètre -profileName, comme par exemple :
manageprofiles(.bat)(.sh) -setDefaultName -profileName nom_profil
-startingPort port_début
Indique le numéro de port de début pour la génération et l'affectation de tous les ports du profil.

Ne définissez pas ce paramètre pour l'augmentation d'un profil existant. Les valeurs de port sont affectées de façon séquentielle à partir de la valeur de -startingPort, en omettant les ports qui sont déjà en cours d'utilisation. Sur tous les systèmes à l'exception de i5/OS, le système reconnaît et résout les ports en cours d'utilisation ; il détermine également les affectations de ports qui permettent d'éviter les conflits de ports.

N'utilisez pas ce paramètre avec le paramètre -defaultPorts ou avec le paramètre -portsFile.

Pendant la création de profil, la commande manageprofiles utilise un ensemble de ports recommandés créés automatiquement, si vous ne spécifiez pas le paramètre -startingPort, le paramètre-defaultPorts ou le paramètre -portsFile. Les valeurs des ports recommandées peuvent être différentes de celles des ports par défaut, en fonction de la disponibilité de ceux-ci.

Remarque : N'utilisez pas ce paramètre si vous utilisez le modèle de profil géré.
-templatePath chemin_modèle
Indique le chemin d'accès aux fichiers modèles du répertoire racine d'installation. Le répertoire profileTemplates contient divers sous-répertoires correspondant à différents types de profils, qui varient en fonction du type de produit installé. Ces sous-répertoires sont les chemins d'accès à indiquer lors de l'utilisation de l'option -templatePath. Vous pouvez également spécifier des modèles de profils ne figurant pas dans la racine d'installation, le cas échéant.

Utilisez des chemins d'accès absolus. Ce paramètre doit exister sous forme de répertoire et doit désigner un répertoire de modèles valide.

Utilisez les modèles suivants avec WebSphere ESB :
  • default.esbserver : pour un profil de serveur autonome WebSphere Enterprise Service Bus, qui définit un serveur autonome.
  • dmgr.esbserver : pour un profil de gestionnaire de déploiement WebSphere Enterprise Service Bus, qui définit un gestionnaire de déploiement.
  • managed.esbserver : pour un profil personnalisé WebSphere Enterprise Service Bus, qui définit un noeud géré, s'il est fédéré sur un gestionnaire de déploiement.
-topologyPattern
Détermine les modèles d'environnement de déploiement à utiliser pour le gestionnaire de déploiement en cours de création. Les valeurs valides sont CondensedSync, CondensedAsync ou Reference.
-topologyRole
Indique la fonction qu'occupera le profil dans l'environnement de déploiement, lorsque vous fédérerez un profil créé. Les valeurs valides sont ADT pour les cibles de déploiement, Messaging pour les messages du site central ou Support pour les services de support. Vous pouvez indiquer une ou plusieurs valeurs séparées par un espace, par exemple ADT Messaging Support ou Messaging ou ADT Support.
-unaugment
Remarque : L'utilisation de profils ayant été réduits (paramètre -unaugment) n'est pas prise en charge pour WebSphere ESB.
-validateAndUpdateRegistry
Vérifie tous les profils répertoriés dans le registre des profils, pour s'assurer qu'ils sont présents sur le système de fichiers. Il supprime du registre tous les profils manquants. Il retourne ensuite la liste des profils manquants qui ont été supprimés du registre.
-validateRegistry
Vérifie tous les profils répertoriés dans le registre des profils, pour s'assurer qu'ils sont présents sur le système de fichiers. Il retourne ensuite la liste des profils manquants.
-validatePorts
Indique les ports à valider afin de vérifier qu'ils ne sont pas réservés ou en cours d'utilisation. Ce paramètre permet d'identifier les ports qui ne sont pas utilisés. Si un port s'avère être en cours d'utilisation, la création de profil s'arrête et un message d'erreur s'affiche. Vous pouvez à tout moment utiliser ce paramètre sur la ligne de commande. Il est recommandé d'utiliser ce paramètre avec le paramètre –portsFile.
-webServerCheck true | false
Indique si vous avez choisi de configurer les définitions de serveurs Web. Les valeurs admises sont true ou false. La valeur par défaut de ce paramètre est false. Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
-webServerHostname nom_hôte_serveur_web
Nom d'hôte du serveur. La valeur par défaut de ce paramètre est la forme longue du nom d'hôte du poste de travail local. Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
-webServerInstallPath nom_chemin_installation_serveur_web
Chemin d'installation du serveur Web (local ou distant). Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
La valeur par défaut de ce paramètre dépend du système d'exploitation du poste de travail local et de la valeur du paramètre webServerType. Exemple :
For AIX operating system
webServerType=IHS: webServerInstallPath defaulted to “/usr/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “?”
webServerType=APACHE: webServerInstallPath defaulted to “?”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”

For HP-UX operating system
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”

For Linux operating system
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”

For Solaris operating system
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”

For Windows operating system
ebServerType=IHS: webServerInstallPath defaulted to “C:\Program Files\IBM\HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “C:\”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “C:\”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
-webServerName nom_serveur_web
Nom du serveur Web. La valeur par défaut de ce paramètre est webserver1. Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
-webServerOS système_exploitation_serveur_web
Système d'exploitation sur lequel réside le serveur Web. Les valeurs valides sont les suivantes : windows, linux, solaris, aix, hpux, os390 et os400. N'utilisez pas ce paramètre avec le paramètre webServerType.
Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
-webServerPluginPath chemin_plugin_serveur_web
Chemin d'accès aux plugins utilisés par le serveur Web. La valeur par défaut de ce paramètre est racine_installation/plugins. Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
-webServerPort port_serveur_web
Indique le port à partir duquel s'effectuera l'accès au serveur Web. La valeur par défaut de ce paramètre est 80. Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
-webServerType type_serveur_web
Type de serveur Web. Les valeurs valides sont les suivantes : IHS, SUNJAVASYSTEM, IIS, DOMINO, APACHE et HTTPSERVER_ZOS. Utilisez ce paramètre avec le paramètre webServerOS. Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
For Windows operating system -winserviceAccountType specifieduser | localsystem
Type de compte de propriétaire de service Windows créé pour le profil. Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
Les valeurs valides sont specifieduser ou localsystem. La valeur localsystem exécute le service Windows sous le compte local de l'utilisateur qui crée le profil. La valeur par défaut de ce paramètre est system.
For Windows operating system -winserviceCheck true | false
La valeur peut être true ou false. Spécifiez true pour créer un service Windows pour le processus serveur créé dans le profil. Indiquez false pour ne pas créer le service Windows. La valeur par défaut de ce paramètre est false.
Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
For Windows operating system -winservicePassword mot_de_passe_service_win
Indiquez le mot de passe de l'utilisateur spécifié ou du compte local qui possédera le service Windows. Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.
For Windows operating system -winserviceStartupType manual | automatic | disabled
Les valeurs admises pour le démarrage du service Windows sont les suivantes :
  • manual
  • automatic
  • disabled

La valeur par défaut de ce paramètre est manual.

Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.

For Windows operating system -winserviceUserName ID_utilisateur_service_win
Indiquez votre ID utilisateur, afin que le système d'exploitation Windows puisse vérifier qu'il est habilité à créer un service Windows. Votre ID utilisateur doit appartenir au groupe administrateur et disposer des droits utilisateur avancés suivants :
  • Agir dans le cadre du système d'exploitation
  • Ouvrir une session en tant que service
La valeur par défaut de ce paramètre est le nom de l'utilisateur actuel. La valeur de ce paramètre ne doit pas contenir d'espaces, ni de caractères non valides, tels que les caractères suivants : *, ?, ", <, >, ,, /, \ et |. L'utilisateur spécifié doit posséder les droits requis pour la création d'un service Windows. Vous devez spécifier le mot de passe correct pour le nom d'utilisateur choisi.
Utilisez ce paramètre lors de la création de profil uniquement. N'utilisez pas ce paramètre lors de l'augmentation d'un profil existant.

reference Rubrique de référence

Conditions d'utilisation | Commentaires en retour


Icône d'horodatage Dernière mise à jour: 07 juillet 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/rins_manageprofiles_parms.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
Ce centre d'information est mis en service par la technologie Eclipse (http://www.eclipse.org).