Important Note: The License built-ins are supposed to be used internally only, that is, by the License Subsystem in the Kernel module which provides hooks for modules requiring licenses. They are not meant to be used by 3rd party developers. At present the licensing functionality depends on SafeNet. However, that may change in the future.

The License package provides services for retrieving and managing licenses for the Content Server and modules that require separate licenses. The major functionalities offered in the License Package are the following:

ApplyCoreLicense() Loads and validate a license file and sets it as the Content Server core license.
ApplyModuleLicense() Loads and validates a module license file and sets it as a module license.
GenerateFingerprint() Generates a fingerprint string for the installed system.
GenerateReportHash() Returns a hash generated from the license data.
GetCoreLicenseInfo() Gets information from the Content Server core license.
GetLicensedApplications() Returns a list of licensed applications.
GetLicenseFeatureName() Returns the feature name for the license.
GetLicenseInfo() Gets the information from a license content string or a license file path.
GetLicenseLogString() Returns a string containing the license info for each license.
GetModuleLicenseInfo() Gets information from a Content Server module license.
GetNumActiveUsers() Returns the number of active users in the system.
ValidateCoreLicense() Validates the Content Server core license.
ValidateModuleLicense() Validates a Content Server module license.

Class Attributes

APPLIST_ERROR

License Error: Error getting application list.

BAD_FINGERPRINT

License Error: Invalid application fingerprint.

BAD_LICENSEFORMAT

License Error: Bad license format.

BAD_VERSION

License Error: Invalid application version.

CANNOT_READ_FILE

License Error: Cannot read license file.

EXPIRED

License Error: Expired License.

FINGERPRINT_ERROR

License Error: Error generating fingerprint.

INFO_ERROR

License Error: Failed to get license information.

INVALID

License Error: Invalid license.

LOGIN_ERROR

License Error: Error getting database login.

NONPRODUCTION_LICENSE

Nonproduction License Type: 1

NOT_FOUND

License Error: No license found.

NUMUSER_ERROR

License Error: Error getting number of active users.

PRODUCTION_LICENSE

License Error: Error getting number of active users.

SAVE_ERROR

Production License Type: 2.

SQL_ERROR

License Error: Error getting SQL object.

TEMPORARY_LICENSE

Temporary License Type: 0.

THREADLOCK_ERROR

License Error: System is busy and cannot read license. Please try again.

TOO_MANY_USERS

License Error: Maximum number of users exceeded.

UNKNOWN_ERROR

License Error: Unknown error.

VALIDATION_ERROR

License Error: Error validating license.

Class Methods

ApplyCoreLicense( String license, Boolean isFilePath )

Loads and a validate license file and sets it as the Content Server core license

ApplyModuleLicense( String licenseFile, String applicationKey, String version, Integer numActiveUsers )

Loads and validates a module license file and sets it as a module license.

GenerateFingerprint( )

Generates a fingerprint string for the installed system.

GenerateReportHash( String licenseContent )

Returns a hash generated from the license data.

GetCoreLicenseInfo( )

Gets information from the Content Server core license.

GetLicensedApplications( )

Returns a list of licensed applications.

GetLicenseFeatureName( String licenseContent )

Returns the feature name for the license.

GetLicenseInfo( String license, String version, Integer numActiveUsers )

Gets the information from a license content string or a license file path.

GetLicenseLogString( Assoc moduleInfo )

Returns a string containing the license info for each license.

GetModuleLicenseInfo( String applicationKey )

Gets information from a Content Server module license.

GetNumActiveUsers( )

Returns the number of active users in the system.

ValidateCoreLicense( )

Validates the Content Server core license

ValidateModuleLicense( String applicationKey, String version, Integer numActiveUsers )

Validates a Content Server module license.

Class Attributes

Integer APPLIST_ERROR

License Error: Error getting application list.

Integer BAD_FINGERPRINT

License Error: Invalid application fingerprint.

Integer BAD_LICENSEFORMAT

License Error: Bad license format.

Integer BAD_VERSION

License Error: Invalid application version.

Integer CANNOT_READ_FILE

License Error: Cannot read license file.

Integer EXPIRED

License Error: Expired License.

Integer FINGERPRINT_ERROR

License Error: Error generating fingerprint.

Integer INFO_ERROR

License Error: Failed to get license information.

Integer INVALID

License Error: Invalid license.

Integer LOGIN_ERROR

License Error: Error getting database login.

Integer NONPRODUCTION_LICENSE

Nonproduction License Type: 1

Integer NOT_FOUND

License Error: No license found.

Integer NUMUSER_ERROR

License Error: Error getting number of active users.

Integer PRODUCTION_LICENSE

License Error: Error getting number of active users.

Integer SAVE_ERROR

Production License Type: 2.

Integer SQL_ERROR

License Error: Error getting SQL object.

Integer TEMPORARY_LICENSE

Temporary License Type: 0.

