TechLibrary

ContentIndex

[+] Expand All

[-] Collapse All

SRC PE 4.9.x Network Guide
- Copyright and Trademark Information
- Table of Contents
- List of Figures
- List of Tables
- About the Documentation
- Operating the SAE
  - Overview of the SAE
    - Role of the SAE
    - Connections to Managed Devices
    - SAE Support for Dual-Stack Configuration
    - SAE Support for Gx Router Driver
    - SAE Plug-Ins
    - Tracking and Controlling Subscriber and Service Sessions with SAE APIs
      - SAE Core API
      - SAE CORBA Remote API
    - SAE Accounting
  - Configuring the SAE (SRC CLI)
  - Managing Subscriber and Service Session Data (SRC CLI)
    - Storing Subscriber and Service Session Data
    - Configuring the Session Store Feature (SRC CLI)
    - Configuring the Number of Threads for Sessions (SRC CLI)
  - Managing SAE Data (SRC CLI)
  - Managing SAE Data (C-Web Interface)
- Using Juniper Networks Routers in the SRC Network
  - Using JunosE Routers in the SRC Network (SRC CLI)
    - COPS Connection Between JunosE Routers and the SAE
      - Highly Available Connections to JunosE Routers
    - Adding JunosE Routers and Virtual Routers (SRC CLI)
    - Configuring the SAE to Manage JunosE Routers (SRC CLI)
    - How SNMP Obtains Information from Routers for the SRC Software
    - Developing Router Initialization Scripts for Network Devices and Juniper Networks Routers
    - Specifying JunosE Router Initialization Scripts on the SAE (SRC CLI)
    - Updating Local IP Address Pools for JunosE Virtual Routers (SRC CLI)
    - Updating Quality of Service Profiles for JunosE Virtual Routers (SRC CLI)
    - Accessing the Router CLI
    - Starting the SRC Client on a JunosE Router
    - Stopping the SRC Client on a JunosE Router
    - Monitoring Interactions Between the SAE and the Router Running JunosE Software
    - Troubleshooting Problems with Managing JunosE Routers
    - Viewing the State of JunosE Device Drivers (SRC CLI)
    - Viewing Statistics for Specific JunosE Device Drivers (SRC CLI)
    - Viewing Statistics for All JunosE Device Drivers (SRC CLI)
    - Viewing the State of JunosE Device Drivers (C-Web Interface)
    - Viewing Statistics for All JunosE Device Drivers (C-Web Interface)
  - Using Devices Running Junos OS in the SRC Network (SRC CLI)
  - Managing Junos DMI Devices Using the SRC Software
    - Managing DMI Devices on Routers Running Junos OS Using the SRC Software and Junos Space
    - Managing DMI Devices Using the SRC Software and Junos Space Overview
      - Configuration Overview
      - Redundancy
    - Summary of Tasks for Configuring the SRC Software to Manage DMI-Enabled Routers Running Junos OS (SRC CLI)
    - Adding the Router Running Junos OS as a DMI Network Device (SRC CLI)
    - Configuring the Junos DMI Driver (SRC CLI)
    - Migrating from the Junos (BEEP) Driver to the Junos DMI Driver (SRC CLI)
  - Managing Routers Running Junos OS and Acting as a PCEF Using the SRC Software (SRC CLI)
- Using Network Devices in the SRC Network
  - Integrating Third-Party Network Devices into the SRC Network (SRC CLI)
    - Integrating Network Devices into the SRC Network Overview
    - Logging In Subscribers and Creating Sessions
    - Configuration Tasks for Integrating Third-Party Network Devices (SRC CLI)
    - Setting Up Script Services
    - Adding Objects for Network Devices (SRC CLI)
    - Adding Virtual Router Objects (SRC CLI)
    - Setting Up SAE Communities (SRC CLI)
      - Configuring the SAE Community Manager
      - Specifying the Community Manager in the SAE Device Driver
    - Configuring SAE Properties for the Event Notification API (SRC CLI)
    - Developing Router Initialization Scripts for Network Devices and Juniper Networks Routers
    - Copying Initialization Scripts to the C Series Controller
    - Specifying Initialization Scripts on the SAE (SRC CLI)
    - Using SNMP to Retrieve Information from Network Devices
    - Configuring Global SNMP Communities in the SRC Software (SRC CLI)
    - Using the NIC Resolver in Environments That Have Third-Party Devices (SRC CLI)
- Locating Subscriber Management Information
  - Locating Subscriber Information with the NIC
    - Locating Subscriber Management Information
      - NIC Client/Server Mode
      - NIC Local Host Mode
    - Mapping Subscribers to a Managing SAE
    - High Availability for NIC
      - High Availability in Existing NIC Configurations
      - NIC Replication
    - Planning a NIC Implementation
    - NIC Configuration Scenarios
    - NIC Agents Used in the NIC Configuration Scenarios
    - Router Initialization Scripts with NIC Configuration Scenarios
  - Configuring the NIC (SRC CLI)
    - Configuration Statements for the NIC
    - Before You Configure the NIC
    - Configuring the NIC (SRC CLI)
    - Reviewing and Changing Operating Properties for the NIC (SRC CLI)
      - Reviewing the Default NIC Operating Properties
      - Changing NIC Operating Properties
    - Configuring NIC Replication (SRC CLI)
    - Configuring a NIC Scenario (SRC CLI)
    - Configuring Advanced NIC Features
    - Verifying Configuration for the NIC (SRC CLI)
    - Starting the NIC (SRC CLI)
    - Testing a NIC Resolution (SRC CLI)
    - Stopping a NIC Host on a C Series Controller (SRC CLI)
    - Restarting the NIC (SRC CLI)
    - Restarting a NIC Agent (SRC CLI)
    - Restarting a NIC Resolver (SRC CLI)
    - Changing NIC Configurations (SRC CLI)
  - Obtaining Interface Configuration for OnePopStaticRouteIp or OnePopVrfIp
  - Configuring Applications to Communicate with an SAE
    - NIC Proxy Configuration Overview
    - Before You Configure a NIC Proxy
  - Configuring SRC Applications to Communicate with an SAE (SRC CLI)
  - Developing Applications That Use NIC
  - NIC Resolution Process
    - NIC Resolution Process Overview
      - NIC Realms
      - Key to Value Resolution
    - NIC Data Types
    - Constraints as NIC Data Types
  - NIC Configuration Scenarios
    - NIC Configuration Scenarios Overview
    - OnePop Scenario
    - OnePopPcmm Scenario
      - Centralized Configuration
      - Distributed Configuration
    - OnePopDynamicIp Scenario
      - Centralized Configuration
      - Distributed Configuration
    - OnePopSharedIp Scenario
      - Centralized Configuration
      - Distributed Configuration
    - OnePopStaticRouteIp Scenario
      - Centralized Configuration
      - Distributed Configuration
    - OnePopVrfIp Scenario
      - Centralized Configuration
      - Distributed Configuration
    - OnePopAcctId Scenario
    - OnePopLogin Scenario
      - Centralized Configuration
      - Distributed Configuration
    - OnePopLoginPull Scenario
    - OnePopPrimaryUser
      - Centralized Configuration
      - Distributed Configuration
    - OnePopDnSharedIp Scenario
      - Centralized Configuration
      - Distributed Configuration
    - OnePopAllRealms Scenario
    - OnePopTunnel Scenario
      - Centralized Configuration
    - OnePopPrefixIp Scenario
    - MultiPop Scenario
