Accounting Configuration for QoS

This section explains how to configure the account configuration and account servers so you can use the Oracle® Enterprise Session Border Controller in conjunction with external RADIUS (accounting) servers to generate CDRs and provide billing services requires.

QoS Accounting Configuration

To configure the account configuration and account servers:

1. In Superuser mode, type configure terminal and press Enter.

   ORACLE# configure terminal

2. Type session-router and press Enter.

   ORACLE(configure)# session-router

3. Type account-config and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters.

   ORACLE(session-router)# account-config
   ORACLE(account-config)#

4. To configure account server parameters (a subset of the account configuration parameters, type account-servers and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters.

   ORACLE(account-config)# account-servers
   ORACLE(account-server)#

   The following example shows both the account config and account server parameters.

   account-config
           hostname                       acctserver1
           port                           1813
           strategy                       Hunt
           state                          enabled
           max-msg-delay                  60
           max-wait-failover              100
           trans-at-close                 disabled
           generate-start                 OK
           generate-interim
                                          OK
                                          Reinvite-Response
   account-server
                   hostname                       192.168.2.2
                   port                           1813
                   state                          enabled
                   min-round-trip                 100
                   max-inactivity                 100
                   restart-delay                  100
                   bundle-vsa                     enabled
                   secret                         testing
                   NAS-ID                         acme-accounting
   last-modified-date             2005-01-15 02:23:42

Account Configuration

You set the account configuration parameters to indicate where you want accounting messages sent, when accounting messages you want them sent, and the strategy you want used to select account servers.

To configure the account configuration:

1. hostname—Enter a name for the host associated with the Oracle® Enterprise Session Border Controller in hostname (FQDN) format. The default value is the name of the local host.

   The value you enter here must match the configured phy-interface’s operation type control or maintenance, to determine on which network to send RADIUS messages.

2. port—Enter the number of the UDP port associated with the Oracle® Enterprise Session Border Controller from which RADIUS messages are sent.The default value is 1813. The valid range is:

   • Minimum—1025

   • Maximum—65535

3. strategy—Indicate the strategy you want used to select the accounting servers to which the Oracle® Enterprise Session Border Controller will send its accounting messages. The default value is hunt. The following table lists the available strategies:

   • hunt—Selects accounting servers in the order in which they are listed.

     If the first accounting server is online, working, and has not exceeded any of the defined constraints, all traffic is sent to it. Otherwise the second accounting server is selected. If the first and second accounting servers are offline or exceed any defined constraints, the third accounting server is selected. And so on through the entire list of configured servers

   • failover—Uses the first server in the list of predefined accounting servers until a failure is received from that server. Once a failure is received, it moves to the second accounting server in the list until a failure is received. And so on through the entire list of configured servers.

   • roundrobin—Selects each accounting server in order, distributing the selection of each accounting server evenly over time.

   • fastestrtt—Selects the accounting server that has the fastest round trip time (RTT) observed during transactions with the servers (sending a record and receiving an ACK).

   • fewestpending—Selects the accounting server that has the fewest number of unacknowledged accounting messages (that are in transit to the Oracle® Enterprise Session Border Controller).

4. state—Enable this parameter if you want the account configuration active on the system. Disable it if you do not want the account configuration active on the system. The default value is enabled. The valid values are:

   • enabled | disabled

5. max-msg-delay—Indicate the length of time in seconds that you want the Oracle® Enterprise Session Border Controller to continue trying to send each accounting message. During this delay, the Oracle® Enterprise Session Border Controller can hold a generic queue of 4096 messages. The default value is 60.

   • Minimum—zero (0)

   • Maximum—4294967295

6. max-wait-failover—Indicate the maximum number of accounting messages the Oracle® Enterprise Session Border Controller can store its message waiting queue for a specific accounting server, before it is considered a failover situation.

   Once this value is exceeded, the Oracle® Enterprise Session Border Controller attempts to send it accounting messages, including its pending messages, to the next accounting server in its configured list. The default value is 100. The valid range is:

   • Minimum—1

   • Maximum—4096

7. trans-at-close—Disable this parameter if you do not want to defer the transmission of message information to the close of a session. Enable it if you want to defer message transmission. The default value is disabled. The valid values are:

   • disabled—The Oracle® Enterprise Session Border Controller transmits accounting information at the start of a session (Start), during the session (Interim), and at the close of a session (Stop). The transmitted accounting information for a single session might span a period of hours and be spread out among different storage files.

   • enabled—Limits the number of files on the Oracle® Enterprise Session Border Controller used to store the accounting message information for one session. It is easiest to store the accounting information from a single session in a single storage file.

8. generate-start—Select the type of SIP event that triggers the Oracle® Enterprise Session Border Controller to transmit a RADIUS Start message. The default value is ok. The valid values are:

   • start—RADIUS Start message should not be generated

   • invite—RADIUS Start message should be generated once the Oracle® Enterprise Session Border Controller receives a SIP session INVITE.

   • ok—RADIUS Start message is generated once the Oracle® Enterprise Session Border Controller receives an OK message in response to an INVITE.

9. generate-interim—Retain the default value reinvite-response to cause the Oracle® Enterprise Session Border Controller to transmit a RADIUS Interim message. (A RADIUS Interim message indicates to the accounting server that the SIP session parameters have changed.)

   To disable interim message generation, enter a pair of quotes as the value for this parameter. Otherwise, select one or more than one of the following values:

   • ok—RADIUS Interim message is generated when the Oracle® Enterprise Session Border Controller receives an OK message in response to an INVITE.

   • reinvite—RADIUS Interim message is generated when the Oracle® Enterprise Session Border Controller receives a SIP session reINVITE message.

   • reinvite-response—RADIUS Interim message is generated when the Oracle® Enterprise Session Border Controller receives a SIP session reINVITE and responds to it (for example, session connection or failure).

   • reinvite-cancel—RADIUS Interim message is generated when the Oracle® Enterprise Session Border Controller receives a SIP session reINVITE, and the Reinvite is cancelled before the Oracle® Enterprise Session Border Controller responds to it.

10. account-server—Create the account server list to store accounting server information for the account configuration. Each account server can hold 100 accounting messages.

    Account server entries are specific to the account configuration. They cannot be viewed or accessed for editing outside of the account configuration.

    Note:

    RADIUS will not work if you do not enter one or more servers in a list.

Account Server

These are the IPv6-enabled parameters in the account-server configuration.

Parameter	Entry Format
hostname	<ip-address>[/<num-bits>][:<port>[/<port-bits>]]
dns-query-type	<none><A><AAAA> Note: When set to none, the system refers to the interface associated with the dns-realm setting in the account-config. If the interface has an IPv6 address, the system performs an AAAA query.