Warning

Modifying any attribute of an activated SWe Traffic Profile is service-impacting because all VMs constituting the redundancy group (1:1 or N:1) will reboot simultaneously. 

Ribbon recommends only modifying unactivated custom profiles. For standard profiles, only the codec profile names are editable.

In this section:

Related articles:

Note

When the SBC is deployed in a 1:1 scenario and registered with the RAMP, you must only configure the SWe Configuration Profiles through the RAMP or EMA.


Note

Changing any parameters of an activated SWe Traffic Profile changes the SWe VM CPU and memory requirements. Use the SWe Capacity Estimator tool to understand the implications of these profile changes.

Use this command to configure custom SWe traffic profiles. Use SBC SWe traffic profiles to characterize the call mix you expect to occur on your SBC SWe system. SBC SWe systems can enhance their VM performance by allocating CPU cores in a manner that maximizes the capacity for the call mix specified in the active traffic profile.

Command Syntax

% set system sweTrafficProfiles <profile name> 
	bhcaPerSubscriber <attempts>
	callHoldTime <seconds>
	cryptoPercent <percent>
	directmediapercent<percent>
	externalRefreshTimer <seconds>
	internalRefreshTimer <seconds>
	isAccess <false | true>
	mediaCostFactor <media factor>
    numAorPerSubscriber <1-200>
	passthroughCodecProfile <profile name>
	processorCapabilityIndexOverride <false | true>
	processorCapabilityIndexOverrideValue <processor factor>
	rxPPSFactor <Rx PPS factor>
	sigCostFactor <signaling factor>
	tonesPercent <percent>
	transcodePercent <percent>
	transcodingCodecProfilec<<profile name>
	txPPSFactor <Tx PPS factor>
	useGPUForTranscoding <false | true>

Command Parameters

The following table represents SWe Traffic Profile parameter descriptions:

ParameterLength/RangeDescription
sweTrafficProfiles1-40 characters

<profile name> – Enter a unique SWe Traffic Profile name.

NOTE: The SBC SWe supports up to 20 SWe Traffic Profiles. To create additional profiles, delete any inactive custom profiles.

bhcaPerSubscriber0-5

<attempts> (default = 1) – Indicates busy hour call attempts (BHCA) per subscriber.

NOTE: This parameter is available when accessScenario = "true".

callHoldTime

10-10800<seconds> – Enter the average call hold time, in seconds, of the call load for this profile. (default = 90)
cryptoPercent0-100

<% value> (default = 0) – The percentage of media sessions (including both transcoding and pass-through) requiring cryptographic treatment. The value is 50 when there is SRTP<->RTP interworking on all calls.

directMediaPercent0-100

<% value> (default 0) – The call load percentage for direct media. The SBC does not convert Direct Media to pass-through calls.

NOTE: Ensure that the combined total percentage of directMediaPercent and transcodePercent does not exceed 100%.

externalRefreshTimer15–86400

<seconds> (default = 1800) – Use this parameter to specify the external registration time, in seconds, towards the AS.

NOTE: The parameter is available only when isAccess is set to "true".

internalRefreshTimer15-86400

<seconds> (default = 1800) – Use this parameter to specify the internal registration time, in seconds, towards the AS.

NOTE: The parameter is available only when isAccess is set to "true".

isAccessN/A

Set this flag to "true" to specify whether the deployment uses an access scenario.

  • false (default)
  • true

NOTE: When set to 'true', internalRefreshTimer, registrationRefreshInterval, and bhcaPerSubscriber parameters are available for configuration.

mediaCostFactor0.0001 to 100Use this parameter to specify a media cost factor to use during capacity estimation. This factor affects the media plane estimation, such as crypto session and pass-through session estimation (default = 1). This parameter is applicable only to custom profiles.

numAorPerSubscriber

1-200

<#> – Enter the number of Address of Records (AoRs) per subscription in an access scenario. This feature calculates the number of RCBs needed to handle all devices per subscription. The default value is 1.

Warning

