Commande manageprofiles

Utilisez la commande manageprofiles pour créer, supprimer, étendre, sauvegarder et restaurer les profils qui définissent des environnements d'exécution. L'utilisation de profils à la place de plusieurs installations de produit permet d'économiser de l'espace disque et simplifie la mise à jour du produit car il suffit de gérer un seul ensemble de fichiers produit.

La seule façon de créer des environnements d'exécution consiste à utiliser la commande manageprofiles et son interface graphique, l'outil de gestion des profils.

Le fichier de commandes se trouve dans le répertoire racine_serveur_app/bin. Ce fichier de commandes est un script appelé manageprofiles.

Remarque : La création d'un profil en exécutant directement manageprofiles.sh n'est pas prise en charge sous z/OS.
A faire : Si cette commande est utilisée avec le modèle de profil géré, les serveurs d'applications ne sont pas créés. Cependant, les ports sont encore utilisés si vous fédérez un noeud.
Important : Le comportement par défaut pour manageprofiles consiste à créer des fichiers avec les droits 755, ignorant ainsi la valeur umask définie à l'échelle du système. Si vous souhaitez modifier ces droits, utilisez la commande chmod chaque fois que vous transmettez le profil d'un utilisateur à un autre utilisateur.

Syntaxe

La commande manageprofiles permet d'effectuer les tâches suivantes :
  • créer un profil (-create)
  • supprimer un profil (-delete)
  • effectuer l'extension d'un profil (-augment)
  • réduire un profil (-unaugment)
  • réduire tous les profils étendus avec un modèle d'extension déterminé (-unaugmentAll)
  • supprimer tous les profils (-deleteAll)
  • afficher la liste de tous les profils (-listProfiles)
  • répertorier les extensions d'un profil (-listAugments)
  • extraire un nom de profil (-getName)
  • extraire un chemin d'accès à un profil (-getPath)
  • valider un registre de profils (-validateRegistry)
  • valider et mettre à jour un registre de profils (-validateAndUpdateRegistry)
  • extraire le nom du profil par défaut (-getDefaultName)
  • sauvegarder un profil (-backupProfile)
  • restaurer un profil (-restoreProfile)
  • effectuer les tâches de commande manageprofiles contenues dans un fichier de réponses (-response)
Pour obtenir une aide plus détaillée, y compris sur les paramètres obligatoires pour chacune des tâches accomplies à l'aide de la commande manageprofiles, utilisez le paramètre -help. L'exemple suivant utilise le paramètre d'aide avec la commande manageprofiles -augment sur des systèmes d'exploitation Windows :
app_server_root\bin\manageprofiles.bat -augment -help

Selon l'opération que vous désirez exécuter à l'aide de la commande manageprofiles, vous devez indiquer un ou plusieurs des paramètres suivants. L'outil de ligne de commande vérifie que les paramètres obligatoires sont fournis et que les valeurs saisies pour ces paramètres sont valides. Veillez à entrer le nom des paramètres en respectant les majuscules et les minuscules car l'outil de ligne de commande ne valide pas la casse des noms de paramètres. Si la casse n'est pas respectée lors de la saisie des noms de paramètres, des résultats incorrects peuvent être produits.

  • -adminPassword motdepasseAdmin
  • -adminUserName ID_utilisateurAdmin
  • -applyPerfTuningSetting standard | peak | development
  • -appServerNodeName nom_noeud_serveur_applications
  • -augment
  • -backupFile nom_fichierSauvegarde
  • -backupProfile
  • -cellName nom_cellule (Paramètre optionnel)
  • -create
  • -debug
  • -defaultPorts
  • -delete
  • -deleteAll
  • -dmgrAdminPassword mot_de_passe
  • -dmgrAdminUserName nom_utilisateur
  • -dmgrHost nom_hôte_gestionnaire_déploiement (Paramètre optionnel)
  • -dmgrPort numéro_port_gest_dép_cellule
  • -dmgrProfilePath chemin_profil_gest_dép_cellule
  • -enableAdminSecurity true | false
  • [Linux]-enableService true | false
  • -federateLater true | false
  • -getDefaultName
  • -getPath
  • -getName
  • -help
  • -hostName nom_hôte
  • -ignoreStack (Paramètre optionnel)
  • -importPersonalCertKS chemin_fichier_de_clés
  • -importPersonalCertKSAlias alias_fichier_de_clés
  • -importPersonalCertKSPassword mot_de_passe_fichier_de_clés
  • -importPersonalCertKSType type_fichier_de_clés
  • -importSigningCertKS chemin_fichier_de_clés
  • -importSigningCertKSAlias alias_fichier_de_clés
  • -importSigningCertKSPassword mot_de_passe_fichier_de_clés
  • -importSigningCertKSType type_fichier_de_clés
  • -isDefault
  • -isDeveloperServer
  • -keyStorePassword mot_de_passe_fichier_de_clés
  • -listAugments
  • -listProfiles
  • -nodeDefaultPorts
  • -nodeName nom_noeud
  • -nodePortsFile chemin_fichier_ports_noeud
  • -nodeProfilePathchemin_profil_noeud
  • -omitAction fonction1 fonction2... fonctionN (Paramètre optionnel)
  • -personalCertDN nom_distinctif
  • -personalCertValidityPeriod période_validité (Paramètre optionnel)
  • -portsFile chemin_fichier (Paramètre optionnel)
  • -profileName nom_profil
  • -profilePath racine_profil
  • -response fichier_réponses
  • -restoreProfile
  • -securityLevel niveau_sécurité
  • -serverName nom_serveur
  • -serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
  • [Linux]-serviceUserName ID_utilisateur_service
  • -setDefaultName
  • -signingCertDN nom_distinctif
  • -signingCertValidityPeriod période_validité (Paramètre optionnel)
  • -startingPort port_début | -portsFile chemin_fichier_ports | -defaultPorts
  • -supportedProtocols protocoles_pris_en_charge
  • -templatePath chemin_modèle
  • -unaugment
  • -unaugmentAll
  • -unaugmentDependents
  • -validateAndUpdateRegistry
  • -validatePorts
  • -validateRegistry
  • -webServerCheck true | false
  • -webServerHostnamenom_hôte_serveurweb
  • -webServerInstallPath nom_cheminInstall_serveurweb
  • -webServerName nom_serveurweb
  • -webServerOS système_exploitation_serveurweb
  • -webServerPluginPath chemin_plugin_serveurweb
  • -webServerPort port_serveurweb
  • -webServerType type_serveurweb
  • [Windows]-winserviceAccountType specifieduser | localsystem
  • [Windows]-winserviceCheck true | false
  • [Windows]-winservicePassword motdepasse_winservice
  • [Windows]-winserviceStartupType manual | automatic | disabled
  • [Windows]-winserviceUserName D_utilisateur_winservice
L'exemple suivant utilise la commande manageprofiles -create sur des systèmes d'exploitation tels que AIX ou Linux :
app_server_root/bin/manageprofiles.sh -create 
   -profileName profile_name 
   -profilePath profile_root 
   -templatePath template_path 

Paramètres

Les options ci-après sont disponibles pour la commande manageprofiles :

-adminPassword motdepasseAdmin
Définit le mot de passe de l'ID utilisateur pour la sécurité administrative défini à l'aide du paramètre -adminUserName.
-adminUserName ID_utilisateurAdmin
Définit l'ID utilisateur utilisé pour la sécurité administrative.
-applyPerfTuningSetting option
Indique le paramétrage du réglage des performances qui correspond le mieux au type d'environnement dans lequel le serveur d'applications est exécuté.

Ce paramètre n'est valide que pour le modèle de profil par défaut.

standard
Les paramètres standard sont les paramètres de configuration par défaut prêts à l'emploi qui sont optimisés pour une utilisation générale.
peak
Les paramètres de performance de pic sont optimisés pour un environnement de production dans lequel les modifications d'application sont rares et les performances d'exécution optimales sont importantes.
développement
Les paramètres de développement sont optimisés pour un environnement de développement dans lequel des mises à jour d'application fréquentes sont effectuées et où les ressources système sont au minimum.
Important : N'utilisez pas les paramètres de développement pour les serveurs de production.

Si vous ne spécifiez pas une option avec le paramètre -applyPerfTuningSetting, la valeur par défaut est standard.

Si vous spécifiez à la fois les paramètres -isDeveloperServer et -applyPerfTuningSetting, en fonction de l'option sélectionnée pour -applyPerfTuningSetting, -applyPerfTuningSetting peut remplacer -isDeveloperServer.

-appServerNodeName nom_noeud_serveur_applications
Indique le nom de noeud du serveur d'applications que vous fédérez dans la cellule. Indiquez ce paramètre lorsque vous créez les parties gestionnaire de déploiement et serveur d'applications de la cellule.
-augment
Utilisez la paramètre augment pour modifier un profil existant avec un modèle d'extension. Quand le paramètre augment est utilisé, la commande manageprofiles met à jour ou étend le profil identifié dans le paramètre -profileName utilisant le modèle indiqué dans le paramètre -templatePath. Les modèles d'extension que vous pouvez utiliser sont déterminés par les produits et versions IBM® installés dans votre environnement.
Important : Les modèles inclus dans le produit WebSphere Application Server Network Deployment peuvent uniquement être utilisés pour créer des profils et non pour étendre des profils existants, car seuls des modèles de création sont livrés avec le produit.

De plus, ne modifiez pas manuellement les fichiers situés dans le répertoire de modèles de profil rep_install/. Par exemple, si vous modifiez les ports lors de la création du profil, utilisez les arguments -startingPort ou -portsFile dans la commande manageprofiles au lieu de modifier le fichier se trouvant dans le répertoire de modèles de profil.

Indiquez le chemin du fichier complet pour -templatePath. Par exemple :
 manageprofiles(.bat)(.sh) -augment -profileName profile_name -templatePath template_path
