Product Description

Oracle Traffic Director serves as the reliable entry point for all HTTP, HTTPS and TCP traffic to application servers and web servers in the back end. Oracle Traffic Director distributes the requests that it receives from clients to servers in the back end based on the specified load-balancing method, routes the requests based on specified rules, caches frequently accessed data, prioritizes traffic, and controls the quality of service.

The following diagram illustrates a high-level workflow in Oracle Traffic Director:
 

Known Versions

• 11gR1
• 11gR2

Software Pattern Summary

Platforms Supported by the Pattern

Identification

Software Instance Triggers

Versioning

Version information for the product is currently collected using the Active and File Versioning methods.

Install root 

Install root is obtained from the triggering process arguments using the following regular expression: 

• '-r\s+(\S+)'

Configuration file directory

Configuration file directory can be obtained from triggering process arguments using the following regular expression: 

• -d\s+(\S+/config)

Active Versioning

To obtain the version, the pattern runs <install_root>/bin/tadm -V command and extracts the version from the output using the following regular expression:

• Oracle Traffic Director (\d+(?:\.\d+)*)

File Versioning

The pattern retrieves the product version by evaluating the instantiate.xml file located in the /inventory subfolder of the install root using the following xpath:

• /INSTANTIATE_LIST/COMPONENT[@NAME="oracle.trafficdirector"]/@VERSION

Versioning from Related Software Instance

The AdminServer pattern uses the version of Oracle Traffic Director Server or Oracle Traffic Director Administration Node Software Instance to extract the product version for Oracle Traffic Director Administration Server Software Instance.

Application Model Produced by Software Pattern

Product Architecture

The main components of Oracle Traffic Director are:

• Oracle Traffic Director Administration Server
  This is a dedicated Oracle Traffic Director instance that hosts the administration console and command-line interfaces for creating and managing Oracle Traffic Director configurations, deploying instances on administration nodes, and managing the lifecycle of these instances.
• Oracle Traffic Director Administration Node
  This is a dedicated Oracle Traffic director instance that is registered with the remote administration server. The administration node running on a host acts as the agent of the remote administration server and assists the administration server in managing the instances on the host.
• Oracle Traffic Director Server
  This is an Oracle Traffic Director server that is instantiated from a configuration and deployed on an administration node. Each Oracle Traffic Director  Instance can have multiple virtual servers  to provide several entry point  for client requests. Virtual servers are bound to one or more listeners and configure them to forward requests to different origin-server pools.

All virtual servers are modeled as SoftwareComponents inside Oracle Traffic Director Server software instance.

Software Pattern Model

Pattern Trigger

The TrafficDirector pattern triggers on the discovered process whose command line contains trafficd-wdog as a substring, and whose arguments (for example, -d /home/oracle/otd/instances/net-test3/config -r /home/oracle/oracle/product/11.1.1.7.0/trafficdirector_Home_1 -t /tmp/net-test3-dee33fc9 -u oracle) contain trafficdirector_Home as a substring.

The AdminServer pattern triggers on the new Oracle Traffic Director Administration Node SoftwareInstance whose instance matches regex "admin-server" and whose config_file matches "^/".

SI Depth

The TrafficDirector pattern creates either Oracle Traffic Director Administration Node or Oracle Traffic Director Server Software Instance, its key being based on instance, si type, host key and hashed config file.

The AdminServer pattern creates an instance-based Software Instance, its key being based on Oracle Traffic Director Administration Node SoftwareInstance key and si type.

Relationship Creation

The pattern creates containment relationships between the Oracle Traffic Director Administration Node software instance and all Oracle Traffic Director Server instances.

Software Instance Modeling

Software Instance Type

As the Oracle Traffic Director Administration Node and Oracle Traffic Director Server are equal processes with different configuration, the TrafficDirector pattern triggers on both of them. To decide on which one should be modeled, the TrafficDirector pattern retrieves the instance information  from the triggering process arguments using the following regular expression:

• -d\s+\S+/(?:net-)?(\S+)/config

and matches the retrieved information against the following regular expression:

• admin-server

In case of successful match, the Oracle Traffic Director Administration Node SI is created. Otherwise, it is Oracle Traffic Director Server Software Instance.

Listening Port

To retrieve information about the listening port used by the Oracle Traffic Director Administration Node or Server, the pattern evaluates the contents of server.xml configuration file located in the configuration file directory using the following xpaths:

• For Oracle Traffic Director Administration Node:
  • /server/http-listener[default-virtual-server-name="admin-server"]/port
• For Oracle Traffic Director Server:
  • /server/%listener%/port

Clustering

To detect the clustered deployment, the TrafficDirector pattern evaluates the contents of server.xml configuration file located in the configuration file directory using the following xpaths:

• /server/cluster/failover-group/router-id

Software Components: virtual servers

The TrafficDirector pattern models virtual servers whose traffic is managed by Oracle Traffic Director. To detect the virtual servers, the TrafficDirector pattern evaluates the contents of server.xml configuration file located in the configuration file directory using the following xpaths:

• /server/virtual-server/name

Next, the pattern searches for http-listener-name and port for every detected virtual server. If the port is identified, the virtual server is modeled as a Software Component of the Oracle Traffic Director.

Software Instance Example

Software Instance details of Oracle Traffic Director Server SI generated with this pattern (click on the image to open full size):

Subject Matter Expertise

Subject Matter Expert input will be welcome on any other potential approaches not discussed to improving product versioning coverage and depth of Oracle Oracle Traffic Director.

Testing

The pattern was tested on live installations in the test lab on Red Hat Enterprise Linux.

Information Sources

Open Issues

There are no known open issues with this pattern.