Workflow 6.5 Service Release 2 Readme

This readme file provides information that supplements the Captaris Workflow documentation. A Service Release may contain updates for system reliability, program compatibility, performance improvements, and more.

Important: All Service Releases are cumulative. Each contains new fixes plus all the fixes from previous Hotfixes.

Contents      

1.     What is Included in this Service Release?

2.     Additional Notes

3.     If you are upgrading from Workflow 6.5 Base

4.     To Apply the Service Release

5.     To Setup Session State to SQL Server/State Server for Web Access

6.     To restrict the SQL Server memory usage

7.     To Remove the Service Release

8.     Fixes in Workflow Service Release 2

What is included in Service Release 2?

·         Fix for the use of SQL Server session state in Workflow Web Access.

·         Improved the deploying feature of models with Web Tasks.

·         Fix for Process View hang with Wizard Models.

·         Fix for the Windows Handler error and Compilation error encountered when a high load is applied on the Web Access.

·         Fix for Model preview displaying inaccurately, when a model using Cross Server option is imported.

·         Fix for the defect where MSMQ Triggers were not working.

·         Fix for the defect that was unable to trigger event task the second time when a new Time based event is set on the first execution of the event task.

·         Fix for Task List view which takes a longer time to load with KPI columns and more process.

·         Fix for the defect where the event service does not release memory after catching the file drop trigger.

·         Fix for the Monitoring view where it throws an exception while exporting view to excel and Monitoring view wizard does not work when selecting user categories in the tree view pane if Workflow Client and Server are installed in different machines.

·         Fix for the error unable to create new task list view when model id is above 64K.

·         Improved the performance of Task List view in Web Access.

·         Fix for Task Properties window where Completion date same as Start date is displayed.

·         Updates to various Assemblies. For a complete list of the updated Assemblies click here.

­Additional Notes

·         Before installing Captaris Workflow Service Release 2, please note that Workflow must be re-activated by contacting Captaris.  After installation of 6.5 Service Release 2 is complete, run the activation utility and provide Captaris (by phone 1-520-320-7070 or email support@captaris.com) with your new license code, and you will be provided with a new activation key.  This step is not required if you are upgrading from Base Hotfix 1 or Feature Pack 1 or the Feature Pack 1 Hotfix 1 installation which has already been re-activated.

·         Do not apply Service Release 2 to a stand-alone Captaris Workflow Database installation running on a 64-bit server. Instead, if the upgrade is done from a version earlier to Feature Pack 1 Hotfix 1 then, manually run the UpdateTeamplateDatabase.sql and UpdateTeamplateDatabaseConcurrencyPatch.sql script on the 64-bit server. There are no Database scripts to run, if the upgrades are from Feature Pack 1 Hotfix 1.

·         To uninstall Service Release 2 and not the entire product under a 64bit database, please run the third script file titled RemoveTeamplateDatabaseConcurrencyPatch.sql. This script need not be run if the upgrade was done from Feature Pack 1 Hotfix 1.

If you are upgrading from Workflow 6.5 Base

·         After successfully configuring your workflow installation, you must re-deploy all workflow models due to policy redirection changes.

·         Do not apply the Service Release 2 Installer to a stand-alone SharePoint 2003 machine running on the .NET 1.1 Framework. To add the SharePoint fixes in this environment, use the Workflow 6.5_FeaturePack1_NETV1.1.zip located at http://www.captaris.com/support/downloads/captaris_workflow and follow the instructions in the included Readme file.

·         If you are using SharePoint the Captaris Workflow SharePoint Web Part must be removed, re-configured, and added back to your SharePoint site.

Steps to make sure the new version of the Workflow Web Part is installed:

1.     Delete the old Workflow Web Part from your SharePoint page.

2.     Run the Captaris Workflow Configuration Utility.

3.     In the configure screen for the SharePoint components, check or uncheck one of the check boxes under the “SharePoint Web Part Menus” section.

4.     Click Configure.  The change to the web part configuration will be detected and this will force the web part to be updated.

5.     Go back to your SharePoint page and add the new version of the Workflow Web Part.

To Apply the Service Release

1. Ensure that no Captaris Workflow windows are open.

