Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation  Back up to About Overview 
ContentIndex
  
[+] Expand All
[-] Collapse All

 A  C  D  E  F  G  I  J  L  M  N  P  Q  R  S  T  W

 

A

address pools    
assigned IP subscribers    
configuring
address pools.     See IP address pools    
application manager    
role, in PCMM environment
assigned IP subscribers    
PCMM network    12
address pools
IP address pools
setting timeouts
voice over IP
 

C

cable modem termination system.     See CMTS devices    
client type 1, PCMM
client type 2, PCMM
CMTS devices    
adding objects to directory    
SRC CLI
adding virtual router objects to directory    
SRC CLI
configuration statements    12
role
CMTS locator    
monitoring    
C-Web interface
SRC CLI
COA script services, configuring
configuration wizard    
fair usage    
configuration overview
running
running    12
configuration wizards    
fair usage    
overview
overview    12
conventions    
notice icons
text
custom RADIUS authentication plug-ins
customer support    1
contacting JTAC
 

D

Data over Cable Service Interface Specifications.     See DOCSIS protocol    
Diameter    
peers    
configuring    12
SNMP support
Diameter server    
clients, viewing    
SRC CLI
message flows, viewing    
SRC CLI
message handler, viewing    
SRC CLI
monitoring    
SRC CLI
peers, viewing    
SRC CLI
server process, viewing    
SRC CLI
server requests, viewing    
SRC CLI
statistics, viewing    
SRC CLI
status, viewing    
SRC CLI
DOCSIS protocol
documentation    
comments on
domains    
IP service edge
IP subscriber edge
radio frequency
dynamic RADIUS authorization requests    
RADIUS packets, defining    12
 

E

end-to-end services
event notification, PCMM network    
configuration statements
description
properties, configuring    
SRC CLI
 

F

flexible RADIUS authentication plug-ins    
configuring
 

G

Gx router driver    
application information, configuring    
SRC CLI
dynamic PCC rules, configuring    
SRC CLI
flow information, configuring    
SRC CLI
Gx policies for dynamic PCC rules, configuring    
SRC CLI
Gx policies for static PCC rules, configuring    
SRC CLI
overview
policies, configuration statements    
SRC CLI
policies, configuring    
SRC CLI
policy list, configuring    
SRC CLI
QoS information, configuring    
SRC CLI
redirect information, configuring    
SRC CLI
static PCC rules, configuring    
SRC CLI
steering information, configuring    
SRC CLI
 

I

intelligent-service-edge device driver    
configuring initialization scripts    
SRC CLI
IP address pools    
assigned IP subscribers
assigned IP subscribers, configuring    
SRC CLI
local address pools, configuring    
SRC CLI
static pools, configuring    
SRC CLI
 

J

JPS (Juniper Policy Server)    
application manager-to-policy server interface, configuring
application manager-to-policy server interface, monitoring    
C-Web interface    12
SRC CLI
architecture
CMTS devices, monitoring    
C-Web interface
CMTS locator, monitoring    
C-Web interface
SRC CLI
JPS state, monitoring
logging, configuring
logging, modifying
message flows, monitoring    
C-Web interface
SRC CLI
message handler, monitoring    
C-Web interface
SRC CLI
monitoring    
C-Web interface
SRC CLI    12
operational status
overview
policy server-to-CMTS interface, configuring
policy server-to-CMTS interface, monitoring    
C-Web interface    12
SRC CLI
policy server-to-RKS interface, configuring
policy server-to-RKS interface, monitoring    
C-Web interface
SRC CLI
server process, monitoring    
C-Web interface
SRC CLI
starting    
SRC CLI
stopping    
SRC CLI
subscriber address mappings, configuring
subscriber configuration, modifying
Juniper Policy Server.     See JPS    
 

L

login process    
assigned IP subscribers, PCMM
 

M

manuals    
comments on
 

N

NIC (network information collector)    
IP address pools, configuring    
SRC CLI
notice icons
 

P