Vous pouvez spécifier un chemin relatif pour le paramètre -templatePath si les modèles de profil sont relatifs au répertoire racine_serveur_app/profileTemplates. Dans le cas contraire, indiquez le chemin complet du modèle. Par exemple :
 manageprofiles -augment -profileName profile_name -templatePath template_path

Voir également le paramètre -unaugment.

-backupFile nom_fichierSauvegarde
Effectue une sauvegarde du fichier de registre du profil dans le fichier défini. Vous devez fournir le chemin complet du fichier de nom_fichierSauvegarde.
-backupProfile
Exécute une sauvegarde du système de fichiers du dossier d'un profil et des métadonnées du profil depuis le fichier de registre du profil. Tous les serveurs qui utilisent le profil dont vous voulez réaliser une sauvegarde doivent d'abord être arrêtés avant d'appeler la commande manageprofiles avec l'option -backupProfile. Le paramètre -backupProfile doit être utilisé avec les paramètres -backupFile et -profileName, par exemple :
manageprofiles(.bat)(.sh) -backupProfile -profileName profile_name -backupFile backupFile_name

Lorsque vous sauvegardez un profil à l'aide de l'option -backupProfile, vous devez d'abord arrêter le serveur et le processus en cours correspondant au profil que vous souhaitez sauvegarder.

-cellName nom_cellule (Paramètre optionnel)
Spécifie le nom de cellule du profil. Utilisez un nom de cellule unique pour chaque profil.
Eviter les incidents Eviter les incidents: Utilisez un nom unique même si vous prévoyez de fédérer le profil personnalisé ou le profil autonome dans une cellule de gestionnaire de déploiement. L'opération de fédération a besoin que les noms de cellule soient uniques pour pouvoir inclure le noeud dans la cellule de gestionnaire de déploiement. Un nom de cellule doit être unique à chaque fois que le produit est exécuté sur la même machine physique ou le même groupe de machines, par exemple sysplex. De plus, le nom de cellule doit être unique à chaque fois que la connectivité réseau entre les entités est nécessaire soit entre les cellules soit à partir d'un client qui doit communiquer avec chaque cellule. Les noms de cellule doivent être uniques si leurs espaces de nom sont fédérés. Sinon, des erreurs comme une exception javax.naming.NameNotFoundException se produisent. Dans ce cas, créez des cellules portant des noms uniques.gotcha

Paramètre facultatif. Si vous omettez le paramètre, un nom de cellule par défaut est affecté.

La valeur par défaut de ce paramètre est basée sur une combinaison formée du nom d'hôte abrégé, de la cellule constante et d'un numéro de lecture fin de ligne :
  • Profil de serveur d'applications : Aucun
  • Profil personnalisé : Aucun
  • Profil de gestion avec le serveur gestionnaire de déploiement : nomabrégéHôteCellNuméroCellule
  • Profil de gestion avec le serveur gestionnaire de travaux : nomabrégéHôteJobMgrCellNuméroCellule
  • Profil de gestion avec le serveur agent d'administration : nomabrégéHôteAACellNuméroCellule
  • Profil de cellule, partie serveur d'applications : nomabrégéHôteCellNuméroCellule
  • Profil de cellule, partie gestionnaire de déploiement : nomabrégéHôteCellNuméroCellule
  • Profil de proxy sécurisé : Aucun
NuméroCellule est un numéro séquentiel commençant à 01.

La valeur de ce paramètre ne doit contenir aucun espace ou caractère non valide tel que *, ?, ", <, >, ,, /, \, |, etc.

-create
Crée le profil.
Définit manageprofiles -create -templatePath chemin_complet_qualifié_du_fichier_vers_le_modèle -help pour des informations spécifiques sur la création d'un profil. Les modèles disponibles incluent :
  • cell - Cellule de gestionnaire de déploiement (dmgr et par défaut)
  • management - Gestion. A utiliser conjointement avec le paramètre -serverType pour indiquer le type de profil de gestion.
  • secureproxy- Serveur proxy
  • par défaut - Serveur d'applications
  • managed - Personnalisé
-debug
Active la fonction de débogage de l'utilitaire Ant que la commande manageprofiles utilise.
-personalCertValidityPeriod période_validité (Paramètre optionnel)
Paramètre facultatif indiquant, en années, la durée de validité du certificat personnel par défaut. Si vous n'indiquez pas ce paramètre avec le paramètre -personalCertDN, le certificat personnel par défaut est valide pendant un an.
-defaultPorts
Attribue au profil les valeurs de port par défaut ou de base.

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

Lors de la création d'un profil, si vous ne définissez pas le paramètre -startingPort, le paramètre -defaultPorts ou le paramètre -portsFile, la commande manageprofiles utilise un ensemble de ports recommandés généré automatiquement. Les valeurs de port recommandées peuvent être différentes des valeurs de port par défaut selon la disponibilité des ports par défaut.

A faire : N'utilisez pas ce paramètre avec le modèle de profil géré.
-delete
Supprime le profil.

La suppression d'un profil ne supprime pas le répertoire des profils. Supposons, par exemple, que vous créiez un profil dans le répertoire /usr/WebSphere/AppServer/profiles/managedProfile. Le répertoire existe toujours après la suppression du profil.

Vous pouvez supprimer ou conserver le répertoire. Cependant, le répertoire racine_profil/logs contient des informations sur la désinstallation du profil. Vous pourriez par exemple vouloir conserver le fichier _nodeuninst.log pour déterminer la cause d'un problème éventuel lors de la procédure de désinstallation.

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

Eviter les incidents Eviter les incidents: Si vous supprimez un ancien noeud qui a été migré, fermez le nouveau gestionnaire de déploiement migré avant de procéder à la suppression. Le nouveau noeud migré ne risque ainsi pas d'être supprimé de la nouvelle cellule migrée.gotcha
-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 créiez un profil dans le répertoire /usr/WebSphere/AppServer/profiles/managedProfile. Le répertoire existe toujours après la suppression du profil.

Vous pouvez supprimer ou conserver le répertoire. Cependant, le répertoire racine_profil/logs contient des informations sur la désinstallation du profil. Vous pourriez par exemple vouloir conserver le fichier _nodeuninst.log pour déterminer la cause d'un problème éventuel lors de la procédure de désinstallation.

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

-dmgrAdminPassword mot_de_passe
Si vous fédérez un noeud et que la sécurité administrative est activée sur le gestionnaire de déploiement, indiquez le nom d'utilisateur valide du gestionnaire de déploiement. Utilisez ce paramètre avec les paramètres -dmgrAdminUserName et -federateLater.
-dmgrAdminUserName nom_utilisateur
Si vous fédérez un noeud et que la sécurité administrative est activée sur le gestionnaire de déploiement, indiquez le mot de passe valide du gestionnaire de déploiement. Utilisez ce paramètre avec les paramètres -dmgrAdminPassword et -federateLater.
-dmgrHost nom_hôte_gestionnaire_déploiement (Paramètre optionnel)
Identifie la machine sur laquelle le gestionnaire de déploiement est exécuté. Définissez ce paramètre et le paramètre dmgrPort pour fédérer un profil personnalisé quand il est créé.

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

La spécification de ce paramètre facultatif ordonne à la commande manageprofiles de tenter de fédérer le noeud personnalisé dans la cellule du gestionnaire de déploiement lors de la création du profil personnalisé avec le paramètre -templatePath managed. Le paramètre -dmgrHost est ignoré lors de la création d'un profil de gestionnaire de déploiement ou d'un profil de serveur d'applications.

Si vous fédérez un noeud personnalisé quand le gestionnaire de déploiement n'est pas en cours d'exécution ou n'est pas disponible parce que la sécurité est activée ou pour d'autres raisons, l'indicateur d'installation dans les journaux est INSTCONFFAIL, indiquant un échec. Le profil personnalisé résultant ne peut être utilisé. 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 vous servir de la commande manageprofiles pour fédérer. Utilisez la commande addNode à la place.

La valeur par défaut de ce paramètre est localhost. La valeur de ce paramètre doit être un nom d'hôte correctement formé et ne doit contenir aucun espace ni caractère non valide tel que *, ?, ", <, >, ,, /, \, |, etc. Il faut également qu'une connexion au gestionnaire de déploiement soit disponible en conjonction avec le paramètre dmgrPort.

-dmgrPort numéro_port_dmgr
Identifie le port SOAP du gestionnaire de déploiement. Définissez ce paramètre et le paramètre dmgrHost pour fédérer un profil personnalisé lorsqu'il est créé. 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 (Java™ Management Extensions) par défaut, vous ne pouvez pas utiliser la commande manageprofiles pour fédérer un profil. Utilisez la commande addNode à la place.

La valeur par défaut de ce paramètre est 8879. Le port que vous définissez doit être un nombre entier positif, et il faut qu'une connexion au gestionnaire de déploiement soit disponible en conjonction avec le paramètre dmgrHost.

-dmgrProfilePath chemin_profil_gest_dép_cellule
Définit le chemin de profil vers la partie gestionnaire de déploiement de la cellule. Définissez ce paramètre lorsque vous créez la partie serveur d'applications de la cellule.
-enableAdminSecurity true | false
Active la sécurité administrative. Les valeurs valides sont true ou false. La valeur par défaut est false.
Lorsque enableAdminSecurity est défini sur true, vous devez également définir les paramètres -adminUserName et -adminPassword ainsi que les valeurs de ces paramètres.

Vous ne pouvez pas utiliser le paramètre -enableAdminSecurity pour activer la sécurité d'administration d'un profil personnalisé. Pour activer la sécurité pour un profil personnalisé, le profil personnalisé doit être fédéré en gestionnaire de déploiement. La sécurité d'administration activée pour le gestionnaire de déploiement est nécessaire pour activer la sécurité du profil personnalisé fédéré.