Integer THREADLOCK_ERROR

License Error: System is busy and cannot read license. Please try again.

Integer TOO_MANY_USERS

License Error: Maximum number of users exceeded.

Integer UNKNOWN_ERROR

License Error: Unknown error.

Integer VALIDATION_ERROR

License Error: Error validating license.

Class Methods

ApplyCoreLicense

Integer ApplyCoreLicense( String license,
Boolean isFilePath )

Loads and validate a license file and sets it as the Content Server core license.

Parameters

license

the license content or the full path and name of the license file.

isFilePath

TRUE - file path, FALSE - license content.

Returns:

Zero if successful; Error otherwise.

ApplyModuleLicense

Integer ApplyModuleLicense( String licenseFile,
                            String applicationKey,
                            String version,
                            Integer numActiveUsers )

Loads and validates a module license file and sets it as a module license.

Parameters

licenseFile

Full path and name of the license file.

applicationKey

string identifier for the module.

version

module version.

numActiveUsers

the number of active users for the module.

Returns:

Zero if successful; Error otherwise.

GenerateFingerprint

String GenerateFingerprint()

Generates a fingerprint string for the installed system.

Returns:

A string containng the generated fingerprint if successful; Error otherwise.

GenerateReportHash

String GenerateReportHash( String licenseContent )

Returns a hash generated from the license data.

Parameters

licenseContent

                Contents of a license file.

Returns:

a string containing the report hash if successful; Error otherwise.

GetCoreLicenseInfo

Assoc GetCoreLicenseInfo()

Gets information from the Content Server core license.

Returns:

Error if error occurred; otherwise an assoc with the following structure:

ActiveFingerprint String

ActiveVersion String

CustomerName String

EndUserCode String

ExpirationDate Date

LicensedFingerprint String

LicensedVersion String

LicensedType String

NumActiveUsers Integer

NumLicenedUsers Integer

ProductName String

SalesKitInfo String

Status Integer

SUID String

TypeName String

GetLicensedApplications

List GetLicensedApplications()

Returns a list of licensed applications.

Returns:

A list of licensed applications.

Example

    Calling the function on a CS with its WebReports licensed will return a list: 
    {'Content_Server','CSAOTPERSPECTIVEMGR','WebReports'}

GetLicenseFeatureName

String GetLicenseFeatureName( String licenseContent )

Returns the feature name for the license.

Parameters

licenseContent

Contents of a license file.

Returns:

A string containing the feature name if no errors; Error otherwise.

Example

    Calling the function with a WebReport license content will return 'WebReports'.

GetLicenseInfo

Assoc GetLicenseInfo( String license,
String version,
Integer numActiveUsers )

Gets the information from a license content string or a license file path.

Parameters

license

Contents of a license file.

version

The version of the running system.

numActiveUsers

optional - The number of active users of the running system.

Returns:

Example

        A sample valid result is given below:

         A<1,?,
            'ActiveFingerprint'='47723CB3',
            'ActiveVersion'='16.0.0',
            'CustomerName'='OpenText Internal Use Only ',
            'EndUserCode'='EU0025397',
            'ExpirationDate'=D/1900/1/0:0:0:0,
            'LicensedFingerprint'='',
            'LicensedVersion'='16.0.0',
            'LicenseType'=1,
            'NumActiveUsers'=7,
            'NumLicensedUsers'=100000,
            'ProductName'='OpenText Content Server',
            'SalesKitInfo'='',
            'Status'=0,
            'SUID'='48382-38294',
            'TypeName'='Non-production'>

GetLicenseLogString

String GetLicenseLogString( Assoc moduleInfo )

Returns a string containing the license info for each license.

Parameters

moduleInfo

An Assoc containing applications.

Returns:

A string containing the license info for each license.

GetModuleLicenseInfo

Assoc GetModuleLicenseInfo( String applicationKey )

Gets information from a Content Server module license.

Parameters

applicationKey

string identifier for a module.

Returns:

GetNumActiveUsers

Integer GetNumActiveUsers()

Returns the number of active users in the system.

Returns:

An integer representing the number of active users or Error if error occurred.

ValidateCoreLicense

Integer ValidateCoreLicense()

Validates the Content Server core license.

Returns:

Zero if success; Error otherwise.

ValidateModuleLicense

Integer ValidateModuleLicense( String applicationKey,
String version,
Integer numActiveUsers )

Validates a Content Server module license.

Parameters

applicationKey

A string identifier for the module.

version

module version.

numActiveUsers

number of active useres for the module.

Returns:

Zero if success; Error otherwise.

ActiveFingerprint	String
ActiveVersion	String
CustomerName	String
EndUserCode	String
ExpirationDate	Date
LicensedFingerprint	String
LicensedVersion	String
LicensedType	String
NumActiveUsers	Integer
NumLicenedUsers	Integer
ProductName	String
SalesKitInfo	String
Status	Integer
SUID	String
TypeName	String