Installation Troubleshooting Steps for ExactTarget for Microsoft Dynamics CRM 4.0

From $1

    Doc-Wiki-BannerHK.png

    (Click the banner to go to the related Docs.Code.ExactTarget.com page.)

    This document contains conceptual and procedural information about troubleshooting your installation of ExactTarget for Microsoft Dynamics CRM 4.0. If you encounter issues during installation or whileattempting to validate the installation, review the situations below for help.

    What Are Installation Troubleshooting Steps for ExactTarget for Microsoft Dynamics CRM 4.0

    These troubleshooting steps provide solutions to problems you may experience while installing the ExactTarget for Microsoft Dynamics 4.0 integration.

    Why Use Installation Troubleshooting Steps for ExactTarget for Microsoft Dynamics CRM 4.0

    You can use these steps to solve installation problems and begin to use the ExactTarget for Microsoft Dynamics 4.0 integration

    How to Troubleshoot the ExactTarget for Microsoft Dynamics 4.0 Installation Process

    Follow the steps below to troubleshoot the following scenarios.

    Installation Fails While Attempting to Import Customizations

    This situation usually occurs because Dynamics CRM customizations failed to import in a timely fashion.  Follow these steps to re-import the customizations and restart the installation process:

    1. Cancel the installation and let the installation program roll back the changes.
    2. Obtain the ExactTarget customizations file from ExactTarget.
    3. Repeat installation process and click No to prompt to import customizations.
    4. Export all existing customizations for Campaign Response, ISV.Config, Marketing List, and Site Map.
    5. Import ExactTarget customizations (the customizations included in the ETCustomizations.xml file).
    6. Publish all customizations.

    Connector Service Fails to Install

    The connector service fails to install if you provide incorrect service account information. To correct this problem, do the following:

    1. Open the Services console at Start->Administrative Tools->Services.
    2. Locate the ExactTargetMSCRMConnector service and open the properties for the service.
    3. Click the Login tab and re-enter the login information for the service.
    4. Restart the service.

    Connector Service Fails to Connect to the ExactTarget Account

    Ensure that the server on which the connector is installed can reach the IP addresses listed below:

    • S1 Instance: 66.231.94.118 on port 443
    • S4 Instance: 66.231.94.116 on port 443

    Also, be sure to whitelist the IP addresses found in this link.

    Ensure that your Dynamics CRM client sessions and servers can reach the following URLs:

    Finally, if you use the optional add-ons, make sure the server can access the following sites owned by ExactTarget:

    CRM Service User Data Blank in Registry Utility After Install

    If you launch the ExactTarget Registry Utility and notice that the value for the CRM Service User field is blank, the connector service did not start as expected. To correct this problem, do the following:

    1. Open the Services console at Start->Administrative Tools->Services.
    2. Locate the ExactTargetMSCRMConnector service and open the properties for the service.
    3. Click the Login tab and re-enter the login information for the service.
    4. Restart the service.

    Error Message in Connector Log File - WSE065: Creation Time of Timestamp is in Future

    If this error is present in the connector log file, the server running the connector service has a time discrepancy with the ExactTarget web service server. When a server that is running the connector service is more than five minutes ahead or behind, the integration will not work. To correct this problem, update your server to synchronize time with the U.S. Naval Observatory master clock.

    Compilation Error on ExactTarget Emails Grid

    If you launch Microsoft Dynamics CRM, navigate to the ExactTarget Emails grid, and see a "Compilation Error," then you most likely have .NET 3.5 installed.

    Installation16.png

    The ExactTarget integration was build on the .NET 3.0 Framework, so the installation of .NET 3.5 requires additional modifications to the ExactTarget web.config file. To correct this problem, do the following:

    1. Navigate to the web.config file for the ExactTarget virtual directory (this would normally be located in C:\Inetpub\ExactTarget\web.config)
    2. Locate the end of the "configSections" node. This should also be right where the "appSettings" node begins:
    </configSections>
        <appSettings />
    1. Put the following "runtime" node between the end of the "configSections" node, and the beginning of the "appSettings" node:
    <runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
            <dependentAssembly>
                <assemblyIdentity name="System.Web.Extensions" publicKeyToken="31bf3856ad364e35"/>
                <bindingRedirect oldVersion="1.0.0.0-1.1.0.0" newVersion="3.5.0.0"/>
            </dependentAssembly>
            <dependentAssembly>
                 <assemblyIdentity name="System.Web.Extensions.Design" publicKeyToken="31bf3856ad364e35"/>
                <bindingRedirect oldVersion="1.0.0.0-1.1.0.0" newVersion="3.5.0.0"/>
             </dependentAssembly>
        </assemblyBinding>
    </runtime>

    Proxy Troubleshooting

    The ExactTarget for Microsoft Dynamics CRM integration may be affected by the installation of a proxy solution. Because there are many different hardware and software solutions available to satisfy your proxy requirements, this section cannot be an all-encompassing guide. Instead, this section can provide you a first step to resolving issues you might encounter with installing ExactTarget in tandem with a proxy solution.

    In order for ExactTarget for Microsoft Dynamics CRM to work between Dynamics CRM and ExactTarget, the following must be true:

    1. Your Dynamics CRM server needs to be able to access the ExactTarget web services.
    2. Traffic from your Dynamics CRM server should be able to pass through your proxy server to exacttarget.com without authentication.

    If your system cannot meet these requirements, or if you encounter issues during installation or when attempting to validate the installation, please review the items below for help.

    Your Users Receive 403 and 407 Errors

    The Dynamics CRM server is not authenticating through the proxy when attempting to hit ExactTarget's web service. To work around this problem, try one of the following:

    1. Find the two .config files listed below (typically stored on the CRM server at the default locations shown):
      • C:\inetpub\ExactTarget\web.config
      • C:\Program Files (x86)\ExactTarget\Connector\ExactTarget.MSCRM4.ConnectorService.exe.config
    2. Backup the current .config files.
    3. Add the following to both of these files code. You can add this code anywhere in the main <configuration> element unless that .config file already has a <system.net> element. If such an element exists, add the code inside that element.
      <system.net>
          <defaultProxy useDefaultCredentials="true">
              <proxy usesystemdefault="true" bypassonlocal="true" />
          </defaultProxy>
      </system.net>
    4. Restart the connector service.

    Your Users Receive the Error Message "A socket operation was attempted to an unreachable host"

    If the ExactTarget Connector Windows Service and the ExactTarget application pool have been modified to run under a specific domain account, this error could occur. To try and work around this problem, change the Internet Explorer proxy settings for that domain account:

    1. Right-click Internet Explorer, and select Run As.
    2. Type in the credentials of the user who is set to run the Windows Service and who is setup as the ExactTarget application pool identity.
    3. Click Tools and select Internet Options.
    4. Select the Connections tab and click on the LAN Settings button.
    5. Fill out the information for your proxy server in the correct section.
    6. Click OK twice.

     

     


    This page was last updated by Ryan Williams on Tue, 24 Jan 2012 13:22:20 GMT.

    If you require assistance with the ExactTarget application, please contact Global Support. If you wish to send Ryan direct feedback, fill out the form below:

     


    Was This Page Helpful?
    Suggestions or Comments:
    Name (optional):
    Email Address (optional):
    Enter 18095 backwards:
       
    Tags: (Edit tags)
    • No tags
    FileSizeDateAttached by 
    Installation16.png
    No description
    1023.02 kB09:22, 24 Jan 2012AdminActions
    Comments (0)
    You must login to post a comment.

     
    Powered by MindTouch 2010
    Admin