221 | Cisco Systems OL-15491-01 instruction

Appendix A CSG2 Command Reference

records intermediate

Command History

Usage Guidelines

Release Modification

12.4(11)MD This command was migrated from CSG1.

Changes from CSG1:

•The configuration mode for this command changed from CSG accounting configuration to CSG2 content configuration.

•The time keyword changed to seconds.

•The range for the seconds argument changed from 5 to 65535, to 5 to 86400.

The CSG2 supports intermediate billing for FTP, HTTP, IP, SIP, TCP, and UDP.

The CSG2 does not support intermediate billing for WAP or e-mail protocols (such as IMAP, POP3, and SMTP).

The CSG2 does not support intermediate billing for RTSP control sessions unless the video/audio traffic is also transported over the control session.

Examples		The following example shows how to enable intermediate billing records for the CSG2 content
		MOVIES. In this example, intermediate records are generated after 100,000 IP bytes of data are sent and
		received, or after 3600 seconds (1 hour) elapse, whichever occurs first:
		ip csg content MOVIES
		records intermediate bytes 100000 seconds 3600

Related Commands		Command	Description

		ip csg content	Configures content for CSG2 services, and enters CSG2 content
			configuration mode.

		Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide

	OL-15491-01			A-221
	OL-15491-01			A-221

Image 221

Cisco Systems OL-15491-01 appendix Command History Usage Guidelines Release Modification, 221

Contents