packet mirroring, configuring
PCMM (PacketCable Multimedia)    
application manager, role
client type 1
client type 2
CMTS device, role
configuring SAE    
SRC CLI
creating sessions
description
end-to-end QoS architecture
end-to-end services
integrating SRC software
IP service edge domain
IP subscriber edge domain
logging in subscribers    
assigned IP method
overview
overview
policy server, role
provisioning end-to-end services
record-keeping server
RF domain
SAE
SAE communities
session store
single-phase resource reservation model
SRC software in    
description
traffic profiles
video-on-demand example
videoconferencing example
PCMM device driver    
configuration statements
configuring    
SRC CLI
PCMM record-keeping server plug-in    
configuration statements
configuring    
SRC CLI
description
plug-ins    
PCMM record-keeping server plug-in
policy servers    
adding application manager groups    
SRC CLI
adding objects to directory    
SRC CLI
role, in PCMM architecture
specifying application managers    
SRC CLI
specifying SAE communities    
SRC CLI
 

Q

QoS (quality of service)    
PCMM environments    
end-to-end QoS architecture
extending to service edge domain
extending to subscriber edge domain
searching for policies in directory
QoS profile-tracking plug-in    
description
QoS profiles, routers running JunosE Software    
how tracking works
managing dynamically
updating directory, using    
qosProfilePublish
quality of service.     See QoS    
 

R

RADIUS    
vendor-specific attributes for wireless ISP roaming
record-keeping server.     See RKS    
RKS (record-keeping server)    
peers, configuration statements
peers, configuring in plug-ins    
SRC CLI
plug-in
plug-in, configuration statements
plug-in, configuring    
SRC CLI
role in PCMM environment
roaming wireless environment
 

S

SAE (service activation engine)    
configuring as an application manager    
SRC CLI
PCMM environment
redundancy.     See SAE communities    
SAE (service activation engine), configuring    
community manager    
SRC CLI
event notification API properties    
SRC CLI
PCMM device driver    
SRC CLI    12
SAE communities    
configuration overview    
SRC CLI
configuration statements
configuring manager    
SRC CLI
defining members    
SRC CLI
description
service flows
services    
voice over IP (VoIP)
session store    
in PCMM environment
single phase resource reservation model, PCMM
subscriber    
wireless environment
support, technical     See technical support    
 

T

technical support    
contacting JTAC
text conventions defined
traffic policies, PCMM
 

W

wireless environment

Fair Usage on MX Series Routers Configuration Wizard Configuration Overview

When you use the fair usage on MX Series routers configuration wizard, the wizard definition file specifies most of the SRC configuration. However, you must provide values for certain parameters in the configuration.

Fair Usage on MX Series Routers Configuration Wizard Definition File

The fair usage on MX Series routers configuration wizard definition file is an .xml file that controls the parameters of the wizard.

The following sample shows the definition file for the fair usage on MX Series routers configuration wizard. The first part of the definition file defines the dialog boxes you use to enter values specific to your environment. The next part of the definition file lists the SRC CLI set commands the wizard invokes.

