[AIX Solaris HP-UX Linux Windows][IBM i]

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.

[AIX Solaris HP-UX Linux Windows]La seule façon de créer des environnements d'exécution consiste à utiliser la commande manageprofiles et son interface graphique, l'outil de gestion des profils.

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

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

Syntaxe

La commande manageprofiles permet d'effectuer les tâches suivantes :
  • créer un profil (-create)
  • supprimer un profil (-delete)
  • effectuer l'extension d'un profil (-augment)
  • réduire un profil (-unaugment)
  • réduire tous les profils étendus avec un modèle d'extension déterminé (-unaugmentAll)
  • supprimer tous les profils (-deleteAll)
  • afficher la liste de tous les profils (-listProfiles)
  • répertorier les extensions d'un profil (-listAugments)
  • extraire un nom de profil (-getName)
  • extraire un chemin d'accès à un profil (-getPath)
  • valider un registre de profils (-validateRegistry)
  • valider et mettre à jour un registre de profils (-validateAndUpdateRegistry)
  • extraire le nom du profil par défaut (-getDefaultName)
  • sauvegarder un profil (-backupProfile)
  • restaurer un profil (-restoreProfile)
  • effectuer les tâches de commande manageprofiles contenues dans un fichier de réponses (-response)
Pour obtenir une aide plus détaillée, y compris sur les paramètres obligatoires pour chacune des tâches accomplies à l'aide de la commande manageprofiles, utilisez le paramètre -help. L'exemple suivant utilise le paramètre d'aide avec la commande manageprofiles -augment sur des systèmes d'exploitation Windows :
app_server_root\bin\manageprofiles.bat -augment -help
Selon l'opération que vous désirez exécuter à l'aide de la commande manageprofiles, vous devez indiquer un ou plusieurs des paramètres suivants. L'outil de ligne de commande vérifie que les paramètres obligatoires sont fournis et que les valeurs saisies pour ces paramètres sont valides. Veillez à entrer le nom des paramètres en respectant les majuscules et les minuscules car l'outil de ligne de commande ne valide pas la casse des noms de paramètres. Si la casse n'est pas respectée lors de la saisie des noms de paramètres, des résultats incorrects peuvent être produits.
  • -adminPassword motdepasseAdmin
  • -adminUserName ID_utilisateurAdmin
  • -applyPerfTuningSetting standard | peak | development
  • -augment
  • -backupFile nom_fichierSauvegarde
  • -backupProfile
  • -cellName nom_cellule (Paramètre optionnel)
  • -create
  • -debug
  • -defaultPorts
  • -delete
  • -deleteAll
  • -enableAdminSecurity true | false
  • [Linux]-enableService 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
  • -nodeName nom_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
  • -serverName nom_serveur
  • -serverType ADMIN_AGENT
  • [Linux]-serviceUserName ID_utilisateur_service
  • -setDefaultName
  • -signingCertDN nom_distinctif
  • -signingCertValidityPeriod période_validité (Paramètre optionnel)
  • -startingPort port_début | -portsFile chemin_profil | -defaultPorts
  • -templatePath chemin_modèle
  • -unaugment
  • -unaugmentAll
  • -unaugmentDependents
  • -validateAndUpdateRegistry
  • -validatePorts
  • -validateRegistry
  • -webServerCheck true | false
  • -webServerHostnamenom_hôte_serveurweb
  • -webServerInstallPath nom_cheminInstall_serveurweb
  • -webServerName nom_serveurweb
  • -webServerOS système_exploitation_serveurweb
  • -webServerPluginPath chemin_plugin_serveurweb
  • -webServerPort port_serveurweb
  • -webServerType type_serveurweb
  • [Windows]-winserviceAccountType specifieduser | localsystem
  • [Windows]-winserviceCheck true | false
  • [Windows]-winservicePassword motdepasse_winservice
  • [Windows]-winserviceStartupType manual | automatic | disabled
  • [Windows]-winserviceUserName D_utilisateur_winservice

