Customizing License Server Configuration
When you install the SRC software and a license for its use, the installation creates a basic configuration for the license server. You can customize this configuration to specify directory and file information required by the license server, tune the notification thresholds for warnings and alarms, tune session settings, and specify an SNMP host and e-mail account to receive notification of warnings and alarms.
The license server properties are located by default in l=config, l=LICSVR, ou=staticConfiguration, o=Management, o=umc.
To use SDX Configuration Editor to configure SAE properties for the license server:
- In the navigation pane, select a project, then LICSVR, and click config.xml.
- In the content pane, select the License Server tab.
The License Server tab appears in the content pane.
![]()
- In the License Server tab, expand each section to change the configuration for the license server. See:
- Alarm Fields
- ORB Configuration Property File Field
- License Server Repository Fields
- License Server Engine Fields
- Location of the License Server Fields
Alarm Fields
The license server provides notifications when licensing thresholds are exceeded. Table 10 describes the conditions that prompt a warning or an alarm.
The license server continues to run during a critical alarm state but denies all requests for licenses. The license server clears the alarm when the alarm is no longer active.
You can configure the license server to send warnings and alarms, and can configure an SNMP host to receive the warnings and alarms. Note that the SAE SNMP agent takes no action when it receives any of these traps. You must determine appropriate measures to resolve these warning states.
For information about traps, see SRC-PE Monitoring and Troubleshooting Guide, Chapter 10, Understanding Traps.
Use the alarm configuration to define the threshold at which an alarm is generated and how system administrators are notified of the alarms.
![]()
Alarm Threshold
- A threshold as a percentage of licensed capacity that, when exceeded, sends SNMP minor traps and initiates e-mail alerts to the system administrator.
- Value—Integer in the range 0-100
- Default—80
- Property name—ConfGroupAlarm.LicenseServer.alarm.threshold
Report Server
- SNMP server to receive warning traps.
- Value—IP address or hostname
- Default—No value
- Property name—ConfGroupAlarm.LicenseServer.alarm.report.server
Email Server
- Optional SMTP e-mail server to receive alarms.
- Value—IP address or hostname
- Default—No value
- Property name—ConfGroupAlarm.LicenseServer.alarm.email.server
Email Account
- E-mail address of the system administrator to receive warning e-mail messages.
- Value—E-mail address
- Default—No value
- Property name—ConfGroupAlarm.LicenseServer.alarm.email.account
ORB Configuration Property File Field
Use the CORBA configuration to define the location of the property file for the object request broker (ORB).
![]()
ORB Configuration Property File
- ORB configuration property file.
- Value—<filename>
- Default—etc/jacorb.properties
- Property name—ConfGroupClient.LicenseServer.corba.config
License Server Repository Fields
Use the License Server Repository configuration to set the directory access information for the license server.
![]()
LDAP Server Address
- IP address of the LDAP server that stores licensing data.
- Value—IP address or hostname.
- Guideline—This is a required property. If no value is assigned, the license server does not start.
If this value is removed while the license server is running, the server rejects licensing requests. After a new value is entered and the license server connects to the LDAP server, the license server accepts license requests again.
Server Port
- Port of the LDAP server that stores licensing data.
- Value—Integer in the range 0-65535
- Default—389
- Property name—ConfGroupLic.LicenseServer.lic.ldap.server.port
Search Base
- Base directory of the LDAP server that stores licensing data.
- Value—DN
- Default—o=umc
- Property name—ConfGroupLic.LicenseServer.lic.ldap.server.base.dir
Authentication DN
- DN used by the SAE to authenticate access to the LDAP server that stores licensing data.
- Value—DN
- Default—cn=licsvr, ou=Components, o=Operators, o=umc
- Property name—ConfGroupLic.LicenseServer.lic.ldap.server.authDN
Password
- Password used to authenticate access to the LDAP server that stores licensing data.
- Value—<password>
- Default— licsvr
- Property name—ConfGroupLic.LicenseServer.lic.ldap.server.password
License Server Engine Fields
Use the License Server Engine configuration to set general properties for the license server.
![]()
Service Session Unit Size
- Size of each license unit for the service session property; this is the size of the license unit allocated to the SAE.
- Value—Integer in the range 0-65535
- Default—50
- Property name—ConfGroupEngine.LicenseServer.engine.unit-1.size
SAE Service Unit Size
- Size of each license unit for the SAE service property; this is the size of the license unit allocated to the SAE.
- Value—Integer in the range 0-65535
- Default—25
- Property name—ConfGroupEngine.LicenseServer.engine.unit-2.size
Lease Renew Interval
- Lease period for the licenses that the SAE client receives.
- Value—Number of seconds in the range 0-129600
- Guideline—604800 is 1 week; 129600 is 2 weeks.
- Default—604800 (one week)
- Property name—ConfGroupEngine.LicenseServer.engine.lease.period
Allocate License Threshold
- Threshold, as a percentage of the chunk size, at which the SAE client obtains more licenses.
- Value—Integer in the range 0-100
- Default—90
- Property name— ConfGroupEngine.LicenseServer.engine.client.allocate.threshold
Release License Threshold
- Threshold, as a percentage of the chunk size, at which the SAE client releases one license unit.
- Value—Integer in the range 0-100
- Default—10
- Property name—
ConfGroupEngine.LicenseServer.engine.client.release.thresholdLocation of the License Server Fields
Use the Persistent Control configuration to set the root directory and working directory for the license server and to set the status cache file.
![]()
Root Directory
- Root directory of the license server.
- Value—DN
- Default—/opt/UMC/licsvr
- Property name—ConfGroupPersistent.LicenseServer.dir.root
Work Directory of the License Server
- Work directory of the license server, in which license server states are saved.
- Value—Directory path
- Default—var/run
- Property name—ConfGroupPersistent.LicenseServer.dir.var
License Server State Cache File