If you use a value other than the default, the SBC SWe memory occupancy increases since the per-allocation value increases. Ribbon recommends using the SWe Capacity Estimator tool to understand the impact on SBC SWe memory when increasing the number of AORs per subscriber.

passthroughCodecProfileN/A

The name of the codec mix to associate with the Passthrough Codec Profile.

  • G711_20ms
  • G711_G729_20ms
processorCapabilityIndexOverrideN/A

Use this flag to enable/disable index overriding of the default CPU performance computation by the SBC SWe. When set to 'true', the computed indices (which are calculated during system boot-up) are ignored, and the value provided in processorCapabilityIndexOverrideValue attribute is used for all estimations.

  • false (default)
  • true

NOTE: Since use cases for overriding the default computed indices are rare, Ribbon recommends not to set the value of processorCapabilityIndexOverride to "true" to avoid inaccurate session numbers and vCPU computations.

processorCapabilityIndexOverrideValue0.2-10

Use this parameter to specify the computational value to use to override the default computed indices. (default = 1)

NOTE: This parameter is available when processorCapabilityIndexOverride is set to "true". The value given should be in 0.2 to 10.

sigCostFactor0.0001 to 100Use this parameter to specify a signaling cost factor to use during capacity estimation. This factor affects the signaling plane estimation, such as cps estimation (default = 1). This parameter is applicable only to custom profiles.
rxPPSFactor1.0 to 100Use this parameter to specify a received (rx) PPS factor to use during capacity estimation (default = 1). This parameter is applicable only to custom profiles.
tonesPercent0-100<% value> (default = 0) – Use this parameter to specify the percentage of legs to use for tones treatment.
transcodePercent0-100

<% value> (default = 0) – Use this parameter to specify the percentage of call load to use for transcoded calls.

NOTE: The combined total percentage of directMediaPercent and transcodePercent should not exceed 100%.

transcodingCodecProfileN/A

The name of the codec mix to associate with the Transcoding Codec Profile.

  • G711_20ms
  • G711_G729_20ms
txPPSFactor1.0 to 100Use this parameter to specify a transmitted (tx) PPS factor to use during capacity estimation. Use the Rx/Tx parameters for scenarios such as SIPREC where the received/transmitted PPS may not be the same (asymmetric) (default = 1). This parameter is applicable only to custom profiles.

useGPUForTranscoding

 N/A

 Use to specify the type of transcoding, GPU (true) or CPU (false).

  • false (default)
  • true


Command Example

  1. The following CLI command creates a custom SWe Traffic profile named custom that includes media and signaling cost factors and asymmetric Tx/Rx PPS factors to use in generating capacity estimates.
    set system sweTrafficProfiles custom isAccess true callHoldTime 100 passthroughCodecProfile G711_G729_20ms transcodePercent 10 transcodingCodecProfile G711_G729_20ms bhcaPerSubscriber 13 numAorPerSubscriber 15 externalRefreshTimer 1800 internalRefreshTimer 1800
commit

  2. The following CLI command creates a custom SWe Traffic Profile named custom1 that includes media and signaling cost factors and asymmetric Tx/Rx PPS factors to use in generating capacity estimates.

    % set system sweTrafficProfiles custom1 isAccess true bhcaPerSubscriber 2.5 transcodePercent 30 callHoldTime 60 internalRefreshTimer 3000 externalRefreshTimer 2500 tonesPercent 15 processorCapabilityIndexOverride false mediaCostFactor 1.5 sigCostFactor 1.5 txPPSFactor 1.2 rxPPSFactor 1.0
commit

  3. Create a codec mix profile, customCodecMix.

    % set system sweCodecMixProfile customCodecMix g723 p20 percentage 50
% set system sweCodecMixProfile customCodecMix g711 p20 percentage 30
% set system sweCodecMixProfile customCodecMix g729 p10 percentage 20
commit

  4. Attach the codec mix profile to the SWe traffic profile.

    % set system sweTrafficProfiles custom1 passthroughCodecProfile G711_20ms transcodePercent 30 transcodingCodecProfile customCodecMix
commit