Page tree
    Skip to end of metadata
    Go to start of metadata
    The full text of this page is only available to our customers.

    Please login or sign up. You may also need to provide your support ID if you have not already done so.

    Discover with BMC Discovery
    download

    This product can be discovered by Enterprise version of BMC Discovery, but you can still Download our free Community Edition to discover [other products] !

    What is this?
    This is a product information page, containing details of the information that BMC Discovery gathers about a product and how it is obtained.
    Product Name
    Traffic Director
    Publisher Page
    Oracle
    Category
    Network Management Software
    Release
    TKU 2019-04-1
    Change History
    Oracle Traffic Director - Change History
    Reports & Attributes
    Oracle Traffic Director - Reports & Attributes
    Publisher Link
    Oracle

    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

    Product ComponentOS TypeVersioningPattern Depth
    Oracle Traffic Director ServerUNIXActive, FileInstance-based
    Oracle Traffic Administration NodeUNIXActive, FileInstance-based
    Oracle Traffic Director Administration ServerUNIXRelated SIInstance-based

    Platforms Supported by the Pattern

    Identification

    Software Instance Triggers

    PatternTrigger NodeAttributeConditionArgument
    TrafficDirectorDiscoveredProcesscmdmatches

    regex " trafficd-wdog"

    argsmatches

    regex " trafficdirector_Home"

    AdminServerSoftwareInstance createdtype=Oracle Traffic Director Administration Node
    instancematches

    regex " admin-server"

    config_filematches^/

    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.


    24 Aug 2014

    The full text of this page is only available to our customers.

    Please login or sign up. You may also need to provide your support ID if you have not already done so.