[Linux]-enableService true | false
[Linux]Active la création d'un service Linux. Les valeurs valides sont true ou false. La valeur par défaut de ce paramètre est false.

Quand la commande manageprofiles est exécutée alors que l'option -enableService est définie sur true, le service Linux est créé avec le profil lorsque la commande est exécutée par le superutilisateur (root). Quand un utilisateur non root exécute la commande manageprofiles, le profil est créé mais pas le service Linux. Le service Linux n'est pas créé car l'utilisateur non root ne dispose pas des autorisations suffisantes pour configurer le service. Un résultat INSTCONPARTIALSUCCESS s'affiche à la fin de la création du profil et le journal de création du profil racine_serveur_app/logs/manageprofiles_create_nomduprofil.log contient un message indiquant que l'utilisateur actuel ne dispose pas des autorisations suffisantes pour configurer le service Linux.

-federateLater true | false
Indique si le profil géré sera fédéré lors de la création du profil ou si vous le fédérerez plus tard à l'aide de la commande addNode. Si les paramètres dmgrHost, dmgrPort, dmgrAdminUserName et dmgrAdminPassword ne comportent pas de valeurs, la valeur par défaut de ce paramètre est true. Les valeurs valides sont true ou false.
-getDefaultName
Renvoie le nom du profil par défaut.
-getPath
Extrait l'emplacement du système de fichiers pour un profil du nom indiqué. Nécessite le paramètre –profileName.
-getName
Obtient le nom d'un profil enregistré à un paramètre -profilePath donné.
-help
Affiche la syntaxe de commande.
-hostName nom_hôte
Spécifie le nom d'hôte sur lequel vous créez le profil. celui-ci doit correspondre au nom d'hôte spécifié lors de l'installation du produit initial. La valeur par défaut de ce paramètre est la forme longue du système de nom de domaine. La valeur de ce paramètre doit être un nom d'hôte IPv6 valide et ne doit contenir aucun espace ou caractère non valide, tel que *, ?, ", <, >, ,, /, \, |, etc.
-ignoreStack (Paramètre optionnel)
Paramètre facultatif utilisé avec le paramètre -templatePath pour réduire un profil particulier qui a été étendu. Reportez-vous au paramètre -unaugment.
-importPersonalCertKS chemin_fichier_de_clés
Indique le chemin d'accès au fichier de clés que vous utilisez pour importer un certificat personnel lors de la création du profil. Le certificat personnel est le certificat personnel par défaut du serveur.
Pratiques recommandées Pratiques recommandées: Importez le certificat racine qui a signé le certificat personnel que vous importez comme certificat personnel par défaut. Sinon, la commande manageprofiles ajoute la clé publique du certificat personnel au fichier trust.p12 et crée un certificat signataire racine.bprac
Les paramètres -importPersonalCertKS et -personalCertDN sont mutuellement exclusifs. Si vous ne créez pas ou n'importez pas spécifiquement de certificat personnel, le système en crée un par défaut.

Si vous définissez l'un des paramètres qui commencent par -importPersonal, vous devez les indiquer tous.

-importPersonalCertKSAlias alias_fichier_de_clés
Indique l'alias du certificat inclus dans le fichier de clés désigné à l'aide du paramètre -importPersonalCertKS. Le certificat est ajouté au fichier de clés par défaut du serveur et utilisé comme certificat personnel par défaut du serveur.

Si vous définissez l'un des paramètres qui commencent par -importPersonal, vous devez les indiquer tous.

-importPersonalCertKSPassword mot_de_passe_fichier_de_clés
Indique le mot de passe du fichier de clés désigné à l'aide du paramètre -importPersonalCertKS.

Si vous définissez l'un des paramètres qui commencent par -importPersonal, vous devez les indiquer tous.

-importPersonalCertKSType type_fichier_de_clés
Indique le type du fichier de clés désigné à l'aide du paramètre -importPersonalCertKS. Les valeurs possibles sont JCEKS, CMSKS, PKCS12, PKCS11 et JKS. Cependant, cette liste est modifiable en fonction du fournisseur indiqué dans le fichier java.security.

Si vous définissez l'un des paramètres qui commencent par -importPersonal, vous devez les indiquer tous.

-importSigningCertKS chemin_fichier_de_clés
Indique le chemin d'accès au fichier de clés que vous utilisez pour importer un certificat racine lors de la création du profil. Le certificat racine est le certificat que vous utilisez comme certificat racine par défaut du serveur. Les paramètres -importSigningCertKS et -signingCertDN sont mutuellement exclusifs. Si vous ne créez pas ou n'importez pas spécifiquement de certificat signataire racine, le système en crée un par défaut.

Si vous définissez l'un des paramètres qui commencent par -importSigning, vous devez les indiquer tous.

-importSigningCertKSAlias alias_fichier_de_clés
Indique l'alias du certificat inclus dans le fichier de clés désigné à l'aide du paramètre -importSigningCertKS. Le certificat est ajouté au fichier de clés racine par défaut du serveur et utilisé comme certificat racine par défaut du serveur.

Si vous définissez l'un des paramètres qui commencent par -importSigning, vous devez les indiquer tous.

-importSigningCertKSPassword mot_de_passe_fichier_de_clés
Indique le mot de passe du fichier de clés désigné à l'aide du paramètre -importSigningCertKS.

Si vous définissez l'un des paramètres qui commencent par -importSigning, vous devez les indiquer tous.

-importSigningCertKSType chemin_fichier_de_clés
Indique le type du fichier de clés désigné à l'aide du paramètre -importSigningCertKS. Les valeurs possibles sont JCEKS, CMSKS, PKCS12, PKCS11 et JKS. Cependant, cette liste est modifiable en fonction du fournisseur indiqué dans le fichier java.security.

Si vous définissez l'un des paramètres qui commencent par -importSigning, vous devez les indiquer tous.

-isDefault
Indique que le profil identifié par le paramètre -profileName qui l'accompagne doit devenir le profil par défaut une fois enregistré. Lorsque des commandes qui s'adressent à ce profil par défaut sont exécutées, il est inutile d'utiliser l'attribut -profileName de la commande.
-isDeveloperServer
Indique si le serveur n'est destiné qu'au développement. Ce paramètre s'avère utile lorsque vous créez des profils afin de tester des applications sur un serveur qui n'est pas un serveur de production avant de déployer les applications sur leurs serveurs de production.

Le paramètre n'est valide que pour le modèle de profil par défaut.

Si vous spécifiez à la fois les paramètres -isDeveloperServer et -applyPerfTuningSetting, en fonction de l'option sélectionnée pour -applyPerfTuningSetting, -applyPerfTuningSetting peut remplacer -isDeveloperServer.

-keyStorePassword mot_de_passe_fichier_de_clés
Indique le mot de passe à utiliser pour tous les fichiers de clés générés lors de la création du profil. Les fichiers de clés sont créés pour le certificat personnel par défaut et le certificat signataire racine.
-listAugments
Répertorie la liste des extensions d'un profil enregistrées dans le registre des profils. Vous devez indiquer le paramètre -profileName avec le paramètre -listAugments.
-listProfiles
Répertorie les profils qui se trouvent dans le registre des profils.
-nodeDefaultPorts
Définit un ensemble de ports lors de la création d'un profil associé à un modèle de cellule. Si vous spécifiez cette option, vous ne pouvez pas spécifier les options -nodePortsFile ou nodeStartingPort simultanément.
-nodeName nom_noeud
Indique le nom du noeud créé avec le nouveau profil. Utilisez une valeur unique dans la cellule ou sur la machine. Chaque profil qui partage le même ensemble de binaires de produit doivent posséder un nom de noeud unique.
La valeur par défaut de ce paramètre est basée sur le nom d'hôte abrégé, le type de profil et un numéro de lecture fin de ligne :
  • Profil de serveur d'applications : nomabrégéHôteNodeNuméroNoeud
  • Profil personnalisé : nomabrégéHôteNodeNuméroNoeud
  • Profil de gestion avec le serveur gestionnaire de déploiement : nomabrégéHôteCellManagerNuméroCellule
  • Profil de gestion avec le serveur gestionnaire de travaux : nomabrégéHôteJobMgrNuméroCellule
  • Profil de gestion avec le serveur agent d'administration : nomabrégéHôteAANodeNuméroCellule
  • Profil de cellule, partie serveur d'applications : nomabrégéHôteNodeNuméroCellule
  • Profil de cellule, partie gestionnaire de déploiement : nomabrégéHôteCellManagerNuméroCellule
  • Profil de proxy sécurisé : nomabrégéHôteNodeNuméroNoeud
NuméroNoeud est un numéro séquentiel commençant à 01.

La valeur de ce paramètre ne doit contenir aucun espace ou caractère non valide tel que *, ?, ", <, >, ,, /, \, |, etc.

-nodePortsFile chemin_ports_noeud
Indique les ports pour la partie noeud de la cellule que vous créez. Si vous précisez cette option, vous ne pouvez pas indiquer l'option -nodeDefaultPorts ou nodeStartingPort simultanément.
-nodeProfilePath chemin_profil_noeud
Indique le chemin de profil vers la partie noeud de la cellule. Indiquez ce paramètre lorsque vous créez la partie noeud de la cellule.
-omitActionfonction1 fonction2... fonctionN (Paramètre optionnel)
Paramètre facultatif qui exclut des fonctions de profil.
Chaque modèle de profil est prédéfini avec certaines fonctions facultatives. Les options facultatives suivantes peuvent être utilisées avec le paramètre -omitAction pour les modèles de profil suivants :
  • default : serveur d'applications
    • deployAdminConsole
    • defaultAppDeployAndConfig
    • deployIVTApplication
  • management : profil de gestion du gestionnaire de déploiement, de l'agent d'administration ou du gestionnaire de travaux
    • deployAdminConsole
  • cell : cellule du gestionnaire de déploiement constitué d'un gestionnaire de déploiement et d'un modèle de profil par défaut
    • cell_dmgr (gestionnaire de déploiement créé en même temps que le profil de cellule)
      • deployAdminConsole
      • defaultAppDeployAndConfig
