Configuring the SAE to Send Tracking Events to the SRC-VTA

The SRC-VTA communicates with the SAE through the Enterprise JavaBean (EJB) adapter plug-in. This plug-in is an SAE plug-in and performs the following functions:

  • Filters SAE plug-in events for the SRC-VTA.
  • Adapts internal SAE events to EJB-compatible methods.
  • Sends SAE tracking plug-in events to the SRC-VTA.

To configure the EJB adapter plug-in:

  1. From configuration mode, access the EJB adapter plug-in configuration. In this sample procedure, the EJB adapter plug-in called QuotaVTA is configured in the nw-area SAE group.
    user@host# edit shared sae group nw-area configuration plug-ins name QuotaVTA ejb-adaptor
  2. Configure the class name of the J2EE application server’s JNDI service provider.
    [edit shared sae group nw-area configuration plug-ins name QuotaVTA ejb-adaptor]
    user@host# set jndi-service-provider jndi-service-provider
  3. Configure the URL of J2EE application server that is running JNDI service.
    [edit shared sae group nw-area configuration plug-ins name QuotaVTA ejb-adaptor]
    user@host# set application-server-url application-server-url
  4. Configure the JNDI name of the SAEEventListener EJB of the peer VTA.
    [edit shared sae group nw-area configuration plug-ins name QuotaVTA ejb-adaptor]
    user@host# set jndi-sae-event-listener jndi-sae-event-listener
  5. (Optional) Configure the LDAP filter that determines the subscriber and service events that the EJB adapter plug-in sends to the VTA. If you specify plug-in attributes in this field, you must include the same attributes in the attributes option.
    [edit shared sae group nw-area configuration plug-ins name QuotaVTA ejb-adaptor]
    user@host# set event-admitter event-admitter

    Table 1 lists the values that you can use for LDAP filter strings.

    Table 1: Settings for Filter Strings

    Filter String

    Action

    ()

    Matches no objects

    (*)

    Matches all objects

    List of <attribute>= <value> pairs

    <attribute>—Name of a property or attribute <ldapAttributeName>

    <value>—One of the following:

    • * (asterisk)
    • Explicit string
    • String that contains an *

      Note: To define a special character (* & , ! | \ ) in a string, precede it with the backslash symbol (\).
    • If <value> is *, checks for any value.
    • If <value> is an explicit string, checks whether any value of the property matches the string, regardless of case.
    • If <value> is a string that contains a *, checks whether any value of the property contains the string, regardless of case.

    (&<filter><filter>...)

    True if all filters match

    (|<filter><filter>...)

    True if at least one filter matches

    (!<filter>)

    True if the filter does not match

    The variables in the filter include the names of plug-in attributes and a PluginEventType variable. The value of this variable is the name of the type of event, such as PE_START_SERVICE. For names of plug-in attributes and plug-in event types, see the SAE CORBA plug-in documentation on the Juniper Networks Web site at http://www.juniper.net/techpubs/software/management/src/api-index.html or in the SDK+AppSupport+Demos+Samples.tar.gz file on the Juniper Web site at https://www.juniper.net/support/csc/swdist-erx/src.html.

  6. (Optional) Specifies whether or not the J2EE application server uses load balancing to determine the location that manages requests to the VTA.
    [edit shared sae group nw-area configuration plug-ins name QuotaVTA ejb-adaptor]
    user@host# set use-ejb-cluster
  7. Configure load-balancing scheme of the J2EE application server that hosts the VTA. See the documentation for the J2EE application server to determine which load-balancing scheme it supports.
    [edit shared sae group nw-area configuration plug-ins name QuotaVTA ejb-adaptor]
    user@host# set ejb-clustering-strategy (EJBObjectClustering | EJBHomeClustering | JNDIClustering)
  8. (Optional) Configure the plug-in attributes that the EJB adapter plug-in sends to the VTA listener. If you do not define a list of attributes, the EJB adapter plug-in sends all plug-in attributes to the VTA. Sending unnecessary plug-in attributes can adversely affect the performance of SRC components.
    [edit shared sae group nw-area configuration plug-ins name QuotaVTA ejb-adaptor]
    user@host# set attributes [(host | router-name | interface-name | ...)...]

    Specify at least the following plug-in attributes: router-name, session-id, login-name, user-ip-address, ssp-host, domain, service-name, event-time, session-time, in-octets, out-octets, in-packets, out-packets, session-timeout, downstream-bandwidth, upstream-bandwidth, service-session-name, subscription-name. You may need to add attributes if you use them for the event admitter.