This article describes in detail about integrating Microsoft Dynamics CRM (All Versions) with MachPanel Control Server.
This article applies to MachPanel build version 7 and above.
Pre-Requisites:
Please make sure that the CRM provisioning user is added in the local admins group on the following servers.
- CRM Server(s) - Admins group
- ADFS Server(s) - Admins group
The following Permissions should also be in place :
- Account used in MachPanel for CRM provisioning is added as a deployment Admin in CRM Deployment Manager
- Same account is added in CRM SQL sysadmin group.
- Add and make sure that CRM Application Pool (Deployment Service Only) uses the same account
- Same account should have [dbo] permissions on “MSCRM_Config”, “ReportServer” and “ReportServerTemp” DBs
CRM Task Utilities:
CRMTasks is a utility created to run CRM operations on CRM server. Need to place correct files in Remote server installation folder based on CRM Server version. Typical installation path: C:\Program Files\MachSol\MachPanel Remote Server. If you are using CRM server 2016, 2015, 2013 or 2011, need to replace files in folder CRMTasks-v1.1 to Remote server installation folder after stopping MachPanel Provisioning service.
Applies to : Microsoft Dynamics 365 (upgraded / fresh install)
If you are using CRM server Dynamics 2016, need to download below and replace files in folder CRMTasks-v2.1 to Remote server installation folder after stopping MachPanel Provisioning service.
http://www.machsol.com/updates/Dynamics-365-CRMTask.zip
Folder "CRMTasks-v2" contains the following files ...
1. CRMTasks.exe
2. microsoft.crm.sdk.proxy.dll
3. microsoft.xrm.sdk.dll
On Dynamics 365 server navigate to "C:\Program Files\MachSol\MachPanel Remote Server" and Replace the above files.
Procedure:
- Open
MachPanel Control Panel Website (You can do it by opening MachPanel
Control Server Configuration Studio and then navigating to Configure > Control Panel Website, and then clicking on the URL in it). Log in with the provider credentials.
- Following CRM providers are supported in MachPanel.
- Navigate to Home >> Service Director >> CRM Hosting >> Server group and then click on Add Server Group.
- Adding CRM Server is a two step process. In the first Server Group is added and in the second step CRM Server is added:
- Server Group Name: This is the friendly name of the server group.
- Provider: Select the provider you wish to add.
- Active Directory Domain: Select the active directory whose credentials will be used while provisioning
- LDAP URL: Provide the path of the Organizational Unit in AD under which the users will be created
- Fill Style: Select from one of the two options
- Least Filled First: Setup hosting on the group member which is least filled
- One-by-One: Setup hosting on group members in circular manner
- Enabled: If unchecked, system will not provision any accounts on the server group members
- Override Domain Credentials: You can check this option and use credentials other than the one mentioned in the Active Directory Domain
4) In the second step, CRM Server is added:
- In Server information section provide the Reference Id and Server IP.
-
In CRM Information section provide IFD site URL, URL base, CRM Server Port, SQL Server Name and SQL Report Server URL.
- ADFS Server FQDN
- External Relying Party Display Name
- Enabled: If unchecked, system will not provision any accounts on this server
- Handle DNS: You can also add DNS Handling feature at server level. A-Record will be created in the required Zone
5) Now click on the newly created Server Group to enter in the CRM Servers tab. Click on 'Test Service'
6) If you get below Test Report then you have successfully integrated CRM with MachPanel: