3.4.6

From KnowledgeTree Document Management Made Simple

Jump to: navigation, search

Contents

KNOWLEDGETREE SERVER 3.4.6

Release Summary

  • Date of this release: 24 January 2008
  • Download Links:
    • Commercial: Click here
    • Open Source: Click here
  • Registration: Please note that you will need to register to receive this download. KnowledgeTree customers go directly to the download area via the customer portal. Contact KnowledgeTree Sales for assistance.


Upgrade / Install

System Requirements: Ensure that your environment meets at least the minimum 
platform requirements.


KnowledgeTree Commercial

1. Download the following components:

  • KnowledgeTree Client Tools for Windows
Note: This package downloads as a zipped file; open the zip file; then, click on Setup to launch 
the Setup Wizard.
  • KnowledgeTree Document Workflow Integration (DWI) Service (optional)
  • KnowledgeTree Commercial License (SMB/Enterprise, or Enterprise Trial)
  • KnowledgeTree KnowledgeTree Document Management System (server package)


2. Install downloaded components:

  • KnowledgeTree Document Management System (server package)
  • KnowledgeTree Client Tools for Windows
Note: KnowledgeTree Tools Version 3.4.6 uses Microsoft .NET 1 Framework; KnowledgeTree Tools 
Version 3.5.2 and up will use Microsoft .NET 2 Framework.
  • KnowledgeTree Document Workflow Integration (DWI) Service (optional)
  • KnowledgeTree Commercial License (SMB/Enterprise, or Enterprise Trial)
Install the License in the DMS Administration module of KnowledgeTree's web interface


3. Configure a connection from KnowledgeTree Client Tools to the KnowledgeTree server

Getting Help


Enhancements

This is a bug fix release that repairs several errors in KnowledgeTree 3.4.5. There are no new features in this release.


Known Issues

  • KTC-317: Upgrade from 3.4.2 fails midway

Ugrades from KnowledgeTree Commercial 3.4.2 to KnowledgeTree Commercial 3.4.6 fails midway on Windows XP SP2, and produces the following error: 'No origin file found that matched c:/Program Files/ ktdms/backup/apache2/conf/hhtpd.conf'. To resolve this issue, upgrade from Commercial 3.4.2 to Commercial 3.4.5; then, upgrade to Commercial 3.4.6


  • KTS-2846: IE6 users running KnowledgeTree on Windows 2003 report failures

