Dimensions CM licensing

You can manage Dimensions CM licenses with either the Micro Focus AutoPass License Server (APLS) or SLM. This section explains how to set up and use the AutoPass License Server.

To license Dimensions CM with SLM, see Administering Licenses and the License Server in the Administration Guide.

Set up the AutoPass License Server

To manage licenses with AutoPass, install and configure the AutoPass License Server (APLS).

To install and configure APLS:

  1. Download the AutoPass License Server from the Micro Focus ITOM Marketplace (requires login).

    Note: Dimensions CM 14.5.3 and later uses AutoPass 11.7.0 or later.

  2. Run the installer for your platform.

  3. Open the APLS web interface and configure the server. For details, see the AutoPass License Server documentation.

Alternatively, you can set up APLS as a Docker image. For details, see the Docker documentation.

Back to top

Configure Dimensions CM to use AutoPass

After installing the AutoPass License Server (APLS), configure the Dimensions CM server to use APLS.

If APLS is installed on the same machine as the Dimensions CM server, you may configure APLS to use HTTP.

Note: If you installed Dimensions CM with an evaluation option, it is valid for 30 days, and no configuration is required. To use Dimensions CM after the evaluation period expires, upgrade to a full license and configure Dimensions CM to use AutoPass.

To update the Dimension CM configuration with AutoPass details:

  1. On each licensed Dimensions CM server, edit the dm.cfg configuration file to add the AutoPass License Server URL:


    where <APLS-URL> is the URL of your AutoPass License Server, for example:

    DM_LICENSE https://apls:5814/autopass

  2. Restart the Dimensions CM listener service.

To configure APLS for HTTP:

  1. Navigate to the autopass\apls\apls\conf directory.

  2. Edit the server.xml configuration file to uncomment the connector block containing port 8080. If needed, change the port to avoid conflict with Micro Focus Common Tools that use port 8080 by default.

    Copy code
    <Connector port="8080" protocol="HTTP/1.1" 
        redirectPort="8443" />
  3. Set the DM_LICENSE variable in the dm.cfg server configuration file to the new port, as described earlier in this section. For example:

    DM_LICENSE https://apls:8080/autopass

  4. Restart the APLS service.

This way, you use port 5814 to access the APLS web interface and manage licenses, and port 8080 (or the port you specified) to connect Dimensions CM to APLS.

Back to top

Install a license

After configuring the AutoPass License Server (APLS) and obtaining a license key, install the license in APLS.

To install a license:

1. Open the APLS web interface.

2. Navigate to License > Install.

3. Add your license key. For details on installing licenses, see the AutoPass License Server documentation.

If you use named licenses, you can manually assign them to specific users or enable APLS to distribute named licenses automatically. For details, see Assign named licenses to users.

Back to top

Assign named licenses to users

You can enable the AutoPass License Server (APLS) to automatically assign named licenses to any new user who accesses Dimensions CM.

Before configuring automatic registration, you need to set up the APLS username and password.

To assign named licenses automatically:

  1. On a licensed Dimensions CM server, edit the dm.cfg configuration file to add this variable:


  2. As the Dimensions CM administrator, register the DM_LICENSE_USER password in the dmpasswd utility:

    dmpasswd DM_LICENSE_USER –add

To assign named licenses manually in the APLS web interface, see the AutoPass License Server documentation.

Back to top

View license information

You can view license usage, expiry dates, capacity, and sharing details in the APLS web interface.

To view license information:

1. Open the APLS web interface.

2. Navigate to Usage and Report > License Usage. The page displays an overview of license types.

3. To view the usage for a particular license, click the license type.

Back to top

See also: