Skip to content

Installing the Workflow Plug-in


The CRM Workflow Plugin is installed on the Dynamics CRM 2011 or 2013 Servers that host the Asynchronous Service.  This includes CRM servers that were installed with the Full Server Role Group, Back End Server Role Group or the Asynchronous Service Server Role.  If there are multiple servers hosting the Asynchronous Service, then the Workflow Plugin must be installed on each server that hosts that service.  See Farm Installation below.

The user installing the extensions must be a member of the CRM Deployment Administrator group. This identity can be added to this group using the Microsoft CRM Deployment Manager application.

For more information about using the Microsoft CRM Deployment Manager, please go here.

This identity may need additional permissions.  See “Add Deployment Administrators” for more information.


The Dynamics CRM 2011 Workflow Plug-in has the following requirements:

  • .NET Framework 4
  • Microsoft Dynamics CRM 2011 or 2013


The Neuron Dynamics CRM Workflow plugin msi is installed in by the Neuron ESB installation program.  Make sure you select the Microsoft Dynamics CRM 2011/2013 plug-in on the Select the Features to Install page of the installer:

The plug-in installers are copied to the instance directory of the Neuron installation.  For example, if the Neuron instance is named Default, the plug-ins will be found in “<Neuron Install Path>\DEFAULT\Plugins”.

  1. Copy the installer from “<Neuron Install Path>\DEFAULT\Plugins\Crm 2011 Neuron Publication” to the Dynamics CRM Serer:
    Crm 2011 Neuron Publication

  2. On the Dynamics CRM Server, execute the installer Neuron.Crm2011.Workflow.Setup64.msi.  The Welcome page is displayed.
    Welcome page

  3. Click Next.  The Installation Location page is displayed.
    Installation Location

  4. Click Next.  The CRM Server Information page is displayed.

    Enter the following information:
    1. Server – Enter the fully qualified domain name of the server hosting Dynamics CRM (this is the server you are installing the Neuron Dynamics CRM Workflow Extensions onto).
    2. Port – Enter the port number that the Dynamics CRM Web services can be accessed at.  Leave this at the default of port 80, unless you are certain it has been changed.
    3. Organization Name – Enter the name of the Dynamics CRM organization entity that you want these extensions to be associated with.
      The Server name may be different than the server you are installing on if you have separated the Front End Server Group Role from the Back End Group Role.  Also set the port the Web Services are listening on and the CRM Organization Name that will use the plug-in.

      Dynamics CRM Workflow Adapter

      Dynamics CRM supports multiple organizations.  The extensions are only associated with a single organization.  This entry cannot be changed after installation.
  5. Click Next.  The Neuron Server Information page is displayed.  

    Enter the following information:
    1. Neuron Host – Enter the fully qualified domain name of the server hosting Neuron.
    2. Neuron Port – Enter the port number of the Neuron bootstrap service.  Leave this at the default setting unless you are certain the port has been changed.
    3. Neuron Zone – Enter the zone name that the Neuron configuration is operating as.

      Enter info for CRM Workflow

  6. Click Next.  On the Confirm Installation page, click Next to install the plugin:
    crm confirm install

  7. During the installation you will be prompted to enter the credentials for a user that is a Deployment Administrator on Dynamics CRM.  Enter the domain, username and password and press OK:
    Deployment Administrator on Dynamics CRM

    [ mkb -info]Occasionally the credentials dialog may appear behind the main installer window.  If the installer appears to stall, move the window to reveal the credentials dialog. [/mkb -info]
  8. When the installation completes, the Information page appears.  Review the content and click Next:
    CRM Workflow Adapter Information

  9. On the Installation Complete page, click Close:
    CRM adapter Installation complete
Was this article helpful?
Dislike 0
Previous: Configure the CRM Workflow Plug-in