19 Managing Charging During System Downtimes

You can configure how Oracle Communications Elastic Charging Engine (ECE) handles charging when the system is down.

Topics in this document:

Configuring Diameter Gateway to Bypass Rating During ECE Downtime

During a planned maintenance activity or in the event of unplanned downtime of an ECE node, you can configure Diameter Gateway to continue receiving CCRs and responding to the service network without real-time rating of the CCRs.

When you configure Diameter Gateway to bypass rating, it persists the Diameter CCRs to the Oracle NoSQL database. Later, when ECE nodes are restored, you can replay the persisted CCRs to the ECE charging servers for rating and updating balance impacts. With this functionality, services can be delivered to your subscribers without any interruption.

To configure Diameter Gateway to bypass rating, perform the following procedures:

  1. Enable the ocsBypassExtension charging extension.

    1. Access the ECE configuration MBeans in a JMX editor, such as JConsole. See "Accessing ECE Configuration MBeans".

    2. Expand the ECE Configuration node.

    3. Expand charging.extensions.

    4. Expand Attributes.

    5. Specify the fully qualified class name of the extension for the ocsBypassExtension attribute.

  2. Start the persistence of the diameter messages. See "Managing the Persistence of Usage Requests During ECE Downtime".

  3. After the ECE nodes are restored, use Diameter Replayer to replay the CCRs to ECE for rating and updating balance impacts. See "Replaying Persisted Requests into ECE".

Managing the Persistence of Usage Requests During ECE Downtime

When Diameter Gateway is configured to bypass rating during a planned maintenance activity or in an unplanned downtime of ECE, Diameter Gateway receives CCRs and persists them to the Oracle NoSQL Database. Later, when the ECE nodes are restarted, you stop the bypass rating extension and replay the persisted messages to the ECE charging servers for rating and updating balance impacts.

Managing the persistence of diameter requests involves starting and stopping the persistence of the requests. Before persisting the incoming diameter requests, ensure that the ocsBypassExtension charging extension is enabled. See "Configuring Diameter Gateway to Bypass Rating During ECE Downtime" for information on configuring Diameter Gateway to bypass rating.

For planned maintenance activities, you start the persistence of usage requests before the ECE nodes become unavailable. During an outage, the persistence of diameter requests starts only if the ocsBypassExtension charging extension is enabled. If only the extension is enabled and bypass rating is not started, the usage requests do not flow to the ECE Charging Server nodes. In such a scenario, Diameter Gateway returns Error 5012 for the requests.

Note:

The bypass rating functionality is supported for Gy diameter messages only.

To persist incoming diameter requests:

  1. Access the ECE configuration MBeans in a JMX editor, such as JConsole. See "Accessing ECE Configuration MBeans".

  2. Expand the DiameterGateway node.

  3. Expand BFTTask.

  4. Expand Operations.

  5. Click startByPass.

    The Diameter Gateway starts persisting the incoming requests.

In planned maintenance activities or in unplanned downtime, once the ECE nodes become available and start running, you must stop the persistence of the requests. Otherwise, messages are persisted even after the ECE nodes are up and running, which results in a large volume of requests that need to be replayed.

To stop persisting the requests, click stopByPass. Before doing this, you can check if the persistence of requests is running by clicking BFTRunning. If bypassing rating is enabled, this field shows True. Otherwise, it shows False.

Replaying Persisted Requests into ECE

When you configure Diameter Gateway to bypass rating during planned maintenance or unplanned downtime of ECE, Diameter Gateway persists the incoming CCRs in the Oracle NoSQL Database. Later, during a non-peak period, you replay the persisted CCRs to the ECE charging server when the ECE server is restored and is ready to process real-time requests. When you replay the persisted CCRs, the requests are passed to the ECE charging server, which then rates the CCRs and updates the balance impacts. You can plan when to start replaying the persisted messages, considering that replaying them can have performance impacts while real-time requests are also being processed. Before replaying the persisted requests, ensure that bypass rating extension is disabled and the ECE nodes are up and running. To check if bypass rating is stopped, click BFTRunning in ECE MBeans.

To replay the persisted requests into ECE:

  1. Access the ECE configuration MBeans in a JMX editor, such as JConsole. See "Accessing ECE Configuration MBeans".

  2. Expand the DiameterGateway node.

  3. Expand BFTTask.

  4. Expand Operations.

  5. Click persistedMessageCount to view the number of requests that have been persisted and are ready for replay.

  6. Click startBFTReplayer.

    The replayer starts replaying the persisted messages to the ECE charging servers. As messages are replayed to the servers, the number of persistedMessageCount keeps decreasing until it becomes 0.

    The replayedMessageCount field shows the number of requests that are being replayed. As requests are replayed, the number of replayedMessageCount keeps increasing until it matches the initial count of persistedMessageCount.

You stop replaying the messages once all the persisted messages are replayed into the ECE charging servers.

To stop replaying the persisted messages:

  1. Check the status of the replayer by clicking BFTReplayerRunning. Ensure that this field shows Running.

  2. Check the status of the replayedMessageCount field. Ensure that this field shows 0, which indicates that all the persisted messages are replayed into the ECE charging servers.

    • replayedMessageCount indicates the number of Diameter messages that are replayed to the ECE charging server by the current instance of Diameter Replayer.

    • persistedMessageCount indicates the number of Diameter messages that have been persisted to the Oracle NoSQL database, but are yet to be replayed.

  3. Click stopBFTReplayer.

    Replaying of messages is stopped.

Configuring How ECE Manages Active Sessions When Network Elements Fail

When a network element associated with active sessions in ECE fails, ECE receives an accounting on/off request from the network element. You can configure ECE to cancel or terminate active sessions when processing accounting on/off requests.

To configure how ECE manages active sessions when network elements fail:

  1. Access the ECE configuration MBeans in a JMX editor, such as JConsole. See "Accessing ECE Configuration MBeans".

  2. Expand the ECE Configuration node.

  3. Expand charging.server.

  4. Expand Attributes.

  5. Set the accountingOnOffMode attribute to one of the following values:

    • TERMINATE: Active sessions with an Initiated state are terminated when an accounting on/off request is processed.

    • CANCEL: Active sessions with an Initiated state are canceled when an accounting on/off request is processed.