Legacy Upgrade

This section contains instructions for clients upgrading from versions 7.22.15 and earlier. Follow the instructions in this section, then return to the main upgrade section to complete the procedure.

Update configuration files

Apply the changes to the web configuration file based on the version from which you're upgrading. Once you've applied these changes, return to the Update configuration files section in the main upgrade section and continue with the changes there.

📌 Examples

  • When upgrading from version 6.5.0, apply the changes in the When upgrading from version 6.5.0 section to the When upgrading from all 7.x.x versions and earlier section.

  • When upgrading from version 7.22.1, apply the changes in the When upgrading from all 7.x.x versions and earlier section only.

When upgrading from version 5.7.4 and earlier

Check the following parameters in your \wfgen\web.config and add them if they aren't already there.

<add key="EngineEnableSelfServiceDataAssignException" value="N" />
<add key="EngineNotificationDefaultReplyTo" value="" />
<add key="EngineNotificationMaxFileAttSize" value="10" />
<add key="EngineNotificationTextDetection" value="Y" />
<add key="EngineNotificationServerTimeout" value="3" />
<add key="ApplicationDistributedDatabaseSourceMode" value="0" />
<add key="ApplicationEnableDistributedDatabaseSource" value="N" />
<add key="ApplicationEnableArchiveSiteRedirectConfirmation" value="Y" />
<add key="ApplicationArchiveSiteUrl" value="" />
<add key="ApplicationShowAssociatedDataWithEmptyValue" value="Y" />
<add key="ApplicationSecurityEnableWebAppsSecureMode" value="N" />

The first number in the PortalFrameSetHeight value is the height of the banner. If your website is configured to display a banner, enter its height in pixels here. The other default values should not be changed.

You can copy the ProcessesRunTimeWebServiceAllowedUsers parameter from your existing \wfgen\ws\web.config to \wfgen\web.config.

You can copy this parameter from your existing \wfgen\WfApps\WebApps\eFormASPX\web.config to \wfgen\web.config.

You can copy this parameter from your existing \wfgen\WfApps\WebServices\GetUsersFromDir\web.config to \wfgen\web.config.

You can copy these parameters from your existing \wfgen\WfApps\WebServices\XmlToDatabase\web.config to \wfgen\web.config.

You can copy these parameters from your existing \wfgen\WfApps\WebServices\XmlTrans\web.config to \wfgen\web.config.

Remove the following deprecated parameters from <appSettings>:

Define the following nodes in <configuration>:

Define or update the following node in <configuration>/<system.web>:

When upgrading from version 6.0.0 and earlier

Add the following new parameters to <appSettings>:

Replace the ApplicationSmtpPickupDirectory path above with the path of your SMTP gateway pickup folder.

The ApplicationSmtpDeliveryMethod parameter defines the notification delivery method. By default, it uses the SMTP server, but you can change the SMTP delivery method to Pickup directory in the Administration Module Configuration Panel.

When upgrading from version 6.1.0 and earlier

Add the following new parameter to <appSettings>:

When upgrading from version 6.1.4 and earlier

Add or modify the AdministrationFormDataProviderName parameter as follows:

The Oracle.DataAccess.Client value was added to this parameter in version 6.1.5.

When upgrading from version 6.1.6 and earlier

Add the following new parameters to <appSettings>:

When upgrading from version 6.4.0 and earlier

Add the following new parameters to <appSettings>:

When upgrading from version 6.5.0 and earlier

Add the following new parameter to <appSettings> to configure the SENDHTTPPOST workflow application log file, replacing the value n with 0 to disable logging, 1 for simple logs, or 2 for debug logs:

When upgrading from version 6.6.0 and earlier

Remove the following deprecated parameters from <appSettings>:

When upgrading from version 7.1.1 and earlier

Add the following new parameters to <appSettings>:

When upgrading from version 7.3.1 and earlier

Add the following new parameter to <appSettings>:

When upgrading from version 7.6.0 and earlier

Add the following new parameters to <appSettings>:

When upgrading from version 7.9.1 and earlier

Add the following new parameters to <appSettings>:

When upgrading from version 7.14.3 and earlier

Add the following new parameter to <appSettings>:

When upgrading from version 7.14.8 and earlier

Add the following new parameters to <appSettings>:

Remove the following deprecated parameters from <appSettings>:

When upgrading from version 7.15.2 and earlier

  1. Add the following nodes after the existing <location> nodes in \wfgen\web.config:

  2. Remove the node below from \wfgen\auth\web.config, \wfgen\hooks\web.config, and \wfgen\scim\web.config, if present:

When upgrading from version 7.15.4 and earlier

Add the following new parameter to <appSettings>:

When upgrading from version 7.15.5 and earlier

  1. Add the following node after the existing <location> nodes in \wfgen\web.config:

  2. Change the default value of RestApiClientRequestTimeout from 3000 to 30000 milliseconds.

  3. Make the following modifications to each Node.js component's web.config file (located in \wfgen\graphql, \wfgen\hooks, \wfgen\scim, and \wfgen\auth):

    • Change the iisnode handler path from server.js to dist/server.js.

    • Change the rewrite rule url property from server.js to dist/server.js.

    It should look as follows:

When upgrading from version 7.16.5 and earlier

Add the following new parameters to <appSettings>:

When upgrading from version 7.18.1 and earlier

Add the following new parameter to <appSettings>:

When upgrading from version 7.18.2 and earlier

Add the following new parameter to <appSettings>:

When upgrading from version 7.20.0 and earlier

Add the following new parameters to <appSettings>:

When upgrading from version 7.21.0 and earlier

Add the following new parameter to <appSettings>:

When upgrading from version 7.22.0 and earlier