This file is shown only for reference purposes. Modification of definition files is not supported.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE cli SYSTEM "configuration-wizard.dtd">
<cli name="fair-usage-mx">
  <help>Configure SRC for fair usage MX scenario</help>
  <step name="src-config">
    <step name="src-host-parameters">
        <caption>SRC host parameters</caption>
        <help>SRC host parameters</help>
        <description>
            This step collect SRC host parameters that will be used
            in configuration. The parameters are SRC host names, IP addresses 
            and domain names.
        </description>
        <wiz-argument name="src-host-name" mandatory="true">
            <help>SRC host name</help>
            <description>SRC host name.</description>
        </wiz-argument>
        <wiz-argument name="src-host-ip" mandatory="true" type="inet">
            <help>SRC host IP address</help>
            <description>SRC host IP address used to communicate with diameter peers and VTA database.</description>        
        </wiz-argument>
        <wiz-argument name="src-host-domain-name" mandatory="true">
            <help>SRC host domain name</help>
            <description>SRC host domain name used as origin-realm for diameter.</description>        
        </wiz-argument>
    </step>
    <step name="vta-db-host-parameters">
        <caption>VTA database host and database parameters</caption>
        <help>VTA database host and database parameters</help>
        <description>
            This step collect VTA database host and database parameters that will be used
            in configuration. The parameters are VTA database host IP addresses, database
            connection user name and password.
        </description>
        <wiz-argument name="vta-database-ip" mandatory="true" type="inet">
            <help>VTA database IP address</help>
            <description>The IP address of the host where VTA database runs.</description>
        </wiz-argument>
        <wiz-argument name="vta-database-user" mandatory="true">
            <help>VTA database connection user name</help>
            <description>The user name for VTA to connect to VTA database.</description>
        </wiz-argument>
        <wiz-argument name="vta-database-passwd" mandatory="true" type="passwd">
            <help>VTA database connection password</help>
            <description>The password for VTA to connect to VTA database.</description>
        </wiz-argument>
    </step>
    <step name="router-host-parameters">
        <caption>Router host parameters</caption>
        <help>Router host parameters</help>
        <description>
            This step collect router host parameters that will be used
            in configuration. The parameters are router host names, IP addresses 
            and domain names.
        </description>
        <wiz-argument name="mx-router-name" mandatory="true">
            <help>Router host name</help>
            <description>Router host name used as diameter peer origin-host and SRC network device name.</description>        
        </wiz-argument>
        <wiz-argument name="mx-router-ip" mandatory="true" type="inet">
            <help>Router IP address</help>
            <description>Router IP address used for diameter and SRC network device address.</description>        
        </wiz-argument>
        <wiz-argument name="mx-router-domain-name" mandatory="true">
            <help>Router domain name</help>
            <description>Router domain name used as diameter peer origin-realm.</description>        
        </wiz-argument>
        <configuration>
        set system diameter active-peers
        set system diameter local-address {src-config src-host-parameters src-host-ip}
        set system diameter origin-host {src-config src-host-parameters src-host-name}
        set system diameter origin-realm {src-config src-host-parameters src-host-domain-name}
        set system diameter port 3868
        set system diameter protocol tcp
        
        set shared network diameter peer {src-config router-host-parameters mx-router-name} active-peer
        set shared network diameter peer {src-config router-host-parameters mx-router-name} address {src-config router-host-parameters mx-router-ip}
        set shared network diameter peer {src-config router-host-parameters mx-router-name} connect-timeout 10
        set shared network diameter peer {src-config router-host-parameters mx-router-name} origin-host {src-config router-host-parameters mx-router-name}
        set shared network diameter peer {src-config router-host-parameters mx-router-name} port 3868
        set shared network diameter peer {src-config router-host-parameters mx-router-name} protocol tcp
        
        set shared network device {src-config router-host-parameters mx-router-name} description 'A MX fair usage device'
        set shared network device {src-config router-host-parameters mx-router-name} device-type junos-ise
        set shared network device {src-config router-host-parameters mx-router-name} management-address {src-config router-host-parameters mx-router-ip}
        set shared network device {src-config router-host-parameters mx-router-name} origin-host {src-config router-host-parameters mx-router-name}
        set shared network device {src-config router-host-parameters mx-router-name} peers {src-config router-host-parameters mx-router-name}
        set shared network device {src-config router-host-parameters mx-router-name} virtual-router * sae-connection {src-config src-host-parameters src-host-ip}
        
        set policies folder fair-usage-ise group MXCaptivePolicy list captive-list applicability both
        set policies folder fair-usage-ise group MXCaptivePolicy list captive-list role junos-ise
        set policies folder fair-usage-ise group MXCaptivePolicy list captive-list rule rule-1 type junos-ise
        set policies folder fair-usage-ise group MXCaptivePolicy list captive-list rule rule-1 dynamic-profile profile-name src_driven_captive_profile
        set policies folder fair-usage-ise group MXQuotaPolicy description 'Quota Policy'
        set policies folder fair-usage-ise group MXQuotaPolicy list quota_list applicability both
        set policies folder fair-usage-ise group MXQuotaPolicy list quota_list role junos-ise
        set policies folder fair-usage-ise group MXQuotaPolicy list quota_list rule rule-1 accounting
        set policies folder fair-usage-ise group MXQuotaPolicy list quota_list rule rule-1 type junos-ise
        set policies folder fair-usage-ise group MXQuotaPolicy list quota_list rule rule-1 dynamic-profile profile-name src_driven_quota_profile
        set policies folder fair-usage-ise group MXQuotaPolicy list quota_list rule rule-1 dynamic-profile variables input type any
        set policies folder fair-usage-ise group MXQuotaPolicy list quota_list rule rule-1 dynamic-profile variables input value ingress_filter_to_use
        set policies folder fair-usage-ise group MXQuotaPolicy list quota_list rule rule-1 dynamic-profile variables output type any
        set policies folder fair-usage-ise group MXQuotaPolicy list quota_list rule rule-1 dynamic-profile variables output value egress_filter_to_use
        set policies folder fair-usage-ise group MXQuotaPolicy local-parameters egress_filter_to_use type any
        set policies folder fair-usage-ise group MXQuotaPolicy local-parameters ingress_filter_to_use type any
        
        set services global service MXQuotaInternet accounting-interim-interval 600
        set services global service MXQuotaInternet available
        set services global service MXQuotaInternet category Internet
        set services global service MXQuotaInternet description 'MX quota high speed service, supposed to be used as VTA behaving service'
        set services global service MXQuotaInternet policy-group /fair-usage-ise/MXQuotaPolicy
        set services global service MXQuotaInternet radius-class MXQuotaInternet
        set services global service MXQuotaInternet status active
        set services global service MXQuotaInternet tracking-plug-in quotavta
        set services global service MXQuotaInternet type normal
        set services global service MXQuotaLowSpeed accounting-interim-interval 600
        set services global service MXQuotaLowSpeed available
        set services global service MXQuotaLowSpeed category Internet
        set services global service MXQuotaLowSpeed description 'MX quota low speed service, supposed to be used as VTA misbehaving service'
        set services global service MXQuotaLowSpeed policy-group /fair-usage-ise/MXQuotaPolicy
        set services global service MXQuotaLowSpeed radius-class MXQuotaInternet
        set services global service MXQuotaLowSpeed status active
        set services global service MXQuotaLowSpeed tracking-plug-in quotavta
        set services global service MXQuotaLowSpeed type normal
        set services global service MXCaptive available
        set services global service MXCaptive description 'MX captive service, supposed to be used as VTA misbehaving service'
        set services global service MXCaptive policy-group /fair-usage-ise/MXCaptivePolicy
        set services global service MXCaptive radius-class MXCaptive
        set services global service MXCaptive status active
        set services global service MXCaptive tracking-plug-in quotavta
        set services global service MXCaptive type normal
        
        set subscribers retailer fair-usage-mx domain-name fair-usage-mx.com
        set subscribers retailer fair-usage-mx subscriber-folder local subscriber quota-subscriber-1 common-name One
        set subscribers retailer fair-usage-mx subscriber-folder local subscriber quota-subscriber-1 surname Quotasubscriber
        set subscribers retailer fair-usage-mx subscriber-folder local subscriber quota-subscriber-1 subscription MXCaptive activation manual
        set subscribers retailer fair-usage-mx subscriber-folder local subscriber quota-subscriber-1 subscription MXCaptive status active
        set subscribers retailer fair-usage-mx subscriber-folder local subscriber quota-subscriber-1 subscription MXQuotaInternet activation automatically-on-login
        set subscribers retailer fair-usage-mx subscriber-folder local subscriber quota-subscriber-1 subscription MXQuotaInternet status active
        set subscribers retailer fair-usage-mx subscriber-folder local subscriber quota-subscriber-1 subscription MXQuotaInternet substitution [ 'egress_filter_to_use=\"10m-service\"' 'ingress_filter_to_use=\"10m-service\"' ]
        set subscribers retailer fair-usage-mx subscriber-folder local subscriber quota-subscriber-1 subscription MXQuotaLowSpeed activation manual
        set subscribers retailer fair-usage-mx subscriber-folder local subscriber quota-subscriber-1 subscription MXQuotaLowSpeed status active
        set subscribers retailer fair-usage-mx subscriber-folder local subscriber quota-subscriber-1 subscription MXQuotaLowSpeed substitution [ 'egress_filter_to_use=\"256k-service\"' 'ingress_filter_to_use=\"256k-service\"' ]

        set slot 0 nic scenario-name OnePopLogin
        set slot 0 nic snmp-agent
        
        set slot 0 sae shared /SAE/fair-usage
        
        set shared sae group fair-usage configuration plug-ins name quotavta ejb-adaptor jndi-sae-event-listener vta-Quota/SAEEventListenerBean
        set shared sae group fair-usage configuration plug-ins name quotavta ejb-adaptor application-server-url {src-config src-host-parameters src-host-ip}:1099
        set shared sae group fair-usage configuration plug-ins name quotavta ejb-adaptor ejb-clustering-strategy EJBObjectClustering
        set shared sae group fair-usage configuration plug-ins name quotavta ejb-adaptor jndi-service-provider org.jnp.interfaces.NamingContextFactory
        set shared sae group fair-usage configuration plug-ins name nic external corba-object-reference corbaname::{src-config src-host-parameters src-host-ip}:2809/NameService#nicsae/saePort
        set shared sae group fair-usage configuration plug-ins event-publishers subscriber-tracking [fileAcct quotavta nic ]
        set shared sae group fair-usage configuration plug-ins event-publishers service-tracking [fileAcct quotavta ]
        set shared sae group fair-usage subscriber-classifier rule rule-mx target uniqueID=quota-subscriber-1,ou=local,retailerName=fair-usage-mx,o=Users,o=umc
        set shared sae group fair-usage subscriber-classifier rule rule-mx condition nasPortId==ge-*
        insert shared sae group fair-usage subscriber-classifier rule rule-mx before rule-1
        
        set slot 0 application-server web virtual-host eth0 alias [ {src-config src-host-parameters src-host-name} {src-config src-host-parameters src-host-ip} ]
        
        set shared vta group Quota nic-proxy IdToSaeNicProxy
        set shared vta group fairusage subscriber-id-solution login-name
        set shared vta group fairusage action CalcUsage function db-engine-calculate-usage
        set shared vta group fairusage action CalculateInterim function db-engine-calculate-interim
        set shared vta group fairusage action DebitAccounts function db-engine-update-accounts
        set shared vta group fairusage action DebitAccounts parameter script-name DebitQuotaUsage
        set shared vta group fairusage action GetAccountBalances function db-engine-get-accounts
        set shared vta group fairusage action SetInterim function sae-set-interim-interval
        set shared vta group fairusage action SetInterim parameter current-subscriber-only
        set shared vta group fairusage action StartCaptiveService function sae-start-service
        set shared vta group fairusage action StartCaptiveService parameter current-subscriber-only
        set shared vta group fairusage action StartCaptiveService parameter subscription-name MXCaptive
        set shared vta group fairusage action StartQuotaInternetService function sae-start-service
        set shared vta group fairusage action StartQuotaInternetService parameter current-subscriber-only
        set shared vta group fairusage action StartQuotaInternetService parameter subscription-name MXQuotaInternet
        set shared vta group fairusage action StartQuotaLowSpeedService function sae-start-service
        set shared vta group fairusage action StartQuotaLowSpeedService parameter current-subscriber-only
        set shared vta group fairusage action StartQuotaLowSpeedService parameter subscription-name MXQuotaLowSpeed
        set shared vta group fairusage action StopQuotaInternetService function sae-stop-service
        set shared vta group fairusage action StopQuotaInternetService parameter current-subscriber-only
        set shared vta group fairusage action StopQuotaInternetService parameter subscription-name MXQuotaInternet
        set shared vta group fairusage action StopQuotaLowSpeedService function sae-stop-service
        set shared vta group fairusage action StopQuotaLowSpeedService parameter current-subscriber-only
        set shared vta group fairusage action StopQuotaLowSpeedService parameter subscription-name MXQuotaLowSpeed
        set shared vta group fairusage action TerminateSession function db-engine-terminate-session
        set shared vta group fairusage database check-valid-connection-sql 'select 1'
        set shared vta group fairusage database connection-url jdbc:mysql://{src-config vta-db-host-parameters vta-database-ip}:3306/quotavta
        set shared vta group fairusage database datasource-mapping mySQL
        set shared vta group fairusage database driver-class com.mysql.jdbc.Driver
        set shared vta group fairusage database max-pool-size 50
        set shared vta group fairusage database min-pool-size 5
        set shared vta group fairusage database password {src-config vta-db-host-parameters vta-database-passwd}
        set shared vta group fairusage database user-name {src-config vta-db-host-parameters vta-database-user}
        set shared vta group fairusage event-handler GetQuota actions GetAccountBalances
        set shared vta group fairusage event-handler GetQuota events [ service-start:MXQuotaInternet service-start:MXQuotaLowSpeed service-interim:MXQuotaInternet service-interim:MXQuotaLowSpeed service-stop:MXQuotaInternet service-stop:MXQuotaLowSpeed account-update ]
        set shared vta group fairusage event-handler GetQuota priority 1
        set shared vta group fairusage event-handler RecordUsage actions [ CalcUsage DebitAccounts ]
        set shared vta group fairusage event-handler RecordUsage events [ service-interim:MXQuotaInternet service-interim:MXQuotaLowSpeed service-stop:MXQuotaInternet service-stop:MXQuotaLowSpeed ]
        set shared vta group fairusage event-handler RecordUsage priority 5
        set shared vta group fairusage event-handler SetInterim actions [ CalculateInterim SetInterim ]
        set shared vta group fairusage event-handler SetInterim condition 'return &lt;balance_PeriodicQuota&gt;+&lt;balance_BoughtQuota&gt;&gt;0;'
        set shared vta group fairusage event-handler SetInterim events [ service-start:MXQuotaInternet service-start:MXQuotaLowSpeed service-interim:MXQuotaInternet service-interim:MXQuotaLowSpeed ]
        set shared vta group fairusage event-handler SetInterim priority 10
        set shared vta group fairusage event-handler NoQuota actions [ StopQuotaInternetService StartQuotaLowSpeedService ]
        set shared vta group fairusage event-handler NoQuota condition 'return &lt;balance_PeriodicQuota&gt;+&lt;balance_BoughtQuota&gt;&lt;=0;'
        set shared vta group fairusage event-handler NoQuota events [ service-start:MXQuotaInternet service-interim:MXQuotaInternet ]
        set shared vta group fairusage event-handler NoQuota priority 15
        set shared vta group fairusage event-handler QuotaRefilled actions [ StopQuotaLowSpeedService StartQuotaInternetService ]
        set shared vta group fairusage event-handler QuotaRefilled condition 'var newBalance=&lt;balance_BoughtQuota&gt;+&lt;balance_PeriodicQuota&gt;;\n    if(&lt;old_balance_PeriodicQuota&gt;==null) &lt;old_balance_PeriodicQuota&gt;=&lt;balance_PeriodicQuota&gt;;\n    if(&lt;old_balance_BoughtQuota&gt;==null) &lt;old_balance_BoughtQuota&gt;=&lt;balance_BoughtQuota&gt;;\n    return &lt;old_balance_PeriodicQuota&gt;+&lt;old_balance_BoughtQuota&gt;&lt;=0&amp;