-personalCertDN nom_distinctif
Indique le nom distinctif du certificat personnel que vous établissez lors de la création du profil. Placez ce nom distinctif entre guillemets. Le certificat personnel par défaut se trouve dans le fichier de clés du serveur. Les paramètres -importPersonalCertKSType et -personalCertDN sont mutuellement exclusifs. Voir les paramètres -personalCertValidityPeriod et -keyStorePassword.
-portsFile chemin_fichier (Paramètre optionnel)
Paramètre facultatif qui spécifie le chemin d'accès à un fichier qui définit les paramètres de port pour le nouveau profil.

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

Lors de la création d'un profil, si vous ne définissez pas le paramètre -startingPort, le paramètre -defaultPorts ou le paramètre -portsFile, la commande manageprofiles utilise un ensemble de ports recommandés généré automatiquement. Les valeurs de port recommandées peuvent être différentes des valeurs de port par défaut selon la disponibilité des ports par défaut.

-profileName nom_profil
Spécifie le nom du profil. Utilisez une valeur unique lorsque vous créez un profil. Chaque profil qui partage le même ensemble de binaires de produit doit posséder un nom unique. Le nom du profil par défaut est basé sur le type de profil et sur un numéro de lecture fin de ligne, par exemple :
<profile_type><profile_number>
  • <type_profil> est une valeur telle qu'AppSrv, Dmgr, AdminAgent, JobMgr, ou Custom
  • <numéro_profil> est un nombre séquentiel qui crée un nom de profil unique

La valeur de ce paramètre ne doit contenir aucun espace ou caractère non valide, tel que *, ?, ", <, >, ,, /, \, |, etc.

Le nom de profil que vous choisissez ne doit pas déjà être utilisé.

-profilePath racine_profil
Définit le chemin complet vers le profil qui est désigné comme étant le profil racine_profil.
Indiquez le chemin complet pour éviter une limitation de scriptage Ant pouvant entraîner un échec lors de la fédération du profil dans une cellule. Exemple :
-profilePath profile_root

[Windows]Si le chemin complet qualifié contient des espaces, placez la valeur entre guillemets.

La valeur par défaut est basée sur le répertoire racine_serveur_app, le sous-répertoire des profils et le nom du profil.

Par exemple, la valeur par défaut est la suivante :
WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName
L'élément WS_WSPROFILE_DEFAULT_PROFILE_HOME est défini dans le fichier wasprofile.properties situé dans le répertoire racine_serveur_app/properties.
Remarque : Le fichier wasprofile.properties inclut les propriétés suivantes :
WS_CMT_PI_MODPERMS
Cette propriété indique si le programme post-installation doit modifier les droits d'accès des fichiers qu'il crée. Les valeurs admises sont true ou false. Toute autre valeur est false par défaut. La suppression de cette propriété du fichier lui affecte également la valeur false par défaut. Si la valeur est false, les droits d'accès des fichiers créés par le programme post-installation sont basés sur le paramètre umask du système.

La valeur de ce paramètre doit être un chemin valide vers le système cible et ne doit pas être utilisée actuellement.

Vous devez disposer des autorisations nécessaires pour écrire dans le répertoire.

WS_CMT_PI_LOGS
Cette propriété spécifie si et quand l'utilitaire de post-installation doit nettoyer ses journaux destinés à chaque produit dans le répertoire PROFILE_HOME/logs/service/productDir. Les paramètres de cette propriété permettent de spécifier les critères de nettoyage de journaux suivants :
  • Vous pouvez spécifier le nombre de journaux à conserver pour chaque produit dans le répertoire PROFILE_HOME/logs/service/productDir. La valeur peut être un entier compris entre 1 et 999. Par exemple, si vous spécifiez WS_CMT_PI_LOGS=5, l'utilitaire de post-installation conserve les cinq journaux les plus récents pour chaque produit.
  • Vous pouvez spécifier l'espace maximal que les journaux peuvent occuper. La valeur peut être un entier compris entre 1 et 999, suivi par :
    • KB, si vous spécifiez une valeur en kilooctets.
    • MB, si vous spécifiez une valeur en mégaoctets.
    • GB, si vous spécifiez une valeur en gigaoctets.
    Par exemple, si vous spécifiez WS_CMT_PI_LOGS=10MB, l'utilitaire de post-installation commence à détruire les journaux les plus anciens lorsque l'espace occupé dépasse 10 mégaoctets.
    Eviter les incidents Eviter les incidents: Les valeurs spécifiées sont sensibles à la casse ; les lettres doivent donc être incluses en majuscules.gotcha
  • Vous pouvez indiquer la période de temps pendant laquelle l'utilitaire de post-installation conservera les journaux. La valeur peut être un entier compris entre 1 et 999, suivi par :
    • D, si vous spécifiez une valeur en jours.
    • W, si vous spécifiez une valeur en semaines.
    • M, si vous spécifiez une valeur en mois.
    • Y, si vous spécifiez une valeur en années.
    Par exemple, si vous spécifiez WS_CMT_PI_LOGS=2W, chaque journal est conservé pendant deux semaines.
    Eviter les incidents Eviter les incidents: Les valeurs spécifiées sont sensibles à la casse ; les lettres doivent donc être incluses en majuscules.gotcha
  • Vous pouvez spécifier une date à laquelle un journal sera détruit. La valeur doit être spécifiée à l'aide de valeurs numériques séparées par des tirets (format JJ-MM-AAAA). Par exemple, si vous spécifiez WS_CMT_PI_LOGS=12-31-2013, tous les journaux seront détruits le 31 décembre 2013.
    Eviter les incidents Eviter les incidents: Si vous ne spécifiez pas la valeur dans le format indiqué (nombres séparés par des tirets), ce paramètre de propriété est ignoré.gotcha
-response fichier_réponses
Accède à toutes les fonctions d'API à partir de la ligne de commande en utilisant la commande manageprofiles.

L'interface de ligne de commande peut être gérée par un fichier de réponses contenant les arguments d'entrée d'une commande donnée dans un fichier de propriétés au format clé et valeur. Pour déterminer les arguments en entrée qui sont requis pour les divers types de modèles de profil et les actions, utilisez la commande manageprofiles avec le paramètre -help.

Utilisez l'exemple de fichier de réponses pour exécuter une opération de création :
create
profileName=testResponseFileCreate
profilePath=profile_root
templatePath=app_server_root/profileTemplates/default
nodeName=myNodeName
cellName=myCellName
hostName=myHostName
omitAction=myOptionalAction1,myOptionalAction2
Lorsque vous créez un fichier de réponses, prenez en considération l'ensemble des directives suivantes :
  • Lorsque vous spécifiez des valeurs, n'entrez pas de guillemets (") au début ou à la fin d'une valeur, même si cette valeur contient des espaces.
    Remarque : Il s'agit d'une règle différente de celle qui s'applique lorsque vous spécifiez des valeurs sur une ligne de commande.
  • Lorsque vous spécifiez une valeur unique contenant une virgule, par exemple les noms distinctifs pour les paramètres personalCertDN et signingCertDN, utilisez une barre oblique inversée double avant la virgule. Par exemple, vous pouvez définir la valeur signingCertDN avec un nom distinctif :
    signingCertDN=cn=testserver.ibm.com\\,ou=Root Certificate\\,
       ou=testCell\\,ou=testNode01\\,o=IBM\\,c=US 
  • Lorsque vous spécifiez plusieurs valeurs, séparez-les à l'aide d'une virgule et n'utilisez pas de barres obliques inversées doubles. Par exemple, voici comment spécifier plusieurs valeurs pour le paramètre omitAction :
    omitAction=deployAdminConsole,defaultAppDeployAndConfig 
  • Ne spécifiez pas de ligne vierge dans un fichier de réponses. Cela peut donner lieu à une erreur.
  • [Windows]Dans un système d'exploitation Windows, l'instruction de chemin peut utiliser des barres obliques (/) ou des barres obliques inverses (\). Si l'instruction de chemin utilise des barres obliques inverses, le fichier de réponses a besoin de barres obliques inverses doubles pour comprendre correctement le chemin. Voici un exemple de fichier de réponses pour une opération de création qui utilise des barres obliques inverses doubles :
    create
    templatePath=C:\\WebSphere\\AppServer\\profileTemplates\\default
    Pratiques recommandées Pratiques recommandées: Utilisez des barres obliques (/) afin de réduire le risque d'erreur lors de la commutation entre plateformes.bprac
-restoreProfile
Important : La commande manageProfiles -restoreProfile n'est prise en charge qu'avec les sauvegardes créées avec le même niveau de groupe de correctifs.
Restaure la sauvegarde d'un profil. Doit s'utiliser avec le paramètre -backupFile, par exemple :
manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name
Pour restaurer un profil, procédez comme suit :
  1. Arrêtez le serveur et les processus en cours du profil à restaurer.
  2. Supprimez manuellement le répertoire du profil dans le système de fichiers.
  3. Exécutez l'option -validateAndUpdateRegistry de la commande manageprofiles.
  4. Restaurez le profil à l'aide de l'option -restoreProfile de la commande manageprofiles.
