Configuring Cloud-Served Standalone Licenses

To configure a cloud-served standalone license, you need to enter your entitlement ID during installation or run the License Activation utility (ulic) after installing Uniface.

Before you begin:

  • You must have an internet connection to activate and periodically renew the license.
  • You must have the Entitlement ID for your license. This ID allows Enterprise Edition users to configure their Uniface clients to directly connect to the SCC.

Configure the License

To configure this license, you can do either of the following:

  • Enter your Entitlement ID when prompted during installation.
  • Manually run the License Activation utility (ulic) from the Start menu (Windows only) and follow the prompts, or run /act {EntitlementId} from the command line. For more information, see Uniface License Management Utility (ulic)

Your license is registered under the name of the machine you are using to activate the license. You can optionally change this to a friendly name that has more meaning to you.

To add a friendly name, you can do either of the following:

Note: The friendly name is restricted to 30 characters, containing letters, digits, underscores, and hyphens.

Once you have set the friendly name, you can no longer edit it. To change the friendly name, return all activated Entitlements and empty the license folder. This is specified by USYSLIC in usys.ini. You can set a new friendly name when reactivating your Entitlement(s).

Enable Multiple Entitlement IDs

You can enable additional Entitlement IDs by entering a new Entitlement ID in the License Activation utility or using the command line. These must be entered and activated one at a time.

Note: You can only activate multiple Entitlement IDs from the same Customer ID.

Configure Entitlements for Uniface Servers

For new installations, the Uniface Router is configured to act as the cloud-served license client that periodically downloads the cloud-served license from the SCC, while the Uniface Server(s) check out the license as a standalone license file. This improves performance in environments with multiple Uniface Servers.

In upgraded versions of Uniface, you can configure this manually:

  1. In the urouter.asn file, set $LICENSE_OPTIONS as follows:
    $LICENSE_OPTIONS LM_LICENSE_FILE=USYSLIC:
  2. In the Uniface Server assignment file(s), set $LICENSE_OPTIONS as follows:
    $LICENSE_OPTIONS LM_LICENSE_FILE=USYSLIC:lservrc

Note: If $LICENSE_OPTIONS is present in your Uniface Router assignment file, the Uniface Router checks that $LICENSE_OPTIONS configures a cloud-served standalone license, and if it does, the Uniface Router performs the license download. To disable this in a cloud-served environment, remove $LICENSE_OPTIONS entirely, or set $LM_LICENSE_FILE to point to the lservrc file using LM_LICENSE_FILE=USYSLIC:lservrc.

Related Topics