&amp;newBalance&gt;0;' set shared vta group fairusage event-handler QuotaRefilled events account-update set shared vta group fairusage event-handler QuotaRefilled priority 20 set shared vta group fairusage event-handler EndofBilling actions TerminateSession set shared vta group fairusage event-handler EndofBilling events callback:TERMINATESESSION set shared vta group fairusage event-handler EndofBilling priority 25 set shared vta group fairusage processor db-engine record-balance-change set shared vta group fairusage processor db-engine account BoughtQuota initial-balance 0 set shared vta group fairusage processor db-engine account BoughtQuota initial-status Inactive set shared vta group fairusage processor db-engine account PeriodicQuota initial-balance 100000000000 set shared vta group fairusage processor db-engine account PeriodicQuota initial-status Active set shared vta group fairusage processor db-engine account-update-script DebitQuotaUsage script ' var newPeriodicBalance=0;\n var newBoughtBalance=0;\n if(&lt;currentUsage&gt;=&lt;balance_PeriodicQuota&gt;){\n newPeriodicBalance=&lt;balance_PeriodicQuota&gt;-&lt;currentUsage&gt;;\n newBoughtBalance=&lt;balance_BoughtQuota&gt;;\n }\n else if(&lt;currentUsage&gt;&lt;=(&lt;balance_PeriodicQuota&gt;+&lt;balance_BoughtQuota&gt;)){\n newBoughtBalance=&lt;balance_BoughtQuota&gt;-(&lt;currentUsage&gt;
-&lt;balance_PeriodicQuota&gt;);\n newPeriodicBalance=0;\n }\n if(newPeriodicBalance!=&lt;balance_PeriodicQuota&gt;){\n &lt;balance_PeriodicQuota&gt;=newPeriodicBalance;\n &lt;lastUpdateTime_PeriodicQuota&gt;=&lt;currentTime&gt;;\n }\n if(newBoughtBalance!=&lt;balance_BoughtQuota&gt;){\n &lt;balance_BoughtQuota&gt;=newBoughtBalance;\n &lt;lastUpdateTime_BoughtQuota&gt;=&lt;currentTime&gt;;\n }' set shared vta group fairusage processor db-engine service MXQuotaInternet interim-interval-function 'return Math.min(7200,Math.max(900, (&lt;balance_PeriodicQuota&gt;+&lt;balance_BoughtQuota&gt;)/250000));' set shared vta group fairusage processor db-engine service MXQuotaInternet usage-metric-function 'return Math.min(7200,Math.max(900, (&lt;balance_PeriodicQuota&gt;+&lt;balance_BoughtQuota&gt;)/250000));' set shared vta group fairusage processor db-engine service MXQuotaLowSpeed interim-interval-function 'return Math.min(7200,Math.max(900, (&lt;balance_PeriodicQuota&gt;+&lt;balance_BoughtQuota&gt;)/250000));' set shared vta group fairusage processor db-engine service MXQuotaLowSpeed usage-metric-function 'return Math.min(7200,Math.max(900, (&lt;balance_PeriodicQuota&gt;+&lt;balance_BoughtQuota&gt;)/250000));' set shared vta group fairusage queue max-concurrency 50 set shared vta group fairusage queue max-queue-size 100000 </configuration> </step> </step> </cli>

The following sections describe which parameters are predefined by the wizard and which parameters require your input.

Configuration Provided by the Fair Usage on MX Series Routers Configuration Wizard

The fair usage on MX Series routers configuration wizard configures the SRC components and configuration trees described in Table 17. Most of the SRC configuration is defined by the wizard definition file. Some parameters are configured based on your inputs to the configuration wizard interface.

Table 17: SRC Configuration Parameters Supplied by the Fair Usage on MX Series Routers Configuration Wizard

SRC Component or Configuration Tree

Description

Web application server (appsvr)

The wizard configures the Web application server, web virtual host eth0 alias, based on the input you provide for the src-host-name and src-host-ip parameters.

Diameter application

The wizard configures the Diameter application based on the values you enter for the following SRC host parameters in the wizard interface:

  • Origin-host—The wizard configures the Diameter origin-host based on the value you enter for the src-host-name parameter.
  • Origin-realm—The wizard configures the Diameter origin-realm based on the value you enter for the src-host-domain-name parameter.
  • Local-address—The wizard configures the Diameter local-address based on the value you enter for the src-host-ip parameter.

Diameter peer

The wizard configures the Diameter peer parameters for the MX Series router based on the values you enter for the following router host parameters:

  • Diameter peer address—The wizard configures the IP address for the Diameter peer based on the value you enter for the mx-router-ip parameter.
  • Diameter peer origin-host—The wizard configures the origin-host of the Diameter peer based on the value you enter for the mx-router-name.