-securityLevel niveau_sécurité
Indique les paramètres de niveau de sécurité initial à utiliser pour le serveur proxy sécurisé. Les valeurs valides sont low, medium et high. La valeur par défaut est high. Le niveau de sécurité dépend des droits utilisateur au démarrage, des questions de routage, des options d'administration et du traitement d'erreurs. Vous pouvez modifier les paramètres de sécurité une fois que vous avez créé le profil de serveur proxy sécurisé.
-serverName nom_serveur
Indique le nom du serveur. Indiquez ce paramètre uniquement pour le modèle par défaut et le modèle de serveur proxy. Si vous n'indiquez pas ce paramètre lorsque vous utilisez le modèle par défaut et le modèle de serveur proxy, le nom de serveur par défaut est server1 pour le profil par défaut et proxy1 pour le profil de proxy sécurisé.
-serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
Indique le type de profil de gestion. Spécifiez DEPLOYMENT_MANAGER pour un serveur de gestionnaire de déploiement, ADMIN_AGENT pour un serveur d'agent d'administration ou JOB_MANAGER pour un serveur de gestionnaire de travaux. Ce paramètre est obligatoire lorsque vous créez un profil de gestion.
[Linux]-serviceUserName ID_utilisateur_service
[Linux]Indique l'ID utilisateur entré lors de la création du service Linux afin que le service Linux s'exécute sous cet ID utilisateur. Le service Linux s'exécute chaque fois que cet ID utilisateur est connecté.
-setDefaultName
Définit le profil par défaut sur l'un des profils existants. Doit s'utiliser avec le paramètre -profileName, par exemple :
manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name
-signingCertDN nom_distinctif
Indique le nom distinctif du certificat signataire racine que vous établissez lors de la création du profil. Placez ce nom distinctif entre guillemets. Le certificat personnel par défaut se trouve dans le fichier de clés du serveur. Les paramètres -importSigningCertKS et -signingCertDN sont mutuellement exclusifs. Si vous ne créez pas ou n'importez pas spécifiquement de certificat signataire racine, le système en crée un par défaut. Voir les paramètres -signingCertValidityPeriod et -keyStorePassword.
-signingCertValidityPeriod période_validité (Paramètre optionnel)
Paramètre facultatif indiquant, en années, la durée de validité du certificat de signature racine. Si vous n'indiquez pas ce paramètre avec le paramètre -signingCertDN, le certificat de signature racine est valide pendant 15 ans.
-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.

Les valeurs des ports sont affectées de façon séquentielle à partir de la valeur -startingPort, de sorte que les ports déjà utilisés sont omis. Le système reconnaît et résout les ports en cours d'utilisation, et il détermine les attributions de port de manière à éviter les conflits de ports.

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

Lors de la création d'un profil, si vous ne définissez pas le paramètre -startingPort, le paramètre -defaultPorts ou le paramètre -portsFile, la commande manageprofiles utilise un ensemble de ports recommandés généré automatiquement. Les valeurs de port recommandées peuvent être différentes des valeurs de port par défaut selon la disponibilité des ports par défaut.

Avertissement : N'utilisez pas ce paramètre avec le modèle de profil géré.
-supportedProtocols protocoles_pris_en_charge
Indique les protocoles valides permettant au serveur proxy sécurisé de traiter les demandes. Les valeurs valides sont SIP, HTTP et HTTP,SIP.
-templatePath chemin_modèle
Spécifie le chemin de répertoire aux fichiers de modèle dans le répertoire racine d'installation. Le répertoire profileTemplates contient plusieurs répertoires qui correspondent aux différents types de profils et qui varient en fonction du type de produit installé. Les répertoires de profil sont les chemins que vous indiquez lorsque vous utilisez l'option -templatePath. Vous pouvez définir des modèles de profil disponibles hors de la racine d'installation, s'il en existe.

Vous pouvez spécifier un chemin relatif pour le paramètre -templatePath si les modèles de profil sont relatifs au répertoire racine_serveur_app/profileTemplates. Dans le cas contraire, indiquez le chemin complet du modèle. P

Les modèles disponibles sont décrits dans la rubrique relative aux concepts de profil.

-unaugment
L'extension est la possibilité de modifier un profil existant à l'aide d'un modèle d'extension. Pour réduire un profil qui a été étendu, vous devez définir les paramètres -unaugment et -profileName. Si une série d'extensions manageprofiles ont été effectuées et que ne définissez que ces deux paramètres pour réduire un profil, l'action de réduction annule la dernière action d'extension réalisée.

Pour réduire un profil particulier qui a été étendu, définissez le paramètre -ignoreStack avec le paramètre -templatePath. En général, vous ne devez pas réduire un profil particulier dans la mesure où vous devez vous assurer que vous ne respectez pas les dépendances de modèle de profil.

Lors de l'utilisation du paramètre -templatePath, définissez le chemin de fichier complet pour le paramètre.

Voir également le paramètre augment.

-unaugmentAll
Réduit tous les profils étendus avec un modèle d'extension déterminé. Le paramètre -templatePath est obligatoire avec le paramètre -unaugmentAll.

Lors de l'utilisation du paramètre -templatePath, définissez le chemin de fichier complet pour le paramètre.

En option, indiquez le paramètre -unaugmentDependents avec le paramètre -unaugmentAll pour réduire tous les profils prérequis liés aux profils en cours de réduction.

Remarque : Si vous utilisez ce paramètre lorsqu'aucun profil n'est étendu avec les modules de profil, une erreur peut être renvoyée.

Voir également le paramètre augment.

-unaugmentDependents
Si ce paramètre est spécifié, il réduit tous les profils étendus prérequis liés aux profils en cours de réduction avec le paramètre -unaugmentAll. S'il n'est pas spécifié, il ne réduit pas les profils étendus prérequis liés aux profils en cours de réduction.

Spécifiez le paramètre -unaugmentDependents avec le paramètre -unaugmentAll.

-validateAndUpdateRegistry
Vérifie tous les profils répertoriés dans le référentiel de profils pour constater si les profils se trouvent bien sur le système de fichiers. Supprime les profils manquants du référentiel. Renvoie une liste des profils manquants qui ont été supprimés du registre.
-validatePorts
Vérifie les ports afin de s'assurer qu'ils ne sont pas réservés ni utilisés. Ce paramètre vous aide à identifier les ports qui ne sont pas en cours d'utilisation. S'il est établi qu'un port est en cours d'utilisation, la création du profil s'arrête et un message d'erreur s'affiche. Vous pouvez utiliser ce paramètre à n'importe quel moment sur la ligne de commande de création. Il est recommandé d'utiliser ce paramètre avec le paramètre –portsFile.
-validateRegistry
Vérifie tous les profils répertoriés dans le référentiel de profils pour constater si les profils se trouvent bien sur le système de fichiers. Renvoie une liste des profils manquants.
-webServerCheck true | false
Indique si vous voulez configurer des définitions de serveur Web. Les valeurs valides sont true ou false. La valeur par défaut de ce paramètre est false.
-webServerHostname nom_hôte_serveurweb
Nom d'hôte du serveur. La valeur par défaut de ce paramètre est le nom d'hôte complet de la machine locale.
-webServerInstallPath nom_cheminInstall_serveurweb
Chemin d'installation du serveur Web, local ou distant. La valeur par défaut de ce paramètre dépend du système d'exploitation de la machine locale et de la valeur du paramètre webServerType. Par exemple :
[Windows]
webServerType=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”
[Linux]
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”
[AIX]
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”
[HP-UX]
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”
[Solaris]
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”
-webServerName nom_serveurweb
Nom du serveur Web. La valeur par défaut de ce paramètre est webserver1.
-webServerOS système_exploitation_serveurweb
Système d'exploitation de la machine sur laquelle réside le serveur Web. Les valeurs valides sont : windows, linux, solaris, aix, hpux, os390 et os400. Utilisez ce paramètre avec le paramètre webServerType.
-webServerPluginPath chemin_plugin_serveurweb
Chemin d'accès aux plug-ins utilisés par le serveur Web. La valeur par défaut de ce paramètre est WAS_HOME/plugins.
-webServerPort port_serveurweb
Indique le port qui sera utilisé pour accéder au serveur Web. La valeur par défaut de ce paramètre est 80.
-webServerType type_serveurweb
Type du serveur Web. Les valeurs valides sont : IHS, SUNJAVASYSTEM, IIS, DOMINO, APACHE, et HTTPSERVER_ZOS. Utilisez ce paramètre avec le paramètre webServerOS.
[Windows]-winserviceAccountType specifieduser | localsystem
[Windows]Type du compte propriétaire du service Windows créé pour le profil. Les valeurs valides sont specifieduser ou localsystem. La valeur localsystem exécute le service Windows sous le compte local du propriétaire qui crée le profil. La valeur par défaut de ce paramètre est localsystem.

Si la valeur est specifieduser, le paramètre winservicePassword est obligatoire. Si aucune valeur n'est indiquée, le paramètre winserviceUserName correspond par défaut à la valeur d'environnement username.

[Windows]-winserviceCheck true | false
[Windows]La valeur peut être true ou false. Indiquez true pour créer un service Windows pour le processus de 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.
Important : Avec un profil personnalisé, il est impossible de créer un service Windows avec ce paramètre. Au lieu de cela, créez le service séparément à l'aide de la commande WASService pour .
[Windows]-winservicePassword motdepasse_winservice
[Windows]Indiquez le mot de passe pour l'utilisateur spécifié ou le compte local auquel doit appartenir le service Windows.
[Windows]-winserviceStartupType manual | automatic | disabled
[Windows]Les valeurs possibles sont les suivantes :
  • manual
  • automatic
  • disabled

Lire l'article relatif à la commande WASService pour plus d'informations sur les services Windows.

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

[Windows]-winserviceUserName ID_utilisateur_winservice
[Windows]Définissez votre ID utilisateur de façon à ce que le système d'exploitation Windows puisse vérifier que vous possédez un ID capable de créer un service Windows. Votre ID utilisateur doit faire partie du groupe d'administration et disposer des droits d'utilisateur avancés suivants :
  • Fonctionner en tant que partie intégrante du système d'exploitation
  • Se connecter en tant que service
