A P P E N D I X A CSG2 Command Reference This appendix documents the commands necessary to configure and monitor the CSG2.
Appendix A • flags, page A-33 • idle (CSG2 content), page A-36 • idle (CSG2 service), page A-38 • inservice (CSG2 content), page A-40 • ip (CSG2 content), page A-41 • ip (iSCSI), page A-43 • ip csg billing, page A-45 • ip csg bma, page A-46 • ip csg bma activate, page A-48 • ip csg bma keepalive, page A-50 • ip csg bma local-port, page A-51 • ip csg bma messages, page A-53 • ip csg bma retransmit, page A-55 • ip csg bma retries, page A-56 • ip csg bma window, page A-58 • ip c
Appendix A CSG2 Command Reference • ip csg psd margin, page A-93 • ip csg psd retransmit, page A-94 • ip csg psd retries, page A-95 • ip csg psd window, page A-97 • ip csg quota-server, page A-98 • ip csg quota-server activate, page A-100 • ip csg quota-server keepalive, page A-101 • ip csg quota-server local-port, page A-102 • ip csg quota-server messages, page A-104 • ip csg quota-server reassign, page A-105 • ip csg quota-server retransmit, page A-106 • ip csg quota-server retrie
Appendix A • ip csg snmp timer, page A-160 • ip csg subscriber, page A-161 • ip csg transport-type assign, page A-162 • ip iscsi target-profile, page A-163 • map, page A-165 • match header, page A-167 • match method, page A-171 • match url, page A-174 • meter exclude control sip, page A-178 • meter exclude mms wap, page A-180 • meter exclude network-init sip, page A-182 • meter exclude pause rtsp, page A-184 • meter exclude svc-idle, page A-186 • meter include imap, page A-188 •
Appendix A CSG2 Command Reference • show ip csg, page A-229 • show ip iscsi, page A-243 • show record-storage-module, page A-246 • snmp-server enable traps csg, page A-248 • subscriber-ip http-header forwarded-for, page A-250 • verify confirm, page A-252 • verify enable, page A-254 • vlan (CSG2 content), page A-255 • vrf, page A-256 Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference accounting accounting 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 customer-string string Defaults The default is no accounting. Command Modes CSG2 policy configuration Command History Release Modification 12.
Appendix A CSG2 Command Reference activation 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 Syntax Description automatic (Optional) Activates the Connection Duration service, unless the billing profile indicates that no service is to be activated.
Appendix A CSG2 Command Reference activation Related Commands Command Description ip csg service Configures a CSG2 content billing service, and enters CSG2 service configuration mode. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference aoc append url 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.
Appendix A CSG2 Command Reference aoc confirm aoc confirm 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 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: $-_.+!*'(),?/:@&=;~%.
Appendix A CSG2 Command Reference aoc confirm 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.
Appendix A CSG2 Command Reference 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 Command History Release Modification 12.
Appendix A CSG2 Command Reference aoc enable 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 mode. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference basis basis 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.
Appendix A CSG2 Command Reference basis Usage Guidelines 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.
Appendix A CSG2 Command Reference basis 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.
Appendix A CSG2 Command Reference block 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 Command History Release Modification 12.
Appendix A CSG2 Command Reference class class 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 value Defaults None Command Modes CSG2 service configuration Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Specifies a value in the range 1 to 255. Changes from CSG1: None.
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.
Appendix A CSG2 Command Reference clear ip csg 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.
Appendix A CSG2 Command Reference clear ip iscsi statistics 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 Command History Release Modification 12.4(15)MD This command was introduced.
Appendix A CSG2 Command Reference 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 Command History Release Modification 12.4(15)MD This command was introduced.
Appendix A CSG2 Command Reference client-group (CSG2 content) 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} Syntax Description std-access-list-number Standard IP access list number.
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.
Appendix A CSG2 Command Reference content (CSG2 service) 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.
Appendix A CSG2 Command Reference content (CSG2 service) 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. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference debug ip csg 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.
Appendix A CSG2 Command Reference debug ip csg gtp quota-server [priority] 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. http [detail] Generates debugging output for the HTTP component. To generate detailed debugging output for the HTTP component, specify the optional detail keyword.
Appendix A CSG2 Command Reference debug ip csg service [detail] Generates debugging output for the subscriber services component. To generate detailed debugging output for the subscriber services component, specify the optional detail keyword. Note service [ha] If you specify the detail keyword, the CSG2 might generate debugging output for every packet mapped to the service. Generates debugging output for the subscriber services component.
Appendix A CSG2 Command Reference debug ip csg Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Changes from CSG1: 12.4(15)MD Usage Guidelines • 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.
Appendix A CSG2 Command Reference entries user idle entries user idle To set the time after which entries for idle subscribers are deleted from the CSG2 User Table, use the entries user idle command in CSG2 billing configuration mode. To use the default settings, use the no form of this command. entries user idle duration [pod] no entries user idle Syntax Description idle duration Number of seconds after which entries for idle subscribers are deleted from the CSG2 User Table.
Appendix A CSG2 Command Reference entries user idle • Examples If Connection Duration Billing is enabled, you can use either the billing plan entry idle timer or the global entry idle timer to release a subscriber connection. The following example shows how to specify an entry idle time of 1 hour for CSG2 billing plan REGULAR: ip csg billing REGULAR entries user idle 3600 Related Commands Command Description ip csg billing Defines a CSG2 billing plan, and enters CSG2 billing configuration mode.
Appendix A CSG2 Command Reference flags flags To specify IP, TCP, or wireless application protocol (WAP) flag bit masks and values for CSG2 Prepaid Error Reimbursement, use the flags command in CSG2 refund configuration mode. To remove the flags, use the no form of this command. flags {ip mask | tcp mask | wap} value no flags {ip mask | tcp mask | wap} value Syntax Description ip All IP protocol connections other than TCP or WAP. tcp TCP connections wap WAP connections.
Appendix A CSG2 Command Reference flags • 0x80: Connection terminated because of lack of authorization failure. – 0: The connection was not terminated as a result of an authorization failure. – 1: The connection was terminated as a result of an authorization failure. • 0x7E: Reserved. The tcp flag values are: • 0x01: Connection initiator. – 0: The connection was initiated by the subscriber. The source address is associated with the user ID. – 1: The connection was initiated by the network.
Appendix A CSG2 Command Reference flags Examples The following example shows how to set flags for IP, TCP, and WAP: ip csg flags flags flags Related Commands refund COMPANY-REFUND tcp 43 00 ip 80 80 wap 04 Command Description ip csg refund Specifies the CSG2 refund policy to apply to the various services, and enters CSG2 refund configuration mode. retcode Specifies the range of application return codes for which the CSG2 refunds quota for Prepaid Error Reimbursement.
Appendix A CSG2 Command Reference idle (CSG2 content) idle (CSG2 content) To specify the minimum amount of time that the CSG2 maintains an idle content connection, use the idle command in CSG2 content configuration mode. To restore the default idle duration value, use the no form of this command. idle duration no idle duration Syntax Description duration Content idle timer duration in seconds.
Appendix A CSG2 Command Reference idle (CSG2 content) to quickly recognize that a session has ended and to generate billing records accordingly. Other service-level features of the CSG2 that count sessions (such as passthrough mode and service-level CDRs) are similarly affected by the content idle timer setting. For TCP, the CSG2 does not send a reset (RST) until a packet is received.
Appendix A CSG2 Command Reference idle (CSG2 service) idle (CSG2 service) To specify the minimum amount of time that the CSG2 maintains a service with no subscriber sessions, use the idle command in CSG2 service configuration mode. To restore the default idle duration value, use the no form of this command. idle duration no idle duration Syntax Description duration Service idle timer duration, in seconds. The timer begins when there are no sessions.
Appendix A CSG2 Command Reference idle (CSG2 service) Related Commands Command Description idle (CSG2 content) Specifies the minimum amount of time that the CSG2 maintains an idle content connection. ip csg service Configures a CSG2 content billing service, and enters CSG2 service configuration mode. pending Sets the pending connection timeout. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference inservice (CSG2 content) inservice (CSG2 content) To activate the content service on each CSG2, use the inservice command in CSG2 content configuration mode. To suspend the content service, use the no form of this command. inservice no inservice Syntax Description This command has no arguments or keywords. Defaults The default value is no inservice. Command Modes CSG2 content configuration Command History Release Modification 12.
Appendix A CSG2 Command Reference ip (CSG2 content) ip (CSG2 content) To define the subset of Layer 3 and Layer 4 flows that can be processed by the CSG2 accounting services, use the ip command in CSG2 content configuration mode. To delete the flow definition, use the no form of this command. ip {any | ip-address [netmask]} [any | protocol [port-number [last-port-number]]] no ip {any | ip-address} Syntax Description any All Layer 3 and Layer 4 flows can be processed. This is the default setting.
Appendix A CSG2 Command Reference ip (CSG2 content) Command Modes CSG2 content configuration Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Changes from CSG1: None. Usage Guidelines This command is required to place content in service. UDP ports 9200 and 9201 are well-known Wireless Session Protocol (WSP) and Wireless Transaction Protocol (WTP) wireless application protocol (WAP) ports.
Appendix A CSG2 Command Reference ip (iSCSI) ip (iSCSI) To specify the IP address of an iSCSI target in the target interface profile on the CSG2, use the ip command in iSCSI configuration mode. To remove the IP address configuration, use the no form of the command. ip ip-address no ip ip-address Syntax Description ip-address Command Default No default behavior or values. Command Modes iSCSI configuration Command History Release Modification 12.4(15)MD This command was introduced.
Appendix A CSG2 Command Reference ip (iSCSI) Command Description ip iscsi target-profile Creates an iSCSI profile for an iSCSI target on the CSG2, and enters iSCSI configuration mode. name (iSCSI) Specifies the name of an iSCSI target in the target profile on the CSG2 port (iSCSI) Specifies the number of the port on which to listen for iSCSI traffic in the iSCSI target interface profile on the CSG2. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference ip csg billing ip csg billing To define a CSG2 billing plan, and to enter CSG2 billing configuration mode, use the ip csg billing command in global configuration mode. To delete the billing plan, use the no form of this command. ip csg billing billing-plan-name no ip csg billing billing-plan-name Syntax Description billing-plan-name Name of the billing plan, which is a set of services. When the CSG2 encounters a new subscriber, the CSG2 retrieves its billing plan.
Appendix A CSG2 Command Reference ip csg bma ip csg bma To configure the Billing Mediation Agents (BMAs) to which the CSG2 is to send billing records, use the ip csg bma command in CSG2 global configuration mode. To remove a BMA from the list of agents, use the no form of this command.
Appendix A CSG2 Command Reference ip csg bma Usage Guidelines You must specify the BMA local port using the ip csg bma local-port command before you enter the ip csg bma command. Accounting records are sent only to the agents identified in the ip csg bma command. This provides a measure of security to ensure that records are not sent to unauthorized systems.
Appendix A CSG2 Command Reference ip csg bma activate ip csg bma activate To enable support for multiple active Billing Mediation Agents (BMAs), use the ip csg bma activate command in CSG2 global configuration mode. To disable support for multiple active BMAs, use the no form of this command. ip csg bma activate [number [sticky seconds]] no ip csg bma activate [number [sticky seconds]] Syntax Description number (Optional) Number of BMAs that the CSG2 tries to activate at the same time.
Appendix A CSG2 Command Reference ip csg bma activate Usage Guidelines Use this command to load-balance CDRs among multiple active BMAs. When the CSG2 uses multiple active BMAs, it sends all CDRs for a given user to a particular BMA. The CSG2 stores that BMA assignment in the CSG2 User Table entry for that user. For example, if a configuration has four active BMAs, and one of those BMAs fails, the CSG2 looks for a suitable standby BMA.
Appendix A CSG2 Command Reference ip csg bma keepalive ip csg bma keepalive To define the Billing Mediation Agent (BMA) keepalive time interval for the CSG2, use the ip csg bma keepalive command in global configuration mode. To reset the BMA keepalive timer to the default value, use the no form of this command. ip csg bma keepalive number-of-seconds no ip csg bma keepalive Syntax Description number-of-seconds Defaults The default value is 60 seconds.
Appendix A CSG2 Command Reference ip csg bma local-port ip csg bma local-port To define the port on which the CSG2 communicates with the Billing Mediation Agent (BMA), use the ip csg bma local-port command in CSG2 global configuration mode. To remove the port, use the no form of this command. ip csg bma local-port port-number no ip csg bma local-port Syntax Description port-number Port number on which the BMA will listen. The range is from 1024 to 65535. 5000 is not a valid port number.
Appendix A CSG2 Command Reference ip csg bma local-port Examples The following example shows how to specify local port 5555 as the port on which the CSG2 listens for the CSG2 accounting service A1: ip csg bma local-port 5555 Related Commands Command Description ip csg bma Defines the Billing Mediation Agents (BMAs) to which the CSG2 is to send billing records ip csg psd local-port Configures the local port on which the CSG2 communicates with the Cisco Persistent Storage Device (PSD).
Appendix A CSG2 Command Reference ip csg bma messages ip csg bma messages To specify the maximum number of general packet radio service (GPRS) tunneling protocol prime (GTP’) messages that the CSG2 can buffer for all Billing Mediation Agents (BMAs), use the ip csg bma messages command in global configuration mode. To restore the default setting, use the no form of this command.
Appendix A CSG2 Command Reference ip csg bma messages By default, the CSG2 limits the rate at which GTP’ messages are read from the PSD to 500 packets/second, and from the SAN to 167 packets/second. However, you can change those default rates. For more information, see the “Configuring the PSD Packet Drain Settings” section on page 7-2 and the “Configuring the iSCSI Packet Drain Settings” section on page 8-4.
Appendix A CSG2 Command Reference ip csg bma retransmit ip csg bma retransmit To define the Billing Mediation Agent (BMA) retransmit time interval for the CSG2, use the ip csg bma retransmit command in global configuration mode. To reset the BMA retransmit timer to the default value, use the no form of this command. ip csg bma retransmit number-of-seconds no ip csg bma retransmit Syntax Description number-of-seconds Defaults The default value is 4 seconds.
Appendix A CSG2 Command Reference ip csg bma retries ip csg bma retries To define the maximum number of Billing Mediation Agent (BMA) retries allowed before the CSG2 determines that the link has failed, use the ip csg bma retries command in global configuration mode. To reset the number of BMA retries to the default value, use the no form of this command.
Appendix A CSG2 Command Reference ip csg bma retries Related Commands Command Description ip csg bma Defines the Billing Mediation Agents (BMAs) to which the CSG2 is to send billing records ip csg ipc retries Defines the maximum number of Interprocessor Communication (IPC) retries allowed before the CSG2 determines that the link has failed. ip csg psd retries Defines the maximum number of Cisco Persistent Storage Device (PSD) retries allowed before the CSG2 determines that the link has failed.
Appendix A CSG2 Command Reference ip csg bma window ip csg bma window To define the Billing Mediation Agent (BMA) transmit window size for the CSG2, use the ip csg bma window command in global configuration mode. To reset the BMA transmit window size to the default value, use the no form of this command. ip csg bma window {max window-size | min window-size | min auto} no ip csg bma window {max | min} Syntax Description max window-size Maximum size, in packets, of the BMA transmit window.
Appendix A CSG2 Command Reference ip csg case-sensitive ip csg case-sensitive To specify whether to treat CSG2 header, method, and URL match patterns as case-sensitive, use the ip csg case-sensitive command in global configuration mode. To disable case-sensitivity for CSG2 match patterns, use the no form of this command. ip csg case-sensitive no ip csg case-sensitive Syntax Description This command has no arguments or keywords. Defaults CSG2 match patterns are case-sensitive.
Appendix A CSG2 Command Reference ip csg content ip csg content To configure content for CSG2 services, and to enter CSG2 content configuration mode, use the ip csg content command in global configuration mode. To delete the content configuration, use the no form of this command. ip csg content content-name no ip csg content content-name Syntax Description content-name Defaults None Command Modes Global configuration Command History Release Modification 12.
Appendix A CSG2 Command Reference ip csg content • subscriber-ip http-header forwarded-for • vlan (CSG2 content) • vrf You cannot change characteristics for a content while it is in service. If the content configuration does not match any service listed under a subscriber’s billing plan, the CSG2 considers the service to be either free or postpaid. The CSG2 does not try to authorize the subscriber with the quota server for the service.
Appendix A CSG2 Command Reference ip csg database ip csg database To identify the database server that answers CSG2 user ID queries, use the ip csg database command in global configuration mode. To disable the database server, use the no form of this command. ip csg database [vrf vrf-name] ip-address port-number local-port no ip csg database Syntax Description vrf vrf-name (Optional) Specifies the Virtual Routing and Forwarding (VRF) table to be used for communication with the database server.
Appendix A CSG2 Command Reference ip csg entries fragment ip csg entries fragment To define the maximum number of entries in the CSG2 fragment database, or to define how long the CSG2 is to retain the entries, use the ip csg entries fragment command in global configuration mode. To restore the default settings, use the no form of this command.
Appendix A CSG2 Command Reference ip csg entries fragment Command Description ip csg entries user profile Specifies the location from which the CSG2 is to obtain the subscriber profile and billing plan when generating entries for the CSG2 User Table. ip csg entries session user max Specifies the maximum number of entries allowed in the CSG2 session table.
Appendix A CSG2 Command Reference ip csg entries session user max ip csg entries session user max To specify the maximum number of entries allowed in the CSG2 session table, use the ip csg entries session user max command in global configuration mode. To restore the default settings, use the no form of this command. ip csg entries session user max entries no ip csg entries session user max Syntax Description entries Defaults The default maximum number of entries is 1000000.
Appendix A CSG2 Command Reference ip csg entries session user max Command Description ip csg psd margin Specifies the maximum number of general packet radio service (GPRS) tunneling protocol prime (GTP’) messages, beyond the size of the Billing Mediation Agent (BMA) message queue, that the CSG2 can buffer for the Cisco Persistent Storage Device (PSD).
Appendix A CSG2 Command Reference ip csg entries user idle ip csg entries user idle To specify how long the CSG2 is to retain entries in the CSG2 User Table, use the ip csg entries user idle command in global configuration mode. To restore the default settings, use the no form of this command. ip csg entries user idle duration [pod] no ip csg entries user idle Syntax Description duration Number of seconds after which the CSG2 is to delete entries for idle subscribers from the CSG2 User Table.
Appendix A CSG2 Command Reference ip csg entries user idle Examples • If Connection Duration Billing is enabled, you can use either the billing plan entry idle timer or the global entry idle timer to release a subscriber connection. • The idle timer does not affect sticky user entries.
Appendix A CSG2 Command Reference ip csg entries user max ip csg entries user max To specify the maximum number of entries allowed in the CSG2 User Table, use the ip csg entries user max command in global configuration mode. To restore the default settings, use the no form of this command. ip csg entries user max entries no ip csg entries user max Syntax Description entries Maximum number of entries allowed in the CSG2 User Table. • For the 2 GB-SAMI option, the range is from 1 to 1250000.
Appendix A CSG2 Command Reference ip csg entries user max Related Commands Command Description ip csg database Server that answers user ID queries. ip csg entries fragment Defines the maximum number of entries in the CSG2 fragment database, or how long the CSG2 is to retain the entries. ip csg entries user idle Specifies how long the CSG2 is to retain entries in the CSG2 User Table.
Appendix A CSG2 Command Reference ip csg entries user profile ip csg entries user profile To specify the location from which the CSG2 is to obtain the subscriber profile and billing plan when generating entries for the CSG2 User Table, use the ip csg entries user profile command in global configuration mode. To restore the default settings, use the no form of this command.
Appendix A CSG2 Command Reference ip csg entries user profile Usage Guidelines Keep the following considerations in mind: • The VSA is removed from the RADIUS Access-Accept message only if remove is specified. Use the remove argument only if the RADIUS client cannot accept the Cisco VSA in the message. • We recommend that you use pass to reduce processing time on the CSG2. • The user ID must be included in the message that contains the billing plan.
Appendix A CSG2 Command Reference ip csg ipc crashdump ip csg ipc crashdump To define the action to be taken by the CSG2 if an Interprocessor Communication (IPC) link fails, use the ip csg ipc crashdump command in global configuration mode. To restore the default setting, use the no form of this command. ip csg ipc crashdump [never | tolerance [number-of-seconds]] no ip csg ipc crashdump Syntax Description never (Optional) Never generate a crash dump in an IPC link fails. This is the default setting.
Appendix A CSG2 Command Reference ip csg ipc keepalive ip csg ipc keepalive To define the Interprocessor Communication (IPC) module keepalive time interval for the CSG2, use the ip csg ipc keepalive command in global configuration mode. To reset the IPC keepalive timer to the default value, use the no form of this command. ip csg ipc keepalive number-of-seconds no ip csg ipc keepalive Syntax Description number-of-seconds Defaults The default value is 8 seconds.
Appendix A CSG2 Command Reference ip csg ipc retransmit ip csg ipc retransmit To define the Interprocessor Communication (IPC) retransmit time interval for the CSG2, use the ip csg ipc retransmit command in global configuration mode. To reset the IPC retransmit timer to the default value, use the no form of this command. ip csg ipc retransmit number-of-seconds no ip csg ipc retransmit Syntax Description number-of-seconds Defaults The default value is 4 second.
Appendix A CSG2 Command Reference ip csg ipc retries ip csg ipc retries To define the maximum number of Interprocessor Communication (IPC) retries allowed before the CSG2 determines that the link has failed, use the ip csg ipc retries command in global configuration mode. To reset the number of IPC retries to the default value, use the no form of this command. ip csg ipc retries number-of-retries no ip csg ipc retries Syntax Description number-of-retries Defaults The default value is 20 retries.
Appendix A CSG2 Command Reference ip csg iscsi drain delay ip csg iscsi drain delay To define the delay interval, in seconds, before draining packets from the Storage Area Network (SAN) connected to the Internet Small Computer Systems Interface (iSCSI) when the Billing Mediation Agent (BMA) becomes active, use the ip csg iscsi drain delay command in global configuration mode. To delete the drain delay interval, use the no form of this command.
Appendix A CSG2 Command Reference ip csg iscsi drain packet ip csg iscsi drain packet To define the number of packets to be drained from the Storage Area Network (SAN) connected to the Internet Small Computer Systems Interface (iSCSI) per drain delay interval when the Billing Mediation Agent (BMA) becomes active, use the ip csg iscsi drain packet command in global configuration mode. To delete the drain packet, use the no form of this command.
Appendix A CSG2 Command Reference ip csg iscsi drain packet Command Description ip csg iscsi profile Specifies the Internet Small Computer Systems Interface (iSCSI) target to be used as backup storage for the CSG2. ip iscsi target-profile Creates an iSCSI profile for an iSCSI target on the CSG2, and enters iSCSI configuration mode. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference ip csg iscsi profile ip csg iscsi profile To specify the Internet Small Computer Systems Interface (iSCSI) target to be used as backup storage for the CSG2, use the ip csg iscsi profile command in global configuration mode. To delete the iSCSI target, use the no form of this command. ip csg iscsi profile target-profile-name no ip csg iscsi profile Syntax Description target-profile-name Defaults No iSCSI target is specified.
Appendix A CSG2 Command Reference ip csg map ip csg map To define the CSG2 billing content filters (header, method, and URL maps), and to enter CSG2 map configuration mode, use the ip csg map command in global configuration mode. To turn off the service, use the no form of this command. ip csg map map-name no ip csg map map-name Syntax Description map-name Defaults None Command Modes Global configuration Command History Release Modification 12.4(11)MD This command was migrated from CSG1.
Appendix A CSG2 Command Reference ip csg map ip csg map URLMAP match url */mobile/index.wml ! ip csg policy MAP-POLICY map HOSTMAP map URLMAP In this example, a flow must match both HOSTMAP and URLMAP in order to match policy MAP-POLICY. Examples The following example shows how to configure a CSG2 URL map named MOVIES: ip csg map MOVIES match url *.movies_(comedy|action|drama).com/*.
Appendix A CSG2 Command Reference ip csg mode single-tp ip csg mode single-tp To enable the CSG2 to use a single traffic processor (TP) instead of multiple TPs, use the ip csg mode single-tp command in global configuration mode. To restore the default setting, use the no form of this command. ip csg mode single-tp no ip csg mode single-tp Syntax Description This command has no arguments or keywords. Defaults The CSG2 operates in multiple-TP mode.
Appendix A CSG2 Command Reference ip csg policy ip csg policy To define a policy for qualifying flows for the CSG2 billing services, and to enter CSG2 policy configuration mode, use the ip csg policy command in global configuration mode. To turn off the service, use the no form of this command. ip csg policy policy-name no ip csg policy policy-name Syntax Description policy-name Defaults None Command Modes Global configuration Command History Release Modification 12.
Appendix A CSG2 Command Reference ip csg policy ip csg policy MAP-POLICY map HOSTMAP map URLMAP In this example, a flow must match both HOSTMAP and URLMAP in order to match policy MAP-POLICY. Examples The following example shows how to configure a CSG2 policy named MOVIES_COMEDY: ip csg policy MOVIES_COMEDY Related Commands Command Description accounting Specifies accounting and an optional customer string for a CSG2 policy.
Appendix A CSG2 Command Reference ip csg psd ip csg psd To configure a Cisco Persistent Storage Device (PSD), use the ip csg psd command in global configuration mode. To remove the PSD, use the no form of this command. ip csg psd [vrf vrf-name] ip-address port-number no ip csg psd [vrf vrf-name] ip-address port-number Syntax Description vrf vrf-name (Optional) Virtual Routing and Forwarding (VRF) table which the CSG2 is to use to communicate with the PSD.
Appendix A CSG2 Command Reference ip csg psd ip csg psd vrf PSDVRF 1.2.3.4 7777 Related Commands Command Description ip csg psd drain delay Defines the delay interval, in seconds, before draining packets from the Cisco Persistent Storage Device (PSD) when the Billing Mediation Agent (BMA) becomes active. ip csg psd drain packet Defines the number of packets to be drained from the Cisco Persistent Storage Device (PSD) per drain delay interval when the Billing Mediation Agent (BMA) becomes active.
Appendix A CSG2 Command Reference ip csg psd drain delay ip csg psd drain delay To define the delay interval, in seconds, before draining packets from the Cisco Persistent Storage Device (PSD) when the Billing Mediation Agent (BMA) becomes active, use the ip csg psd drain delay command in global configuration mode. To delete the drain delay interval, use the no form of this command.
Appendix A CSG2 Command Reference ip csg psd drain packet ip csg psd drain packet To define the number of packets to be drained from the Cisco Persistent Storage Device (PSD) per drain delay interval when the Billing Mediation Agent (BMA) becomes active, use the ip csg psd drain packet command in global configuration mode. To delete the drain packet, use the no form of this command.
Appendix A CSG2 Command Reference ip csg psd keepalive ip csg psd keepalive To define the Cisco Persistent Storage Device (PSD) keepalive time interval for the CSG2, use the ip csg psd keepalive command in global configuration mode. To reset the PSD keepalive timer to the default value, use the no form of this command. ip csg psd keepalive number-of-seconds no ip csg psd keepalive Syntax Description number-of-seconds Defaults The default value is 60 seconds.
Appendix A CSG2 Command Reference ip csg psd local-port ip csg psd local-port To configure the local port on which the CSG2 communicates with the Cisco Persistent Storage Device (PSD), use the ip csg psd local-port command in global configuration mode. To remove a quota server local port configuration, use the no form of this command. ip csg psd local-port port-number no ip csg psd local-port Syntax Description port-number Port number on which the CSG2 is to communicate with the PSD.
Appendix A CSG2 Command Reference ip csg psd local-port Related Commands Command Description ip csg bma local-port Configures the local port on which the CSG2 communicates with the Billing Mediation Agent (BMA). ip csg psd Configures a Cisco Persistent Storage Device (PSD). ip csg quota-server local-port Configures the local port on which the CSG2 communicates with quota servers. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference ip csg psd margin ip csg psd margin To specify the maximum number of general packet radio service (GPRS) tunneling protocol prime (GTP’) messages, beyond the size of the Billing Mediation Agent (BMA) message queue, that the CSG2 can buffer for the Cisco Persistent Storage Device (PSD), use the ip csg psd margin command in global configuration mode. To restore the default setting, use the no form of this command.
Appendix A CSG2 Command Reference ip csg psd retransmit ip csg psd retransmit To define the Cisco Persistent Storage Device (PSD) retransmit time interval for the CSG2, use the ip csg psd retransmit command in global configuration mode. To reset the PSD retransmit timer to the default value, use the no form of this command. ip csg psd retransmit number-of-seconds no ip csg psd retransmit Syntax Description number-of-seconds Defaults The default value is 4 seconds.
Appendix A CSG2 Command Reference ip csg psd retries ip csg psd retries To define the maximum number of Cisco Persistent Storage Device (PSD) retries allowed before the CSG2 determines that the link has failed, use the ip csg psd retries command in global configuration mode. To reset the number of PSD retries to the default value, use the no form of this command.
Appendix A CSG2 Command Reference ip csg psd retries Related Commands Command Description ip csg bma retries Defines the maximum number of Billing Mediation Agent (BMA) retries allowed before the CSG2 determines that the link has failed. ip csg ipc retries Defines the maximum number of Interprocessor Communication (IPC) retries allowed before the CSG2 determines that the link has failed. ip csg psd Configures a Cisco Persistent Storage Device (PSD).
Appendix A CSG2 Command Reference ip csg psd window ip csg psd window To define the Cisco Persistent Storage Device (PSD) transmit window size for the CSG2, use the ip csg psd window command in global configuration mode. To reset the PSD transmit window size to the default value, use the no form of this command. ip csg psd window {max window-size | min window-size | min auto} no ip csg psd window {max | min} Syntax Description max window-size Maximum size, in packets, of the PSD transmit window.
Appendix A CSG2 Command Reference ip csg quota-server ip csg quota-server To configure the CSG2 quota servers that return billing quota values for subscribers, use the ip csg quota-server command in global configuration mode. To remove a quota server configuration, use the no form of this command.
Appendix A CSG2 Command Reference ip csg quota-server Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Changes from CSG1: Usage Guidelines • The name of this command changed from quota server to ip csg quota-server. • The configuration mode for this command changed from CSG user group configuration to global configuration. • The vrf vrf-name keyword and argument were added. • The reassign keyword was removed.
Appendix A CSG2 Command Reference ip csg quota-server activate ip csg quota-server activate To activate one or more quota servers, use the ip csg quota-server activate command in global configuration mode. To deactivate quota servers, use the no form of this command. ip csg quota-server activate number no ip csg quota-server activate Syntax Description number Defaults The default value is 1. Command Modes Global configuration Command History Release Modification 12.
Appendix A CSG2 Command Reference ip csg quota-server keepalive ip csg quota-server keepalive To define the quota server keepalive time interval for the CSG2, use the ip csg quota-server keepalive command in global configuration mode. To reset the quota server keepalive timer to the default value, use the no form of this command. ip csg quota-server keepalive number-of-seconds no ip csg quota-server keepalive Syntax Description number-of-seconds Defaults The default value is 60 seconds.
Appendix A CSG2 Command Reference ip csg quota-server local-port ip csg quota-server local-port To configure the local port on which the CSG2 communicates with quota servers, use the ip csg quota-server local-port command in global configuration mode. To remove a quota server local port configuration, use the no form of this command.
Appendix A CSG2 Command Reference ip csg quota-server local-port Examples The following example configures quota server local port 6666: ip csg quota-server local-port 6666 Related Commands Command Description ip csg bma local-port Configures the local port on which the CSG2 communicates with the Billing Mediation Agent (BMA). ip csg psd local-port Configures the local port on which the CSG2 communicates with the Cisco Persistent Storage Device (PSD).
Appendix A CSG2 Command Reference ip csg quota-server messages ip csg quota-server messages To specify the maximum number of general packet radio service (GPRS) tunneling protocol prime (GTP’) messages that the CSG2 can buffer for all quota servers, use the ip csg quota-server messages command in global configuration mode. To restore the default settings, use the no form of this command.
Appendix A CSG2 Command Reference ip csg quota-server reassign ip csg quota-server reassign To reassign subscribers to a different CSG2 quota server after a failure, use the ip csg quota-server reassign command in global configuration mode. To disable quota server reassignment for subscribers, use the no form of this command. ip csg quota-server reassign no ip csg quota-server reassign Syntax Description This command has no arguments or keywords.
Appendix A CSG2 Command Reference ip csg quota-server retransmit ip csg quota-server retransmit To define the quota server retransmit time interval for the CSG2, use the ip csg quota-server retransmit command in global configuration mode. To reset the quota server retransmit timer to the default value, use the no form of this command. ip csg quota-server retransmit number-of-seconds no ip csg quota-server retransmit Syntax Description number-of-seconds Defaults The default value is 4 seconds.
Appendix A CSG2 Command Reference ip csg quota-server retries ip csg quota-server retries To define the maximum number of quota server retries allowed before the CSG2 determines that the link has failed, use the ip csg quota-server retries command in global configuration mode. To reset the number of quota server retries to the default value, use the no form of this command.
Appendix A CSG2 Command Reference ip csg quota-server retries Related Commands Command Description ip csg bma retries Defines the maximum number of Billing Mediation Agent (BMA) retries allowed before the CSG2 determines that the link has failed. ip csg ipc retries Defines the maximum number of Interprocessor Communication (IPC) retries allowed before the CSG2 determines that the link has failed.
Appendix A CSG2 Command Reference ip csg quota-server window ip csg quota-server window To define the quota server transmit window size for the CSG2, use the ip csg quota-server window command in global configuration mode. To reset the quota server transmit window size to the default value, use the no form of this command.
Appendix A CSG2 Command Reference ip csg quota-server window Command Description ip csg psd window Defines the Cisco Persistent Storage Device (PSD) transmit window size for the CSG2. ip csg quota-server Configures the CSG2 quota servers that return billing quota values for subscribers. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference ip csg radius ack error parse ip csg radius ack error parse To enable the CSG2 to generate a RADIUS response to a RADIUS Accounting Start Request or a RADIUS Accounting Interim Request when it encounters a RADIUS parse error condition, use the ip csg radius ack error parse command in global configuration mode. To prevent RADIUS responses to errors, use the no form of this command.
Appendix A CSG2 Command Reference ip csg radius ack error parse Related Commands Command Description ip csg radius ack error user Enables the CSG2 to generate a RADIUS response to a RADIUS Accounting Start Request or a RADIUS Accounting Interim Request when it encounters a user resource error condition. ip csg radius endpoint Identifies the CSG2 as an endpoint for RADIUS Accounting messages. ip csg radius handoff Configures RADIUS handoff support.
Appendix A CSG2 Command Reference ip csg radius ack error user ip csg radius ack error user To enable the CSG2 to generate a RADIUS response to a RADIUS Accounting Start Request or a RADIUS Accounting Interim Request when it encounters a user resource error condition, use the ip csg radius ack error user command in global configuration mode. To prevent RADIUS responses to errors, use the no form of this command.
Appendix A CSG2 Command Reference ip csg radius ack error user Related Commands Command Description ip csg radius ack error parse Enables the CSG2 to generate a RADIUS response to a RADIUS Accounting Start Request or a RADIUS Accounting Interim Request when it encounters a RADIUS parse error condition. ip csg radius endpoint Identifies the CSG2 as an endpoint for RADIUS Accounting messages. ip csg radius handoff Configures RADIUS handoff support.
Appendix A CSG2 Command Reference ip csg radius correlation ip csg radius correlation To enable RADIUS correlation processing by the CSG2, use the ip csg radius correlation command in global configuration mode. To disable RADIUS correlation processing, use the no form of this command. ip csg radius correlation no ip csg radius correlation Syntax Description This command has no arguments or keywords. Defaults The CSG2 does not perform RADIUS correlation processing.
Appendix A CSG2 Command Reference ip csg radius correlation Related Commands Command Description ip csg radius handoff Configures RADIUS handoff support. ip csg radius start restart session-id Deletes an existing CSG2 User Table entry for a specific subscriber, and creates a new entry for that subscriber. ip csg radius stop purge Specifies the attribute that must be included in the RADIUS Accounting Stop request in order for the CSG2 User Table entry to be deleted.
Appendix A CSG2 Command Reference ip csg radius endpoint ip csg radius endpoint To identify the CSG2 as an endpoint for RADIUS Accounting messages, use the ip csg radius endpoint command in global configuration mode. To remove the endpoint identification, use the no form of this command.
Appendix A CSG2 Command Reference ip csg radius endpoint secret-string 1- to 64-character clear password value for MD5 authentication. All characters are valid; case is significant. The secret-string is always sent in plain text to the CSG2 module when the configuration is downloaded. The secret-string must match the secret that is specified on the RADIUS client (for example, the gateway general packet radio service [GPRS] support node [GGSN]).
Appendix A CSG2 Command Reference ip csg radius endpoint You can also configure an optional RADIUS key. Examples • If you configure a RADIUS key, the CSG2 parses and acts on a message only if the RADIUS Authenticator is correct. • If you do not configure a RADIUS key, the CSG2 always parses and forwards every message. The following example shows how to identify the CSG2 as a RADIUS endpoint: ip csg radius endpoint vrf RADIUSVRF 1.2.3.
Appendix A CSG2 Command Reference ip csg radius handoff ip csg radius handoff To configure the CSG2 RADIUS handoff timer, use the ip csg radius handoff command in global configuration mode. To turn off the timer, use the no form of this command. ip csg radius handoff duration no ip csg radius handoff Syntax Description duration Handoff timer duration, in seconds. The handoff timer is started when a RADIUS Accounting Stop is received.
Appendix A CSG2 Command Reference ip csg radius handoff Related Commands Command Description ip csg radius ack error parse Enables the CSG2 to generate a RADIUS response to a RADIUS Accounting Start Request or a RADIUS Accounting Interim Request when it encounters a RADIUS parse error condition. ip csg radius ack error user Enables the CSG2 to generate a RADIUS response to a RADIUS Accounting Start Request or a RADIUS Accounting Interim Request when it encounters a user resource error condition.
Appendix A CSG2 Command Reference ip csg radius monitor ip csg radius monitor To specify that the CSG2 is to monitor the RADIUS flows to the specified server, use the ip csg radius monitor command in global configuration mode. To stop monitoring the RADIUS flows, use the no form of this command.
Appendix A CSG2 Command Reference ip csg radius monitor Command History Usage Guidelines Examples Release Modification 12.4(15)MD This command was introduced. You can configure an optional RADIUS key. • If you configure a RADIUS key, the CSG2 parses and acts on a message only if the RADIUS Authenticator is correct. • If you do not configure a RADIUS key, the CSG2 always parses and forwards every message.
Appendix A CSG2 Command Reference ip csg radius monitor nas ip csg radius monitor nas To specify that the CSG2 is to monitor the RADIUS flows to the specified Network Access Server (NAS), use the ip csg radius monitor nas command in global configuration mode. To stop monitoring the RADIUS flows, use the no form of this command.
Appendix A CSG2 Command Reference ip csg radius on-off purge ip csg radius on-off purge To specify the rate at which the CSG2 is to delete CSG2 User Table entries in response to a RADIUS Accounting On or RADIUS Accounting Off message, or in response to the clear ip csg user all command, use the ip csg radius on-off purge command in global configuration mode. To restore the default setting, use the no form of this command.
Appendix A CSG2 Command Reference ip csg radius pod attribute ip csg radius pod attribute To specify the RADIUS attributes and vendor-specific attribute (VSA) subattributes to be copied from the RADIUS Start message and sent to the Network Access Server (NAS) in the Packet of Disconnect (PoD) message, use the ip csg radius pod attribute command in global configuration mode. To disable this feature, use the no form of this command.
Appendix A CSG2 Command Reference ip csg radius pod attribute The CSG2 saves only those attributes or subattributes which meet both of the following criteria: • They are present in the new RADIUS Accounting Start or RADIUS Interim Accounting Request. • They are configured for reporting at the time the new request arrives at the CSG2.
Appendix A CSG2 Command Reference ip csg radius pod nas ip csg radius pod nas To specify the Network Access Server (NAS) port to which the CSG2 is to send the Packet of Disconnect (PoD) message, and to specify the key to use in calculating the Authenticator, use the ip csg radius pod nas command in global configuration mode. To restore the default settings, use the no form of this command.
Appendix A CSG2 Command Reference ip csg radius pod nas Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Changes from CSG1: Usage Guidelines • The name of this command changed from radius pod nas to ip csg radius pod nas. • The configuration mode for this command changed from CSG user group configuration to global configuration. • The vrf vrf-name keyword and argument were added.
Appendix A CSG2 Command Reference ip csg radius pod timeout ip csg radius pod timeout To specify the number of times to retry the RADIUS Packet of Disconnect (PoD) message if it is not acknowledged by means of an ACK message, and the interval between retransmissions, use the ip csg radius pod timeout command in global configuration mode. To restore the default timeout, use the no form of this command.
Appendix A CSG2 Command Reference ip csg radius proxy ip csg radius proxy To specify that the CSG2 is to be a proxy for RADIUS messages, use the ip csg radius proxy command in global configuration mode. To stop the CSG2 from proxying for RADIUS messages, use the no form of this command.
Appendix A CSG2 Command Reference ip csg radius proxy csg-source-address Specifies the source IP address that the CSG2 is to use when sending packets to the RADIUS server. The CSG2 source IP address must be unique (or the IP address-VRF name combination must be unique, if VRF is configured).
Appendix A CSG2 Command Reference ip csg radius proxy Command Modes Global configuration Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Changes from CSG1: Usage Guidelines • The name of this command changed from radius proxy to ip csg radius proxy. • The configuration mode for this command changed from module CSG configuration to global configuration. • The vrf csg-vrf-name, vrf server-vrf-name, and vrf sub-vrf-name keywords and arguments were added.
Appendix A CSG2 Command Reference ip csg radius proxy Note If your network is designed to check the authorization string in RADIUS messages, we recommend that you enter a secret-string. Additionally, if you configure the ip csg entries user profile radius remove command, you might need to configure a secret-string.
Appendix A CSG2 Command Reference ip csg radius reauthorization attribute ip csg radius reauthorization attribute To define the RADIUS attributes and VSA subattributes to be monitored by the CSG2, and to enable Roaming Service Control, use the ip csg radius reauthorization attribute command in global configuration mode. To delete a RADIUS attribute, use the no form of this command.
Appendix A CSG2 Command Reference ip csg radius reauthorization attribute Examples The following example illustrates how to create a RADIUS proxy point: ip csg radius reauthorization attribute 14 ip csg radius reauthorization attribute vsa 7777 44 ip csg radius reauthorization attribute 26 7778 4 Related Commands Command Description ip csg radius proxy Specifies that the CSG2 is to be a proxy for RADIUS messages. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference ip csg radius start restart session-id ip csg radius start restart session-id To delete an existing CSG2 User Table entry for a specific subscriber, and to create a new entry for that subscriber, use the ip csg radius start restart session-id command in global configuration mode.
Appendix A CSG2 Command Reference ip csg radius start restart session-id Examples The following example shows how to enable the ip csg radius start restart session-id command: ip csg radius start restart session-id 44 Related Commands Command Description ip csg radius stop purge Specifies the attribute that must be included in the RADIUS Accounting Stop request in order for the CSG2 User Table entry to be deleted. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference ip csg radius stop purge ip csg radius stop purge To specify the attribute that must be included in the RADIUS Accounting Stop request in order for the CSG2 User Table entry to be deleted, use the ip csg radius stop purge command in global configuration mode. ip csg radius stop purge {radius-attribute-number | vsa {vendor-id | 3gpp} radius-subattribute-number} Syntax Description radius-attribute-number Specifies the RADIUS attribute number. The range is from 1 to 255.
Appendix A CSG2 Command Reference ip csg radius stop purge Related Commands Command Description ip csg radius start restart session-id Deletes an existing CSG2 User Table entry for a specific subscriber, and creates a new entry for that subscriber. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference ip csg radius userid ip csg radius userid To specify the RADIUS attribute used to extract the user identifier from a RADIUS record, use the ip csg radius userid command in global configuration mode. To specify that no RADIUS attributes are to be used, use the no form of this command. ip csg radius userid {1 | 31 | User-Name | Calling-Station-Id} no ip csg radius userid Syntax Description 1 RADIUS attribute number 1. 31 RADIUS attribute number 31.
Appendix A CSG2 Command Reference ip csg radius userid Related Commands Command Description ip csg radius ack error parse Enables the CSG2 to generate a RADIUS response to a RADIUS Accounting Start Request or a RADIUS Accounting Interim Request when it encounters a RADIUS parse error condition. ip csg radius ack error user Enables the CSG2 to generate a RADIUS response to a RADIUS Accounting Start Request or a RADIUS Accounting Interim Request when it encounters a user resource error condition.
Appendix A CSG2 Command Reference ip csg records format ip csg records format To specify variable, fixed, or combined (variable-single) call detail record (CDR) format, use the ip csg records format command in global configuration mode. To use the default setting, use the no form of this command. ip csg records format [fixed | variable [combined {http | wap}]] no ip csg records format [fixed | variable [combined {http | wap}]] Syntax Description fixed (Optional) Specifies fixed CDR format.
Appendix A CSG2 Command Reference ip csg redirect ip csg redirect To redirect subscriber flows to an alternate IP address when the subscriber’s quota is exhausted, use the ip csg redirect command in global configuration mode. To remove the redirect, use the no form of this command.
Appendix A CSG2 Command Reference ip csg redirect Examples The following example shows how to configure CSG2 redirects: ip ip ip ip ip csg csg csg csg csg redirect redirect redirect redirect redirect http http://server/topoff.html sip sip: 1.2.3.4 wap http://server/topoff.wml interval 30 maximum 10 Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference ip csg refund ip csg refund To specify the CSG2 refund policy to apply to the various services, and to enter CSG2 refund configuration mode, use the ip csg refund command in global configuration mode. To disable this feature, use the no form of the command. ip csg refund refund-policy-name no ip csg refund refund-policy-name Syntax Description refund-policy-name Defaults None Command Modes Global configuration Command History Release Modification 12.
Appendix A CSG2 Command Reference ip csg replicate ip csg replicate To enable high availability (HA) state replication between redundant CSG2 systems, use the ip csg replicate command in global configuration mode. To disable state replication, use the no form of this command.
Appendix A CSG2 Command Reference ip csg replicate Related Commands Command Description replicate Replicates the connection state for all connections to the CSG2 content servers on the standby system. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference ip csg report http header ip csg report http header To define the inclusion of multiple HTTP request headers in the CSG2 HTTP_Header call detail record (CDR), use the ip csg report http header command in global configuration mode. To disable this configuration, use the no form of this command.
Appendix A CSG2 Command Reference ip csg report http header Command Description ip csg report usage Enables CSG2 supplemental usage reporting to the quota server. ip csg report wap actual-pdu Specifies whether actual wireless application protocol (WAP) protocol data units (PDUs) are to be reported in CSG2 call detail records (CDRs). Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference ip csg report radius attribute ip csg report radius attribute To specify the RADIUS attributes and VSA subattributes to be copied from the RADIUS Start message and sent to the Billing Mediation Agent (BMA) in CSG2 call detail records (CDRs), use the ip csg report radius attribute command in global configuration mode. To disable this feature, use the no form of this command.
Appendix A CSG2 Command Reference ip csg report radius attribute The CSG2 saves only those attributes or subattributes which meet both of the following criteria: • They are present in the new RADIUS Accounting Start or RADIUS Interim Accounting Request. • They are configured for reporting at the time the new request arrives at the CSG2.
Appendix A CSG2 Command Reference ip csg report smtp rfc2822 ip csg report smtp rfc2822 To specify that the CSG2 is to include RFC 2822 header Tag-Length-Values (TLVs) in Simple Mail Transfer Protocol (SMTP) call detail records (CDRs), use the ip csg report smtp rfc2822 command in global configuration mode. To exclude SMTP headers from CDRs, use the no form of this command. ip csg report smtp rfc2822 no ip csg report smtp rfc2822 Syntax Description This command has no arguments or keywords.
Appendix A CSG2 Command Reference ip csg report usage ip csg report usage To enable CSG2 supplemental usage reporting to the quota server, use the ip csg report usage command in global configuration mode. To disable supplemental usage reporting, use the no form of this command. ip csg report usage {bytes ip | seconds} no ip csg report usage {bytes ip | seconds} Syntax Description bytes ip Report the number of IP bytes uploaded and downloaded for each interval.
Appendix A CSG2 Command Reference ip csg report usage Related Commands Command Description ip csg report http header Defines the inclusion of multiple HTTP request headers in the CSG2 HTTP_Header call detail record (CDR). ip csg report radius attribute Specifies the RADIUS attributes to be copied from the RADIUS Start message into call detail records (CDRs).
Appendix A CSG2 Command Reference ip csg report wap actual-pdu ip csg report wap actual-pdu To specify whether actual protocol data units (PDUs) are to be reported in CSG2 wireless application protocol (WAP) call detail records (CDRs), use the ip csg report wap actual-pdu command in global configuration mode. To exclude actual PDUs from WAP CDRs, use the no form of this command. ip csg report wap actual-pdu no ip csg report wap actual-pdu Syntax Description This command has no arguments or keywords.
Appendix A CSG2 Command Reference ip csg service ip csg service To configure a CSG2 content billing service, and to enter CSG2 service configuration mode, use the ip csg service command in global configuration mode. To turn off the content billing service, use the no form of this command. ip csg service service-name no ip csg service service-name Syntax Description service-name Defaults None Command Modes Global configuration Command History Release Modification 12.
Appendix A CSG2 Command Reference ip csg service Examples • basis • class • content (CSG2 service) • idle (CSG2 service) • meter exclude mms wap • meter exclude pause rtsp • meter exclude svc-idle • meter include imap • meter increment • meter initial • meter minimum • owner • passthrough • reauthorization threshold • reauthorization timeout • records granularity • refund • verify confirm • verify enable The following example shows how to define a CSG2 content billi
Appendix A CSG2 Command Reference ip csg service Command Description ip csg refund Specifies the CSG2 refund policy to apply to the various services, and enters CSG2 refund configuration mode. meter exclude mms wap Excludes bytes for a WAP 1.x Multimedia Messaging Service (MMS) session from the CSG2 usage calculation. meter exclude pause rtsp Excludes the Real Time Streaming Protocol (RTSP) PAUSE time from the CSG2 usage calculation.
Appendix A CSG2 Command Reference ip csg snmp timer ip csg snmp timer To define Simple Network Management Protocol (SNMP) timers for lost CSG2 records, use the ip csg snmp timer command in global configuration mode. To restore the default setting, use the no form of this command. ip csg snmp timer {bma | psd | quota-server} interval no ip csg snmp timer {bma | psd | quota-server} interval Syntax Description bma Defines an SNMP timer for lost CSG2 Billing Mediation Agent (BMA) records.
Appendix A CSG2 Command Reference ip csg subscriber ip csg subscriber To define a subscriber interface as a CSG2 subscriber interface, use the ip csg subscriber command in interface configuration mode. To restore the default setting, use the no form of this command. ip csg subscriber no ip csg subscriber Syntax Description This command has no arguments or keywords. Defaults The interface is not a CSG2 subscriber interface.
Appendix A CSG2 Command Reference ip csg transport-type assign ip csg transport-type assign To classify data traffic on the basis of its access path, use the ip csg transport-type assign command in global configuration mode. To remove transport-type information, use the no form of this command. ip csg transport-type assign ip-address value no ip csg transport-type assign ip-address value Syntax Description ip-address IP address. value Transport-type value in the range 1 to 255.
Appendix A CSG2 Command Reference ip iscsi target-profile ip iscsi target-profile To create an iSCSI profile for an iSCSI target on the CSG2, and enter iSCSI configuration mode, use the ip iscsi target-profile command in global configuration mode. To remove the iSCSI profile, use the no form of the command. ip iscsi target-profile target-profile-name no ip iscsi target-profile target-profile-name Syntax Description target-profile-name Command Default No default behavior or values.
Appendix A CSG2 Command Reference ip iscsi target-profile Related Commands Command Description ip (iSCSI) Specifies the IP address of an iSCSI target in the target interface profile on the CSG2. ip csg iscsi drain delay Defines the delay interval, in seconds, before draining packets from the Storage Area Network (SAN) connected to the Internet Small Computer Systems Interface (iSCSI) when the Billing Mediation Agent (BMA) becomes active.
Appendix A CSG2 Command Reference map map To reference a header, method, or URL map that is part of a CSG2 billing policy, use the map command in CSG2 policy configuration mode. To delete the reference, use the no form of this command. map map-name no map map-name Syntax Description map-name Defaults None Command Modes CSG2 policy configuration Command History Release Modification 12.4(11)MD This command was migrated from CSG1.
Appendix A CSG2 Command Reference map Examples The following example shows how to reference maps for CSG2 policies MOVIES and GAMES: ip csg policy MOVIES map HORROR map COMEDY ip csg policy GAMES map GAMES Related Commands Command Description ip csg map Defines the CSG2 billing content filters (header, method, and URL maps), and enters CSG2 map configuration mode. ip csg policy Defines a policy for qualifying flows for the CSG2 billing services, and enters CSG2 policy configuration mode.
Appendix A CSG2 Command Reference match header match header To specify a header match pattern for a CSG2 billing map, use the match header command in CSG2 map configuration mode. To delete the header match pattern, use the no form of this command. match header header-name value no match header header-name value Syntax Description header-name Header field that is to be matched against the input header.
Appendix A CSG2 Command Reference match header Usage Guidelines This command is valid only for HTTP and Session Initiation Protocol (SIP). You can use more than one match header command in CSG2 map configuration mode to specify multiple header match patterns for a header map as follows: • You can configure more than one match header command in a given header map, but they must reference different headers.
Appendix A CSG2 Command Reference match header Convention Description \character Escaped character. Examples: \? Match on a question mark (\?) \+ Match on a plus sign \* Match on an asterisk \a Alert (ASCII 7) \b Backspace (ASCII 8) \f Form-feed (ASCII 12) \n New line (ASCII 10) \r Carriage return (ASCII 13) \t Tab (ASCII 9) \v Vertical tab (ASCC 11) \0 Null (ASCII 0) \\ Back slash Bracketed range [0-9] Matching any single character from the range.
Appendix A CSG2 Command Reference match header match header User-Agent myagent The following example shows how to specify SIP header match patterns for map SIP-HDR1. In this example, the header match is TRUE only for Event presence and Content-Type application/sdp.
Appendix A CSG2 Command Reference match method match method To specify a method match pattern for a CSG2 billing map, use the match method command in CSG2 map configuration mode. To delete the match pattern, use the no form of this command. match method method-name no match method method-name Syntax Description method-name Method to be matched.
Appendix A CSG2 Command Reference match method You can specify up to 8192 match patterns. The following table shows and describes the special characters that you can use in the method-name argument in method match patterns. Convention Description * Zero or more characters. + Zero or more repeated instances of the token preceding the +. ? Zero or one character. \character Escaped character.
Appendix A CSG2 Command Reference match method In this example, a flow must match both HOSTMAP and URLMAP in order to match policy MAP-POLICY. Examples The following example shows how to specify a GET method match pattern for map MOVIES: ip csg map MOVIES match method GET Related Commands Command Description ip csg case-sensitive Specifies whether to treat CSG2 header, method, and URL match patterns as case-sensitive.
Appendix A CSG2 Command Reference match url match url To specify a URL match pattern for a CSG2 billing map, use the match url command in CSG2 map configuration mode. To delete the match pattern, use the no form of this command. match url pattern no match url pattern Syntax Description pattern Command Modes CSG2 map configuration Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Regular URL pattern to be matched against the input URL.
Appendix A CSG2 Command Reference match url • As a further example, by default the following URLs do not match: http://www.cisco.com/index.html http://www.cisco.com/INDEX.html However, if you have disabled case-sensitivity by entering the no ip csg case-sensitive command, then all of the following URLs match: http://www.cisco.com/index.html http://www.cisco.com/INDEX.html http://www.cisco.com/Index.html http://www.cisco.com/IndeX.html http://www.cisco.com/INdex.
Appendix A CSG2 Command Reference match url *.movies_drama.com/*.mpeg *.clips_comedy.com/*.mpeg *.clips_action.com/*.mpeg *.clips_drama.com/*.mpeg can be combined into the following single pattern: *.(movies|clips)*?*(comedy|action|drama).com/*.mpeg – Do not forget that the entire pattern, including wildcards and UNIX string-matching special characters, cannot exceed 128 characters. You can specify up to 8192 match patterns.
Appendix A CSG2 Command Reference match url When configuring a map, keep the following considerations in mind: • We recommend that you configure the URL match pattern during your maintenance window, or during off-peak hours. • You cannot specify different types of match patterns in a given map. For example, a map can include one or more match header statements, but it cannot include both match header statements and match url statements.
Appendix A CSG2 Command Reference meter exclude control sip meter exclude control sip To exclude call control packets for a Session Initiation Protocol (SIP) session from the CSG2 usage calculation, use the meter exclude control sip command in CSG2 service configuration mode. To return to the default behavior, use the no form of the command. meter exclude control sip no meter exclude control sip Syntax Description This command has no arguments or keywords.
Appendix A CSG2 Command Reference meter exclude control sip Command Description meter include imap Specifies which Internet Message Access Protocol (IMAP) bytes are billed for by the CSG2 when doing prepaid debits. meter increment Specifies the increments for debiting quota by the CSG2 upon completion of a service configured for Service Duration Billing.
Appendix A CSG2 Command Reference meter exclude mms wap meter exclude mms wap To exclude bytes for a WAP 1.x Multimedia Messaging Service (MMS) session from the CSG2 usage calculation, use the meter exclude mms wap command in CSG2 service configuration mode. To return to the default behavior, use the no form of the command. meter exclude mms wap no meter exclude mms wap Syntax Description This command has no arguments or keywords.
Appendix A CSG2 Command Reference meter exclude mms wap Command Description meter increment Specifies the increments for debiting quota by the CSG2 upon completion of a service configured for Service Duration Billing. meter initial Specifies the initial quota debited by the CSG2 from the balance at the beginning of a service when the service is configured for Service Duration Billing.
Appendix A CSG2 Command Reference meter exclude network-init sip meter exclude network-init sip To exclude incoming Session Initiation Protocol (SIP) transactions (that is, those that are initiated from the network) from the CSG2 usage calculation, use the meter exclude network-init sip command in CSG2 service configuration mode. To return to the default behavior, use the no form of the command.
Appendix A CSG2 Command Reference meter exclude network-init sip Command Description meter initial Specifies the initial quota debited by the CSG2 from the balance at the beginning of a service when the service is configured for Service Duration Billing. meter minimum Specifies the initial quota debited by the CSG2 from the balance at the beginning of a service when the service is configured for Service Duration Billing. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference meter exclude pause rtsp meter exclude pause rtsp To exclude the Real Time Streaming Protocol (RTSP) PAUSE time from the CSG2 usage calculation, use the meter exclude pause rtsp command in CSG2 service configuration mode. To return to the default behavior, use the no form of the command. meter exclude pause rtsp no meter exclude pause rtsp Syntax Description This command has no arguments or keywords.
Appendix A CSG2 Command Reference meter exclude pause rtsp Command Description meter exclude svc-idle Excludes the final service idle from the CSG2 usage calculation. meter include imap Specifies which Internet Message Access Protocol (IMAP) bytes are billed for by the CSG2 when doing prepaid debits. meter increment Specifies the increments for debiting quota by the CSG2 upon completion of a service configured for Service Duration Billing.
Appendix A CSG2 Command Reference meter exclude svc-idle meter exclude svc-idle To exclude the final service idle from the CSG2 usage calculation, use the meter exclude svc-idle command in CSG2 service configuration mode. To return to the default behavior, use the no form of the command. meter exclude svc-idle no meter exclude svc-idle Syntax Description This command has no arguments or keywords. Defaults The default behavior is to include the service-idle in the usage calculation.
Appendix A CSG2 Command Reference meter exclude svc-idle Command Description meter exclude network-init sip Excludes incoming Session Initiation Protocol (SIP) transactions (that is, those that are initiated from the network) from the CSG2 usage calculation. meter exclude pause rtsp Excludes the Real Time Streaming Protocol (RTSP) PAUSE time from the CSG2 usage calculation.
Appendix A CSG2 Command Reference meter include imap meter include imap To specify which Internet Message Access Protocol (IMAP) bytes are billed for by the CSG2 when doing prepaid debits, use the meter include imap command in CSG2 service configuration mode. To return to the default behavior, use the no form of the command.
Appendix A CSG2 Command Reference meter include imap – BODY.PEEK[#.TEXT] – RFC822 – RFC822.TEXT • HEADER—If the bytes cannot be classified as BODY, then they are classified as HEADER if a fetch request or response is encountered for one of the following specifications (including any appended “<>” subset variants): – BODY[HEADER] – BODY[#.HEADER] – BODY.PEEK[HEADER] – BODY.PEEK[#.HEADER] – RFC822.
Appendix A CSG2 Command Reference meter include imap Command Description meter increment Specifies the increments for debiting quota by the CSG2 upon completion of a service configured for Service Duration Billing. meter initial Specifies the initial quota debited by the CSG2 from the balance at the beginning of a service when the service is configured for Service Duration Billing.
Appendix A CSG2 Command Reference meter increment meter increment To specify the increments for debiting quota by the CSG2 upon completion of a service configured for Service Duration Billing, use the meter increment command in CSG2 service configuration mode. To restore the default behavior, use the no form of the command.
Appendix A CSG2 Command Reference meter increment Examples The following example shows how to configure quota debit increments for Service Duration Billing for the OFF_NET service. ip csg service OFF_NET meter increment 100 Related Commands Command Description ip csg service Configures a CSG2 content billing service, and enters CSG2 service configuration mode. meter exclude control sip Excludes call control packets for a Session Initiation Protocol (SIP) session from the CSG2 usage calculation.
Appendix A CSG2 Command Reference meter initial meter initial To specify the initial quota debited by the CSG2 from the balance at the beginning of a service when the service is configured for Service Duration Billing, use the meter initial command in CSG2 service configuration mode. To restore the default behavior, use the no form of the command.
Appendix A CSG2 Command Reference meter initial Command Description meter exclude mms wap Excludes bytes for a WAP 1.x Multimedia Messaging Service (MMS) session from the CSG2 usage calculation. meter exclude network-init sip Excludes incoming Session Initiation Protocol (SIP) transactions (that is, those that are initiated from the network) from the CSG2 usage calculation. meter exclude pause rtsp Excludes the Real Time Streaming Protocol (RTSP) PAUSE time from the CSG2 usage calculation.
Appendix A CSG2 Command Reference meter minimum meter minimum To specify the minimum number of quadrans debited by the CSG2 for a service or session, use the meter minimum command in CSG2 service configuration mode. To return to the default behavior, use the no form of the command. meter minimum value no meter minimum value Syntax Description value Minimum number of quadrans debited for a service or session, excluding the value in meter initial.
Appendix A CSG2 Command Reference meter minimum Examples The following example shows how to configure a minimum debit for the OFF_NET service. ip csg service OFF_NET meter minimum 60 Related Commands Command Description ip csg service Configures a CSG2 content billing service, and enters CSG2 service configuration mode. meter exclude control sip Excludes call control packets for a Session Initiation Protocol (SIP) session from the CSG2 usage calculation.
Appendix A CSG2 Command Reference mode mode To specify the mode for a CSG2 billing plan, use the mode command in CSG2 billing configuration mode. To use the default mode, use the no form of this command. mode [postpaid | prepaid] no mode Syntax Description postpaid (Optional) Specifies a postpaid billing plan. prepaid (Optional) Specifies a prepaid billing plan. This is the default setting. Defaults The default mode is prepaid.
Appendix A CSG2 Command Reference mode tcp mode tcp To specify the mode for CSG2 TCP sessions, use the mode tcp command in CSG2 content configuration mode. To use the default mode, use the no form of this command. mode tcp {datagram | transparent [zero]} no mode tcp Syntax Description datagram Specifies that the CSG2 is to treat TCP sessions as datagrams. transparent Specifies that the CSG2 is to treat TCP sessions as transparent.
Appendix A CSG2 Command Reference name (iSCSI) name (iSCSI) To specify the name of an iSCSI target in the target profile on the CSG2, use the name command in iSCSI configuration mode. To remove the IP address configuration, use the no form of the command. name target-name no name target-name Syntax Description target-name Command Default No default behavior or values. Command Modes iSCSI configuration Command History Release Modification 12.4(15)MD This command was introduced.
Appendix A CSG2 Command Reference name (iSCSI) Command Description ip iscsi target-profile Creates an iSCSI profile for an iSCSI target on the CSG2, and enters iSCSI configuration mode. port (iSCSI) Specifies the number of the port on which to listen for iSCSI traffic in the iSCSI target interface profile on the CSG2. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference next-hop next-hop To define a next-hop IP address, use the next-hop command in CSG2 content configuration mode. To delete the next-hop IP address, use the no form of this command. next-hop ip-address [reverse] [subscriber media] no next-hop ip-address [reverse] [subscriber media] Syntax Description ip-address IP address of the next hop for packets sourced by the flow initiator. reverse (Optional) IP address of the next hop for packets sent to the flow initiator.
Appendix A CSG2 Command Reference next-hop Related Commands Command Description client-group (CSG2 content) References a standard access list that is part of a CSG2 content. ip csg content Configures content for CSG2 services, and enters CSG2 content configuration mode. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference owner owner To specify an identifier or name for a CSG2 service owner, use the owner command in CSG2 service configuration mode. To remove the owner ID or name, use the no form of this command. owner {id id | name name} no owner {id | name} Syntax Description id id 1- to 15-character string that identifies a service owner. name name 1- to 38-character string that specifies the name of the service.
Appendix A CSG2 Command Reference parse length parse length To define the maximum number of Layer 7 bytes that the CSG2 is to parse when attempting to assign a policy, use the parse length command in CSG2 content configuration mode. To restore the default setting, use the no form of this command. parse length number no parse length Syntax Description number Defaults The CSG2 parses up to 4000 Layer 7 bytes when attempting to assign a policy.
Appendix A CSG2 Command Reference parse protocol parse protocol To define how the CSG2 is to parse traffic for a content, use the parse protocol command in CSG2 content configuration mode. To restore the default setting, use the no form of this command. parse protocol {ftp | http | imap | other | pop3 | rtsp | sip | smtp | wap {connection-oriented | connectionless}} no parse protocol Syntax Description ftp FTP traffic, with Layer 7 inspection of FTP control sessions. http HTTP traffic.
Appendix A CSG2 Command Reference parse protocol Related Commands Command Description ip csg content Configures content for CSG2 services, and enters CSG2 content configuration mode. parse length Defines the maximum number of Layer 7 bytes that the CSG2 is to parse when attempting to assign a policy. subscriber-ip http-header forwarded-for Specifies that the CSG2 is to obtain the subscriber's IP address from the HTTP X-Forwarded-For header.
Appendix A CSG2 Command Reference passthrough passthrough To enable passthrough mode for a CSG2 service, use the passthrough command in CSG2 service configuration mode. To disable passthrough mode, use the no form of this command. passthrough quota-grant no passthrough Syntax Description quota-grant Defaults None Command Modes CSG2 service configuration Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Size of each quota grant to give to the service.
Appendix A CSG2 Command Reference pending pending To set the pending connection timeout, use the pending command in CSG2 content configuration mode. To restore the default, use the no form of this command. pending timeout no pending Syntax Description timeout Defaults The default pending connection timeout is 30 seconds. Command Modes CSG2 content configuration Command History Release Modification 12.4(11)MD This command was migrated from CSG1.
Appendix A CSG2 Command Reference policy (CSG2 content) policy (CSG2 content) To reference a CSG2 billing policy, use the policy command in CSG2 content configuration mode. To delete a policy reference, use the no form of this command. policy policy-name [priority priority-number] no policy policy-name Syntax Description policy-name Name of a configured CSG2 billing policy. priority priority-number (Optional) Priority of the policy. The priority specifies the order of preference of the policy.
Appendix A CSG2 Command Reference policy (CSG2 content) Examples The following example shows how to reference policies with and without priorities: ip csg content MOVIES policy COMEDY policy HORROR ip csg content MUSIC policy HIPHOP priority 1 policy COUNTRY priority 10000 Related Commands Command Description ip csg content Configures content for CSG2 services, and enters CSG2 content configuration mode.
Appendix A CSG2 Command Reference port (iSCSI) port (iSCSI) To specify the number of the port on which to listen for iSCSI traffic in the iSCSI target interface profile on the CSG2, use the port command in iSCSI configuration mode. To remove the port number, use the no form of the command. port port-number no port port-number Syntax Description port-number Command Default No default behavior or values. Command Modes iSCSI configuration Command History Release Modification 12.
Appendix A CSG2 Command Reference port (iSCSI) Command Description ip iscsi target-profile Creates an iSCSI profile for an iSCSI target on the CSG2, and enters iSCSI configuration mode. name (iSCSI) Specifies the name of an iSCSI target in the target profile on the CSG2 Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference reauthorization threshold reauthorization threshold To configure the CSG2 reauthorization threshold, use the reauthorization threshold command in CSG2 service configuration mode. To restore the default setting, use the no form of this command. reauthorization threshold threshold no reauthorization threshold Syntax Description threshold Number of remaining quadrans or seconds to trigger reauthorization.
Appendix A CSG2 Command Reference reauthorization threshold Examples The following example shows how to specify a reauthorization threshold of 75 quadrans: ip csg service A1 reauthorization threshold 75 Related Commands Command Description ip csg service Configures a CSG2 content billing service, and enters CSG2 service configuration mode. reauthorization timeout Specifies the CSG2 reauthorization timeout. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference reauthorization timeout reauthorization timeout To specify the CSG2 reauthorization timeout, use the reauthorization timeout command in CSG2 service configuration mode. To restore the default setting, use the no form of this command. reauthorization timeout [initial initial-timeout] [maximum maximum-timeout] no reauthorization timeout Syntax Description initial initial-timeout (Optional) Initial timeout, in seconds, for reauthorization after a quota grant of zero.
Appendix A CSG2 Command Reference reauthorization timeout Examples The following example shows how to specify an initial reauthorization timeout of 10 seconds and a maximum reauthorization timeout of 20 seconds: ip csg service A1 reauthorization timeout initial 10 maximum 20 Related Commands Command Description ip csg service Configures a CSG2 content billing service, and enters CSG2 service configuration mode. reauthorization threshold Specifies the CSG2 reauthorization threshold.
Appendix A CSG2 Command Reference records delay records delay To specify the delay before the CSG2 is to send the HTTP Statistics CDR, use the records delay command in CSG2 content configuration mode. To restore the default setting, use the no form of this command. records delay seconds no records delay Syntax Description seconds Defaults The default value is 0 (no records delay). Command Modes CSG2 content configuration Command History Release Modification 12.
Appendix A CSG2 Command Reference records granularity records granularity To specify the granularity at which CSG2 billing call detail records (CDRs) are to be generated, use the records granularity command in CSG2 service configuration mode. To restore the default granularity, use the no form of this command.
Appendix A CSG2 Command Reference records granularity Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Changes from CSG1: Usage Guidelines • The time keyword changed to seconds. • The range for the seconds argument changed from 60 to 4294967295, to 5 to 86400. You can use this command to reduce the number of records for services for which transaction-level billing is not required.
Appendix A CSG2 Command Reference records intermediate records intermediate To enable the generation of CSG2 intermediate billing records, use the records intermediate command in CSG2 content configuration mode. To disable the generation of intermediate billing records, use the no form of this command.
Appendix A CSG2 Command Reference records intermediate Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Changes from CSG1: Usage Guidelines • 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.
Appendix A CSG2 Command Reference refund refund To specify the refund policy for a CSG2 prepaid service, use the refund command in CSG2 service configuration mode. To disable the refund policy, use the no form of this command. refund policy-name no refund policy-name Syntax Description policy-name Defaults Refunding is not enabled. Command Modes CSG2 service configuration Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Name of the refund policy.
Appendix A CSG2 Command Reference replicate replicate To replicate the connection state for all connections to the CSG2 content servers on the standby system, use the replicate command in CSG2 content configuration mode. To disable connection redundancy, use the no form of this command. replicate [delay seconds] no replicate [delay] Syntax Description delay seconds Defaults Connection redundancy is not enabled. If you do not specify a delay, there is no delay.
Appendix A CSG2 Command Reference replicate Related Commands Command Description ip csg content Configures content for CSG2 services, and enters CSG2 content configuration mode. ip csg replicate Enables state replication between redundant CSG2 systems. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference retcode retcode To specify the range of application return codes for which the CSG2 refunds quota for Prepaid Error Reimbursement, use the retcode command in CSG2 refund configuration mode. To disable this feature, use the no form of this command.
Appendix A CSG2 Command Reference retcode Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Changes from CSG1: None. 12.4(15)MD Usage Guidelines The ftp and sip keywords were added. The CSG2 supports return code-based refunding for all protocols except RTSP. The return codes are protocol-specific. For IMAP, keep in mind the following considerations: Examples • Only return code 554 is used.
Appendix A CSG2 Command Reference sami rate all sami rate all To specify the bit rate limit to be used by the Service and Application Module for IP (SAMI) for each PowerPC’s (PPC’s) traffic, CSG2 use the sami rate all command in global configuration mode. Use the no form of this command to disable this feature. sami rate bits-per-second all no sami rate bits-per-second all Syntax Description bits-per-second Defaults The default rate is 1.9 Gbps (0x70000000).
Appendix A CSG2 Command Reference service service To associate a service with a CSG2 billing plan, use the service command in CSG2 billing configuration mode. To remove the association, use the no form of this command. service service-name no service service-name Syntax Description service-name Defaults None Command Modes CSG2 billing configuration Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Name of a configured CSG2 billing service.
Appendix A CSG2 Command Reference show ip csg show ip csg To display information about the CSG2, use the show ip csg command in privileged EXEC mode.
Appendix A CSG2 Command Reference show ip csg replicate Displays information about only high availability (HA) sessions. smtp Displays information about only the Simple Mail Transfer Protocol (SMTP) sessions. user Displays information about only subscriber sessions. application (Optional) Displays information about only the specified application: internal • ftp—Closes FTP subscriber sessions. • http—Closes HTTP subscriber sessions. • imap—Closes IMAP subscriber sessions.
Appendix A CSG2 Command Reference show ip csg internal (Optional) Displays internal CSG2 data structure information for use in debugging. We recommend that you enter this keyword only when directed to do so by Cisco Technical Assistance Center (TAC) engineers. detail (Optional) Displays more detailed information. Command Default None Command Modes Privileged EXEC Command History Release Modification 12.4(11)MD This command was migrated from CSG1.
Appendix A CSG2 Command Reference show ip csg TCP WAPCONN WAPCONNLESS TCP UDP UDP 0.0.0.0/0:0 0.0.0.0/0:9201 0.0.0.0/0:9200 ALL ALL ALL INSTALLED INSTALLED INSTALLED The following example shows how to display detailed statistics and counters for the CSG2 HTTP content named HTTP: Router# show ip csg content name HTTP detail HTTP, parse type = http, state = INSTALLED, index = 13 destination = 0.0.0.
Appendix A CSG2 Command Reference show ip csg response sends = 11252888, response send failures = 0 received from peer unreliable = 51626, reliable = 97224994, request = 11254924, response = 1667364 unsupported ipc port = 0, unsupported ipc request port = 0 uncorrelated = 1138193 errors rtx list = 0, hash list = 0, dealloc = 0 msg type = 0, ack miss = 0 -----------------------------destination = 127.1.0.
Appendix A CSG2 Command Reference show ip csg Denied (per second) = 5065121 (0) Rate: Limit 1800 per traffic processor Denied (per second) = 25193314 (0) Session Create Allowed (per second) = 49802545 (1872) IPC: Queue Depth Tolerance 36000 / 100000 (36 percent) Denied (per second) = 21971 (6) BMA Messages Allowed (per second) = 94475805 (11138) IPC: Queue Depth Tolerance 60000 / 100000 (60 percent) Denied (per second) = 0 (0) Quota Server Allowed (per second) = 13725076 (837) IPC: Queue Depth Tolerance
Appendix A CSG2 Command Reference show ip csg out of order = 412 out of order get = 384 out of order flushed = 28 retransmitted = 485 set aside = 9504977 set aside get = 9418614 set aside flushed = 86222 term closed = 1362349 term RST = 457991 term not SYN = 0 term mid SYN = 0 term error = 0 dropped OOW = 0 dropped set aside = 692663 dropped queue size = 0 dropped error = 0 CSG Fragment Stats: creates = 161, destroys = 161, timeouts = 0, invalids = 0, locked = 0 Leaders: rx = 161, tx = 161, dropped = 0,
Appendix A CSG2 Command Reference show ip csg alloc failures = 0, no standby on CG failure = packets sent = 14217667, received = 122537872, packets dropped = 0, rejected = 0, retransmits packets outstanding: current = 5022, highwater bad records = 0, unknown CG = 0, CG failures = send skipped = 0, records dropped during drain Charging Gateways: defined = 5, max active = 5 127.1.0.4:00ACTIVE 127.1.0.5:00ACTIVE 127.1.0.6:00ACTIVE 127.1.0.7:00ACTIVE 127.1.0.
Appendix A CSG2 Command Reference show ip csg invalid message size = 0, unable to find client = 0 unable to send to client = 0, unable to send to server = 0 unable to find proxy blk = 0 proxy CSG ip = 10.18.28.34, server ip = 11.18.28.17 client->server = 386484, server->client = 385459 parse errors = 0, pkt not proxied = 0 proxy CSG ip = 10.18.28.36, server ip = 11.18.28.18 client->server = 230290, server->client = 229610 parse errors = 0, pkt not proxied = 0 proxy CSG ip = 10.18.28.37, server ip = 11.18.
Appendix A CSG2 Command Reference show ip csg CSG OTHER Stats: total sessions = 40344, alloc fail = 0 aoc fail = 0, frags = 0, aborts = 6521, init fail = 2513 reports = 39937, standby no uid = 0, errors = 0 CSG HTTP Stats: sess = 18052044, txn = 22158257, set-aside resolved = 9367313 packets: sub new = 22418621, retx = 53, payload less = 164830871 net new = 238215919, retx = 94709, payload less = 22597153 billing reports: header = 6075882, stats = 79933600 alloc failures = 0 downgrade: parse failures = 8
Appendix A CSG2 Command Reference show ip csg Aoc: reqs = 47923, drop = 14006, redir = 6778, fail = 0 Drops: err = 0, quota = 14290, block = 0, queue = 2521 Timer Stats: tmr_intialized = 1 tmr_ticks = 7160 tmr_starts = 4067359 tmr_stops = 3487837 tmr_timeouts = 574960 tmr_active = 4562 tmr_longest_chain = 505 Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference show ip csg The following example shows how to display information about the quota server: Router# show ip csg quota-server charging gateway vrf priority state -------------------------------------------------------------------------10.18.28.
Appendix A CSG2 Command Reference show ip csg The following table lists and describes the possible states for the show ip csg sessions user command: State1 Description CSG_SSVC_STATE_INIT The session has been created but no packet has been processed. Short timer.2 CSG_SSVC_STATE_SYN_SUB A SYN packet has been received from the subscriber interface. Short timer.2 CSG_SSVC_STATE_SYN_NET A SYN packet has been received from the network interface. Short timer.
Appendix A CSG2 Command Reference show ip csg State1 Description CSG_SSVC_STATE_CLOSING_ACK_NET_WAIT The session has received a FIN-ACK or a FIN and an ACK from the subscriber interface and is waiting for the ACK from the network interface to close the connection. Short timer.2 CSG_SSVC_STATE_CLOSING_ACK_SUB_WAIT The session has received a FIN-ACK or a FIN and an ACK from the network interface and is waiting for the ACK from the subscriber interface to close the connection. Short timer.
Appendix A CSG2 Command Reference show ip iscsi show ip iscsi To display information about the iSCSI, use the show ip iscsi command in privileged EXEC mode. show ip iscsi {name | session [session-id] [detail] | stats [detail] | target} Syntax Description name Displays the name of an iSCSI initiator. session Displays the status of iSCSI sessions on the CSG2. session-id (Optional) Displays information for only the specified iSCSI session.
Appendix A CSG2 Command Reference show ip iscsi The following example shows output from the show ip iscsi stats command: Router# show ip iscsi stats iSCSI Stats: Login Requests - 2, Login Responses - 2 Logout Requests - 0, Logout Responses - 0 Login Timeouts - 0, Logout Timeouts - 0 SCSI Commands - 27, SCSI Responses - 27 Data In PDUs - 25, Data Out PDUs - 0 Immed Data - 1, Unsolicited Data - 0 NOP Ins - 35, NOP Outs - 35 Async Requests - 0, Async Req Logout - 0 Async Drop Conn - 0, Async Drop Conns - 0
Appendix A CSG2 Command Reference show ip iscsi The following example shows output from the show ip iscsi target command: Router# show ip iscsi target Target Profile= TARGET_LINUX IN_USE Target: name= iqn.2002-10.edu.unh.iol.iscsi.draft20-target:1 Target: ip= 10.76.43.233, port= 3260, portal group= 0 vrf= , sync read offset= 100, batch write= 100 write interval= 5 sec, file size= 100 MB # Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference show record-storage-module show record-storage-module To display information about the record storage module (RSM), use the show record-storage-module command in privileged EXEC mode. show record-storage-module {stats | target-info [all | target-profile profile-name] [detail]} Syntax Description stats Displays current RSM statistics. target-info Displays the number of RSM disks available, and their current status.
Appendix A CSG2 Command Reference show record-storage-module Number of drives = 5, Read drive = sda3, Write drive Active drives: Drive = sda3 File system id = 19 Descriptors: read = -1, write = -1, master = -1 Current File: bytes written = 0, bytes read = 0 Master file in memory: Drive full = No Write: dir = 1, file = 1 Read: dir = 1, file = 1, offset = 62675 Salvage file = 0, CRC = 0x91C816C0 Failed drives: Drive = sda0 Reason = Unexpected IFS error (Invalid DOS media or Drive = sda1 Reason = Unexpected
Appendix A CSG2 Command Reference snmp-server enable traps csg snmp-server enable traps csg To enable Simple Network Management Protocol (SNMP) notification types that are available on the CSG2, use the snmp-server enable traps csg command in global configuration mode. To disable CSG2 notifications, use the no form of this command.
Appendix A CSG2 Command Reference snmp-server enable traps csg Examples The following example enables CSG2 traps: snmp-server enable traps csg Related Commands Command Description ip csg snmp timer Defines Simple Network Management Protocol (SNMP) timers for lost CSG2 records, and enters CSG2 SNMP timer configuration mode. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference subscriber-ip http-header forwarded-for subscriber-ip http-header forwarded-for To specify that the CSG2 is to obtain the subscriber's IP address from the HTTP X-Forwarded-For header, use the subscriber-ip http-header x-forwarded-for command in CSG2 content configuration mode. To specify that the CSG2 is to obtain the subscriber's IP address from the IP header, use the no form of this command.
Appendix A CSG2 Command Reference subscriber-ip http-header forwarded-for To prevent exposure of potentially sensitive IP addresses, the CSG2 can obscure the contents of X-Forwarded-For headers, overwriting the contents with blanks. • If you want to obscure the contents of the X-Forwarded-For header, enter the subscriber-ip http-header x-forwarded-for command with the obscure keyword.
Appendix A CSG2 Command Reference verify confirm verify confirm To configure a token for use in CSG2 service verification URL-rewriting, use the verify confirm command in CSG2 service configuration mode. To remove the token, use the no form of this command. verify confirm token no verify confirm token Syntax Description token A string of up to 15 alphanumeric characters. The string is not case-sensitive.
Appendix A CSG2 Command Reference verify confirm Examples The following example specifies a token for service verification URL-rewriting: ip csg service MOVIES aoc enable verify confirm ?CSG_VERIFY_OK Related Commands Command Description ip csg service Configures a CSG2 content billing service, and enters CSG2 service configuration mode. verify enable Enables CSG2 service verification. Cisco Content Services Gateway - 2nd Generation Release 2.
Appendix A CSG2 Command Reference verify enable verify enable To enable CSG2 service verification, use the verify enable command in CSG2 service configuration mode. To disable this feature, use the no form of this command. verify enable no verify enable Syntax Description This command has no arguments or keywords. Defaults None Command Modes CSG2 service configuration Command History Release Modification 12.4(11)MD This command was migrated from CSG1.
Appendix A CSG2 Command Reference vlan (CSG2 content) vlan (CSG2 content) To restrict the CSG2 billing content to a single source VLAN, use the vlan command in CSG2 content configuration mode. To remove the restriction, use the no form of this command. vlan vlan-number no vlan Syntax Description vlan-number Defaults None Command Modes CSG2 content configuration Command History Release Modification 12.4(11)MD This command was migrated from CSG1. Dot1q encapsulation VLAN number.
Appendix A CSG2 Command Reference vrf vrf To restrict the CSG2 content to packets within a single Virtual Routing and Forwarding (VRF) table, use the vrf command in CSG2 content configuration mode. To remove the restriction, use the no form of this command. vrf vrf-name no vrf Syntax Description vrf-name Defaults None Command Modes CSG2 content configuration Command History Release Modification 12.4(11)MD This command was introduced.