2. Run the Captaris Workflow Service Release on each machine that has a component of Captaris Workflow 6.5 installed. For example, if you have a distributed installation of Captaris Workflow, you must install this Service Release on all machines.

3. The Configuration Utility automatically opens after the Service Release is installed. Verify the information is correct in EACH component of the Configuration Utility and then click Configure to configure the Service Release.

The Captaris Workflow SWS, and Captaris Workflow Event Handler will automatically be restarted by the Configuration Utility. As well, an iisreset command is automatically run by the Configuration Utility.

*If you are using the Captaris Workflow Active Directory Service, you must restart this service manually.

** Step 4 is only required for environments with a NetBIOS domain name that does not match their corresponding Short Domain Name. By default, Active Directory Users have their Fully Qualified Domain Name imported into the USERS table. However, in order to support Users NetBIOS domain names, a surrogate key must be added to the Teamplate database.

4. Insert a record into the NETBIOSDOMAIN table. For example, to map the NetBIOS domain name 'MY_DOMAIN_NAME' to the Fully Qualified Domain Name 'DomainName.Com' execute the following SQL statement:

INSERT INTO NETBIOSDOMAIN(DOMAIN, NETBIOS) VALUES('MY_DOMAIN_NAME', 'DomainName.Com')

To Setup Session State to SQL Server/State Server for Web Access

*This section is not required if the Session State is to be configured in the Web Access to run in InProc mode (default).

1.     Follow the article http://msdn.microsoft.com/en-us/library/87069683(vs.71).aspx (Configure State Server Mode/Configure SQL Server Mode). The web.config referenced here is the file residing at  ‘<Installation Directory>\Captaris\CaptarisWorkflow\Web\WorkflowWebAccess’.

2.     It is also recommended to set the Recycling Worker Process when using the Session State with the SQL Server or State Server mode. The following steps helps to set the  Recycling Worker Process:

a.     Go to Start -> Control Panel -> Administrative Tools -> Internet Information Services (IIS) Manager.

b.     In the left pane, under the Application Pools section, go to the appropriate Application pool, which is configured for the Web Access.

c.     Right click the appropriate Application Pool, and select Properties from the context menu.

The Properties dialog box with Recycling as the default tab appears.

d.     Under Memory recycling option, enable Maximum used memory (in megabytes): and set an appropriate value based on the available memory.

e.     Click OK.

f.      Run the iisreset command in the Run prompt (Start -> Run).

 

 

To restrict the SQL Server memory usage

 

*This section applies to SQL Server 2005 only. It is required if want to restrict the SQL Server memory usage. Ensure that the value set will not affect other applications using the same SQL Server.

1.     In the SQL Server Management Studio, right click the server and select Properties.

2.     From the left pane, select memory properties.

3.     Set the Maximum server memory in (MB) to a value to which SQL Server memory has to be restricted and Click OK.

4.     Restart the SQL Server to implement the configuration changes.

To Remove the Service Release

1.     From Add Remove Programs, select Captaris Workflow 6.5 Service Release 2.

Note: If the Captaris Workflow 6.5 Service Release 2 is not displayed in the Add or Remove Program dialog, select the Show updates checkbox.

2.     Click Remove.

3.     Run the configuration tool to configure the application.

4.     Manually restart the Captaris Workflow Services.

 

Fixes in Workflow Service Release 2

Captaris Tracking Number

Module

Problem

Affected Assemblies

59126

User Admin

Role System group appears in the Organizational View.

TeamplateWinAdmin.dll

59406

Manager

Error occurs when sorting on Owner Name in File List.

TeamplateWinManagement.dll

59507

Web Access

Edit/Delete monitoring view menu item opens another dialog in which the default view to edit/delete is Task List view.

App_Web_tasklistedit.aspx.cdcab7d2.dll

App_Web_tasklistdelete.aspx.cdcab7d2.dll

60340

User Admin

There is still a way to interrupt the bulk importing of users from Active Directory.

Captaris.Workflow.Common.dll

60746

Manager

Unable to remove the user from the Access List.

TeamplateWindowsDirectoryServices.dll

62679

User Admin

