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.

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
  • -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
  • -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
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.

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é.

Les noms de noeud par défaut sont les suivants :
  • Modèle dmgr : nomduprofilNetwork
  • Modèle par défaut : nomabrégéHôte_nomduprofil.
  • Modèle géré : nomabrégéHôte_nomduprofil.
  • Modèle de cellule (cell) : identique au modèle dmgr précédent pour les deux profils créés.

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.

Le répertoire des profils est supprimé lorsque vous supprimez le profil, de sorte que vous puissiez recréer le profil sans avoir à supprimer manuellement le répertoire.

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.

Le répertoire du profil est supprimé lorsque vous supprimez le profil de sorte que, lorsque vous re-créez le profil, vous n'ayez pas à gérer des informations obsolètes.

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é.

-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.
Les noms de noeud par défaut suivants sont disponibles :
  • Modèle de gestion (management) pour le gestionnaire de déploiement, l'agent d'administration ou le gestionnaire de travaux : nomduprofilManager.
  • Modèle par défaut : nomabrégéHôte_nomduprofil.
  • Modèle géré : nomabrégéHôte_nomduprofil.
  • Cellule : reportez-vous aux exemples précédents de modèles de gestion et de modèles par défaut et appliquez-les comme il convient aux deux profils créés.
  • Modèle de serveur proxy (secureproxy) : nomabrégéHôte_nomduprofil.

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

La valeur par défaut est basée sur le répertoire racine_données_utilisateur, 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.

Le profil QEJBSVR doit 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.
-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.
-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.

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.
Le chemin de modèle par défaut est racine_serveur_app/profileTemplates/default. Vous pouvez utiliser un chemin relatif pour le paramètre -templatePath. Le chemin est relatif au répertoire de travail en cours ou à racine_serveur_app/profileTemplates, dans cet ordre. L'exemple suivant crée un profil basé sur la valeur par défaut d'un serveur d'applications autonome :
manageprofiles -create -profileName MyProfile -startingPort 10380

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, vous pouvez indiquer un chemin de fichier relatif 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, vous pouvez indiquer un chemin de fichier relatif 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 :
webServerType=IHS: webServerInstallPath defaulted to “n\a”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “n\a”
webServerType=DOMINO: webServerInstallPath defaulted to “n\a”
webServerType=APACHE: webServerInstallPath defaulted to “n\a”
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.

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.

    manageprofiles -create 
       -profileName Dmgr001
       -profilePath profile_root
       -templatePath management
       -serverType DEPLOYMENT_MANAGER
       -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.

    manageprofiles -create 
       -profileName AdminAgent001
       -profilePath profile_root
       -templatePath management
       -serverType ADMIN_AGENT
       -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.

    manageprofiles -create 
       -profileName JobMgr001
       -profilePath profile_root
       -templatePath management
       -serverType JOB_MANAGER
       -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.

    manageprofiles -create 
       -profileName SecureProxySrv001
       -profilePath profile_root
       -templatePath secureproxy
       -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.

    manageprofiles -create 
       -profileName Custom01 
       -templatePath managed 
       -startingPort 22000
       -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.

    manageprofiles -create 
       -profileName Default01 
       -templatePath default 
       -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.
      app_server_root/bin/manageprofiles -create 
         -templatePath app_server_root/profileTemplates/cell/dmgr
         -nodeProfilePath user_data_root/profiles/AppSrv01
         -profileName Dmgr001
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node
    2. Créez la partie serveur d'applications du profil de cellule.
      app_server_root/bin/manageprofiles -create
         -templatePath app_server_root/profileTemplates/cell/default
         -dmgrProfilePath user_data_root/profiles/Dmgr001
         -portsFile user_data_root/profiles/Dmgr001/properties/portdef.props
         -nodePortsFile user_data_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_données_utilisateur/profileRegistry/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_données_utilisateur/profileRegistry/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 :

manageprofiles -create
              -profileName shasti 
              -profilePath /shasti/WebSphere 
              -templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
              -serverType DEPLOYMENT_MANAGER
              -cellName cell1
              -hostName planetaix 
              -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 :
  • /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 :

racine_serveur_app/bin/manageprofiles -create
               -profileName shasti 
               -profilePath racine_données_utilisateur/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, 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 :

  • 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 :

app_server_root/bin/manageprofiles -create
 -templatePath
app_server_root/profileTemplates/cell/dmgr
 -help 

or

app_server_root/bin/manageprofiles -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.

    • racine_serveur_app/profiles
  2. Créez la partie gestionnaire de développement du profil de cellule.
    app_server_root/bin/manageprofiles -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.
    app_server_root/bin/manageprofiles -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.

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 :
    • /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 :
    manageprofiles 
       -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é.

Remarque : Une fois qu'un profil a été créé, la console affiche un message indiquant que la création a abouti et vous recommande de consulter le fichier AboutThisProfile.txt. Toutefois, aucun fichier AboutThisProfile.txt n'est généré lorsque vous créez un profil client ou un profil de plug-ins sous IBM i.

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-iseries&topic=rxml_manageprofiles
Nom du fichier : rxml_manageprofiles.html