Cisco OL-15491-01 User Manual
APPENDIX
A
CSG2 Command Reference
This appendix documents the commands necessary to configure and monitor the CSG2. Other
commands used with the CSG2 are documented in the following publications:
• Service and Application Module for IP User Guide for the following commands:
–
Supervisor console commands
–
Power PC console commands
–
Power PC ROM-monitor (ROMmon) console commands
–
Broadcom BCM Linux-based Storage Area Network Operation System (SanOS) console
commands
–
Broadcom BCM ROMmon console commands
–
Line Card Processor (LCP) console commands
• Cisco IOS Server Load Balancing Command Reference for IOS SLB-specific commands
• Cisco IOS Release 12.2 command reference publications for other IOS commands
All of the CSG2 commands are listed below in alphabetical order:
• accounting, page A-6
OL-15491-01
• activation, page A-7
• aoc append url, page A-9
• aoc confirm, page A-10
• aoc enable, page A-12
• basis, page A-14
• block, page A-17
• class, page A-18
• clear ip csg, page A-19
• clear ip iscsi statistics, page A-21
• clear record-storage-module stats, page A-22
• client-group (CSG2 content), page A-23
• content (CSG2 service), page A-25
• debug ip csg, page A-27
• entries user idle, page A-32
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-1
• flags, page A-34
• idle (CSG2 content), page A-37
• idle (CSG2 service), page A-39
• inservice (CSG2 content), page A-41
• ip (CSG2 content), page A-42
• ip (iSCSI), page A-44
• ip csg billing, page A-46
• ip csg bma, page A-47
• ip csg bma activate, page A-49
• ip csg bma keepalive, page A-51
• ip csg bma local-port, page A-52
• ip csg bma messages, page A-54
• ip csg bma retransmit, page A-56
• ip csg bma retries, page A-57
Appendix A CSG2 Command Reference
• ip csg bma window, page A-59
• ip csg case-sensitive, page A-60
• ip csg content, page A-61
• ip csg database, page A-64
• ip csg entries fragment, page A-66
• ip csg entries session user max, page A-68
• ip csg entries user idle, page A-70
• ip csg entries user max, page A-72
• ip csg entries user profile, page A-74
• ip csg ipc crashdump, page A-76
• ip csg ipc keepalive, page A-77
• ip csg ipc retransmit, page A-78
• ip csg ipc retries, page A-79
• ip csg iscsi drain delay, page A-80
• ip csg iscsi drain packet, page A-81
• ip csg iscsi profile, page A-83
• ip csg map, page A-84
• ip csg mode single-tp, page A-86
• ip csg policy, page A-87
• ip csg psd, page A-89
A-2
• ip csg psd drain delay, page A-91
• ip csg psd drain packet, page A-92
• ip csg psd keepalive, page A-93
• ip csg psd local-port, page A-94
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
OL-15491-01
Appendix A CSG2 Command Reference
• ip csg psd margin, page A-96
• ip csg psd retransmit, page A-97
• ip csg psd retries, page A-98
• ip csg psd window, page A-100
• ip csg quota-server, page A-101
• ip csg quota-server activate, page A-104
• ip csg quota-server keepalive, page A-106
• ip csg quota-server local-port, page A-107
• ip csg quota-server messages, page A-109
• ip csg quota-server reassign, page A-110
• ip csg quota-server retransmit, page A-111
• ip csg quota-server retries, page A-112
• ip csg quota-server window, page A-114
• ip csg radius ack error parse, page A-116
• ip csg radius correlation, page A-120
• ip csg radius endpoint, page A-122
• ip csg radius handoff, page A-126
• ip csg radius monitor, page A-128
• ip csg radius monitor nas, page A-131
• ip csg radius on-off purge, page A-133
• ip csg radius pod attribute, page A-134
• ip csg radius pod nas, page A-136
• ip csg radius pod timeout, page A-138
• ip csg radius proxy, page A-139
• ip csg radius reauthorization attribute, page A-143
• ip csg radius start restart session-id, page A-145
• ip csg radius stop purge, page A-147
• ip csg radius userid, page A-149
• ip csg records format, page A-151
• ip csg redirect, page A-152
• ip csg refund, page A-154
• ip csg replicate, page A-155
• ip csg report http header, page A-157
• ip csg report radius attribute, page A-159
OL-15491-01
• ip csg report smtp rfc2822, page A-161
• ip csg report usage, page A-162
• ip csg report wap actual-pdu, page A-164
• ip csg service, page A-165
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-3
• ip csg snmp timer, page A-168
• ip csg subscriber, page A-169
• ip csg transport-type assign, page A-170
• ip iscsi target-profile, page A-171
• map, page A-173
• match header, page A-175
• match method, page A-179
• match url, page A-182
• meter exclude control sip, page A-186
• meter exclude mms wap, page A-188
• meter exclude network-init sip, page A-190
• meter exclude pause rtsp, page A-192
• meter exclude svc-idle, page A-194
• meter include imap, page A-196
Appendix A CSG2 Command Reference
• meter increment, page A-199
• meter initial, page A-201
• meter minimum, page A-203
• mode, page A-205
• mode tcp, page A-206
• name (iSCSI), page A-207
• next-hop, page A-209
• owner, page A-211
• parse length, page A-212
• parse protocol, page A-213
• passthrough, page A-215
• pending, page A-216
• policy (CSG2 content), page A-217
• port (iSCSI), page A-219
• reauthorization threshold, page A-221
• reauthorization timeout, page A-223
• records delay, page A-225
• records granularity, page A-226
• records intermediate, page A-228
• refund, page A-230
A-4
• replicate, page A-231
• retcode, page A-233
• sami rate all, page A-235
• service, page A-236
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
OL-15491-01
Appendix A CSG2 Command Reference
• session-timeout (iSCSI), page A-237
• show ip csg, page A-239
• show ip iscsi, page A-252
• show record-storage-module, page A-255
• snmp-server enable traps csg, page A-257
• subscriber-ip http-header forwarded-for, page A-259
• target-portal (iSCSI), page A-261
• verify confirm, page A-263
• verify enable, page A-265
• vlan (CSG2 content), page A-266
• vrf, page A-267
OL-15491-01
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-5
accounting
accounting
Appendix A CSG2 Command Reference
To specify accounting and an optional customer string for a CSG2 policy, use the accounting command
in CSG2 policy configuration mode. To remove accounting for a policy, use the no form of this
command.
accounting [customer-string string]
no accounting [customer-string string]
Syntax Description
Defaults The default is no accounting.
Command Modes CSG2 policy configuration
Command History
Usage Guidelines This command is required if the CSG2 is to generate call detail records (CDRs) for content that matches
customer-string string (Optional) 1- to 16-byte string to be output to the generated accounting
records.
Release Modification
12.4(11)MD This command was migrated from CSG1.
Changes from CSG1: All keywords and arguments except customer-string string
were removed.
12.4(15)MD Support for FTP was added.
the CSG2 policy.
This command is required to enable billing functions (such as CDR generation and prepaid charging) for
content that matches a CSG2 policy.
For FTP and Real Time Streaming Protocol (RTSP) accounting, the CSG2 matches prepaid services on
the basis of the IP address and port number of the control connection to the FTP or RTSP network IP
address.
Examples The following example shows how to specify accounting and customer strings for a CSG2 policy:
ip csg policy MOVIES
accounting customer-string MOVIES
Related Commands
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-6
Command Description
ip csg policy Defines a policy for qualifying flows for the CSG2 billing services, and
enters CSG2 policy configuration mode.
OL-15491-01
Appendix A CSG2 Command Reference
activation
To specify the activation mode for a CSG2 Connection Duration service, use the activation command
in CSG2 service configuration mode. To restore the default setting, use the no form of this command.
activation [automatic | user-profile]
no activation
activation
Syntax Description
automatic (Optional) Activates the Connection Duration service, unless the billing profile
indicates that no service is to be activated.
If you specify the automatic keyword, the CSG2 activates the Connection Duration
service in the subscriber’s billing plan automatically, unless the service name is
specified with a zero length as the connect service in the billing profile information.
The connect service information must be specified in the same message as the
subscriber’s billing plan.
user-profile (Optional) Activates the Connection Duration service only if the billing profile
specifies this service as the connect service. This is the default setting.
If you specify the user-profile keyword, the CSG2 activates the Connection Duration
service for a subscriber only if the service name is specified as a connect service in
the billing profile information in an authentication, authorization, and accounting
(AAA) Access-Accept, an AAA Accounting-Start, or a Quota Server User-Profile
Response.
Defaults The Connection Duration service is activated only if the billing profile specifies this service as the
connect service.
Command Modes CSG2 service configuration
Command History
Release Modification
12.4(11)MD This command was migrated from CSG1.
Changes from CSG1: None.
Usage Guidelines This command requires that the service be configured with basis second connect.
Examples The following example specifies automatic activation for Connection Duration service CONNECT.
ip csg service CONNECT
basis second connect
activation automatic
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
OL-15491-01
A-7
activation
Related Commands Command Description
ip csg service Configures a CSG2 content billing service, and enters CSG2 service
configuration mode.
Appendix A CSG2 Command Reference
A-8
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
OL-15491-01
Appendix A CSG2 Command Reference
aoc append url
To specify that the CSG2 is to append the original URL to the redirect URL sent by the quota server on
a Content Authorization REDIRECT_URL response for use in Advice of Charge (AoC) URL-rewriting,
use the aoc append url command in CSG2 service configuration mode. To restore the default setting,
use the no form of this command.
aoc append url
no aoc append url
Syntax Description This command has no arguments or keywords.
Defaults The CSG2 does not append the original URL to the redirect URL.
aoc append url
Command Modes CSG2 service configuration
Command History
Release Modification
12.4(11)MD This command was introduced.
Usage Guidelines Before configuring this command, you must enable AoC by configuring the aoc enable command.
The CSG2 performs this function only for content parsed as connectionless or connection-oriented
wireless application protocol (WAP 1.x). For other protocols, the CSG2 ignores this configuration
option.
Examples The following example specifies that the CSG2 is to append the original URL to the redirect URL for
use in AoC URL-rewriting:
ip csg service MOVIES
aoc enable
aoc append url
Related Commands
Command Description
aoc confirm Configures a token for use in Advice of Charge (AoC) URL-rewriting.
aoc enable Enables Advice of Charge (AoC) URL-rewriting for the CSG2.
ip csg service Configures a CSG2 content billing service, and enters CSG2 service
configuration mode.
OL-15491-01
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-9
aoc confirm
aoc confirm
Appendix A CSG2 Command Reference
To configure a token for use in Advice of Charge (AoC) URL-rewriting, use the aoc confirm command
in CSG2 service configuration mode. To remove the token, use the no form of this command.
aoc confirm token
no aoc confirm
Syntax Description
Defaults None
Command Modes CSG2 service configuration
Command History
token A string of up to 15 alphanumeric characters. The string is not case-sensitive.
Acceptable characters include alphanumeric characters and any of the following
special characters: $-_.+!*'(),?/:@&=;~%. To enter other special characters not listed,
use the URL-escape format with the percent sign (%).
To insert a question mark (?) in the string, press Ctrl-v and then press the question
mark (?) key. To insert a question mark in an editing document, use ASCII code 22.
To retain the question mark, use TFTP instead of copy-and-paste.
Release Modification
12.4(11)MD This command was migrated from CSG1.
Changes from CSG1:
• The name of this command changed from aoc confirmation to aoc confirm.
• The configuration mode for this command changed from CSG user group
configuration to CSG2 service configuration.
• The list of supported special characters changed.
Usage Guidelines Before configuring this command, you must enable AoC by configuring the aoc enable command.
URL-rewriting allows a top-off server to append parameters to a URL in order to convey state
information to the quota server during a Content Authorization Request. Whenever a Content
Authorization Response contains the forward action code, and the URL contains the AoC confirmation
token, the token and all trailing characters are removed from the URL before the request is forwarded to
the server.
The token is used for HTTP and WAP 1.x content authorization URL-rewriting.
If the token uses the URL-escape format, the redirect URL to which the token is being matched must
also use the URL-escape format.
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-10
OL-15491-01
Appendix A CSG2 Command Reference
Examples The following example specifies a token for Advice of Charge (AoC) URL-rewriting:
ip csg service MOVIES
aoc enable
aoc confirm ?CSG_AOC_OK
Related Commands Command Description
aoc append url Specifies that the CSG2 is to append the original URL to the redirect URL sent
by the quota server for use in Advice of Charge (AoC) URL-rewriting.
aoc enable Enables Advice of Charge (AoC) URL-rewriting for the CSG2.
ip csg service Configures a CSG2 content billing service, and enters CSG2 service
configuration mode.
aoc confirm
OL-15491-01
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-11
aoc enable
aoc enable
To enable Advice of Charge (AoC) URL-rewriting for the CSG2, use the aoc enable command in CSG2
service configuration mode. To restore the default setting, use the no form of this command.
aoc enable
no aoc enable
Syntax Description This command has no arguments or keywords.
Defaults The CSG2 does not append the original URL to the redirect URL.
Command Modes CSG2 service configuration
Appendix A CSG2 Command Reference
Command History
Release Modification
12.4(11)MD This command was migrated from CSG1.
Changes from CSG1: The name of this command changed from authorize content to
aoc enable.
Usage Guidelines This command is not valid if the service is configured with basis second connect.
If this command is configured, the CSG2 alerts the quota server of a new transaction, and allows it to
direct the CSG2 to perform any of the following mutually exclusive actions:
• DROP: Instructs the CSG2 to drop all packets for this flow.
• FORWARD: Instructs the CSG2 to forward the flow without altering the destination (a weight
might be specified).
• REDIRECT-URL: Instructs the CSG2 to redirect subscriber requests to the URL provided by the
quota server. The CSG2 sends a Layer 7 redirect to the subscriber (for example, HTTP 302 response)
that contains the redirect URL. This applies to both HTTP and WAP 1.x protocols.
Examples The following example enables AoC URL-rewriting for the CSG2:
ip csg service MOVIES
aoc enable
Related Commands
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-12
Command Description
aoc append url Specifies that the CSG2 is to append the original URL to the redirect URL sent by
the quota server for use in Advice of Charge (AoC) URL-rewriting.
OL-15491-01
Appendix A CSG2 Command Reference
Command Description
aoc confirm Configures a token for use in Advice of Charge (AoC) URL-rewriting.
ip csg service Configures a CSG2 content billing service, and enters CSG2 service configuration
aoc enable
mode.
OL-15491-01
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-13
basis
basis
Appendix A CSG2 Command Reference
To specify the billing basis for a CSG2 content billing service, use the basis command in CSG2 service
configuration mode. To use the default billing basis, use the no form of this command.
basis [byte {ip | tcp} | {fixed | second [connect | transaction]}]
no basis [byte {ip | tcp} | {fixed | second [connect | transaction]}]
Syntax Description
byte ip (Optional) Billing charge is a function of the IP data volume processed
during the subscriber’s session. This is the default setting.
byte tcp (Optional) Billing charge is a function of the TCP data volume processed
during the subscriber’s session.
Note Supplemental usage reporting always reports IP bytes, even if the
billing basis is configured for TCP bytes.
fixed (Optional) Billing charge is a fixed cost, which is deducted each time the
first packet for a transaction hits a content-policy pair (that is, deducted for
each request).
second (Optional) Billing charge is duration-based for the CSG2 service. Unless
the connect keyword is also configured, the billing is for the service
duration time.
connect (Optional) Billing charge is based on connection duration time, not service
duration time.
Note If you specify the connect keyword, the balance and consumed
fields in the output of the show ip csg users command are updated
only when there is a Service Reauthorization Request for new quota.
transaction (Optional) Billing charge is based on transaction duration time.
Note The transaction keyword is valid for Session Initiation Protocol
(SIP) only.
Defaults The default setting is byte ip (billing charge is a function of the IP data volume processed).
Command Modes CSG2 service configuration
Command History
Usage Guidelines The basis command applies to prepaid and virtual prepaid billing only. It has no impact on postpaid
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-14
Release Modification
12.4(11)MD This command was migrated from CSG1.
Changes from CSG1: The exclude mms keyword was removed.
12.4(15)MD The transaction keyword was added.
billing.
OL-15491-01
Appendix A CSG2 Command Reference
For TCP billing, configuring basis byte tcp allows counting of only TCP payload and exclusion of
overhead for network retransmission. With this option, the CSG2 excludes IP and TCP headers from
volume counts. The byte counting is limited to TCP payload. Retransmitted packets are not counted.
Services that are configured with the basis second connect command (that is, for Connection Duration
Billing) are subject to the following restrictions:
• Service verification is not supported for Connection Duration services.
• If redirect is to be performed when the Connection Duration service runs out of quota, the URL
location to which the CSG2 redirects must map to a policy that does not have accounting configured.
This is because all IP sessions mapped to policies with accounting configured (postpaid or prepaid)
are dropped when the Connection Duration service has no quota.
For Service Duration Billing:
• When a Service Duration Billing Service is a member of a billing plan, and an accounting definition
is in service and downloaded to a CSG2 module, you cannot modify the basis or meter configuration.
You are instructed at the console to configure no inservice on the downloaded Accounting
definitions.
• If a content configuration is included in a service configured for basis second, the CSG2 restricts
the content idle timeout to less than or equal to the service idle timeout for the service. The content
idle time is not included in the last billable time for the service.
• The CSG2 does not allow you to specify weights for Service Duration Billing.
basis
Note We recommend that you first remove the service from each billing plan, make the basis changes, and add
it back to each billing plan. If you delete it, the service is automatically removed from each billing plan,
and you must add it back to each plan after configuring it.
To enable Connection Duration Billing for a service, configure the service name as a service under one
or more billing plans in CSG2 billing configuration mode, then enter the basis second connect command
in CSG2 service configuration mode.
Because Internet Message Access Protocol (IMAP) metering is byte-based, you cannot configure both
meter include imap and basis fixed or basis second in the same service. Only basis byte is meaningful
with meter include imap.
You cannot configure both meter exclude svc-idle and basis byte or basis fixed in the same service.
Only basis second is meaningful with meter exclude svc-idle.
Examples The following example shows how to specify fixed billing for the CSG2 service MOVIES:
ip csg service MOVIES
basis fixed
The following commands are used to configure Service Duration Billing for the OFF_NET service.
ip csg service OFF_NET
basis second
Related Commands
OL-15491-01
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-15
basis
Appendix A CSG2 Command Reference
Command Description
ip csg service Configures a CSG2 content billing service, and enters CSG2 service
configuration mode.
meter exclude svc-idle Excludes timers from the usage calculation.
meter include imap Specifies which Internet Message Access Protocol (IMAP) bytes are billed
for when doing prepaid debits.
meter increment Specifies the increments for debiting quota upon completion of a service
configured for Service Duration Billing.
A-16
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
OL-15491-01
Appendix A CSG2 Command Reference
block
To force the CSG2 to drop packets that do not match a configured billing policy, use the block command
in CSG2 content configuration mode. To restore the default behavior, enabling the CSG2 to forward the
packets without billing, use the no form of this command.
block
no block
Syntax Description This command has no arguments or keywords.
Defaults None
Command Modes CSG2 content configuration
block
Command History
Release Modification
12.4(11)MD This command was migrated from CSG1.
Changes from CSG1:
• The name of this command changed from ip csg block to block.
• The configuration mode for this command changed from global to CSG2 content
configuration.
Usage Guidelines By default, if packets do not match any billing policy, the CSG2 forwards the packets without billing.
This command causes the CSG2 to drop the packets instead.
Examples The following example shows how to force the CSG2 to drop packets that do not match any billing
policy:
ip csg content MOVIES
block
Related Commands
Command Description
ip csg content Configures content for CSG2 services, and enters CSG2 content
configuration mode.
ip csg policy Defines a policy for qualifying flows for the CSG2 accounting services, and
enters CSG2 policy configuration mode.
parse length Defines the maximum number of Layer 7 bytes that the CSG2 is to parse when
attempting to assign a policy.
OL-15491-01
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-17
class
class
Appendix A CSG2 Command Reference
To specify a service class value, use the class command in CSG2 service configuration mode. To remove
the service class value, use the no form of this command.
class value
no class value
Syntax Description
Defaults None
Command Modes CSG2 service configuration
Command History
Usage Guidelines The class command is used with fixed-record format to identify a service class value. This value is
Examples The following example specifies a class value for the service:
value Specifies a value in the range 1 to 255.
Release Modification
12.4(11)MD This command was migrated from CSG1.
Changes from CSG1: None.
opaque to the CSG2 and has meaning only for the administrator. It is reported as tariff-class in
fixed-record format call detail records (CDRs).
ip csg service FOO
class 7
Related Commands
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-18
Command Description
ip csg service Configures a CSG2 content billing service, and enters CSG2 service
configuration mode.
ip csg transport-type assign Classifies data traffic on the basis of its access path.
mode Specifies the mode for a CSG2 billing plan.
ip csg records format Specifies variable or fixed CDR format.
owner Specifies an identifier or name for a service owner.
OL-15491-01
Appendix A CSG2 Command Reference
clear ip csg
clear ip csg
To clear the CSG2, use the clear ip csg command in privileged EXEC mode.
clear ip csg {counters | sessions user [application] [ip-address ip-mask] |
user [all | ip ip-address {global | vrf vrf-name}]}
Syntax Description counters Clears all CSG2 cumulative counters and statistics, but not CSG2
“state” counters. For example, counters such as “current number of
sessions” are not cleared.
sessions user Closes all subscriber sessions.
application (Optional) Closes subscriber sessions for only the specified
application:
• ftp—Closes FTP subscriber sessions.
• http—Closes HTTP subscriber sessions.
• imap—Closes IMAP subscriber sessions.
• other—Closes other subscriber sessions.
• pop3—Closes POP3 subscriber sessions.
• rtsp—Closes RTSP subscriber sessions.
• smtp—Closes SMTP subscriber sessions.
• wap—Closes WAP subscriber sessions.
ip-address ip-mask (Optional) Closes subscriber sessions for only the specified
subscriber IP address and subscriber IP address mask.
Specify IP address 0.0.0.0 to close subscriber sessions for all
subscriber IP addresses.
Specify IP address mask 0 to close subscriber sessions for all
subscriber IP address masks.
user Closes all subscriber entries in the CSG2 User Table.
all (Optional) Closes all subscriber entries in the CSG2 User Table.
ip ip-address (Optional) Closes only those subscriber entries in the CSG2 User
Table that are associated with the specified IP address.
global (Optional) Closes all subscriber entries that are associated with the
specified IP address.
vrf vrf-name (Optional) Closes only those subscriber entries that are associated
with the specified IP address and that are associated with the
specified Virtual Routing and Forwarding (VRF) table.
Note The VRF table name is defined using the vrf definition
command in global configuration mode. VRF table names
supported by the CSG2 can be from 1 to 32 characters long,
and can include uppercase or lowercase letters, numbers, and
any special characters.
OL-15491-01
The CSG2 does not support the use of the word forwarding
as a valid VRF name.
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-19
clear ip csg
Defaults None
Command Modes Privileged EXEC
Appendix A CSG2 Command Reference
Command History
Release Modification
12.4(11)MD This command was introduced.
12.4(15)MD The ftp keyword was added.
Usage Guidelines By default, the CSG2 deletes 1000 User Table entries per second in response to the clear ip csg user all
command. To specify a different deletion rate, use the ip csg radius on-off purge command in global
configuration mode.
Examples The following example clears all counters and statistics for the CSG2:
clear ip csg counters
The following example clears all subscriber entries from the CSG2 User Table that are associated with
IP address 1.2.3.4:
clear ip csg user ip 1.2.3.4
The following example clears all subscriber entries from the CSG2 User Table that are associated with
IP address 1.2.3.4 and that are also associated with VRF table AAA:
clear ip csg user ip 1.2.3.4 vrf AAA
The following example clears all sessions for application http and IP address mask 1.2.3.4/32:
clear ip csg sessions user http 1.2.3.4/32
Related Commands
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-20
Command Description
show ip csg Displays information about the CSG2.
OL-15491-01
Appendix A CSG2 Command Reference
clear ip iscsi statistics
To clear current iSCSI statistics, use the clear ip iscsi statistics command in privileged EXEC
configuration mode.
clear ip iscsi statistics
Syntax Description This command has no arguments or keywords.
Command Default No default behavior or values.
Command Modes Privileged EXEC
clear ip iscsi statistics
Command History
Examples The following example clears iSCSI-related statistics:
Related Commands
Release Modification
12.4(15)MD This command was introduced.
clear ip iscsi statistics
Command Description
show ip iscsi Displays information about the iSCSI.
OL-15491-01
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-21
clear record-storage-module stats
clear record-storage-module stats
To clear current record storage module (RSM) statistics, use the clear record-storage-module stats
command in privileged EXEC configuration mode.
clear record-storage-module stats
Syntax Description This command has no arguments or keywords.
Command Default No default behavior or values.
Command Modes Privileged EXEC
Appendix A CSG2 Command Reference
Command History
Examples The following example clears RSM-related statistics:
Related Commands
Release Modification
12.4(15)MD This command was introduced.
clear record-storage-module stats
Command Description
show record-storage-module Displays information about the record storage module (RSM).
A-22
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
OL-15491-01
Appendix A CSG2 Command Reference
client-group (CSG2 content)
To reference a standard access list that is part of a CSG2 content, use the client-group command in CSG2
content configuration mode. To delete the reference, use the no form of this command.
client-group {std-access-list-number | std-access-list-name}
no client-group {std-access-list-number | std-access-list-name}
client-group (CSG2 content)
Syntax Description
std-access-list-number Standard IP access list number. The ranges are from 1 to 99 and from
1300 to 1999.
std-access-list-name Standard access list name.
Defaults All subscribers can access the content.
Command Modes CSG2 content configuration
Command History
Release Modification
12.4(11)MD This command was migrated from CSG1.
Changes from CSG1:
• The configuration mode for this command changed from CSG policy
configuration to CSG2 content configuration.
• The range for the std-access-list-number argument increased from 1300 to
1999.
Usage Guidelines The client-group command is used to qualify subscribers for the CSG2 content. The conditions
specified in the referenced access list must be true in order for the flows to be processed by the CSG2
content. If the conditions are not true, the CSG2 determines this to be a content mismatch, and normal
content match processing continues (that is, the CSG2 tries to match a less specific content). If no
contents are matched, the CSG2 does not process the flow (that is, the CSG2 blocks this traffic flow).
If you reference an access list that includes a deny statement, and that deny statement is matched, then
the CSG2 treats the traffic as a content mismatch and normal content processing continues, allowing the
traffic to match another less specific content. For example, in the following configuration, packets from
from IP address 1.1.1.1 do not match CONTENT1, but they do match CONTENT2:
ip csg content CONTENT1
ip any
client-group 99
inservice
!
ip csg content CONTENT2
ip any
inservice
!
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
OL-15491-01
A-23
Appendix A CSG2 Command Reference
client-group (CSG2 content)
access-list 99 deny 1.1.1.1
access-list 99 permit any
You can use next-hop with client groups as long as a given client group is always sent to the same next
hop. You cannot send a given client group to two or more different next hops based on a content.
The CSG2 searches contents with the same IP and VLAN configuration, but different client groups, in
numerical order. For example, given two contents with the same IP/VLAN configuration, one
referencing client group 4 and the other client group 7, the CSG2 matches the content that references
client group 4.
Examples The following example shows how to reference client group 44 for the CSG2 content MOVIES:
ip csg content MOVIES
client-group 44
Related Commands Command Description
ip csg content Configures content for CSG2 services, and enters CSG2 content configuration
mode.
next-hop Defines a next-hop IP address.
A-24
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
OL-15491-01
Appendix A CSG2 Command Reference
content (CSG2 service)
To configure a content and policy as a member of a CSG2 billing service, and optionally to assign a
weight to this content, use the content command in CSG2 service configuration mode. To remove a
content name from the billing service, use the no form of this command.
content content-name policy policy-name [weight weight-value]
no content content-name policy policy-name
content (CSG2 service)
Syntax Description
Defaults The default weight-value is 1 quadran.
Command Modes CSG2 service configuration
Command History
Usage Guidelines You must configure a policy before configuring this command.
content-name Name of the content for this service. The name can be from 1 to 15
characters long, and can include uppercase or lowercase letters (the CSG2
changes all letters to uppercase), numbers, and any special characters.
policy policy-name Name of a configured policy to apply to the content for this service.
weight weight-value (Optional) Number of quadrans to deduct for each transaction. The range is
from 0 to 32767. The default weight-value is 1 quadran.
Release Modification
12.4(11)MD This command was migrated from CSG1.
Changes from CSG1: The weight-name argument was replaced with the
weight-value argument.
Content can reference more than one policy. Therefore, you can have multiple content commands with
the same content-name argument, but different policy-name arguments.
OL-15491-01
To make a specific content free, specify a weight-value of 0.
Each content billing service is associated with one or more contents and policies.
Multiple services can include the same content/policy pair, as long as the services are not associated with
the same billing plan. They cannot be associated with the same billing plan because then the match of
content/policy pair to service would not be unique.
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-25
Appendix A CSG2 Command Reference
content (CSG2 service)
Examples The following example shows how to configure content for the CSG2 service MOVIES. In this example:
• Policy MOVIES_COMEDY is applied to content MOVIES_COMEDY.
• Policy MOVIES_ACTION is applied to content MOVIES_ACTION.
• Content MOVIES_ACTION is given a billing weight of 2.
ip csg service MOVIES
content MOVIES_COMEDY policy MOVIES_COMEDY
content MOVIES_ACTION policy MOVIES_ACTION weight 2
Related Commands Command Description
ip csg content Configures content for CSG2 services, and enters CSG2 content configuration
mode.
ip csg policy Defines a policy for qualifying flows for the CSG2 accounting services, and enters
CSG2 policy configuration mode.
ip csg service Configures a CSG2 content billing service, and enters CSG2 service configuration
mode.
A-26
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
OL-15491-01
Appendix A CSG2 Command Reference
debug ip csg
To set the flags to obtain debugging output for the various CSG2 components, use the debug ip csg
command in privileged EXEC mode. To disable the debugging feature, use the no form of this command.
debug ip csg {all | acl number [vrf vrf-name | global] | configuration sync | content | crashinfo |
error | frag | ftp | gtp {any | bma [priority] | ipc | psd | quota-server [priority]} | http [detail]
| imap | interm | ipc [detail] | iscsi [detail] | other | packet [dump] | policy | pop3 |
psd [detail] | qs [detail] | radius [detail] | replicate | rtsp
session {event | state [detail]} | sip | smtp | stats | tlv | udb [xml] | users | wap [detail] | xml}
no debug ip csg {all | acl number [vrf vrf-name | global] | configuration sync | content | crashinfo
| error | frag | ftp | gtp {any | bma [priority] | ipc | psd | quota-server [priority]} | http [detail]
| imap | interm | ipc [detail] | iscsi
psd [detail] | qs [detail] | radius [detail] | replicate | rtsp [detail] | service [detail | ha] |
session {event | state [detail]} | sip | smtp | stats | tlv | udb [xml] | users | wap [detail] | xml}
Syntax Description all Generates debugging output for all CSG2 components.
acl number Generates debugging output for all subscribers in a simple access control
list (ACL).
vrf vrf-name (Optional) Generates debugging output for the Virtual Routing and
Forwarding (VRF) table with the ACL.
[detail] | other | packet [dump] | policy | pop3 |
[detail] | service [detail | ha] |
debug ip csg
Note The VRF table name is defined using the vrf definition command
in global configuration mode. VRF table names supported by the
CSG2 can be from 1 to 32 characters long, and can include
uppercase or lowercase letters, numbers, and any special characters.
The CSG2 does not support the use of the word forwarding as a
valid VRF name.
global (Optional) Generates debugging output for the default routing table with the
ACL.
configuration sync Generates debugging output for the configuration synchronization
component.
content Generates debugging output for the CSG2 content debug messages,
indicating the results of the content match algorithm. This output is filtered
if debug ip csg acl has been configured.
crashinfo Generates debugging output for the crash information component.
error Generates debugging output for situations that might indicate a problem.
frag Generates debugging output for the CSG2 fragment database.
ftp Generates debugging output for the FTP component.
gtp any Generates debugging output for the general packet radio service (GPRS)
tunneling protocol (GTP) component’s interaction with components other
than the Billing Mediation Agent (BMA), the Interprocessor
Communication (IPC) component, the Persistent Storage Device (PSD)
component, or the quota server.
OL-15491-01
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-27
debug ip csg
Appendix A CSG2 Command Reference
gtp bma [priority] Generates debugging output for the GTP component’s interaction with the
BMA.
To generate detailed debugging output for the GTP component’s interaction
with a specific BMA, specify the quota server’s priority.
gtp ipc Generates debugging output for the GTP component’s interaction with the
IPC component.
gtp psd Generates debugging output for the GTP component’s interaction with the
PSD component.
gtp quota-server
[priority]
http [detail] Generates debugging output for the HTTP component.
imap Generates debugging output for the Internet Message Access Protocol
interm Generates debugging output for the intermediate CDR component.
ipc [detail] Generates debugging output for the IPC component.
iscsi [detail] Generates debugging output for the iSCSI component.
mail Generates debugging output for the mail component.
other Generates debugging output for other components.
packet [dump] Generates debugging output for e-mail packets.
Generates debugging output for the GTP component’s interaction with the
quota server.
To generate detailed debugging output for the GTP component’s interaction
with a specific quota server, specify the quota server’s priority.
To generate detailed debugging output for the HTTP component, specify the
optional detail keyword.
(IMAP) component.
To generate detailed debugging output for the IPC component, specify the
optional detail keyword.
To generate detailed debugging output for the iSCSI component, specify the
optional detail keyword.
A-28
To generate a dump of all inbound packets in hexadecimal format, specify
the optional dump keyword.
policy Generates debugging output for the policy component.
pop3 Generates debugging output for the Post Office Protocol, version 3 (POP3)
component.
psd [detail] Generates debugging output for the PSD component.
To generate detailed debugging output for the PSD component, specify the
optional detail keyword.
qs [detail] Generates debugging output for the quota server component.
To generate detailed debugging output for the quota server component,
including all packets to and from the quota server in both hexadecimal and
ASCII formats, specify the optional detail keyword.
radius
[detail] Generates debugging output for the RADIUS component.
To generate detailed debugging output for the RADIUS component, specify
the optional detail keyword.
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
OL-15491-01
Appendix A CSG2 Command Reference
replicate Generates debugging output for the high availability (HA) component,
service [detail] Generates debugging output for the subscriber services component.
service [ha] Generates debugging output for the subscriber services component.
session event Generates debugging output for the session event component.
session state [detail] Generates debugging output for the session state component.
rtsp [detail] Generates debugging output for the Real Time Streaming Protocol (RTSP)
debug ip csg
including stateful messages as well as stateless transitions and the
dump/bulk synchronization processes.
You can also use the following commands to debug the redundancy facility
(RF), the RF for Interdevice redundancy (RF Interdev), and the Hot Standby
Router Protocol (HSRP):
• debug redundancy progression
• debug redundancy interdev
• debug standby
To generate detailed debugging output for the subscriber services
component, specify the optional detail keyword.
Note If you specify the detail keyword, the CSG2 might generate
debugging output for every packet mapped to the service.
To generate debugging output for high availability (HA) replication for the
subscriber services component, specify the optional ha keyword.
To generate detailed debugging output for the session state component,
specify the optional detail keyword.
component.
To generate detailed debugging output for the RTSP component, specify the
optional detail keyword.
sip Generates debugging output for the Session Initiation Protocol (SIP)
component.
smtp Generates debugging output for the Simple Mail Transfer Protocol (SMTP)
component.
stats Generates debugging output for the statistics component.
tlv Generates debugging output for the Tag-Length-Values (TLVs) component.
udb [xml] Generates debugging output for the User Database (UDB) component.
To generate debugging output for only the XML component, specify the
optional xml keyword.
users Generates debugging output for the subscriber component.
wap [detail] Generates debugging output for the wireless application protocol (WAP)
component.
To generate detailed debugging output for the WAP component, specify the
optional detail keyword.
Defaults The CSG2 generates no debugging output.
OL-15491-01
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
A-29
debug ip csg
Command Modes Privileged EXEC
Appendix A CSG2 Command Reference
Command History
Release Modification
12.4(11)MD This command was migrated from CSG1.
Changes from CSG1:
• The acl number, configuration sync, detail, dump, error, frag, global, ha,
http, interm, ipc, mail, other, packet, priority, qs, replicate, service, session
event, session state, stats, and vrf vrf-name, keywords and arguments were
added.
• The any, bma, ipc, psd, and quota-server keywords were added for the gtp
keyword.
• The agent, api, cpu, module number, quota, prepaid, record storage slot, and
timer keywords and arguments were removed.
12.4(15)MD The crashinfo, ftp, iscsi, mail, and sip keywords were added.
Usage Guidelines To see most but not all debugging output, use the all option to turn on all debugging flags, and then use
the no form of this command to exclude debugging output for any options that are not of interest to you.
Restrict the output of other CSG2 debugging commands to subscribers specified in the ACL.
Once the debug flags are set, they are automatically sent to the CSG2 cards when a configuration is
downloaded. Similarly, changes in the debug settings are sent to the CSG2 cards that are being debugged.
Generating debugging output for ACL (that is, configuring the acl keyword) disables all of the following
types of debugging:
• Configuration
• Error
• GTP
• IPC
• PSD
• RADIUS
• Replicate
• Statistics
• TLV
• UDB
You can use the show debug command to display the debug flag settings.
Note You must re-enter the debug command after every reload because it is not saved in the startup
configuration.
Examples The following example shows how to turn on debugging for rtsp and udb:
A-30
Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide
OL-15491-01
Loading...