La valeur par défaut de ce paramètre est le nom d'utilisateur actuel. La valeur de ce paramètre ne doit contenir aucun espace ou caractère non valide tel que *, ?, ", <, >, ,, /, \, |, etc. L'utilisateur que vous définissez doit disposer des autorisations appropriées pour créer un service Windows. Vous devez définir le mot de passe correct pour le nom d'utilisateur que vous choisissez.
Important : Lorsque vous créez un profil avec un service Windows, ainsi qu'un utilisateur et un mot de passe spécifiés et que cet utilisateur est un utilisateur de domaine, vous devez utiliser une double barre oblique inversée comme illustré dans l'exemple ci-dessous :
winServiceUserName=DOMAIN\\DOMAINUSER
winServicePassword=DOMAINUSERPASSWORD

Scénario d'utilisation

Les exemples qui suivent donnent la syntaxe appropriée. Pour chacun des exemples suivants, entrez la commande sur une seule ligne. Chaque exemple présente la commande sur plus d'une ligne à des fins de clarification.

  • Création d'un gestionnaire de déploiement

    L'exemple suivant utilise le modèle management pour créer un gestionnaire de déploiement appelé Dmgr001. Les ports du gestionnaire de déploiement commencent au port 20000.

    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName Dmgr001
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/management
       -serverType DEPLOYMENT_MANAGER
       -nodeName Dmgr001Node
       -cellName Dmgr001NodeCell
       -hostName localhost
       -isDefault
       -startingPort 20000
    [Windows]
    app_server_root\bin\manageprofiles.bat -create 
       -profileName Dmgr001
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\management
       -serverType DEPLOYMENT_MANAGER
       -nodeName Dmgr001Node
       -cellName Dmgr001NodeCell
       -hostName localhost
       -isDefault
       -startingPort 20000
  • Création d'un agent d'administration

    L'exemple suivant utilise le modèle management pour créer un agent d'administration appelé AdminAgent001. Les ports de l'agent d'administration commencent au port 24000.

    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName AdminAgent001
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/management
       -serverType ADMIN_AGENT
       -nodeName AdminAgent001Node
       -hostName localhost
       -isDefault
       -startingPort 24000
    [Windows]
    app_server_root\bin\manageprofiles.bat -create 
       -profileName AdminAgent001
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\management
       -serverType ADMIN_AGENT
       -nodeName AdminAgent001Node
       -hostName localhost
       -isDefault
       -startingPort 24000
  • Création d'un gestionnaire de travaux

    L'exemple suivant utilise le modèle management pour créer un gestionnaire de travaux appelé JobMgr001. Les ports du gestionnaire de travaux commencent au port 25000.

    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName JobMgr001
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/management
       -serverType JOB_MANAGER
       -nodeName JobMgr001Node
       -cellName JobMgr001NodeCell
       -hostName localhost
       -isDefault
       -startingPort 25000
    [Windows]
    app_server_root\bin\manageprofiles.bat -create 
       -profileName JobMgr001
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\management
       -serverType JOB_MANAGER
       -nodeName JobMgr001Node
       -cellName JobMgr001NodeCell
       -hostName localhost
       -isDefault
       -startingPort 25000
  • Création d'un serveur proxy sécurisé

    L'exemple suivant utilise le modèle secureproxy pour créer un serveur proxy sécurisé appelé SecureProxySrv001. Les ports du proxy sécurisé démarrent au numéro de port 26000.

    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName SecureProxySrv001
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/secureproxy
       -nodeName SecureProxySrv001Node
       -serverName secproxy1
       -hostName localhost
       -isDefault
       -startingPort 26000
    [Windows]
    app_server_root\bin\manageprofiles.bat -create 
       -profileName SecureProxySrv001
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\secureproxy
       -nodeName SecureProxySrv001Node
       -serverName secproxy1
       -hostName localhost
       -isDefault
       -startingPort 26000
  • Création d'un profil personnalisé

    L'exemple ci-après crée un profil personnalisé et le fédère dans la cellule du gestionnaire de déploiement.

    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName Custom01
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/managed
       -nodeName Custom01Node
       -cellName Custom01Cell
       -hostName myhost.mycity.mycompany.com
       -isDefault
       -dmgrHost myhost.mycity.mycompany.com
       -dmgrPort 8879
    [Windows]
    c:\WebSphere\AppServer\bin manageprofiles.bat -create
       -profileName Custom01
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\managed
       -nodeName CustomNode01
       -cellName CustomNodeCell01
       -hostName myhost.mycity.mycompany.com
       -isDefault 
       -dmgrHost myhost.mycity.mycompany.com
       -dmgrPort 8879
  • Création d'un profil de serveur d'applications

    Créez un profil de serveur d'applications appelé Default01 à l'aide de la commande ci-après.

    [Windows]La commande crée également un service Windows pour le serveur d'applications, un certificat de signature racine et un certificat personnel pour le profil, ainsi qu'un mot de passe de fichier de clés pour les deux certificats.
    app_server_root\bin manageprofiles.bat -create 
       -profileName Default01 
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Default01Node
       -cellName Default01Cell
       -hostName myhost.mycity.mycompany.com
       -isDefault 
       -winserviceCheck true
       -winserviceAccountType specifieduser
       -winserviceUserName my_user_id
       -winservicePassword my_password
       -winserviceStartupType manual
       -startingPort 21000
       -personalCertDN "cn=testa, ou=Rochester, o=IBM, c=US"
       -signingCertDN "cn=testc, ou=Rochester, o=IBM, c=US"
       -keyStorePassword ap3n9krw
    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName Default01
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/default
       -nodeName Default01Node
       -cellName Default01Cell
       -hostName myhost.mycity.mycompany.com
       -isDefault
       -startingPort 21000
       -personalCertDN "cn=testa, ou=Rochester, o=IBM, c=US"     
       -signingCertDN "cn=testc, ou=Rochester, o=IBM, c=US"     
       -keyStorePassword ap3n9krw
  • Création d'un profil de cellule
    La création d'un profil de cellule requiert la création de la partie gestionnaire de déploiement et de la partie serveur d'applications du profil de cellule. Les deux profils sont liés et certains paramètres de création utilisés pour la partie gestionnaire de déploiement et pour la partie serveur d'applications du profil de cellule doivent correspondre.
    Important : Dans ces deux parties, vous devez utiliser des valeurs identiques pour les paramètres cellName, nodeName et appServerNodeName. Si vous n'avez pas spécifié les noms de ces paramètres lors de la création de l'étape de gestionnaire de déploiement du profil de cellule, vous devez utiliser le nom par défaut qui a été attribué dans le premier appel de ligne de commande. L'exemple ci-après illustre l'utilisation de valeurs identiques pour ces paramètres dans la partie gestionnaire de déploiement et la partie serveur d'applications du profil de cellule.
    For Dmgr:                       
    -cellName host01Cell01          
    -nodeName host01CellManager01   
    -appServerNodeName host01Node01 
                                    
    For AppServer:                  
    -cellName host01Cell01          
    -nodeName host01CellManager01   
    -appServerNodeName host01Node01 
    L'exemple suivant explique comment créer un profil de cellule appelé Dmgr001 dont le nom de cellule est Default01Cell et le nom de noeud Default01Node. Pour créer une cellule entière opérationnelle, les paramètres -nodeProfilePath, -cellName, -appServerNodeName et -nodeName doivent correspondre entre le profil cell_dmgr et le profil cell_node.
    1. Créez la partie gestionnaire de développement du profil de cellule.
      [Windows]
      app_server_root\bin\manageprofiles.bat -create
         -templatePath app_server_root\profileTemplates\cell\dmgr
         -nodeProfilePath app_server_root\profiles\AppSrv01
         -profileName Dmgr001
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node
      [Linux][HP-UX][Solaris][AIX]
      app_server_root/bin/manageprofiles.sh -create 
         -templatePath app_server_root/profileTemplates/cell/dmgr
         -nodeProfilePath app_server_root/profiles/AppSrv01
         -profileName Dmgr001
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node
    2. Créez la partie serveur d'applications du profil de cellule.
      [Windows]
      app_server_root\bin\manageprofiles.bat -create
         -templatePath app_server_root\profileTemplates\cell\default
         -dmgrProfilePath app_server_root\profiles\Dmgr001
         -portsFile app_server_root\profiles\Dmgr001\properties\portdef.props
         -nodePortsFile app_server_root\profiles\Dmgr001\properties\nodeportdef.props
         -profileName AppSrv01
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node
      [Linux][HP-UX][Solaris][AIX]
      app_server_root/bin/manageprofiles.sh -create
         -templatePath app_server_root/profileTemplates/cell/default
         -dmgrProfilePath app_server_root/profiles/Dmgr001
         -portsFile app_server_root/profiles/Dmgr001/properties/portdef.props
         -nodePortsFile app_server_root/profiles/Dmgr001/properties/nodeportdef.props
         -profileName AppSrv01
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node

Journaux

La commande manageprofiles crée un journal pour chacun des profils qu'elle crée.
  • Les journaux se trouvent dans le répertoire racine_serveur_app/logs/manageprofiles. Les fichiers sont nommés dans ce modèle : nom_profil_create.log.
  • La commande crée également un journal pour chaque profil supprimé. Les journaux se trouvent dans le répertoire racine_serveur_app/logs/manageprofiles. Les fichiers sont nommés dans ce modèle : nom_profil_delete.log.

Exemple : Création de profils de gestionnaire de déploiement

Vous pouvez créer un profil de gestionnaire de déploiement après l'installation des principaux fichiers du produit. Le gestionnaire de déploiement fournit une seule interface d'administration à un groupe logique de serveurs d'applications sur une ou plusieurs machines. Utilisez la commande manageprofiles.sh -create pour créer un profil de gestionnaire de déploiement.

Pour créer un profil de gestionnaire de déploiement appelé shasti :

