Uniface License Management Utility (ulic)

The Uniface License Management utility (ulic) is responsible for activating and downloading required Sentinel licenses, for checking out licenses, and renewing the lease on licenses on a regular basis. The licenses themselves are maintained by the Sentinel Cloud Server.

On Windows, the License Activation and License Return tools provide an interactive user interface for the License Management utility, enabling you to easily activate and return Sentinel licenses. These tools can be found in the Uniface program group of the Start menu.

The License Management utility is also available as a command line interface (ulic).

On non-Windows platforms, the command line interface must be used.

Command Line Interface

The command line interface enables you to run the Uniface License Management utility in batch mode.

On Windows, you must disable the default user interface by explicitly specifying /bat. For example:

ulic /bat /act

On non-Windows platforms, /bat is the default and the EntitlementId argument is mandatory when activating or returning licenses.

ulic /act 77259e95-d153-4a4b-aa27-a62fadcefb97

Commands

/act {EntitlementId}

Starts the Activate license form; if EntitlementId is specified, it is used to fill in the Entitlement Id field.

Note: To activate multiple entitlements, run the /act command for each Entitlement ID that needs to be activated.

/ret {EntitlementId}

Starts the Return license form; if EntitlementId is specified, it is used to fill in the Entitlement Id field.

/prep

Prepares the system for licensing by creating persistence data (must be run as Administrator or Root). For more information on when to use /prep, see Creating Persistence Data with ulic /prep.

Note: /prep must be run as a single command. Run ulic with /prep only before performing your next action.

/q

Makes /act and /ret quit immediately upon successful completion. This is used by the IDE when it runs the Uniface License Management utility so it can immediately start after the utility completes.

/fn={friendlyname}

Adds a friendly name for your machine. This is a human readable fingerprint used to uniquely identify your machine in the EMS customer portal, and store it in the SCC database. You can change this to something that is meaningful to you. The friendly name is restricted to 30 characters, containing letters, digits, underscores, and hyphens.

/fp={filename}

Generates a fingerprint for a machine that contains an RMS License Manager (Server). A valid file path and file name must be provided. The output is an XML file that you can upload to the EMS customer portal to manually register a fingerprint and download your license file.

/repair {so | net | tmso | tmnet | com FEATURE VERSION}

In the case that persistent storage is not created or is corrupted, /repair can be run to perform a persistent storage repair. It must be must be run as Administrator or Root. Running /repair on its own will run repair code for standalone licenses, network licenses, and time tampering, in the case of changes to the system clock.

You can also run /repair with an optional flag to repair just one type of persistent storage:

  • /repair so—performs a repair for a standalone license.
  • /repair net—performs a repair for a network license.
  • /repair tmso—performs a reset for time tampering with a standalone license.
  • /repair tmnet—performs a reset for time tampering with a network license.
  • /repair com FEATURE VERSION—performs a reset for a commuter license. Run this command individually for each feature and its version that has been commuted.

Note: /prep automatically runs /repair with the so, net, tmso, and tmnet flags if it fails to create persistent storage. If corruption occurs at a later stage, use /repair on its own or with the relevant flag to repair your persistent storage

Qualifiers for /act and /ret

You can provide additional information using the following qualifiers:

/proxy={ none | manual | auto }

If /proxy is not specified, it defaults to none for /act, and the values recorded in the configuration file for /ret.

If /host, /port, /user, or /password is specified /proxy defaults to manual, so /proxy=manual doesn't need to be specified.

/host=HostName

/port=PortNr

/user=Username

/password=Password

Examples

  • Activate entitlement ID 123456abcd, with no proxy server:
    ulic /bat /act 123456abcd

    /proxy=none is default for /act

  • Activate entitlement ID 123456abcd, with proxy server proxyhost:
    ulic /bat /act 123456abcd /host=proxyhost /port=8088 /user=proxyuser /password=secret

    /proxy=manual is implied by the use of /host, /port, /user or /password

  • Activate entitlement ID 123456abcd, with system proxy settings:
    ulic /bat /act 123456abcd /proxy=auto
  • Activate entitlement ID 123456abcd, and add the friendly name MyWorkPC:
    ulic /fn=MyWorkPC /act 123456abcd
  • Return license for entitlement ID 123456abcd, using the proxy settings that were in effect when the license was activated:
    ulic /bat /ret 123456abcd

    /proxy=none is not the default for /ret

  • Return entitlement ID 123456abcd, with no proxy server:
    ulic /bat /ret 123456abcd /proxy=none
  • Return entitlement ID 123456abcd, with proxy server proxyhost:
    ulic /bat /ret /host=proxyhost /port=8088 /user=proxyuser /password=secret 23456abcd
  • Generate fingerprint XML file fingerprint.xml for the RMS Server on Windows:
    ulic /bat /fp=C:\MyDir\fingerprint.xml
  • Generate fingerprint XML file fingerprint.xml for RMS on Unix:
    ulic /bat /fp=/home/user/fingerprint.xml

Related Topics