Use the licenseRequired table to specify the feature licenses that the SBC will request from the Site License Server (SLS) when the SBC is operating in a network wide license deployment with the licenseMode configured as "network".

Services enabled by a counted license can be configured with a minCount and a maxCount value. When these values are equal, the SBC requests and retains that number of licenses at the SBC irrespective of demand for the license. When the values for these fields are different, the SBC maintains the number of licenses configured in minCount irrespective of demand, and it will never request more licenses than the configured maxCount value.

Note

This command applies to Network Licensing is active (licenseMode is set to 'network'). Refer to License Mode - CLI for configuration details.

 

Command Syntax

% set system licenseRequired <feature name>
	maxCount <2-1000000, or "unlimited">
	minCount <1-256000>

 

Command Parameters

Note

The minCount and maxCount parameters are not configurable for services controlled by instance licenses. These services are enabled system-wide when a single token of the feature license is present at the system

License Required Parameters

ParameterLength/RangeDescription
licensesRequiredN/A

<feature name> – The licensing feature name.

minCount1–256000

Use this parameter to specify the minimum number of licenses the SBC will request from the SLS to retain at the SBC (regardless of demand) when the associated license is first configured. (Default = 1)

When the minCount is set to the default value of "1", one license is requested from the SLS and retained at the SBC to verify the availability of the feature license. When minCount is configured for a service that is already active, the SBC immediately requests the additional licenses required to reach the configured minimum count. If the licenses that are present at the SBC have already surpassed the configured minimum, the SBC does not make any additional license requests.

If a configured minimum count is not available at the SLS, the alarm sonusSbxMinimumLicenseCountThresholdNotReached is raised to indicate the SBC is running below the configured minimum count for the associated license.

maxCount2–1000000, or "unlimited"

Use this parameter to specify the maximum number of licenses the SBC can request from the SLS. (Default = 'unlimited')

If the system is utilizing licenses and the maxCount is reconfigured to a value less than the licenses already in use, the SBC does not reject existing sessions using the license, and throttles new attempts requiring the license to the newly configured limit. 

If the SBC is operating above the configured threshold, the alarm sonusSbxMaximumLicenseCountThresholdExceeded is raised. This condition restricts further use of the licensed feature until the number of licenses at the SBC drop below the configured maximum.

Command Example

set system licenseRequired SBC-PSX-RTU minCount 10 maxCount 100
commit
 
show details system licenseRequired
licenseRequired SBC-PSX-RTU {
    minCount 10;
    maxCount 100;
}
[ok]