CSG2 Command Reference Appendix a CSG2 Command Reference Appendix a CSG2 Command Reference Appendix a CSG2 Command Reference Appendix a CSG2 Command Reference Enters CSG2 policy configuration mode Command DescriptionAccounting Release Modification Activation automatic user-profile No activation Syntax Description Defaults Command ModesActivation Configuration mode Related Commands DescriptionIp csg service Aoc append url Aoc enableAoc append url No aoc append url Aoc confirm Token Aoc confirmAoc confirm token No aoc confirm Aoc append url Ip csg service Movies aoc enable Aoc confirm ?CSGAOCOK Aoc enable No aoc enable Aoc enableAoc enable Usage Guidelines Examples Command Description Basis Defaults Command Modes Ip csg service Offnet basis second Ip csg service Movies Basis fixed Meter increment Meter exclude svc-idleMeter include imap Block Ip csg contentBlock No block Parse length Class Command History Release ModificationUsage Guidelines Examples Related Commands Syntax Description Clear ip csgUser All 12.415MD The ftp keyword was added 12.411MD This command was introducedIP address Show ip csg Clear ip iscsi statistics Command Modes Command HistoryClear ip iscsi statistics ReleaseModification Clear record-storage-module stats Clear record-storage-module statsFollowing example clears RSM-related statistics Clear record-storage-module stats Client-group CSG2 content Mode Ip csg content MoviesNext-hop Defines a next-hop IP address Default weight-valueis 1 quadran Content CSG2 serviceCSG2 service configuration You must configure a policy before configuring this command CSG2 policy configuration mode Debug ip csg Http detail Gtp quota-serverImap Interm Service ha Service detailSession event Session state detail Replicate Statistics Entries user idle duration pod no entries user idle Entries user idlePod Billing to entries user idle Service Ip csg radius pod timeoutIp csg billing Ip csg entries user idle Tcp FlagsWap Mask Appendix a CSG2 Command Reference Flags Refunds quota for Prepaid Error Reimbursement Enters CSG2 refund configuration modeIp csg refund Retcode Default idle duration is 300 seconds 5 minutes Idle CSG2 contentCSG2 content configuration Idle duration no idle duration Service with no subscriber sessions Idle CSG2 serviceSets the pending connection timeout Pending Ip csg service Movies Idle Idle CSG2 service Idle content connection Idle CSG2 content Inservice No inservice Inservice CSG2 contentDefault value is no inservice Detects an error, the command fails Any Ip CSG2 contentNo ip any ip-address Ip csg content Moviescomedy Ip 172.18.45.0/24 tcp Command Modes Command History Usage Guidelines Examples Ip iSCSI Ip csg iscsi drain delayIp csg iscsi drain packet Ip csg iscsi profile Port iSCSI Ip iscsi target-profileName iSCSI Ip csg billing billing-plan-name Ip csg billingNo ip csg billing billing-plan-name Entries user idle Ip csg bma Syntax Description Defaults Command Modes Command History Ip csg bma keepalive Ip csg bma activateIp csg bma local-port Ip csg bma messages Sticky seconds Ip csg bma activate Ip csg bma activate 2 sticky Related Commands Description Ip csg bma Ip csg bma keepaliveIp csg ipc keepalive Ip csg psd keepalive Csg bma command Quota-server local-port command, respectivelyIp csg bma local-port Ip csg bma local-port port-number No ip csg bma local-port Ip csg psd local-port CSG2 accounting service A1Cisco Persistent Storage Device PSD Ip csg bma local-port Ip csg bma messages 12.411MD This command was migrated from CSG1Ip csg bma messages number no ip csg bma messages CSG2 buffers up to 10000 GTP’ messages Ip csg psd drain packet Ip csg psd drain delayIp csg psd margin Ip csg quota-server messages No ip csg bma retransmit Ip csg bma retransmitIp csg bma retransmit number-of-seconds Number-of-retries Ip csg bma retriesPacket Ip csg quota-server retries Ip csg ipc retriesIp csg psd retries Min auto Ip csg bma window Ip csg case-sensitive No ip csg case-sensitive Ip csg case-sensitiveMatch header Match method Ip csg content content-name No ip csg content content-name Ip csg content Subscriber-iphttp-headerforwarded-for Subscriber-iphttp-headerforwarded-for Vlan CSG2 content VrfBlock No ip csg database Ip csg databaseServer Ip csg database 10.1.2.3 11111 Default maximum number of entries is Default idle duration is 5 secondsIp csg entries fragment Ip csg database Ip csg entries session user max Ip csg entries user profile Server that answers user ID queries Ip csg entries session user max Command Description Ip csg entries user idle Packet of Disconnect message when an entry idles out Database, or how long the CSG2 is to retain the entries Ip csg entries fragmentDefines the maximum number of entries in the CSG2 fragment Ip csg entries user max 12.411MD This command was introducedIp csg entries user max entries No ip csg entries user max Ip csg entries user max Related Commands Description Ip csg entries user profile Ip csg entries user profile radius pass CommandDescriptionIp csg database Server that answers user ID queries Tolerance number-of-seconds Ip csg ipc crashdumpNever Ip csg ipc keepalive Default value is 8 secondsIp csg ipc keepalive number-of-seconds No ip csg ipc keepalive Ip csg ipc retransmit Default value is 4 secondIp csg ipc retransmit number-of-seconds No ip csg ipc retransmit No ip csg ipc retries Ip csg ipc retriesIp csg ipc retries number-of-retries Ip csg iscsi drain delay Ip csg iscsi drain packet ISCSI configuration mode Target to be used as backup storage for the CSG2 Ip csg iscsi profile target-profile-name Ip csg iscsi profileNo ip csg iscsi profile No iSCSI target is specified Match header Match method Match url Ip csg mapIp csg map map-name No ip csg map map-name Match patterns as case-sensitive Ip csg case-sensitiveMap Policy Command Ip csg mode single-tpIp csg mode single-tp No ip csg mode single-tp Accounting Map Ip csg policyIp csg policy policy-name No ip csg policy policy-name Accounting Enters CSG2 map configuration modeIp csg map Ip csg policy Moviescomedy Ip csg psd Buffer for the Cisco Persistent Storage Device PSD Tunneling protocol prime GTP’ messages, beyond the sizeIp csg psd retransmit Ip csg psd window No ip csg psd drain delay Ip csg psd drain delayIp csg psd drain delay number-of-seconds Ip csg psd drain packet Cisco Persistent Storage Device PSD when the Billing Ip csg psd keepalive number-of-seconds Ip csg psd keepaliveNo ip csg psd keepalive Defines the Interprocessor Communication IPC keepalive time Ip csg psd local-port Csg psd commandIp csg psd local-port port-number No ip csg psd local-port Local-port Related Commands Description Ip csg psd margin Configures a Cisco Persistent Storage Device PSDIp csg psd margin number no ip csg psd margin Can buffer for all Billing Mediation Agents BMAs Ip csg psd retransmit number-of-seconds Ip csg psd retransmitNo ip csg psd retransmit Defines the Interprocessor Communication IPC retransmit Ip csg psd retries Following example shows how to allow two PSD retriesDiscarding it the initial attempt plus four retries Ip csg psd retries Defines the maximum number of Billing Mediation Agent BMA Defines the Billing Mediation Agent BMA transmit window size Ip csg psd window Ip csg quota-server Syntax Description Defaults Ip csg quota-server window Ip csg quota-server reassignIp csg quota-server retransmit Ip csg quota-server activate Default value is Global configuration100 Ip csg quota-server activate 101 Ip csg quota-server keepaliveFor subscribers Quota-server local-port Ip csg quota-server local-port1024 to 102 Billing Mediation Agent BMA Following example configures quota server local portFor subscribers 103 Ip csg quota-server messages Ip csg quota-server messages104 105 Ip csg quota-server reassign 106 Ip csg quota-server retransmit Ip csg quota-server retries Is 1 to 65535. The default value is107 Ip csg quota-server retries 108 Server transmit window automatically. The CSG2 keeps track Ip csg quota-server windowAs the minimum window 109 110 Size for the CSG2 111 Ip csg radius ack error parseNo ip csg radius ack error parse 112 113 Ip csg radius ack error userNo ip csg radius ack error user Ip csg radius ack error parse Related Commands Command DescriptionAccounting Interim Request when it encounters a Radius Parse error condition Ip csg radius correlation Ip csg radius correlationNo ip csg radius correlation Csgusersessioncorrelator=string 116 Key Ip csg radius endpointSpecifies a Radius key 117 118 Endpoint Nas Ip csg radius monitorIp csg radius userid 119 Command History Usage Guidelines Release Modification Radius handoff is disabledIp csg radius handoff Ip csg radius handoff duration No ip csg radius handoff 121 Ip csg radius start restartSession-id Optional Specifies a Radius key Ip csg radius monitor Network Access Server NAS 12.415MD This command was introducedIp csg radius monitor nas 123 Ip csg radius monitor nas 1.2.3.4 vrf Nastable Ip csg radius monitor nas124 Ip csg radius on-off purge Default rate is 1000 User Table entry deletions per secondSpecified rate 125 Vsa Ip csg radius pod attribute3gpp 126 Key to use in calculating the Authenticator Following example shows how to specify Radius attributes 44Between retransmissions 127 Example, write memory Ip csg radius pod nasPossible values are 0 128 129 NasMessage and sent to the NAS in the PoD Default timeout is 5 seconds Ip csg radius pod timeoutDefault number of retransmits is 3 retransmits Command History Examples Release Modification 131 Ip csg radius proxy 132 Csg-source-address is set to csg-address Arguments were added Configuration mode for this command changed from module CSGTable table-namekeyword and argument were removed Csg-source-address 134 135 Ip csg radius reauthorization attribute Ip csg radius reauthorization attribute vsa 7777 Ip csg radius reauthorization attributeIp csg radius reauthorization attribute 26 7778 136 Ip csg radius start restart session-id This commandRadius start restart session-id 26 keyword was removed Ip csg radius start restart session-id 138 Ip csg radius stop purge Ip csg radius stop purge139 140 User-Name Ip csg radius useridCalling-Station-Id 141 142 Variable Ip csg records formatCombined http Combined wap 144 Ip csg redirect 145 Following example shows how to configure CSG2 redirects For Prepaid Error Reimbursement For CSG2 Prepaid Error ReimbursementIp csg refund Flags Ip csg replicate Replication is not enabled 148 Content servers on the standby system Ip csg report radius attribute Ip csg report http headerIp csg report smtp rfc2822 149 150 151 Ip csg report radius attributeNo Radius attributes are copied into CDRs 152 Ip csg report http headerIp csg report usage Ip csg report smtp rfc2822 No ip csg report smtp rfc2822 Ip csg report smtp rfc2822Ip csg report wap actual-pdu 153 Ip csg report usage Defaults Command Modes Command History Usage GuidelinesBytes ip Seconds 155 Start message into call detail records CDRs 156 Ip csg report wap actual-pdu Ip csg service service-name No ip csg service service-name Ip csg serviceActivation Aoc append url Aoc confirm Aoc enable 157 Activation ServiceURL-rewriting Basis 159 Snmp-server enable traps csg Ip csg snmp timerBma Psd Ip csg subscriber Command Modes Interface configurationIp csg subscriber No ip csg subscriber Interface is not a CSG2 subscriber interface Ip csg transport-type assign Specifies a service class value162 Ip csg transport-type assign 1.2.3.4 Target-profile-name Name of the iSCSI profile Ip iscsi target-profileIp iSCSI 163 164 Map CSG2 policy configurationMap map-name no map map-name Header-map Url-map 166 167 CSG2 map configurationMatch header Convention Description Match header host1 *.2.*.44Zero or more characters Zero or one character 169 \character 170 Case-sensitive Match method method-name No match method method-name Match methodMethod-name Method to be matched. Valid methods are Match method get 172 173 As case-sensitive Match url pattern No match url pattern Syntax Description Command Modes Command HistoryMatch url http//url-string HTTP//url-string 175 176 Ip csg map Movies Ip csg map Images Match url *.gifjpg 177 178 Meter exclude control sipMeter exclude control sip no meter exclude control sip Are billed for by the CSG2 when doing prepaid debits Specifies which Internet Message Access Protocol Imap bytesBeginning of a service when the service is configured for Service Duration Billing Meter exclude control sip Meter exclude mms wapMeter exclude network-init Sip 181 Ip csg service SERVICE-A Meter exclude network-init sip SERVICE-A serviceMeter exclude network-init sip 182 183 Meter exclude pause rtsp No meter exclude pause rtsp Meter exclude pause rtspSIP session from the CSG2 usage calculation Meter exclude network-init sip 185 Meter exclude svc-idle Offnet serviceMeter exclude svc-idle No meter exclude svc-idle Only basis second is meaningful with meter exclude svc-idle 187 Body header Meter include imapBody only Body other RFC822 Ip csg service S1Prepaid debits 189 190 Meter increment value No meter increment value Meter incrementSpecify meter increment 191 192 Ip csg service Offnet Meter increment Ip csg service Offnet Meter initial Default quota is 0 quadrans CSG2 service configurationMeter initial Meter initial value no meter initial value 194 Meter minimum Default number is 0 quadransMeter minimum value no meter minimum value Charge is 110 quadrans 196 Ip csg service Offnet Meter minimum Mode Default mode is prepaid CSG2 billing configurationSpecifies variable or fixed call detail record CDR format 197 198 Mode tcp Name target-name No name target-name Name iSCSITarget-name Name of the iSCSI target Target named eftcompany.com 200 Reverse Next-hopSubscriber media Next-hop or next-hop reverse 202 Id id OwnerName name 203 204 Parse lengthParse length number no parse length 205 Parse protocol 206 Configures content for CSG2 services, and entersCSG2 content configuration mode Each time the service runs low on quota Configured, but none are activePassthrough Passthrough quota-grantno passthrough Default pending connection timeout is 30 seconds Pending timeout no pendingPending Displays information about the CSG2 Policy-name Name of a configured CSG2 billing policy Policy CSG2 contentThis policy, do not configure the accounting command 209 210 Services, and enters CSG2 policy configuration modePriority Policy Country priority Port iSCSI No default behavior or valuesPort port-number no port port-number 211 212 213 Reauthorization threshold 214 Ip csg service A1 Reauthorization threshold Default initial reauthorization timeout is 4 seconds Reauthorization timeoutDefault maximum reauthorization timeout is 60 seconds 215 216 Maximum reauthorization timeout of 20 seconds Records delay seconds no records delay Records delayDefault value is 0 no records delay Transaction closes, but before the connection closes Records granularity ServiceBytes bytes Seconds seconds 219 Bytes bytes Records intermediateSeconds seconds 220 221 Refund policy-name No refund policy-name RefundPolicy-name Name of the refund policy Refund Connection redundancy is not enabled Replicate delay seconds no replicate delayIf you do not specify a delay, there is no delay Replicate 224 Enables state replication between redundant CSG2 systemsIp csg replicate Rc-start RetcodeRc-end 225 226 Masks and values for CSG2 Prepaid Error Reimbursement Sami rate all Default rate is 1.9 GbpsSami rate bits-per-second all No sami rate bits-per-secondall Service service-name No service service-name ServiceService-name Name of a configured CSG2 billing service None CSG2 billing configuration 229 Show ip csg Ip-address ip-mask UserShow ipc sctp Id user-name Show module csg content Command Default Command Modes Command HistoryShow ip csg accounting Show module csg stats 232 Following example shows how to display the CSG2 statisticsDetail Router# show ip csg stats 233 Datagram packets = Datagram frags = 234 235 236 IPC 237 CSG Other Stats Total sessions = 40344, alloc fail = 238 239 Router# show ip csg sessions 240Router# show ip csg quota-server 241 State Description 242 243 Command Default Command Modes Command History ExamplesShow ip iscsi Router# show ip iscsi stats detail iSCSI Stats 244Router# show ip iscsi stats iSCSI Stats Target name= iqn.2002-10.edu.unh.iol.iscsi.draft20-target1 245 246 Show record-storage-moduleRouter# show record-storage-module stats Router# show record-storage-module target-info all detail 247 Records Snmp-server enable traps csgState 248 Ip csg snmp timer Following example enables CSG2 trapsCSG2 records, and enters CSG2 Snmp timer configuration mode Snmp-server enable traps csg Obscure Subscriber-ip http-header forwarded-forHttp-header x-forwarded-for 250 251 252 Verify confirmVerify confirm token No verify confirm token 253 Verify enable Verify enableNo verify enable 254 Vlan vlan-number Vlan CSG2 contentNo vlan Vlan-number Dot1q encapsulation Vlan number Vrf Contentvrf Vrf-name VRF within which the content should match packetsVrf No vrf