Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

Excerpt Include
7.0 Licensing Common Note
7.0 Licensing Common Note
nopaneltrue

When operating in domain license mode, use the licenseRequired table to restrict specific node instances to a subset of a domain's licensed capacity, if needed. Entries in the License Required table are optional when using network-wide domain licensing (NWDL) and, when present, the entries specify limits on the license capacity allowed for the node. By default no limits are configured; the absence of entries in the License Required table indicates that the node is entitled to use the entire capacity assigned to the SBC cluster.

If you choose to specify any restrictions then you must configure appropriate limits for all counted features and also include entries in the License Required table for any on/off features you want to enable. If the License Required table contains a limit for any feature, any other features that are not included in the table are treated as having a license count of 0 and are effectively disabled. If you are using the full-capacity licensing option enabled by the SBC-CAPACITY-D license key, then any maxCount values you specify in License Required table entries are ignored.

 

 

Use the licenseRequired table to specify the feature licenses that the

Spacevars
0product
 will request from the Site License Server (SLS) when the
Spacevars
0product
 is operating in a network wide license deployment.

Services enabled by a counted license can be configured with a minCount and a maxCount value. When these values are equal, the

Spacevars
0product
 requests and retains that number of licenses at the
Spacevars
0product
 irrespective of demand for the license. When the values for these fields are different, the
Spacevars
0product
 maintains the number of licenses configured in minCount irrespective of demand, and it will never request more licenses than the configured maxCount value.

Info
titleNote

This command applies only when network license mode is active from a prior release.

 

Command Syntax

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

Command Parameters

Info
titleNote

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

Hide

The following note was removed from licenseRequired description based on Shambhu's directive to remove mention of the license. It may be added back in the future.

Note: When SBC-CAPACITY is present in the licenseRequired table, only one token of each configured license will be sought from the license server. After a token is retrieved, the associated service is activated to full capacity and there is no further interaction between the SBC and license server.

Caption
0Table
1License Required Parameters
3License Required Parameters
ParameterLength/RangeDescription
licenseRequiredN/A

<feature name> – The licensing feature name.

<featureName> – license keys for each licensed feature:

  • DSP-AMRNB

  • DSP-AMRWB

  • DSP-EVRC

  • DSP-EVS

  • DSP-G722

  • DSP-SILK

  • ENCRYPT

  • POL-BASE

  • SBC-1X10GMP

  • SBC-4X1GMP

  • SBC-CAPACITY

  • SBC-LI

  • SBC-MRF-RTU

  • SBC-NICEREC

  • SBC-P-DCS-LAES

  • SBC-POL-E911

  • SBC-POL-ENUM

  • SBC-POL-RTU

  • SBC-RTU

  • SBC-SIP-I

  • SBC-SIP323

  • SBC-SIPREC

  • SBC-VIDEO

  • SRTP

  • SWE-INSTANCE

  • VDSP-RTU

minCount1–256000

Use this parameter to specify the minimum number of licenses the

Spacevars
0product
will request from the SLS to retain at the
Spacevars
0product
(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

Spacevars
0product
to verify the availability of the feature license. When minCount is configured for a service that is already active, the
Spacevars
0product
immediately requests the additional licenses required to reach the configured minimum count. If the licenses that are present at the
Spacevars
0product
have already surpassed the configured minimum, the
Spacevars
0product
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
Spacevars
0product
is running below the configured minimum count for the associated license.
maxCount2–1000000, or "unlimited"

Use this parameter to specify the The maximum number of licenses the

Spacevars
0product
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
Spacevars
0product
does not reject existing sessions using the license, and throttles new attempts requiring the license to the newly configured limit. 
uses of the licensed feature allowed for the node within what is allowed for the domain. If you specify a limit for any feature, you must include an entry for each feature you want to enable, including features that are not counted (on/off features) or counted features that you do not want to limit. For features that you want to enable but do not need to restrict, it is not necessary to specify the maxCount parameter because its default value is unlimited.

If the

Spacevars
0product
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
Spacevars
0product
drop below the configured maximum.

Command Example

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

 

Pagebreak