L'exemple suivant utilise la commande manageprofiles -create sur des systèmes d'exploitation tels que AIX ou Linux :
app_server_root/bin/manageprofiles.sh -create 
   -profileName profile_name 
   -profilePath profile_root 
   -templatePath template_path 

Paramètres

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

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

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

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

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

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

-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 de base 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.

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

Voir également le paramètre -unaugment.

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

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

-cellName nom_cellule (Paramètre optionnel)
Spécifie le nom de cellule du profil. Utilisez un nom de cellule unique pour chaque profil.
Eviter les incidents Eviter les incidents: Les noms de cellule doivent être uniques. Si des noms de cellule sont en double, des problèmes peuvent se produire au niveau des communications distantes entre les cellules, par exemple, lors des appels Enterprise JavaBeans distants.gotcha

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

[AIX Solaris HP-UX Linux Windows]La valeur par défaut de ce paramètre est basée sur une combinaison formée du nom d'hôte abrégé, de la cellule constante et d'un numéro de lecture fin de ligne :
  • Profil de serveur d'applications : Aucun
  • Profil de gestion avec le serveur agent d'administration : nomabrégéHôteAACellNuméroCellule
où NuméroCellule est un numéro séquentiel commençant à 01.
[IBM i]Les noms de noeud par défaut sont les suivants :
  • Modèle par défaut : nomabrégéHôte_nomduprofil.
  • Modèle géré : nomabrégéHôte_nomduprofil.

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 :
  • management - Gestion. A utiliser conjointement avec le paramètre -serverType pour indiquer le type de profil de gestion.
  • par défaut - Serveur d'applications
-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.

[AIX Solaris HP-UX Linux Windows]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.

[AIX Solaris HP-UX Linux Windows]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.

[IBM i]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.

-deleteAll
Supprime tous les profils enregistrés.

[AIX Solaris HP-UX Linux Windows]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.

[AIX Solaris HP-UX Linux Windows]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.

[IBM i]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.

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

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

-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.
-nodeName nom_noeud
Indique le nom du noeud créé avec le nouveau profil. Utilisez une valeur unique sur la machine. Chaque profil qui partage le même ensemble de binaires de produit doivent posséder un nom de noeud unique.
[AIX Solaris HP-UX Linux Windows]La valeur par défaut de ce paramètre est basée sur le nom d'hôte abrégé, le type de profil et un numéro de lecture fin de ligne :
  • Profil de serveur d'applications : nomabrégéHôteNodeNuméroNoeud
  • Profil de gestion avec le serveur agent d'administration : nomabrégéHôteAANodeNuméroCellule
où NuméroNoeud est un numéro séquentiel commençant à 01.
[IBM i]Les noms de noeud par défaut suivants sont disponibles :
  • 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.

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

-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 l'agent d'administration
    • deployAdminConsole
-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>
où
  • <type_profil> est une valeur telle qu'AppSrv ou AdminAgent
  • <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.

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

[AIX Solaris HP-UX Linux Windows]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.

[IBM i]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.

[AIX Solaris HP-UX Linux Windows]Vous devez disposer des autorisations nécessaires pour écrire dans le répertoire.

[IBM i]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.
  • [Windows]Dans un système d'exploitation Windows, l'instruction de chemin peut utiliser des barres obliques (/) ou des barres obliques inverses (\). Si l'instruction de chemin utilise des barres obliques inverses, le fichier de réponses a besoin de barres obliques inverses doubles pour comprendre correctement le chemin. Voici un exemple de fichier de réponses pour une opération de création qui utilise des barres obliques inverses doubles :
    create
    templatePath=C:\\WebSphere\\AppServer\\profileTemplates\\default
    Pratiques recommandées Pratiques recommandées: Utilisez des barres obliques (/) afin de réduire le risque d'erreur lors de la commutation entre plateformes.bprac
