Legacy Upgrade
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" />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>:
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:
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
Add the following nodes after the existing
<location>nodes in\wfgen\web.config: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
Add the following node after the existing
<location>nodes in\wfgen\web.config:Change the default value of
RestApiClientRequestTimeoutfrom3000to30000milliseconds.Make the following modifications to each Node.js component's
web.configfile (located in\wfgen\graphql,\wfgen\hooks,\wfgen\scim, and\wfgen\auth):Change the iisnode handler path from
server.jstodist/server.js.Change the rewrite rule
urlproperty fromserver.jstodist/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
Add the following new parameters to
<appSettings>:Remove the following parameters from
<appSettings>:Add the following to the
<configuration>node:Add
targetFramework="4.8"to the three web apps'httpRuntimenodes:Add the following to the
<configuration>node in\Inetpub\wwwroot\wfgen\ws\web.config:Add the following to
<configuration>node in\Program Files\Advantys\WorkflowGen\Services\bin\WfgDirectoriesSyncService.exe.config: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.
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:
Update the GraphQL and webhooks configuration files
In the \wfgen\graphql\web.config and \wfgen\hooks\web.config files, add the following to <system.webServer>:
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.
Remove the xmlns attribute
As of WorkflowGen version 7, you must remove the xmlns attribute from these configuration files:
To do this, change <configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0"> to <configuration>.