[AIX Solaris HP-UX Linux Windows][z/OS]

Creating ODRs

You can create on demand routers (ODRs) to route requests to Intelligent Management nodes. The ODR is fully aware of the dynamic state of the cell, so that if one server in the cell fails, the requests are routed to another server. The configuration of the ODR in the DMZ is not supported.

Before you begin

  • The ODR is a server that acts as an intermediary for HTTP requests that are serviced by application servers or Web servers. Make sure you have an application or Web server installed. By default, the ODR binds to ports 80 and 443 for listening on HTTP and HTTPs, which requires running the ODR as a root user. If you want to run the ODR as a non-root user, you must change the PROXY listening ports to values greater than 1024.
  • [z/OS]SIP is not supported on the z/OS® operating system.

About this task

A deployment manager profile cannot be used as the target profile for an ODR. Only an application server profile can be used as the target node when creating an ODR. To collocate an ODR with a deployment manager, a separate Intelligent Management-enabled application server profile must be created and federated on the same machine as the Intelligent Management-enabled deployment manager profile. You can then create an ODR within the application server profile.

The nodes hosting an ODR must be at the same level as the deployment manager.

Avoid trouble: The SIP ODR is stabilized, and is currently not recommended. Use the SIP proxy server instead.

Procedure

  1. Navigate to the ODR creation wizard in the administrative console.
    In the administrative console, select Servers > Server types > On demand routers. Click New.
  2. Select the node on which you want the ODR to be created.
    The selected node is pre-populated with available nodes in the cell. If your environment is a heterogeneous mix of Intelligent Management and nodes that are running other middleware software, select a product node. If you select a node that is not running the product, your ODR does not start.
    [z/OS]Tip: Select a node to run the ODR that does not run any dynamic clusters, unless you are using the z/OS operating system. [z/OS]In a z/OS environment, you can co-locate the ODR on a node that hosts application servers.
  3. Determine whether to generate HTTP ports, SIP ports, or both.
    The Generate unique ports option is selected by default and is the recommended option. If you deselect this option, port conflicts might occur.
  4. Select a server template to base your new ODR.
    You can use an application server template on which to model the servers for the new ODR. You can use a default template or map an existing application server. Mapping preexisting ODRs can save time. You can build one ODR, apply all of the configurations that your environment needs, and use that ODR as a template.

    If you are running Intelligent Management for z/OS, ensure that the SIP option is not selected.

    Avoid trouble:

    If you don't want to use UDP for SIP support, you can disable UDP to redirect the SIP traffic to TCP. To disable the UDP transport, navigate to On Demand Routers > [ODR Name] > SIP proxy server transports > UDP_SIP_PROXY_CHAIN in the administrative console and clear the Enabled check box. Save and synchronize the changes. Restart the Java On Demand Router. You might want to wait for a few moments to allow the ports to be released from the Operating System perspective. Modifying the SIP port properties does not disable other Java On Demand Router functionality.

    The Java ODR SIP functionality is not a recommended path if you require a proxy for SIP applications. The recommended proxy for SIP applications is SIP Proxy. For more information, see Installing a Session Initiation Protocol proxy server

Results

The ODR that you created automatically routes HTTP requests to product cells.

What to do next

To enable routing to another product cell, configure your cell to communicate with other product cells.

You might want to configure the ODR to route work to nodes that are not running Intelligent Management nodes. After you create the ODR and apply any optional configuration parameters, you can define the ability to route work to nodes that are not running Intelligent Management. Note that the configuration of the ODR in the DMZ is not supported.