Defining outbound chains for bootstrapping

You can define new outbound chains by using the wsadmin utility. These chains can be used for bootstrapping connections to messaging engines.

About this task

To create outbound chains for bootstrapping, there are several main steps:
  1. Locate the appropriate TransportChannelService configuration object. This object is the parent object of all the objects created.
  2. Create the individual channels that comprise the transport channel service. Some of these channels might require references to other configuration objects.
  3. Assemble the channels that you have created into an outbound channel chain.
The channels used to build an outbound bootstrap chain determine the protocol with which the outbound chain can be used to bootstrap. The following table shows all valid bootstrap chains with their bootstrap protocols.
Table 1. Valid bootstrap chains and protocols. The first column contains the bootstrap protocol used in building the outbound bootstrap chain. The second to fifth columns in the table contain the channels that are valid for the protocol specified on the first column. The order of the channels is important while building the chain. The order of the channels from left to right as given in the table is TCP, SSL, HTTP, HTTP tunneling, and JFAP channels.
Bootstrap protocol TCP channel SSL channel HTTP channel HTTP tunneling channel JFAP channel
TCP X       X
SSL X X     X
HTTP X   X X X
HTTPS X X X X X

For example, a chain for bootstrapping that uses the SSL protocol would consist of a TCP channel, SSL channel, and JFAP channel. When you create chains, the order of channels in the chain is important. You must specify channels in the order (left to right) in which they appear in the preceding table.

The example in this topic describes how to create a bootstrap chain that is capable of bootstrapping by using the HTTPS protocol. This requires a chain containing all the channel types described. Thus, it is easy to see how to create chains for other protocols by omitting channels during the chain creation step.

[IBM i] Note: You open a wsadmin command session from within Qshell. For more information, see the topic "Configure Qshell to run WebSphere® Application Server scripts".