- Providing Admission Control with SRC ACP
  - Overview of Providing Admission Control with SRC ACP
  - Configuring Admission Control (SRC CLI)
    - Configuration Statements for SRC ACP
    - Configuring SRC ACP (SRC CLI)
    - Creating Grouped Configurations for SRC ACP (SRC CLI)
    - Configuring Local Properties for SRC ACP (SRC CLI)
    - Configuring the SAE for SRC ACP (SRC CLI)
    - Configuring SRC ACP Properties (SRC CLI)
    - Configuring SRC ACP to Manage the Edge Network (SRC CLI)
    - Configuring SRC ACP to Manage the Backbone Network (SRC CLI)
    - Defining SRC ACP Congestion Point Usage Trap Thresholds (SRC CLI)
  - Configuring Congestion Point Classification (SRC CLI)
    - Congestion Point Classification Overview
      - Congestion Point Classification Scripts
      - Congestion Point Profiles
    - Configuration Statements for Congestion Point Classification
    - Classifying Congestion Points (SRC CLI)
      - Configuring Targets and Criteria for Classification Scripts
      - Configuring Classification Scripts Contents for Classification Scripts
      - Configuring Congestion Point Classification Targets
        Congestion Point Classification Criteria
    - Defining a Congestion Point Profile (SRC CLI)
    - Congestion Point Expressions
  - Managing SRC ACP (SRC CLI)
  - Monitoring Admission Control (SRC CLI)
  - Monitoring Admission Control (C-Web Interface)
- Using External Subscriber Monitor
  - Configuring External Subscriber Monitor with the SRC CLI
  - Monitoring External Subscriber Events with the SRC CLI
  - Monitoring External Subscriber Events with the C-Web Interface
- Using Session State Registrar
  - Session State Registrar Overview
    - Session State Registrar Overview
    - SSR Node Types
    - SSR Node Groups
    - C Series Controller Requirements
    - SSR Cluster Configurations Overview
      - Small-Scale Deployments
    - Scaling the SSR Cluster
      - Scaling the Front End of the Cluster
      - Scaling the Back End of the Cluster
    - SSR Cluster Network Requirements
    - Supported SSR Cluster Configurations
      - Failover Overview
        Failover Examples
        Possible Failure Scenarios
        Distributed Cluster Failure and Recovery
    - SSR Database Schema
    - Making Modifications to the SSR Database Schema Overview
    - SSR Database Operating Modes
    - Distributing the SSR Cluster Configuration and Enabling SSR Client Components
      - Enabling, Restarting and Disabling the SSR Component Database
  - Planning Your Session State Registrar Cluster
    - Planning the SSR Cluster Topology
      - Small-Scale Deployments
      - Identifying the C Series Controllers in the SSR Cluster
    - SSR Cluster Planning Worksheets
  - Configuring the Session State Registrar (SRC CLI)
  - Managing the SSR Cluster
  - Monitoring the SSR Cluster
- Using the Subscriber Information Collector
  - Overview of the Subscriber Information Collector
    - Subscriber Information Collector Overview
    - Managing Dynamic Services on RADIUS-Enabled Devices
    - SIC Dynamic Authorization Support Overview
      - Rendering
    - How the Dynamic Authorization Process Works in the SIC
    - Dynamic Authorization Targets (SRC CLI)
    - RADIUS Authentication/Authorization and Accounting Data Flow
    - Local and Shared Configurations for the SIC (SRC CLI)
      - Local Configuration
      - Shared Configuration
    - Accounting Methods and Targets (SRC CLI)
      - Using the SSR Database as the Accounting Method
        How the SIC Seamlessly Processes IP Address Changes When the SSR Database Is the Accounting Method
        Mapping Attributes When Using the Database Accounting Method
      - Using the Proxy RADIUS Accounting Method
    - Authentication Route Targets (SRC CLI)
    - Request Routing (SRC CLI)
      - Explicit Routing Rules
      - Implicit Routing Rules
    - SIC Editing Rules (SRC CLI)
    - RADIUS and Diameter Configuration for the SIC Overview (SRC CLI)
      - RADIUS Accounting and Authentication Listeners
      - SIC Diameter Server
        SIC Diameter Server Configuration Overview
      - RADIUS Network Elements
        Configuring Upstream RADIUS Network Elements Overview
        Configuring Downstream RADIUS Network Elements Overview
      - Using the Proxy Function to Define Implicit Routing Rules
    - Failover Policy
      - Failover Mode
        Round-Robin
        Primary or Backup
    - RADIUS and Diameter Transports
    - SIC Dictionaries and Device Models Overview (SRC CLI)
    - SIC Local Realms Overview
    - SIC Event Logging Overview (SRC CLI)
    - SNMP Support for the SIC Overview (SRC CLI)
  - Configuring the Subscriber Information Collector with the SRC CLI
    - SIC Configuration Summary
      - SIC RADIUS Configuration Summary (SRC CLI)
      - SIC RADIUS Dynamic Authorization Configuration Summary (SRC CLI)
      - SIC Diameter Configuration Summary (SRC CLI)
      - Configuring Management of RADIUS-Enabled Devices for the SIC (SRC CLI)
    - Configuring the Connection Between the SIC and the Juniper Networks Database (SRC CLI)
    - Creating an SIC Group and Server (SRC CLI)
    - Creating an SIC Server Instance (SRC CLI)
    - Configuring Dictionaries for the SIC Group (SRC CLI)
    - Configuring the Device Models Supported by the SIC Group (SRC CLI)
    - Configuring the RADIUS Accounting Listener for the SIC Group (SRC CLI)
      - Configuring the RADIUS Accounting Listener Queue Limits (SRC CLI)
      - Configuring the RADIUS Accounting Listener Transport (SRC CLI)
    - Configuring the RADIUS Authentication Listener for the SIC Group (SRC CLI)
      - Configuring the RADIUS Authentication Listener Queue Limits (SRC CLI)
      - Configuring the RADIUS Authentication Listener Transport (SRC CLI)
    - Configuring the Outbound RADIUS Transport of the SIC Group (SRC CLI)
    - Configuring the RADIUS Transport for an SIC Server (SRC CLI)
    - Configuring the SIC Diameter Server (SRC CLI)
      - Configuration Statements for the SIC Diameter Server (SRC CLI)
      - Configuring the SIC Diameter Server Identity (SRC CLI)
      - Configuring the SIC Diameter Server Peer (SRC CLI)
    - Configuring Upstream and Downstream RADIUS Network Elements (SRC CLI)
      - Configuration Statements for Downstream Network Elements and Accounting and Authentication Targets (SRC CLI)
      - Configuration Statements for Upstream Network Elements, Accounting and Authentication Clients, and Dynamic Authorization Targets (SRC CLI)
      - Creating a Network Element (SRC CLI)
      - Configuring the Device Models Supported in the Network Element (SRC CLI)
      - Configuring Upstream Network Elements and Accounting and Authentication Clients (SRC CLI)
      - Configuring Upstream Network Elements and Dynamic Authorization Targets (SRC CLI)
      - Configuring Downstream Network Elements and Accounting and Authentication Targets (SRC CLI)
        Configuring SIC Accounting Targets (SRC CLI)
        Configuring SIC Authentication Targets (SRC CLI)
      - Configuration Statements for SIC Group Failover Mode and Policy (SRC CLI)
      - Configuring Failover Mode and Policy (SRC CLI)
        Configuring Failover Mode (SRC CLI)
        Configuring Fast Fail Options for the Failover Policy
        Configuring Retry Options for the Failover Policy
    - Configuring What Realms Are Local to the SIC Group (SRC CLI)
    - Configuration Statements for SIC Editing Rules (SRC CLI)
    - Configuring the Optional Editing Rules Used by the SIC Group (SRC CLI)
    - Configuring the Accounting Method Used by the SIC Group (SRC CLI)
      - Configuring the SSR Database as the Accounting Method (SRC CLI)
      - Configuring Proxy RADIUS as the Accounting Method (SRC CLI)
    - Configuring the Authentication Target Used by the SIC Server (SRC CLI)
    - Configuring Request Routing (SRC CLI)
      - Configuration Statements for SIC Explicit Accounting Routing Rules
      - Configuration Statements for SIC Explicit Authentication Routing Rules
      - Configuring Explicit Routing (SRC CLI)
      - Configuring Implicit Routing (SRC CLI)
    - Configuring Event Logging for an SIC Server (SRC CLI)
    - Configuring SNMP for the SIC Group (SRC CLI)
    - Example: Basic SIC Group Configuration (SRC CLI)
    - Configuring the NAS Groups (SRC CLI)
      - Configuring NAS Groups
      - Configuring the NAS Group Device Capabilities (SRC CLI)
      - Classifying Interfaces
      - Configuring NAS Group Routes
    - Configuring the SAE to Manage AAA Devices
    - Configuring AAA Policies (SRC CLI)
      - Configuring AAA Policy Lists
      - Configuring AAA Policy Rules
      - Configuring Template Activation Actions
  - Device and Service Templates for Dynamic Authorization (SRC CLI)
    - Device and Service Template Configuration Overview (SRC CLI)
      - Device Template Configuration Overview (SRC CLI)
      - Service and Global Service Template Configuration Overview (SRC CLI)
        Mode
        Caveat (Cisco Only)
        Attributes
        Variables
        Overriding the Service Correlation ID
        Tagged Attributes
    - Configuring Device Templates (SRC CLI)
    - Configuring the Device Capabilities Supported in the Device Template (SRC CLI)
    - Configuration Statements for SIC Service Templates (SRC CLI)
    - Configuring SIC Service Templates (SRC CLI)
    - Configuration Statements for Tagged Attributes in SIC Service Templates (SRC CLI)
    - Configuring Tagged Attributes in SIC Service Templates (SRC CLI)
    - Configuration Statements for SIC Global Service Templates (SRC CLI)
    - Configuring Global Service Templates (SRC CLI)
    - Sample Service Templates
      - Juniper Networks Routers Service Template
      - Cisco Router Service Template
  - Monitoring the Subscriber Information Collector with the SRC CLI
- Controlling Volume Usage with the SRC VTA
  - Overview of Controlling Volume Usage with the SRC VTA
    - SRC VTA Overview
    - SRC VTA Architecture and Connections to Other SRC Components
    - How the SRC VTA Works
    - SRC VTA Operation
    - Configuring Event Handlers Overview
    - Configuring Actions Overview
      - On Error
    - Managing SRC VTA Accounts and Sessions Overview
      - Identifying Subscribers, SAEs, and Sessions
      - Managing SRC VTA Accounts and Sessions
    - Adjusting the Interim Accounting Interval Overview
    - Locating the SAE That Manages a Subscriber for the SRC VTA
    - Using JavaScript Programs in SRC VTA Configurations
    - SRC VTA SOAP Interface
      - SRC VTA SOAP Interface URL
    - Example: Limiting Subscriber Access Based on Account Balances
  - Prerequisites for Running the SRC VTA
  - Configuring the SRC VTA (SRC CLI)
    - Configuring an SRC VTA Shared Group Configuration (SRC CLI)
      - Creating and Configuring an SRC VTA Shared Group Configuration (SRC CLI)
      - Keys Used to Specify the Subscriber ID Solution (SRC CLI)
    - Configuring the Connection Between the SRC VTA and the External Account and Session Database (SRC CLI)
    - Cleaning Up the Sessions Records and SessionBalanceChanges Records from the SRC VTA Database (SRC CLI)
    - Configuring Actions for SRC VTA Event Handlers (SRC CLI)
    - Configuring Event Handlers (SRC CLI)
    - Configuring Event Queues for SRC VTA Groups (SRC CLI)
    - Configuring the DB-Engine Processor for the SRC VTA Group (SRC-CLI)
    - Configuring the Mailer Processor for the SRC VTA Group (SRC CLI)
      - Configuring the SRC VTA Mailer Processor to Send E-Mail Notifications (SRC CLI)
      - Configuring the SRC VTA to Send E-Mail Notifications (SRC CLI)
    - Configuring the SRC VTA Scripts Processor (SRC CLI)
    - Configuring SRC VTA Logging (SRC CLI)
      - Logging SRC VTA Messages to a Text File
      - Logging SRC VTA Messages to a System Logging Server
    - Enabling, Disabling, and Restarting the SRC VTA (SRC CLI)
    - Enabling the SOAP Interface for an SRC VTA Group (SRC CLI)
    - Methods for the SRC Volume Tracking Application SOAP Interface
    - SOAP Fault Codes for the SRC Volume Tracking Application
    - Using One SRC VTA Account for Multiple Subscriber Sessions
  - Managing the SRC VTA (SRC CLI)
  - Monitoring and Testing the SRC VTA
- Index
  - Index

A B C D E F G H I J L M N O P R S T U V W

access DNs
accounting
SAE, description
ACP (Admission Control Plug-In)
redundancy
monitoring
ACP congestion point usage trap
configuring
ACP.     See SRC ACP
action congestion points    1
configuring
monitoring
C-Web interface    1, 2
SRC CLI    1, 2
address pools.     See IP address pools
Admission Control Plug-In.     See SRC ACP
agents     See NIC agents
allocating bandwidth to applications not controlled by SRC ACP
APIs
SRC ACP
APIs (application programming interfaces)
CORBA remote API
NIC
provided with SAE
SAE core API
application programming interfaces.     See APIs
applications
executing with SRC ACP
external for use with SRC ACP    1, 2
assigned IP subscribers
third-party devices    1
IP address pools
assigning
edge congestion points to subscribers
interfaces to backbone congestion point profiles
interfaces to subscribers
ATM access network, using with SRC ACP
attributes
authentication plug-ins
virtual routers
SRC CLI    1, 2
authentication target
configuration
SRC CLI
authorizing and tracking services

backbone congestion point profiles
configuring
backbone congestion points    1
configuring
configuring for services
defining applications in
deriving
DNs of
monitoring
SRC CLI    1, 2
running applications from
backbone network
backbone network management with SRC ACP
configuring
background bandwidth
bandwidth
allocating to applications not controlled by SRC ACP
background    1, 2
configuring
for services    1, 2
for subscribers
downstream
upstream
bandwidths and congestion points for subscribers
configuring
basic group
configuration
SRC CLI
configuration summary
SRC CLI
configuring management of RADIUS-enabled devices for the SIC
SRC CLI
Diameter configuration summary
SRC CLI
RADIUS configuration summary
SRC CLI
RADIUS dynamic authorization configuration summary
SRC CLI
BEEP, devices running Junos OS    1
configuring port
SRC CLI
BEEP, Devices running Junos OS
connection
Blocks Extensible Exchange Protocol.     See BEEP

