Install or Upgrade the Exchange Integration Web Service

To prepare for installation:

  1. Install or upgrade your EMS databases as outlined in the EMS Desktop Client Installation Guide.

  2. Manually uninstall any previous versions of the Exchange Integration Service on your web server. 

ClosedInstall or Upgrade the Exchange Integration Web Service

To install the Exchange Integration Web Service:

  1. Verify that the requirements outlined in the System Requirements section are met.

  2. Download ExchangeIntegrationWebService.msi​ onto the web server that will be running the service.

  3. Run ExchangeIntegrationWebService.msi​

    The first page welcomes you to the Exchange Integration Service Setup Wizard

  4. Click Next to begin the installation process.

    The Destination Folder screen opens.

  5. Select the destination folder. The installation process creates a new physical directory on your web server based on the destination folder path entered (“ExchangeIntegrationService” in the example above.) Click Next.

    The Exchange Integration Service should not be installed in the same physical directory as other EMS web-based products.

  6. The SQL Server and database information screen appears.

  7. Enter your EMS SQL Instance Name.

  8. Enter your EMS Database Name, typically named  “EMS”.

  9. Click Next.

    The Virtual Directory information screen appears.

  10. The Virtual Directory Name will default to the destination folder specified in Step 5. We recommend that you keep the default setting. The installation process will create a virtual directory on your web server based on the virtual directory entered (“ExchangeIntegrationWebService” in the example above.) Click Next.

    The Exchange Integration should not be installed in the same virtual directory as other EMS web-based products.

  11. On the Ready to Install Exchange Integration Web Service screen, click Install to install the Exchange Integration.

    The Completed the Exchange Integration Web Service Setup Wizard screen appears. 

  12. Click Finish

  13. After following the steps above, verify your installation by opening a browser and entering the following URL:

    http://[ServerName]/ExchangeIntegrationWebService/pamconfig.aspx
    (replace [ServerName] with the name of your web server)

    A standard installation requires that the Exchange Integration be published without any authentication methods in place (e.g., Integrated Windows Authentication or Portal Authentication). If you require the Exchange Integration to be secured with authentication, additional configuration is necessary. Contact your implementation consultant for further details.

  14. Navigate to System Administration > Settings > Parameters > Desktop Client tab.

  15. In the Exchange Integration Web Service URL field, enter http://[ServerName]/ExchangeIntegrationWebService/Service.asmx.

    This is a service page for APIs. When you navigate to this page, you will see an expected error. This error does not indicate a problem with the system.

Next step

The next step after installation is configuration. For information on the configuration of your Exchange Integration Web Service refer to Configuration of Exchange Integration Web Service.