Customer is not able to search Workflow groups from User administration Tool.

TeamplateWinAdmin.dll

64911

IDE, Manager & Web Access

Deploying Models with Web Tasks is slow. Redundant copying of assemblies into bin folder.

TeamplateBLL.dll

65012

Event Service

User is unable to create a model with an event task executing more than once based on the time-based triggers.

Captaris.Workflow.EventService.Service.dll

65362

User Admin

Admin tool's User search item does not highlight the correct user for a name that appears after Role System.

TeamplateWinAdmin.dll

65399

Web Access

Workflow Process View Hangs for Wizard models.

TeamplateWinIDE.dll

65459

User Admin

The model preview is not displayed properly while importing a model.

TeamplateBLL.dll

66950

Web Access

Windows Handler exception occurs while defining the tasks in web wizard.

TeamplateBLL.dll

TeamplateWinIDE.dll

Teamplate.Web.UI.WebControls.dll

66951

Web Access

On logoff from the application, the login page is not displayed if SSL is implemented for the site.

App_Web_login.aspx.cdcab7d2.dll

App_Web_shortcuts.aspx.2d873051.dll

66952

IDE, Manager & Web Access

Compilation error is displayed while executing the web tasks in IDE, Workflow Manager and Web Access.

TeamplateBLL.dll

TeamplateWinIDE.dll

Teamplate.Web.UI.WebControls.dll

66953

Web Access

An exception is thrown while logging into Web Wizard.

App_Web_weblogin.aspx.df5c6e46.dll

66954

Web Access

Server Error "Unable to serialize session state" is thrown when trying to create/edit new or existing task list view in Web Access. Similarly if a task is selected from the file list area and the Task properties icon is clicked, the same exception is thrown.

TeamplateBLL.dll

66955

Web Access

Shortcut keys for Start Workflow are not created.

App_Web_shortcuts.aspx.2d873051.dll

Teamplate.Web.UI.WebControls.dll

66956

Web Access

Select user in Wizard and Web Access are not consistent.

App_Web_explorerpage.aspx.cdcab7d2.dll

App_Web_selecttaskusers.aspx.fe64a0b2.dll

App_Web_selectuserswebaccesstasks.aspx.cdcab7d2.dll

App_Web_defineusertask.ascx.a7535a78.dll

App_Web_tasklist.aspx.cdcab7d2.dll

Teamplate.Web.UI.WebControls.dll

66957

Web Access

Error occurs when creating new Monitoring View.

App_Code.dll

67623

Web Access

Edit monitoring view does not refresh the explorer page on completion.

Teamplate.Web.UI.WebControls.dll

67444

Web Access

Wrong message is displayed while deleting task in Web Wizard.

App_Web_definesystemtask.aspx.df5c6e46.dll

67638

Web Access

Reference to a wrong script file.

App_Web_introduction.aspx.df5c6e46.dll App_Web_definetasks.ascx.a7535a78.dll

67528

Web Access

Unable to create shortcut key for Processes.

Teamplate.Web.UI.WebControls.dll

App_Web_shortcuts.aspx.2d873051.dll

66727

Manager

New Monitoring view wizard does not work for client machines when selecting users categories

TeamplateWinMonitoring.dll

 

67665

Manager

Throws an exception while exporting monitoring view to excel

TeamplateWinMonitoring.dll

63542

Manager

Task List view takes a long time to load with KPI columns and more processes

TeamplateBLL.dll

65613

Manager

When using grouped views in Workflow Manager the selected text is not legible

TeamplateWinManagement.dll

67724

Manager

Unable to create new task list view when model id is above 64k

TeamplateWinManagement.dll

67530

Web Access

Taking more time to display the Task List view.

Teamplate.Web.UI.WebControls

65609

Manager

Task properties window shows wrong Completion Date.

TeamplateWinIDE.dll

67564

Event Service

MSMQ Trigger functionality does not work.

Captaris.Workflow.EventService.Service.dll

66739, 65333

Event Service

Event service & SQL Server memory does not reduce after dropping a large number of files with file drop triggers associated to it.

TeamplateBLL.dll, Configuration changes are required to restrict the SQL Server memory.