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:
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.
Run the installer for your platform.
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.
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:
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:
Restart the Dimensions CM listener service.
To configure APLS for HTTP:
Navigate to the autopass\apls\apls\conf directory.
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"
DM_LICENSEvariable in the dm.cfg server configuration file to the new port, as described earlier in this section. For example:
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.
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.
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:
On a licensed Dimensions CM server, edit the dm.cfg configuration file to add this variable:
As the Dimensions CM administrator, register the
DM_LICENSE_USERpassword 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.
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.