Upgrading Ad Hoc Transfer Plug-in for Outlook

Ipswitch no longer supports the Ad Hoc Transfer Plug-in for Outlook on Windows Server 2003 or 2008. Do not upgrade to the Ad Hoc Transfer Plug-in for Outlook V2.3 on those operating systems.

An Upgrade Affects Any Customizations to the User Interface and Help Topics

When you upgrade from version 2.1 or later of Ad Hoc Transfer Plug-in for Outlook, a new customizations sample file is installed. This is necessary because the schema for this XML file has changed. In order to maintain your customizations, you need to copy the entries from your existing customizations.xml file to a new customizations.xml that is based on the new sample file. The new sample file can be found in: C:\ProgramData\Ipswitch\Ad Hoc Transfer Plug-in for Outlook\customizations.xml.sample

For more information, see Customizing the User Interface.

If you are upgrading from version 2.2 or later of Ad Hoc Transfer Plug-in for Outlook, any changes that you have made to the customizations.xml file are maintained.

Standard Upgrade

If you have a previous version of the Ad Hoc Transfer Plug-in for Outlook installed on a system with a supported version of Outlook, you can upgrade to the new Ad Hoc Transfer Plug-in for Outlook by running the installer. It retains the previous configuration settings so that the Ipswitch client can use them to connect to the WS_FTP Server server.

See Installing for installation requirements and information.

Silent Upgrade

If your current version is Ad Hoc Transfer Plug-in for Outlook V2.0 or later, the silent installation will handle the upgrade to the new version, and can install Sync at the same time.

If your current version is Ad Hoc Transfer Plug-in for Outlook V1.5, before silently upgrading to the new Ad Hoc Transfer Plug-in for Outlook, you must first uninstall the previous version using command line options to execute the uninstall. The installer can use the previous configuration settings during installation so that the plug-in can use them to connect to the WS_FTP Server server.

Ensure that you meet all requirements before attempting a silent install or you will break the plug-in installation. See Silent install for information about installing the requirements and configuring the silent installation.

To silently upgrade the client application:

  1. Ensure Outlook is closed on the computer.
  2. If your current version is Ad Hoc Transfer Plug-in for Outlook V1.5, you need to silently uninstall the version 1.5 of the plug-in. When you run the installer, you must use this syntax:

    msiexec /x {D05A1A4A-82E2-4C04-8566-FB792A66C8E} /q

    If you did not install the plug-in silently on Windows 7, an Administrator must either uninstall from the command line without using the quiet (/q) parameter or uninstall the plug-in from Programs and Features.

  3. Once the uninstall is complete, you can install the Ad Hoc Transfer Plug-in for Outlook V2.2.5 using this syntax:

    msiexec /i [path+executable].msi /q DRIVER_NAME="xftWSFTPDriver.dll" [optional connection properties]

    The previous connection configuration information is saved on the computer after uninstalling the plug-in. You do not need to enter connection properties again.

You must run all installer commands from the Administrator account.

Remote Upgrade using Active Directory Group Policy

Since remote installation uses silent installation via the Windows Installer, if your current version is Ad Hoc Transfer Plug-in for Outlook V1.5, you must uninstall the plug-in before installing Ad Hoc Transfer Plug-in for Outlook. If your current version is Ad Hoc Transfer Plug-in for Outlook 2.0 or later, the silent installation handles the upgrade to the new version. (See Silent Upgrade above for more information.) Once the previous version is uninstalled, you can remotely upgrade the Ad Hoc Transfer Plug-in for Outlook the same way you remote install it. See Remotely Deploying the Ad Hoc Transfer Plug-in for Outlook for more information.

Upgrading the Ad Hoc Transfer Plug-in for Outlook on Outlook 2003

If you installed a previous version of the Ad Hoc Transfer Plug-in for Outlook on a system with Outlook 2003, you must upgrade to Outlook 2007/2010 because Outlook 2003 is no longer supported. Before you upgrade Outlook, uninstall the previous version of Ad Hoc Transfer Plug-in for Outlook. Once Outlook is upgraded, you can install the Ad Hoc Transfer Plug-in for Outlook V2.3.

Upgrading Outlook 2007 to Outlook 2010 or 2013

If you have the Ad Hoc Transfer Plug-in for Outlook V2.0 installed on a system with Outlook 2007, you can upgrade to Outlook 2010, 2013, or 2016 without reinstalling the plug-in.

If you have a previous version of the Ad Hoc Transfer Plug-in for Outlook installed on a system with Outlook 2007, you must upgrade the plug-in to Ad Hoc Transfer Plug-in for Outlook V2.0 before upgrading to Outlook 2010, 2013, or 2016.