Switching Between Environments for EMS Desktop Client Web Deploy

Users can switch their EMS Desktop Client between on-premise test and production environments, between on-premise and cloud hosted environments, or between cloud hosted test and production environments.

The EMS Desktop Client runs from the executable file located here: C:\Users\Username\AppData\Roaming\EMS2016\EMSApplication.exe. Because we can’t point to any two of these environments with the same EMS executable Desktop Client file, users must clear the EMS registry entry and then point to the desired environment.

  1. Clear the EMS registry entry by utilizing the “Reset EMS V220 Connection.reg” file.

    The content of this file is as follows:

    Windows Registry Editor Version 5.00
    [HKEY_CURRENT_USER\SOFTWARE\EMS Software\Version 220]
    "AppFacadeUrl"=-

    This file can be shared with users via SFTP as most e-mail programs will block attachments with the .reg extension. Alternatively, the file can be renamed with a .txt extension and then renamed again on the user side back to .reg. Or users can copy the three lines above into a text editor and save the file as “Reset EMS V220 Connection.reg.”

    If there is a need to switch between 44.1 and 220 environments it is recommended that the AppFacadeURL for both versions be cleared when switching between environments.

  2. Save the registry editor file “Reset EMS V220 Connection.reg” on the hard drive of the EMS Desktop Client user and run it.

  3. Click Yes on the warning dialog that opens.

  4. Click OK on the informational message that opens.

  5. Launch the Desktop Client from the EMS Desktop Client executable file or EMS icon .

  6. In the EMS Web Deploy configuration URL, enter the EMS Desktop Client URL corresponding to the desired environment.

  7. Click OK.

    This will launch the EMS Desktop Client for the specified environment.

Settings are saved from the last time the EMS Desktop Client was accessed. The steps discussed above must be repeated only when a user wants to switch environments.

If you are using the older version of EMS—44.1, replace 220 with 44.1 in the above steps.