certificate authority (CA)
classification scripts
congestion point classification
configuring
criteria    1, 2
description
how it works
targets    1, 2
clients
gateway
Web Services Gateway
Common Object Request Broker Architecture.     See CORBA
community manager
configuring, third-party devices
SRC CLI
component interactions
devices running Junos OS and SAE
configuration group, devices running Junos OS    1, 2
configuration manager, instantiating for NIC
congestion point applications
SPI for ACP
congestion point classification    1, 2
congestion point classification scripts.     See classification scripts
congestion point expressions    1, 2
congestion point profiles    1
congestion point expressions
defining
congestion points    1, 2
configuring
defining applications in
deriving
deriving from congestion point expressions
deriving from profile
managing
modifying
monitoring    1, 2
retrieving information about
congestion points by IP address and associated service sessions
monitoring
SRC CLI
congestion points by login name and associated service sessions
monitoring
SRC CLI
congestion points by session ID and associated service sessions
monitoring
SRC CLI
conventions
notice icons
text
COPS (Common Open Policy Service)
connection with JunosE routers    1
configuring SAE, SRC CLI
disabling on router
enabling on router
COPS-PR versus COPS XDR
JunosE router connection
CORBA (Common Object Request Broker Architecture)
IOR location
remote API
CORBA interfaces
SRC ACP
CORBA-based plug-in SPI.     See plug-ins, external
customer support    1
contacting JTAC
customized interface modules

database accounting method
configuration
SRC CLI
deriving congestion points
device drivers
Gx
viewing state, SRC CLI
Junos
configuring, SRC CLI
viewing state, C-Web interface
viewing state, SRC CLI
viewing statistics, C-Web interface    1, 2
viewing statistics, SRC CLI    1, 2
JunosE
configuring, SRC CLI
viewing state, SRC CLI
viewing statistics, SRC CLI    1, 2
devices running Junos OS
BEEP connection    1
configuring port, SRC CLI
configuration groups
configuring to interact with SAE
default virtual router
Diameter connection
disabling interactions with SAE
enabling interactions with SAE
monitoring interactions with SAE
SAE interactions
SRC software process    1, 2
troubleshooting
Devices running Junos OS
configuration groups
SRC software process
directory
services for SRC ACP
subscribers for SRC ACP
directory blacklist, deleting    1, 2
distinguished name.     See DN
DMI
managing Junos DMI-enabled devices
overview
managing routers running Junos OS    1, 2
overview of managing DMI-enabled routers running Junos OS through Junos Space
SRC CLI
DMI driver
migrating
SRC CLI
DMI network device
adding
SRC CLI
DMI, devices running Junos OS
connection    1, 2
DN (distinguished name)
NIC resolution
DNs
backbone congestion points
edge congestion points
documentation
comments on
domain maps
reloading on SAE
downstream bandwidth
downstream RADIUS network elements and accounting targets
configuration statements
SRC CLI
downstream RADIUS network elements and authentication targets
configuration statements
SRC CLI

edge congestion points
assigning to subscribers
deriving
DNs of
monitoring
SRC CLI    1, 2
edge network    1, 2
edge network management, configuring
equipment registration
deleting    1, 2
event notification, PCMM network
configuration statements
properties, configuring
SRC CLI
event notification, third-party devices
description
events, publishing
external applications
displaying information from
interaction with NIC
monitoring
C-Web interface    1, 2
external plug-ins
configuring SRC ACP as
external plug-ins.     See plug-ins
External Subscriber Monitor
acting as pseudo RADIUS server, C-Web interface
agent process statistics, viewing
SRC CLI
configuring
configuring basic local properties
configuring client secret
configuring directory connection properties
configuring event notification
configuring eventing properties
configuring initial properties
configuring logging destinations
event notifications, monitoring
SRC CLI
event notifications, viewing
SRC CLI
IP address manager    1
C-Web Interface
overview, C-Web interface
starting
statistics, monitoring
SRC CLI
statistics, viewing
SRC CLI
stopping

failover parameters, SAE 1, 2
fault recovery, SRC ACP
files
ACP data

group
creation
SRC CLI
groups, NIC hosts
Gx router driver
adding router acting as PCEF
SRC CLI
charging rule installation
service activation
charging rule removal
service deactivation
charging rule report
Charging-Rule-Install
Gx router driver, configuring
SRC CLI
overview
SAE
mapping between concepts
SAE (service activation engine)
SAE plug-ins
service accounting
session creation
session detach
session reauthorization
session updation
viewing state, SRC CLI

hosted internal plug-in
hosted plug-ins. See plug-ins

interactions between SRC ACP and other components    1, 2
interface classification scripts
reloading on SAE    1, 2
interface modules, SAE
interfaces, assigning to backbone congestion point profiles
internal plug-ins.     See plug-ins
IOR
router initialization scripts    1, 2
IP address pools
local address pools, configuring
SRC CLI    1, 2
static pools, configuring
SRC CLI    1, 2
IP pools
updating
Junos VR
JunosE VR    1, 2

JunosE routers
accessing router CLI
COPS connection    1
configuring, SRC CLI
integration overview
monitoring interactions with SAE
router objects, adding
SRC CLI
SRC client    1
starting
stopping
troubleshooting
VR objects
adding individually, SRC CLI    1, 2
discovering, SRC CLI

LDAP access.     See SAE (service activation engine), configuring
local properties
configuration
SRC CLI
logging properties
configuring for SRC ACP
login names
login process
assigned IP subscribers, third-party devices
event notification method, third-party devices
login registration
deleting    1, 2

managing
congestion points
edge network with SRC ACP
manuals
comments on
methods
SRC Volume-Tracking Application
modifying congestion points
monitoring
backbone congestion points
SRC ACP
C-Web interface
SRC CLI

NAS port ID
network devices
SNMP communities, configuring
SRC CLI
network information collector.     See NIC
network interfaces    1, 2
network publisher     See NIC
NIC (network information collector)    1, See also other NIC entries
API
configuration prerequisites
C Series Controllers
configuration statements
configuration, changing
configuration, verifying
data mapping
default operating properties, viewing
factory interface    1, 2
logging
changing configuration
default
monitors
example
network publisher
overview
prerequisites
running
troubleshooting
operating properties, changing
overview
planning implementation
realms
overview
replication
groups
overview
SAE plug-in agents
replication, configuring
resolution processes    1, 2
resolvers
constraints
overview
restarting
results
intermediate
roles
starting
stopping
testing
any key
examples
resolution
test data
viewing
configuration
NIC agents
configuration overview
directory, configuring
SRC CLI
overview    1, 2
restarting
sae client agents, configuring
sae plug-in agents, configuring
NIC configuration scenarios
changing    1
SRC CLI
MultiPop
OnePop
OnePopAcctId
OnePopAllRealms
OnePopDnSharedIp
OnePopDynamicIp
OnePopLogin
OnePopLoginPull
OnePopPcmm
OnePopPrefixIp
OnePopPrimaryUser
OnePopSharedIp
OnePopStaticRouteIp    1, 2
OnePopTunnel
OnePopVrfIp    1, 2
overview    1, 2
scenario-name
NIC hosts
configuration prerequisites
groups
overview
redundancy
example
starting
stopping    1, 2, 3, 4
NIC locators
external applications    1, 2
overview    1, 2
NIC proxies
cache, configuring
SRC CLI
configuration overview
configuration prerequisites
instantiating
logging
NIC replication, configuring
SRC CLI
overview
prerequisites
removing instances
requirements    1, 2
resolution information, configuring
SRC CLI
resolution requests
NIC Proxy for Pseudo-RADIUS server
configuring
NIC proxy for Pseudo-RADIUS server
changing configuration
configuring for NIC replication
configuring resolution
NIC resolvers
restarting
nic-network-publisher-configuration-statements
notice icons

operation
SRC ACP, configuring

PacketCable Multimedia.     See PCMM
PCMM (PacketCable Multimedia)
SAE connection
plug-ins
architecture
authentication
virtual routers, SRC CLI    1, 2
external
hosted
hosted internal plug-in
internal
SRC ACP
tracking
virtual routers, SRC CLI    1, 2
types
preventing
service activation
priorityList
properties
SRC ACP
proxy RADIUS accounting method
configuration
SRC CLI
pseudo-RADIUS server
configuring External Subscriber Monitor
publishing events

RADIUS accounting listener
configuring
SRC CLI    1, 2
RADIUS accounting listener queue limits
configuration
SRC CLI
RADIUS accounting listener transport
configuration
SRC CLI
RADIUS authentication listener queue limits
configuration
SRC CLI
RADIUS authentication listener transport
configuring
SRC CLI
randomPick
realm
     See NIC realms
redundancy, SRC ACP
rendering
resolution processes
DN to SAE reference    1, 2, 3
IP address to login name
IP address to SAE reference    1, 2, 3, 4, 5, 6
login name to SAE reference
roles, NIC
roundRobin
router initialization scripts
developing    1, 2
iorPublisher    1, 2
isePoolPublisher    1, 2
Junos
configuring location, SRC CLI
JunosE
configuring location, SRC CLI
example    1, 2
JunosE Software    1, 2
poolPublisher    1, 2
specifying for NIC
router object
adding for third-party devices
SRC CLI
routers
accessing router CLI
adding devices running Junos OS
SRC CLI
adding JunosE
SRC CLI
configuring SAE to communicate with Junos Space
SRC CLI
integrating devices running Junos OS    1, 2, 3
integrating JunosE
SNMP communities, configuring
SRC CLI

