- -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.
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.
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
où 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.
- -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.
-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.



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
où
numéro_noeud représente un numéro séquentiel commençant à
01.

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
- -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
où 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.
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
où
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
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.
-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 :
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”
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”
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”
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”
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.
-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.
-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.
-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.
-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.
-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.