![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
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.
Syntaxe
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.
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 :
- Définit le mot de passe de l'ID utilisateur pour la sécurité administrative défini à l'aide du paramètre -adminUserName.
- Définit l'ID utilisateur utilisé pour la sécurité administrative.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Spécifie le nom de cellule du profil. Utilisez un nom de cellule unique pour chaque profil.
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 :
Les noms de noeud par défaut sont les suivants :
La valeur de ce paramètre ne doit contenir aucun espace ou caractère non valide tel que *, ?, ", <, >, ,, /, \, |, etc.
- 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 :
- Active la fonction de débogage de l'utilitaire Ant que la commande manageprofiles utilise.
- 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.
- 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é. - 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.
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: 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
- 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.
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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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é.
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.
- 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.
- Renvoie le nom du profil par défaut.
- Extrait l'emplacement du système de fichiers pour un profil du nom indiqué. Nécessite le paramètre –profileName.
- Obtient le nom d'un profil enregistré à un paramètre -profilePath donné.
- Affiche la syntaxe de commande.
- 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.
- 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.
- 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.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.
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
Si vous définissez l'un des paramètres qui commencent par -importPersonal, vous devez les indiquer tous.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Répertorie les profils qui se trouvent dans le registre des profils.
- 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.
- 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 :
Les noms de noeud par défaut suivants sont disponibles :
La valeur de ce paramètre ne doit contenir aucun espace ou caractère non valide tel que *, ?, ", <, >, ,, /, \, |, etc.
- 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.
- 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.
- 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 :
- 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.
- 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.
- 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 :
où<profile_type><profile_number>
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é.
- 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
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.
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 :
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.WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName
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.
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.
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.
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: 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
- 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.
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: Utilisez des barres obliques (/) afin de réduire le risque d'erreur lors de la commutation entre plateformes.bprac
- 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.
- 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 : - 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é.
- 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é.
- 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.
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é.
- 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
- 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.
- 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.
- 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.
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é. - Indique les protocoles valides permettant au serveur proxy sécurisé de traiter les demandes. Les valeurs valides sont SIP, HTTP et HTTP,SIP.
- 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
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.
- 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.
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.
- 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.
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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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 “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”
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
webServerType=IHS: webServerInstallPath defaulted to “/usr/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “?” webServerType=APACHE: webServerInstallPath defaulted to “?” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
webServerType=IHS: webServerInstallPath defaulted to “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”
- Nom du serveur Web. La valeur par défaut de ce paramètre est webserver1.
- 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.
- 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.
- Indique le port qui sera utilisé pour accéder au serveur Web. La valeur par défaut de ce paramètre est 80.
- 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.
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.
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 .Indiquez le mot de passe pour l'utilisateur spécifié ou le compte local auquel doit appartenir le service Windows.
Les valeurs possibles sont les suivantes :
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.
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 :
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.
Journaux
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]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
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]](../images/windows.gif)
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
![[IBM i]](../images/iseries.gif)
manageprofiles -create
-profileName shasti
-profilePath /shasti/WebSphere
-templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
-serverType DEPLOYMENT_MANAGER
-cellName cell1
-hostName planetaix
-nodeName dmgr1
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 :
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
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
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
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
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
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
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]](../images/windows.gif)
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]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
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
![[IBM i]](../images/iseries.gif)
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 racine_serveur_app, le sous-répertoire des profils et le nom du profil.
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 :
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[IBM i]](../images/iseries.gif)
![[Windows]](../images/windows.gif)
Pour obtenir une aide détaillée sur la création d'un profil de cellule, utilisez les commandes suivantes :
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
app_server_root/bin/manageprofiles.sh -create
-templatePath
app_server_root/profileTemplates/cell/dmgr
-help
![[Windows]](../images/windows.gif)
app_server_root\bin\manageprofiles.bat -create
-templatePath
app_server_root\profileTemplates\cell\dmgr
-help
![[IBM i]](../images/iseries.gif)
app_server_root/bin/manageprofiles -create
-templatePath
app_server_root/profileTemplates/cell/dmgr
-help
or
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
app_server_root/bin/manageprofiles.sh -create
-templatePath
app_server_root/profileTemplates/cell/default
-help
![[Windows]](../images/windows.gif)
app_server_root\bin\manageprofiles.bat -create
-templatePath
app_server_root\profileTemplates\cell\default
-help
![[IBM i]](../images/iseries.gif)
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.
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.
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 |
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é.
![[IBM i]](../images/iseries.gif)
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.