Help Center>Foundation Help

Applies to:

Upgrading to Workflow 10.8 (or later)

Upgrade Notes:

  • If you are upgrading to WinshuttleWorkflow 10.9:
    You can upgrade to Winshuttle Workflow 10.9 from Workflow versions 10.6 and later.
  • In you are upgrading to Winshuttle Workflow 10.8:
    You can upgrade to Winshuttle Workflow 10.8 from Workflow versions 10.2-10.7 or ShareVis 6.x.

Before you upgrade

  1. Make sure Sharepoint Administration Services and Timer Services are running on all Web Front ends.
  2. Restart SharePoint Timer Services on all front-ends.
  3. Open Windows Task Scheduler, and then disable the SVService scheduled task on all front-ends (if any).
  4. Perform an IISRESET on all front-ends.
  5. In the folder for the Workflow installation files (<wsp installer folder>/resources/tools/bin/ by default), open readlicensekey.exe. This tool extracts the current Workflow license.

    Note: Readlicensekey.exe must be run on all workflow front-ends except the one on which you are run the installer.

  6. Click Read Key, and then click Copy to Clipboard.
  7. Open any text editor (e.g. Windows notepad), paste the copied key, and then save the file to a convenient location.
  8. Uninstall Workflow from all other front-ends (except the one on which you plan to upgrade).

    Note: You can use the 10.8 uninstaller to uninstall older versions of Winshuttle Workflow (10.7 and earlier) as well.

Upgrading to Workflow 10.8 (and later)

Back to top
  1. On the current front-end, right-click the 10.8 installer (winshuttleworkflow.exe), and then click Run as Administrator. .
  2. Select Upgrade. (You will be warned to uninstall from any other Web Front End servers).
  3. At the Welcome screen, click Next.
  4. On the System Check screen, click Next.
  5. Select Upgrade, and then click Next.
  6. After installation has completed:
    • If you are installing a Winshuttle Workflow version Workflow 10.8 Hotfix 2 or earlier: Manually restart the SharePoint Timer Services on all front-ends.
    • Perform an IISRESET on all front-ends
  7. Manually delete the Old "Sharevis Central Administration" Application Pool from the IIS admin console.
  8. Update your license (see below).

Upgrading custom plug-ins

Back to top

If you used custom plug-ins in a Workflow 10.7 or earlier environment, you will also need to update the plugins after you have upgraded Winshuttle Workflow to version 10.8.

Note to developers: Workflow logging was moved to a new assembly (WFLogger.dll) from SVcore.dll to extend logging support for different modules in Workflow.

  1. Open your custom plugin project in Visual studio.
  2. Copy the WFLogger.dll from the installation folder WinshuttleWorkflowInstaller_201X
  3. Add a reference to WFLogger to the Plugin project.

  4. Rebuild the project to generate latest custom plugin assembly.
  5. Register the latest custom plugin assembly into the GAC (Global Assembly Cache).

Activating the Workflow license

Back to top
  1. Open the Workflow Central Administrator page.

    The default URL is YourServerName: 54073

  2. Click Licenses.
  3. Next to the Add button, paste the license copied earlier (see "Before you upgrade").

  4. Click Add.
  5. Perform an IISRESET.