For the connection to the Diameter peer, the wizard uses TCP, port 3868, and specifies the connection as active.

NIC

The wizard configures the NIC to use the OnePopLogin scenario.

SAE

The wizard uses the SAE group name “fair-usage”, which must exist before invoking the wizard. If the group “fair-usage” does not exist, you must create it by committing set slot 0 sae shared /SAE/fair-usage. Because the wizard uses a single-step configuration commit process, it is not possible to commit the local and shared SAE configurations simultaneously. The wizard configures the following parameters for the SAE:

  • SRC VTA ejb-adaptor plug-ins
  • NIC plug-ins
  • Plug-ins event publisher
  • SAE logger
  • Subscriber classifier. All subscribers are classified to a single SRC VTA user profile.

VTA

Services—The wizard configures an SRC VTA group called “fair-usage” and two services. The high-speed service, called MXQuotaInternet, operates at 10 Mbps and is activated when the subscriber logs in. The MXQuotaInternet service continues to run until the subscriber’s quota is exhausted. When the quota is exhausted, the subscriber is switched to the low-speed service called MXQuotaLowSpeed, which operates at 256 Kbps. The real service behavior depends on the MX Series router firewall filter configuration.

External MySQL database—The wizard requires an external MySQL database, which you must configure. The wizard configures basic parameters for the external database based on the values you specify in the wizard VTA database host and database parameters dialog box. The database connection-url is based on the value you enter for the vta-database-ip parameter. The username and password are based on the values you enter for vta-database-user and vta-database-pass. If you want to use a database other than MySQL, you must customize the configuration using the SRC CLI after you commit the configuration using the wizard.