-restoreProfile
Important : La commande manageProfiles -restoreProfile n'est prise en charge qu'avec les sauvegardes créées avec le même niveau de groupe de correctifs.
Restaure la sauvegarde d'un profil. Doit s'utiliser avec le paramètre -backupFile, par exemple :
manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name
Pour restaurer un profil, procédez comme suit :
  1. Arrêtez le serveur et les processus en cours du profil à restaurer.
  2. Supprimez manuellement le répertoire du profil dans le système de fichiers.
  3. Exécutez l'option -validateAndUpdateRegistry de la commande manageprofiles.
  4. Restaurez le profil à l'aide de l'option -restoreProfile de la commande manageprofiles.
-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 ADMIN_AGENT
Indique le type de profil de gestion. Spécifiez ADMIN_AGENT pour un serveur d'agent d'administration. Ce paramètre est obligatoire lorsque vous créez un profil de gestion.
[Linux]-serviceUserName ID_utilisateur_service
[Linux]Indique l'ID utilisateur entré lors de la création du service Linux afin que le service Linux s'exécute sous cet ID utilisateur. Le service Linux s'exécute chaque fois que cet ID utilisateur est connecté.
-setDefaultName
Définit le profil par défaut sur l'un des profils existants. Doit s'utiliser avec le paramètre -profileName, par exemple :
manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name
-signingCertDN nom_distinctif
Indique le nom distinctif du certificat signataire racine que vous établissez lors de la création du profil. Placez ce nom distinctif entre guillemets. Le certificat personnel par défaut se trouve dans le fichier de clés du serveur. Les paramètres -importSigningCertKS et -signingCertDN sont mutuellement exclusifs. Si vous ne créez pas ou n'importez pas spécifiquement de certificat signataire racine, le système en crée un par défaut. Voir les paramètres -signingCertValidityPeriod et -keyStorePassword.
-signingCertValidityPeriod période_validité (Paramètre optionnel)
Paramètre facultatif indiquant, en années, la durée de validité du certificat de signature racine. Si vous n'indiquez pas ce paramètre avec le paramètre -signingCertDN, le certificat de signature racine est valide pendant 15 ans.
-startingPort port_début
Indique le numéro de port de début pour la génération et l'affectation de tous les ports du profil.

[AIX Solaris HP-UX Linux Windows]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.

[IBM i]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é.
-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.

[AIX Solaris HP-UX Linux Windows]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

[IBM i]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.

[AIX Solaris HP-UX Linux Windows]Lors de l'utilisation du paramètre -templatePath, définissez le chemin de fichier complet pour le paramètre.

[IBM i]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.

[AIX Solaris HP-UX Linux Windows]Lors de l'utilisation du paramètre -templatePath, définissez le chemin de fichier complet pour le paramètre.

[IBM i]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 :
[Windows]
webServerType=IHS: webServerInstallPath defaulted to “C:\Program Files\IBM\HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “C:\”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “C:\”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[Linux]
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[AIX]
webServerType=IHS: webServerInstallPath defaulted to “/usr/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “?”
webServerType=APACHE: webServerInstallPath defaulted to “?”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[HP-UX]
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[Solaris]
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[IBM i]
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.
[Windows]-winserviceAccountType specifieduser | localsystem
[Windows]Type du compte propriétaire du service Windows créé pour le profil. Les valeurs valides sont specifieduser ou localsystem. La valeur localsystem exécute le service Windows sous le compte local du propriétaire qui crée le profil. La valeur par défaut de ce paramètre est localsystem.

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

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

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

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

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