Remove the existing Access-Control-Allow-* custom header nodes from location path="graphql" (as shown below), since they are deprecated as of version 7.22.1:

When upgrading from all 7.x.x versions and earlier

  1. Add the following new parameters to <appSettings>:

  2. Remove the following parameters from <appSettings>:

  3. Add the following to the <configuration> node:

  4. Add targetFramework="4.8" to the three web apps' httpRuntime nodes:

  5. Add the following to the <configuration> node in \Inetpub\wwwroot\wfgen\ws\web.config:

  6. Add the following to <configuration> node in \Program Files\Advantys\WorkflowGen\Services\bin\WfgDirectoriesSyncService.exe.config:

  7. Add the following to the <configuration> node in \Program Files\Advantys\WorkflowGen\Services\bin\WfgWorkflowEngineService.exe.config:

Upgrade the WorkflowGen database

Run the SQL scripts listed below in order, starting with your current version of WorkflowGen, then continue running the scripts in the Upgrade the WorkflowGen database section in the main upgrade chapter.

Oracle database is no longer supported as of WorkflowGen 7.16.0.

MS SQL Server

For versions 5.1.9 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-2-0.sql database update script in your SQL Server Management Studio tool.

For versions 5.2.x and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-3-0.sql database update script in your SQL Server Management Studio tool.

For versions 5.3.x, 5.4.0 (alpha, beta 1 and beta 2) and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-4-0.sql database update script in your SQL Server Management Studio tool.

For versions 5.4.x official and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-5-0.sql database update script in your SQL Server Management Studio tool.

For versions 5.5.0 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-5-1.sqldatabase update script in your SQL Server Management Studio tool.

For versions 5.5.1 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-5-2.sql database update script in your SQL Server Management Studio tool.

For versions 5.5.4 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-5-5.sql database update script in your SQL Server Management Studio tool.

For versions 5.5.5 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-6-0.sql database update script in your SQL Server Management Studio tool.

For versions 5.6.1 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-6-2.sql database update script in your SQL Server Management Studio tool.

For versions 5.6.2 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-6-3.sql database update script in your SQL Server Management Studio tool.

For versions 5.6.3 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-6-4.sql database update script in your SQL Server Management Studio tool.

For versions 5.7.0 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-7-1.sql database update script in your SQL Server Management Studio tool.

For versions 5.7.1 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V5-7-2.sql database update script in your SQL Server Management Studio tool.

For versions 5.7.4 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V6-0-0.sql database update script in your SQL Server Management Studio tool.

For versions 6.0.0 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V6-1-0.sql database update script in your SQL Server Management Studio tool.

For versions 6.1.2 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V6-1-3.sql database update script in your SQL Server Management Studio tool.

For versions 6.1.3 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V6-1-4.sql database update script in your SQL Server Management Studio tool.

For versions 6.1.6 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V6-2-0.sql database update script in your SQL Server Management Studio tool.

For versions 6.4.0 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V6-5-0.sql database update script in your SQL Server Management Studio tool.

For versions 6.5.0 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V6-6-0.sql database update script in your SQL Server Management Studio tool.

For versions 6.6.0 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-0-0.sql database update script in your SQL Server Management Studio tool.

For versions 7.1.0 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-1-1.sql database update script in your SQL Server Management Studio tool.

For versions 7.1.1 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-2-0.sql database update script in your SQL Server Management Studio tool.

For versions 7.2.1 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-3-0.sql database update script in your SQL Server Management Studio tool.

For versions 7.5.1 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-6-0.sql database update script in your SQL Server Management Studio tool.

For versions 7.9.1 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-10-0.sql database update script in your SQL Server Management Studio tool.

For versions 7.10.0 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-11-0.sql database update script in your SQL Server Management Studio tool.

For versions 7.11.2 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-12-0.sql database update script in your SQL Server Management Studio tool.

For versions 7.12.2 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-13-0.sql database update script in your SQL Server Management Studio tool.

For versions 7.13.1 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-14-0.sql database update script in your SQL Server Management Studio tool.

For versions 7.14.7 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-15-0.sql database update script in your SQL Server Management Studio tool.

For versions 7.15.1 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-15-2.sql database update script in your SQL Server Management Studio tool.

For versions 7.15.5 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-16-0.sql database update script in your SQL Server Management Studio tool.

For versions 7.16.5 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-17-0.sql database update script in your SQL Server Management Studio tool.

For versions 7.21.0 and earlier

Launch the Update\Databases\MsSQLServer\Update_WFG-V7-22-0.sql database update script in your SQL Server Management Studio tool.

For all 7.x.x and earlier versions

Launch the Update\Databases\MsSQLServer\Update_WFG-V8-0-0.sql database update script in your SQL Server Management Studio tool.

Update the Directory Synchronization configuration file

A new configuration parameter is required when upgrading from version 5.1.5 and earlier. This parameter allows you to provide a unique service name to the WorkflowGen Directory Synchronization service should you have multiple instances of WorkflowGen installed on a single server.

Add the following parameter to DRIVE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgDirectoriesSyncService.exe.config:

Update the WorkflowGen Engine Service configuration file

A new configuration parameter is required when upgrading from version 5.1.5 or earlier. This parameter allows you to provide a unique service name to the WorkflowGen Engine service should you have multiple instances of WorkflowGen installed on a single server.

Add the following parameter to DRIVE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgWorkflowEngineService.exe.config:

Move the XMLTODATABASE transactions file

If you're upgrading from version 5.7.4 or earlier, copy the Transactions.xml file from \wfgen\WfApps\WebServices\XmlToDatabase\App_Data to \wfgen\App_Data\Files\XmlToDatabase.

Last updated