6 Configure Overload Protection

Overload Protection (OLP) is a critical feature in Converged Application Server designed to safeguard the Media Feature Engine (MFE) cluster against service degradation or crashes due to unexpected spikes in traffic. Effective OLP configuration helps ensure overall system stability and maintains service availability, even under heavy load conditions.

OLP applies uniformly to all MFEs in the cluster. Oracle strongly recommends enabling Overload Protection to prevent individual MFEs and the collective cluster from being overwhelmed during traffic surges. Proper configuration of OLP thresholds enables intelligent traffic rejection or throttling before system resources are exhausted, enabling graceful degradation instead of abrupt failure. You can configure, add, update, remove, and retrieve Media Feature Engine Overload Protection settings in Converged Application Server through the Remote Console, the REST API, or the WLST.

Remote Console

To add OLP using the Remote Console:

1. In the Edit Tree, navigate to Custom Resources, and then IntelligentMediaConnector, and then Media Connector Configurations, and then MFE Overload Protection, and then Resource Threshold.
2. Click New.
3. Select the resource (CPU, Memory, StreamCount) to protect.
4. Set the upper limit and the lower limit for this resource.
5. Click Create.
6. Click the shopping cart and then Commit Changes.

REST APIS

To add OLP using the REST APIs:

curl -v -X POST \
  -u <username>:<password> \
  -H X-Requested-By:MyClient \
  -H Accept:application/json \
  -H Content-Type:application/json \
  -d '{
  "resourceName": "<CPU|Memory|StreamCount>",
  "min": <lower_limit_integer>,
  "max": <upper_limit_integer>
}' \
  "http://<adminserver_host>:<port>/management/weblogic/latest/edit/customResources/IntelligentMediaConnector/customResource/mediaOverLoadProtection/resourceThresholds/resourceThreshold"

See the Developer Guide for more information about the REST API.

WLST

To add OLP using the WLST:

1. Navigate to the <Domain_Home>/bin directory.
2. Set the environmental variables.

   . ./setDomainEnv.sh

3. Save the following file to a script.

   try:
       connect("<username>", "<password>", "t3://<adminserver_ip>:<port>")
       edit()
       startEdit()
   
       cd('/CustomResources/IntelligentMediaConnector')
       ms = cmo.getResource()
       mop = ms.getMediaOverLoadProtection()
       rtb = mop.getResourceThresholds()
   
       name = '<threshold_name>'  # e.g. CPU / Memory / StreamCount
   
       rt = rtb.lookupResourceThreshold(name)
   
       if rt is not None:
           print "ResourceThreshold already exists:", name
           cancelEdit('y')
           print 'res:0'
           disconnect('true')
           exit('true')
   
       rt = rtb.createResourceThreshold(name)
       rt.setMin(<min_value>)
       rt.setMax(<max_value>)
   
       save()
       activate(block="true")
       print 'res:1'
   
   except Exception, e:
       print e
       dumpStack()
       print 'res:0'
   
   disconnect('true')
   exit('true')

4. Run the script.

   java weblogic.WLST /path/to/file.py