Internet Explorer 6 users running KnowledgeTree on Windows 2003 have reported failures on some functionality in KnowledgeTree, including the apparent failure of document upload (in this case it was later found that the document had actually been added although upload appeared to have failed), and also disabled functionality on some pages in KnowledgeTree where active scripting is required for KnowledgeTree to work properly - e.g. show all users. It was found that Windows 2003 stops IE6 from running the scripts required for KnowledgeTree to work. To resolve these issues, go to Tools - Options to open the Internet Options dialog. Open the Security tab, click Custom Level. Change custom settings to Medium, and Enable active scripting in the Settings box. Click OK to save your changes.


  • KTS-2866: Files linked to tags containing backslashes ( \ ) are not found when the tag is navigated from the Dashboard
  • KTS-2866: Double quote ("), forward slash (/) and backslash(\) in file and folder names causes Bulk Export to fail
  • KTS-2868: A backslash (\) is added before the quote, double quote and backslash in the Discussion Thread Title and Body

When creating a discussion thread, and the Subject and Body contains a quote, double quote, or backslash (' " \), extra backslashes being added. Related calls: KTS-2855, KTS-2790

  • KTS-2869: User with Delete permission can delete an immutable document
  • KTS-2870: Folder names that include backslashes don't display past the first backslash in the breadcrumb navigation
  • KTS-2873: Double quote (") is not accepted as valid input for metadata when the name of a Lookup field or a Tree field contains a double quote.

Defect Repairs

This release fixes the following errors:

Users received an error, 'Authentication failure. Please try again'. Users created through Active Directory Authentication were unable to login. Related calls: KTS-2772


Automatic Workflow Assignment by Folder did not trigger the workflow to start when a document was moved into that folder. (Environment Windows xp pro sp2). Related calls: KTS-2176, KTC-261


LDAP / Active Directory Authentication returns incorrect fields. This issue was reported on Windows Server 2003 running Knowledge Tree Commercial. On an Active Directory host network, setting the external authenication to LDAP returns the wrong email address (it was using the local domain). The username produced by Active Directory authentication is correct, but the email is wrong. Additionally, the username produced by LDAP is wrong but the email is correct. This issue occurred because the Active Directory plugin was using the UPN as the email address; this was changed so that it uses the mail attribute. To resolve this issue, the attributes retrieved from either directory were rearranged to match the user's fields correctly. The username now comes from the SAMAccountName for both LDAP and AD. If, for some reason, it returns empty then the UserPrincipalName is used to retrieve the username. Related calls: KTS-2013


Users could not login after their passwords were changed in Active Directory. Related calls: KTS-2772, SUP-529


A user reported a problem with Automatic Workflow Associations - there was no page for Type Allocation, or for Action in Browse View. In DMS Administration, when selecting the Automatic Workflow Type, the link to the page for File Type_Workflow Association did not display. This also occurred when selecting Folder Association - the action did not display in the Browse Documents view. The error was related to the new Plugin load system, and fixed for issue KTC-261, in the following environments: Windows Vista (FF2, IE7) Windows XP sp2 O2003 (FF2, IE7) Redhat Linux 5 Oracle Enterprise Linux The different options are now available as expected after the handlers are set - 'Configure Workflow' folder action, and 'Workflow association by document types' admin page.


A user reported that, after upgrading to version 3.4.5, backslashes ('\')were appearing before every quote and double quote throughout their installation in the following environment: Debian / etch, klt commercial ed. version 3.4.5, running on apache, php4 & Mysql. This issue was also reported on Linux Fedora Core 8, PHP 5.4.2, Apache 2.x The error was resolved by removing the function calls to 'sanitizeForSQL()', which was adding slashes before saving the data in the database.


When a user was subscribed to a folder in a large database, the RSS plugin was slowing down loading of the Dashboard. This occurred due to the way in which the latest folder transactions are retrieved from the database. To resolve this issue, the code was optimized by cutting down on the number of times the database has to be accessed. The fix speeds up loading of the Dashboard where the RSS plugin is enabled.


The KnowledgeTree Indexer plugin was not indexing in KnowledgeTree 3.4.5 on a Windows machine. The Indexers are no longer used in KnowledgeTree 3.5.x. The pexec function in the word Indexer was replaced with popen(). A parameter was set to wait until the Indexer script has finished running before continuing through the code.

KTS-2834 After upgrading, the login page displayed an error message after the admin user had entered login credentials: 'Incompatible database version (3.4.5, expected version 3.4.6)'. To resolve this issue, the database version was updated.


Upgrading from KnowledgeTree Commercial 3.3.7 to KnowledgeTree Commercial 3.4.6 failed on Windows XP sp2 with the following error message:

Error message:
Database upgrade to version 3.4.6: Remove backslashes
[db_error: message="DB Error: syntax error" code=-2 mode=return level=notice prefix="" info="/* Script to remove back 
slashes from  ' and " and \ * From the welcome dashlet, folder names and document titles. */ UPDATE help_replacement SET  
description = replace(replace(replace(description, '\\\\', '\\'), '\\\"', '\"'), '\\\, '\), title =  
replace(replace(replace(title, '\\\\', '\\'), '\\\"', '\"'), '\\\, '\); UPDATE document_metadata_version SET name = 
replace(replace(replace(name, '\\\\', '\\'), '\\\"', '\"'), '\\\, '\), description = replace(replace(replace(description, 
'\\\\', '\\'), '\\\"', '\"'), '\\\, '\); UPDATE folders SET name = replace(replace(replace(name, '\\\\', '\\'), '\\\"', '\"'), 
'\\\, '\), description = replace(replace(replace(description, '\\\\', '\\'), '\\\"', '\"'), '\\\, '\); 
[nativecode=1064 ** You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version 
for the right syntax to use near '; UPDATE document_metadata_version SET name = replace(replace(r]"]. 

To resolve this error, the C-style comment block was removed because it seemed to conflict with MySQL, which may only see #'s as valid comment characters.


Bulk uploads of zipped files were failing on Windows Vista with the following error message: 'Bulk upload failed: Could not retrieve contents from zip storage'. The error was resolved with KTS-2859. Related calls: KTS-2859.


A user was unable to upload files in Windows XP and Windows 2003 server. The error was not occurring on most Linux environments or on Windows Vista. This issue was resolved so that Word documents are indexed properly on upload to prevent the system from hanging, in all Windows environments, as a single file upload or when performing bulk uploads in a zip file. Related calls: KTS-2811

When installing KnowledgeTree Commercial on Windows XP, a parse error occurred at the end of the install when the log-in should have displayed:

Error text:
Parse error: parse error, unexpected T_ELSE, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}' in C:\Program 
Files\ktdms\knowledgeTree\lib\util\ktutil.inc on line 218

This was discovered to be an automerge error.


  • KTC-261

The automatic workflow assignment by Document Type and by Folder was not working. When setting the handler to 'Document Type WorkflowAssociator', the 'Workflow Allocation' listing does not display in the 'Document and Workflow Configuration' section. When setting it to the 'FolderWorkflowAssociator' and going in to the folder, the option 'Configure Workflows', to set the Workflow does not display in the folder actions pane on the left hand side. The issue was caused by the way the Plugins are loaded, and not the Workflow. To resolve this issue, the check for which the Workflow Type was assigned was moved into the un_setup() function. It now registers and deregisters the type actions according to which Workflow Type is assigned, as it did previously in the setup function. This was considered the best solution for the current architecture. A deregister plugin helper function was added. The different options are now available as expected after the handlers are set - 'Configure Workflow' folder action and 'Workflow association by document types' admin page. The 'Configure Workflow' folder action is only available when the Workflow association is set to folders. The 'Workflow association by document types' admin page is only available when the Workflow association is set to document type. Related Calls: KTS-2175, KTS-2789


Troubleshooting

n/a


KNOWLEDGETREE CLIENT TOOLS FOR WINDOWS 3.4.6

Release Summary

  • Estimate: 30 January 2008


Upgrade / Install

Click here to open the online Install Guide.


Known Issues

The following errors have been discovered but not yet fixed in KnowledgeTree Client Tools for Windows 3.4.6:

  • Corruption of normal.dot template in Microsoft Office XP

KnowledgeTree Client Tools for Windows attaches its own Word template to documents that are opened in Microsoft Word XP (Word 2002). The normal.dot template, which is prone to corruption in Word XP, causes Word XP to crash. Users are then told to open Word XP in 'Safe Mode'. This occurs more frequently when launching Microsoft Outlook while Microsoft Word is open. This issue occurs with or without KnowledgeTree Client Tools installed.

How to fix this:

  1. Ensure that Word XP configuration does not 'Prompt to save Normal template' on exit.
  2. Locate the normal.dot template (default location is C:\Documents and Settings\<user>\Application Data\Microsoft\Templates)
  3. Delete the normal.dot
  4. A new normal.dot is created the next time Word XP is started.
For more information, see http://support.microsoft.com/kb/291352/en-us.


  • BBS-903: Close a document and the system asks you to save the template

related calls: BBS-1024, BBS-1147,


  • BBS-1024: User is asked to save Normal.dot in Office XP

related calls: BBS-903, BBS-1147, BBS-1147


  • BBS-1153: Characters other than 0-9 and A-Z cause exception and are incorrectly handled in KnowledgeTree Explorer

related calls: BBS-1150


  • BBS-1156: Unhandled exception when updating the document properties dialog with a document type that has unusual characters in its name.


  • BBS-1157: Tags added when uploading from KTE do not display in the Web interface's Tag Cloud dashlet


  • BBS-1159: Exception when attempting to open XLS document after check in


  • BBS-1161: Emails saved to the DMS are not flagged as 'saved'


  • BBS-1170: Problem opening a folder or document in browser

When selecting 'Open in Browser' or 'Open in KnowledgeTree Web' on a folder or document in the right click menu in KnowledgeTree Explorer, the folder or document does not open in the Browser, and the following error displays: 'Web Browser Launch Failure. Please ensure that https:// paths are associated with your default web browser'. This issue is related to the user's Windows configuration - the 'Open in KT Web' feature in KnowledgeTree Tools relies on Windows file associations that cause the execution of http:// urls to launch a web browser. In the absence of the associations, the browser does not launch.

How to set up file associations:

  • On Vista:

1. Go to http://ask-leo.com/where_did_file_associations_go_in_windows_vista.html

2. Follow all Leo's steps; then, configure a web browser for both http and https protocols (for the protocols, scroll all the way to the bottom of the list).

  • On Windows XP:

1. Find the file associations under Folder Options - File Types; then,

2. Scroll down to "URL:HyperText Transfer Protocol" under File Types and click Change... next to "Opens with:"


  • BBS-1172: Foldernames in the KnowledgeTree Explorer left pane don't update during refresh


  • BBS-1183: Exception when attempting to save a previously saved attachment

(Exception [Input string was not in a correct format.] when attempting to save an already saved attachment a second time over the one already saved.) To prevent this issue, avoid attempting to re-save a previously saved attachment, with the same file name, and to the same folder.


Links

Personal tools