SRC-PE Network Guide

About This Guide
Objectives
Audience
Documentation Conventions
Related Juniper Networks Documentation
Obtaining Documentation
Documentation Feedback
Requesting Support
Overview of the SAE
Role of the SAE
Connections to Managed Devices
COPS Connection Between JUNOSe Routers and the SAE
Beep Connection Between JUNOS Routing Platforms and the SAE
COPS Connection Between CMTS Devices and the SAE
COPS Connection Between Juniper Policy Servers and the SAE
SAE Plug-Ins
Internal Plug-Ins
External Plug-Ins
Hosted Plug-Ins
Tracking and Controlling Subscriber and Service Sessions with SAE APIs
SAE Core API
SAE CORBA Remote API
SAE Accounting
Accounting Policy
Subscription Process
Tracking Subscriber Sessions
Accounting Plug-Ins
Interim Accounting
Configuring the SAE with the SRC CLI
Configuring LDAP Access to Directory Data
Configuring Access to Subscriber Data
Related Information
Configuring Access to Service Data
Related Information
Configuring Access to Policy Data
Related Information
Configuring Access to the Persistent Login Cache
Related Information
Configuring the Location of Network Device Data
Related Information
Enabling Automatic Discovery of Changes in SAE Configuration Data
Related Information
Setting the Timeout and Number of Events for SAE Directory Eventing
Related Information
Storing Subscriber and Service Session Data
Session Store Files
Active and Passive Session Stores
Session Store File Rotation
Configuring the Session Store Feature
Configuring Session Store Parameters for a Device Driver
Related Information
Configuring Global Session Store Parameters
Related Information
Reducing the Size of Objects for the Session Store Feature
Related Information
Configuring the Number of Threads for Sessions
Configuring the SAE with SDX Configuration Editor
Overview of Configuring the SAE
Configuring LDAP Access to Directory Data
Configuring Access to Subscriber Data
User Data Fields
Configuring Access to Service Data
Service Data Fields
Configuring Access to Policy Data
Policy Data Fields
Configuring Access to the Persistent Login Cache
Persistent Login Cache Data Fields
Configuring the Location of Router, Persistent Login, and Persistent Session Data
Router Data, DHCP Persistent Login Information, and Persistent Session Data Fields
Enabling Automatic Discovery of Changes in SAE Configuration Data
Enable Configuration Directory Eventing Field
Storing Subscriber and Service Session Data
Session Store Files
Active and Passive Session Stores
Session Store File Rotation
Configuring the Session Store Feature
Configuring Session Store Parameters for a Device Driver
Session Store Fields
Configuring Global Session Store Parameters
Global Session Store Fields
Reducing the Size of Objects for the Session Store Feature
Compressed Serialized Data Field
Configuring the Number of Threads for Sessions
Number of Threads for Sessions Field
Managing SAE Data with the SRC CLI
Commands to Manage SAE
Reloading the SAE Data
Reloading the SAE Configuration
Reloading Services
Reloading Subscriptions
Reloading Interface Classification Scripts
Reloading Domain Maps
Updating Memory Usage
Removing the Directory Blacklist
Removing Login Registrations
Removing Equipment Registrations
Modifying Failover Server Parameters
Shutting Down the Device Drivers
Using JUNOSe Routers in the SRC Network with the SRC CLI
COPS Connection Between JUNOSe Routers and the SAE
Adding JUNOSe Routers and Virtual Routers with the CLI
Adding Operative JUNOSe Routers and Virtual Routers
Adding Routers Individually
Adding Virtual Routers Individually
Related Information
Configuring the SAE to Manage JUNOSe Routers with the CLI
Related Information
Using SNMP to Retrieve Information from JUNOSe Routers
Configuring the SNMP Server on the JUNOSe Router
Configuring Global SNMP Communities in the SRC Software
Developing Router Initialization Scripts
Interface Object Fields
Required Methods
Example: Router Initialization Script
Specifying Router Initialization Scripts on the SAE with the 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 JUNOSe Router
Troubleshooting Problems with Managing JUNOSe Routers
Troubleshooting the SRC Client on JUNOSe Routers
Viewing the State of JUNOSe Device Drivers with the SRC CLI
Viewing Statistics for Specific JUNOSe Device Drivers with the SRC CLI
Viewing Statistics for All JUNOSe Device Drivers with the SRC CLI
Viewing the State of JUNOSe Device Drivers with the C-Web Interface
Viewing Statistics for Specific JUNOSe Device Drivers with the C-Web Interface
Viewing Statistics for All JUNOSe Device Drivers with the C-Web Interface
Using JUNOSe Routers in the SRC Network with a Solaris Platform
COPS Connection Between JUNOSe Routers and the SAE
Adding JUNOSe Routers and Virtual Routers
Adding Operative JUNOSe Routers and Virtual Routers
Adding Routers Individually
Router Fields
Adding Virtual Routers Individually
Virtual Router Fields
Specifying the SAEs That Can Manage the Router
Adding an SAE
Modifying an SAE Address
Deleting an SAE Address
Configuring the SAE to Manage JUNOSe Routers
JUNOSe Router Driver Fields
Using SNMP to Retrieve Information from JUNOSe Routers
Configuring the SNMP Server on the JUNOSe Router
Configuring Global SNMP Communities in the SRC Software
Global SNMP Community Fields
Developing Router Initialization Scripts
Interface Object Fields
Required Methods
Example: Router Initialization Script
Specifying Router Initialization Scripts on the SAE
JUNOSe Router Script Fields
Updating Local IP Address Pools for JUNOSe VRs
Updating Local IP Address Pools with SDX Admin
Updating Local IP Address Pools with the poolRepublish Command
Syntax of poolRepublish Command
Troubleshooting the poolRepublish Command
Accessing the Router CLI
Using Policy Editor
Using SDX Admin
Remote Access Fields
Starting the SRC Client on a JUNOSe Router
Stopping the SRC Client on a JUNOSe Router
Monitoring Interactions Between the SAE and the JUNOSe Router
Troubleshooting the SRC Client on JUNOSe Routers
Using JUNOS Routing Platforms in the SRC Network with the SRC CLI
BEEP Connection Between JUNOS Routing Platforms and the SAE
Adding JUNOS Routing Platforms and Virtual Routers
Adding Operative JUNOS Routing Platforms
Adding Routers Individually
Adding Virtual Routers Individually
Related Information
Configuring the SAE to Manage JUNOS Routing Platforms
Related Information
Configuring Secure Connections Between the SAE and JUNOS Routing Platforms
Manually Obtaining Digital Certificates
Obtaining Digital Certificates through SCEP
Installing the Server Certificate on the Router
Creating a Client Certificate for the Router
Installing the Client Certificate on the Router
Configuring the SAE to Use TLS
Configuring TLS on the SAE
Checking Changes to the JUNOS Configuration
Setting Up Periodic Configuration Checking
Using SNMP to Retrieve Information from JUNOS Routing Platforms
Configuring Global SNMP Communities in the SRC Software
Developing Router Initialization Scripts
Interface Object Fields
Required Methods
Example: Router Initialization Script
Specifying Router Initialization Scripts on the SAE
Accessing the Router CLI
Configuring JUNOS Routing Platforms to Interact with the SAE
Configuring the JUNOS Routing Platform to Apply Changes It Receives from the SAE
Disabling Interactions Between the SAE and JUNOS Routing Platforms
Monitoring Interactions Between the SAE and JUNOS Routing Platforms
Troubleshooting Problems with the SRC Software Process
Deleting All SRC Data on JUNOS Routing Platforms
Viewing the State of JUNOS Device Drivers with the SRC CLI
Viewing Statistics for Specific JUNOS Device Drivers with the SRC CLI
Viewing Statistics for All JUNOS Device Drivers with the SRC CLI
Viewing the State of JUNOS Device Drivers with the C-Web Interface
Viewing Statistics for Specific JUNOS Device Drivers with the C-Web Interface
Viewing Statistics for All JUNOS Device Drivers with the C-Web Interface
Using JUNOS Routing Platforms in the SRC Network with a Solaris Platform
BEEP Connection Between JUNOS Routing Platforms and the SAE
Adding JUNOS Routing Platforms and Virtual Routers
Adding Operative JUNOS Routing Platforms
Adding Routers Individually
Router Fields
Adding Virtual Routers Individually
Virtual Router Fields
Specifying the SAEs That Can Manage the Router
Adding an SAE
Modifying an SAE Address
Deleting an SAE Address
Configuring the SAE to Manage JUNOS Routing Platforms
JUNOS Router Driver Fields
Configuring Secure Connections Between the SAE and JUNOS Routing Platforms
Creating a Server Certificate for the SAE
Installing the Server Certificate on the SAE
Installing the Server Certificate on the Router
Creating a Client Certificate for the Router
Installing the Client Certificate on the Router
Installing the Client Certificate on the SAE
Configuring the SAE to Use TLS
Configuring the Keystore for TLS Certificates and Keys
Keystore Fields for the JUNOS Router Driver
Checking Changes to the JUNOS Configuration
Setting Up Periodic Configuration Checking
Configuration Checking Fields for the JUNOS Router Driver
Using SNMP to Retrieve Information from JUNOS Routing Platforms
Configuring Global SNMP Communities in the SRC Software
Global SNMP Community Fields
Developing Router Initialization Scripts
Interface Object Fields
Required Methods
Example: Router Initialization Script
Specifying Router Initialization Scripts on the SAE
JUNOS Router Script Fields
Accessing the Router CLI
Using Policy Editor
Using SDX Admin
Remote Access Fields
Configuring JUNOS Routing Platforms to Interact with the SAE
Configuring the JUNOS Routing Platform to Apply Changes It Receives from the SAE
Disabling Interactions Between the SAE and JUNOS Routing Platforms
Monitoring Interactions Between the SAE and JUNOS Routing Platforms
Troubleshooting SRC Problems on JUNOS Routing Platforms
Troubleshooting Problems with the SRC Software Process
Troubleshooting Problems with Interfaces
Troubleshooting Problems with Services
Deleting All SRC Data on JUNOS Routing Platforms
Locating Subscriber Information with the NIC
Locating Subscriber Management Information
NIC Client/Server Mode
NIC Local Host Mode
Mapping Subscribers to a Managing SAE
NIC Proxies and NIC Locators
NIC Hosts
NIC Agents
NIC Resolvers
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 NIC with the SRC CLI
Configuration Statements for the NIC
Configuration Statements for NIC Operating Properties
Configuration Statements for NIC Scenarios
Configuration Statements for NIC Logging
Before You Configure the NIC
Configuring the NIC from the SRC CLI
Starting the NIC from the SRC CLI
Reviewing and Changing Operating Properties for NIC
Reviewing the Default NIC Operating Properties
Changing NIC Operating Properties
Configuring NIC Replication
Configuring a NIC Scenario
Configuring Directory Agents
Configuring SAE Plug-In Agents
Configuring the SAE to Communicate with SAE Plug-In Agents When You Use NIC Replication
Obtaining Interface Configuration Information for OnePopStaticRouteIp
Verifying Configuration for the NIC
Testing a NIC Resolution
Stopping a NIC Host on a C-series Platform
Restarting the NIC
Restarting a NIC Agent
Restarting a NIC Resolver
Changing NIC Configurations
Configuring NIC on a Solaris Platform
Before You Configure NIC Hosts
Configuring NIC Hosts to Resolve Requests
Configuring Operating Parameters for NIC Hosts
Directory Connection Properties for NIC Hosts
NIC Host Properties
Additional Properties for NIC Hosts
Reviewing Basic Configuration for a NIC Host
Modifying Basic Configuration for NIC Agents on a NIC Host
Configuring Consolidator Agents
Consolidator Agent Fields in Basic Editing Level
Configuring Directory Agents
Directory Agent Fields in Basic Editing Level
Configuring SAE Plug-In Agents
SAE Plug-In Agent Fields in Basic Editing Level
Configuring the SAE for SAE Plug-In Agents
Configuring the SAE to Communicate with SAE Plug-In Agents When You Use NIC Replication
Configuration Fields for SAE Plug-In Agents
Starting NIC on a Solaris Platform
Stopping a NIC Host on a Solaris Platform
Monitoring NIC Hosts
Configuring NIC Replication
Changing NIC Configurations
Obtaining Interface Configuration for OnePopStaticRouteIp
JUNOS Interface Information for OnePopStaticRouteIp
Information Collection for OnePopStaticRouteIp from the Network Publisher
Before You Run the Network Publisher
Configuring the Network Publisher
Network Publisher Configuration File Fields
Logging Configuration Fields
Router Configuration Fields
Filter Configuration Fields
Directory Configuration Fields
Troubleshooting Configuration Fields
Running the Network Publisher
Troubleshooting Router Connections and Configuration for the Network Publisher
Changing the Location of an Input Directory for the Network Publisher
Reviewing the Information Collected from a JUNOS Routing Platform
Reviewing and Editing Interface Information from SDX Admin
NIC Document That Maps Subscriber IP Addresses to a JUNOS Interface
Configuring Applications to Communicate with an SAE
Overview of NIC Proxy Configuration
Before You Configure a NIC Proxy
Using the CLI to Configure SRC Applications to Communicate with an SAE
Configuration Statements for NIC Proxies
Before You Configure a NIC Proxy
Configuring Resolution Information for a NIC Proxy
Changing the Configuration for the NIC Proxy Cache
Configuring a NIC Proxy for NIC Replication
Configuring NIC Test Data from the SRC CLI
Configuring Applications to Communicate with an SAE with SDX Configuration Editor
Configuring an Application to Use a Local NIC Host
Local NIC Host Configuration Fields
Configuring NIC Proxies from SDX Configuration Editor
Configuring Resolution Information for a NIC Proxy
NIC Proxy Resolution Fields
Configuring the NIC Proxy Cache
NIC Proxy Cache Fields
Configuring the NIC Proxy for NIC Replication
NIC Host Selection Fields
Reviewing and Updating the ORB Configuration for Applications That Include a NIC Proxy
Configuring JacORB as the Default ORB
Configuring One Web Application to Use JacORB
Configuring a Web Application Server to Use JacORB
Testing Applications by Using a NIC Proxy Stub
Configuring a NIC Proxy Stub from SDX Configuration Editor
NIC Proxy Stub Fields
Configuring a NIC Proxy Stub from SDX Admin
Configuring the Test Data
Configuring a NIC Proxy Stub to Use a corbaloc URL to Test Data
Configuring a NIC Proxy Stub to Use a File URL to Test Data
Configuring a NIC Proxy Stub to Use an IOR to Test Data
Monitoring NIC Proxies
Developing Applications That Use NIC
External Application Requirements for NIC
External Non-Java Applications That Use NIC
Creating a NIC Locator to Include with a Non-Java Application
External Java Applications That Use NIC
Developing a Java Application to Communicate with a NIC Proxy
Instantiating a Configuration Manager
Passing a Reference to the Configuration Manager to the NIC Factory
Instantiating the NIC Factory Class
Initializing Logging
Instantiating the NIC Proxy
Managing a Resolution Request
Deleting Invalid Results from the NIC Proxy's Cache
Removing the NIC Proxies
Updating Information About Address Pools
Configuring NIC Host Redundancy
Overview of NIC Host Redundancy
Before You Configure NIC Host Redundancy
Configuring NIC Host Redundancy
Configuring Redundant Hosts
Redundant Hosts Fields
Configuring Communities
Communities Fields
Configuring Monitors
Configuring Operating Parameters for Monitors
JRE Properties for a Redundant Monitor
Configuring a Monitor Process
Monitor Field
Configuring JacORB Properties on Redundant NIC Hosts
JacORB Properties for Timeouts
Starting NIC Monitors
Starting NIC Hosts
Verifying That a Monitor Is Running
Stopping a Monitor
Optimizing Performance of the NIC Proxy for NIC Host Redundancy
JacORB Properties for Retry Intervals
Viewing Log Files for NIC Hosts and Monitors from the Solaris CLI
Clearing Persistent Data and Logs for NIC Hosts and NIC Monitors
NIC Resolution Process
Overview of the Resolution Process
NIC Realms
Key to Value Resolution
NIC Data Types
Constraints as NIC Data Types
Customizing a NIC Configuration
Before You Customize a NIC Configuration
Planning a Custom NIC Configuration
Creating a Custom NIC Configuration by Adding Components to an Existing Scenario
Creating a Custom NIC Configuration by Removing Components in an Existing Scenario
Qualifying NIC Data Types
Qualifying a NIC Data Type from SDX Admin
Qualifying a NIC Data Type from SDX Configuration Editor
Managing Directory Changes for the Directory Agent
Reviewing the NIC Configuration
Reviewing the Configuration for NIC Realms
NIC Resolution Transition Fields
NIC Resolvers Fields
Consolidator Agents
Reviewing the Configuration of Consolidator Agents
Consolidator Agent Fields
Directory Agents
Reviewing the Configuration of Directory Agents
Directory Agent Fields
Directory Eventing Fields
SAE Plug-In Agents
Reviewing the Configuration of SAE Plug-In Agents
SAE Plug-In Agent Fields
Properties Agents
Configuring Properties Agents
Properties Agent Fields
XML Agents
Configuring XML Agents
XML Agent Fields
Reviewing and Changing the Configuration for a NIC Host Instance
NIC Host Fields
Configuring Logging for NIC
Reviewing the Configuration for NIC Locators
Managing NIC Resolvers
NIC Configuration Scenarios
Overview of NIC Configuration Scenarios
OnePop Scenario
Centralized Configuration
Distributed Configuration
Redundancy
OnePopPcmm Scenario
Centralized Configuration
Distributed Configuration
OnePopDynamicIp Scenario
Centralized Configuration
Distributed Configuration
OnePopSharedIp Scenario
Centralized Configuration
Distributed Configuration
OnePopStaticRouteIp
Centralized Configuration
Distributed Configuration
OnePopAcctId Scenario
OnePopLogin Scenario
Centralized Configuration
Distributed Configuration
OnePopPrimaryUser
Centralized Configuration
Distributed Configuration
OnePopDnSharedIp Scenario
Centralized Configuration
Distributed Configuration
OnePopAllRealms Scenario
Centralized Configuration
Distributed Configuration
MultiPop Scenario
IP Realm
Shared IP Realm
DN Realm
Index