[AIX][HP-UX][Linux][Solaris]
manageprofiles.sh -create
              -profileName shasti 
              -profilePath /shasti/WebSphere 
              -templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
              -serverType DEPLOYMENT_MANAGER
              -cellName cell1
              -hostName planetaix 
              -nodeName dmgr1
[Windows]
manageprofiles.bat -create
              -profileName shasti 
              -profilePath C:\shasti\WebSphere
              -templatePath C:\IBM\WebSphere\AppServer\profileTemplates\management
              -serverType DEPLOYMENT_MANAGER
              -cellName cell1
              -hostName planetnt
              -nodeName dmgr1
La commande crée un profil de gestionnaire de déploiement appelé shasti dans une cellule appelée cell1 avec le nom de noeud dmgr1 à l'emplacement suivant :
  • [AIX][HP-UX][Linux][Solaris]/shasti/WebSphere
  • [Windows]C:\shasti\WebSphere

Si vous n'indiquez pas l'une des options de port lors de la création du profil, un ensemble de valeurs de port recommandé sera utilisé. L'algorithme de résolution du conflit de ports détermine ces ports. L'ensemble de ports recommandé ne doit rencontrer aucun conflit. Si vous souhaitez utiliser les ports IBM par défaut, utilisez l'option -defaultPorts lorsque vous créez un profil.

Exemple : Incrémentation des numéros de port par défaut à partir d'un point de départ

La commande manageprofiles peut attribuer des numéros de port en fonction d'une valeur de début de port. Vous pouvez fournir la valeur de port de début à partir de la ligne de commande, à l'aide du paramètre -startingPort. La commande affecte des numéros de port en séquence à partir de la valeur de début du numéro de port. Cependant, si une valeur de port dans la séquence est en conflit avec une affectation de port existante, la valeur de port disponible suivante est utilisée.

L'ordre d'affectation des ports est arbitraire. Toute prédiction est impossible.

Par exemple, les ports créés avec le paramètre -startingPort 20002 se présentent de la manière suivante :

Ports affectés à un profil de serveur d'applications
WC_defaulthost=20002
WC_adminhost=20003
WC_defaulthost_secure=20004
WC_adminhost_secure=20005
BOOTSTRAP_ADDRESS=20006
SOAP_CONNECTOR_ADDRESS=20007
IPC_CONNECTOR_ADDRESS=20008
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20009
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20010
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20011
ORB_LISTENER_ADDRESS=20012
DCS_UNICAST_ADDRESS=20013
SIB_ENDPOINT_ADDRESS=20014
SIB_ENDPOINT_SECURE_ADDRESS=20015
SIB_MQ_ENDPOINT_ADDRESS=20016
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20017
SIP_DEFAULTHOST=20018
SIP_DEFAULTHOST_SECURE=20019
OVERLAY_UDP_LISTENER_ADDRESS=20020
OVERLAY_TCP_LISTENER_ADDRESS=20021
Ports affectés à une cellule contenant un profil de serveur d'applications fédéré
WC_defaulthost=20002
WC_defaulthost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
DCS_UNICAST_ADDRESS=20011
SIB_ENDPOINT_ADDRESS=20012
SIB_ENDPOINT_SECURE_ADDRESS=20013
SIB_MQ_ENDPOINT_ADDRESS=20014
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20015
SIP_DEFAULTHOST=20016
SIP_DEFAULTHOST_SECURE=20017
NODE_MULTICAST_DISCOVERY_ADDRESS=20018
NODE_IPV6_MULTICAST_DISCOVERY_ADDRESS=20019
NODE_DISCOVERY_ADDRESS=20020
NODE_DCS_UNICAST_ADDRESS=20021
NODE_BOOTSTRAP_ADDRESS=20022
NODE_SOAP_CONNECTOR_ADDRESS=20023
NODE_ORB_LISTENER_ADDRESS=20024
NODE_SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20025
NODE_CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20026
NODE_CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20027
NODE_IPC_CONNECTOR_ADDRESS=20028
OVERLAY_UDP_LISTENER_ADDRESS=20029
OVERLAY_TCP_LISTENER_ADDRESS=20030
NODE_XDAGENT_PORT=20031
NODE_OVERLAY_UDP_LISTENER_ADDRESS=20032
NODE_OVERLAY_TCP_LISTENER_ADDRESS=20033
Ports affectés à une cellule contenant un profil de gestionnaire de déploiement
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
XDAGENT_PORT=20013
OVERLAY_UDP_LISTENER_ADDRESS=20014
OVERLAY_TCP_LISTENER_ADDRESS=20015
STATUS_LISTENER_ADDRESS=20016
Ports affectés à un profil de gestion contenant un serveur gestionnaire de déploiement
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
DataPowerMgr_inbound_secure=20013
XDAGENT_PORT=20014
OVERLAY_UDP_LISTENER_ADDRESS=20015
OVERLAY_TCP_LISTENER_ADDRESS=20016
STATUS_LISTENER_ADDRESS=20017
Ports affectés à un profil de gestion contenant un serveur gestionnaire de travaux
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
STATUS_LISTENER_ADDRESS=20011
Ports affectés à un profil de gestion contenant un serveur agent d'administration
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
Ports affectés à un profil de proxy sécurisé
PROXY_HTTP_ADDRESS=20002
PROXY_HTTPS_ADDRESS=20003
PROXY_SIP_ADDRESS=20004
PROXY_SIPS_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006

L'exemple suivant utilise le paramètre startingPort de la commande manageprofiles et crée des ports à partir d'une valeur initiale de 20002. Le contenu est indiqué dans l'exemple précédent :

[Windows]
manageprofiles.bat -create
               -profileName shasti 
               -profilePath G:\shasti\WebSphere 
               -templatePath G:\shasti\WebSphere\profileTemplates\default 
               -nodeName W2K03 
               -cellName W2K03_Cell01
               -hostName planetnt 
               -startingPort 20002 
                            
[Linux][HP-UX][Solaris][AIX]
racine_serveur_app/bin/manageprofiles.sh -create
               -profileName shasti 
               -profilePath racine_serveur_app/profiles/shasti 
               -templatePath racine_serveur_app/profileTemplates/default 
               -nodeName W2K03 
               -cellName W2K03_Cell01
               -hostName planetnt 
               -startingPort 20002

Exemple : Création de profils de cellule

Pour créer le profil de cellule en utilisant la commande manageprofiles, vous devez créer à la fois le profil de gestion de cellule pour un serveur de gestionnaire de déploiement et le profil du noeud de cellule en utilisant deux appels de ligne de commande manageprofiles différents. Ces deux profils, ensemble, constituent le profil de la cellule.

Deux modèles, cell_dmgr et cell_node, servent à créer le profil de cellule. Ces modèles sont liés et certains paramètres entre les paramètres de création doivent correspondre d'un modèle à l'autre. Vérifiez que les appels correspondent.

Vous pouvez créer les deux moitiés de la cellule dans n'importe quel ordre, à n'importe quel moment, à partir de la ligne de commande. La meilleure façon consiste cependant à créer d'abord la partie gestionnaire de déploiement du profil. Une fois crée, la cellule contient un gestionnaire de déploiement et un noeud fédéré. La partie gestionnaire de déploiement et la partie noeud se trouvent dans des répertoires séparés.

Pour chacun des deux profils créés, vous pouvez indiquer le chemin d'accès complet vers le profil résultant en utilisant le paramètre -profilePath. Si vous ne définissez pas ce paramètre, la valeur par défaut pour chaque chemin d'accès de profil est basée sur le répertoire racine_serveur_app, le sous-répertoire des profils et le nom du profil.

Les deux modèles qui composent un profil de cellule comptent entre eux des dépendances qui nécessitent que certaines valeurs de paramètre correspondent dans les deux appels de création. Pour créer une cellule de travail complète, les paramètres -nodeProfilePath, -cellName, -appServerNodeName et -nodeName doivent utiliser les mêmes valeurs pour le profil cell_dmgr que pour le profil cell_node. Dans le cas de ports, et plus précisément de ports alloués de façon dynamique, la création de la seconde moitié de la cellule doit faire référence aux ports utilisés dans la première moitié de la cellule. Utilisez les arguments -portsFile et -nodePortsFile avec des références aux fichiers ci-après du profil qui représente la première moitié de la cellule :

[Linux][HP-UX][Solaris][AIX]
  • racine_profil/properties/portdef.props
  • racine_profil/properties/nodeportdef.props
[Windows]
  • racine_profil\properties\portdef.props
  • racine_profil\properties\nodeportdef.props
Cette approche permet de s'assurer que les ports de la seconde moitié de la cellule sont créés avec une corrélation correcte à la première moitié de la cellule.

Pour obtenir une aide détaillée sur la création d'un profil de cellule, utilisez les commandes suivantes :

[Linux][HP-UX][Solaris][AIX]
app_server_root/bin/manageprofiles.sh -create
 -templatePath
app_server_root/profileTemplates/cell/dmgr
 -help 
[Windows]
app_server_root\bin\manageprofiles.bat -create
 -templatePath
app_server_root\profileTemplates\cell\dmgr
 -help

or

[Linux][HP-UX][Solaris][AIX]
app_server_root/bin/manageprofiles.sh -create
 -templatePath
app_server_root/profileTemplates/cell/default
 -help 
[Windows]
app_server_root\bin\manageprofiles.bat -create
 -templatePath 
app_server_root\profileTemplates\cell\default
 -help 

La sortie du paramètre -help définit les paramètres qui sont obligatoires et ceux qui sont facultatifs lors de la création du profil de responsable du déploiement de cellule et du profil de noeud de cellule.