Procedure

  1. Locate the TransportChannelService object for the server in which you want to create the new chain. For example, in a WebSphere Application Server Network Deployment configuration, you can list the available TransportChannelService objects and select the appropriate service as follows.
    Using Jython:
    wsadmin>AdminConfig.list("TransportChannelService" )
    (cells/BadgerCell01/nodes/BadgerCellManager01/servers/dmgr|server.xml
    #TransportChannelService_1)
    (cells/BadgerCell01/nodes/BadgerNode01/servers/nodeagent|server.xml
    #TransportChannelService_1095
    711814579)
    (cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml
    #TransportChannelService_109571
    2023139)
    (cells/BadgerCell01/nodes/BadgerNode01/servers/server2|server.xml
    #TransportChannelService_109571
    2039302)
    wsadmin>tcs = AdminConfig.list("TransportChannelService" ).split("\r\n")[2]
    Using Jacl:
    wsadmin> $AdminConfig list TransportChannelService
    (cells/BadgerCell01/nodes/BadgerCellManager01/servers/dmgr|server.xml
    #TransportChannelService_1)
    (cells/BadgerCell01/nodes/BadgerNode01/servers/nodeagent|server.xml
    #TransportChannelService_1095
    711814579)
    (cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml
    #TransportChannelService_109571
    2023139)
    (cells/BadgerCell01/nodes/BadgerNode01/servers/server2|server.xml
    #TransportChannelService_109571
    2039302)
    wsadmin> set tcs [lindex [$AdminConfig list TransportChannelService] 2]
    (cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#
    TransportChannelService_1095712023139)
  2. Define an outbound TCP channel called testTCPChannel.
    Using Jython:
    wsadmin>tcpChannel = AdminConfig.create("TCPOutboundChannel", tcs, 
    [["name", "testTCPChannel"]] )
    Using Jacl:
    wsadmin>set tcpChannel [$AdminConfig create TCPOutboundChannel $tcs 
    "{name testTCPChannel}"]
    testTCPChannel(cells/BadgerCell01/nodes/BadgerNode01/servers/
    server1|server.xml#TCPOutboundChannel_1095969213949)
  3. Define an outbound SSL channel called testSSLChannel. There are two steps required to define such a channel.
    1. Identify the SSL alias to be used by the channel.
      Using Jython:
      wsadmin>for obj in AdminConfig.list("SSLConfig" ).split("\r\n"): 
      print obj+AdminConfig.show(obj, "alias")
      (cells/BadgerCell01|security.xml#SSLConfig_1) 
      [alias BadgerCellManager01/DefaultSSLSettings]
      (cells/BadgerCell01|security.xml#SSLConfig_1095711819776) 
      [alias BadgerNode01/DefaultSSLSettings]

      Using Jacl:

      wsadmin>foreach obj [$AdminConfig list SSLConfig] { puts "$obj 
      [$AdminConfig show $obj alias]]" }
      (cells/BadgerCell01|security.xml#SSLConfig_1) {alias BadgerCellManager01/
      DefaultSSLSettings}]
      (cells/BadgerCell01|security.xml#SSLConfig_1095711819776) {alias BadgerNode01/
      DefaultSSLSettings}]
    2. Create an SSL channel as in the following example, in which the BadgerNode01/DefaultSSLSettings alias is used.
      Using Jython:
      wsadmin>sslChannel = 
      AdminConfig.create("SSLOutboundChannel", tcs, [["name", "testSSLChannel"], 
      ["sslConfigAlias", "BadgerNode01/DefaultSSLSettings"]] )

      Using Jacl:

      wsadmin>set sslChannel [$AdminConfig create SSLOutboundChannel $tcs 
      "{name testSSLChannel} 
      {sslConfigAlias BadgerNode01/DefaultSSLSettings}"]
      testSSLChannel(cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#
      SSLOutboundChannel_1095971760671)
  4. Define an outbound HTTP channel called testHTTPChannel.
    Using Jython:
    wsadmin>httpChannel = AdminConfig.create("HTTPOutboundChannel", tcs, 
    [["name", "testHTTPChannel"]] )

    Using Jacl:

    wsadmin>set httpChannel [$AdminConfig create HTTPOutboundChannel $tcs 
    "{name testHTTPChannel}"]
    testHTTPChannel(cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#
    HTTPOutboundChannel_1095971896556)
  5. Define an outbound HTTP tunneling channel called testHTCChannel.
    Using Jython:
    wsadmin>htcChannel = AdminConfig.create("HTTPTunnelOutboundChannel", tcs, 
    [["name", "testHTCChannel"]] )

    Using Jacl:

    wsadmin>set htcChannel [$AdminConfig create HTTPTunnelOutboundChannel $tcs 
    "{name testHTCChannel}"]
    testHTCChannel(cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#
    HTTPTunnelOutboundChannel_1095972164201)
  6. Define an outbound JFAP channel called testJFAPChannel.
    Using Jython:
    wsadmin>jfapChannel = AdminConfig.create("JFAPOutboundChannel", tcs, 
    [["name", "testJFAPChannel"]] )

    Using Jacl:

    wsadmin>set jfapChannel [$AdminConfig create JFAPOutboundChannel $tcs 
    "{name testJFAPChannel}"]
    testJFAPChannel(cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#
    JFAPOutboundChannel_1095972226631)
  7. Finally, create the channel chain by combining the channels defined so far. For example, to create a chain called testChain:
    Using Jython:
    wsadmin>AdminConfig.create("Chain", tcs, [["name", "testChain"], ["enable", "true"], 
    ["transportChannels", [tcpChannel, httpChannel, htcChannel, jfapChannel]]] )
    testChain(cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#
    Chain_1095972662147)

    Using Jacl:

    wsadmin>$AdminConfig create Chain $tcs "{name testChain} {enable true} 
    {transportChannels {$tcpChannel $httpChannel $htcChannel $jfapChannel}}"
    testChain(cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#
    Chain_1095972662147)
Task topic    

Terms and conditions for information centers | Feedback

Last updated: April 17, 2014 04:48 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-base-iseries&topic=tjk1000_
File name: tjk1000_.html