Dimensions CM licensing
To manage Dimensions CM licenses, you need the OpenText™ AutoPass License Server (APLS). This topic explains how to set up and work with APLS.
Note: Dimensions CM no longer supports licensing with SLM.
Step 1: Set up AutoPass
To manage licenses in Dimensions CM, install and configure the AutoPass License Server (APLS).
To install and set up APLS:
Download the AutoPass License Server files from the ITOM Marketplace (requires login).
For details about supported versions, see the Support Matrix.
Run the installer for your platform.
Open the APLS web interface and configure the server. For details, see the AutoPass License Server help.
Alternatively, you can set up APLS as a Docker image. For details, see the Docker help.
Step 2: Configure for AutoPass
By default, APLS is set up to accept connections via HTTPS only. After you install APLS, configure Dimensions CM to use AutoPass.
Note: You can install Dimensions CM with an evaluation option which is valid for 30 days and doesn't require additional configuration. Select the evaluation option during installation, or specify the DM_LICENSE variable in the server's dm.cfg configuration file:
After the evaluation period expires, you need to upgrade to a full license and configure Dimensions CM to use AutoPass.
If installing APLS on the same machine as Dimensions CM, you can use the sample localhost certificate. To use APLS on a remote machine, you need to configure APLS with a signed SSL certificate.
To use AutoPass on the same machine as Dimensions CM:
|Clean Dimensions CM installation
When running the installation, accept the default license server URL:
For installation details, see Install Dimensions CM.
|Dimensions CM upgrade
To use AutoPass on a remote machine:
Obtain a signed SSL certificate and install it on the APLS server. For details, see the AutoPass License Server help.
Copy the content of the APLS SSL certificate and add it to the cacerts.pem file located in the %DM_ROOT%/dfs folder.
The .pem file is a text file that contains multiple BEGIN CERTIFICATE and END CERTIFICATE sections.
Open the dm.cfg configuration file on the Dimensions CM server. Then add or edit the variable DM_SSL_TRUST_CERTS_FILE:Copy code
For more information on configuring and validating SSL certificates, see the validating SSL certificates section in Administration.
Step 3: Obtain license
To obtain a Dimensions CM license, you need the AutoPass Lock Code.
To obtain a license:
Get the AutoPass Lock Code.
In the APLS web interface, navigate to License > Install.
Copy the alpha-numeric value displayed in the Lock Code field.
Visit the Software Licenses and Downloads (SLD) portal (requires login) and use the Lock Code to generate a license key.
For details, see the Knowledgebase article KM000005202.
Step 4: Install license
After configuring the AutoPass License Server (APLS) and obtaining a license key, install the license in APLS.
To install a license:
Open the APLS web interface.
Navigate to License > Install.
Add the license key file you obtained from the SLD portal. For details on installing licenses, see the AutoPass License Server help.
If you use named licenses, you can assign them to specific users manually or enable APLS to distribute named licenses automatically. For details, see Step 5: Assign licenses.
You can enable AutoPass 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:Copy code
As the Dimensions CM administrator, register the DM_LICENSE_USER password in the dmpasswd utility:Copy code
dmpasswd DM_LICENSE_USER –add
To assign named licenses manually in the APLS web interface, see the AutoPass License Server help.
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.