You are here: eSignLive Documentation > Online Guides > Connector Guides > Deploying the Push Notification Service

Deploying the Push Notification Service

NOTE: The Push Notification Service is needed only if your connector is installed on-premises. If you have a SaaS deployment (as is possible for Microsoft Dynamics CRM 2.0, for example), please ignore this section.

The Push Notification Service: (1) receives an Event Notification (callback) from eSignLive every time the status of an e-signature process changes; (2) transmits that information to the relevant connector (e.g., eSignLive for Microsoft Dynamics CRM, eSignLive for Microsoft SharePoint).

This section describes:

Installing the Push Notification Service

To install the Push Notification Service for an eSignLive connector:

  1. If you are using Microsoft Dynamics CRM 2.0, unzip the file PushNotificationService.zip into the folder where you want to install the service.
  2. Create an IIS Website by doing the following:
    1. Connect to IIS with sufficient privileges.
    2. Click Add Web Site. A new dialog box appears.
    3. Specify the following parameters:
      • Site name — You can specify any name you want.
      • Physical path — If you are using Microsoft Dynamics CRM 2.0, this path should identify the folder where the zip file was unzipped in Step 1. If you are using any other connector, this path should identify the folder where the Push Notification Service will be installed.
      • Port — You can specify any port number you want.
    4. Click OK.
    5. Ensure that the Application Pool version is 4.0 by selecting the Basic Settings of the Application Pool, as illustrated below.
  3. If you are using Microsoft Dynamics CRM 2.0, edit the file web.config as follows:
    1. Update the connectionString in the "<add name="CrmLocal" connectionString="....">" section of the file.
    2. Update the following parameters:
      • URL — The URL of your Microsoft Dynamics CRM organization (e.g., http://hostname:8888/Dynamics2015)
      • Domain — The domain name
      • Username — The user name associated with a domain account that has Admin privileges on Microsoft Dynamics CRM 2.0
      • Password — Password for the Username
    3. Save your changes, and restart the Website in IIS.
  4. If you are using a connector other than Microsoft Dynamics CRM 2.0, do the following to run the Installer:
    1. Double-click the file ESLEventReceiverInstaller.msi.
    2. On the Welcome screen, click Next. A new dialog box appears.
    3. Specify the IIS Site and Application Pool.
    4. NOTE: Specify a Virtual directory only if you want to host the service on a virtual directory inside the IIS Website. Otherwise, leave that field blank.

    5. Click Next. The Connection Settings page appears.
    6. Specify the following parameters, which will be used to store the service's notifications. Their values were determined when the SQL database was installed as part of your connector's deployment.
      • Server Name — Name of the SQL server
      • Database NameName of the SQL database
      • User Name — The user name associated with the database
      • Password — Password for the User name
    7. Click Next.
    8. After the installation is complete, click Close.
  5. To verify that the service is running: (1) open the service in the Contents View of IIS; (2) browse for PostEvent.svc.
  6. Bind the IIS Website to the public IP or domain, so eSignLive can send notifications to the Push Notification Service. For this purpose, bear in mind that:
    • The URL for the Push Notification Service is:
    • http://{SERVER_NAME:PORT}/PostEvent.svc/PostESLEvent

      Here {SERVER_NAME:PORT} is a placeholder for the server name and port number.

      NOTE: The service can be hosted on any port you want.

      NOTE: The server name and port must be accessible from the Internet. You may want to open your firewall exclusively to eSignLive's IP address. If so, you can obtain that IP address from eSignLive Support.

      NOTE: This URL should be used in eSignLive Account > Callback URL in the connector configuration.

      NOTE: PostESLEvent is the method in the service that receives HTTP POST requests with a JSON payload as event data.

Verifying the Push Notification Service

To verify that events are being properly received by the Push Notification Service:

  1. Create a package using your eSignLive connector.
  2. Do one of the following:
    1. If you are using Microsoft Dynamics CRM 2.0, the service should receive an eSignLive Notification Entity about the new package.
    2. If you are using a connector other than Microsoft Dynamics CRM 2.0, the service should receive at least one event associated with the new package. To verify that it has, check the SQL table:
    3. Select * From EslNotifications
  3. If the expected events do not appear, check the following service log:
  4. {SERVICE_INSTALLATION_FOLDER}\Logs\Log.txt

  5. If the log files have not been created, there could be a permission issue on the IIS Website directory. Ensure that the account running the Application Pool has write permissions to the Website folder.

NOTE: The Push Notification Service will not work if there is not enough free memory. If you find that it isn't working, ensure that on the server where the service is installed, the free memory is > 5% of the total memory.

Uninstalling the Push Notification Service

NOTE: The Push Notification Service is needed by your connector if it was installed on-premises. Thus you should uninstall the service only if you also want to uninstall the on-premises deployment of your connector.

To uninstall the Push Notification Service for your connector:

  1. If you are using a connector other than Microsoft Dynamics CRM 2.0, run the file ESLEventReceiverInstaller.msi, and select Remove ESLEventReceiverInstaller. Then click Finish.
  2. To delete the IIS Website and Application Pool, right-click PushNotificationService, and select Remove.
  3. If you are using Microsoft Dynamics CRM 2.0, remove the service's unzipped folder.