IBM Integration Bus, Version 10.0.0.5 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


Setting up the JNDI interface for the proxy servlet

The JNDI interface for the proxy servlet requires a one time setup of the WebSphere® Application Server full profile.

About this task

The proxy servlet initialization parameters must be configured for the integration node environment that the proxy servlet is connecting to each time the proxy servlet is deployed to the servlet container. It is now possible to configure the web.xml parameters only once through the JNDI in WebSphere Application Server, regardless of how many future deployments there might be of the proxy servlet. Because the JNDI configuration parameters take precedence over the initialization parameters in the web.xml file, using this method means that you need to set up at the application server side only once for any future deployments of the proxy servlet.

These setup tasks must all be completed in the WebSphere Application Server administrative console.

Creating a resource environment provider

About this task

Configure a resource environment provider, which encapsulates the referenceables that convert resource environment entry data into resource objects. These resource objects can then be accessed by applications.

Procedure

  1. Select Resources > Resource Environment > Resource Environment Providers. The Resource environment providers wizard opens.
  2. Click New. The Configuration panel opens so that you can configure a new resource environment provider.
  3. Type a name for the resource environment provider in the Name filed. For example, MyResourceEnvironmentProvider. It is recommended that you enter a meaningful description in the Description field, but it is not required. Click OK to continue and then save the changes.

Results

The new resource environment provider is listed in the wizard.

Creating a referenceable object

About this task

Configure a new referenceable, which specifies the factory class that converts data in the Java™ Naming and Directory Interface (JNDI) name space into an object that represents your resource to WebSphere Application Server.

Procedure

  1. Select Resources > Resource Environment > Resource Environment Providers. The Resource environment providers wizard opens.
  2. From the Resource environment providers panel, select the provider that you created in the previous task: In this example, it is called MyResourceEnvironmentProvider.
  3. Click Referenceables. The Referenceables panel opens.
  4. Click New. The Configuration panel opens.
  5. In the Configuration panel, type the following values:
    1. In the Factory class name field, type: com.ibm.broker.httpproxy.MQResourceConnectionFactory
    2. In the Class name field, type: com.ibm.broker.httpproxy.MQResourceConnection
  6. Click OK and save the changes.

Creating resource environment entries

About this task

Configure resource environment entries, which are objects that contain information about a resource, and represent it in the JNDI name space.

Procedure

  1. Select Resources > Resource Environment > Resource Environment Providers > MyResourceEnvironmentProvider. The Resource environment providers wizard opens at the configuration panel for your provider.
  2. Click Resource environment entries. The Resource environment entries panel opens.
  3. Click New. The Configuration panel opens.
  4. In the Configuration panel, type your values. In this example, the values are:
    1. In the Name field, type for example: MQResourceReference
    2. In the JNDI name field, type for example: proxyservlet/reference/MQResourceReference . This JNDI name is used during application deployment resource mapping.
    3. In the Referenceables drop-down list, ensure that com.ibm.broker.httpproxy.MQResourceConnectionFactory is selected.
  5. Click OK and save the changes.

Creating custom properties or define the parameters to be configured

About this task

Specify custom properties that your enterprise information system (IES) requires for the resource providers and resource factories that you configure. For example, most database vendors require extra custom properties for data sources that access the database.

Procedure

  1. Select Resources > Resource Environment > Resource Environment Providers > MyResourceEnvironmentProvider > ResourceEnvironment Entries > MQResourceReference. where MyResourceEnvironmentProvider and MQResourceReference are your own specified values. The Resource environment providers wizard opens at the configuration panel for your entry.
  2. Click Custom properties. The Configuration panel opens.
  3. Click New.
  4. In the Configuration panel, you must type your values for all the resources that are administered through the administrative console. For example: The integration node name, the configuration file path, the client mode channel name, and the client mode port number. For each resource, you must provide values for Name, Value, Description, and Type. The following example is for the integration node name
    Option Description
    Name This field refers to the value in the "<param-name> </param-name>" tag in the web.xml. For example: brokerName
    Value This field refers to the value in the "<param-value> </param-value>" tag in the web.xml. For example: RRB
    Description Optional. It is recommended that you provide a meaningful description.
    Type Specify the type. For example: java.lang.String
  5. Click OK to save the configuration.
  6. Click New to create a new configuration for the remaining resources.

Results

You have a list of configured resources that is similar to the following table, but with the values that you specified:
Table 1.
Name Value Description Required
brokerName RRB Integration node Name false
configFilePath C:\\Documents and Settings\\All Users.WINDOWS\\Application Data\\IBM\\MQSI\\components\\RRB\\config\soapplugin6.conf Configuration File Path false
clientModeChannelName SYSTEM.DEF.SVR.CONN Client Mode Channel Name false
clientModePortNumber 2908 Client Mode Port Number false
The WebSphere Application Server wizard does not provide an option to specify the Required attribute and so the default value is set to false. This attribute can be ignored.

What to do next

After you complete these tasks, you must deploy the proxyservlet.war file. During the deployment, you must provide the JNDI reference name for the Resource Environment reference that is defined in the web.xml file. For example: proxyservlet/reference/MQResourceReference.

After the deployment, proxyservlet gives precedence to the values configures in the Resource Environment Entries. If there is an environment change, the values must be modified in the custom properties of the Resource Environment Entries. After you modify a value, restart the Proxyservlet application in WebSphere Application Server for the new values to take effect.


ac69470_.htm | Last updated 2016-06-25 08:07:22