SRC VTA NIC proxy—The wizard uses the IdToSaeNicProxy NIC proxy, which uses the subscriber ID to locate the SAE when NIC resolution is needed. The wizard also configures the NIC to use the OnePopLogin scenario.

Event Handlers—The wizard configures event handlers so that when there is no quota left for a subscriber, its MXQuotaInternet service is stopped and the MXQuotaLowSpeed service is started. When the subscriber’s quota is refilled, the MXQuotaLowSpeed service is stopped and the MXQuotaInternet service is restarted.

db-engine processor—The wizard configures the db-engine processor with some initial balance in the PeriodQuota account. The SRC VTA quota account is debited according to the DebitQuotaUsage script.

Actions—The wizard configures actions to retrieve account balances, debit accounts, calculate usage, and start and stop services.

Policies

The wizard creates a policy folder named “fair-usage-ise” and two policies. The service policy named “MXQuotaPolicy” uses a dynamic profile named “src_driven_quota_profile”. The policy named “MXCaptivePolicy” uses a dynamic profile named “src_driven_captive_profile.”

Services

The wizard configures two services. The high-speed service, called MXQuotaInternet, operates at 10 Mbps and is activated when the subscriber logs in. The MXQuotaInternet service continues to run until the subscriber’s quota is exhausted. When the quota is exhausted, the subscriber is switched to the low-speed service called MXQuotaLowSpeed, which operates at 256 Kbps.

