Skip to main content

Dynamics 365 License Management

Licenses are required for both the Catalog Service and the Rule Execution Service. Whether you're deploying the Online or On-Prem solution will determine the appropriate method for activating your InRule licenses. For Online installations, you will have an Azure license file provided to you by InRule which can be uploaded either through Azure's App Service Editor tool or via FTP. Walkthroughs of both means are provided below.

For On-Prem solutions, you will need to leverage the InRule License Activation Utility. A walkthrough of this process can be found here.

Uploading a License File​

Azure App Service Editor​

To upload the InRule license file to your execution service or your catalog service, navigate to the Azure portal and to the appropriate app service. On the left-hand nav-bar, scroll down until you find the App Service Editor option, under the Development Tools header:

Development Tools menu with Clone App, Console, Advanced Tools, App Service Editor (Preview), and Extensions, App Service Editor highlighted

On the resulting page, press Go

App Service Editor (Preview) page with the Go button highlighted

From here, you'll need to navigate to the appropriate file location, which is different depending on if you're adding it for the Execution Service or the Catalog Service:

Execution ServiceCatalog Service
Expand the app_data folder and navigate to its inner most directory. Select the InRule.Webjob folder and right-click, then select Upload File:

App Service Editor file explorer with app_data > Jobs > Continuous > InRule.Crm.WebJob right-click context menu open and Upload Files highlighted

Find your InRuleLicense.xml file wherever you have it stored and select Open to finish.
Right-click anywhere in the top level of the wwwroot directory, then select Upload File:

App Service Editor file explorer with the wwwroot directory's right-click context menu open and Upload Files listed

Find your InRuleLicense.xml file wherever you have it stored and select Open to finish.

With that, your license file should be uploaded and usable by your Rule Execution or Catalog Service.

FTP​

This example leverages Azure CLI in addition to PowerShell commands. If you intend to use this method, please run the CLI from PowerShell.

Alternative approaches using just PowerShell should be possible but are not detailed in this document.

First, retrieve the FTP deployment profile (url and credentials) with the az webapp deployment list-publishing-profiles command and put the values into a variable:

# Example: az webapp deployment list-publishing-profiles --name contoso-execution-prod-wa --resource-group inrule-prod-rg --query "[?contains(publishMethod, 'FTP')].{publishUrl:publishUrl,userName:userName,userPWD:userPWD}[0]" | ConvertFrom-Json -OutVariable creds | Out-Null

az webapp deployment list-publishing-profiles --name WEB_APP_NAME --resource-group RESOURCE_GROUP_NAME --query "[?contains(publishMethod, 'FTP')].{publishUrl:publishUrl,userName:userName,userPWD:userPWD}[0]" | ConvertFrom-Json -OutVariable creds | Out-Null

Then, upload the license file using those retrieved values:

# Example:
$client = New-Object System.Net.WebClient;$client.Credentials = New-Object System.Net.NetworkCredential($creds.userName,$creds.userPWD);$uri = New-Object System.Uri($creds.publishUrl + "/app_data/Jobs/Continuous/InRule.Crm.WebJob/InRuleLicense.xml"); + $client.UploadFile($uri, "$pwd\InRuleLicense.xml");

$client = New-Object System.Net.WebClient;$client.Credentials = New-Object System.Net.NetworkCredential($creds.userName,$creds.userPWD);$uri = New-Object System.Uri($creds.publishUrl + "/app_data/Jobs/Continuous/InRule.Crm.WebJob/InRuleLicense.xml"); + $client.UploadFile($uri, "LICENSE_FILE_ABSOLUTE_PATH")

Activating Your License Utility​

Activating your license for an On-Prem installation of InRule requires leveraging the InRule Activation Utility. A walkthrough of this process can be found below:

1: Download the License Activation Utility​

Download and install the InRule Activation Utility from support.inrule.com on the server where you intend to deploy the InRule Execution Service.

2: Run the Activation Utility​

Run the activation utility as an Administrator to install Event Log Source.

InRule License Activation Utility 5.1.0 with no activated products, empty Name, Organization, and License Key(s) fields, and the Event Log Source Uninstall button

3: Find Your License Keys​

Go to support.inrule.com and select Licensing Info on the left-hand navigation bar to find your irServer license keys. Which one(s) you'll need are dependent on what environment you intend to setup your InRule components in.

License Activations page listing irServer Production, Disaster Recovery, and Development license keys with the key values redacted

4: Enter Your Name, Organization Name, and License Keys Into the Activation Utility​

Enter your name, organization and the relevant license keys into the Activation Utility and press Activate

License Activation Utility with Your Name Here, Your Org Here, and placeholder license keys entered in the Activate Licenses section

5: Verify Your License Keys Have Activated​

License Activation Utility Activated Licenses list with two license keys (redacted) and their expiration dates