Vous pouvez utiliser des fichiers de propriétés pour créer, modifier ou supprimer
les propriétés du canal entrant HTTP et les propriétés personnalisées.
Avant de commencer
Déterminez les changements à apporter à votre
configuration de canal entrant HTTP 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
Grâce à un fichier de propriétés, vous pouvez créer, modifier ou supprimer
un objet de canal entrant HTTP. Vous pouvez également créer, modifier et supprimer
les propriétés personnalisées du canal entrant HTTP.
Exécutez les
commandes administratives à l'aide de wsadmin pour créer ou changer un fichier de propriétés pour un canal entrant HTTP, valider les propriétés et les appliquer à
votre configuration.
Tableau 1. Actions appliquées aux fichiers de propriétés du canal entrant HTTP. Vous pouvez créer, modifier et supprimer
les propriétés de canal entrant HTTP.Action |
Procédure |
création |
Paramétrez les propriétés requises et exécutez la commande applyConfigProperties. |
modify |
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 présente une valeur par défaut, la propriété
est paramétrée sur la valeur par défaut. Pour supprimer tout l'objet HTTPInboundChannel,
supprimez la mise en commentaire #DELETE=true et exécutez
la commande deleteConfigProperties. |
create Property |
Non applicable |
delete Property |
Non applicable |
Tableau 2. Actions appliquées aux propriétés personnalisées du canal entrant HTTP. Vous pouvez créer, modifier et supprimer
les propriétés personnalisées du canal entrant HTTP.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 |
create Property |
Paramétrez les propriétés et exécutez la commande applyConfigProperties
pour créer une propriété personnalisée. |
delete Property |
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 doit contenir uniquement les
propriétés à supprimer. |
Vous pouvez éventuellement utiliser le mode interactif avec les commandes :
AdminTask.command_name('-interactive')
Procédure
- Créez ou modifiez un fichier de propriétés de canal entrant HTTP.
- Paramétrez les propriétés d'objet HTTPInboundChannel selon les besoins.
Ouvrez un éditeur dans un fichier de propriétés HTTPInboundChannel.
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 HTTPInboundChannel :
#
# Header
#
ResourceType=HTTPInboundChannel
ImplementingResourceType=TransportChannelService
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:TransportChannelService=:HTTPInboundChannel=myHTTPIC
#DELETE=true
#
#
#Properties
#
enableLogging=false #boolean,default(false)
name= myHTTPIC #required
readTimeout=60 #integer,required,default(60)
maxFieldSize=32768 #integer,default(32768)
useChannelAccessLoggingSettings=false #boolean,default(false)
maxRequestMessageBodySize=-1 #integer,default(-1)
maximumPersistentRequests=100 #integer,required,default(100)
discriminationWeight=10 #integer,default(0)
persistentTimeout=30 #integer,required,default(30)
maxHeaders=50 #integer,default(50)
keepAlive=true #boolean,default(true)
useChannelErrorLoggingSettings=false #boolean,default(false)
useChannelFRCALoggingSettings=false #boolean,default(false)
writeTimeout=60 #integer,required,default(60)
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell04
serverName=server1
nodeName=myNode05
- Exécutez la commande applyConfigProperties pour changer une configuration de
canal entrant HTTP.
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 modifiez les propriétés personnalisées du canal entrant HTTP.
- Paramétrez les propriétés personnalisées HTTPInboundChannel selon vos besoins.
Ouvrez un éditeur dans un fichier de propriétés HTTPInboundChannel.
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 définir une propriété personnalisée, modifiez la valeur AttributeInfo
et les valeurs de propriétés ; par exemple :
#
# Header
#
ResourceType=HTTPInboundChannel
ImplementingResourceType=TransportChannelService
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:TransportChannelService=:HTTPInboundChannel=myHTTPIC
AttributeInfo=properties(name,value)
#
#
#Properties
#
existingProp=newValue
newProp=newValue
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell04
serverName=server1
nodeName=myNode05
- Exécutez la commande applyConfigProperties.
- Si vous n'avez plus besoin du canal entrant HTTP ou d'une propriété personnalisée existante,
vous pouvez supprimer la totalité de l'objet de canal entrant HTTP ou de
la propriété personnalisée.
Résultats
Vous pouvez utiliser le fichier de propriétés pour configurer et gérer
l'objet de canal entrant HTTP et ses propriétés.
Que faire ensuite
Sauvegardez les modifications de la configuration.