L'exemple suivant crée un profil de cellule nommé Dmgr001 ayant Default01Cell comme nom de cellule et Default01Node comme nom de noeud.
  1. Vérifiez que le chemin suivant est disponible :

    Le chemin doit être disponible lorsque vous créez les parties gestionnaire de déploiement et noeud de la cellule à mesure que des sous-répertoires sont ajoutés pour chaque partie.

    • [Linux][HP-UX][Solaris][AIX]racine_serveur_app/profiles
    • [Windows]racine_serveur_app\profiles
  2. Créez la partie gestionnaire de développement du profil de cellule.
    [Linux][HP-UX][Solaris][AIX]
    app_server_root/bin/manageprofiles.sh -create 
     -templatePath 
    app_server_root/profileTemplates/cell/dmgr 
     -nodeProfilePath 
    app_server_root/profiles/AppSrv01 
     -profileName Dmgr001 
     -cellName Default01Cell 
     -nodeName Default01Node 
     -appServerNodeName federated_node_name
    [Windows]
    app_server_root\bin\manageprofiles.bat -create 
     -templatePath 
    app_server_root\profileTemplates\cell\dmgr 
     -nodeProfilePath 
    app_server_root\profiles\AppSrv01 
     -profileName Dmgr001 
     -cellName Default01Cell 
     -nodeName Default01Node 
     -appServerNodeName federated_node_name
  3. Vérifiez que le profil Dmgr001 existe avant la création de la partie serveur d'applications du profil de cellule.
  4. Créez la partie serveur d'applications du profil de cellule.
    Important : Les valeurs des paramètres cellName, nodeName et appServerNodeName doivent être identiques à celles utilisées dans la partie du gestionnaire de déploiement du profil de cellule. L'exemple ci-après illustre l'utilisation de valeurs identiques pour les paramètres cellName, nodeName et appServerNodeName sont identiques dans la partie du gestionnaire de déploiement et dans la partie du serveur d'applications du profil de la cellule.
    For Dmgr:                       
    -cellName host01Cell01          
    -nodeName host01CellManager01   
    -appServerNodeName host01Node01 
                                    
    For AppServer:                  
    -cellName host01Cell01          
    -nodeName host01CellManager01   
    -appServerNodeName host01Node01 
    Si vous n'avez pas spécifié les noms de ces paramètres lors de la création de l'étape de gestionnaire de déploiement du profil de cellule, vous devez utiliser le nom par défaut qui a été attribué dans le premier appel de ligne de commande.
    [Linux][HP-UX][Solaris][AIX]
    app_server_root/bin/manageprofiles.sh -create 
     -templatePath 
    app_server_root/profileTemplates/cell/default 
     -dmgrProfilePath 
    app_server_root/profiles/Dmgr001 
     -portsFile 
    app_server_root/profiles/Dmgr001/properties/portdef.props 
     -nodePortsFile 
    app_server_root/profiles/Dmgr001/properties/nodeportdef.props 
     -profileName AppSrv01 
     -cellName Default01Cell 
     -nodeName Default01Node 
     -appServerNodeName federated_node_name
    [Windows]
    app_server_root\bin\manageprofiles.bat -create 
     -templatePath 
    app_server_root\profileTemplates\cell\default 
     -dmgrProfilePath 
    app_server_root\profiles\Dmgr001 
     -portsFile 
    app_server_root\profiles\Dmgr001\properties\portdef.props 
     -nodePortsFile 
    app_server_root\profiles\Dmgr001\properties\nodeportdef.props 
     -profileName AppSrv01 
     -cellName Default01Cell 
     -nodeName Default01Node 
     -appServerNodeName federated_node_name

Après la création des parties gestionnaire de déploiement et noeud du profil de cellule, une synchronisation entre les deux serveurs doit avoir lieu. Par défaut, la synchronisation se produit automatiquement entre les deux serveurs à un intervalle spécifié. Cependant, si la synchronisation est désactivée, que l'intervalle est trop long ou qu'un incident empêchant la survenance de la synchronisation dans les délais se produit, exécutez la commande syncNode pour synchroniser le gestionnaire de déploiement et le noeud.

Vous devez utiliser le paramètre portsFile ou le paramètre nodePortsFile, et le paramètre startingPort ou nodeStartingPort.

Si vous utilisez la commande manageprofiles, vous pouvez choisir le profil qui sera le profil par défaut.

Si vous fédérez un noeud de serveur d'applications dans le cadre de la création du profil de cellule, à l'aide du paramètre -appServerNodeName, le noeud ne dispose pas d'une configuration d'origine. Si vous utilisez la commande -removeNode sur un noeud qui a été généré lors de la création du profil de cellule, la commande indique que l'utilitaire de suppression de noeud ne peut pas supprimer le noeud et restaure le noeud vers une configuration de base. Pour supprimer un noeud qui a été fédéré dans le cadre de la création du profil de cellule, utilisez la commande manageprofiles pour supprimer le profil du noeud. Une fois le profil du noeud supprimé, utilisez la commande -cleanupNode du gestionnaire de déploiement pour supprimer la configuration du noeud du référentiel de cellule. Il est possible de créer un nouveau profil à l'aide de l'outil de gestion de profil ou de la commande manageprofiles.

Exemple : Utilisation des numéros de port prédéfinis

La commande manageprofiles recommande les valeurs de port initiales lorsque vous ne définissez pas explicitement les valeurs de port. En revanche, vous pouvez utiliser les valeurs de port prédéfinies.

La commande manageprofiles recommande les valeurs de port lorsque les options -defaultPorts, -startingPort ou -portsFile ne sont pas spécifiées.
Tableau 1. Adresses de fichier des valeurs de port par défaut..

Le tableau ci-dessous contient les adresses de fichier des valeurs de port par défaut par type de profil.

Profil Chemin
Serveur d'applications racine_serveur_app/profileTemplates/default/actions/portsUpdate/portdef.props
Cellule - Partie serveur d'applications racine_serveur_app/profileTemplates/cell/dmgr/actions/portsUpdate/nodeportdef.props
Cellule - Partie gestionnaire de déploiement racine_serveur_app/profileTemplates/cell/dmgr/actions/portsUpdate/portdef.props
Personnalisé racine_serveur_app/profileTemplates/managed/actions/portsUpdate/portdef.props
Profil de gestion pour un serveur du gestionnaire de déploiement racine_serveur_app/profileTemplates/management/actions/portsUpdate/dmgr.portdef.props
Profil de gestion pour un serveur d'agent d'administration racine_serveur_app/profileTemplates/management/actions/portsUpdate/adminagent.portdef.props
Profil de gestion pour un serveur de gestionnaire de travaux racine_serveur_app/profileTemplates/management/actions/portsUpdate/jmgr.portdef.props
Proxy sécurisé racine_serveur_app/profileTemplates/secureproxy/actions/portsUpdate/portdef.props
Pour personnaliser les valeurs de port dans le fichier portdef.props avant la création de votre profil, procédez comme suit : l'exemple suivant crée le profil par défaut. Pour les autres types de profils, vous devez remplacer le chemin par celui du profil que vous souhaitez créer.
  1. Copiez le fichier racine_serveur_app/profileTemplates/par_défaut/actions/portsUpdate/portdef.props à partir du chemin du modèle de profil par défaut et placez une copie du fichier dans un répertoire temporaire tel que :
    • [Windows]c:\temp\ports
    • [AIX HP-UX Solaris]/temp/ports
  2. Dans le nouveau fichier, modifiez les paramètres de port afin de spécifier vos valeurs de port.
  3. Créez votre profil à l'aide de la commande manageprofiles. Utilisez les valeurs de port modifiées. Indiquez l'emplacement de votre fichier portdef.props modifié via le paramètre -portsFile. Spécifiez le paramètre -validatePorts pour vous assurer que les ports ne sont ni réservés, ni en cours d'utilisation. Guidez-vous avec l'exemple qui suit :
    [Windows]
    manageprofiles.bat 
       -create
       -profileName Wow_Profile 
       -profilePath profile_root 
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Wow_node 
       -cellName Wow_cell
       -hostName lorriemb 
       -portsFile C:\temp\ports\portdef.props
       -validatePorts 
    [AIX][Linux]
    manageprofiles.sh 
       -create
       -profileName Wow_Profile 
       -profilePath profile_root 
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Wow_node 
       -cellName Wow_cell
       -hostName lorriemb 
       -portsFile \temp\ports\portdef.props
       -validatePorts
Imaginez que le fichier portdef.props possède les valeurs suivantes :
WC_defaulthost=39080
WC_adminhost=39060
WC_defaulthost_secure=39443
WC_adminhost_secure=39043
BOOTSTRAP_ADDRESS=32809
SOAP_CONNECTOR_ADDRESS=38880
IPC_CONNECTOR_ADDRESS=39633
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=39401
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=39403
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=39402
ORB_LISTENER_ADDRESS=39100
DCS_UNICAST_ADDRESS=39353
SIB_ENDPOINT_ADDRESS=37276
SIB_ENDPOINT_SECURE_ADDRESS=37286
SIB_MQ_ENDPOINT_ADDRESS=35558
SIB_MQ_ENDPOINT_SECURE_ADDRESS=35578
SIP_DEFAULTHOST=35060
SIP_DEFAULTHOST_SECURE=35061
OVERLAY_UDP_LISTENER_ADDRESS=35062
OVERLAY_TCP_LISTENER_ADDRESS=35063
STATUS_LISTENER_ADDRESS=35064

Une fois que vous avez exécuté la commande manageprofiles pour créer votre profil à l'aide des valeurs de port définies par l'utilisateur, le système vous indique si l'opération a réussi ou échoué.

La commande manageprofiles crée une copie du fichier portdefs.props actuel dans le répertoire racine_profil\properties.

N'utilisez qu'un seul de ces trois paramètres de valeur de port, -startingPort, -defaultPorts, ou -portsFile avec la commande manageprofiles. Les trois paramètres sont mutuellement exclusifs.


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rxml_manageprofiles
Nom du fichier : rxml_manageprofiles.html