Configure transport chains
A transport chain consists of one or more types of channels, each of which supports a different type of I/O protocol, such as TCP or HTTP. Network ports can be shared among all of the channels within a chain. The channel framework function automatically distributes a request arriving on that port to the correct I/O protocol channel for processing.
Ensure that a port is available for the new transport chain. If we need to set up a shared port, you must:
- Use wsadmin commands to create the transport chain.
- Make sure that all channels sharing that port have the same discrimination weight assigned to them.
You need to configure transport chains to provide networking services to such functions as the service integration bus component of IBM service integration technologies, the caching proxy, and the high availability manager core group bridge service.
We can use either the console or wsadmin commands to create a transport chain. If we use the console...
- In the console, click Servers > Server Types > WebSphere application servers > server_name or Servers > Server Types > WebSphere proxy servers > server_name, and then select one of the following options, depending on the type of chain you are creating:
For application servers, in the Container settings section select one of the following options:
- Click SIP Container Settings > SIP container transport chains.
- Click Web container settings > Web container transport chains.
- (zos) Click Container services > ORB service > ORB service transport chains.
- In the Server messaging section, click either Messaging engine inbound transports or WebSphere MQ link inbound transports.
For proxy servers, under HTTP proxy server settings, click Proxy server transports and select either HTTPS_PROXY_CHAIN or HTTP_PROXY_CHAIN. Then click HTTP proxy inbound channel.
- Click New.
The Create New Transport Chain wizard initializes. During the transport chain creation process, you are asked to:
- Specify a name for the new chain.
- Select a transport chain template
- Select a port, if one is available to which the new transport chain is bound. If a port is not available or to define a new port, specify a port name, the host name or IP address for that port, and a valid port number.
Avoid trouble: If we are configuring a chain containing a TCP channel, the wizard displays a list of configured TCP channels and a list of the ports that the listed TCP channels are not using. We must select one of the ports that none of the other TCP channels are using.
Similarly, if you are configuring a transport chain containing a UDP channel, the wizard displays a list of already configured UDP channels and a list of the ports that these UDP channels are not using. We must select one of the ports that none of the other UDP channels are using. gotcha
When you click Finish, the new transport chain is added to the list of defined transport chains on the Transport chain panel.
- Click the name of a transport chain to view the configuration settings that are in effect for the transport channels contained in that chain.
To change any of these settings...
- Click the name of the channel whose settings we need to change.
- Change the configuration settings.
Some of the settings, such as the port number, are determined by what is specified for the transport chain when it is created and cannot be changed.
- Click on Custom properties to set any custom properties defined for your system.
- When you the configuration changes, click OK.
- Stop the application server and start it again.
We must stop the application server and start it again before your changes take effect.
What to do next
Update any routines we have that issue a call to start transports during server startup. When a routine issues a call to start transports during server startup, the product converts the call to a transport channel call.
(zos) Update any routines we have that issue a call to start transports during server startup. When a routine issues a call to start transports during server startup, the product issues an error message.
Avoid trouble: If we create a new web container transport chain, the initial value for the writeBufferSize attribute is 8192, which is too small for most web container transport chains. IBM recommends that you use the console or wsadmin scripting to change the value of this attribute to 32768. Complete the following steps to use the console, to change the value of this attribute:
- Click Servers and expand Server Types.
- Click WebSphere application servers > server_name.
- Expand Web Container Settings and click Web container transport settings > transport_chain_name.
- Click Web container inbound channel.
- Specify 32768 in the Write buffer size field, and click OK.
- Click Save.
To change the value , see the documentation about working with Web container inbound channel properties files. gotcha
Subtopics
- Transport chains
Transport chains represent a network protocol stack used for I/O operations within an application server environment.
- HTTP transport collection
Use this page to view or manage HTTP transports. Transports provide request queues between web server plug-ins and web containers in which the web modules of applications reside. When you request an application in a web browser, the request is passed to the web server, then along the transport to the web container.
- HTTP transport settings
Use this page to view and configure an HTTP transport. The name of the page might be that of an SSL setting such as DefaultSSLSettings. This page is not available if we do not have an HTTP transport defined for the system.
- Transport chains collection
Use this page to view or manage transport chains. Transport chains enable communication through transport channels, or protocol stacks, which are usually socket based.
- Transport chain settings
Use this page to view a list of the types of transport channels configured for the selected transport chain. A transport chain consists of one or more types of channels, each of which supports a different type of I/O protocol, such as TCP, HTTP, or DCS.
- HTTP tunnel transport channel settings
- HTTP transport channel settings
Use this page to view and configure an HTTP transport channel. This type of transport channel handles HTTP requests from a remote client.
- TCP transport channel settings
Use this page to view and configure a TCP transport channels. This type of transport channel handles inbound TCP/IP requests from a remote client.
- DCS transport channel settings
Use this page to view and configure an DCS transport channels. This type of transport channel handles inbound Distribution and Consistency Services (DCS) messages.
- (zos) ORB service transport channel settings
Use this page to view and configure an Object Request Broker (ORB) Service transport channels. This type of transport channel handles CORBA and RMI/IIOP inbound messages for the ORB Service. It enables clients to make requests and receive responses from servers in a network-distributed environment.
- SSL inbound channel
Use this page to determine which SSL inbound channel options to specify for the application server.
- Session Initiation Protocol (SIP) inbound channel settings
Use this page to configure the SIP inbound channel settings.
- Session Initiation Protocol (SIP) container inbound channel settings
Use this page to configure the SIP container inbound channel settings.
- User Datagram Protocol (UDP) Inbound channel settings
Use this page to configure the UDP Inbound channel settings.
- Web container inbound transport channel settings
Use this page to view and configure a web container inbound channel transport. This type of channel transport handles inbound web container requests from a remote client.
- DataPower appliance manager transport channel settings
Use this page to view and configure a DataPower appliance manager transport channel. This type of transport channel handles events from managed DataPower appliances.
- HTTP transport channel custom properties
For an HTTP transport channel, we can add any of the following custom properties to the configuration settings for that channel.
- HTTP Tunnel transport channel custom properties
For an HTTP Tunnel transport channel, we can add the following custom properties to the configuration settings for that channel.
- TCP transport channel custom properties
For a TCP transport channel, we can use TCP transport channel custom properties to configure internal TCP transport channel properties.
- Web container transport chain custom properties
Use this page to set custom properties for a web container transport channel.
- Configure inbound HTTP request chunking
Inbound HTTP request chunking is used to eliminate the restriction on messages greater than 10MB. The 10MB restriction is set because the entire message is buffered in the controller before the HTTP request is dispatched to the servant, therefore, the controller may fail with an out of memory condition when multiple large HTTP messages are processed simultaneously. With chunking enabled, the message is broken up into smaller pieces before it is processed by the web container and application. As a result, only one small chunk is buffered in memory at a time in the controller thus greatly reducing the amount of memory consumed by large HTTP messages. Applications do not require changes to enable inbound HTTP chunking.
- Transport chain problems
Review the following topics if you encounter a transport chain problem.
- Delete a transport chain
Transport chains cannot be deleted the same way that HTTP transports can be deleted. Because we cannot have multiple HTTP transports associated with the same port, when we delete an HTTP transport, you effectively delete the associated port and stop all traffic on that port. However, the process is more complicated for a transport chain because multiple transport chains might be associated with the same port and we do not want to disrupt traffic on transport chains that you are not deleting.
- Disable ports and their associated transport chains
Transport chains cannot be disabled the same way that HTTP transports can be disabled. Because we cannot have multiple HTTP transports associated with the same port, when you disable an HTTP transport, you effectively disable the associated port and stop all traffic on that port. However, the process is more complicated for a port that has associated transport chains because multiple transport chains might be associated with the same port, and you might not want to disrupt traffic on all of the transport chains at the same time.
- SIP UDP transport channel custom properties
We can add the following custom properties to the configuration settings for the Session Initiation Protocol (SIP) UDP transport channel.
Related concepts
SIP container
Related tasks
Use wsadmin scripting
was26.html was36.html HTTP error, FRCA, and NCSA access log settings Ports collection