How to Enable Cloud Licensing
Product Application Information
Cloud Licensing applies to:
- Desktop Connect for Microsoft Dynamics
- Desktop Connect for Salesforce.com
Create an Application Server
In order to use the License Management Service, the installation needs to be added as an Application Server by a user with License Owner privileges.
Configure the Installation
Port Requirements
The following ports need to be enabled in order to use cloud licensing
| Port | Direction | Source | Destination | Description |
|---|---|---|---|---|
| 33666 | Out | Desktop Connect | License Management Service | This port is used to connect to the License Management Service in order to consume licenses, the communication over this port is SSL encrypted. |
Permissions
Please make sure the service user running the Apache Tomcat service has read, modify and write permissions on the Tomcat "lib" folder (default: “C:\Program Files\Apache Software Foundation\Tomcat 8.0\lib”)
Connecting to License Management Service
Once the Application Server has been created, the License Management Service generates a connection file, the connection file is digitally signed by the License Management Service.
Follow the steps described below in order to enable connection to cloud licensing system:
Download or request the connection file (named DCLicenseClient.license.signed.xml) from the License Portal or from your license provider.
Copy the connection file to the Desktop Connect Tomcat "lib" folder.
Default location: “C:\Program Files\Apache Software Foundation\Tomcat 8.0\lib”
Restart the Tomcat service hosting Desktop Connect.
Make sure to configure the product allocations, organizations and tenants related to the installation according to the PO/contract/agreement with the customer. Review the License Management Service User Guide for details.
Verify the Connection
When the license file is configured and applied, the Desktop Connect server will connect to the License Management Service.
Verify the connection over the License Management Portal. Check the Connection States a table of the Application Servers Overview article.
Troubleshooting
Perform the following steps to ensure the correct functionality of the licensing:
Ensure Tomcat has been restarted after the connection file was applied.
Ensure the application is able to access the port required to connect to the server.
Collect Tomcat standard out log and send it to customer service (default: “C:\Program Files\Apache Software Foundation\Tomcat 8.0\logs\tomcat8-stdout-[yyyy-mm-dd].log")