Skip to content

Support

Techpubs Home
Report an Error

Short Contents

Entire manual as PDF [3.3 MB]

About This Guide
[PDF 83 KB]
Objectives
Audience
Documentation Conventions
Related Juniper Networks Documentation
Obtaining Documentation
Documentation Feedback
Requesting Support
Chapter: Overview of the SAE
[PDF 389 KB]
Role of the SAE
Connections to Juniper Networks Routers
COPS Connection Between JUNOSe Routers and the SAE
Beep Connection Between JUNOS Routing Platforms and the SAE
Router Initialization Scripts
SAE Plug-Ins
Internal Plug-Ins
External Plug-Ins
Hosted Plug-Ins
How Internal Plug-Ins Work
Plug-In Pool
Event Publishers
Types of Internal Plug-Ins
Authorization Plug-Ins
Tracking Plug-Ins
Using Internal Plug-Ins to Customize RADIUS Packets
How the SAE Uses Plug-Ins
Assigning DHCP Addresses to Subscribers
Creating and Tracking Subscriber Sessions
Activating and Tracking Service Sessions
Classification Scripts
How Classification Scripts Work
Interface Classification Scripts
Subscriber Classification Scripts
DHCP Classification Scripts
Login Events and Processes
Login Events
Summary of the Login Process
Residential Subscriber Login and Processes
PPP Subscribers
Web Login for PPP Subscribers
PPP Login Interactions
PPP Logout Interactions
DHCP Subscribers
Interface Startup
Initial Login
Initial DHCP Login Interactions
DHCP Login to Subscriber Account Interactions
Persistent DHCP Subscriber Login Interactions
DHCP Subscriber Logout Interactions
Static IP Subscribers
Single PC, IP Address Known
Subscriber IP Address Not Known
Enterprise Subscriber Login Process
Interface Startup
Subscriptions and Activations
Activation and Deactivation
Subscription Activation Interactions
Subscription Deactivation Interactions
Automatic Activation at Login
Enterprise-Specific Remote Session Activation
Storing Subscriber and Service Session Data
Session Store Files
Active and Passive Session Stores
Session Store File Rotation
Virtual Portal Address Feature
SAE APIs
SAE Core API
SAE CORBA Remote API
SAE Accounting
Accounting Policy
Subscription Process
Tracking Subscriber Sessions
Accounting Plug-Ins
Interim Accounting
Chapter: Configuring the SAE
[PDF 334 KB]
Overview
Configuring LDAP Access to Directory Data
Configuring Access to Subscriber Data
Configuring Access to Service Data
Configuring Access to Policy Data
Configuring Access to the Persistent Login Cache
Configuring Directory Eventing
Configuring the Location of Router, Persistent Login, and Persistent Session Data
Enabling Directory Eventing of Configuration Data
Configuring Router Properties
Configuring the JUNOS Router Driver
Configuring the JUNOSe Router Driver
Configuring the Length of Time MAC Addresses Remain in SAE Cache
Configuring a Simulated Router Driver
Configuring Session Stores
Configuring Session Store Parameters for a Device Driver
Configuring Global Session Store Parameters
Configuring SNMP Communities
Identifying a Profile for Unauthenticated Subscribers
Configuring the Virtual Portal Address
Configuring Router Initialization Scripts
Configuring the License Manager
Configuring Directory Access
Configuring Client Properties
Configuring Interim Accounting
Allowing Multiple Logins from the Same IP Address
Authenticating Registered Username/Password Pairs
Configuring Timers for Session Reactivation
Configuring the Number of Threads for Sessions
Reducing the Size of Session Objects
Modifying the SAE Property File
Editing Properties with SDX Admin
Editing Properties with a Text Editor
Other Configuration Tasks
Loading Subscriptions Based on RADIUS Authorization
Accepting Login Names with Different Formats
Default Login Parser Properties
Chapter: Starting and Managing the SAE
[PDF 605 KB]
Starting the SAE
Before You Start the SAE
Logging the SAE Start or Stop Process
Starting and Stopping the SAE
Configuring Secure Connections for SAE Web Admin
Starting SAE Web Admin
Viewing SAE Data
Viewing Information About Services
Viewing Information About Policies
Viewing Information About Routers
Viewing Information About Subscriber Sessions
Viewing Information About Interfaces
Viewing and Deleting Login and Equipment Registrations
Viewing Information About Threads
Viewing SNMP Information
Viewing and Reloading the SAE Configuration
Testing a Portal
Testing Classification Scripts and Domain Name Parsing
Testing Classification Scripts
Testing Domain Name Parser Scripts
Chapter: Classifying Interfaces and Subscribers
[PDF 377 KB]
Configuring Classification Scripts
Classification Targets
Target Expressions
Classification Criteria
Glob Matching
Regular Expression Matching
Creating and Modifying Classification Scripts
Structured View
Configuring Targets in Structured View
Configuring Criteria in Structured View
Raw View
Testing Subscriber and Interface Classification Scripts
Classifying Interfaces
Selecting Interface Classification Criteria
Configuring Interface Classification Targets
Examples: Interface Classification Scripts
Managing Interfaces for Premium and Basic PPP and DHCP Subscribers
Managing Specific Interfaces
Managing Interfaces by Using the Interface Description
Classifying Subscribers
Selecting Subscriber Classification Criteria
Sending DHCP Options to the JUNOSe Router
Configuring Subscriber Classification Targets
Examples: Subscriber Classification Scripts
Default Subscriber Classification Script
Static IP Subscriber
Subscriber Group
Enterprise Subscribers
Matching on the Interface Name
Matching on the Interface Alias
Service Bundle in a Wholesaler/Retailer Scenario
Router Interface Subscriber Session
Group of Subscriber Sessions
Classifying DHCP Subscribers
Selecting DHCP Classification Criteria
Configuring DHCP Classification Targets
Selecting DHCP Parameters
Setting DHCP Parameters with DHCP Options
Creating DHCP Profiles
Chapter: Configuring Authorization and Accounting Plug-Ins
[PDF 389 KB]
Configuring Plug-Ins with SDX Configuration Editor
Accessing the Plug-In Configuration
Creating Plug-In Instances
Configuring Internal Plug-Ins
Configuring the SAE for External Plug-Ins
Configuring the State Synchronization Plug-In Interface
Configuring Tracking Plug-Ins
Configuring Flat File Accounting Plug-Ins
Configuring Headers for Flat File Accounting Plug-Ins
Configuring Basic RADIUS Accounting Plug-Ins
Configuring Flexible RADIUS Accounting Plug-Ins
Configuring Custom RADIUS Accounting-Plug-Ins
Configuring Authorization Plug-Ins
Limiting Subscribers on Router Interfaces
Configuring Basic RADIUS Authentication Plug-Ins
Configuring Flexible RADIUS Authentication Plug-Ins
Configuring Custom RADIUS Authentication Plug-Ins
Configuring LDAP Authentication Plug-Ins
Using RADIUS Plug-In Fields
Configuring UDP Ports for RADIUS Plug-Ins
Configuring Global UDP Ports
Creating RADIUS Peers
Defining RADIUS Packets for Flexible RADIUS Plug-Ins
Creating and Using RADIUS Templates
Configuring RADIUS Attributes
More About Using Flexible RADIUS Packet Definitions
Setting Values in Authentication Response Packets
Selecting IP Address Pools Using DHCP Response Packets
Configuring Event Publishers
Configuring Global and Default Retailer Event Publishers
Configuring Service-Specific Event Publishers
Configuring Retailer-Specific Event Publishers
Configuring Virtual Router-Specific Event Publishers
Configuring Plug-Ins with SDX Admin or a Text Editor
Configuring External Plug-Ins
Configuring Internal and Hosted Plug-Ins
Defining RADIUS Packets
Setting Up the Plug-In Instance to Use a Template
Configuring Event Publishers
Example: LDAP Authentication Plug-In
Example: Basic RADIUS Accounting Plug-In
Chapter: Developing Router Initialization Scripts
[PDF 56 KB]
Interface Description
Methods
Example
Chapter: Using the License Server
[PDF 116 KB]
Overview
Server License
License Server Errors
License Requests
License Allocation Example
License Release Example
Lease Renewal
Directory Location and Access
License Switching and Preferences
Failover Behavior
Managing Log Files
Customizing License Server Configuration
Configuring Alarms
Specifying the ORB Configuration Property File
Configuring the Repository for the License Server
Configuring Properties for the License Server
Configuring Location of the License Server
Troubleshooting License Server Problems
Chapter: Using the SNMP Agent
[PDF 324 KB]
Overview of the SNMP Agent
SNMP Agent Behavior
MIBs
Configuration MIBs
MIB Structure
MIB Location
IOR Files
SNMP Agent
SAE
License Server
NIC Host
Web Redirector
SNMP Agent Hierarchy and Objects
System Management Configurations
Subfolders
Components
Traps
Adding and Deleting Subfolders
Adding and Deleting System Management Configurations
Configuring Components
Adding Components
Deleting Components
Component Fields
Configuring Traps
Adding Traps
Deleting Traps
Trap Fields
Chapter: Understanding Traps
[PDF 148 KB]
Performance Traps
R/AV
Decoding Trap Numbers in Performance Traps
Decoding Trap Numbers for Raised Trap Actions
Decoding Trap Numbers for Clear Trap Actions
SAE Performance Traps
Accounting Performance Traps
Authentication Performance Traps
NIC Performance Traps
Router Driver Performance Traps
Workflow Performance Traps
System Management, Policy Engine, and SDX Redirector Performance Traps
Event Traps
Alarm State Transitions
Chapter: Configuring Logging for SDX Components
[PDF 135 KB]
Overview of Logging
Configuring Logging with SDX Configuration Editor
Accessing the Logging Configuration for All Components Except the NIC
Accessing the Logging Configuration for the NIC
Saving Event Messages in Text Files
File Logging Fields
Saving Event Messages on a Logging Server
System Logging Fields
Specifying Filters for Logs
Defining Categories
Defining Severity Levels
Defining Filters
Cleaning Logs and Process Files for SDX Components
Chapter: Configuring the Directory Eventing System
[PDF 102 KB]
Overview
Configuring Standard DES Properties
Configuring SDX DES Properties
Example
Configuring the Type of Directory
Configuring DES to Manage Directory Problems
Using DES for Large Directories
Index