Installing the WCF Router

In this section:

How to:

This section describes how to install the iWay WCF Routing Service (WCF Router) as a standalone application or as a Windows service.


Top of page

x
Prerequisites

Before installing the iWay WCF Routing Service (WCF Router), ensure that Microsoft .NET Framework Version 3.5 or higher version is installed on the system that will be used to run the WCF Router.

For more information on how to install Microsoft .NET Framework Version 4.0, refer to the following website:

http://www.microsoft.com/en-us/download/details.aspx?id=17851


Top of page

x
Procedure: How to Install the WCF Router as a Standalone Application
  1. Open a command prompt (as an administrator) on your system and navigate to the location where the IWayRoutingService.exe file is located.
  2. Execute the following command:
    IWayRoutingService.exe -console

    or

    IWayRoutingService.exe -c

    For example:

    Note: The IWayRoutingService.exe file should not be run without specified parameters. If the IWayRoutingService.exe file is running in command mode, then the command window must remain open for the duration of the MS CRM session. Closing the command window will instantly disconnect the router. The command window is recommended only for testing purposes and is not considered safe for information disclosure. Always run the routing service as a service in a production environment.


Top of page

x
Procedure: How to Install the WCF Router as a Windows Service
  1. Open a command prompt (as an administrator) on your system and navigate to the location where the IWayRoutingService.exe file is located.
  2. Execute the following command:
    IWayRoutingService.exe -install

    or

    IWayRoutingService.exe -i

    For example:

    If the command runs successfully, the WCF Router will be installed as a Windows service.

    Note:

    • After the WCF Router is installed as a Windows service, the IWayRoutingService.exe file and the XML configuration file must remain in the same folder until the service is uninstalled. Moving or deleting the IWayRoutingService.exe file after installation will prevent you from uninstalling the WCF Router.
    • If the IWayRoutingService.exe file path contains more than two subfolders, problems with installing as a Windows service are possible. Avoid using any subfolders in this path.

Top of page

x
Procedure: How to Start and Stop the WCF Router Windows Service

You can start and stop the WCF Router Windows Service using the Windows Services dialog, as shown in the following image.


Top of page

x
Procedure: How to Uninstall the WCF Router as a Windows Service
  1. Open a command prompt (as an administrator) on your system and navigate to the location where the IWayRoutingService.exe file is located.
  2. Execute the following command:
    IWayRoutingService.exe -uninstall

    or

    IWayRoutingService.exe -u

    For example:

    If the command runs successfully, the WCF Router will be uninstalled as a Windows service.

    Note:

    • Ensure that you run the uninstallation command from the same path where the WCF Router Windows Service was installed.
    • If you have issues with this uninstallation process, the SC tool can be used, which provides capabilities similar to the Services dialog found in the Administrative Tools. You can specify sc delete "iWay WCF Routing Service". After this command is executed, restart the machine. For more information on using the SC tool, see http://support.microsoft.com/kb/251192.

iWay Software