You can use properties files to create, modify, or delete
HTTP inbound channel properties and custom properties.
Before you begin
Determine the changes that you want to make to your HTTP
inbound channel configuration or its configuration objects.
Start
the wsadmin scripting tool. To start wsadmin using the Jython language,
run the wsadmin -lang jython command from the bin directory
of the server profile.
About this task
Using a properties file, you can create, modify, or delete
an HTTP inbound channel object. You can also create, modify, or delete
HTTP inbound channel custom properties.
Run administrative commands
using wsadmin to create or change a properties file for an HTTP inbound
channel, validate the properties, and apply them to your configuration.
Table 1. Actions for HTTP inbound
channel properties files. You can create, modify, and
delete HTTP inbound channel objects.Action |
Procedure |
create |
Set required properties and then run the applyConfigProperties command. |
modify |
Run the applyConfigProperties command
to modify the value of a custom property. |
delete |
Run the deleteConfigProperties command
to delete a property. If the deleted property has a default value,
the property is set to the default value. To delete the entire HTTPInboundChannel
object, uncomment #DELETE=true and then run the deleteConfigProperties command. |
create Property |
Not applicable |
delete Property |
Not applicable |
Table 2. Actions for
HTTP inbound channel custom properties. You can create,
modify, and delete HTTP inbound channel custom properties.Action |
Procedure |
create |
Not applicable |
modify |
Edit properties and then run the applyConfigProperties command
to modify the value of an existing custom property. |
delete |
Not applicable |
create Property |
Set properties and then run the applyConfigProperties command
to create a custom property. |
delete Property |
Specify the properties to delete in the properties
file and then run the deleteConfigProperties command
to delete an existing custom property. The properties file must contain
only the properties to be deleted. |
Optionally, you can use interactive mode with the commands:
AdminTask.command_name('-interactive')
Procedure
- Create or edit an HTTP inbound channel properties file.
- Set HTTPInboundChannel object properties as needed.
Open an editor on an HTTPInboundChannel properties file.
Modify the Environment Variables section to match your system and
set any property value that needs to be changed. An example HTTPInboundChannel
properties file follows:
#
# 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
- Run the applyConfigProperties command
to change an HTTP inbound channel configuration.
Running
the applyConfigProperties command applies the properties
file to the configuration. In this Jython example, the optional -reportFileName parameter
produces a report named report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt'])
- Create or edit HTTP inbound channel custom properties.
- Set HTTPInboundChannel custom properties as needed.
Open an editor on an HTTPInboundChannel properties file.
Modify the Environment Variables section to match your system and
set any property value that needs to be changed. To specify a custom
property, edit the AttributeInfo value and properties
values; for example:
#
# 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
- Run the applyConfigProperties command.
- If you no longer need the HTTP inbound channel or an existing
custom property, you can delete the entire HTTP inbound channel object
or the custom property.
Results
You can use the properties file to configure and manage
the HTTP inbound channel object and its properties.
What to do next
Save the changes to your configuration.