Configuring the GPRS Tunneling Protocol
IMPORTANT:
Configuring GTPP for GGSN/P-GW
configure
context source
apn apnname1.com
accounting-mode gtpp
gtpp
group group1 accounting-context
billing
end
IMPORTANT:
configure
context source
gtpp
group group1
gtpp
charging-agent address 1.2.3.4 port 3386
gtpp
server 1.3.5.6 max msgs priority 1
gtpp
dictionary dict1
gtpp
max-cdr 255 wait-time 10
gtpp
transport-layer udp
end
IMPORTANT:
configure
context source
ggsn-service ggsn1
accounting
context billing
end
|
Command
|
Default
|
Range
|
Comment
|
|---|---|---|---|
|
gtpp group name in
billing context
|
|||
|
gtpp trigger egcdr
max-losdv
|
no
|
no, enabled
|
When this trigger
is enabled a partial record will be generated once the maximum configured
number of eG-CDR service containers has been reached.
|
|
gtpp egcdr lotdv-max-containers int
|
int=8
|
int=1..8
|
This parameter allows changing
the maximum number of traffic volume containers in the LOTV field
of the eG-CDR.
|
|
gtpp egcdr losdv-max-containers int
|
int=10
|
int=1..255
|
This parameter allows changing
the maximum number of service data containers in the eG-CDR.
|
|
gtpp egcdr final-record
include-content-ids (all | only-with-traffic) closing-cause (same-in-all-partials | unique)
|
only-with-traffic
same-in-all-partials
|
The CLI option 'include-content-ids'
allows controlling the service containers that are included in the
final eG-CDR generated for a subscriber. With "all", not only the service
containers which are currently counting traffic are included, but
also all other containers which may have been closed earlier for
this subscriber session with a "partial" cause value.
The CLI option 'closing-cause'
allows controlling the cause for record closing in the final eG-CDR
in case multiple eG-CDRs need to be generated for final closure
reason such as 'Normal Release'.
By default if multiple
eG-CDRs are generated for end of subscriber session all the eG-CDRs have
the same cause for record closing.
|
|
|
gtpp egcdr service-idle-timeout seconds
|
seconds=0
|
seconds=0,
10-86400
|
The service idle timeout configuration
allows to specify a time period after which, if no data is reported
for a service flow, the service container is closed and added to
the eGCDR as part of LOSDV Container list with service condition
change as "ServiceIdleOut".
|
|
rulebase name in
Active Charging Service
|
|||
|
timestamp rounding
egcdr (ceiling | floor | round-off)
|
round-off
|
Defines the method
to determine the value for time stamp and duration fields in the
eG-CDR: ceiling will always use the next full second, floor cuts
off all milliseconds, and round off will use the standard rounding
mechanism to use the closest full second value (i.e. rounding down
for milliseconds 1-499, and rounding up for milliseconds 500-999).
|
|
|
egcdr threshold interval seconds
|
no
|
seconds=60..40000000
|
Sets the interval
for generating a partial eG-CDR
|
|
egcdr threshold volume
(downlink octets | uplink octets | total octets )
|
no
|
octets=10000-400000000
|
Sets the volume limit
in downlink only, uplink only or for the total after which a partial
eG-CDR.
|
|
egcdr service-data-flow
threshold interval seconds
|
no
|
seconds=60..40000000
|
Sets the interval
for generating partial service containers. The eG-CDR is not closed
unless the maximum configured limit of service containers has been
reached and this trigger is not disabled.
|
|
egcdr service-data-flow
threshold volume (downlink octets | uplink octets | total octets )
|
no
|
octets=10000-400000000
|
Sets the volume limit
in downlink only, uplink only or for the total after which a partial
service container is generated. The eG-CDR is not closed unless
the maximum configured limit of service containers has been reached
and this trigger is not disabled.
|
|
egcdr tariff minute minute hour hour
|
no
|
minute=0..59
hour=0..23
|
Specifies a single
tariff time change which triggers the closing and reopening of a
traffic data volume container. The command can be repeated up to
4 times to define multiple tariff time changes.
|
|
apn name
|
|||
|
active-charging-service
rulebase string
|
string= 1..63 characters
|
Selects the default
rulebase to be applied to a subscriber session.
|
|
|
cc-home behavior bits profile index
|
bits=0x000
index=8
|
bits=0x000-0xFFF
index=0-15
|
When the GGSN is configured to
reject the charging characteristics sent by the SGSN for "home" subscribers,
it uses the profile index specified by this command to determine
the appropriate CCs to use.
Multiple behavior
bits can be configured for a single profile index by "Or"ing the
bit strings together and convert the result to hexadecimal.
Other than for G-CDRs,
this setting does not impact the triggers for CDRs, it is just used
to set the default content for the CC field in the CDR.
|
|
cc-roaming behavior bits profile index
|
bits=0x000
index=8
|
bits=0x000-0xFFF
index=0-15
|
Same as above, but
for "roaming" subscribers
|
|
cc-visting behavior bits profile index
|
bits=0x000
index=8
|
bits=0x000-0xFFF
index=0-15
|
Same as above, but
for "visiting" subscribers.
|
|
cc-sgsn
|
no
|
|
Causes the GGSN's
accepting of the specified CC from the SGSN(s).
|
|
cc-sgsn radius-returned
|
no
|
|
GGSN accepts CC provided by
Radius
|
|
cc-sgsn radius-returned
use-ggsn profile index
|
no
|
index=0-15
|
GGSN accepts CC from
AAA server, or uses index if not
provided
|
|
cc-sgsn use-ggsn profile index
|
no
|
index=0-15
|
GGSN uses profile index and
sets bits 0-3 of the CC to index, overriding
all other ways of providing CC
|
|
cc-sgsn use-ggsn behaviour bits
|
0xFFF
|
0x000-0xFFF
|
GGSN sets bits 4-31
of the CC to bits, overriding
all other ways of providing CC
|
Configuring GTPP for PDG and TTG
configure
context dest1
apn apn_name
accounting-mode gtpp
gtpp
group group1 accounting-context pdg
end
configure
context dest1
policy
accounting acct1
cc
profile 1 interval 60
cc
profile 1 volume total 100000
cc
profile 1 tariff time 1 0 0 time 2 2 2 time 3 4 4 time 4 5 5
cc
profile 1 buckets 3
cc
profile 1 serving-nodes 4
end
configure
context source
pdg-service pdg1
associate
accounting-policy acct1
end
configure
context source
gtpp
group group1
gtpp
charging-agent address 1.2.3.4 port 3386
gtpp
server 1.3.5.6 max msgs priority 1
gtpp
dictionary dict1
gtpp
max-cdr 255 wait-time 10
gtpp
transport-layer udp
gtpp
trigger volume-limit
gtpp
attribute local-record-sequence-number
end
configure
context dest1
subscriber
default
accounting-mode gtpp
end
configure
context dest1
policy
accounting acct1
cc
profile 1 interval 60
cc
profile 1 volume total 100000
cc
profile 1 tariff time 1 0 0 time 2 2 2 time 3 4 4 time 4 5 5
cc
profile 1 buckets 3
cc
profile 1 serving-nodes 4
end
configure
context source
pdg-service pdg1
accounting
context pdg
associate
accounting-policy acct1
end
configure
context source
gtpp
group default
gtpp
charging-agent address 1.2.3.4 port 3386
gtpp
server 1.3.5.6 max msgs priority 1
gtpp
dictionary dict1
gtpp
max-cdr 255 wait-time 10
gtpp
transport-layer udp
gtpp
trigger volume-limit
gtpp
attribute rat
end
Configuring GTPP for S-GW
configure
context dest1
subscriber default
accounting-mode gtpp
end
configure
context dest1
policy
accounting lte
cc
profile 1 interval 60
cc
profile 1 volume total 100000
cc
profile 1 tariff time 1 0 0 time 2 2 2 time 3 4 4 time 4 5 5
cc
profile 1 buckets 3
cc
profile 1 serving-nodes 4
end
configure
context source
sgw-service sgw1
associate
accounting-policy lte
end
configure
context source
sgw-service sgw1
accounting
context dest1 gtpp group sgw
end
configure
context source
gtpp
group group1
gtpp
charging-agent address 1.2.3.4 port 3386
gtpp
server 1.3.5.6 max msgs priority 1
gtpp
dictionary dict1
gtpp
max-cdr 255 wait-time 10
gtpp
transport-layer udp
end
IMPORTANT:
Configuring GTPP for SGSN
configure
context local
gtpp
single-source private-extensions
end
configure
context source
gtpp
group default
gtpp
charging-agent address 192.168.10.10
gtpp
server 192.168.10.2 priority 1 max 1
gtpp
dictionary custom10
end
IMPORTANT:
| Command | Default Value | Range | Comment |
|---|---|---|---|
|
gtpp group <name> in
billing context
|
|||
|
Trigger Related Configuration
|
|||
|
gtpp trigger volume-limit
|
enabled
|
no, enabled
|
When this trigger
is disabled no partial record closure occurs when volume limit is reached.
|
|
gtpp trigger time-limit
|
enabled
|
no, enabled
|
When this trigger
is disabled no partial record closure occurs when the configured
time limit is reached.
|
|
gtpp trigger tariff-time-change
|
enabled
|
no, enabled
|
When this trigger
is disabled container closure does not happen for a tariff-time change.
|
|
gtpp trigger qos-change
|
enabled
|
no, enabled
|
Disabling this trigger
ignores a qos-change and does not open a new CDR for it.
|
|
CDR attribute related
configuration
|
|||
|
gtpp attribute diagnostics
|
no
|
no, enabled
|
Includes the Diagnostic
field in the CDR that is created when PDP contexts are released.
|
|
gtpp attribute duration-ms
|
no
|
no, enabled
|
Specifying this option
results in mandatory "Duration" field in the CDR to be recorded
in milliseconds rather than seconds.
|
|
gtpp attribute imei
|
enabled
|
no, enabled
|
Specifying this option
includes field "IMEI" in the CDR.
|
|
gtpp attribute camel-info
|
disabled
|
no, enabled
|
If enabled include
CAMEL related information in the CDR provided if Ge interface is enabled.
|
|
gtpp attribute local-record-sequence-number
|
no
|
no, enabled
|
Specifying this option
includes optional fields "Local Record Sequence Number" and "Node-ID"
in the CDR. Since the "Local Record Sequence Number" has to be unique
within one node (identified by "Node-ID"), "Node-ID" field will
consist of sessMgr Recovery count + AAA Manager identifier + the
name of the GSN service. Since each AAA Manager generates CDRs independently,
that allows the "Local Record Sequence Number" and "Node ID" fields
to uniquely identify a CDR.
|
|
gtpp attribute msisdn
|
enabled
|
no, enabled
|
Specifying this option
includes field "MSISDN" in the CDR.
|
|
gtpp attribute node-id-suffix <string>
|
no
|
string from 1 to 16
characters
|
Specifies the string
suffix to use in the Node-ID field of S-CDRs. With the default setting
of "no" the SGSN uses the GTPP context name for the Node-Id field.
|
|
gtpp attribute rat
|
enabled
|
no, enabled
|
Specifying this option
includes field "RAT" in the CDR.
|
|
HDD related configuration
|
|||
|
gtpp storage-server
local file format <custom1-custom6>
|
custom4
|
enabled
|
Defines the file format
for CDR files created on the hard disk.
|
|
gtpp storage-server
local file compression
|
none
|
none
gzip
|
Allows to compress
generated billing files with gzip.
|
|
gtpp storage-server
mode { local | remote }
|
remote
|
enabled
|
This enables HDD storage.
|
|
gtpp storage-server
local file rotation cdr-count <1000-65535>
|
cdr-count
10000
|
no, enabled
|
Configures cdr-count
for file rotation.
|
|
gtpp storage-server
local file rotation volume mb <2MB-40MB>
|
4MB
|
no, enabled
|
Configures file volume
for file rotation.
|
|
gtpp storage-server
local file rotation time-interval
|
3600
|
no, enabled
|
Configures time-interval
for file rotation.
|
| sgsn-service <name> in Gn context or "gprs-service <name>" in Gn context | |||
|
cc profile <index> buckets <number>
|
index=0-15
number=4
|
index=0-15
number=1-4
|
Specifies the number
of traffic volume container changes due to QoS changes or tariff time
that can occur before an accounting record should be closed.
|
|
cc profile <index> interval <seconds>
|
no
|
index=0-15
interval= 60-40.000.000 seconds
octets=0-1,000,000
|
Specifies the normal
time duration that must elapse before closing an accounting record.
|
|
cc profile <index> volume volume { downlink <octets> uplink <octets> | total <octets> }
|
no
|
index=0 -1 5
octets= 100.000- 4.000.000.000
|
Specifies the downlink,
uplink, and total volumes that must be met before closing an accounting
record.
|
|
cc profile <index> tariff time1 mins hours time2 mins hours time3 mins hours time4 mins hours
|
no
|
index= 0-15
mins= 0 to 59
hours= 0 to 23
|
Specifies time-of-day
time values to close the current traffic volume container (but not necessarily
the accounting record). Four different tariff times may be specified.
If less than four times are required, the same time can be specified multiple
times.
|
|
sgsn-operator-policy { default | name <name> }
|
|||
|
cc behavior no-records
|
no
|
1-12
|
Specifies the behavior
bit upon which the SGSN ceases sending accounting records to a server.
nr_value can be
configured to any integer value between 1 and 12 corresponding to
the 12 behavior bits.
|
|
cc prefer
|
hlr-value
|
local- valuehlr-value
|
Specify the preference
for local/HLR CC settings.
|
|
cc local-value behavior <bits> profile <index>
|
bits=0x000index=8
|
bits= 0x000-0xFFF
index=0-15
|
When no CC is provided
by the HLR or the local-value is preferred, then this command specifies
the charging characteristics to be used.
|
|
sgsn-operator-policy { default | name <name> } ,
apn
|
|||
|
cc local-value-for-scdrs
behaviour <bits>
|
no
|
bits= 0x000-0xFFF
|
Set behavior bits
per APN for S-CDR. This will be given highest priority if CC is
configured in sgsn-op-policy and apn level.
|
|
cc prefer
|
no
|
hlr-value-for-scdrshlr-value-for-scdrs
|
Define if HLR or local
CC value is used in S-CDR.
|
Sample Configuration for SGSN when HDD is Used
configure
context source
gtpp
group default
gtpp
dictionary custom10
gtpp
storage-server mode local
gtpp
storage-server local file format custom3
gtpp
storage-server local file rotation cdr-count 1000
gtpp
storage-server local file rotation time-interval 4000
gtpp
storage-server local file rotation volume mb 8
end
Gathering Statistics
|
Statistics/Information
|
Action to Perform
|
|---|---|
|
GTPP statistics for Charging
Gateway Functions
|
At the Exec Mode prompt,
enter the following command:
show gtpp statistics
cgf-address cgf_address
|
|
Information on the
number of CDRs stored in HDD
|
At the Exec Mode prompt,
enter the following command:
show gtpp storage-server
local file statistics
|
|
Information on the
GTPP accounting server configuration
|
At the Exec Mode prompt,
enter the following command:
show gtpp accounting
servers group name group_name
|
|
Information on the
CDR storage server status
|
At the Exec Mode prompt,
enter the following command:
show gtpp storage-server status
|