Vous pouvez utiliser des fichiers de propriétés pour créer, modifier ou supprimer
des propriétés de plug-in de serveur Web et des propriétés personnalisées.
Avant de commencer
Déterminez la nature des changements à apporter à votre configuration
de propriétés de plug-in ou à ses objets de configuration.
Démarrez l'outil de scriptage wsadmin. Pour démarrer wsadmin à l'aide du langage Jython, exécutez la commande wsadmin -lang jython du répertoire bin
du profil de serveur.
Pourquoi et quand exécuter cette tâche
A l'aide d'un fichier de propriétés, vous pouvez créer, modifier ou supprimer
un objet de plug-in. Vous pouvez également créer, modifier ou supprimer des propriétés
personnalisées de plug-in.
Exécutez des commandes d'administration à l'aide de wsadmin pour modifier
un fichier de propriétés pour un plug-in, valider les propriétés et les appliquer
à votre configuration.
Tableau 1. Actions associées aux fichiers de propriétés de plug-in. Vous pouvez
modifier et supprimer des objets de plug-in.Action |
Procédure |
création |
Non applicable |
modify |
Modifiez les propriétés et exécutez la commande applyConfigProperties
pour modifier la valeur d'une propriété personnalisée. |
suppression |
Exécutez la commande deleteConfigProperties pour supprimer
une propriété. Si la propriété supprimée comporte une valeur par défaut, la propriété
est définie sur la valeur par défaut. |
création d'une propriété |
Non applicable |
suppression d'une propriété |
Non applicable |
Tableau 2. Actions associées
aux propriétés personnalisées de plug-in. Vous pouvez créer, modifier et
supprimer des propriétés personnalisées de plug-in.Action |
Procédure |
création |
Non applicable |
modify |
Modifiez les propriétés et exécutez la commande applyConfigProperties
pour modifier la valeur d'une propriété personnalisée existante. |
suppression |
Non applicable |
création d'une propriété |
Paramétrez les propriétés et exécutez la commande applyConfigProperties
pour créer une propriété personnalisée. |
suppression d'une propriété |
Définissez les propriétés à supprimer dans le fichier de propriétés
et exécutez la commande deleteConfigProperties pour supprimer une
propriété personnalisée existante. Le fichier de propriétés ne doit contenir que
les propriétés à supprimer. |
Vous pouvez éventuellement utiliser le mode interactif avec les commandes :
AdminTask.nom_commande('-interactive')
Procédure
- Créez ou éditez un fichier de propriétés de plug-in de serveur Web.
- Définissez des propriétés d'objet PluginProperties si nécessaire.
Ouvrez un fichier de propriétés PluginProperties dans un éditeur.
Modifiez la section Environment Variables pour qu'elles correspondent à votre système et définissez les valeurs de propriétés devant être modifiées. Voici un exemple de fichier de propriétés PluginProperties :
#
# Header
#
ResourceType=PluginProperties
ImplementingResourceType=WebServer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:WebServer=:PluginProperties=
AttributeInfo=pluginProperties
#
#
#Properties
#
LogFilename="c:\Program Files\IBM\HTTPServer\Plugins\logs\IHS\http_plugin.log"
ConfigFilename=plugin-cfg.xml #default(plugin-cfg.xml)
RemoteKeyRingFilename="c:\Program Files\IBM\HTTPServer\Plugins\config\IHS\plugin-key.kdb"
LogLevel=ERROR #ENUM(DETAIL|DEBUG|ERROR|WARN|STATS|TRACE),default(ERROR)
PluginPropagation=AUTOMATIC #ENUM(MANUAL|AUTOMATIC),default(AUTOMATIC)
AcceptAllContent=false #boolean,default(false)
PluginInstallRoot="c:\Program Files\IBM\HTTPServer\Plugins"
IgnoreDNSFailures=false #boolean,default(false)
ESIInvalidationMonitor=false #boolean,default(false)
IISDisableNagle=false #boolean,default(false)
RemoteConfigFilename="c:\Program Files\IBM\HTTPServer\Plugins\config\IHS\plugin-cfg.xml"
PluginGeneration=AUTOMATIC #ENUM(MANUAL|AUTOMATIC),default(AUTOMATIC)
ResponseChunkSize=64 #integer,default(64)
RefreshInterval=60 #integer,default(60)
VHostMatchingCompat=false #boolean,default(false)
ASDisableNagle=false #boolean,default(false)
IISPluginPriority=HIGH #ENUM(MEDIUM|HIGH|LOW),default(HIGH)
KeyRingFilename=plugin-key.kdb #default(plugin-key.kdb)
ChunkedResponse=false #boolean,default(false)
ESIEnable=true #boolean,default(true)
ESIMaxCacheSize=1024 #integer,default(1024)
AppServerPortPreference=HOSTHEADER #ENUM(WEBSERVERPORT|HOSTHEADER),default(WEBSERVERPORT)
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myNode04Cell
nodeName=myNode04
serverName=IHS
- Exécutez la commande applyConfigProperties pour créer ou modifier
une configuration de propriétés de plug-in.
L'exécution de la commande applyConfigProperties
applique le fichier de propriétés à la configuration. Dans cet
exemple Jython, le paramètre facultatif -reportFileName
génère un rapport nommé report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName MonTypeObjet.props -reportFileName report.txt '])
- Créez ou éditez des propriétés personnalisées de plug-in de serveur Web.
- Définissez des propriétés personnalisées PluginProperties si nécessaire.
Ouvrez un fichier de propriétés PluginProperties dans un éditeur. Modifiez la section Environment Variables pour qu'elles correspondent à votre système et définissez les valeurs de propriétés devant être modifiées. Pour spécifier une propriété
personnalisée, éditez la valeur AttributeInfo et des valeurs
de propriétés. Par exemple :
#
# Header
#
ResourceType=PluginProperties
ImplementingResourceType=WebServer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:WebServer=:PluginProperties=
AttributeInfo=properties(name,value)
#
#Properties
#
existingProp=newValue
newProp=newValue
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myNode04Cell
nodeName=myNode04
serverName=IHS
- Exécutez la commande applyConfigProperties.
- Supprimez une propriété de plug-in de serveur Web.
Résultats
Vous pouvez utiliser le fichier de propriétés pour configurer et gérer
l'objet de plug-in et ses propriétés.
Que faire ensuite
Sauvegardez les modifications de la configuration.