Scénario d'utilisation

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

  • Création d'un profil de serveur d'applications

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

    [Windows]La commande crée également un service Windows pour le serveur d'applications, un certificat de signature racine et un certificat personnel pour le profil, ainsi qu'un mot de passe de fichier de clés pour les deux certificats.
    app_server_root\bin manageprofiles.bat -create 
       -profileName Default01 
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Default01Node
       -cellName Default01Cell
       -hostName myhost.mycity.mycompany.com
       -isDefault 
       -winserviceCheck true
       -winserviceAccountType specifieduser
       -winserviceUserName my_user_id
       -winservicePassword my_password
       -winserviceStartupType manual
       -startingPort 21000
       -personalCertDN "cn=testa, ou=Rochester, o=IBM, c=US"
       -signingCertDN "cn=testc, ou=Rochester, o=IBM, c=US"
       -keyStorePassword ap3n9krw
    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName Default01
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/default
       -nodeName Default01Node
       -cellName Default01Cell
       -hostName myhost.mycity.mycompany.com
       -isDefault
       -startingPort 21000
       -personalCertDN "cn=testa, ou=Rochester, o=IBM, c=US"     
       -signingCertDN "cn=testc, ou=Rochester, o=IBM, c=US"     
       -keyStorePassword ap3n9krw
    [IBM i]
    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

Journaux

La commande manageprofiles crée un journal pour chacun des profils qu'elle crée.
  • [AIX Solaris HP-UX Linux Windows]Les journaux se trouvent dans le répertoire racine_serveur_app/logs/manageprofiles. Les fichiers sont nommés dans ce modèle : nom_profil_create.log.
  • [AIX Solaris HP-UX Linux Windows]La commande crée également un journal pour chaque profil supprimé. Les journaux se trouvent dans le répertoire racine_serveur_app/logs/manageprofiles. Les fichiers sont nommés dans ce modèle : nom_profil_delete.log.
  • [IBM i]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.
  • [IBM i]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 : 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

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

[Windows]
manageprofiles.bat -create
               -profileName shasti 
               -profilePath G:\shasti\WebSphere 
               -templatePath G:\shasti\WebSphere\profileTemplates\default 
               -nodeName W2K03 
               -cellName W2K03_Cell01
               -hostName planetnt 
               -startingPort 20002 
                            
[Linux][HP-UX][Solaris][AIX]
racine_serveur_app/bin/manageprofiles.sh -create
               -profileName shasti 
               -profilePath racine_serveur_app/profiles/shasti 
               -templatePath racine_serveur_app/profileTemplates/default 
               -nodeName W2K03 
               -cellName W2K03_Cell01
               -hostName planetnt 
               -startingPort 20002
[IBM i]
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 : 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
Profil de gestion pour un serveur d'agent d'administration racine_serveur_app/profileTemplates/management/actions/portsUpdate/adminagent.portdef.props
Pour personnaliser les valeurs de port dans le fichier portdef.props avant la création de votre profil, procédez comme suit : l'exemple suivant crée le profil par défaut. Pour les autres types de profils, vous devez remplacer le chemin par celui du profil que vous souhaitez créer.
  1. Copiez le fichier racine_serveur_app/profileTemplates/par_défaut/actions/portsUpdate/portdef.props à partir du chemin du modèle de profil par défaut et placez une copie du fichier dans un répertoire temporaire tel que :
    • [Windows]c:\temp\ports
    • [AIX HP-UX Solaris][IBM i]/temp/ports
  2. Dans le nouveau fichier, modifiez les paramètres de port afin de spécifier vos valeurs de port.
  3. Créez votre profil à l'aide de la commande manageprofiles. Utilisez les valeurs de port modifiées. Indiquez l'emplacement de votre fichier portdef.props modifié via le paramètre -portsFile. Spécifiez le paramètre -validatePorts pour vous assurer que les ports ne sont ni réservés, ni en cours d'utilisation. Guidez-vous avec l'exemple qui suit :
    [Windows]
    manageprofiles.bat 
       -create
       -profileName Wow_Profile 
       -profilePath profile_root 
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Wow_node 
       -cellName Wow_cell
       -hostName lorriemb 
       -portsFile C:\temp\ports\portdef.props
       -validatePorts 
    [AIX][Linux]
    manageprofiles.sh 
       -create
       -profileName Wow_Profile 
       -profilePath profile_root 
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Wow_node 
       -cellName Wow_cell
       -hostName lorriemb 
       -portsFile \temp\ports\portdef.props
       -validatePorts
    [IBM i]
    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

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