SAE (service activation engine)
accounting
APIs.     See APIs
BEEP connection, devices running Junos OS
COPS
JunosE router connection
deleting directory blacklist    1, 2
device running Junos OS client
Diameter connection, devices running Junos OS
disabling interactions with device running Junos OS
enabling interactions with device running Junos OS
failover parameters    1, 2
Gx router driver
monitoring interactions
device running Junos OS
JunosE routers
NIC replication, configuring
SRC CLI
overview
PCMM environment
plug-ins     See plug-ins
reloading configuration    1, 2, 3, 4
role
router initialization scripts.     See router initialization scripts
session store
C Series Controllers
starting
SRC client on JunosE router
stopping
SRC client on JunosE router
SAE (service activation engine), configuring
BEEP connection
SRC CLI
COPS connection
SRC CLI
directory eventing, SAE configuration data
SRC CLI
event notification API properties
SRC CLI
LDAP access, SRC CLI
device data
directory data
persistent login cache data
policy data
service data
subscriber data
router initialization script location
SRC CLI    1, 2
serialized data compression
SRC CLI
session job manager
SRC CLI
session store
SRC CLI
SRC ACP
SAE (service activation engine),configuring
to monitor backbone congestion points
SAE communities
configuring, third-party devices
SRC CLI
description, third-party devices
SAE remote interface
customized interface modules
script services
for third-party devices
serialized data compression, configuring
SRC CLI
service activation engine.     See SAE
services
configuring bandwidth for    1, 2
monitoring
C-Web interface
SRC CLI
preventing activation
reloading on SAE    1, 2
session job manager, configuring
SRC CLI
session state registrar     See SSR
session store
C Series Controllers
configuring, SRC CLI
compressing session objects
global parameters
in third-party networks
SIC
device models in network element
configure
failover mode
configure
failover mode and policy
configure    1, 2
fast fail options for the failover policy
configure
retry options for the failover policy
configure
SIC (subscriber information collector)
accounting listener
overview
accounting methods
overview
authentication methods
overview
configuring basic SIC group
1
database accounting method
overview
overview mapping attributes    1, 2
default attributes in tagged attribute group, configuring
SRC CLI
device capabilities, configuring
SRC CLI
device models
overview
device models, configuration
SRC CLI
device templates, configuring
SRC CLI
Diameter server
overview
statements
Diameter server identity, configuring
SRC CLI
Diameter server peer, configuring
SRC CLI
Diameter server, configuring
SRC CLI
dictionaries
overview
dictionaries, configuration
SRC CLI
downstream network element
overview
dynamic authorization
how the process works
overview    1, 2, 3
editing rules
overview
editing rules, configuration
SRC CLI
editing rules, configuration statements
SRC CLI
event logging
event level
log file
log stream
overview
event logging, configuration
SRC CLI
explicit authentication routing, configuration statements
SRC CLI
explicit routing rules
overview
explicit routing, configuration
SRC CLI    1, 2
explicit routing, configuration statements
SRC CLI
failover mode
overview    1, 2
failover policy
overview    1, 2
global service template default attributes, configuring
SRC CLI
global service template mode, configuring
SRC CLI
global service template normal attributes, configuring
SRC CLI
global service template override attributes, configuring
SRC CLI
global service template parameterized attributes, configuring
SRC CLI
global service template required attributes, configuring
SRC CLI
global service template variables, configuring
SRC CLI
global service templates, configuring
SRC CLI
global service templates, creating
SRC CLI
global service templates, overview
SRC CLI
implicit routing rules
overview
implicit routing, configuration
SRC CLI
local and shared configuration
overview
local realms
overview
local realms, configuration
SRC CLI
normal attributes in tagged attribute group, configuring
SRC CLI
override attributes in tagged attribute group, configuring
SRC CLI
overview
parameterized attributes in tagged attribute group, configuring
SRC CLI
primary/backup
overview    1, 2
proxy accounting method
overview
proxy function
overview
RADIUS configuration
overview
RADIUS transport for server, configuring
SRC CLI
RADIUS transports
overview
request routing rules
overview
request routing, configuring
SRC CLI
required attributes in tagged attribute group, configuring
SRC CLI
round robin
overview    1, 2
server instance, creation
SRC CLI
service template default attributes, configuring
SRC CLI
service template mode, configuring
SRC CLI
service template normal attributes, configuring
SRC CLI
service template override attributes, configuring
SRC CLI
service template parameterized attributes, configuring
SRC CLI
service template required attributes, configuring
SRC CLI
service template samples
SRC CLI
service template variables, configuring
SRC CLI
service template, configuration statements
SRC CLI
service template, tagged attribute configuration statements
SRC CLI
service templates, configuring
SRC CLI
service templates, creating
SRC CLI
service templates, overview
SRC CLI
SNMP support
overview
snmp, configuring
SRC CLI
statistics
accounting transactions
authentication transactions
client accounting requests
client authentication requests
Diameter host
Diameter peer
target accounting requests
target authentication requests
tagged attribute group, creating
SRC CLI
tagged attributes in, configuring
SRC CLI
upstream network element
overview
SIC accounting and authentication clients
configuring
SRC CLI
SIC accounting and authentication targets
configuring
SRC CLI
SIC accounting targets
configuring
SRC CLI
SIC authentication targets
configuring
SRC CLI
SIC dynamic authorization targets
configuring
SRC CLI
SIC upstream and downstream network elements
configuring
SRC CLI
creating
SRC CLI
SNMP
retrieving information from network devices
SNMP communities
configuring
SRC CLI
SOAP
interfaces
Soap Fault Codes
VTA
Method
SRC ACP (SRC Admission Control Plug-In)    1
API
ATM access network
authorizing and tracking services
backbone network management, configuring
classification scripts
configuring
configuring
congestion points
connections to services directory, configuring
connections to subscribers’ directory, configuring
CORBA interfaces, configuring
data files
data files, reorganizing
description of
event publishers, configuring
external applications    1, 2
external plug-in for SAE, configuring
fault recovery
groups, configuring    1, 2
information from external applications, displaying
interactions with other components
logging properties, configuring
monitoring
C-Web interface
SRC CLI
operation, configuring
preventing service activation
properties
redundancy    1
configuring
SAE, configuring for
starting
state synchronization    1
configuring
stopping
subscribers, monitoring    1, 2
supporting multiple SAEs
using multiple SRC ACPs
SRC ACP (SRC Admission Control Plug-In), congestion points
SRC Admission Control Plug-In.     See SRC ACP
SRC client, JunosE routers
configuring
starting
stopping
SRC software process, Devices running Junos OS
SRC software process, devices running Junos OS    1, 2
disabling
reenabling
SRC Volume Tracking Application
API
SRC Volume-Tracking Application    SRC Volume-Tracking Application     See SRC VTA
SOAP interface
methods
SRC Volume-Tracking Application (SRC VTA)
account and session database connection, configuring     See SRC CLI
database deadlocks
troubleshooting
database to store account and session data, configuring     See SRC CLI
db-engine processor
configuring
group, configuring     See SRC CLI
JDBC .jar file     See installing
keys to specify subscriber-id-solution     See SRC CLI
tracking events
configuring
SRC Volume-Tracking Application (VTA)
group
configuring
SRC Volume-Tracking Application.     See SRC VTA
SRC VTA
accounts and service sessions
modifying
balance change history records
deleting
events
testing
performance statistics
monitoring
viewing
session history records
deleting    1, 2
sessions
terminating
SOAP API statistics
viewing
subscriber accounts
viewing
subscriber balance changes
viewing
subscriber session history
viewing
testing configuration
overview
SRC VTA (SRC Volume-Tracking Application (SRC VTA)
enabling
SRC VTA (SRC Volume-Tracking Application)
account and session database connection, configuration
SRC CLI
accounts
description
interim accounting interval, setting
service
subscriber
usage metric, setting    1, 2, 3
actions    1
overview
architecture
bought account
bought quota    1
example
connections to SRC components
database
optimizing
database engine processor
configuring
db-engine processor
configuring
e-mail notifications, sending
event attributes
event handlers
event queue
configuring
events    1
account update
callback
tracking events from SAE
example
limiting subscriber access
functions
overview
group, configuring
SRC CLI    1, 2
how it works
initial account balance
setting
initial account status
setting
interval accounting interval, setting    1, 2
JavaScript programs
keys to specify subscriber-id-solution
SRC CLI
logging events to a text file
configuration
configuring
mail processor
configuring
on-error
overview
operation process
overview
periodic account
periodic quota    1
example
processors
providing volume-based services
quota service    1
activation upon deposit
related configuration tasks
identifying subscribers, SAEs, and sessions
tracking plug-ins, enterprise subscribers
SAE events
saving event messages on a system logging server
configuration
configuring
script runner processor
configuring
scripts
external    1, 2
JavaScript programs
services
interim accounting interval, setting
sessions
subscriber login with IP address
types
usage metric, configuring    1, 2, 3
SRC VTA (Volume-Tracking Application)
actions
configuring
database deadlocks
troubleshooting
event handlers
configuring
function
configuring
on-error
configuring
related configuration tasks
NIC
NIC proxies
services and policies
subscribers and subscriptions
SSR (session state registrar)
adding a client node to an active cluster
SRC CLI
adding a management server to a client node in an active cluster
SRC CLI
adding data nodes to an active cluster
SRC CLI
attribute associations, configuring in an active cluster
SRC CLI
cluster configurations
cluster network requirements
cluster status, viewing
SRC CLI
configuration statements
configuring
cluster name
cluster nodes
database memory size
geometry
initial cluster
management server
subscriber sessions schema    1, 2
creating
database
database memory requirements, viewing
SRC CLI
database mode, viewing
SRC CLI
database modes
database schema
database schema, configuring in an active cluster
SRC CLI
database, viewing running configuration
SRC CLI
deleting
all subscriber and service sessions
database
subscriber sessions by IP address
disabling
SSR component database
distributing the cluster configuration
enabling
SSR component database
impact of configuration changes
making modifications to subscriber sessions table
node groups
node types
overview
placing
SSR database into maintenance mode
SSR database into production mode
planning the cluster topology
planning worksheets
removing
client node
data nodes
management server
restarting
SSR component database
scaling the cluster
server requirements
supported configurations
viewing, all subscriber sessions
SRC CLI
viewing, subscriber sessions by indexed field
SRC CLI
viewing, subscriber sessions by IP address
SRC CLI
viewing, total number of subscriber sessions
SRC CLI
starting
SRC ACP
state synchronization
SRC ACP
statistics, SRC ACP
monitoring
C-Web interface    1, 2, 3
stopping SRC ACP
subscriber information collector    subscriber information collector     See SIC
authentication target, configuring
basic group, configuring
configuration summary
SRC CLI
configuring management of RADIUS-enabled devices for the SIC
SRC CLI
database accounting method, configuring
default attributes in tagged attribute group, configuring     See SIC
device capabilities, configuring     See SIC
device models, configuring     See SIC
device templates, configuring     See SIC
Diameter configuration summary
SRC CLI
Diameter server     See statements
Diameter server identity, configuring     See SIC
Diameter server peer, configuring     See SIC
Diameter server, configuring     See SIC
dictionaries, configuring     See SIC
dynamic authorization
how the process works
overview
editing rules, configuration statements     See SIC
editing rules, configuring     See SIC
event logging, configuring     See SIC
explicit authentication routing, configuration statements     See SIC
explicit routing, configuration statements     See SIC
explicit routing, configuring     See SIC
global service template default attributes, configuring     See SIC
global service template mode, configuring     See SIC
global service template normal attributes, configuring     See SIC
global service template override attributes, configuring     See SIC
global service template parameterized attributes, configuring     See SIC
global service template required attributes, configuring     See SIC
global service template variables, configuring     See SIC
global service templates, configuring     See SIC
global service templates, creating     See SIC
global service templates, overview     See SIC
group, creating
implicit routing, configuring     See SIC
local properties
directory connection properties, configuring
local realms, configuring     See SIC
normal attributes in tagged attribute group, configuring     See SIC
outbound RADIUS transport for group, configuring     See SIC
override attributes in tagged attribute group, configuring     See SIC
parameterized attributes in tagged attribute group, configuring     See SIC
proxy RADIUS accounting method, configuring
RADIUS accounting listener queue limits, configuring
RADIUS accounting listener transport, configuring
SRC CLI
RADIUS accounting listener, configuring    1, 2
RADIUS authentication listener queue limits, configuring
RADIUS authentication listener transport, configuring
SRC CLI
RADIUS configuration summary
SRC CLI
RADIUS dynamic authorization configuration summary
SRC CLI
RADIUS transport for server, configuring     See SIC
request routing, configuring     See SIC
required attributes in tagged attribute group, configuring     See SIC
server instance, creating     See SIC
service template default attributes, configuring     See SIC
service template mode, configuring     See SIC
service template normal attributes, configuring     See SIC
service template override attributes, configuring     See SIC
service template parameterized attributes, configuring     See SIC
service template required attributes, configuring     See SIC
service template samples     See SIC
service template variables, configuring     See SIC
service template, configuration statements
SRC CLI
service template, tagged attribute configuration statements
SRC CLI
service templates, configuring     See SIC
service templates, creating     See SIC
service templates, overview     See SIC
snmp, configuring     See SIC
tagged attribute group, creating     See SIC
tagged attributes in service templates, configuring     See SIC
subscriber information collector (SIC)
accounting and authentication clients
configuring
accounting and authentication targets
configuring
accounting targets
configuring
authentication targets
configuring
device models in network element
configure
dynamic authorization targets
configuring
failover mode
configure
failover mode and policy
configure    1, 2
fast fail options for the failover policy
configure
retry options for the failover policy
configure
upstream and downstream network elements
configuring
creating
subscribers
assigning interfaces to
configuring bandwidths and congestion points for    1, 2
IP addresses
login names
monitoring
C-Web interface    1, 2
SRC CLI    1, 2
provisioned and actual bandwidths
subscriptions
reloading on SAE    1, 2
support, technical     See technical support

targets.     See classification scripts
technical support
contacting JTAC
text conventions defined
third-party devices
creating sessions
integrating into SRC network
SRC CLI
logging in subscribers
assigned IP method
overview
provisioning with script services
router objects, adding
SRC CLI
SAE communities
VR objects, adding
SRC CLI
threads
configuring for sessions
SRC CLI
tracking plug-ins
virtual routers
SRC CLI    1, 2
troubleshooting
devices running Junos OS
JunosE routers
tuning factors for background bandwidth

upstream bandwidth
upstream network elements, accounting and authentication clients, and dynamic authorization targets
configuration statements
SRC CLI    1, 2

virtual routers
adding for third-party devices
SRC CLI
adding individually for JunosE routers
SRC CLI    1, 2
adding operative VRs    1
SRC CLI
Volume-Tracking Application (VTA)
prerequisites for running
VTA     See SRC VTA
VTA (SRC Volume-Tracking Application)
accounts
calculating interim interval
calculating usage
getting balances
event attributes
event handlers    1
overview
event queue
deleting
events
SAEEventListener
sessions
closing
VTA (Volume-Tracking Application)
database to store account and session data, configuration
SRC CLI
prerequisites for running
SRC CLI
tracking events
configuring

Web application server
application deployment
channel stack
configuring
configuration statements
SRC CLI
configuring the Web application server
SRC CLI
installing Web applications inside
local properties
configuring
multicast-address
configuring
node-id
configuring
shared cluster name
configuring
shared cluster nodes
configuring
shared cluster properties
configuring
starting
Web Services Definition Language.     See WSDL
Web Services Gateway
clients
managing
WSDL files

Download This Guide

Download this guide: SRC PE 4.9.x Network Guide

Configuring Event Handlers Overview

Event handlers define how the SRC VTA processes events. An event handler configuration includes the following options:

Events—Type of event including tracking, update, or callback event; for example, a service-start tracking event.
Priority—Priority at which event handlers are evaluated and executed. Event handlers are evaluated and executed from low to high.
Condition—Condition that the event handler evaluates to determine whether the event handler should process the event.
Actions—List of actions to be performed by the event handler.

You can set up multiple event handlers to process events. For example, the first event handler could retrieve the balance for a quota account, and the next event handler could refill the quota account depending on whether the condition of the second event handler is met.

When an event is received, the corresponding event type and condition configured for the event handler are evaluated based on the priority. When a condition is met, the corresponding actions are performed according to the event attributes. The action can update or add event attributes to the events for subsequent processing of the same event. An action can invoke a function provided by any processor. After an event handler has completed its processing, event processing continues with the next applicable event handler.

The SRC VTA communicates with the SAE through the Enterprise JavaBean (EJB) adapter plug-in. When an event is sent by the ejb-adapter plug-in on the SAE, it is received by the SAEEventListener, which places the event in the event queue. Because you can have multiple VTA instances, each SRC VTA has a separate SAEEventListener. The SRC VTA takes events one by one and presents them to an ordered sequence of event handlers. Each event handler includes a list of actions. If the event handler is configured to handle the event, it acts on the event based on the configured actions—for example, updating a balance or starting a service. Each action can specify a function.

The ejb-adapter plug-in can use either the round-robin algorithm or the primary/backup algorithm to send events from the SAE to the SRC VTAs. When you configure the ejb-adapter plug-in, you specify a comma-separated list of SRC VTA IP addresses or hostnames. When you use the round-robin algorithm, an outgoing event from the SAE is sent to each of the SRC VTAs specified in the comma-separated list until it is handled by one of the SRC VTAs. When you use the primary/backup algorithm, the first SRC VTA in the comma-separated list is the primary SRC VTA; all others are secondary SRC VTAs. All outgoing events from the SAE are forwarded to the primary SRC VTA until it becomes full or inaccessible. When the handling of an event fails in the primary SRC VTA, the event is sent to the secondary VTAs in a round-robin fashion until one of the secondary SRC VTAs handles the event. On successful handling of the event, the secondary SRC VTA is promoted and becomes the new primary SRC VTA.

Priority

When you configure an event handler, you need to specify the priority for evaluating and running the event handler. The priority is an integer where the smaller number has the higher priority. The event handler with the highest priority receives the event, determines whether the event’s type is the same as the event type of the event handler, and determines whether the event satisfies the condition of the event handler. When an event handler finishes processing an event, the next applicable event handler according to the priority of the event handler processes the event.

Events

Each SRC VTA event corresponds to one subscriber and contains some attributes. The SRC VTA supports the following event types:

Service and subscriber tracking events from the SAE; for example, start or stop tracking events.
Account update events triggered by updating database accounts.
Callback events triggered by an SRC VTA API call.

Various events can be received by the SRC VTA from the SAE. Table 49 describes the events supported by the SRC VTA.

Table 49: SRC VTA Event Types

Event	Description
account-update	Database update event
callback:callid	External callback event for the specified call
service-interim:service name	Service interim–tracking event for the specified service
service-start:service name	Service start–tracking event for the specified service
service-stop:service name	Service stop–tracking event for the specified service
user-interim	User interim–tracking event
user-start	User start–tracking event
user-stop	User stop–tracking event

The service-name is the name of any configured SRC service.

To process an event, the event handler must be configured to handle the particular event type. You configure which events are handled by the event handler with the shared vta group name event-handler event-handler-name events events statement. Separate events with a comma. You can configure an event handler to handle multiple event types. If an event handler is configured to handle an event, it can pass that event to a sequence of actions.

An example of an event is:

service-start: QuotaInternet, callback: TerminateSession

The SRC software supports wildcard characters to configure an event for the specified service in event handler.

Event Attributes

Each event carries attributes. Table 50 describes the types of attributes that are available for each type of event.

Table 50: Event Attributes

Event Type	Available Attributes
Service and subscriber tracking events from the SAE	Plug-in attributes, such as PA_SERVICE_NAME or PA_LOGIN_NAME, associated with an SAE plug-in event. For a list of SAE plug-in events, see Testing the SRC VTA Configuration Overview. currentTime attribute—Time since January 1, 1970 UTC when the SRC VTA begins passing the event to the event handlers (events are queued in the event queue and then passed to the event handlers). The value is the number of milliseconds in the range 0–9223372036854775807. subscriberId—Subscriber ID based on attributes of a service or a subscriber-tracking event. The subscriberId event attribute is a result of the calculation. It identifies the subscriber of the corresponding SRC VTA event.
Account update events	old_status_accountname—The old status of the account. new_status_accountname—Returns the new status of the specified account. old_lastUpdateTime_accountname—Returns the old last update time of the account. new_lastUpdateTime_accountname—Returns the new last update time of the account. old_balance_accountname—Returns the old balance of the account. new_balance_accountname—Returns the new balance of the specified account currentTime—Time since January 1, 1970 UTC, when the SRC VTA begins passing the event to the event handlers (events are queued in the event queue and then passed to the event handlers). The value is the number of milliseconds in the range 0–9223372036854775807. subscriberId—Subscriber ID based on attributes of a service or a subscriber-tracking event. The subscriberId event attribute is a result of the calculation. It identifies the subscriber of the corresponding SRC VTA event.
Callback events	callId—When the callback event type is invoked the callId value is specified. The callId value is placed in to the event using this event attribute and then processed. If an event handler is configured to handle this event type, the actions specified for the event handler can invoke functions, which have access to the callId in this event attribute. currentTime—Time since January 1, 1970 UTC, when the SRC VTA begins passing the event to the event handlers (events are queued in the event queue and then passed to the event handlers). The value is the number of milliseconds in the range 0–9223372036854775807. subscriberId—Subscriber ID based on attributes of a service or a subscriber-tracking event. The subscriberId event attribute is a result of the calculation. It identifies the subscriber of the corresponding SRC VTA event.

Glob Pattern

Use glob pattern matching when you configure an event for the specified service in event handler. The pattern matching happens only when SRC VTA receives a new service event from the SAE. After the pattern matching, the service name related event handlers are evaluated and executed based on the priority.

Use the following wildcard characters when you configure an event for the specified service in event-handler:

*—Matches any substring.
?—Matches any single character.
[range]—Matches a single character in the specified range. Ranges can have the form a-z, abcd, 0-9 or A-Z.
[!range]—Matches a single character outside the specified character or range of characters.

An example of an event for the specified service with a wildcard pattern:

service-start: Int8192-Usage_[!1-3]

Matches any service event that starts with Int8192-Usage_ and ends with a value other than 1, 2, or 3. In this case, the ‘does not match’ condition is checked because in this case the pattern begins with “!”.

Table 51 lists some examples of events with wildcard pattern and conditions.

Table 51: Wildcard Pattern and Conditions

Wildcard Pattern	Match Condition	Does not Match Condition
Int8192-Usage	Int8192-Usage	Int8192-VTA
Int8192-Usage?3.3	Int8192-Usage_3.3 Int8192-Usage13.3 Int8192-Usage-3.3	Int8192-Usage3.3
Int8192-Usage_[0-3%]	Int8192-Usage_1 Int8192-Usage_%	Int8192-Usage_6
Int8192-Usage_[1-47a-f]	Int8192-Usage_2 Int8192-Usage_7 Int8192-Usage_c	Int8192-Usage_6 Int8192-Usage_g Int8192-Usage_C
Int8192-Usage_[!a-c]	Int8192-Usage_d Int8192-Usage_1	Int8192-Usage_a Int8192-Usage_b
Int8192-Usage_[!1-3]	Int8192-Usage_6 Int8192-Usage_4	Int8192-Usage_2 Int8192-Usage_1

Guidelines for Using Glob Pattern in an Event Handler

Keep in mind the following considerations when using a wildcard pattern to configure service name related event in event-handler:

Glob matches are case sensitive.
A minor change in wildcard pattern may match unexpected events.
Must be aware of wildcard pattern and choose a wise configuration.

Follow these guidelines when using wildcard pattern:

Enclose patterns in double quotes.
For example:
root@c5bng-src10# set RecordUsage events "service-start:Quota[2-3]"
Verify the VTA information logs after you configure a wildcard pattern in the VTA event handler and confirm that the event handlers are loaded as expected.
It is advised to use the same wildcard pattern throughout the event configuration, when you use a wildcard character for a service name in event-handler.
For example:
In GetQuota eventhandler configuration, if you use “service-start:Video-*” wildcard pattern for matching all the corresponding events and you want to match the same set of services in NoQuota eventhandler configuration, you must use the same “service-start:Video-*” wildcard pattern.
When you use the event name with a wildcard pattern which is also the service name, both the service name and the wildcard pattern matching the service name are considered for processing.
For Example:
For the “service-interim:Sample[1-6]Test” event, the wildcard matches service names such as Sample[1-6]Test (which is a part of the event), Sample1Test, Sample2Test, Sample3Test, Sample4Test, Sample5Test, and Sample6Test.
When you specify the priority for evaluating and running an event handler, you must set different priorities for different event handlers. The event gets dropped when it has more than one event handler with same priority.

Condition

Each event handler evaluates conditions to determine whether it should handle the event. You specify the condition as a script written in the JavaScript programming language that must return one of the following values:

True—Event handler should handle the event.
False—Event handler should not handle the event.

If the condition is met, the SRC VTA performs the corresponding actions based on the event attributes. An action invokes a function and provides the parameters required by that function to the db-engine processor. If no condition is specified, true is returned as the value. If a referenced attribute does not exist in the event, the referenced attribute’s value is null. Following is an example condition:

var newBalance=<balance_BoughtQuota>+<balance_PeriodicQuota>; if(<old_balance_PeriodicQuota>==null) <old_balance_PeriodicQuota>=<balance_PeriodicQuota>; if(<old_balance_BoughtQuota>==null) <old_balance_BoughtQuota>=<balance_BoughtQuota>; return <old_balance_PeriodicQuota>+<old_balance_BoughtQuota><=0&&newBalance>0;

Note: In any condition or other JavaScript script, event attributes are referred to by enclosing them in angle < > brackets.

Actions

When you configure an event handler, you specify actions that the event handler executes in response to an event; for example, updating an account balance, starting a service, or stopping a service. An action is performed only if the event matches the specified event type and condition you configure for the event handler. An action can invoke functions provided by any processor.

Note: We recommend that when you configure event handlers and their actions, you ensure that for any given event, all database operations are performed before any other operations that have permanent effects. This is because if a database error occurs—for example, due to normal contention for database records between different event threads—the SRC VTA rolls back the current database transaction (no changes are made to the database) and then restarts processing the event. If the event performs some other operation other than database operations before such an error, such as start a service, then that other operation is performed again when the event is reprocessed following the error.