Both of the services use quota as the tracking plug-in.

Subscribers

The wizard configures one subscriber named “quota-subscriber-1” that subscribes to both the MXQuotaInternet and the MXQuotaLowSpeed services.

shared network device (configuration tree)

The shared network device configuration tree sets up the MX Series router so that it can be managed by the SAE. The wizard specifies the router as a junos-ise type device and adds “A MX fair usage device” as the device description.

The management-address assigned by the wizard is based on the value you enter for the mx-router-ip parameter.

The origin-host assigned by the wizard is based on the value you enter for the mx-router-name parameter.

The wizard specifies the router as a peer to the SAE based on the value you enter for the mx-router-name.

The wizard specifies the IP address of the SAE that manages the router based on the value you enter for the src-host-ip parameter.

Required Input Parameters for the Fair Usage on MX Series Routers Configuration Wizard

The fair usage on MX Series routers configuration wizard requires you to input certain parameters that are specific to your environment. When you run the wizard, you are prompted to enter these parameters. Table 18 describes these parameters in detail.

Table 18: Input Parameters Required by the Fair Usage on MX Series Routers Configuration Wizard

Type of Parameters

Parameters

SRC host parameters

  • src-host-name—The wizard uses the value you enter as the origin-host for the SRC Diameter application.
  • src-host-ip—The wizard uses the value you enter as the local-address for the SRC Diameter application.
  • src-host-domain-name—The wizard uses the value you enter as the origin-realm for the SRC Diameter application.

Database host and database parameters used by the SRC VTA

The wizard configures the SRC VTA component to use an external MySQL database, but it does not configure the external database. You must deploy the database on a separate host and create the database by using the “vta-database-mysql.sql” file, which is included with the SRC software. The wizard requires you to enter the following parameters for the external database used by the SRC VTA:

  • vta-database-ip—The wizard uses the value you enter as the database connection-url.
  • vta-database-user—The wizard uses the value you enter as the database username.
  • vta-database-pass—The wizard uses the value you enter as the database password.

Router host parameters

The wizard does not configure the MX Series router. The wizard prompts you to enter values to define the MX Series router as a Diameter peer. The wizard requires you to enter the following parameters for the router host:

  • mx-router-name—The wizard uses the value you enter as the Diameter peer origin-hostname for the router.
  • mx-router-ip—The wizard uses the value you enter as the Diameter peer IP address.
  • mx-router-domain-name—The wizard uses the value you enter as the Diameter peer name.

You must manually configure the rest of the configuration for the MX Series router.

Certain router configuration parameters, such as dynamic profiles, must be consistent between the SRC configuration and the router configuration. The MX Series router configuration described in this section is for reference only.

A sample MX Series router configuration that can work with the SRC configuration created by the fair usage on MX Series routers configuration wizard is provided in a text file in the format of the Junos OS configuration. The sample configuration contains everything under the fair-usage group. The configuration configures IP dynamic interfaces for Dynamic Host Configuration Protocol (DHCP) access. You must edit the interface names that are used for DHCP access in this sample configuration. The sample configuration file is DemosAndSamplesApplications/wizard/fair-usage-mx.txt in SDK+AppSupport+Demos+Samples.tar.gz.

Related Documentation

Modified: 2016-05-27