IBM WorkplaceTM · Installation, migration, upgrade, ... importCdo failure during set-up of WebSphere Portal..... 9 Installing WebSphere Portal PDM hangs on Windows

IBM WorkplaceTM

Release Notes

Version 2.5 Beta

��

G210-1959-00

Note: Before using this information and the product it supports, read the information in "Notices" on page 115.

Beta Edition (January, 2005)

This edition applies to IBM® Workplace 2.5 Beta, and to all subsequent releases and modifications until otherwise indicated in new editions.

© Copyright International Business Machines Corporation 1994, 2005. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

IBM Workplace 2.5 Beta Release Notes

About this release................................................................................................. 1New in this release..................................................................................................................... 1

Rich client ............................................................................................................................ 1Application plug-in for IBM Workplace Messaging rich client .............................................. 1Release note information for WebSphere Portal available online ....................................... 3Installation and configuration improvements made ............................................................. 3Technical preview................................................................................................................ 3

Notes Mail -- Technical Preview ................................................................................... 3Mobile and Wireless Support -- Technical Preview ...................................................... 4Tech Preview features are not supported by Customer Support .................................. 4Voice Chat technical preview ........................................................................................ 4

Product compatibility .................................................................................................................. 5Composing rich text e-mail messages using a screen reader............................................. 5PKI functionality is not working in the current beta release ................................................. 5

Installation, migration, upgrade, and configuration information ..................... 7Software requirements ............................................................................................................... 7

Notes Mail - Technical Preview Software Requirements..................................................... 7Browser requirements ................................................................................................................ 8

Windows XP SP2 users must enable ActiveX scripting ...................................................... 8Installation notes ........................................................................................................................ 8

Collab. Ctr. People Finder portlet not compatible with 2.5 .................................................. 8Display problems with Installation screens .......................................................................... 8Exception when creating new Teamspace with Cloudscape............................................... 8Files not removed after installation if servers are running ................................................... 9importCdo failure during set-up of WebSphere Portal ......................................................... 9Installing WebSphere Portal PDM hangs on Windows 2003 servers .................................. 9Linking to a JDK that was not installed by DB2 ................................................................... 10Reducing deadlock on WebSphere Portal databases ......................................................... 10Troubleshooting the lwpT-portal-setup configuration target ................................................ 11Use the same DBMS for all IBM Workplace databases ...................................................... 11WebSphere updates required for proper name caching...................................................... 11Windows 2003 - Benign error message on Win2003 installations ...................................... 12IBM Workplace Collaborative Learning ............................................................................... 12

Unable to enter international group names for Learning............................................... 12IBM Workplace Rich Client .................................................................................................. 13

Can’t install rich client with IIS HTTP server ................................................................. 13Documentation on provisioning server URL provider is vague ..................................... 13Download link will not auto install if JRE is not installed ............................................... 14Interrupting the installation/provisioning of the Rich client ............................................ 15Linux - Mozilla bean not showing up in client installer .................................................. 15Logging in to IBM Workplace as Offline causes errors ................................................. 15Missing Accelerator keys in provisioning components install ....................................... 16Providing a trusted root certificate to users................................................................... 16Salvaging a user’s workspace after an uninstall ........................................................... 16Specifying an install location for the Rich client ............................................................ 18User access rights required for rich client installation ................................................... 18Versions not specified in IWCT Server Client install screen ......................................... 18

Technical Preview ............................................................................................................... 18Adding the Notes Mail portlet page ............................................................................... 18


Enabling wireless access to Notes portlets................................................................... 19Upgrade notes ........................................................................................................................... 19

IBM Workplace Rich Client .................................................................................................. 19Must start server1 for 2.01 Rich Client to upgrade to 2.5 ............................................. 19

Configuration notes .................................................................................................................... 20Configuring displayName attribute for Active Directory ....................................................... 20Create a full-text index on the Domino Directory ................................................................. 20Dynacache requirement ...................................................................................................... 20How to disable email notifications for the Team Project template ....................................... 20LDAP referrals not followed by default ................................................................................ 21SMTP server - LMS Mail (Calendar and Enrollment notifications) ...................................... 21Tips for using Domino directory assistance ......................................................................... 21wpsadmin authorization error when using Domino Directory .............................................. 23"Automatically create mailboxes" affects calendar as well .................................................. 23IBM Workplace Collaborative Learning ............................................................................... 23

Learning Requirements when connected to MS IIS 5.0 HTTP Server.......................... 23Updating Learning Settings on a data-only DB2 server ................................................ 23

IBM Workplace Rich Client .................................................................................................. 24Changing from one user’s workspace to another on one machine ............................... 24Changing the specified provisioning server .................................................................. 24Client supports one machine per user (credential store) .............................................. 24Configuring the rich client to use non-standard HTTP ports ......................................... 24Configuring use of the Edit My Profile link for Domino Directory .................................. 24Issuing user credentials through a Certificate Authority................................................ 25LMS server timing out users while they are taking courses .......................................... 26Removing the rich client workspace ............................................................................. 27Unsupported Rich client offering policy configurations ................................................. 27

IBM Workplace Messaging.................................................................................................. 27Import command issues ................................................................................................ 27Mailbox database script creates a ${env.TEMP} directory ........................................... 28

Technical Preview ............................................................................................................... 28Domino V6.5.2 settings to enable Domino XML Services ............................................ 28Initial User Configuration for the Notes Mail Portlet ...................................................... 29

Uninstallation information........................................................................................................... 29IBM Workplace Rich Client .................................................................................................. 29

HTTP server plugin should be regenerated during uninstall ......................................... 29

Known limitations, problems, and workarounds............................................... 31Limitations .................................................................................................................................. 31

Configuration issues ............................................................................................................ 31Admin users can only see the Workplace applications they create .............................. 31

IBM Workplace Collaborative Learning issues .................................................................... 31Collaboration Templates not available .......................................................................... 31Discussions: Child documents are not deleted with parent .......................................... 31Do not use Intellexis’ close button; tracking will not work ............................................. 31Issues with User Permission Report and DBCS characters ......................................... 31Reports cannot be generated in PDF format ................................................................ 31Some templates are not instantiating in the template catalog ...................................... 32Student interface: Font size changes using Internet Explorer ...................................... 32User search may fail for names with DBCS and accented characters ......................... 32


Wildcarding in a course search is not supported for all fields ....................................... 32IBM Workplace Documents issues...................................................................................... 32

Client-side size limitation for importing documents ....................................................... 32Default folder in Document Library has human-unreadable name ............................... 33Desktop Integration messages do not appear on client terminal .................................. 33Do not use Portal Administration to maintain applications ............................................ 33Installed workplace templates are locked for editing .................................................... 34Search for Document Title or Document Description fails ............................................ 35

IBM Workplace Rich Client issues....................................................................................... 35Cannot skip the update of a .jar file .............................................................................. 35Client mail messages on Linux do not convert URLs to hotlinks .................................. 35F1 functionality in this release ....................................................................................... 35Hover text may not display properly .............................................................................. 35Instant Contacts - Can’t sort list of contacts.................................................................. 35Issues with spell check on Linux with rich client ........................................................... 36Language to search has to match the client’s Regional Settings ................................. 36Limits for IBM Workplace Messaging............................................................................ 36Lowest ranking search results appear at the top .......................................................... 37MIME messages with GIFs generate errors in client messaging .................................. 37Outlook mail background color not displaying in client messaging ............................... 37Rich-client Search does not support use of wild-card characters ................................. 37Rich client fails to check if an account has been deleted .............................................. 37Signing verification that uses the UID attribute not supported ...................................... 37User cannot cancel a search once it begins ................................................................. 37WCT does not support Tivoli Access Manager (TAM).................................................. 38"Export" command is not working ................................................................................. 38

IBM Workplace Team Collaboration issues......................................................................... 38Description text missing from Default templates in Editor............................................. 38HTTP tunnel cluster base URL is hardcoded ................................................................ 38Limitations for Web Conference templates and applications ........................................ 38Meetings cannot be deleted when Messaging is not installed ...................................... 39Search for Discussion Topic in Subject fails ................................................................. 39

Security................................................................................................................................ 39Certificates in the admin console are improperly formatted .......................................... 39Creation of separate credentials not supported ............................................................ 39Importing of some PKCS12 files is not supported ........................................................ 39Reverse Proxy Support ................................................................................................. 40

Browser issues .................................................................................................................... 40Directory Search Help problem with Lotus Notes client settings .................................. 40

Portlet issues ....................................................................................................................... 40Option to overwrite template is given when not applicable ........................................... 40Remove Contact from Instant Contacts limitation ......................................................... 40

IBM Data Access Tool ......................................................................................................... 40Database application names are limited to 50 or fewer characters .............................. 40Input mode values cannot be changed for certain data types ...................................... 41Printing limitations ......................................................................................................... 41Right-to-Left format is not supported in this release ..................................................... 41

Activity Explorer ................................................................................................................... 42Cannot add groups to the membership list of a shared object ...................................... 42


Cannot open activity explorer by dragging file to a contact .......................................... 42Cannot print directly from shared objects ..................................................................... 42Cannot search across shared objects........................................................................... 42No detailed activity logs ................................................................................................ 42No round-trip editing for shared files............................................................................. 42No support for off-line use or archiving ......................................................................... 42No versioning or real-time editing of shared notes ....................................................... 42Not all chats are persistent ........................................................................................... 42

Technical Preview ............................................................................................................... 43Notes Mail - Junk Mail feature is not fully implemented ................................................ 43NotesMail - Configuration Options which are not implemented .................................... 43NotesMail - Confirm Delivery feature does not work..................................................... 43NotesMail - Preference Options which are not implemented ........................................ 43Objects in e-mail message not displayed on wireless device ....................................... 43Restored Mail folder is not implemented in Notes Mail ................................................. 43Search feature is not implemented ............................................................................... 43Usage quota is not implemented .................................................................................. 43

Known problems and workarounds............................................................................................ 44Installation issues ................................................................................................................ 44

All Workplace / Cloudscape installs need workplace.properties ................................... 44Cannot remove workspace directory after install - need to reboot ................................ 44File not found error message upon running install.bat .................................................. 44High contrast mode may cause installers to mis-render ............................................... 45Importing users from LDAP using Tivoli Access Manager ............................................ 45Provisioning component uninstall leaves log files ......................................................... 45Provisioning URL wrong for IEOP installation............................................................... 45UpdatePDM fails on Windows using the default installation folder ............................... 46

Configuration issues ............................................................................................................ 47Additional steps to set correct heap size of JVM .......................................................... 47Administrative Console field validation is not working correctly .................................... 47Attachment viewer may require additional software installation ................................... 47Authorization Data Exception during lwpT-portal-setup ................................................ 48Cannot log into IBM Workplace if LDAP server is restarted ......................................... 48Datasource Issue when Configuring WebSphere Portal for DB2 ................................. 49enable-security-ldap fails with Authorization Exception ................................................ 49Exposed passwords in configuration and support files ................................................. 50Incorrect default theme ................................................................................................. 51java.net.ConnectException errors during running config targets .................................. 53LMS uses the uid attribute to authenticate user in LDAP ............................................. 53Manage Workplace Applications page is not working ................................................... 53Non-Workplace theme gives JavaScript errors & missing GIFs ................................... 53Out of Memory Exception Errors in running config targets ........................................... 54Some Admin Console i-tag help links aren’t connected................................................ 54User Policy setting and new categories for catalogs .................................................... 54Web Server setting needed to support WCT downloads .............................................. 55Windows 2003 using Lwp.db.drop=true does not work ................................................ 55"Too many open files" exception ................................................................................... 55

IBM Workplace Collaborative Learning issues .................................................................... 55Cannot log into <servername>/lms-lmm ....................................................................... 55


Courses with a file-based CMI activity will not launch on XP........................................ 55Limitation of JReport Server Engine for Bi-di characters display .................................. 56Skills Dictionary - Cannot remove proficiency levels .................................................... 56Some IE browsers may hang if student uses the ’Previous’ button .............................. 56Tracking doesn’t work with separate LMS and Delivery servers .................................. 56"Value must be a double" message when viewing course results ................................ 56

IBM Workplace Documents issues...................................................................................... 56Applications containing Team Tasks limit names to 100 characters ............................ 56Configuring Documents e-mail notification ................................................................... 56Document Editors issues .............................................................................................. 57Project Planner ............................................................................................................. 59

IBM Workplace Rich Client issues....................................................................................... 59’Reply To All’ & ’New Message To All’ inserts extra addressee.................................... 59’Using a wizard’ update/install option only supported in English................................... 59Accessibility issues ....................................................................................................... 59Address book entry issues ............................................................................................ 60Calendar and calendar entry issues ............................................................................. 60Calendar globalization issues ....................................................................................... 61Chat window font limitations ......................................................................................... 61Client shortcut replaced on second install to new location ........................................... 61Cursor not displaying after tabbing to the body of mail message ................................. 61Differences in rich client Change Password functionality ............................................. 61Disappearance of the Messages navigator section ...................................................... 61Document editors and document library issues ............................................................ 62Enabling accessibility features for the document editors .............................................. 63Error messages send users to error logs without location ............................................ 63Files remain in user home directory after client uninstallation ...................................... 64Globalization issues ...................................................................................................... 64Help menu in chat window does not work ..................................................................... 64IBM Workplace appears unresponsive and CPU usage spikes.................................... 64IBM Workplace becomes unresponsive after the server goes down ............................ 64IBM Workplace becomes unusable disconnected ........................................................ 64IBM Workplace Client v. 2.0.1 Turkish needs fix from IBM ........................................... 64IBM Workplace may pop up over another application .................................................. 64If Network outage may need to remove workspace to provision .................................. 65IM display problems in "High Contrast" mode............................................................... 65Instant messaging - Reconnecting if network goes down............................................. 65License agreement is truncated for some non-English languages ............................... 65Linux - Can’t download client from provisioning server................................................. 65Linux - People Finder/Links may not work in Rich client ............................................... 65Linux issues .................................................................................................................. 66Logoff/logon required after restarting stopped SSO service ......................................... 67Mail issues .................................................................................................................... 67Meeting issues .............................................................................................................. 68No delete dialog when deleting roles with special characters....................................... 68Occasional display of blank Preference panes ............................................................. 69Offline issues ................................................................................................................ 69Page not found / no response from rich client download link........................................ 69Provisioning can fail without error due to disk space .................................................... 69


Reply using chat not available in saved chat transcript ................................................ 69Rich client install problems when path contains Unicode ............................................. 69Rich client will crash when using the Web browser on a SSL site ................................ 69RTL layout not rendered despite locale setting............................................................. 70Selected group in Instant Contacts not displayed ......................................................... 70Sorting in Preferences different in non-English version ................................................ 70Spell checker issues ..................................................................................................... 70Synchronization issues ................................................................................................. 70Temporary files can be deleted after installing rich client ............................................. 71Unable to edit Draft messages moved from Outbox ..................................................... 71Update silently installs unsigned features without warning ........................................... 71User defined links on Linux when connected via proxy server ..................................... 71User not warned during install of an unsigned nested feature ...................................... 71

IBM Workplace Messaging issues....................................................................................... 72Bad mail address produces ’Person exists outside search bases’ ............................... 72Calendar issues ............................................................................................................ 72Cannot import a calendar from a pre-2.0 zip file ........................................................... 72Cannot run trace logging on POP3 and IMAP mail services ........................................ 72End Date/Time fields not always reset properly ............................................................ 72Extraneous "?" displayed at the end of some messages .............................................. 72Folder created on back end won’t show up immediately in UI ...................................... 73Hit ’F5’ to refresh whenever you delete a Calendar Event............................................ 73Import of some calendar entries causes parser exception ........................................... 73Incorrect message when removing a contact from the address book........................... 73Lag between updating an account and testing it with ListAccounts .............................. 73ListAccounts command does not show friendly name .................................................. 73Lmadmin commands..................................................................................................... 74Lmadmin tool limitations when using Cloudscape as a datastore ................................ 75Log messages may be in mixed languages .................................................................. 76Mail issues .................................................................................................................... 76Managing the user preference cache for the mail portlet .............................................. 77Maximum SMTP connections is off by -1...................................................................... 77Meeting issues .............................................................................................................. 77Message attachment issues ......................................................................................... 77Messages not relayed to list members if members not in LDAP .................................. 78Migrating calendar events become appointments ........................................................ 78No localization support for Lmadmin commands .......................................................... 78NotesMail - Config info not defaulted into Mail Preferences ......................................... 78Restricting users from sending mail to groups does not work ...................................... 78Rich client does not handle signed and encrypted messages ...................................... 78Searching indexing lag time and troubleshooting ......................................................... 78Seems like e-mail is deleted randomly ......................................................................... 79Sending mail to groups without a mail address does not work ..................................... 79Spell checker issues ..................................................................................................... 79Suspending a rich client mail account does not work ................................................... 79Time fields not checked for validity on Save ................................................................. 80Toggling Hide Folders/Show Folders may alter folder expand state ............................ 80Using Mailing Lists with installs that generate WMM external IDs ................................ 80

IBM Workplace Team Collaboration issues......................................................................... 81


A contributor who is also an owner has moderator access........................................... 81Assign task or change owner to explicit member only .................................................. 81Cancel membership in a web conference hosted by a Linux server ............................. 81Canceling membership in public space ........................................................................ 81Cannot add users with Traditional Chinese locales to team space .............................. 81Chat feature generates error messages ....................................................................... 82Contributor has moderator access if a member of moderator group ............................ 82Counts in membership are inconsistent ........................................................................ 82Deadlock when users simultaneously create team spaces .......................................... 82Directory search of a team space not returning results ................................................ 82Enabling Team Collaboration mail notifications ............................................................ 83Error inviting groups to a team space ........................................................................... 83Extended Search config form cannot handle carriage returns ...................................... 83For network deployment, a contributor can rename a team space............................... 83Instant Contacts display problems when using high contrast ....................................... 84Instant Messaging - Livenames and presence indicators ............................................. 84Instant Messaging - On-line tag may show disconnected............................................. 84Limitation in the number of invited groups for an application ........................................ 84Membership portlet user names appear in mixed languages ....................................... 84No warnings if team space exceeds policy size limits .................................................. 85Problems with IBM Workplace applications using Cloudscape .................................... 85See old leave message if cancel and then return to space .......................................... 85Shared member of two groups may not have correct access to space ........................ 85Team Space Search index gets deleted on first restart of server ................................. 85UNIX - PowerPoint files not displaying as a preview in Documents ............................. 86Web conference should not be in catalog ..................................................................... 86You must enable cache replication in network deployment .......................................... 86

IBM Workplace Forms issues.............................................................................................. 86Edits to a form template title creates a new form portlet ............................................... 86Field displays "changed" after selecting name in People Selector ............................... 86Moderator & Contributor roles portlet in application not working .................................. 87New form portlets created by non-admin are not found ................................................ 87Only first name selected displays in form portlet view .................................................. 87

IBM Workplace Templates and Applications issues ............................................................ 87Application parameters display at instantiation ............................................................. 87Cannot edit a template more than twice ....................................................................... 87Component properties do not show default parameter values ..................................... 87Default editor/user policy cannot be re-added .............................................................. 87Edited component properties are not immediately refreshed ....................................... 88Form Template Library title is incorrect ......................................................................... 88Template Catalog shows inaccessible templates ......................................................... 88Template Editors can change Template Owner ............................................................ 88Values specified for application parameters are not validated...................................... 88

People components............................................................................................................. 88Directory Search results not displaying a user’s title .................................................... 88Person tag links not updated when user information changes ..................................... 88Pop-up windows can trigger login screen ..................................................................... 88

Security................................................................................................................................ 89Domino CA occasionally refuses to certify Workplace certificates ............................... 89


If the HTTP session times out, you may lose unsaved work ........................................ 89Incorrect error message importing an invalid PKCS12 objects ..................................... 89Logout/login required to see newly added certificates .................................................. 89Mail encryption fails for contacts newly added to PAB ................................................. 89Repeating error message: "Authentication failed for <null>"......................................... 90Security implications with WMM ................................................................................... 90Security issue when IBM Workplace has write access to LDAP................................... 91Security vulnerability between Workplace and MS PKI EJB servers ............................ 91Some Verisign CA cert attributes are not supported..................................................... 91Special characters could prevent wpsadmin from authenticating ................................. 91You may be prompted twice to trust same certificate ................................................... 91

International language support ............................................................................................ 92Active Content Filtering on non Latin-1(ISO-8859-1) documents ................................. 92

Browser issues .................................................................................................................... 92Back button shows information after logout .................................................................. 92Chat may not work using Mozilla browser .................................................................... 92JavaScript error when performing certain tasks ............................................................ 92Problems with SCORM courses not working on Linux/Mozilla ..................................... 92Rich Text Editor Spell Check w/ tables in doc concatenates text ................................. 93Some Learning functionality not supported in Mozilla browser ..................................... 93Spell Check corrupts tables in Rich Text Editor ............................................................ 93Text indentation not visible in HTML view in Presentation editor .................................. 93

Portlet issues ....................................................................................................................... 93Blank page upon login to IBM Workplace ..................................................................... 93Entries are deleted after logging out ............................................................................. 94Instant messaging if SIP server fails ............................................................................. 94No ’Show All’ option after search in Manage Document Libraries ................................ 94User is logged out if working in open document over two hours................................... 94Web conferencing PowerPoint slide display problems ................................................. 94Windows may flicker and disappear ............................................................................. 94WebSphere Portal issues ............................................................................................. 95Contact information not always saved successfully ...................................................... 95

IBM Data Access Tool ......................................................................................................... 95Cannot import or export applications without the data definition .................................. 95Combination box list items don’t update when new items are added ........................... 95Error message 23502: columns cannot accept Null value ............................................ 95Form closes without warning after deleting last record ................................................. 96Images on buttons do not appear when previewing forms ........................................... 96Red cross appears instead of error message ............................................................... 96Renamed columns do not appear in data binding drop-down list ................................. 96Renaming a table .......................................................................................................... 96Select correct computed expression for summaries to work ........................................ 96Some border styles appear incorrectly in data access designer................................... 96

Activity Explorer ................................................................................................................... 97Alert notifications not working ....................................................................................... 97Default display can become corrupted.......................................................................... 97Modification data for some objects is not updated properly .......................................... 97Wrong options included in context menus for restricted objects ................................... 97

Technical Preview ............................................................................................................... 97


Admin mail preference values are default for new portlet users ................................... 97All sent messages are saved in the sent folder ............................................................ 98Bad email addresses may not return delivery failures .................................................. 98Caveats using the ’Move to Folder’ button to move messages .................................... 98Delete Folder from Notes Mail does not work ............................................................... 98Errors occur when deleting documents or folders......................................................... 98If Soft delete is disabled, you cannot empty the trash folder ........................................ 98If Soft Delete is enabled, Messages in Trash lose field values ..................................... 98Issues with documents saved as drafts ........................................................................ 99Junk Mail dialog can’t be reinvoked after checkbox is checked.................................... 99Messages are lost after renaming a user’s folder ......................................................... 99Misleading wireless message if Notes mail source not configured ............................... 99NotesMail - Changing portlet’s mail source .................................................................. 100NotesMail - Do not change Mail server type/protocol ................................................... 100NotesMail - Syntax Error when clicking Edit Mail Source button .................................. 100NotesMail - Username/Password fields in Mail Preferences ........................................ 100Sending mail addressed to Notes name causes Domino to crash ............................... 100Special characters display incorrectly in subject, body of email ................................... 100Tabbing and focus issue in a Mail message ................................................................. 100Unread marks not working for new messages .............................................................. 100When reading a rich text message, text colors are not displayed................................. 101When reading rich text messages, inline images are not displayed ............................. 101Wireless: Body text lost using address lookup on forwarded mail ................................ 101Wireless: Error when opening/restoring message in Trash folder ................................ 101Wireless: Invalid addresses deleted without error message ......................................... 101Wireless: Navigation of Folders w/ Pocket PC IE skips messages............................... 102

Documentation updates....................................................................................... 103IBM Workplace Information Center ............................................................................................ 103

Additional components IDs for messages ........................................................................... 103Configuring the IMAP service .............................................................................................. 105Help incorrectly references mobile client in user policies .................................................... 106HTML table of contents cannot be collapsed in Mozilla ...................................................... 106Installing and configuring the IBM Tivoli Directory Integrator .............................................. 106Mozilla for Windows............................................................................................................. 107Quota manager does not delete calendar and address book entries .................................. 107Servers can have Mail services or SIP services, but not both............................................. 107IBM Workplace Collaborative Learning ............................................................................... 107

Some Virtual Classroom features do not apply to Learning users ................................ 107Workplace skills are different from WCL instructor skills .............................................. 107

IBM Workplace Rich Client .................................................................................................. 108Help system error for "Always encrypt" and "Never encrypt"........................................ 108Plug-in Help not provided for some client plug-ins ........................................................ 108

Security................................................................................................................................ 108Enabling non-wpsadmins to manage client certificates ................................................ 108Error in "Configuring the IBM HTTP server to use a certificate" ................................... 108Update to "Securing the network for IBM Workplace" topic .......................................... 109Updates to "Importing a certificate into the WAS trust stores" ...................................... 110

IBM Workplace Portlet Help ....................................................................................................... 110Application Membership help refers to team spaces........................................................... 110


Chat Room Archives Help doesn’t open.............................................................................. 110Mail and rich text editor keystrokes ..................................................................................... 110Web conference templates are not customizable................................................................ 110Wildcard (*) character in People Finder and Directory Search............................................ 111IBM Workplace Collaborative Learning ............................................................................... 111

Approval process for an Approver ................................................................................ 111IBM Workplace Rich Client Help ................................................................................................ 111

IBM Workplace Rich Client .................................................................................................. 111Accessibility, Keyboard commands - Help update ........................................................ 111Emulator icon not available in this release.................................................................... 111Mail Help issues ............................................................................................................ 112Stand-alone document editor file commands ................................................................ 112

IBM Data Access Tool ......................................................................................................... 112Disable/Enable setting on a control .............................................................................. 112Using relationships - Help correction ............................................................................ 112Using values defined from table columns - Help correction .......................................... 113

Notices and Trademarks ...................................................................................... 115Notices ....................................................................................................................................... 115

Copyright notices and information regarding non-IBM software.......................................... 115JReport - license information............................................................................................... 127

Trademarks ................................................................................................................................ 128Trademark list...................................................................................................................... 128


About this release

New in this release

Rich client The rich client versions of IBM(R) Workplace products provide the usability and the support for offline use traditionally found in desktop applications, with the manageability of Web-based applications. As updates to your applications become available, your administrator can make them available on your desktop.

IBM Workplace Messaging IBM Workplace Messaging(TM) includes Mail, Calendar, Address Book, and Instant Messaging. Using IBM Workplace Messaging, you can send and receive e-mail messages, maintain a personal calendar, save contact information for people and group mailing lists, work offline, participate in online chats, and save chat transcripts.

IBM Workplace Documents IBM Workplace Documents provides library services for document check-in and check-out, document locking, and versioning. It includes a set of document editors, which allow you to work with word-processing, presentation and spreadsheet documents. Using IBM Workplace Documents, you can store documents in a local, encrypted data store, which can help increase security against viruses and other risks. You can create personalized views of document libraries. In addition, you can work offline to create, import, edit, and save documents.

This release contains some technical previews of features that may appear in a future release. These include response chains, identifying messages that are sent only to you , and the ability to access Notes databases, documents, and views.

Customers or business partners who are interested in the IBM Workplace client should contact their IBM representative for more details.

Application plug-in for IBM Workplace Messaging rich client The Notes Application Plug-in is included as part of the Notes / Domino 7.0 beta release, and is designed to work in conjunction with the Lotus Workplace Messaging rich client. The Lotus Workplace Messaging Rich Client Edition is a new offering that utilizes IBM Workplace Client Technology. For purposes of these Release Notes, Lotus Workplace Messaging will be referred to as the "rich client" below.

This plug-in is being delivered as part of Notes / Domino 7.0 beta and, as such, we welcome feedback on the usage of this capability as we continue our development activities in this area.

At this time only a limited number of applications have been verified with this environment. They are theTeamroom (teamrm7.ntf), Discussion (discsw7.ntf), and Journal (journal6.ntf) databases which are built using the out-of-box Notes 7.x templates. In the sections below, you will find details on how to access and work with these applications. Although the number of applications verified is limited, we are very interested to hear about experiences running other Notes Domino Applications.

System Requirements

In addition to having the Lotus Workplace Messaging rich client 2.5 beta installed, the following are required:

� IBM Lotus Notes Client 7.0 Beta 3 for Windows Installed on the same machine as the rich client

� Minimum System Memory 512 MB (recommended 1 GB)

� Diskspace of 275MB

1


Configuration Instructions

� Install IBM Lotus Workplace Messaging rich client 2.5 beta.

� Install IBM Lotus Notes 7 Client Beta 3 from this web site http://www-10.lotus.com/ldd/beta/nd7pubbeta.nsf

Operating Instructions

� The Notes applications are accessed via the rich client by selecting from the Switcher Bar and selecting the Notes Applications Icon.

� The Notes Application component provides access to your Notes Applications which can be selected through the Notes Application navigator. Initially the application displayed will be the default page configured for the Notes client.

� Once the Notes Application is active the menus available to the Notes Client will also be available from within the rich client while the Tabbed Pages are showing Notes content.

Known Limitations and Problems

1. Any settings you have set in Notes will also be set in the rich client. So, for instance, if you have Single Sign On turned on in Notes, you will not be prompted for a login to Notes when switching to the Notes Application component. However, if you have it turned off, you will be asked to sign into Notes. This holds true for the Sametime client as well.

2. In general preference settings can be modified from within Notes Plugin, however some items such as Toolbar modifications will not have any effect until the Notes Client is utilized as the toolbars are not available within the rich client.

3. Notes Auto Logout is not putting up the Logout screen in the rich client. The databases are locked and cannot be edited without a password, but the top database is visible.

4. If a database is open in Notes, and you try to open the same one in the rich client, it will not open. However, if you open it first in the rich client and then try to open the same db in Notes, Notes will bring the rich client to the foreground to display the database.

5. If you have Designer opened and you open a database in the rich client, you cannot close Designer until the Workplace client has been closed.

6. If you have the Workplace Client open as well as Notes and Designer, selecting to close Designer will actually close the Notes client. Designer will remain open until the Workplace Client is closed.

7. The Startup folder bookmarks are not available from the Notes Application Navigator.

8. Some Accelerator keys that move the main window are not available when accessing Notes applications in the rich client.

9. When clicking on the 'X' to close a document, if the document needs to be saved, the tab disappears and then you are prompted to save your document. If you are closing several documents, you will not be able to tell which document is prompting you to be saved. If you click Cancel, the tab will be restored and will allow you to close it again.

10. Hitting the F10 key with a Notes database open and then clicking on the top-level menu will cause the Workplace Client to hang. You must restart the Workplace Client to recover.

11. Clicking on a database bookmark will sometimes bring up the "Search for Database" dialog. However, if you right-click on the bookmark, select "Open Replica," and choose your database from there, it will open correctly.

12. If the Workplace Client crashes while you are working on an autosave-enabled document, you will be prompted to recover the document when the Client is restarted. Even though the document does not display when you click on it and select Recover, it is there in the autosave database. You can check this by opening the autosave database.

13. Double-clicking on an attachment from a document that is in the Autosave directory will display the error message "Note item not found" and the Workplace Client will hang.

14. When working with an outside application, such as IE, if you give focus back to Workplace Client by clicking on the File menu in the Notes Application view, your application could hang. When giving focus to the Workplace Client, we recommend you click on the title bar or within a view and then select the menu.

15. When using IBM Workplace and the Lotus Notes Rich Client with Calendaring & Scheduling Alarms enabled, opening a calendar entry from the Alarm dialog may result in the dialog having incorrect focus. In some situations, the dialog will have focus instead of the entry. You may also encounter the Alarm dialog disappearing behind the Lotus Workplace application after editing the entry without first dismissing the dialog.

2


16. When using IBM Workplace and the Lotus Notes Rich Client with Calendaring & Scheduling Alarms enabled, you may encounter the error "entry not found in index" or "The document specified by the link cannot be located within the linked-to database" if you open the Calendar from the Workplace - Today Welcome page prior to receiving the Alarm.

17. When using IBM Workplace and the Lotus Notes Rich Client with Calendaring & Scheduling, if the meeting chair reschedules a meeting using the drag and drop method, the meeting will not appear on the calendar at the new day/time until the view is manually refreshed with F9.

18. When using the IBM Workplace client and you have Lotus Notes installed with the Calendaring & Scheduling Alarms enabled, you may see a situation when the perspective is set to another IBM Workplace application (like Messaging) and the Lotus Notes Alarms dialog displays. Opening the C&S entry from the Alarm dialog will display the entry in the preview frame of the Messaging perspective.

19. When using IBM Workplace and the Lotus Notes Rich Client with Calendaring & Scheduling Alarms enabled, the IBM Workplace application is not restored from the minimized state when you receive an Alarm dialog and attempt to open the calendar entry from the dialog.

Release note information for WebSphere Portal available online The WebSphere Portal 5.0.2.2 release notes include up-to-date information about product usage, installation, administration, and troubleshooting, and are available online at:

http://www.ibm.com/websphere/portal/library

Installation and configuration improvements made In IBM Workplace 2.5, the deployment time for a WorkPlace Server has been significantly decreased by including an Archive Installer, as well as Configuration Wizards.

The Archive Installer copies a pre-configured Workplace server image to your system. Once this image is copied to the server, it takes only minutes to install by changing the settings to match what is needed specifically for your machine and environment.

The Configuration Wizards will take you through an automated process of setting up a specific database server. For the current Beta release, IBM is supporting DB2, so that you can take advantage of this functionality, and provide us with feedback/comments. When the final IBM Workplace 2.5 release is shipped, you will have additional database options to choose from. Wizard technology is also being used to help set up your in-house LDAP directory; for this Beta release, we are supporting IDS, as well as Lotus Domino directory; for the final IBM Workplace 2.5 release, you will have additional options to choose from.

Technical preview

Notes Mail -- Technical Preview IBM Workplace 2.0 ships with a technical preview of the Notes Mail portlet. Technical previews are provided so that you can read about and try features that may be included in a future release. Because these features are still under development they are not fully tested, are unsupported, and may produce unexpected results. To enable the Notes Mail portlet, see the Installation and Configuration sections of these release notes. This feature is not supported by IBM Customer Support and should not be deployed in a production environment.

3


Mobile and Wireless Support -- Technical Preview IBM Workplace 2.0 ships with a technical preview of portlets enabled for access from a wide range of mobile and wireless devices. The portlets enabled for mobile and wireless access are the Notes Mail technical preview portlet, and the Address Book portlet.

Devices supporting the following markup languages are enabled by this technical preview:

� WML � XHTML Basic � XHTML Mobile Profile � i-Mode � HTML 3.2 (for the Pocket PC)

Technical previews are provided so that you can read about and try features that may be included in a future release. Because these features are still under development they are not fully tested, are unsupported, and may produce unexpected results. Access from mobile and wireless devices is enabled when the Notes Mail portlet is enabled, as described in the Installation and Configuration sections of these release notes. This feature is not supported by IBM Customer Support and should not be deployed in a production environment.

Tech Preview features are not supported by Customer Support IBM Workplace 2.0 products ship with some components or features that are "tech preview" items. Technical previews are provided so that you can read about and try features that may be included in a future release. Because these features are still under development, they are not fully tested, are unsupported, and may produce unexpected results.

These features are not supported by IBM Customer Support, and should not be implemented or enabled in a production environment.

Two technical forums have been set up for customers. These forums can be used to exchange information between customers and to leave feedback for IBM.

The URL for all of the Tech Preview items except Common Mail Portlet is: http://www.lotus.com/ldd/beta/lwp20tpbeta.nsf

The URL for the Common Mail Portlet for Domino is:

http://www.lotus.com/ldd/beta/nptpbeta.nsf

For details about which features are offered as a "tech preview" only, please refer to technote #1168533.

Voice Chat technical preview Voice Chat is a technical preview feature in Workplace Client Technology that allows users to speak to each other using their computers' microphone and speakers.

Users must be assigned to a user policy that allows them to use Voice Chat. Also, a user must be either online, or offline but connected, to receive an Voice Chat invitation.

To start a Voice Chat 1. Click Actions -> People -> Start Voice Chat. Or right click on a buddy list name and click Start Voice Chat. 2. Click OK in the following dialog: "The invitation to start an audio conversation has been sent. Please wait for the

person to either accept or decline it."

If the person accepts your invitation to chat the Voice Chat dialog opens.

To accept a Voice Chat invitation Click Accept when you see the following dialog: "<the person’s name> has invited you to start a Start Voice Chat.... If you accept the invitation, you will talk using your computer’s microphone and speakers. If you decline, <the person’s name> will be notified."

To decline a Voice Chat invitation Click Decline when you see the following dialog: "<the person’s name> has invited you to start a Start Voice Chat.... If you accept the invitation, you will talk using your computer’s microphone and speakers. If you decline, <the person’s name> will be notified."

4


To hang up Click Hang Up.

To control volume To control the volume of your voice, click and hold on the volume control bar and move it right (to increase) or left (to decrease).

To mute a Voice Chat To mute a chat, select Mute next to the person you want to mute, for example, to mute yourself select Mute next to your name.

Product compatibility

Composing rich text e-mail messages using a screen reader If the policy for rich text editing permits it, users can elect to create the body of an e-mail message using plain text or rich text; the rich text editor component is based on an underlying editing component, provided by the browser. Until recently, this editor component did not work properly with screen reader software.

GW Micro has now released a version of its Window-Eyes screen reader software that does work with the rich text editor. Window-Eyes 4.5 SP2 is free for download from GW Micro if you already have Window-Eyes 4.5 or 4.5 SP1.

Interacting with the rich text editor is similar to interacting with a text area field on the page. A user may enter text, hear existing text spoken, and select and modify text. The keystrokes used to interact with and modify the text in the editor are listed below. Select the text to be modified before invoking these commands:

control-shift-m will invoke a toolbar in a separate window. The user can interact with the toolbar to apply formatting (bold, italics, alignment, fonts) to selected text in the editor.

control-shift-g will invoke a color picker dialog where the user can select a foreground color to apply to selected text in the editor.

control-shift-j will invoke a color picker dialog where the user can select a background color to apply to selected text in the editor.

control-shift-t will invoke a dialog to insert a table at the current cursor position in the editor.

Some of these keystrokes are already mapped by Window-Eyes (control-shift-m and control-shift-t); in order to use these commands within Window-Eyes, you must first issue the Window-Eyes bypass key sequence, ins-b, before invoking the editor command.

PKI functionality is not working in the current beta release The Public Key Infrastructure (PKI) functionality is not available in this beta release of IBM Workplace 2.5. Domino Certificate Requests will not be processed.

This issue is occurring after a Certificate is created for the Domino Adapter; the Submit request fails.

5


Installation, migration, upgrade, and configuration information

Software requirements

Notes Mail - Technical Preview Software Requirements

While the Notes Mail - Technical Preview portlet is available for installation on all supported software configurations for IBM WorkPlace 2.0, please note that this portlet was only tested on the following software:

WebSphere Portal Server operating systems � Microsoft Windows 2000 Server with Service Pack 4 � Microsoft Windows 2000 Advanced Server with Service Pack 4

LDAP directory servers � Lotus Domino Enterprise Server (as LDAP server) 6.5. (Recommended) � IBM Directory Server 4.1 with Fix Pack 2 � +IBM Directory Server 5.1 with Fix Pack 2

Note IBM Directory Server requires IBM DB2 as the database store. Note If the LDAP server is Lotus Domino 6.5, IBM Workplace supports searches of secondary Domino directories that are designated as "Domain type: Notes" in a directory assistance database on the server.

Domino Server Versions � Domino v6.5.2 with the Notes Mail Technical Preview fixpack for Domino 6.0.4/6.5.2. � Domino v6.0.4 with the Notes Mail Technical Preview fixpack for Domino 6.0.4/6.5.2.

Note The Notes Mail Technical Preview fixpacks for Domino 6.0.4/6.5.2 can be obtained at http://www.lotus.com/ldd/beta/nptrbeta.nsf

Domino Mail template versions (tested as backend databases for the Notes Mail - Technical Preview portlet) mail50.ntf mail50ex.ntf mail6.ntfmail6ex.ntfiNotes5.ntfiNotes6.ntf

Operating systems for the browser client � Microsoft Windows 2000 Professional with Service Pack 2 � Microsoft Windows XP

Client browsers � Microsoft Internet Explorer 6.0 with Service Pack 1 -- on Windows 2000 and Windows XP with the Sun Java(TM)

Runtime Environment (JRE) 1.4.2 or with Microsoft Java Virtual Machine (JVM) 1.1

Mobile and Wireless Browsers � Nokia mobile phones � Sony-Ericsson phones � Phones using the Openwave micro-browser � Pocket PC

7


Browser requirements

Windows XP SP2 users must enable ActiveX scripting If you're using Windows XP Service Pack 2, make sure that ActiveX scripting is enabled in your browser. Otherwise, display problems occur in the Mail and Calendar portlets.

Installation notes

Collab. Ctr. People Finder portlet not compatible with 2.5 Do not install the WebSphere Portal Collaboration Center People Finder portlet after installing IBM Workplace 2.5. If you install the Collaboration Center version of the People Finder portlet after IBM Workplace 2.5 installation, the People Finder portlet will not function in IBM Workplace 2.5.

Use one of the following installation scenarios instead:

Scenario 1 1. Install WebSphere Portal. 2. Install Lotus Collaborative Components and the Collaboration Center. 3. Install IBM Workplace -- the IBM Workplace version of People Finder is installed and used.

Scenario 2 1. Install WebSphere Portal. 2. Install IBM Workplace. 3. Do a manual installation of the Lotus Collaborative Components and the Collaboration Center portlets and do not

install the People Finder portlet.

Display problems with Installation screens While running the IBM Workplace installation program, you may encounter the following display problems:

� During installation, "Please wait while the installer determines setup type." screen goes by too fast and cannot be read.

� When you complete the IBM Workplace installation, the final "Summary" screen may not appear. If this happens, minimize the installation program and then restore it; this refreshes the page and forces the screen to appear.

Exception when creating new Teamspace with Cloudscape When you install IBM Workplace using Cloudscape as your DBMS, you may encounter a "get" exception when creating a new Teamspace. You can work around this issue in Windows with the following steps:

1. Make a copy of the workplace.properties file.

2. Open the file, and locate the following string: workplace.policymanager.datasource=jdbc/lwmApp

3. Modify the string to read as follows: workplace.policymanager.datasource=jdbc/lwpComm

4. Save the file.

8


Files not removed after installation if servers are running Before running the IBM Workplace installation program, stop the WebSphere Application and WebSphere Portal servers running on that computer. If the WebSphere Application Server or WebSphere Portal Server is running when you start the IBM Workplace installation program (xxxLWPsuite), then the following files are in use and cannot be deleted during the IBM Workplace installation:

� hlcore.jar

� hlevents.jar

� html-parser-1.4.0.jar

� lwpacf.jar

� lwputil.jar

� wsecutils.jar

� wsnaming.jsr

� wstx.jsr

� xmlParserAPIs.jar

The next time you start the WebSphere Portal Server, errors will occur.

To fix this problem if it occurs: Manually delete the files listed above before running the IBM Workplace configuration targets that start the WebSphere Portal server.

importCdo failure during set-up of WebSphere Portal If the "importCdo" operation fails during the set-up of WebSphere Portal, correct the problem by following these steps:

1. Log in to the WAS Admin Console.

2. Click Applications--> Enterprise Applications--> IBM_Lotus_LMS_LMM.

3. Click "Map RunAs roles to users".

4. Select the check box near lwpUser, and then click All Authenticated?.

5. Click Apply.

6. Click OK, then click Save, and then click Save again when you are prompted to confirm.

7. Restart the server.

8. Run the "importCdo" operation again.

Installing WebSphere Portal PDM hangs on Windows 2003 servers When you run the IBM Workplace installation program to install WebSphere Application Server and WebSphere Portal Server (the install.bat program) on a Windows 2003 server, the program may hang after successfully installing WebSphere Portal Server, but before installing the WebSphere Portal PDM (the problem occurs after you see the message "Installing WebSphere Portal. Do not close this window"). If this happens, you can complete the installation with the following steps:

1. Using Task Manager, stop the installation process. 2. Launch the installation program again (using install.bat as before). 3. The installation program will detect that WebSphere Application Server and WebSphere Portal Server are already installed, so it skip that step and then complete the installation of WebSphere Portal PDM.

9


Linking to a JDK that was not installed by DB2 On AIX and Linux, DB2 does not install its own version of the JDK on client machines; however you need the JDK on the client if you want to develop stored procedures or use the GUI interface. After you install the JDK, you may find that it resides in a different location than required by DB2. You can correct this problem by creating a symbolic link that points DB2 to the installed JDK.

To create the pointer, execute the following command as the root user on the AIX or Linux machine:

cd /<path_expected_by_DB2>; ln -s <actual_path>/<actual_JDK_directory> ./<expected_JDK_directory>

For example, suppose you have a version of the JDK installed in /usr/lib/IBMJava2-1.3.1 but your installed DB2 expects it to reside in /opt. You can create a pointer that enables DB2 to access the JDK from its current location via the /opt directory:

cd /opt; ln -s /usr/lib/IBMJava2-1.3.1 ./IBMJava2-131

For more information, see the TechNote "Configuring the Development Center to use JDKs that are not installed or configured by DB2" at: http://www-1.ibm.com/support (locate the TechNote by searching for the title shown above).

Reducing deadlock on WebSphere Portal databases Regardless of what DBMS product you use for the WebSphere Portal databases, you may experience some amount of deadlock. A deadlock occurs when two or more processes compete for access to the same data, and end up waiting for each other to release the data. For example, Process A might lock row #1 in a table, and then attempt to lock row #2 before updating them. Suppose that row #2 has already been locked by Process B, which is now waiting for access to row #1 so it can complete its own update. Each process is now locking a row needed by the other, and neither process can complete its update. Deadlocks are generally resolved when the competing processes time-out on the update and release the data without having modified it.

Follow these steps to reduce occurrences of deadlock in WebSphere Portal:

1. (All DBMS products) Log in to the DBMS server as a database administrator with all associated privileges.

2. (DB2 Version 8.1 with FixPack 4a only) If you are not hosting the WebSphere Portal databases on the specified version of DB2, skip to the next step.

Run the following commands:

db2set DB2_EVALUNCOMMITTED=YESdb2set DB2_INLIST_TO_NLJN=YESdb2 update db cfg for <wpcp_db> using locklist 1024

3. (Cloudscape only) If you are not hosting the WebSphere Portal databases on Cloudscape, skip to the next step.

A. Run the following commands: setCPcview

B. Open the Cloudscape database, located at <wp_root>\cloudescape\wps50.

C. Click the database tab.

10


4. (All DBMS products) Complete this step for all DBMS products.

Run the following commands:

CREATE INDEX DbUser.IX2110D ON DbUser.PROT_RES (PARENT_OID, OID);CREATE INDEX DbUser.IX2140B ON DbUser.LNK_USER_ROLE (ROLE_INST_OID);

where DbUser is the user name of the database administrator.

5. (All DBMS products) Restart your DBMS server for this change to take effect.

Note If you use host WebSphere Portal databases on DB2 Version 7.2 or SQL Server databases, you might continue to experience deadlocks when using the Portal Document Manager feature. This issue will be addressed in a future WebSphere Portal release.

Troubleshooting the lwpT-portal-setup configuration target This information supplements the section entitled "Troubleshooting configuration scripts."

If you are unsuccessful running the target lwpT-portal-setup, navigate to the <was_root>\lib\ext\ directory and delete the contents of the folder except bloxcommon.jar, epi-common.jar, and wsdl4jpbext.jar. Rerun the lwpT-portal-setup target.

Use the same DBMS for all IBM Workplace databases While the IBM Workplace installation program allows you to create a mixed DBMS environment (for example, hosting Messaging databases on DB2 and Learning databases on Oracle), this arrangement was never tested. Please refrain from implementing a mixed DBMS type environment for the 2.0 release of IBM Workplace as it is not supported.

WebSphere updates required for proper name caching The WebSphere JNDI name cache returns stale objects over a few hours time. Users can encounter errors when attempting to use portlets, and CORBA BAD_OPERATION exception errors are logged. Follow the steps below to correct the problem by installing the WebSphere V5.0.2 Cumulative Fix for SDKs ( PQ88973). This fix supercedes PQ81989 required for release 2.0 of the IBM Workplace products.

Imporant: Follow these steps before you run the updatePDM task, because the updatePDM task will fail without this fix. Running the updatePDM task is done prior to IBM Workplace installation. Running updatePDM is described in the IBM Workplace installation documentation, in the section "Upgrading WebSphere Portal to run with IBM Workplace."

Download the patch

The v5.0.2 cumulative Fix for SDKs is here: http://www-1.ibm.com/support/docview.wss?rs=180&context=SSEQTP&uid=swg24007622

Unzip the patch

� Copy the WAS502_jdk_win.zip to a local drive on your deployment server. � Create a directory 'update' under \websphere\portalserver � Extract the contents on the .zip into this folder

(If you already have an 'update' folder, then create one with a different name (update2 for example)

11


Run the Install Wizard

� From a DOS prompt, go to the directory you extracted the cumulative fix pack into. � Make sure server1 and WebSphere_Portal are stopped. � Run \webphere\appserver\bin\setupcmdline.bat � Run updatewizard � In the update Wizard, select install Fixpacks � The Wizard should default to the fixpacks subdirectory, and should find the was502_jdk fixpack. � Install this fixpack. It is okay to allow the UpdateWizard to remove PQ78370

Windows 2003 - Benign error message on Win2003 installations On Windows 2003, an error message will appear when running the database scripts (see image below). This is not a fatal error. Please choose 'ignore' and continue with the installation.

IBM Workplace Collaborative Learning

Unable to enter international group names for Learning Whether running on English operating system with language locale set or running on pure language operating system, users cannot enter international LDAP group name in Administrator Settings. This is a third party InstallShield issue.

Workaround 1 If the problem is only related to the admin group option of the admin settings, then one way around this is to enter a valid admin user LDAP ID in English, install and start Workplace Collaborative Learning, access the system as that user and then use the user interface to set the admin group privileges you originally wanted. Otherwise, if you must enter DBCS characters into Installer screens, follow the workaround steps below.

Workaround 2 Set default to the desired language.

1. Open Control Panel -> Regional Options and set the default system locale to the one you want (Chinese, Korean, etc.).

2. Restart your machine.

3. Run the Installer.

4. Enter the DBCS strings you need into a compatible editor such as WordPad.

5. Copy and paste the strings into the Installer text fields.

12


Workaround 3 Required to manually set HKEY_USERS value to reflect PRC locale for China in order that cut & paste of Chinese text works in English Win 2K environment with system & user locale set to PRC.

The workaround steps are:

(1) Export international setting for HKEY_CURRENT_USER first, save as 1.reg.

(2) Then export International setting for HKEY_USERS, save as 2.reg

(3) Copy those strings that are inside [] mark.

(4) Then edit 1.reg

(5) Replace strings inside [] mark by pasting.

(6) Then import 1.reg by running it

You can see both HKEY_USERS and HKEY_CURRENT_USER international settings are the same now. However, input of DBCS and international characters are still not possible either in pure language Win 2K OS or with English Win2K (system & user locale set to PRC).

IBM Workplace Rich Client

Can't install rich client with IIS HTTP server Using a Web server with MS IIS 5.0, in the following procedure the rich client installation program may not actually start..

1. Login to IBM Workplace as a non-administrative user.2. Click on the Rich Client tab.3. Click the "Download IBM Workplace rich client software" link.

If the rich client software installation program does not start, perform the following steps :

1. Change your HTTP server to IIS using the link below:

http://publib.boulder.ibm.com/infocenter/wasinfo/topic/com.ibm.websphere.base.doc/info/aes/ae/tins_manualWeb Server.html#configIIS

2. After you configure the HTTP server to IIS, copy the following two folders to your IIS root directory (C:\Inetpub\wwwroot):

� C:\IBMHttpServer\htdocs\en_US\lwpinstall � C:\IBMHttpServer\htdocs\en_US\lwpupdate

The rich client software installation program will now start when you click the "Download IBM Workplace rich client software" link.

Documentation on provisioning server URL provider is vague In the "Installing the IBM Workplace Rich Client" section of the Infocenter help, the "Installing and configuring the provisioning server" section content is rather vague on modifying the default URL for the provisioning server, as shown below:

Specifying the provisioning server Web address During IBM Workplace installation, the system creates a default "IBMWorkplace Provisioning Server" URL resource. The administrator sets theWeb address of the provisioning server as a Resource in the WebSphereApplication Server Administrative Console as follows:

1. Click Resources -> URL Provider -> Default URL Provider -> URLs. 2. On the URLs page, open "IBM Workplace Provisioning Server." 3. Enter the Web address of the provisioning server.

Elaboration on this content is provided below:

13


Platform provisioning -- Standard SSL port When SSL is enabled and using the standard 443 port, the client download JSP will detect that it is enabled and initialize the download applet to retrieve the platform installer over a secure socket. -- Non-standard SSL port If SSL is set up on a non-standard port, you must configure the client download JSP on the server to recognize that port. You can do this be updating the host parameter in the <app_server_home>\installedApps\lwpspinup2\wctInstall.ear\wctinstall.war\token-values.props file to read as shown below: host=https:/myserver.ibm.com:<custom port>. -- RCPML protocol The download JSP will also set up the client configuration properties to retrieve the RCPML page over SSL by setting the URL to use the https protocol. To verify, check the com.ibm.workplace.configuration/defaulturl property in the <wct_home>/rcp/plugin_customization.ini file.

Application provisioning Application provisioning is performed by the rich client provisioning manager using a JNDI property to determine the update server URL. You can inspect or update this URL using the WAS administrative console. Note: You can bypass this by specifying a URL directly in a feature.xml, however setting the update server in the feature.xml defeats central administration from the server. 1. Log in to the WAS administrative console (http://yourserver:9091/admin). 2. Click Resources --> URL Providers. 3. Check that the scope is set to cell. If there is a node name specified, remove it and then click Apply.

The Specification property contains the default provisioning update server; do not change the JNDI name or any other fields.You can verify the component update protocol by inspecting the URLs on the following client-side RCPML file: C:\Documents and Settings\<user>\IBM\RCP\<uid>\<user>\.metadata\.plugins\com.ibm.rcp.pagebuilder.portal\MyStuff.xml.

Download link will not auto install if JRE is not installed If the IBM JRE 1.4.1 or the SUN JRE 1.4.2 are not installed in Linux and/or Java is not enabled in Mozilla 1.4 then the WCT install will not be able to run automatically from the download link.

Instead of the install running automatically as a java applet the install will give you an option to save the setup_wct_platform.bin file into your home directory. While this file is downloaded Mozilla will change the file attribute to read only. Before you can "execute" this bin file to begin install you will need to change the attributes on this file.

1. You can do this via the GUI by right clicking on the file and selecting properties, then select the Permission's tab and select execute for the owner, then select close.

Or you can do this via a command prompt in the terminal window.

a. Login as root b. Open a terminal window c. Change to the directory that contains the file, setup_wct_platform.bin d. Type the following: e. chmod u=rwx setup_wct_platform.bin f. The permission on the file have now been changed. You should be able to install the client by

executing the setup_wct_platform.bin file.

Note: If you double click on the .bin file before changing the file attributes you will get this error: Nautilus has no installed viewer capable of displaying /yourdir/setup_wct_platform.bin. If you try to launch the bin file via command line ./setup_wct_platform.bin, you will get an error message in the console indicating Permission Denied.

14


2. After running the platform install, the rich client automatically launches for setup. The first dialog asks for username, password, servername, and port number. Because this process was not started from the server applet, the servername field is not pre-set to the server name (the default is "workplace"). This is also true for the lookaside installer. The user must know the full name of the server (machine.domain.com) and enter it here.

3. Continuing with the setup process, at the provisioning URL dialog, the URL is also not pre-set to the correct string (the default is "http://workplace"). This is also true for the lookaside installer. The user must know the correct URL ( http://machine.domain.com/lwp/myworkplace/MyStuff) and enter it here. Note that this URL is case-sensitive.

Interrupting the installation/provisioning of the Rich client You can run into unusual behavior if you interrupt the installation or provisioning of the Rich client.

If you install Rich client applications from the Rich client tab of the IBM Workplace server and successfully complete the install, then begin the provisioning of the rich client applications by supplying the provisioning URL and clicking Next, then Cancel the provisioning process, the product is partially provisioned to the user's machine. If the user launches a client application shortcut from the desktop, a blank window displays. To prevent this from happening, you must delete the user's workspace from the machine's directory and begin the provisioning procedure again.

If you install Rich client applications by running the cdWCT lookaside installer and in the middle of the installation, click Cancel, the installation does stop, but an incorrect wizard window displays that states, "InstallShield has successfully installed IBM Workplace products rich client."

Linux - Mozilla bean not showing up in client installer When installing the Workplace Rich Client on a Linux workstation, the error "Cannot validate Mozilla version" indicates that version 1.4 of Mozilla with GTK2 binding is not installed on the workstation, or it is not installed in the expected location.

The file "/etc/gre.conf" contains information on the Mozilla version and the variable "GRE_PATH" whose value should point to the directory location where the appropriate Mozilla version has been installed. In a default RedHat installation this file contains the following information:

[1.4] GRE_PATH=/usr/lib/mozilla-1.4

To fix this error do the following:

1. Download Mozilla 1.4 for RedHat from the followin ftp URL " http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.4.1/contrib/mozilla-1.4.1-gtk2-xft-svg-calendar -suse82.tar.bz2" .

2. Extract the contents of this file to /usr/lib/mozilla-1.4 directory.

3. Create or update "/etc/gre.conf" to have the first two lines as below [1.4]GRE_PATH=/usr/lib/mozilla-1.4

4. Reinstall Workplace Client Technology platform.

Logging in to IBM Workplace as Offline causes errors Once you have completed downloading the appropriate rich client application software from the server, the rich client launches itself automatically for you to log in. At this point, the rich client initializes local data storage and downloads your mail and calendar information.

If you select to work offline in the login dialog that you are prompted with during initialization, you will see empty views -- no folders, messages, links, instant messaging, or calendar events when IBM Workplace rich client starts up in offline mode. If you restart IBM Workplace rich client and select to work online after this occurs, IBM Workplace rich client will still not work correctly. You should not choose to work offline during initialization.

If you did choose to work offline, exit IBM Workplace rich client, delete all directories except the applications directory from your workspace, and set up IBM Workplace again. Select to work online when you log in.

15


Missing Accelerator keys in provisioning components install In some panels of the rich client provisioning installer, administrators will not be provided with accelerator keys (underlined letters for shortcut keys) for Browse buttons, captions, fields, or checkboxes.

In these panels, use the <Tab> key to change the input focus, and use the spacebar to activate buttons or checkboxes.

Providing a trusted root certificate to users One of the windows in the Rich client installation wizard asks you to specify a root certificate to install into the rich client. This page of the wizard is currently not functional. It does not provide a trusted root certificate to users. In order to provide a trusted root certificate in the rich client, perform the following steps on the server where the client components have been made available:

1. Copy the certificate file you wish to provide to all users, and paste it into the http server at <hypertext document root>/lwpinstall/wct. This will make the file available to browser clients through HTTP.

2. Navigate to the WebSphere Application Server's installableApps directory, open <servername>/wctInstall.ear/wctInstall.war/fileList.props in a text editor, and append a comma, followed by the name of the trusted root certificate file, to the end of the following properties: win32.ie.downloads.fileswin32.mozilla.downloads.fileslinux.mozilla.downloads.filesThis causes the trusted root certificate file to automatically be downloaded to users' workstations when they download the client installer.

When users launch the installer, the installer detects the certificate that has been downloaded to the same directory as the installer, and adds the certificate to the HTTP stack in the client.

Salvaging a user's workspace after an uninstall If you uninstall the IBM Workplace rich client from a workstation, the user data is not automatically removed. As a result, you can install a copy of the IBM Workplace rich client that "adopts" that orphaned data directory, otherwise known as a user workspace, as its own.

Gather the following information first:

� What Windows / Linux user was signed in when the orphaned workspace was created? This is referred to as the <username>.

� What folders exist in that username's home directory (On Windows: c:\documents and settings\<username>\ibm\rcp, on RedHat: /home/<username>)? Which of those folders has a creation date that matches the creation date of the data the user wants to recover? This directory is the orphaned workspace, and its numerical name (e.g., 1287133565) is the orphaned workspace name, which is referred to as the <installation instance ID>.

� What path will you install the rich client to? This is referred to as <rcp_home>. It is easiest to accept the default, which is c:\program files\ibm\lotus workplace client for Windows, and /opt/ibm/lotus workplace client for RedHat.

To re-link IBM Workplace data that is left behind when the rich client is uninstalled from a user workstation:

1. Gather the information above, then copy the installation instance ID (e.g., 1287133565) to the clipboard. 2. Follow the instructions in the IBM Workplace InfoCenter to uninstall all existing instances of the IBM Workplace

rich client (in Windows, use Add / Remove Programs, on Linux, run the uninstall executable).3. Create, or verify the existence of, the rcp_home directory. Under the rcp_home directory, create, or verify the

existence of, a folder called rcp. In that folder, create a file called rcpinstall.properties.

16


4. Edit that file and paste the following content into it:

� rcp.installId=%WORKSPACE% � rcp.install.id=%WORKSPACE% � rcp.product.installId=IBM_LWP_C%WORKSPACE% � rcp.product.name=IBM Lotus Workplace products rich client 2.0%WORKSPACE% � rcp.beanBootstrapInstaller_bean66.name=beanBootstrapInstaller_component3%WORKSPACE% � rcp.beanBootstrapInstaller_bean31.name=beanBootstrapInstaller_component2%WORKSPACE% � rcp.beanJavaSecurityFilesInstaller_beanJavaSecurityFiles2.name=beanJavaSecurityFilesInstaller_co

mponent3%WORKSPACE% � rcp.beanBootstrapInstaller_bean66.installId=IBM_LWP_C_WCTbootsc%WORKSPACE% � rcp.beanJavaSecurityFilesInstaller_beanProductJavaSecurityFiles.installId=IBM_LWP_C_RCPmjre%

WORKSPACE% � rcp.beanBootstrapInstaller_bean31.installId=IBM_LWP_C_WCTbootcf%WORKSPACE% � rcp.beanRCPClientInstaller_rcpComponent.installId=IBM_LWP_C_RCP_RCPa%WORKSPACE% � rcp.beanRCPClientInstaller_rcpWin32Component.name=beanRCPClientInstaller_rcpWin32Compone

nt%WORKSPACE% � rcp.beanRCPClientInstaller_RCP-Linux-MozillaFileDelete.installId=38ef825dfb3f3fb60252500b7526

1e5f%WORKSPACE% � rcp.beanBootstrapInstaller_bean16.installId=IBM_LWP_C_WCTboot%WORKSPACE% � rcp.beanApplicationInstaller_ProductAppsInstaller.installId=IBM_LWP_C_WCTapps%WORKSPACE% � rcp.beanRCPClientInstaller_rcpComponent.name=beanRCPClientInstaller_rpcComponent%WORKSP

ACE% � rcp.beanRCPClientInstaller_rcpInstall.name=beanRCPClientInstaller_rcpInstall%WORKSPACE% � rcp.beanJavaSecurityFilesInstaller_productWindowsThemeSupport.installId=IBM_LWP_C_RCPmjrewi

nXP%WORKSPACE% � rcp.beanBootstrapInstaller_bean16.name=beanBootstrapInstaller_IBM Workplace Client Technology

- Install Bootstrap%WORKSPACE%� rcp.beanRCPClientInstaller_rcpInstall.installId=IBM_LWP_C_RCP%WORKSPACE% � rcp.beanRCPClientInstaller_RCP-Linux-MozillaFileDelete.name=beanRCPClientInstaller_MozillaFileD

elete%WORKSPACE% � rcp.beanBootstrapInstaller_LicenseFilesCompBean.installId=IBM_LWP_C_WCTbootlf%WORKSPACE

% � rcp.beanJavaSecurityFilesInstaller_beanJavaSecurityFiles.name=beanJavaSecurityFilesInstaller_com

ponent2%WORKSPACE% � rcp.beanJavaSecurityFilesInstaller_beanJavaSecurityFiles.installId=IBM_LWP_C_RCPmjresf%WORKS

PACE% � rcp.beanJavaSecurityFilesInstaller_beanJavaSecurityFiles2.installId=IBM_LWP_C_RCPmjresf2%WOR

KSPACE% � rcp.beanJavaSecurityFilesInstaller_productWindowsThemeSupport.name=beanJavaSecurityFilesInst

aller_component10%WORKSPACE% � rcp.beanJavaSecurityFilesInstaller_beanProductJavaSecurityFiles.name=beanJavaSecurityFilesInstal

ler_IBM Workplace Client Technology - Security%WORKSPACE% � rcp.beanApplicationInstaller_ProductAppsInstaller.name=beanApplicationInstaller_IBM Workplace

Client Technology - Install Applications%WORKSPACE% � rcp.beanRCPClientInstaller_rcpWin32Component.installId=IBM_LWP_C_RCPw32%WORKSPACE% � rcp.beanBootstrapInstaller_LicenseFilesCompBean.name=beanBootstrapInstaller_LicenseFilesComp

onent%WORKSPACE% 5. Replace all instances of the token %WORKSPACE% with the installation instance ID (e.g., 1287133565) 6. Save the rcpinstall.properties file and exit. 7. In a browser, sign on to IBM Workplace, then navigate to the Rich Client page and click the Download... link. 8. Accept any security warnings. The installer launches. 9. When prompted for an installation location, browse to the rcp_home directory, and continue to progress through

the installer. 10. At the end of the install, the rich client launches; the data it launches with should be that of the orphaned

workspace, which is now linked to the rich client that has just been installed. 11. Wait for the rich client to perform an update check and download any additional components it may need.

17


Specifying an install location for the Rich client If a user without administrative rights to install programs on the workstation or who does not have write access to the default Rich client install location tries to install the IBM Workplace Rich client, when she clicks "Next" in the install location panel of the Installation wizard, the installer returns an error similar to the following:

"C:\Program Files\IBM\Lotus Workplace Client is not writable."

Either a user with administrative rights to the workstation should perform the installation on behalf of the user or the user can use the Browse button to select their own Documents and Settings directory or another directory the user has write access to, and specify it as the install location for the Rich client.

User access rights required for rich client installation In order to install the base Workplace client platform, you must have Write access privilege to the parent directory into which it is being installed. By default, this directory is:

C:\Program Files\IBM\Lotus Workplace Client\ (on Windows)

/opt/IBM/Lotus Workplace Client/ (on Linux)

Note: The installation program creates the IBM\Lotus Workplace Client directories, if they do not already exist.

You can change this installation directory by changing the value in the edit field during rich client installation.

Once the base client platform is installed in the above directory, you no longer need to have write access to that directory. If there are multiple users of the installation, it is strongly recommended that only the administrator have Write access to that directory.

In order to first run the client and subsequently update or otherwise provision applications onto the base configuration, you must have Write access to your workspace. The default workspace location is shown below:

C:\Documents and Settings\<username>\IBM\RCP\<install id>\<username> (on Windows)

/home/<username>/IBM/RCP/<install id>/<username> (on Linux)

This directory is changeable by using the -data switch at startup.

Versions not specified in IWCT Server Client install screen cdServerWCT1: The text on the Installer screen with the title 'Welcome to Setup for IBM Workplace rich client provisioning components' indicates IBM Workplace version 2.0. This text should indicate minor version 2.0.1. This screen is also not specific as to the minor version support details of the IBM WebSphere Application Server (specific version supported = 5.0.2.2) and the IBM HTTP Server (specific version supported = 1.3.26).

Technical Preview

Adding the Notes Mail portlet page Adding the Notes Mail - Technical Preview portlet page 1. After deploying IBM Workplace, go to the directory <installation directory>\config\portal\access\mailbox. 2. Edit the file createDominoPages.bat and replace <wps> with the path to your WebSphere Portal installation (for

example, c:\websphere\portalserver), replace <server> with the URL to your WebSphere Portal server (for example, myportalserver:9081), and then save the changes.

3. Start the WebSphere Portal server if it is not already running. 4. From a DOS command line, run createDominoPages.bat. If you log in as wpsadmin, a new page named Notes

Mail should appear (if using English locale).

18


Enabling all users to use Notes Mail To enable Notes Mail for users, you must edit various policies assigned to all or some set of users and enable the Demonstration features policy.

1. Invoke http://<server>:9091/admin to bring up the admin console. (If the port does not work, make sure you have completed the deployment steps to set up this port.) 2. Click Lotus Workplace, then Users, then Manage User Policies. 3. Click Default User Policy (or any other policy assigned to a group of users for which you want to enable Notes Mail). 4. Next to Allow technical preview features, select Demonstration features. 5. Click OK.

Enabling select users to use Notes Mail Create a new policy (for example, Domino User Policy) that has all the same settings as Default User Policy, and select Demonstration features for the new policy. You can either map this policy to all users with a particular DN suffix or assign policies to individual users. The latter requires that policies be configured to use a WMM attribute to store the currently assigned user policy for users. Using the administration user interface, is not possible to select many users and set the policy for them all at once. However, you can do this using the command line by specifying the following:

lm updateaccount -externalid <inf -fn externallist.txt> -policy NewPolicy

Enabling wireless access to Notes portlets Use these steps to enable access from wireless devices (e.g., mobile phones, PDAs) to the Domino Messaging portlets.

1. After installing IBM Workplace, edit the file <WPS_HOME>\shared\app\config\services\PortalFilterService.properties, where <WPS_HOME> is the path to your WebSphere Portal installation.

2. Comment out the two lines for WML and two lines for cHTML:

#filtername1 = wml#wml.classname = com.ibm.transform.wps.portalfilter.TranscodingPortalFilter#filtername2 = chtml#chtml.classname = com.ibm.transform.wps.portalfilter.TranscodingPortalFilter

3. Save the file.

4. Stop and restart the WebSphere Portal server.

Upgrade notes


Must start server1 for 2.01 Rich Client to upgrade to 2.5 In order for 2.01 Rich Client installs to connect and properly upgrade to 2.5 Rich Client, server1 must be started. The 2.01 client installer was, by default, deployed on server1, so when these clients connect to the 2.5 upgraded server, they try to authenticate through server1.

To start server1:

From /WebSphere/AppServer>/bin type startserver server1

19


Configuration notes

Configuring displayName attribute for Active Directory If your LDAP directory is Active Directory, follow these required steps to configure the use of the displayName attribute.

Configuring displayName before enabling directory security If possible, configure the use of the displayName attribute before you enable directory security for WebSphere Portal:

1. Shut down the WebSphere and WebSphere Portal servers. 2. Use a text editor to open <wp_root >\PortalServer\config\templates\wmm\wmmLDAPAttributes_ACTIVE_DIRECTORY.xml. 3. Add the following attribute map tag, by moving it from the comment-out section:

<attributeMap wmmAttributeName="displayName"pluginAttributeName="displayName"applicableMemberTypes="Person;Group"dataType="String"valueLength="128"multiValued="true" />

4. Save and close the file. 5. Enable directory security for WebSphere Portal.

Configuring displayName after IBM Workplace installation If you have already installed IBM Workplace, you can follow these steps instead. However, if you ever reconfigure WebSphere Portal directory security, you will need to repeat these steps afterward.

1. Stop all servers.2 Open the file <wp_root>\wmm\wmmLDAPServerAttributes.xml and then add the following attributeMap tag to the file:

attributeMap wmmAttributeName="displayName"pluginAttributeName="displayName"applicableMemberTypes="Person;Group"dataType="String"valueLength="128"multiValued="true" />

3. Save the file. 4. Start all servers.

Create a full-text index on the Domino Directory Create a full-text index on the Domino Directory (NAMES.NSF). Creating the index will significantly reduce the time required for login and searches related to authentication.

Dynacache requirement Portal requires dynacache to be enabled, as several components within IBM Workplace make use of dynacache. Please note that it is possible to disable dynacache using the WebSphere admin console, but this is not a supported configuration of Workplace 2.0.

How to disable email notifications for the Team Project template The following outlines how to disable email notifications for the Team Project template:

1. Login in to IBM Workplace as an administrator

2. Click on Workplace Builder tab

3. Identify the Team Project template and click on the export icon for that template.

4. Select Save from the File Download Dialog and save the file to disk

5. Open the previously saved file in your favorite editor, notepad will do on Windows OS

20


6. Search for the word notificationEnabled

7. change notificationEnabled="true" to "false"

8. Save the file

9. Go to Workplace Builder tab in IBM Workplace as an administrator

10. Click on the Import... button

11. Click on the Browse... button , find the updated file in the File Open Dialog, Click Open.

12. Click OK on the Import Workplace Template page

13. Click the Replace existing template radio button

14. Click OK,

15. The new file has been imported, confirm by the message "Team Project was successfully imported."

LDAP referrals not followed by default By default, WebSphere Portal/Member Manager do not follow LDAP referrals and return an exception error when a referral is found. To configure WebSphere Portal/Member Manager to follow referrals, follow these steps:

1. Shut down all servers.2. Using a text editor, open <wp_root>/shared/app/wmm/wmm.xml. 3. Add the following line to the wmm.xml file:

java.naming.referral="follow"4. Save the file.5. Restart the servers.

SMTP server - LMS Mail (Calendar and Enrollment notifications) The default port for SMTP is 25; IBM Workplace will use this by default. If there are any other services running through this port, IBM Workplace SMTP server will appear as started in the Admin Console, but will be inactive. This more commonly occurs on non-Windows platforms (for example, SendMail if enabled will be running on the same port).

Workaround Terminate the service (e.g., SendMail), stop the SMTP service through the IBM Workplace admin console, and restart SMTP. Alternatively, assign a different port number for SMTP prior to configuration, or change the port number via the IBM Workplace admin console (this will require a server restart).

You may also check the etc/services file (UNIX only) for SMTP status. As an additional check, telnet to the SMTP server and you should see this 220 <host.acme.com> Lotus Workplace Messaging Ready.

Tips for using Domino directory assistance This release of IBM Workplace supports the use of Domino directory assistance to search secondary Domino Directories (domain type "Notes" in Directory Assistance document). Note that this release does not support searches of LDAP directories (domain type "LDAP" in Directory Assistance document).

This topic provides tips for configuring directory assistance to work with IBM Workplace. For complete information on configuring directory assistance, see the Domino Administrator Help.

� Give the WebSphere Portal administrative account name Manager access in the access control list (ACL) of the primary Domino Directory. The primary Domino Directory is the main NAMES.NSF database on the Domino LDAP server configured to work with WebSphere Portal.

� Give the primary Domino Directory server Manager access in the ACL of each secondary Domino Directory. A secondary Domino Directory is a Domino Directory that has a Directory Assistance document in the directory assistance database on the primary Domino Directory server.

21


� To search a secondary Domino Directory, configure naming contexts (rules) in the Directory Assistance document for that directory that match the LDAP user and group suffixes configured for the WebSphere Portal server. For example, if the configured LDAP user suffix is ou=users,o=acme, and the configured LDAP group suffix is ou=groups,o=acme, any of the following naming context configurations in a Directory Assistance document are acceptable:

Note: "Trusted for Credentials" should be set to "true" if you want to authenticate users and groups in the directory.

or

or

22


wpsadmin authorization error when using Domino Directory If your LDAP directory is the Domino Directory, users may see wpsadmin authorization errors similar to the following one that prevent them from using IBM Workplace:

"Error provisioning user CN=wpsadmin,OU=users,O=acme,C=US"

Administrators will see a SystemOut.log error such as:

"Authorization failed for domldap.acme.com:389/wpsadmin"....."user:domldap.acme.com:389/CN=wpsadmin,OU=users,O=acme,C=US is not granted any of the required roles: wasAdmin."

This error indicates that the name stated in the error message is not mapped to a required security role. To correct the problem:

1. Start the WebSphere Administrative Console.2. Expand Applications on the left, and then select Enterprise Applications.3. Click A_LWP_Infrastructure on the right. 4. Click the Configuration tab, and in the Additional Properties section click "Map security roles to users/groups".5. Map the required role stated in the SystemOut.log error to the stated name, and click OK. For example, assuming the error above, you would map the wasAdmin role to the user name CN=wpsadmin,OU=users,O=acme,C=US. 6. Click A_LWP_Team.7. Repeat Steps 4 and 5.

"Automatically create mailboxes" affects calendar as well The Administrator Console configuration under IBM Workplace --> Users --> Manage User Policies --> <policyname> --> Mail Details allows for the automatic creation of inboxes. In this release, however, disabling the "Automatically create mailboxes" configuration item prevents a Calendar from being created as well.


Learning Requirements when connected to MS IIS 5.0 HTTP Server When setting up an IBM Workplace deployment connected to MS IIS 5.0 HTTP Server, Windows Integrated Authentication ( WIA ) needs to be disabled.

If Windows Integrated Authentication is enabled the "Launch" icon will be missing from the Learning portlet after enrolling in a course. The reason for this is because WIA strips user authentication information from the web services calls from a machine it has already authenticated.

See link for details how to disable Windows Integrated Authentication: http://support.microsoft.com/default.aspx?scid=kb;EN-US;837139

Updating Learning Settings on a data-only DB2 server To successfully update Learning settings in a configuration where the IBM Workplace data server is remote from the IBM Workplace application server, you must run LWPdbconfig update-settings on the data server after modifying lwpprops.properties with the updated information. This is documented in the InfoCenter. However, there is a known problem with running this task on the IBM Workplace data server. In order for the changes to actually take effect, within lwpprops.properties, these values must be set (to true) before running LWPdbconfig update-settings:

LWP.Learning.LMS=true (If you are updating LMS settings) LWP.Learning.LDS=true (If you are updating LDS settings)

23



Changing from one user's workspace to another on one machine The rich client supports multiple users on a single workstation only if none of the users have write access to the rich client installation directory. When multiple users share a workstation, any new features or applications for the platform are installed to an individual user's workspace, separate from the platform. Each user has an independent configuration based on the (shared) base platform, but captured in that individual user's workspace. To change from one user's workspace to another, you must log off the operating system and log back onto the system as the other user.

Changing the specified provisioning server To subsequently change the server that you specify as the provisioning server for a client already installed and provisioned on a user's machine, you must change the value of the default url preference in the <user_workspace>/.metadata/.plugins/com.ibm.workplace.configuration/prefs.ini file as follows (where <user_workspace> is the user's workspace, which by default is stored to C:\Documents and Settings\<username>\IBM\RCP\<rcpinstallid>\<username>\ on Windows):

/instance/com.ibm.workplace.configuration/defaulturl=http\://<full_servername_of_new_provisioning_server.com>/<url>Currently, there is no way for a server administrator to change the users' provisioning server from the server.

Client supports one machine per user (credential store) The client supports provisioning only one machine per user; a single local credential store is created for the user on a given machine. If the user's policies indicate that a CA-signed certificate should be requested to sign and encrypt mail messages, the PKI infrastructure requests the CA-signed certificate the first time a signed email is composed and sent by that user. The private key specific to that machine's CA request is stored in the local credential store residing on the user's single machine.

If a user were provisioned on more than one machine, multiple local credential stores would be created and these local credential stores do not currently support sharing or exchanging private keys. As a result, if the user were to send a signed email message from the second machine, a second PKI request would be sent to the same Certification Authority because the credentials created in the first machine's local credential store are not available to the second machine. Even if a PKI request for the user was already approved and accepted, a second, redundant request would be submitted. To prevent this behavior, provision each user on a single machine.

Configuring the rich client to use non-standard HTTP ports By default, the rich-client applications do not run properly if your server is configured with non-standard HTTP ports. Standard HTTP ports are 80 for HTTP and 443 for HTTPS.

You can configure the Rich client to work with non-standard ports by changing the host value in the was_home/installedApps/node/wctInstall.ear/wctinstall.war/token-values.props file from host=getParameter to host=<protocol>://<LWpServer>:<port> (for example, host=https://yourlwp.yourco.com:444, or host=http://yourlwp.yourco.com:81).

Configuring use of the Edit My Profile link for Domino Directory If your LDAP directory is the Domino Directory and you allow IBM Workplace write access to it, follow these steps to ensure that users can successfully use the "Edit My Profile" link on the Portal page to change their first and last names.

Note If you do not follow these steps, when users change their first and last names, IBM Workplace deletes and re-creates the users' Person documents in the Domino Directory. This deletion and re-creation changes users' external IDs which prevents users from accessing previously existing data.

24


To configure use of the Edit My Profile link on Domino 6 If you use a Domino 6 server, follow these steps after completing the IBM Workplace installation:

1. Open the file <wp_root>\shared\app\wmm.xml.

2. Search for the following text:

adapterClassName="com.ibm.ws.wmm.ldap.domino.DominoLdapAdapterImpl"

3. Replace the adapterClassName value with the following one:

adapterClassName="com.ibm.ws.wmm.ldap.domino.Domino6LdapAdapterImpl"

4. Save the wmm.xml file.

5. (Recommended) By default, when users change their first or last names using the "Edit My Profile" link, their distinguished names are changed in their Person documents. This distinguished name change does not carry over to groups that the users belong to or to Domino access control lists (ACLs), which can prevent users from accessing resources after a name change. To avoid this situation, prevent distinguished names from changing when users change their first or last names by following these steps:

a. Open the file <wp_root>\shared\app\config\services\PumaService.Properties.

b. Remove the pound sign (#) from the line user.sync.remove.attributes, and type the following values for it:

user.sync.remove.attributes=cn,CN,cN,Cn

Note This step assumes that cn is the attribute used for the left-most part of users' distinguished names, configured through the LdapUserPrefix property in the WebSphere Portal wpconfig.properties file.

c. Save the PumaServer.Properties file.

6. Restart the WebSphere, WebSphere Portal, and IBM Workplace servers

To configure use of the Edit My Profile link on Domino 5 If you use a Domino 5 server, follow these steps after completing the IBM Workplace installation. When users change their first or last names through the "Edit My Profile" link, these steps prevent deletion and re-creation of Person documents and prevent users' distinguished names from changing.

1. Open the file <wp_root>\shared\app\config\services\PumaService.Properties.

2. Remove the pound sign (#) from the line user.sync.remove.attributes, and type the following values for it:

user.sync.remove.attributes=cn,CN,cN,Cn

Note This step assumes that cn is the attribute used for the left-most part of users' distinguished names, configured through the LdapUserPrefix property in the WebSphere Portal wpconfig.properties file.

4. Save the PumaServer.Properties file.

5. Restart the WebSphere, WebSphere Portal, and IBM Workplace servers.

Issuing user credentials through a Certificate Authority The IBM Workplace Client Technology mail application uses signing and encryption credentials that are created on the client at initial deployment or when first needed, depending on the prevailing user policy established through the administrative console. These credentials may be certified through an external Certificate Authority (CA), as described in the Workplace information center. In order for this to happen, two administrative steps are needed.

Firstly, the configuration for the connections to the one or more CAs must be entered on the IBM Workplace server, as described in the instructions in the information center.

25


Secondly, certification of generated credentials must be enabled in the policy settings for the appropriate user group or groups. This is done though the 'Manage User Policies' section of the server administrative console, on the third item in the panel shown below.

Note that the "one or more CA configurations" should be provided before the user policy is updated. If not, then certification requests will be generated by the clients which will not be able to be processed on the server, and may prevent subsequent certification requests from being generated. Also, any name mapping rules needed for the configured CAs must be provided - please see the IBM Workplace Help documentation for more details.

LMS server timing out users while they are taking courses The Application Servers (WAS) time-out is ignored when Enterprise Application session time-outs are specified and the Overwrite checkbox is selected for the Overwrite Session Management. The default setting is 30 minutes. You also have the option to set the Application Server time-out to 'No time-out' in the Admin console: Servers\Application Servers\server1\Web Container\Session Management.

The value of the Application server setting is used as a default when the session time-out is not specified for a Enterprise Application (LMM or DS applications).

It is also good practice to set an LTPA time-out to greater than or equal to the session time-outs. This prevents the LTPA token from expiring prior to the session expiring. This may help any related activity that relies on LTPA authentication. If the LTPA token expires the user will be directed back to login page. Progress is not lost if the LTPA token expires. Progress is, however, lost for a session time-out.

Having the content send periodic tracking requests will help keep the session alive.

26


Removing the rich client workspace Removing the rich client workspace (use only when instructed by IBM Support):

1. Locate your "home" directory.On Windows, this is usually the \Documents and Settings\<username> folder, and on Linux, this is usually the /home/<username> directory, where <username> is the currently logged-in user.

2. Navigate to the folder/directory <home directory>\IBM\RCP (Windows) or <home directory>/IBM/RCP (Linux).In this folder/directory, there is a folder/directory with a large number for its name. This large-number folder/directory is the rich client workspace.

3. Delete the workspace folder/directory.

On either platform:

In situations where the Setup of the client takes a long time, and you will be reconnecting to the same server, you can save time during Setup by removing only part of the workspace folder/directory. Navigate into the folder/directory <workspace>\<username>. Here, select all files and folders/directories except the applications folder/directory, and then delete them.

Unsupported Rich client offering policy configurations The following offerings cannot be configured as stand-alone applications. You must select them as additions to setting Allow Mail, Document libraries, Workplace applications, team spaces, or Web conferencing:

Allow calendar Allow instant messaging

If you set up the Rich client to allow only one of the above offerings, a blank window displays when you launch the client.

Dynamic policy changes are not supported either. If you make subsequent changes to the offerings available to a IBM Workplace Rich client user via their user policy settings, these changes are not applied to the client machine until you restart the server and the user subsequently logs into the client.

IBM Workplace Messaging

Import command issues Import command behavior is listed below:

� 'lm import -user <login_name> - path <folder name>' format: This format is useful for restoring mail messages or contacts that were inadvertently deleted from that user's account after the mail account was exported. When using this format, Import only restores mail and contacts but calendar events are NOT restored. Messages and contacts that already exist in the mail account are not added again.

� 'lm import -zipfile <filename> -newuser <login_name>' format: This format is useful for moving a mail account from one cell to another. When using this format, Import creates mail, contacts and calendar events for this 'newuser' account. This new account could have been previously created, or, if the account does not already exist, it is created by the Import command. Import does not do any fixups of recipient/invitee names, so it should only be used to import into a mail account with the same login name. It should NOT be used to import an existing zipfile into a new mail account in the SAME cell.

27


� Import does not support the import of exported zipfiles that were generated by IBM Workplace 1.1, and that contained calendar information.

� A couple of caveats when exporting calendar events and moving them to a new account:

a) Private properties are not being exported, resulting in some fidelity loss when importing into the new account.

b) Invitee status is not being exported and invitee status related information will not appear in the new account.

Mailbox database script creates a ${env.TEMP} directory Messaging and Archive Cloudscape database scripts use Ant to access the machine's TEMP environment variable when creating the database. If the machine does not have this variable set, then it creates a directory in <Workplace Home>/config/database/mailbox/mailbox/cloudscape that uses the Ant property format (that is, ${property name }). This appears to be specific to Linux machines although any unix machine lacking a TEMP environment variable will have this issue.

To fix, an environment variable called 'TEMP' should be created on the target machine and set to the location of the 'temp' directory prior to running the scripts. The location of temp is mostly likely off of the root so the variable would be set as TEMP=/temp, for example. Then the ant property in the database scripts will resolve correctly and the scripts will execute correctly. If this step is not completed, the database script should still work.

Technical Preview

Domino V6.5.2 settings to enable Domino XML Services To enable and control Domino XML Services there are several notes.ini keywords that are used in the Domino Server notes.ini file.

NOTE: Before enabling Domino XML Services on a Domino 6.04/6.5.2 server you will need to download a set of binaries and copy them to the Domino program directory. Without these binaries the stability of the Domino server will be compromised.

Domino Server Versions � Domino v6.5.2 with the Notes Mail Technical Preview fixpack for Domino 6.0.4/6.5.2. � Domino v6.0.4 with the Notes Mail Technical Preview fixpack for Domino 6.0.4/6.5.2.

Note The Notes Mail Technical Preview fixpacks for Domino 6.0.4/6.5.2 can be obtained at http://www.lotus.com/ldd/beta/nptpbeta.nsf

� Notes ini keyword: "HTTPDomWSAppSpace" To enable Domino XML Services on this Domino Server add keyword to notes.ini file having it equal to 1

HTTPDomWSAppSpace=1

� Note.ini keyword: "HTTPDomWSConvertFormat" For MIME conversion add keyword in notes.ini to 2 otherwise only plain text will be visible to the user. This will cause an additional Domino Server task to run (dwsaddin) which is responsible for converting Notes documents to a MIME stream. It is recommended that this keyword be

HTTPDomWSConvertFormat=2

28


� Notes.ini keyword: "DWSAddinMaxThreads" This can be used to adjust the maximum number of Notes documents that can be converted to MIME streams simultaneously (default 20)

DWSAddinMaxThreads=20

� Notes.ini keyword: "HTTPDomWSForceFromValue" To always force the "from" field in a mail message to be set to the authenticated username

HTTPDomWSForceFromValue=1

Initial User Configuration for the Notes Mail Portlet Once the Notes Mail Portlet has been installed by the portlet administrator, the administrator should then open the configuration (click the wrench icon) of the portlet and make sure to enable this setting: "Allow portlet users to change the mail server in edit mode". Once this setting has been enabled, upon initial login, the user must supply the necessary information to enable the portlet to connect to his/her Domino server and mailfile. The user is presented with a startup page advising to press the "Edit" pencil icon to go to the Preferences page and enter this information. The user will be advised to enter a user name & password as well as a server host name and path\mailfile name.

When in the main Preferences page, the user should enter the user name & password information and then press the "Edit Mail Source" button to enter the server host name and path\mailfile name. The user may also choose to supply or change any other Preferences information during this process as well. Upon saving from the "Edit Mail Source" page and then the main Preferences page the user will come back to the Workplace main page and the Inbox view should now be visible with Domino mail data.

It should also be noted here that when the Domino mail server is down, the delegate will report this as not having sufficient configuration information and the user will again get a message advising him/her to go into Preferences and enter the proper configuration information. If this is not the initial time and/or sufficient configuration information has been supplied, the user should also check the Domino server for availability.

Uninstallation information


HTTP server plugin should be regenerated during uninstall After uninstalling IBM Workplace Client Provisioning Components from your IBM Workplace server, you should regenerate the HTTP server plugin manually from the WebSphere Portal Administration Console, or manually run the LwpGenPluginCfg.bat (.sh) script provided with IBM Workplace.

29


Known limitations, problems, and workarounds

Limitations

Configuration issues

Admin users can only see the Workplace applications they create In the current beta release of IBM Workplace, there is a defect where users who have Administrator rights can only see the Workplace applications they have created. Administrators should be able to see all workplaces.

IBM Workplace Collaborative Learning issues

Collaboration Templates not available In the current IBM Workplace 2.5 Beta release, Collaboration Templates are not available.

Discussions: Child documents are not deleted with parent Child documents are not deleted when a parent document is deleted from a discussion.

Do not use Intellexis' close button; tracking will not work If a student taking an imported Intellexis course closes the course by clicking on the Close ("X") button on the course screen, tracking information will not be recorded. Close an imported Intellexis course by clicking Close in the Learning window.

Issues with User Permission Report and DBCS characters The User Permission Report does not correctly display DBCS characters in CSV format. Use another available, supported format, such as XML.

Reports cannot be generated in PDF format Due to issues with the report generator, Workplace Collaborative Learning reports cannot be produced as PDF files in this release of IBM Workplace. This limitation affects all Collaborative Learning reports. Reports are alternatively available in the following formats: HTML, XML, CSV, and Text.

31


Some templates are not instantiating in the template catalog If you create a new template and use one of the below listed templates as a starting point:

� Marketing Team � Sales Team � Event Planning � Employee Human Resources Site � Human Resources Team � Customer Support Team � Course Collaboration

clicking on the template link to edit the newly-created template causes an error in the catalog.

Student interface: Font size changes using Internet Explorer Users on Microsoft Internet Explorer versions 5.5 and 6.0 may see sudden changes in font size. Use Microsoft Internet Explorer 5.0x or Internet Explorer 6 Service Pack 1 (6.02) or Netscape Navigator as the browser.

User search may fail for names with DBCS and accented characters A wild card user search may fail to return users with DBCS or accented characters in their name. The LMS performs an LDAP search/query before the Database search/query. So in the event that the LDAP search limit is not set to a number bigger than the actual number of entries in LDAP, users may be unable to successfully search the International users that they "just" rostered minutes ago. This is because international names are sorted at the end (after the English names) and it is possible that these international names are already excluded in the "partial result" from the first round of LDAP search. In this case, when the system performs the database search, it will not be able to hit these international names either.

Make sure that the LDAP search results preference is set to a number large enough to find entries in the LDAP directory.

Wildcarding in a course search is not supported for all fields Wildcarding is not supported for the Search for, Description, and Name fields in the Learning portal's Course Search dialog.

IBM Workplace Documents issues

Client-side size limitation for importing documents The client-side document import has a size limitation. When importing a large number of documents from the client it is recommended that you increase the Portal Session timeout, otherwise a session timeout may occur during import. An alternative method for importing a large number of documents is to use the server-side import.

32


Default folder in Document Library has human-unreadable name The main folder name is correct, but the one in the directory listing is the non-human-readable code for the folder name by default, as in the example below:

Desktop Integration messages do not appear on client terminal Popup messages from the Desktop Integration Upload Monitor do not appear in a terminal services client where the user is working, but instead appear on the original terminal where the monitor was started. This includes the password prompt dialog if the user elected to not save the password for a server connection when installing Desktop Integration.

Do not use Portal Administration to maintain applications Always maintain Workplace applications using the application editor. Do not use Portal Administration to modify Workplace applications. Here are some examples:

� To create and arrange the pages of your Workplace application, always use the Pages and Layout portlet of the application editor . Do not use the Manage Pages portlet of Portal Administration to perform this task. If you create new pages for a Workplace application using Portal Administration - Manage Pages, these pages will not be registered in the application template. If you choose to save the application as a template, the new pages will be lost.

� To add application components (portlets) to the pages of a Workplace application, always use the Pages and Layout portlet of the application editor. Do not use the Manage Pages portlet of Portal Administration to perform this task. If you attempt to work with application components like other portlets using the Portal Administration tasks Install Portlets, Manage Portlet Applications, or Manage Portlets, the application components of the Workplace application will not work because they rely on corresponding business component objects.

If you ignore this warning and use Portal Administration portlets to maintain Workplace applications assembled from templates, your applications will not deploy properly, pages will not be defined in the template, and application components (portlets) will not work. Workplace applications require the infrastructure provided the collaborative domain object, community roles for membership, and the business component objects associated with application components (portlets), and other related objects and services that the template XML defines. Portal Administration portlets do not support the complete object model for Workplace templates and applications.

33


If you want to add non-Workplace-provided portlets (that is, portal-installed business portlets, portlets downloaded from the Portal Catalog, or JSR 168 portlets) to the pages of a Workplace application, make sure that you use either the Workplace template editor or the application editor, not Portal Administration.

The following usage scenario is not recommended: If you uninstall any of the Workplace-provided portlets (application components) and remove these portlets from the pages of a Workplace application, you cannot reinstall them and add them back onto pages of a Workplace application using Portal Administration. In this release of the product, there is no way to reinstall and redeploy portlets that are provided with the ready-made Workplace templates and applications.

The following list identifies the portlets provided by IBM Workplace Collaboration Services applications. Use the Workplace application editor or template editor -- not Portal Administration -- when you work with these application components.

Portlets common to most Workplace templates and applications: Members (or Participants for Web Conference applications) Search People Finder Instant Contacts

Portlets provided by IBM Workplace Collaboration Services 2.0 and 2.5: Application Information Team Space Information Team Tasks Team Calendar Discussion Document Library Document Library Information Domino Web Application Web Conference Information Participants (the Web Conference version of Members) Agenda Materials Web Conference Projector Chat Room

New portlets provided by IBM Workplace Collaboration Services 2.5:AnnouncementsAgendaAttendanceCustomer ContactsDirectionsEmployee DirectoryFAQsInvitations and RSVPsIssuesLinksMilestonesMinutesProspectsSales TrackingSign Up SheetSurveyVacations

Installed workplace templates are locked for editing The templates provided by IBM Workplace Collaboration Services are locked by default. The locking of installed templates prevents the loss of translated properties for installed Workplace application templates after they are edited, To edit an installed template, simply copy one of the installed templates and edit the copy. To copy a template, create a new template using one of the installed templates: In the Starting point field, select one of the installed templates (Blank, Chat Room, Course Collaboration, Customer Support Team, Discussion, Document Library, Domino Application Access, Employee HR Site, Event Planning, HR Team, Marketing Team, Sales Team, or Team Project). Save and close this copy of the installed template. You can now edit this copy of an installed template and any applications that apply this template; template and application properties will display in any one of the 24 supported languages.

34


The locking of installed templates was necessitated by a defect in this version of the product whereby the template editor retrieves the language properties that the installed templates and applications were created with (English), not the language being used. The translated text for the language currently in use is stored in the template properties; however, the template editor retrieves the original properties file -- not the template properties, which store the translated template name and description. This problem is visible if you unlock one of the installed templates, set your browser to a language other than English, and open one of the installed templates in the template editor. The name and description of the installed template display in English, rather than in the non-English language that you set for your browser.

Search for Document Title or Document Description fails Searching the Document Title or Document Description of a Document fails to return results. Instead, search for content in the Body of the Document.

IBM Workplace Rich Client issues

Cannot skip the update of a .jar file While updating a .jar file, if you select 'Cancel', you cannot proceed to install the next .jar; you will be prompted to start again.

Client mail messages on Linux do not convert URLs to hotlinks URLs included in mail message bodies for e-mails created in the client Messaging product running on Linux are not automatically converted to hotlinks. The conversion of text containing a URL syntax to a hotlink is performed by Internet Explorer, and is supported in Windows-based installations only.

F1 functionality in this release If you have IBM productivity tools enabled, pressing F1 while in the context of one of the productivity tools will open IBM productivity tools Help.

If you have Lotus Notes enabled, pressing F1 while in the context of a Notes application will open Lotus Notes Help.

Pressing F1 in any other area of IBM Workplace rich client, including in each component's navigator, opens IBM Workplace rich client Help. An alternate way to opening IBM Workplace rich client help is to click Help --> Help Contents.

Hover text may not display properly Non-English hover text may not display properly when your computer's locale is different from the locale specified by the "-nl" command line option, or from the locale specified in the Preferred language section of Regional Settings preferences.

Instant Contacts - Can't sort list of contacts Under each group in Instant Contacts, users are listed in the order in which they were added. At this time, there is no way to sort the list. This issue will be addressed in a future release.

35


Issues with spell check on Linux with rich client Unexpected results when using Spell Check with the Rich Client on Linux. The Rich text editor on Linux uses the embedded Mozilla browser (implemented as a plugin) and it has some limitations which have been forwarded to Mozilla.

The Spell checker on Linux may experience the following issues:

� Spell check will not function if there are spaces in your install path (such as installing the rich client in the c:\program files directory)

� After pressing Replace All the Spell Check dialog will remain open. It should close and indicate no more spelling errors were found. User needs to select Cancel to close the Spell Check dialog box.

� If you misspell the word "the" in an email message such as "th" spell check will flag all words that contain "th" as a spelling error.

� Spell check will loop through a cycle twice after selecting ignore for all misspelled words.

For status on the above issues please refer to http://bugzilla.mozilla.org/show_bug.cgi?id=253614

Language to search has to match the client's Regional Settings Set the client language preference to that which most closely matches the language used in the majority of e-mail content.

Limits for IBM Workplace MessagingAddress Book� If you try to add contacts to your address book when you have reached your limit, you are prompted with an

error message that your contact could not be saved successfully. The default setting is a limit of 250 entries. � You cannot save a group that contains more than 100 e-mail addresses. � For this release, the address book cannot contain 500 or more entries.

Calendar � You cannot add more than 1536 characters to the Location field of a calendar entry. � If you open 70 or more tabbed pages (such as mail messages and calendar entries) and leave them open, the

mail client becomes unusable. � If a meeting entry contains an exceptionally large number of invitees, such as 300, the entry may take a long time

to open or may not open at all. If the entry is opened, the meeting form may not display all of the invitees. � If you create and save more than 300 calendar entries in one session, the messaging client may fail or become

unusable. Do not try to create a very large number of calendar entries in one session.

Mail Messages � You cannot have more than 600 messages open on tabs at the same time. If you are over the limit you cannot use

Mail effectively. � You cannot create more than 498 messages. If you go over the limit, you will see a gray window.

Attachments � To open an attachment directly from a message, the attachment's file name must have at least seven characters.

If it has less than seven characters, the attachment must be saved locally to open it.

Changing language using keyboard commands � Changing language using keyboard commands is not supported for 2.0. If you want to switch to a language in a

different language pack, a rich client reinstall is required. If the language pack is installed, a restart of the client is required.

Instant Contacts � You can add up to 100 contacts to your Instant Contacts list.

36


Lowest ranking search results appear at the top The lowest ranking search results display at the top of the result list and the Score/relevancy column is not sortable.

MIME messages with GIFs generate errors in client messaging MIME mail messages with a base content type of Image/GIF, or with a base content type of Multipart/mixed, and that contain multiple GIF files, generate an error when opened in the client messaging product.

Outlook mail background color not displaying in client messaging The background color of mail messages composed in Outlook and opened in the client messaging product are not consistent. When it sets the color of the bgcolor HTML tag, Outlook prepends non-standard values to the standard values used to represent colors in HTML. This prevents the background color from being rendered as a standard color by the client.

Rich-client Search does not support use of wild-card characters Use of wild-card characters such as * or ? in a search query are not supported.

Rich client fails to check if an account has been deleted When a mail account is deleted but the "Update directory person record" option is not selected, a rich client user cannot log in to My Workplace by having IBM Workplace create a new account. The rich client tries to synchronize against a deleted mail account but fails to check if it has been deleted. This problem does not exist for Web browser clients.

Normally when a mail account is deleted using the WebSphere Administrative Console and the Administrative Console option "Update directory person records" is not selected, a new account is created the next time the user logs in.

Signing verification that uses the UID attribute not supported A bug in the PKCS code prevents the S/MIME component from signing messages, or verifying signed messages, when the signing certificate Subject distinguished name contains the UID attribute. The bug has no impact on encrypting messages.

If your organization uses the UID attribute in the distinguished names of users, and by extension creates certificates whose Subject distinguished names contain the UID attribute, sending and receiving signed messages is not available. In particular, an attempt to send a message with signing requested would fail, since the action of signing the content would fail, and the only remedy would be to send the message unsigned. For a message received with such a signature, the message content would be available, but the signature on the content would not be able to be verified. The underlying PKCS exceptions are trapped and logged, and are passed on to the calling program.

User cannot cancel a search once it begins Once a Search has begun, a user cannot cancel that Search.

37


WCT does not support Tivoli Access Manager (TAM) It should be noted that IBM Workplace Client Technology does not support Tivoli Access Manager (Single Sign On). Customers that already use Portal and Tivoli Access Manager should be aware that Tivoli Access Manager is not a supported configuration for Workplace Client Technology.

"Export" command is not working The "Export" command, both from the "lmadmin" command as well as the admin console/task scheduler, is not working in this current release.

IBM Workplace Team Collaboration issues

Description text missing from Default templates in Editor Click on any of the unlocked default templates (Blank, Document Library, Discussion, etc.); unlock one, if they are all locked. In the Editor, the user should see Description: <descriptive text for each template>. The Description text is missing.

HTTP tunnel cluster base URL is hardcoded The HTTP tunnel cluster base URL cannot be edited. The base URL setting is appended to the context root. The affinity plugin of the IBM HTTP server uses this string to determine the tunnel cluster group to which it forwards incoming HTTP Tunnel requests. Normally you can set the base URL in the WebSphere Administrative Console. Click Lotus Workplace -> SIP Cell-Wide Settings, then under Additional Properties, click HTTP Tunnel Cluster to set the field "Mapped URI". For this release, the field cannot be edited even though the user interface says that the field is editable.

Limitations for Web Conference templates and applications Web Conference templates and applications are limited in the following ways in this release of IBM Workplace Collaboration Services:

� You cannot view, edit, or create new templates based on the Moderated Web Conference template. � The Moderated Web Conference template is not listed in the Application Template Library, is not listed in the

selection list for templates when you create a new application, nor is it listed in any display filter lists (typically, the Show list).

� The application category Web Conference is not listed in the selection list of categories when you create or modify a template or an application.

� Web Conference applications cannot be edited. You will not see Edit in the navigation bar. (For other categories of applications, Edit in the navigation bar opens the application editor.)

These restrictions apply to the availability of the Moderated Web Conference template and creating and customizing Web Conference applications. Web Conference applications and components are available for general use by anyone with a user policy that provides access to Web Conferences. Application managers can control the life cycle of their Web Conferences by maintaining the Workplace policy assigned to the Web Conferences.

38


Meetings cannot be deleted when Messaging is not installed In a deployment where the user's e-mail domain differs from the server's local domain, meetings created in the Team Calendar cannot be deleted or modified. When attempting to delete a meeting, the user receives a prompt that indicates the meeting will be deleted. Clicking OK to this message will refresh the page but the meeting will not be removed from the Team Calendar. Attempting to change invitees of a meeting will bring up an incorrect error message stating that the entry was deleted while you were editing it. Clicking "Back to main view" link will bring the Team Calendar back up and no changes will be saved to the meeting details. There is no workaround for this problem at this time but there will be a fix in a later release.

Search for Discussion Topic in Subject fails Searching the Subject of a Discussion Topic fails to return results. Instead, search for content in the Body of the Discussion Topic.

Security

Certificates in the admin console are improperly formatted Some certificate field values in the Workplace Client Certificate Store pane of the WebSphere Administrative Console are being displayed in unusual formats. For example, some of the certificates display the serial numbers in decimal format instead of hex.

Creation of separate credentials not supported The administrative policy setting of creating separate signing and encryption credentials is not supported on the Workplace client. When credentials are created on the client, whether at start-up or on-demand, a single public and private key pair will be created for use in both signing and encrypting messages, even if the administrator policy is set to generate separate credentials. In addition, a single certificate will be submitted for certification, if this is configured.

Importing of some PKCS12 files is not supported The Java Runtime Environment (JRE) that ships with IBM Workplace rich client products enforces restrictions regarding the cryptographic algorithms and maximum cryptographic strengths available for use by the rich client applications in different geographic locations. For example, restricted policy specifies limits on the allowable length, and as a result, the strength of encryption keys. IBM Workplace ships with restricted policy settings. You can set it up to use unrestricted policy settings if you live in an eligible geographic region; see the Strengthening the encryption keys used by IBM Workplace rich client products topic in the IBM Workplace Information Center for more details.

Some PKCS12 files use algorithms that are not supported by restricted policy. Even if the file itself is protected by an acceptable algorithm, such as PBEWithSHAAnd40BitRC2, it may contain a private key that is shrouded using an algorithm not supported in the restricted security context, PBEWithSHAAnd3KeyTripleDES, for example.

Which certificates use unsupported algorithms? - The Internet Explorer (IE) browser exports data in the unsupported PBEWithSHAAnd3KeyTripleDES format, even if the option to not use strong encryption is chosen. The only way a PKCS12 file can be imported into the client is if it uses the 40BitRC2 algorithm. Files encrypted with this algorithm are not exported by IE using the PBEWithSHAAnd40BitRC2 algorithm.

- When exporting PKCS12 certificates using the Notes security panel, Notes always uses Triple-DES PBE to protect the private key. This algorithm is not available to IBM Workplace under the restricted key policy. The Notes backend code supports a variety of other PBE algorithms, including 128-bit RC2, which would be permitted under the restricted policy; however the Notes security panel does not allow the user to choose anything other than triple-DES.

39


Reverse Proxy Support Only Workplace Messaging supports reverse proxy; therefore only Workplace Messaging supports Tivoli Access Manager (WebSEAL).

Browser issues

Directory Search Help problem with Lotus Notes client settings Help for Directory Search does not work with certain Lotus Notes client browser settings. If a user of the Lotus Notes client has a current Location - Internet Browser setting of "Notes with Internet Explorer," clicking a URL to open IBM Workplace opens the browser within the Notes user interface on a tabbed page. If a user then opens the Directory Search window while performing a Workplace task such as sending a Mail message, and clicks the Help button, the Help window does not display Help properly.

Note: The Location - Internet Browser setting of "Notes" is not supported with IBM Workplace.

Workaround Advise users to set their Location - Internet Browser to "Microsoft Internet Explorer," or to "Other" (to use a different browser, such as Mozilla).

Portlet issues

Option to overwrite template is given when not applicable Import is showing the option to overwrite a template, even though the user does not have Editor rights to the orginal template. Although the option to overwrite is shown, when the user tries to overwrite the template, they will be prompted by the overwrite confirmation window again.

The system will not let the user overwrite the template, even though it is showing the option

Remove Contact from Instant Contacts limitation You can remove a contact from Instant contacts by clicking a contact's name to display the menu and then clicking Remove from Instant Contacts list. In any given Workplace session, you can remove only one contact from the Contacts List.

IBM Data Access Tool

Database application names are limited to 50 or fewer characters When entering the name of a new database application in the New Database Application window, limit the number of characters to 50 or fewer. If the number of characters exceeds 50, an error message will display and you will not be able to create the new application until you reduce the number of characters in the 'Name' field to 50 or fewer.

40


Input mode values cannot be changed for certain data types If a control on a form in data access designer contains the data type INTEGER, FLOAT, DATE, or DATETIME, you cannot edit the Input mode value for that control, which appears in the Basics tab of the attributes editor when the control is selected.

Printing limitations When printing forms, grids, and reports using IBM Data access viewer, you may experience the following limitations:

1. When printing grids and reports, you cannot print individual rows, even though you may see this as an option on the printing setup window. Instead, you can only print grids and reports in their entirety.

2. When viewing a form, you can only print the record that is currently being displayed in that form, even though you may see an option to print all pages on the printing setup window. If you want to print multiple records, you must display and print each record individually.

3. In Internet Explorer, an 'about:blank' message may appear at the bottom of your screen and consequently in the footer of printed pages. To remove this message, open Internet Explorer, click File > Page Setup, and then remove the '&u' at the beginning of the Footer field in the Headers and Footers section. You can also open this window by clicking CTRL+U while displaying a print preview.

4. When printing forms with shapes, the shapes do not print.

5. In order to print background colors and images that appear in your form, grid, or report, you must first enable your browser to print them. The way to enable printing background colors and images depends on your browser.

In Internet Explorer V6, take the following steps: 1. Click Tools > Internet Options.... 2. Click the Advanced tab. 3. Under Printing, check the Print background colors and images option. 4. Click OK to save your changes.

In Mozilla V1.4, take the following steps: 1. Click File > Page Setup. 2. Check the Print Background (colors and images) option. 3. Click OK to save your changes.

6. When printing a form, grid, or report, background images that are set to fit-to-size are printed, even when you have not enabled your browser to print background colors and images. To avoid printing background images, do not enable the fit-to-size option for the image.

7. Non-standard fonts do not print correctly. Non-standard fonts include those fonts that begin with 'WCT', for example, 'WCT_engl'.

8. When adding a field with a Multiline Edit control, the default setting for wrapping text is 'off' and no scroll bars. For Linux/Mozilla users, If you disable wrapping but do not enable scroll bars, printing problems may occur where the multiline edit field will expand to the length of the longest line within it, overlapping any controls in its path.

Right-to-Left format is not supported in this release Right-to-Left format in IBM data access tool is not supported in this release.

41


Activity Explorer

Cannot add groups to the membership list of a shared object When adding members to a shared object, you can add the names of individual members only; you cannot add group names.

Cannot open activity explorer by dragging file to a contact When a user has the Workplace rich client open to the Messaging perspective or any perspective other than activity explorer, and drags a file from the Windows desktop to a name in the Instant Contacts list, this action should automatically launch activity explorer. However, if the user has not previously opened activity explorer from the Switcher bar, the user will be unable to drag a file to a name in the Instant Contacts list. After opening activity explorer from the Switcher bar, later attempts to drag a file to the Instant Contacts list

Cannot print directly from shared objects You cannot print directly from any shared object, with the exception of shared files. You can print the text of a shared note or persistent chat by copying the contents of the object to the clipboard, pasting the text to a text editor, and then printing from the text editor.

Cannot search across shared objects You cannot search for particular shared objects. If the list of shared objects in the Activity List is extensive, you can customize the view to help locate objects.

No detailed activity logs Activity Explorer doesn't currently provide a detailed event log to describe actions taken on members' shared objects.

No round-trip editing for shared files When you open a shared file, such as a Microsoft Word document, activity explorer launches the document in the appropriate application. However, any changes you make to a shared file are not automatically saved to the server. When you save a shared file, the file is saved as to your local hard drive only. After you save a local copy, you can then save it to the server to replace the existing server version , or if you want to preserve the existing server version of the file, you can post the new version as a response to the original.

No support for off-line use or archiving You cannot use activity explorer when disconnected from the server. Shared objects, with the exception of files, cannot be saved off-line.

No versioning or real-time editing of shared notes Shared notes do not support versioning or real-time collaborative editing. Although multiple members of a shared note can work on the object at the same time, the various members cannot see the changes that other members are making. When a member saves a new version of a shared note to the server, the modified version overwrites the original version. If multiple members are active in a shared note at the same time, the server retains the version that is saved last only. Previous versions are lost.

Not all chats are persistent Standard chats started from the Instant Contacts pane are not persistent and cannot be converted to persistent chats. To create a persistent chat from the Instant Contacts pane, right-click the contact and then click New Persistent Chat.

42


Technical Preview

Notes Mail - Junk Mail feature is not fully implemented If a user selects a document in a view, and then selects to move that document to the Junk Mail folder, the user will receive a message that future, similar messages will be delivered directly to the Junk Mail folder. This feature is not implemented in Notes mail. Future, similar messages will not automatically be routed into the Junk Mail folder.

NotesMail - Configuration Options which are not implemented In the Notes Mail portlet, under configuration settings:

1. The "Credential Vault" control isn't hooked up in the Notes Mail portlet; please do not use this feature. 2. The "Use a secure connection" checkbox isn't functioning in the Notes Mail portlet.

NotesMail - Confirm Delivery feature does not work When a user composes a new mail message, there is a checkbox to 'Confirm Delivery.' This feature does not work in this release.

NotesMail - Preference Options which are not implemented In the Notes Mail portlet, under Mail preference settings:

1. The "Use a secure connection" checkbox isn't functioning in the Notes Mail portlet (Mail Preferences/Edit Mail Source page).

2. The "Default sort order" selector does not change the order of the Inbox view. 3. The Out of Office controls do not contain error checking for invalid selections (date ranges, blank subject field).

Objects in e-mail message not displayed on wireless device When displaying a Notes mail message on a Wireless or hand-held device, the following objects will not be correctly represented in the document:

� Images/pictures Images and pictures will be omitted � Links Links will not be displayed or accessible � Buttons Buttons will be omitted � Tables The text contained in the table will be displayed unformatted. � Attachment An attachment will be indicated by the text "(See attached file: file-name)" but there is

no way to access the attachment.

Restored Mail folder is not implemented in Notes Mail Please note that the "Restored Mail" folder is not implemented in the Notes Mail portlet.

Search feature is not implemented The search feature is not functioning in the Notes Mail portlet; please do not use this feature in the current release.

Usage quota is not implemented The usage quota feature is not implemented in the Notes Mail portlet for his release.

43


Known problems and workarounds

Installation issues

All Workplace / Cloudscape installs need workplace.properties For all Workplace installations where Cloudscape is the database, administrators must ensure that a file called workplace.properties is manually created and copied to the user home directory. For Windows, this is Documents and Settings/<user>. For Unix, log in with the ID that is used to start the WebSphere, Portal and Workplace servers, and browse the HOME environment variable. Place workplace.properties in this directory ($HOME/workplace.properties).

To create the workplace.properties file, please follow these steps:

1. Copy the following information into a text editor (Notepad, WordPad, etc.)

nagano.account.datasource=jdbc/lwmAppnagano.accesscontrol.datasource=jdbc/lwmAppnagano.admin.datasource=jdbc/lwmAppnagano.calendar.datasource=jdbc/lwmAppnagano.directory.datasource=jdbc/lwmAppnagano.file.datasource=jdbc/lwmAppnagano.mail.datasource=jdbc/lwmAppnagano.pab.datasource=jdbc/lwmAppnagano.msgqueue.datasource=jdbc/lwmAppnagano.scheduler.datasource=jdbc/lwmAppnagano.startup.datasource=jdbc/lwmAppnagano.compact.datasource=jdbc/lwmAppnagano.quota.datasource=jdbc/lwmAppworkplace.policymanager.datasource=jdbc/lwmApparchive.tracking.datasource=jdbc/lwmApp

workplace.do.force.transactions=true

2. Save this file with the filename "workplace.properties"

3. Copy the newly-created workplace.properties file into the appropriate Unix or Windows directory, as described above.

Cannot remove workspace directory after install - need to reboot After uninstalling, users will not be able to remove the workspace directory. Please reboot the system, and then delete the workspace directory.

File not found error message upon running install.bat Run install.bat under Windows, and you get the following message:

Install: File not found - D:\DOCUME~1\db2admin\LOCALS~1\Temp\1\wplaunch\wpinstall.jar

This error message is harmless. You may ignore it and continue with install without problems.

44


High contrast mode may cause installers to mis-render When installing any of the IBM Workplace components on servers or workstations, under some circumstances, setting the system to high contrast mode may have unanticipated effects on panel layouts and readability. In these cases, the installers can be run using the -console command line switch to run in text mode.

Importing users from LDAP using Tivoli Access Manager This issue is described in the following scenario:

You have successfully installed and configured Tivoli Access Manager 5.1 with Tivoli Directory Server 5.2. Then you created a new suffix in the directory of Tivoli Directory Server for IBM workplace 2.0. After that, you successfully installed and configured IBM workplace with Tivoli Directory Server. You tried to integrated IBM Workplace with TAM by following the instructions in "Integrating Lotus Workplace Messaging 2.0 with Tivoli Access Manager 5.1" and " Integrating Lotus Workplace Messaging 1.1 with Tivoli Access Manager 4.1" on the developerWorks Web site. In the topic "LDAP integration", when you attempt to import users from LDAP into TAM, you will get an error message that TAM does not have the required privileges to import users from LDAP.

Workaround Because the LDAP suffix used by IBM Workplace is created after Access Manager has been configured, the appropriate ACLs should be applied to the new suffix manually for Access Manager to be able to manage users and groups within this new suffix. To apply the ACLs, you can follow the instructions in section "Apply IBM Tivoli Access Manager ACLs to new LDAP suffixs" in "Appendix D. Managing user registries" of "IBM Tivoli Access Manager Base Administration Guide 5.1". After you apply the ACLs, you can import the users into TAM. However, you may not be able to log into IBM Workplace using exsiting IBM workplace userids. To work around this problem, you can "unconfigure" TAM following topic "Unconfiguring Tivoili Access Manager components" in the Tivoli Access Manager Base Installation Guide and then configure it again. After configuring TAM again, you can successfully log into IBM Workplace.

Note: IBM Workplace 2.0 (on Windows 2000 Server, Service Pack 4), Tivoli Access Manager 5.1 (on AIX 5.2), and Tivoli Directory Server 5.2 (on AIX 5.2).

Provisioning component uninstall leaves log files After uninstalling the IBM Workplace rich client provisioning components, a set of log files will remain in the install root directory (default is c:\program files\ibm\ibm lotus workplace client provisioning). To completely clean the server, delete the install root directory manually after uninstalling.

Provisioning URL wrong for IEOP installation If you install IBM Workplace over an existing portal (IOEP), when dialog box for the provisioning URL come up, the default URL will be WRONG. It will be <SERVERNAME>/lwp/myworkplace/MyStuff, and it needs to be <SERVERNAME>/wps/myportal/MyStuff.

So that every user not need to have to fix this use the following workaround:

On the Server 1. Navigate to <WAS>\installedApps\<NODENAME>\wctInstall.ear\wctinstall.war 2. EDIT the file: pluginvalues.props

change the line: plugin_customization.com.ibm.workplace.configuration/defaulturl=$host$/lwp/myworkplace/MyStuff

to: plugin_customization.com.ibm.workplace.configuration/defaulturl=$host$/wps/myportal/MyStuff 3: Save the file

Now when you provision, the default provisioning URL will be right.

45


UpdatePDM fails on Windows using the default installation folder UpdatePDM fails if the default wps/was directory is used for install (that's any directory with a long name, i.e., C:\Program Files\WebSphere). This is due to the fact that the installer may fail to pick up on the long directory name and, therefore, fail to update the UpdatePDM batch file during install.

Workaround You will need to edit the updatePDM.bat file and manually add the WAS_HOME and WPS_HOME environment variable settings. See the bolded text in the sample updatePDM.bat file below as an example:

@echo offrem Copyright IBM Corp. 2004

rem THIS PRODUCT CONTAINS RESTRICTED MATERIALS OF IBMrem All Rights Reserved * Licensed Materials - Property of IBMrem US Government Users Restricted Rights - Use, duplication or disclosurerem restricted by GSA ADP Schedule Contract with IBM Corp.

echo SCRIPT VERSION 20040802 0725PDM

setlocal

SET WAS_HOME=C:\Program Files\WebSphere\AppServerSET WPS_HOME=C:\Program Files\WebSphere\PortalServer

if exist "%WAS_HOME%\bin\setupCmdLine.bat" call "%WAS_HOME%\bin\setupCmdLine.bat"

echo WAS_HOME = %WAS_HOME%echo WPS_HOME = %WPS_HOME%echo JAVA_HOME = %JAVA_HOME%echo WAS_NODE = %WAS_NODE%echo WAS_CELL = %WAS_CELL%echo ..

if not exist "%WPS_HOME%\updatePDM\*" (echo *** ERROR %WPS_HOME%\updatePDM DOES NOT EXIST ... goto exit

)call "%WAS_HOME%\bin\stopServer" WebSphere_Portalcall "%WAS_HOME%\bin\stopServer" server1cd /d "%WPS_HOME%\updatePDM"call "%WPS_HOME%\updatePDM\updatePortal" -fixpack -installDir "%WPS_HOME%" -fixpackDir "%WPS_HOME%\updatePDM\fixpacks" -install -fixpackID LWP_PTF_20call "%WPS_HOME%\updatePDM\updatePortal" -fix -installDir "%WPS_HOME%" -fixDir "%WPS_HOME%\updatePDM\fixpacks" -install -fixes PQ90055call "%WPS_HOME%\updatePDM\updatePortal" -fix -installDir "%WPS_HOME%" -fixDir "%WPS_HOME%\updatePDM\fixpacks" -install -fixes PQ90024call "%WPS_HOME%\updatePDM\updatePortal" -fix -installDir "%WPS_HOME%" -fixDir "%WPS_HOME%\updatePDM\fixpacks" -install -fixes PQ94757cd /d "%WPS_HOME%\config"call WPSconfig CFG-LWP-20cd /d "%WPS_HOME%\updatePDM"

:exitendlocal

46


Configuration issues

Additional steps to set correct heap size of JVM When running Workplace 2.0, the WebSphere\AppServer directory gets filled with various heapdump and javacore files, for example:

heapdump.20040625.083931.896.txtjavacore.20040625.084045.896.txt

This occurs because when IBM Workplace is started, it invokes a second JVM without allocating enough memory for the heap. These settings are not exposed in the WebSphere Administrative Console and therefore it is necessary to follow the steps below to manually modify one file:

1. Extract the file jvm.config from

\WebSphere\WorkplaceServer\lwps_extdir\channellwpservice.jar

into...

/websphere/AppServer/classes/com/ibm/wkplc/channellwp/service/impl directory

2. Set the following in the same file.

VM_ARGUMENTS=-Xms1024m -Xmx1024m

3. Restart the servers and the new settings will be in place.

Administrative Console field validation is not working correctly Field validation in the WebSphere Administrative Console does not work correctly if the locale of your browser is different from the locale of the WebSphere Server. When you enter an invalid value into a field, one of the following actions occurs:

� No error message displays. � An Incorrect error message displays. � An Error 500 servlet exception displays.

In these client configurations, IBM recommends that you verify your field entries before you click Save/Save to commit them to the configuration store.

Note: This issue is not specific to IBM Workplace pages.

Attachment viewer may require additional software installation You may need to install additional software so that the attachment viewer works properly. The attachment viewer in the Mail and Web Conferencing portals allows documents produced by many different applications, such as word processors or spreadsheets, to be viewed as HTML pages.

On AIX or Solaris machines, if not already installed, install X Windows (X11R6). On Linux systems, install Motif 2.0 or LessTif 0.93 to make the attachment viewer work properly. You can install the software before or after installing the WebSphere Portal Server.

For more information on document conversion and system requirements, go to http://publib.boulder.ibm.com/pvc/wp/502/ent/en/InfoCenter/wpf/pdm_info.html#docconv.

47


Authorization Data Exception during lwpT-portal-setup When you use the "lwpconfig lwpT-portal-setup" install for IBM Workplace Collaborative Learning 2.0, the install fails. The log displays the following information:

init-wireless:

lwwA-setup-mobile: [copy] Copying 1 file to C:\WebSphere\workplaceserver\config\work

[xmlAccess] XMLA0006I: Connecting to URL http://localhost:9081/lwp/config [xmlAccess] XMLA0002I: Reading input file C:\WebSphere\workplaceserver\config\work\addmobilemarkups.xml [xmlAccess] XMLA0011I: Request was accepted. [xmlAccess] <?xml version="1.0" encoding="UTF-8" ?> [xmlAccess] <failure> [xmlAccess] com.ibm.wps.command.CommandFailedException: WPCM0004E:An unknown exception occurred: CommandException [xmlAccess] WrappedException is: com.ibm.wps.ac.AuthorizationDataException: PACC0057E: Authorization Data Exception occurred. [xmlAccess] </failure>

BUILD FAILED file:./wireless/actions/wps_cfg.xml:17: XMLA0015E: Server response indicates an error.

Workaround You can work around this issue by making sure that you stop the WebSphere portal before you begin the IBM Workplace installation.

In one particular case, in addition to stopping the WebSphere portal, cleaning out the Documents and Settings\db2dmin\Local settings\Temp\1 directory, rebooting the machine, and starting the install again worked.

Before running lwpT-portal-setup, do the following:

1. Navigate to the file, ...WebSphere\AppServer\lib\ext

2. Look for the following .JAR files (you should only have the ones named below):

-- bloxcommon.jar -- epi-common.jar -- wsdl4jpbext.jar.

3. Remove all other .JAR files, or rename them to something with a non-".JAR" extension.

4. You will need to re-run the failed configuration targets, or re-install IBM Workplace and apply this fix prior to running base-setup.

Cannot log into IBM Workplace if LDAP server is restarted If the network goes down between IBM Workplace and the LDAP server, or the LDAP server needs to be restarted in a production environment, trying to log in to IBM Workplace will fail, displaying an error message: "The system could not log into your account."

To work around the problem, restart the WAS/Portal/LWP servers.

48


Datasource Issue when Configuring WebSphere Portal for DB2 The "Configuring WebSphere Portal for DB2" section of the WebSphere Portal InfoCenter has the following section on updating wpconfig.properties:

DbDriverDs Description: The data source for the JDBC provider that WebSphere Portal uses to communicate with its databases. Recommended value: COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource Default value: com.ibm.db2j.jdbc.DB2jConnectionPoolDataSource (Cloudscape)

The DbDriverDs recommended value is incorrect, it should be: COM.ibm.db2.jdbc.DB2XADataSource

If you have not yet performed the steps outlined in the "Configuring WebSphere Portal for DB2" section, then be sure to use this correct value for DbDriverDs.

If you have already performed these steps (and therefore have used the incorrect DbDriverDs value), your Portal log files may have errors similar to this:

TransactionIm E WTRN0062E: An illegal attempt to use multiple resources that have only one-phase capability has occurred within a global transaction.

To correct this, do the following:

1.) Log in to the WebSphere Administration console2.) Choose Resources -> JDBC Providers3.) Select the wpcp50JDBC entry4.) Change the Implementation Classname to COM.ibm.db2.jdbc.DB2XADataSource5.) Click OK6.) Click Save twice7.) Choose Resources -> JDBC Providers8.) Select the wps50JDBC entry9.) Change the Implementation Classname to COM.ibm.db2.jdbc.DB2XADataSource10.) Click OK11.) Click Save twice12.) Log out and restart all WebSphere instances

enable-security-ldap fails with Authorization Exception Occasionally WebSphere Portal's enable-security-ldap task fails with an error similar to this:

start-portal-server: [logmsg] 2004.06.17 11:01:30.041 start-portal-server [logmsg] EJPC3060I Starting Server "WebSphere_Portal"

[exec] ADMU0116I: Tool information is being logged in file [exec]

/usr/WebSphere/AppServer/logs/WebSphere_Portal/startServer.log [exec] ADMU3100I: Reading configuration for server: WebSphere_Portal [exec] ADMU3200I: Server launched. Waiting for initialization status. [exec] ADMU3000I: Server WebSphere_Portal open for e-business; process id

is 39732

action-create-deployment-credentials:[xmlaccess] <?xml version="1.0" encoding="UTF-8" ?>[xmlaccess] <failure>[xmlaccess] com.ibm.wps.command.xml.XmlCommandServlet$AuthorizationException: XMLC0005E: Authorization for user wpsadmin failed.[xmlaccess] </failure>

49


If this occurs, check the wpconfig.properties file under the WebSphere/PortalServer/config directory and make sure that the LDAPUserFilter and LDAPGroupFilter properties exist and are filled out. If they aren't, create them and fill them out using the rules for your particular LDAP vendor and structure (examples below) and then re-run enable-ldap-security.

# LDAPUserFilter: The LDAP user filter appropriate for your LDAP server (to work with default values in WMM)

#IBM Directory Server: { (&(uid=%v)(objectclass=inetOrgPerson)) }#Domino: { (&(|(cn=%v)(uid=%v))(objectclass=inetOrgPerson)) }#Active Directory: {

(&(|(cn=%v)(samAccountName=%v))(objectclass=user)) }#SunOne: { (&(uid=%v)(objectclass=inetOrgPerson)) }#Novell eDirectory { (&(uid=%v)(objectclass=inetOrgPerson)) }LDAPUserFilter=

# LDAPGroupFilter: The LDAP group filter appropriate for your LDAP server (to work with default values in WMM)

#IBM Directory Server: { (&(cn=%v)(objectclass=groupOfUniqueNames)) }#Domino: {

(&(cn=%v)(|(objectclass=groupOfNames)(objectclass=groupOfUniqueNames)))

#Active Directory: { (&(cn=%v)(objectclass=group)) }#SunOne { (&(cn=%v)(objectclass=groupOfUniqueNames)) }#Novell eDirectory { (&(cn=%v)(objectclass=groupOfUniqueNames)) }LDAPGroupFilter=

Exposed passwords in configuration and support files Administrative passwords in system files Some system configuration files and log files contain administrative passwords in plain text. IBM provides a data collection utility that collects some of these files in a JAR file for you to send to IBM for problem determination. While we have made every effort to identify these files and remove them from the JAR file, there may be some additional cases in this beta release we have not filtered. Therefore, we strongly recommend that for the installation of this beta release, you do not use the same administrative password for IBM Workplace products (the Portal Administrator, for example) that you use for your production systems. If you are concerned about sharing these system passwords with IBM, you should not use the data collection utilities that are installed with the product. The paragraphs below list those files which are in question as well as a description of how to modify the collector utility if you would want these files to be collected. These issues will be resolved prior to general availability.

System files containing passwords There are several system configuration files that contain administrative IDs and passwords (including those for the Portal administrator). These files are:

� <was_root>\config\soap.client.props � <wp_root>\config\wpconfig.properties � <wp_root>\config\wpconfig_ascii.properties � <wp_root>\config\wpconfig1_.properties � <wp_root>\config\wpconfig1__ascii.properties � <wp_root>\config\ArchiveInstall.properties � <wp_root>\config\wpconfig_<date_and_time_stamp>.properties

None of these files are collected by the IBM Workplace data collection utility. However, for installation and configuration problems, if you do want these added to the collected JAR file, please see below for more information.

Additionally, there are several log files created during the installation and configuration process which may contain the same passwords. These files are:

� <wp_root>\config\ConfigTrace.log � <wp_root>\config\configwizardlog.txt � <lwp_root>\log\lwpinstalllog.txt

The first of these files is currently copied by the IBM Workplace data collection utility, the remaining log files are not. Please read the subsequent paragraphs about the IM Workplace Data Collection utility for more information about modifying the behavior of the collection utility.

50


Modifying the IBM Workplace data collection utility The collector utility simplifies the task of reporting and diagnosing problems on your IBM Workplace installation. The collector is installed at <lwp_root>\tools\collector\scripts\<platform>

The utility is launched using the testScript file contained in the same directory. Diagnostic data is archived into a .JAR file named with date and time stamp and stored in the C:\WebSphere\WorkplaceServer\tools\collector\out directory. The definition of items to collect in that .JAR are contained in the workplace.inventory file contained in the scripts directory.

The workplace.inventory file is a text file listing files and directories of files to be gathered, as well as utilities and commands to execute to obtain system configuration information. The inventory file can be edited to add or remove files from the JAR file and contains comments to demonstrate how this is done. Comments are indicated by the use of an exclamation point (!) at the start of the line. Alternatively, a new inventory file could be created; and the testScript file modified to use the new inventory file.

Finally, once the collector has been run, particular files could be removed from the resultant JAR file using any standard archive file utility, before copying the archive to IBM.

Conventions

Convention Root installation directory

<wp_root> \WebSphere\PortalServer\

<was_root> \WebSphere\AppServer\

<lwp_root> \WebSphere\WorkplaceServer\

<WebSphere_DeployMgr_root> \WebSphere\DeploymentManager\

<ihs_root> \IBMHTTPServer\

Incorrect default theme Themes are defaulting to Adminstrator with Left navigation. In order to change the Themes, the following workaround is provided:

Workaround

� Start the WPS server and click 'Administration'

� Click 'Manage Pages'

51


� Click the Edit icon for Administration, as shown below:

� Assign the IBM Workplace Collaboration Services Theme to all of Admin

� Choose 'OK'; choose 'OK' again. You will see the new Admin Theme has been applied.

52


java.net.ConnectException errors during running config targets There is a known issue where, in some cases, Portal Server fails to start in the midst of running certain configuration tasks. If this happens, you will receive a BUILD FAILED error message during base-setup for IBM Workplace.

Workaround Start Portal server manually, before attempting to re-run the config targets, and/or the rest of base-setup. Simply start your Portal Server manually, by running your startserver script file and specifying the name of your Portal Server instance, and re-run the failed target(s), and the remainder of base-setup.

LMS uses the uid attribute to authenticate user in LDAP The SPR relating to this issue seems to be a configuration issue - Portal seems to be authenticating based on the LDAP cn attribute (value is 'administrator') whereas LMS, by default, uses the uid attribute (value of 'administ').

So if get the exception error: usermod_unable_get_authuser_wmmsettings

Workaround is to update LMS via settings.xml (as per my comments) or have the LDAP updated to have uid and cn the same value. : So, if authentication is based on cn attribute the LMS needs to be updated in settings.xml and ds-settings.xml in both DS and LMM as follows, ie change the wmmAttribute for ldapid and userid to "cn", instead of "uid", and the Portal server restarted.

<ldap ... ... <users loginKey="LdapId"> <commonschema> ...

<mapping name="LdapId" wmmAttribute="cn"/> <mapping name="UserId" wmmAttribute="cn"/>

. . .User wpsadmin could already log into either LMS or IBM Workplace because its LDAP entry has uid and cn attribute values the same, i.e., 'wpsadmin'.

Manage Workplace Applications page is not working In the Administrative Console, the Manage Workplace Applications page does not display the Workplace Applications defined in the system.

Non-Workplace theme gives JavaScript errors & missing GIFs When users are switched to a non-Workplace theme, they may encounter JavaScript errors and broken image sources. To fix this issue, copy the entire "psw" subdirectory in

"[WASHOME]\installedApps\[nodename]\wps.ear\wps.war\themes\html\workplace"

to the desired theme.

Example: Copy from:

"F:\WebSphere\AppServer\installedApps\brisket\wps.ear\wps.war\themes\html\workplace\psw"

to: "F:\WebSphere\AppServer\installedApps\brisket\wps.ear\wps.war\themes\html\Science"

53


Out of Memory Exception Errors in running config targets Under certain circumstances, there is a known issue with the ANT 1.5.1 version that is bundled with WAS, which IBM Workplace utilizes for running its configuration tasks in setting up IBM Workplace 2.0. The issue causes Out of Memory Exceptions, and failed targets in setting up IBM Workplace. This issue seems to happen more often on UNIX based platforms, but can also occur in Windows under certain circumstances. The solution to the issue, aside from trying to increase the heapsize as described in a separate release note, is to download and install the latest version of ANT to your WAS install. The latest version of ANT can be found at:

http://ant.apache.org/

Please proceed to download the latest ANT, which will be bundled in a single ZIP file. Here are the steps to follow in order to get the updated ANT running on your system:

1. Copy the latest ANT's ZIP file into your IBM Workplace server, in any temporary folder.

2. Unzip the file.

3. Copy the contents of the 'lib' folder, under the new ANT's unzipped folder structure, into your WAS_HOME/lib folder (i.e., /usr/WebSphere/AppServer/lib/). Overwrite ALL files. (Note: It is HIGHLY recommended that you backup the contents of your WAS_HOME/lib folder prior to running this step).

4. Re-run the previously failed target(s).

5. Continue with install/configuration.

You should now be able to successfully pass through all your configuration targets.

Some Admin Console i-tag help links aren't connected The Admin Console Help isn't complete and some of the i-tag links on the IBM Workplace pages will display an error in the Help window. In most cases, users can open the Admin Console Help window and manually navigate to the desired topic under the IBM Workplace or IBM Workplace Server index entries.

User Policy setting and new categories for catalogs Using a new category for the Document Library or Team Space catalogs disables the Workplace User Policy for that catalog.

Workaround When using a new category in the Team Space catalog or the Document Library catalog, and you want to restrict application creation with User Policies, you will need to use the "Allow Workplace applications - Create User policy" options to restrict creation.

Following is a table that maps which categories map to which User Policy:

Catalog Template Category User Policy Team Space Catalog TeamSpace Category Allow team spaces - create Team Space Catalog New Category Allow Workplace Applications - create Team Space Catalog Document Library Category Allow Document Libraries - Create Team Space Catalog Workplace Application Category Allow Workplace Applications - create Workplace Application Catalog TeamSpace Category Allow team spaces - create Workplace Application Catalog New Category Allow Workplace Applications - create Workplace Application Catalog Document Library Category Allow Document Libraries - create Workplace Application Catalog Workplace Application Category Allow Workplace Applications - create Document Library Catalog TeamSpace Category Allow Team Space - create Document Library Catalog New Category Allow Workplace Application - create Document Library Catalog Document Library Category Allow Document Library - create Document Library Catalog Workplace Application Category Allow Workplace Application - create

54


Web Server setting needed to support WCT downloadsLotus Workplace Client Technology downloads require the application/zip type to be defined for Jar files. See your web server's documentation for how to do this. For IBM HttpServer, do the following:

� Edit httpd.conf file

� Add the following line to the <IfModule mod_mime.c> section:

AddType application/zip .jar

Windows 2003 using Lwp.db.drop=true does not work If the machine hosting the database server for Workplace databases is using Windows 2003 as the operating system then use native database tools to drop databases if needed. The property Lwp.db.drop=true in the file lwpprops.properties in <Workplace Home>/config does not work with the Win2003 operating system. Please use the tools provided by the database vendor (Oracle, DB2 etc..) to drop the database.

"Too many open files" exception The Juru search indexing job might present a "too many open files" exception when very large numbers of files (around 40000) are being indexed at the same time. Depending on the format of the files, this error may or may not occur. When it does occur, it is because available file handles in the system have been used up. Importing empty or corrupted files into the system deteriorates the scenario. Importing files whose formats are not supported by Document Conversion Technology also imposes a negative effect.

One way to work around the problem is to increase the maximum number of file handles allowed in the system. If this choice is not feasible, you may also choose to import and index files in smaller chunks.

IBM Workplace Collaborative Learning issues

Cannot log into <servername>/lms-lmm In the current Beta build, it is not possible to log into http://<servername.lotus.com/lms-lmm

Workaround In your current deployment database, log in and apply the following changes:

� set schema lwplms

� Run the following lines in cview on the lwp25 database (back up the database first):

update lwplms.permission set perm_id=perm_id-1 where perm_id > 446; update lwplms.permission set perm_id=perm_id-1 where perm_id > 9; update permission set perm_id=perm_id-1 where perm_id > 446

� Now restart the (learning) servers.

Courses with a file-based CMI activity will not launch on XP There is a known issue in IBM Workplace Collaborative Learning 2.0 on Windows XP when you launch a course containing a file-based CMI activity. Please note the file-based activity launches properly on other versions of Windows.

55


Limitation of JReport Server Engine for Bi-di characters display TM

The JReport Server Engine in IBM WorkPlace Collaborative Learning supports Bi-directional characters, but Right-to-Left display is not supported. Therefore, all Bi-di reports will display from Left to Right, like English reports.

Skills Dictionary - Cannot remove proficiency levels In the Skill dictionary, it is not possible to remove a proficiency level from a rating scale, i.e., the remove functionality does not work.

The only workaround is to delete the rating scale, recreate it, and add back the desired proficiency levels.

Some IE browsers may hang if student uses the 'Previous' button Internet Explorer with certain versions of the JVM hangs if a student uses the "Previous" button. Downgrade to a Microsoft JVM version lower than 3810 (for example 3802 or 3805), or install the Sun JVM Version 1.4.2, which is available from www.javasoft.com.

Tracking doesn't work with separate LMS and Delivery servers Tracking doesn't work with separate LMS and Delivery servers running under Windows. A WebSphere fix addresses the problem (#PQ71167), and increases the allowable response header length from 8K to 100K.

Download the "WebSphere Plug-in Cumulative Fix for 5.0.0, 5.0.1, and 5.0.2" from the IBM Support Site, and apply the patch to both servers to remove the limitation.

"Value must be a double" message when viewing course results Click Results By User from the Course Management tab, search for a course, and then edit it. When you save your changes, you see the error "Value must be a double" above one or more of the following numeric fields: Min Score, Max Score, Raw Score or Time Spent.

The message should read "Value must be numeric." Change your entry in the field to a numeric value and save again.

IBM Workplace Documents issues

Applications containing Team Tasks limit names to 100 characters Workplace applications that contain Team Tasks as an application component cannot have application names that exceed 100 characters. For example, make certain that the names of your Team Space applications, built from the Team Project template, are not more than 100 characters long.

Configuring Documents e-mail notification When you configure e-mail notification for IBM Documents, and your site does not have a license for Workplace Messaging, you must perform the following actions to set up e-mail notification:

1. Perform steps 1 and 2 of the Messaging configuration checklist by setting the DNS name of the Mail Services and setting the DNS servers from which to retrieve MX attributes. The Messaging configuration checklist is available in the IBM Workplace Information Center. Open the information center and in the navigation pane, click Messaging --> Messaging configuration checklist.

56


2. Use a text editor and open: <was_root>\wpcp\config\<node>\WebSphere_Portal\author\WCM.properties

3. Edit the last two lines of text (see example below), substituting your company's fully-qualified SMTP server address and the e-mail address to which you want e-mail notifications sent.### E-Mail settings for lite workflow## Please edit for your company's e-mail and smtp settings.#wcm.mail.smtp.host = smtp_host.mycompany.comwcm.mail.return.address = [email protected]

4. Save and close the file.

5. Restart the servers.

Document Editors issues Following are the issues associated with the Document Editors in this beta release of IBM Workplace:

General

� Files with Document Editor format (*.sxw,*.sxc and *.sxi) can not be opened from the local file system.

� On the Linux platform, in the case of documents containing characters that can not be displayed (such as WingDing), when exporting the document as PDF format, the editors may crash.

� When using a National Language version, Document Editors can have issues dealing with metric units when translated into National Language names. For instance, "cm" is translated as Chinese characters "··".

� "Undo" doesn't work for deleted text in a text box when the focus has been moved out of the box.

� On the Linux platform, for a large-sized Microsoft Office file, if you open the file in Document Editors and Edit or Save in Document Editor format, and then export the file in PDF format, when you open the PDF file in Document Editors, the data will be lost, and the file will be empty.

� In the following case, the linked object, (i.e., the linked graphic and floating frame) will be lost in Document Editor.

Click Create -> GraphicsClick "Link" in the Graphics dialogSelect a picture file; for example, D:\house.wmfClick "Open" to exit the Graphics dialogSave and Close the documentDelete or rename the file D:\house.wmfRe-open the document; the linked object has been lost

� When opening more than one Document Editor file, and then opening a Microsoft PowerPoint file to edit, Document Editor may crash.

� Copy & Paste between different applications in Document Editor may lead to a change or loss of the pasted object property.

� Extended Tips can't be displayed in the Preference dialog.

� When enabling the setting "Use the browser embedded in this client" (Preference->Web Browser), then clicking a URL in a document, the embedded browser can't be launched. Instead, Microsoft Internet Explorer is launched on the Windows platform, and an error dialog pops up on the Linux platform.

� In the Help table of contents, when the book "IBM Productivity Tools" is selected, there is no content displayed.

� A password-protected file can not be opened in a Document Editor.

57


Word Processing Editor

� When copying text from the Word Processing Editor and pasting to the Mail client, the result string may contain an extra line.

� For Chinese users, when using Microsoft Pinyin IME2003 to input numbers into the Word Processing Editor, the auto-text-correction function does not work correctly.

� If the height of a row in a table is larger than that of the page, the content outside of the page cannot be displayed; however that content will not be lost. If the height of a row in a table is no more than that of the page, but there is not enough space to display it on the current page, the row will be displayed on the next page

� If you are opening, editing, or saving a document when it is under loading (the page number in the status bar keeps on increasing), Document Editor may crash.

� "Undo" does not work when a document is under loading (the page number in the status bar keeps on increasing) until the loading is finished.

� When opening a Microsoft Word file which has tables with merged cells in the Work Processing Editor, Document Editor may crash.

� In certain cases, when switching from Outline view to Normal view in the Word Processing Editor, Document Editors may crash.

� Graphics will be lost if you save a Word Processing Editor file as an HTML file.

� In the Word Processing Editor, if you click Create->Note, the author name can not show in the Author field of the Insert Note dialog.

Spreadsheet Editor

� If generating a chart in a Microsoft Excel document with the following steps:

Click Insert -> ChartIn the Series page, click AddInput a string as the legend name in the Name fieldClick Finish

The legend name in the chart will lose fidelity for rendering when the document is opened in the Spreadsheet Editor. This issue can be avoided by referring the text string from the cell, rather than inputting as described above.

� Generating a chart in a Microsoft Excel document with the following steps:

Click Insert->ChartIn the Series page, click AddInput {1,2,3,4,5} in the Values fieldClick Finish

The source data will be lost when the document is opened in Spreadsheet Editor. This issue can be avoided by using the source data getting from the cell, rather than by inputting as described above.

� Application stops responding when clicking the 'Number' tab under "Cell properties" in the Spreadsheet Editor. Open vcl.xcu (applications\eclipse\plugins\com.ibm.superodc.base.share.linux_1.5.0\registry\data\org\openoffice). Find SANS_UNICODE in en section, then add "sanscondensed" into the front of the font list.

Presentation Editor

� "Align Left", "Align Center", and "Align Right" for the text in a drawing object (i.e., rectangle and ellipse), do not work.

� If a file is saved in Outline view or Page view, when opening the file, Document Editors will no longer respond.

� In the course of a document loading, you can not selecting and edit the content in a text box object until the loading is finished.

� In a slide with Background on, if you create a 3D object, and then double-click on the object, you will not be able to exit from the associated state to select another object unless you do another operation (i.e.,switch to another slide).

58


� How to add customized template files:

- Create a Presentation document.

- Locate the template folder in local file system by searching for the base folder whose name starts with "com.ibm.superodc.base.share" in user folder, e.g. C:\Documents and Settings\username for Windows platform. The template folder is base folder/template/language/layout

- Export the presentation file to local file system at the template folder.

� In certain case, when a file is still under loading in Word Processing Editor or Presentation Editor, if saving, opening or closing it, Document Editors may crash.

� "Undo" doesn't work when a document is loading until the loading is finished.

� In certain cases when opening and closing two or more large-sized Microsoft PowerPoint files with objects, Document Editor may crash.

� In certain cases, when opening and closing a Microsoft PowerPoint file, if another Presentation Editor document is opened in Outline view, Document Editors may crash.

Project Planner Following are the issues associated with the Project Planner in this beta release of IBM Workplace 2.5:

� The start date of a task which has automatically changed its start date because of the "Finish-Finish" link, can not change back when the linked task is deleted.

� When using "Finish-Start" to constrain a milestone, Project Planner does not adjust the milestone's start date.

� Project Planner inherits some issues that result from Eclipse and GEF; for example, Task multi-level display in Linux, or GANTT chart drag-and-drop in Linux.

IBM Workplace Rich Client issues

'Reply To All' & 'New Message To All' inserts extra addressee When using the "New Message To All" options to send a message, the addressee will appear twice in the 'To' field.

This extra address can be deleted manually to prevent multiple sendings of the email.

'Using a wizard' update/install option only supported in English The 'Using a wizard' update/install option is only supported in English for this release.

Accessibility issues � Using Windows, if you press Shift five times in a row, the Windows StickyKeys dialog box opens and IBM

Workplace hangs. IBM Workplace will also hang with ToggleKeys, MouseKeys, and FilterKeys. If you press Ctrl, and then press F7 to display a pop-up list of all the views that are open, IBM Workplace flashes a dialog box so quickly that you cannot read it. Use Windows Task Manager to close the StickyKeys dialog box and restart IBM Workplace.

� When high contrast is enabled, the Get Information from Directory button in address book entries does not display correctly.

� You cannot use the Tab key to access attachments in a mail message.

59


� On Linux, you cannot navigate the Preferences dialog box by typing the first letter of section names. Use the arrrow keys instead.

� If you use a screen reader to read Help, use one of the following workarounds to navigate between Help frames. WindowEyes: After selecting a topic in the Help table of contents, press H to go to the first heading of the topic (the title of the topic), and then press Ctrl+Shift+R to read the topic. To return to the table of contents, press Ctrl+Home to go to the top of Help, and then press Ctrl+Tab seven times. JAWS: After selecting a topic in the Help table of contents, press M until the topic view frame is current and then press Ins+Down to read the selected topic. To return to the table of contents, press M until the contents view frame is current.

Address book entry issues � If you add members to a group manually by typing addresses in the Add an e-mail address field, a new contact

entry is added to the address book for each member you add. Delete any unwanted contacts from the address book.

� If you select Add to Instant Contacts in a contact entry, and then save the entry, the contact does not appear immediately in the Instant Contacts list. If you close and restart your client, the new contact appears in the Instant Contacts list.

� You cannot delete a contact or group entry while viewing it. If you click Delete above the entry when it is open, the entry will not be deleted. To delete the entry, close the entry, and then select and delete it from the address book list.

� You cannot select multiple entries from the address book list and delete them at once. You must select and delete address book entries one at a time.

� If you open an existing contact entry, use the Get Information from Directory button to update the entry, and then save the entry, a new contact entry is created with the updated information but the old contact entry remains in the address book. Delete the old contact entry.

� If you create a new contact entry and leave it open, you cannot create a second new contact entry. The same is true for group entries. You must save or close the first new entry before you can create the second new entry.

� You cannot use the keystroke combinations Ctrl+C, Ctrl+V, or Ctrl+X in any of the editable fields in a contact entry.

� If you enter text in the Notes field of a contact entry, the text does not automatically wrap to the next line. Use the Enter key to manually wrap text in this field.

� If you click Remove Members in a group entry when no members are selected in the member list, the first group member in the list is removed. Ensure that you make a selection before clicking Remove Members.

� You may be able to save a group with a name that contains invalid characters. � If you select multiple contacts and groups in the address book, right-click the selection, and choose an action

(such as Open) from the context menu that appears, the action is performed on only the first entry in the selection.

� When high contrast is enabled, the Get Information from Directory button in address book entries does not display correctly.

Calendar and calendar entry issues � Before saving a new calendar entry, make sure you enter text in the entry's Subject field. Otherwise, you will not

be able to save the entry. � If you click a calendar entry to preview it, but the entry does not display in the preview pane, try the following:

Open and go to your Inbox, then return to the calendar and click the entry again. � If you click a calendar entry to preview it, the Edit menu may contain two Delete commands. �� File > Open does not work for calendar entries in the side calendar. To open an entry, select it and press Enter

instead. � If you repeat a calendar entry daily for a year, the limit is 99 days. � When you print a calendar entry, the print job will appear as "about:blank" in your printer's queue. This will not

affect the print job. � If you select multiple entries in the calendar, right-click the selection, and choose an action (such as Open) from

the context menu that appears, the action is performed on only the first entry in the selection. � On Linux, if you click an entry in either the side or tabbed calendar to preview it, the focus should remain on the

entry but it switches to the preview pane. To return focus to the entry, click the entry again. � On Linux, if you open the pop-up date picker from either the side calendar or tabbed calendar and click the

current month or year, the date picker may close before you can select a new month or year. Use the left and right arrows in the pop-up date picker to navigate to the new month or year instead.

60


Calendar globalization issues Following are the international calendar issues in this release of IBM Workplace:

� If the preferred language is set to Chinese (Traditional) and you set the tabbed calendar view to One Day, the day of the week appears in short format (as opposed to the long format that appears for other locales).

� If the preferred regional format is set to English (United States) and the preferred calendar type is set to Islamic (Civil), the date picker displays incorrect month names.

� If the preferred calendar type is set to Japanese (Japan) and the preferred language is set to any locale other than Japanese (Japan) or English (United States), the end date and time fields on new appointment and meeting entries display incorrect values. Additionally, Japanese eras are incorrectly expressed as digits rather than text.

Chat window font limitations You can change font size in the Chat window by clicking the Font style button at the bottom of the Chat window. Note that not all font sizes are retained when selected; selecting font sizes above 26 has no effect. Also, the San Serif font is not supported. If you apply the Sans Serif font to text, a Serif font is applied instead.

Client shortcut replaced on second install to new location When installing the IBM Workplace client more than once on the same Windows workstation, the shortcut of the most recent installation will overwrite any previous shortcut on the user desktop. To prevent this from happening, rename the existing desktop shortcut before installing an additional instance of the client. The best practice is to give the shortcut a name that will indicate which instance of the client it starts.

Cursor not displaying after tabbing to the body of mail message When you use the tab button to move the cursor into the body section of a mail message in the client Messaging product, no cursor displays to indicate that you can begin typing text into the body field.

Differences in rich client Change Password functionality In the IBM Workplace rich client File --> Preferences menu sequence, there are two "Change Password" buttons. While they look similar, they actually do different things.

The File --> Preferences --> Login "Change Password" button enables you to change your IBM Workplace password. Your new password takes effect the next time that you log in. If you are working online, it is synchronized with your IBM Workplace server.

The File --> Preferences --> Security "Change Password" button pertains only to the password to "unlock" the credential store. This password is stored in a username/password credential (LWPCredential) in the credential store.

Disappearance of the Messages navigator section After approximately 800 calendar entries are created, the Messages navigation section disappears.

61


Document editors and document library issues � The IBM document editors may use different fonts for Windows and Linux. If a document uses a font on the

Windows platform that does not exist on the Linux platform, the document editors render the document on Linux with a different font than the original font. The font change does not affect the content.

� Using the word processing editor, you cannot create hidden paragraphs. If you use the word processing editor to import an OpenOffice.org or Microsoft Word document, you can toggle the display of existing hidden paragraphs by choosing View --> Hidden Paragraph. If you print a document that contains hidden paragraphs, the paragraphs are printed regardless of the current View --> Hidden Paragraph setting.

� When you save a document with a document editor, you cannot change the file type for the document. However, you can save the document content as a new document with a different file type.

� If you open an encoded .txt file to edit, canceling the ASCII filter options dialog box causes an error, displays an empty document, and disables double-clicking in the folder list. To fix this, close the empty document, and then close and reopen the folder list.

� If you edit an .xls document using an external editor and save the document, make sure you select Yes when prompted to save the document in OpenOffice.org format; otherwise, your changes may be lost.

� If you edit a document and click the x icon on the document's tab to close the document, the editor does not display a message asking whether you want to save your changes. To display the message, click the Close button above the document instead.

� If you choose any of these spreadsheet editor commands--Manipulate --> Consolidation, Create --> Function, Create --> Name --> Define, or Tools --> Solve Equations--close and restart IBM Workplace, and then start the spreadsheet editor again, it will lose focus and its toolbar will not work. To fix this, end the soffice.exe process on Windows or the soffice.bin process on Linux and then restart the spreadsheet editor.

� Help for the document editors in the Arabic version of the product is in English, not Arabic. It will be available in Arabic in an upcoming release.

� If system locale is set to Simplified Chinese on RedHat and SuSE Linux and you use a document editor to open a Workplace document or an imported Microsoft Office document that contains vertical text, the document editor will crash.

� In rare cases, document editors will not start due to existing printer drivers. If this occurs, try reinstalling printer drivers.

� If you paste some 32-bit characters into a word-processing document, position the cursor between two of the characters, and then paste more 32-bit characters, one character before and after the cursor will be changed to a character space.

� If you paste some 32-bit characters into a word-processing document, use Backspace to delete one of the 32-bit characters, and then press Ctrl+Z, the character will not be restored; instead, a character space will be added.

� If you open the Page Setup dialog box by selecting Layout --> Page in a presentation document, and then click Help in the dialog box, the Help window that opens does not close when you close Workplace. You must close the Help window manually.

� If you combine pictures in a presentation document (by right-clicking and selecting Combine) and move the combined picture by pressing an arrow keys 20 times or so, the document editor will crash.

� You cannot send an instant message when you are using the document libraries and have a non-modal dialog box (such as the Import dialog box) open.

� If you create a folder and one or more subfolders offline, make sure the total number of characters in the group of folder names is less than 127. Otherwise, a synchronization error will occur.

� On Linux, you cannot print a document from a document library's list view. � On Linux, document library list views do not display the correct document type for Microsoft Office documents. � On Linux, to use hyperlinks in the document editors, you must do the following:

1. Make sure a browser application is installed and determine the application's executable file path (for example, /usr/bin/mozilla). 2. Open the common.xcu configuration file. The path to this file is:

root/IBM/RCP/497853422/root /applications/com.ibm.pdm.sodc.feature/eclipse/plugins/com.ibm.superodc.base.share.win32_1.0.0/registr y/data/org/openoffice/Office/Common.xcu (where root is the user name and 497853422 is an installation property)

62


3. Find these lines:

<prop oor:name="http" oor:op="replace" oor:type="xs:string"> <value/> </prop> <prop oor:name="https" oor:op="replace" oor:type="xs:string"> <value/>

</prop> <prop oor:name="ftp" oor:op="replace" oor:type="xs:string"> <value/>

</prop>

4. Change all three instances of "<value/>" to "<value>/usr/bin/mozilla</value>" (where "/usr/bin/mozilla" is your browser application's executable file path). 5. Exit the client and any soffice processes.6. Restart the client.

Enabling accessibility features for the document editors To enable accessibility features for the Document editors on Windows platforms, you must use the following steps to download, install, and configure the Java Accessibility Bridge package. Note that accessibility works as is and is not fully supported in this release.

1. Use this URL to download the Sun Java Access Bridge For Windows Operating System V1.1 package: http://java.sun.com/products/accessbridge/

2. Unzip the downloaded file to a folder named acbridge.

3. Add the path string acbridge\AccessBridge_1.1_GA to the system path.

4. Copy these files from acbridge\AccessBridge_1.1_GA\installer\installerFiles to <wct install path>\eclipse\jre\lib\ext:

jaccess-1_4.jar access-bridge.jar

5. Copy these files from acbridge\AccessBridge_1.1_GA\installer\installerFiles to <wct install path>\eclipse\jre\bin:JavaAccessBridge.dll JAWTAccessBridge.dll WindowsAccessBridge.dll

6. Copy this file from acbridge\AccessBridge_1.1_GA\installer\installerFiles to <wct install path>\eclipse\jre\lib\:accessibility.properties

Error messages send users to error logs without location Several of the error messages displayed by the rich client direct users to see the error log, but do not provide information about which error log nor do they provide the error log directory location. As documented in the Logging and tracing topic in the IBM Workplace 2.0 Information Center, there are three error logs associated with the rich client. They are:

� SystemOut.log -- Captures all output generated by the Workplace log program as well as the output sent directly to System.out.

� SystemErr.log -- Captures only output directed to System.err and consists mostly of stack traces.

� .log -- Captures errors thrown by Eclipse.

These system log files are stored in the logs subdirectory of the user's workspace. For example, on Windows in C:\Documents and Settings\<username>\IBM\RCP\<platform id>\<username>\logs. The Eclipse log file is stored in the .metadata subdirectory of the user's workspace. For example, on Windows in C:\Documents and Settings\<username>\IBM\RCP\<platform id>\<username>\.metadata.

63


Files remain in user home directory after client uninstallation After uninstalling the IBM Workplace rich client, user data and automatically downloaded application components will not be uninstalled from the workspace directory found in the user's home directory (Windows: C:\Documents and Settings\<username>\IBM\..., Linux: /home/username/IBM...). Users may safely delete the workspace directory after uninstalling, unless they wish to retain the data for later use.

Users who wish to retain data but not retain automatically provisioned applications may reclaim some hard drive space by deleting the "applications" subdirectory in the workspace.

Globalization issues � Regardless of what you set your date format to be in your OS, IBM Workplace will display the date in the Date

column in short format. � For Windows, in order to display GB18030 characters in IBM Workplace, for example in the subject and body of a

message, in the search field, the name of the document, you must change the font association in your registry or change the default font of your appearance first, so IBM Workplace will use the proper font. Without changing your configuration, IBM Workplace will try to render the GB18030 characters with the OS default font, which doesn't support the characters.

Help menu in chat window does not work The Help menu in the chat window does not work in this release. To get Help for chat, click Help --> Help Topics from the main Help menu in IBM Workplace rich client.

IBM Workplace appears unresponsive and CPU usage spikes When you open an e-mail with a large number of recipients, the CPU usage can spike and IBM Workplace will appear unresponsive. The problem will disappear by itself, in a time frame in proportion to the number of e-mail recipients. The delay is approximately 10 seconds for 100 e-mail recipients.

IBM Workplace becomes unresponsive after the server goes down When the IBM Workplace server goes down, the rich client will become unresponsive after some time. You should exit IBM Workplace rich client and log in again after the server has been restarted successfully.

IBM Workplace becomes unusable disconnected When running IBM Workplace rich client, if you disconnect from the network or put your PC into stand-by mode, IBM Workplace becomes unusable when you reconnect. There is no warning that a network is not present; you must restart IBM Workplace.

IBM Workplace Client v. 2.0.1 Turkish needs fix from IBM The WCT RichClient is not supported without a fix from IBM on machines using the Turkish locale.

IBM Workplace may pop up over another application If you have IBM Workplace rich client open in the background, and you are using another application, IBM Workplace may pop up over the other application that you are using.

64


If Network outage may need to remove workspace to provision If you encounter a network outage during provisioning, the client may not display properly, or may not complete provisioning. If the client displays with a grey perspective, exit the client and then relaunch the client. Wait 6 to 7 minutes; if you are not prompted to accept updates to the client you may need to manually reinitiate provisioning. To do this, exit the client again. Then delete your %WORKSPACE%\.metadata\.plugins\com.ibm.rcp.pagebuilder directory. Re-launch the client and authenticate with the IBM Workplace server when prompted. Proceed through the dialogs and continue with provisioning the client. The client should display properly after reinitiating provisioning.

IM display problems in "High Contrast" mode If you are using IBM Workplace while in High Contrast --> White on black mode (Control Panel --> Accessibility Options), the group names and online person names in Instant Contacts are not displayed unless you click the target position. The hover text of an online person does not display.

Instant messaging - Reconnecting if network goes down If you are working with instant messaging and you are disconnected from the network, for example, if a network cable becomes disconnected or a server fails, a "Reconnect to Instant Messaging" button displays at the bottom of the window. (It could take several minutes for this button to display.) In addition, the Instant Contacts list displays with all users as offline, with no online status. To reconnect to instant messaging, click the "Reconnect to Instant Messaging" button.

License agreement is truncated for some non-English languages With some operating system configurations in some languages, the client installer and server-side client installer may truncate the license agreement display by a few pixels under the scrollbar on the right side. In cases where this makes the license difficult to read, the panel can be resized to change the line lengths, causing truncated words to move to a different place in the panel and making it possible to read them.

Linux - Can't download client from provisioning server After installing IBM Workplace rich client provisioning components on a server, the install and update components may not work correctly, and / or Instant Messaging may not function correctly, because the plugin-cfg.xml file has not been correctly regenerated (see httpRefreshErr.txt in the provisioning components install directory for confirmation). To fix this, an administrator should cd to the WorkplaceServer bin directory (by default /opt/WebSphere/WorkplaceServer/bin) and run lwpGenPluginCfg.sh.

Linux - People Finder/Links may not work in Rich client On the Linux platform, if the browser window closes immediately after launching it, from a link, or from the People Finder, in the IBM Workplace client, do the following:

1. Exit the IBM Workplace client.2. Delete the contents of the folder:<your Lotus Workplace Client software install directory>/Mozilla/plugins3. Launch the IBM Workplace client. Using links or the People Finder should now work.

65


Linux issuesNavigating with keyboard� For Linux users, if you press ENTER to select an item when navigating through the Navigator with the keyboard,

multiple items may get selected at the same time. � On Linux, you cannot navigate the Preferences dialog box by typing the first letter of section names. Use the

arrrow keys instead.

Mail Messages � When you edit a message on Linux, you will see two cursors. Only one of the cursors works.

Calendar � On Linux, if you open the pop-up date picker from either the side calendar or tabbed calendar and click the

current month or year, the date picker may close before you can select a new month or year. Use the left and right arrows in the pop-up date picker to navigate to the new month or year instead.

� On Linux, if you select a date with the tabbed calendar's date picker, there may be a delay before the tabbed calendar refreshes to show the new date. This occurs if server performance is low.

� On Linux, if you click an entry in either the side or tabbed calendar to preview it, the focus should remain on the entry but it switches to the preview pane. To return focus to the entry, click the entry again.

IBM Workplace Documents � The IBM document editors may use different fonts for Windows and Linux. If a document uses a font on the

Windows platform that does not exist on the Linux platform, the document editors render the document on Linux with a different font than the original font. The font change does not affect the content.

� On the Linux platform, you cannot print a document from a document library's list view. � On Linux, to use hyperlinks in the document editors, you must do the following:

1. Make sure a browser application is installed and determine the application's executable file path (for example, /usr/bin/mozilla). 2. Open the common.xcu configuration file. The path to this file is:

root/IBM/RCP/497853422/root /applications/com.ibm.pdm.sodc.feature/eclipse/plugins/com.ibm.superodc.base.share.win32_1.0.0/re gistry/data/org/openoffice/Office/Common.xcu (where root is the user name and 497853422 is an installation property)

3. Find these lines:

<prop oor:name="http" oor:op="replace" oor:type="xs:string"> <value/> </prop> <prop oor:name="https" oor:op="replace" oor:type="xs:string"> <value/>

</prop> <prop oor:name="ftp" oor:op="replace" oor:type="xs:string"> <value/>

</prop>

4. Change all three instances of "<value/>" to "<value>/usr/bin/mozilla</value>" (where "/usr/bin/mozilla" is your browser application's executable file path). 5. Exit the client and any soffice processes.6. Restart the client.

Instant Contacts � The following limitations exist on the Linux platform when you right-click a name in Instant Contacts:

� Double menu options display when you hold down the right-mouse menu. Simply select the option you want. � The New Contacts dialog box displays unexpectedly. Click Cancel to close the New Contacts dialog box.

Search � If you search for a word in a document using the Find feature (CTRL+F or Find), and the word is not found in the

document, you will not be prompted with a message when the search has completed. If the word cannot be found, the Find dialog stays open.

66


Logoff/logon required after restarting stopped SSO service Once you enable Single Sign-on (SSO) for rich client products, an SSO service runs on the operating system, independent of the rich client. If you are running the rich client on a Windows operating system, the service is registered as the rcpsl service in the Services window of the Administrative Tools application. If you are running the rich client on a Linux operating system, the service runs as the rcpsso daemon. If you stop the service and restart it, a logoff and logon to the operating system is required before SSO with the operating system works for the rich client.

For example, if you stop the service from the Services pane of the Administrative Tools application, then you start the rich client, a log on is required as expected. If you then restart the service from this pane and start the rich client, you are again asked for a password. You have to log off, then log back into the Windows operating system for SSO to be initialized. The same is true if you are running the rich client on Linux. If you stop the SSO daemon using the ./rcpsso stop command and restart it using ./rcpsso start, a logoff and logon to the operating system is required before the restarted SSO service will work correctly.

Mail issues Following are the Mail issues in the current release:

� Messages that you have in the Trash folder will appear in the All Messages folder in this release. � New links that you create in the Links section will appear in the All Messages folder in this release. � If you receive attachments in a mail message, the attachments will save with their original file names even if you

change the file names in the Save As dialog box. To change the file names of attachments when you save them, save each attachment individually.

� You may be prompted with the error message, "The message could not be sent successfully" for any, but not only, these reasons: � If you try to send a message that is over your message size limit, you will be prompted with this error

message. The message you tried to send will be lost. Check what your mail limits are with your administrator.

� If you enter an address incorrectly in a message, you will be prompted with this error message. Double check that you entered the address correctly.

� If the mail address cannot be resolved successfully you will get a general error message in some cases. More detailed information is currently missing.

� When you change the Font and Size of selected text and then place your cursor on unchanged text, the Font and Size selections in the toolbar for the unchanged text will reflect the changed text's Font and Size.

� When in a message, if you click Folder --> Move To Folder and choose Junk Mail, the message will not move to the Junk Mail folder.

� You cannot drag and drop a message to the Junk Mail folder. To delete messages as junk mail, select the messages, click the arrow beside Delete, and then click Delete as Junk Mail.

� If you do not see the Hide button in Properties, or the Properties display appears corrupted, resize the Properties window to see all of the controls.

� If there are no messages selected in the Trash folder, the Empty Trash button is greyed out. To enable the Empty Trash button, manually select the messages that you want to delete in your Trash folder.

� If you open a message that does not contain a subject, the tab that opens to display the message appears blank. There is only an X visible on the tab to close the tab.

� If you change your default Mail Preferences (File --> Preferences --> Mail) to include or not to include message history and attachments, you must restart IBM Workplace for the changes to take effect when replying to a selected message in the Inbox. When replying to a message that is open, the Reply button changes according to your preference.

� There is a bug that is allowing you to move messages from the Outbox folder to other folders. You should only be able move messages from the Outbox to the Trash folder, if you want to delete a message.

� If you open a personal folder that you created, and then choose to delete the folder, the folder disappears in the Messages section, but you will still be in the deleted folder. You will also still see the documents that were in the folder. If you try to open one of the documents after you confirmed deletion, you will get an error. Click a different folder to completely remove the folder and documents.

� The action View --> Sort By --> Attachment does not work correctly and causes sorting to stop working. Do not use this feature. If you do click View --> Sort By --> Attachment, you should restart IBM Workplace to correct the sorting problem.

� You may get an encryption error if you try to send an encrypted message to multiple users. This can occur if you have spaces in between each person's address in the name list of the message. If the spaces are removed from the name list, sending encrypted mail works correctly.

67


� E-mail sent in MIME format from Lotus Notes is correctly interpreted when received and opened in IBM Workplace -- Notes links, images, and attachments are active and available. E-mail sent in Notes Rich Text format from Lotus Notes is converted to entirely plain text when received and opened in IBM Workplace -- Notes links are replaced by placeholder strings. Images and attachments are also replaced by placeholder strings, but can be accessed at the bottom of the e-mail.

� If you create a new message, select that encryption is required in Properties, and then save that message as a draft, the encryption setting will be lost when you open the draft message. You need to re-select that encryption is required in Properties.

� If you create a new message, select to include a digital signature in Properties, and then save that message as a draft, the digital signature setting will be lost when you open the draft message. You need to re-select the digital signature option in Properties.

� To send an encrypted e-mail to a group, do not append the @domain name to the group name. Encryption will not work.

� We do not support archive and restore for this release. � Currently we have an interoperability issue with Lotus Notes. Messages with attachments sent from IBM

Workplace cannot be opened in Notes. The attachments are part of the message, but clicking on the inline link will not open them.

� The content of incoming MIME messages of the type "message/external" cannot be opened by IBM Workplace. The body of that message will be empty and you will not be informed about the specific failure reason. The same applies to messages of the type "image/jpg" and "image/gif".

� If you click File --> Open in New Tab --> Outbox, the Outbox will not open in a new tab. To open the Outbox in a new tab, right-click Outbox, and then click Open in New Tab.

� When working in edit mode in the body of a new message or calendar entry, if you do not see the entire rich-client toolbar, resize the panes of the calendar and the navigator to expose the rest of the toolbar icons.

� Renaming a sub-folder that is nested within a parent folder is not working correctly. The parent folder will get renamed instead of the sub-folder.

� When using Typeahead to fill in a recipient's address in a new message, the following issues will happen: � If you enter a few characters that will be recognized by typeahead, typeahead fills in the first matching name.

If you press BACKSPACE to delete the entire suggested name, and you then use the first character that you previously entered, typeahead fills in the first matching name again.

� If you press BACKSPACE to delete the entire suggested name, press TAB to move to the next field (cc), and then use the first character that you previously entered, typeahead fills in the first matching name again in the To field. Workaround: Select the entire suggested name and press BACKSPACE once.

Meeting issues � If you create a meeting invitation and invite a group that you're a member of, you may receive the invitation as if

you're an invitee (rather than the meeting chair). To avoid creating duplicate entries on your calendar, delete the meeting invitation and any notices about the meeting that you receive.

� If you send notices about a meeting in rapid succession, they may appear out of order in the Inbox of invitees. For example, if you send a meeting invitation and then immediately cancel the meeting, meeting invitees may receive the cancellation notice before the original meeting invitation.

� You cannot view meeting invitee status for members of a public group using View Invitee Status in the meeting entry. Individual members of the group can respond to the invitation, but you must check individual invitation responses you receive in your Inbox for status.

� If an invitee accepts and then declines a meeting invitation and you use View Invitee Status to check status, the invitee's status is not updated from accepted to declined.

� If a meeting entry contains duplicate invitee names (for example, the same person listed in both the Required and Optional fields), the duplicate names do not appear in the meeting entry at all when you preview the entry.

No delete dialog when deleting roles with special characters A delete confirmation dialog should always be displayed to a user when deleting a role. The delete confirmation dialog is not displaying when deleting roles which contain special characters in the name and description. The role is simply deleted with no confirmation dialog displaying.

68


Occasional display of blank Preference panes Certain panes in the Preferences page can display blank. For example, if you select Preferences --> Security, expand the Certificates tab, select Certification Authorities, and then select My Certificates, the My Certificates pane can sometimes display without content. To correct this, resize the window and the content displays.

Offline issues � When in Offline mode and disconnected from the network, if you change to Online mode, IBM Workplace will

transition to Online mode, even when there is no network present. There is no warning stating that you are not connected to the network to work in Online mode.

� A problem with the local data store is usually only repaired by removing the rich client's workspace directory and running Setup again. This will re-initialize the data store, and synchronize it with the server data store.

� When in Offline mode, if you create a message addressed to a group that you have listed in your personal address book, when you go back online you will see the error "Message will not send" when IBM Workplace tries to send the message from the Outbox. You need to expand the group manually to successfully send the message.

� When in Offline mode, messages addressed to groups must include the domain name of the group (for example, [email protected]), otherwise you will get an error that the message could not be sent when you go back online. The message will remain in the Outbox.

Page not found / no response from rich client download link When users click the "Download IBM Workplace rich client" link in the Downloads tab, and get no response or see a "Page Not Found" error, it is likely the rich client provisioning components have not been installed on the server. To fix this, an administrator should follow the Workplace InfoCenter instructions for running the installer found on the "IBM Workplace Managed Client (Server Install)" CDs, to install the rich client provisioning components on the Workplace server.

Provisioning can fail without error due to disk space Provisioning the rich client uses approximately 400 MB for English clients and 500 MB with language packs, not including application data. If you attempt to provision the rich client on a workstation that does not have sufficient disk space, the installation will either stop midway or complete, but launch a grey window only; no error message indicating that provisioning did not complete successfully due to limited disk space is displayed.

Reply using chat not available in saved chat transcriptWhen you open a saved chat transcript, Reply --> Reply Using Chat is not available from the Actions menu. Instead, click the Reply button at the top of the open chat transcript.

Rich client install problems when path contains Unicode Under some circumstances, the IBM Workplace client installer will not work correctly when installing to a path that uses Unicode characters (including Cyrillic and Asian character sets). This is a symptom of an InstallShield Multi-Platform limitation that has been escalated to InstallShield for a fix.

As a workaround, use an ASCII-only install path until the problem is resolved.

Rich client will crash when using the Web browser on a SSL site Currently the Rich Client will crash when using the Web Browser and a web page that is SSL enabled (Secure Sockets Layer). An example of an SSL enabled web page would be the Administrative Console with Lotus Workplace.

69


RTL layout not rendered despite locale setting The rich client products do not correctly display the text of languages requiring a right-to-left (RTL) layout based on the locale setting of the client machine. To specify a RTL layout, go to the Window -> Preferences -> Regional Settings pane and change the Preferred Language setting to "Arabic" or "Hebrew." You must restart the client to see the change.

Alternatively, you can append the -dir rtl parameter (ensuring that the rtl flag is lower case) to the command that starts up the rich client. On Windows, edit the Target field of the desktop shortcut, by appending a space, then -dir rtl to the richclient.exe command. On Linux, append the -dir rtl parameter to the command that starts the richclient in the richclient.sh file stored in the rcp directory.

Selected group in Instant Contacts not displayedWhen you right-click a group in Instant Contacts and click New contact, the default group "Work" is always selected, even if you select another group to which to add a contact. For example, if you right-click a group named "Personal" and choose New Contact, the group "Work" is selected in the Add to Group drop-down list. To add the contact to a group other than "Work," you must select the group from the drop-down list.

Sorting in Preferences different in non-English version Some alphabetic sorting in Preferences is not working correctly in non-English versions of IBM Workplace.

Spell checker issues When you select a single word to spell check, the spell checker will check the selected word and then continue to check the entire document.

The spell checker in this release does not allow you to change to a different dictionary. Therefore, Step 4 in the topic "Spell checking" is not correct. You cannot check spelling using a different dictionary.

When using the Spell Checker, Ignore All does not ignore all instances of a misspelled word. The misspelled word will still get flagged as incorrect as you continue checking the document.

Synchronization issues � If you enter a partial host name when setting up IBM Workplace rich client, synchronization will fail. You must

enter the fully qualified DNS name of the server. For example, enter acme2.abc.com, not acme2. If you entered a partial host name, exit IBM Workplace, clear the rich client workspace, and then re-run the setup. If you do not clear the workspace, the partial host name (the non-fully qualified DNS name) will be used again.

� If the computer running IBM Workplace loses power or is shut off during synchronization, the local data store may be damaged. Symptoms of this will include: An empty user interface when IBM Workplace is next launched; synchronization and instant messaging errors; exception messages in the SystemOut.log and SystemErr.log files in the rich client's <workspace>\logs directory. Since the data store is damaged, it should be repaired by removing the rich client's workspace directory and running Setup again. This will re-initialize the data store and synchronize it with the server data store. Note that if there was any new data created in the local data store, it will be lost by doing this.

� During first-time rich client initialization, the Stop Synchronization button and synchronization activity indicator controls may not appear in the status bar of the rich client. This is because synchronization began before the client user interface was drawn, and the controls were not drawn with it. After first-time synchronization completes, subsequent synchronizations should show both controls. Also, if the computer running IBM Workplace has a relatively slow CPU (less than 1 GHz), synchronization may complete so quickly in the background that the client does not have time to draw the controls and update the status bar. This does not affect synchronization itself.

70


Temporary files can be deleted after installing rich client After downloading and installing the IBM Workplace rich client from the IBM Workplace server, it is safe to remove the temporary files that are placed in the user's home directory under wctpinstall-temp.*. These files are only used during client installation. If users have installed the rich client many times, this can free up appreciable amounts of space on the workstation.

Unable to edit Draft messages moved from Outbox In the case that a message cannot be sent when the client switches from Offline to Online mode (due to an addressing error or other problem with the message), that message will remain in the Outbox.

Expected behavior is that the user may move the unsendable message from the Outbox folder to the Drafts folder. There they should be able to select the Edit actionbar button and change the message.

In addition, the user may double-click or hit Enter for a message in the Drafts folder in order to open it in Edit mode. This will allow the user to change the message, and then click the Send actionbar button to resubmit the message for sending.

Update silently installs unsigned features without warning With the Update Silently option enabled, unsigned features will be installed/updated without a warning.

User defined links on Linux when connected via proxy server If the client is connected to the internet via a proxy server user defined navigation links may not work on the Linux platform. When clicking on user defined links, the browser window stays open with a malformed URL. This is due to the proxy settings in your default profile not being utilized by Mozilla which is instead using the default setting (direct connection to the internet).

To resolve do the following:

1. On the Linux workstation using a text editor create a new file containing the following:

#!/bin/sh"$1"/run-mozilla.sh "$1"/mozilla-bin -remote "openURL("$3",new-window)" || "$1"/run-mozilla.sh "$1"/mozilla-bin "$3"

(note: if you create the file on Windows and copy it to Linux it will save the file with additional characters, so you will need to run dos2unix and chmod 777)

2. Save this file with the filename "launch-mozilla.sh"

3. Replace the existing file launch-mozilla.sh in the <wctinstalled directory>\mozilla directory with the newly created one.

4. Copy the file <your installed version of mozilla directory>\mozilla\components\libxremoteservice.so to the <wctinstalled directory>\mozilla\components directory.

User not warned during install of an unsigned nested feature If one feature requires another feature, the other feature is considered to be nested. When the parent feature is installed, the nested feature will be installed automatically. If the nested feature is unsigned, there will be no warning presented to the user.

71


IBM Workplace Messaging issues

Bad mail address produces 'Person exists outside search bases' In some circumstances logging in as a person with a bad mail address may produce a message like: 'User cn=person,o=yourOrganization cannot have an account. Their person record exists outside LDAP search bases configured for WMM'.

If this message is received, in addition to validating the LDAP search bases for WMM, also check that the email address is valid and doesn't contain any unusual characters like backslash '\'.

Calendar issues � Incorrect server time causes calendar entry rendering problems. Make sure the time of the server's clock is set

correctly to avoid potential problems. � Using Internet Explorer 5.5, the personal and team calendars may appear broken when you open them. Use a

later version of the browser or download the latest version of the MSXML parser. � Using Mozilla 1.4, if you minimize the calendar and then maximize it, an error message appears. To redisplay the

calendar, click the Today is link or use the View field to change the view. � Using Mozilla 1.4, if you press the Up and Down arrow keys to change the selection in the Entry type field on a

calendar entry, you must press Enter after you highlight the entry type you want to complete the selection.

Cannot import a calendar from a pre-2.0 zip file You cannot import a calendar into IBM Workplace 2.0 from a zipfile that was exported in IBM Workplace 1.0, 1.1, or 1.1.1.

Cannot run trace logging on POP3 and IMAP mail services POP3 and IMAP components are not available for trace logging through the WebSphere Administrative Console when running IBM Workplace Messaging on a stand-alone server. Trace logging is available for POP3 and IMAP if you are running IBM Workplace in a Network Deployment (ND) environment.

End Date/Time fields not always reset properly The End Date and End Time fields in a calendar meeting form are not always reset properly when the start date and start time fields are changed.

Reset the End fields manually when resetting a Start Date or Start Time.

Extraneous "?" displayed at the end of some messages Some messages will display with an extraneous "?" at the end. Below are example scenarios where this can happen. There may be more.

Under Mozilla: � Compose a message using RTE. Add several lines of text. � Switch from RTE to plain text. � An extraneous "?" will de displayed at the end of the message.

Under IE: � Messages that come into the system directly from SMTP will display the extraneous "?".

There is currently no workaround for this problem.

72


Folder created on back end won't show up immediately in UI A mail folder created by a backend process won't show up immediately in the LWM user interface. The folder cache is time-to-live, which means that cache entries are refreshed within a certain period of time; currently, the refresh interval is set to one hour. It will take at most one hour for a folder created on the back end to appear in the front end user interface.

Hit 'F5' to refresh whenever you delete a Calendar Event When you create a new calendar event, and then use the Context menu to delete it, you must then press the 'F5' key to force the Calendar to refresh itself, otherwise it will still be visible and may cause problems.

Import of some calendar entries causes parser exception A calendar entry that contains multiple lines of text may cause a parser exception when the calendar entry is imported with the user's mail store.

Incorrect message when removing a contact from the address book If you edit a contact in your instant contacts list, click Remove to remove the contact from your address book, and save the contact, a message that says the contact has been added to your address book appears. In this case, you can ignore the message; it is incorrect and the contact is removed from the address book.

Lag between updating an account and testing it with ListAccounts There may seem to be a lag when you update an account, and then attempt to test it using the Lmadmin ListAccount command. You may get an error such as "Error searching for policy with key <0>".

Try the command again and it will work.

ListAccounts command does not show friendly name The Lmadmin ListAccounts command does not return a friendly login name that can be used with the Lmadmin Export command. The workaround is to use a command similar to the following:

wsadmin> lm listaccounts /dn <outf -fn 'c:/temp/users.txt'>

This command produces a file, for example:

fb497b00-d4cd-11d7-83e5-84323f46600euid=wpsadmin,cn=Users,l=Westford,st=Massachusetts,c=US,ou=Lotus,o=Software group,dc=ibm,dc=comf212af80-d30f-11d7-84f7-82eb3f4373bbuid=SusanAdams1,cn=users,l=Westford,st=Massachusetts,c=US,ou=Lotus,o=Software group,dc=ibm,dc=com

Edit the file to list the login names for use with the Export command:

wpsadmin SusanAdams1

See the IBM Workplace Information Center topic "Exporting multiple user mail files manually" for more information.

73


Lmadmin commands The following are known problems with Lmadmin commands:

Wmmidsynch If you use the wmmidsynch command with the \dryrun option you will see a message that indicates the tool successfully synchronized the external ids. Please note that the actual update did NOT occur. The message is merely indicating that it could have successfully synchronized. The actual data remains untouched. You must use the \modify option to make changes to the external id data.

CreateAccount and UpdateAccount The -policy option is available for assigning a user policy name only when using the directory policy attribute method of assigning users to policies.

You can not use the -policy option to assign a user to a policy when using the distinguished name (DN) scope matching method of assigning users to policies. The DN-scope matching method assigns users to policies based on DN scope, not name. You will not receive an error if you use the -policy option incorrectly.

More than one mail forwarding address or one mail alias is not supported.

ListAccounts The documentation in the information center does not include the -user parameter for use with ListAccounts. The -user parameter lets you enter a user's distinguished name or login name to see account information. For example:

lm listaccounts -user 'uid=SusanAdams,cn=users,l=Sutton,st=Ohio,c=US,ou=Widget,o=Sales group,dc=acme,dc=com'

Listldapusers The Lmadmin command Listldapusers is not working correctly when you search for users in a Domino LDAP server. When names.nsf on the LDAP server is subject to full-text indexing, and in some instances, the Lmadmin command Listldapusers returns a blank line. The workaround is to delete the full-text index.

CreatePolicy Specifying the default export schedule results in an error when using the CreatePolicy command. For example:

lm CreatePolicy -policy test1 -expsched 'Export Default'

This problem occurs with the default (system generated) default export task. This error does not occur for other export schedules that you create. The workaround is to use the Administrative Console to create and edit user policies to assign the default export schedule to a user policy.

When specifying any of the following options for a user policy:

� Always allow use of external tools � Never allow use of external tools � Allow use of external tools only if an IBM editor is not available

When creating a policy you should specify a value for each in such a way that the option you need to use is enabled while the other three are disabled. For example, to set the option "Always allow use of external tools" use the following syntax:

lm -createpolicy MyNewPolicy -exttoolal on -exttoolnv off -exttoolps off

Only one of the following three parameters should be enabled when specifying the use of external tools. Enable only one of these parameters:

-exttoolal Always enables use of external tools.

-exttoolnv Never allows use of external tools.

-exttoolps Enables (on) or disables (off) use of external tools if IBM document editors.

74


UpdatePolicy Only one of the following three parameters should be enabled when specifying the use of external tools. Enable only one of these parameters:

-exttoolal Always enables use of external tools.

-exttoolnv Never allows use of external tools.

-exttoolps Enables (on) or disables (off) use of external tools if IBM document editors.

QueryCell /deadmaildomain Listing deadmail messages sorted by destination domain does not work.

DeleteMessage /help The current help says that you can force the deletion of messages that are not in DEAD state by using the parameter "/force". This is incorrect. Use "-force" instead.

setConnectionTypeMaxRecipients This command does not work for the anonymous, authenticated, suspect, or trusted connection types. No matter what you set the value to, the value is always 100.

setConnectionTypeSMTPNoise This command does not work for the anonymous, authenticated, suspect, or trusted connection types.No matter what you set the value to, the value is always 128.

Help not working for some commands Some commands do not provide any on-line help. The following commands produce an error:

cls /help imap /help mail /help status /help tsksch /help

Lmadmin tool limitations when using Cloudscape as a datastore Cloudscape Network Server and its driver require non-XA transactions. IBM Workplace Messaging 2.0 uses remote calls to the WebSphere Member Manager EJB deployed on WebSphere Portal Server. This causes the WebSphere Application Server transaction manager to assume that the resource is an XA resource using XA transactions even if it is not. This results in errors in the System.out log and failed transactions as shown in the following sample log:

J2CA0023E: A two phase XA operation, prepare, was invoked. This resource adapter from datasource jdbc/lwmApp does not support two phase processing.[6/3/04 10:46:14:391 EDT] 5f0b956e OnePhaseResou u Encountered an XA resource error during an XA prepare operation: error code: XAER_PROTO

javax.transaction.xa.XAException

The following Lmadmin commands will not complete successfully when using Cloudscape Network Server as a datasource:

CreateAccount DeleteAccount

In some cases, the Lmadmin may return a message indicating that the account creation or deletion completed successfully. Verification that it in fact failed may be obtained using the ListAccounts command which continues to work properly under Cloudscape.

75


The commands listed below work correctly but there will be errors similar to the one shown above in the System.out log:

ListAccountsUpdateAccount

There is another way to create an account without using Lmadmin. See the IBM Workplace information center and the topic, "Creating mail accounts automatically."

Unfortunately there is no way to remove an account under Cloudscape successfully using IBM Workplace exclusively. We suggest working with the database using the Cloudscape administration tool: cview. Delete an account by performing the following steps:

1. Using the Lmadmin tool, type the following command:

ListAccounts -user user /dn.

2. Fill in the login name of the account you wish to remove for the User placeholder in the command. This will obtain the dn so the account can be located in the Cloudscape database.

3. Start the cview tool. 4. Locate the table called NGN_ACCOUNTS in the LWPSGL database. 5. Query the table to find the row that represents the account with the dn you retrieved in step 1. 6. Update the row to change the value of the ISTATE field to 3. This marks the row as soft deleted so that the

Compact and Reconcile task will find it, remove all data in all tables associated with that account, and reclaim the space.

Log messages may be in mixed languages In some locales, IBM system messages should appear in one language while the application actually displays the native language. With IBM Workplace log messages, you will see a mix of WebSphere Application Server messages in English and IBM Workplace Messaging localized in your local language.

Mail issues � The Welcome message may not be the first to appear in a user's Inbox. If there are messages waiting to be

delivered before a user's account is provisioned, the messages will appear before the Welcome message in the user's Inbox.

� If you specify a name with non-ASCII characters that's not in your organization's directory in the To field of a message and save the message as a draft, the To column of the Drafts folder displays question marks in place of the name. In this case, the name is displayed incorrectly, but the name is not lost.

� You cannot rename a mail folder with a name that contains DBCS characters if either a parent folder or a child folder has the same name.

� For mail accounts migrated from IBM Workplace Messaging 1.0, migrated messages do not display the sender's name in mailbox folders (such as the Inbox) but do display the sender's name when the individual messages are opened.

� For those who use both the rich client and the portal client for IBM Workplace Messaging, if you use the rich client offline and create mail folders, use the rich client online and replicate the folders, and then open your mail using the portal client, the new folders do not appear immediately. The new folders will appear eventually depending on how the portal server is configured.

� If you're viewing a message and move the message to a folder, and then move the message to a different folder, the confirmation message that appears displays the first folder name. The message is moved to the second folder, so you can ignore the incorrect confirmation message.

76


Managing the user preference cache for the mail portlet To improve portlet performance, you can manage the cache that contains user preference information normally stored in the WebSphere Member Manager (WMM) lookaside database. The cache contains information about the user signature settings, whether to use plain or rich text for mail content, and spam filter settings.

Caching user preferences improves overall mail portlet performance. There is one cache for preferences for all users. The default cache size is 100,000 bytes and the cached data persists by default for one hour before data is refreshed from WMM. These values can be changed by editing the mail portlet's configuration.

To change the cache size and how long the cached data exists before it is refreshed, perform the following steps:

1. Log in to IBM Workplace as an administrative user. 2. Click Administration --> Portlets --> Manage portlets. 3. Find the Workplace mail portlet (wps.Mail) in the portlet list. 4. Click Modify Parameters. 5. At the bottom of the Parameter and Value columns, type PrefCacheSize in the Parameter column to increase the

size of the cache. 6. In the Value column, enter a value in bytes larger than 100,000 7. Click Add. 8. At the bottom of the Parameter and Value columns, type PrefCacheTimeToLive in the Parameter column to set

how long the cached data should exist before the cache is refreshed. 9. In the Value column, enter a value in seconds. The default is 3600 seconds (one hour). Increasing the number of

seconds keeps the cache values alive longer which should keep performance higher for longer. The disadvantage to caching values is that the cached values in the Web client could be out of synchronization with values in the rich client.

10. Click Add. New values take effect the next time a user changes and saves their preferences, removing all previously cached values.

Note: Size and time and changed independently.

Maximum SMTP connections is off by -1 With the Maximum Inbound SMTP connections set to 10, the server should accept 10 connections, and refuse any subsequent connections until one of the existing connections terminates. Currently, the server accepts only 9 connections ( 0 through 8). Note that when connections 0 and 1 terminate, connections 9 and 10 are accepted.

Meeting issues � If you edit all instances of a repeating meeting, change the start date of the series, and then edit all instances of

the meeting again, the old start date of the series is displayed instead of the new start date you specified. � If a meeting invitee sends a response to a meeting invitation after you remove the invitee from the meeting, and

you click Change Invitees in the meeting entry, the invitee's name and status are displayed in the FYI section.

Message attachment issues � You cannot open an attachment with a space in its file name. � You cannot view an attachment with a . (period) in its file name (for example, "my.results.doc"). Note that this

does not refer to the period separating the file name from the file extension. � Using Internet Explorer, you cannot view an attachment with a DBCS file name. � You cannot view a Chinese or Korean .ppt attachment unless the appropriate Chinese or Korean fonts (for

example, Gulim 12pt and 16pt) are installed on the Messaging server.

77


Messages not relayed to list members if members not in LDAP You cannot use a local mail list group and include addresses that are external to the local domain. Doing so will produce Failure Delivery Status Notifications. Although the messages aren't being relayed as they should be, the sender will receive a notification that the recipient has not received the message.

You can specify a mail list group that is external to the local LDAP directory and specify external addresses. As a workaround, you can send mail to external users individually.

Migrating calendar events become appointments There is no provision for representing event types (meetings, appointments, and so on ) in the iCal stream extracted from a Domino or Exchange system. For this reason, all calendar events migrated to IBM Workplace Messaging will initially appear as appointments.

No localization support for Lmadmin commands Lamdmin scripting commands are in English only.

NotesMail - Config info not defaulted into Mail Preferences The Mail Server values set in Config Mode are not carried over to the User's mail preferences. Portlet Users must type in their own mail server information in their portlet Mail Preferences.

Restricting users from sending mail to groups does not work You cannot restrict users from sending mail to groups.

In the WebSphere Administrative Console, clicking Lotus Workplace --> Directories --> Directory settings for Messaging, then under the option Search and delivery restrictions, you can normally choose "Users and groups" or "Users only". Selecting "Users only" neither restricts users from picking groups using the name picker, nor does it prevent users from sending mail to groups.

Rich client does not handle signed and encrypted messages There are two ways to sign a mail message:

� Append the digital signature as an attachment � Encode the content of the mail.

By default, user policies uses the first method and the end user is not able to change this setting. However, when a mail message is encrypted and signed, the entire contents of the message must be encoded. When this happens, mail content is unreadable by the recipient.

Searching indexing lag time and troubleshooting Search index : Mail documents are indexed over the course of each hour at intervals governed by a set of internal rules. User's may observe some latency between the time a mail document reaches their inbox and the time it is actually searchable. This is normal. Should a user find that documents have not been indexed at all after a significant period of time, then they may use the "Troubleshooting search index" feature to rebuild their index all at once. Note however that doing so with large amounts of data will result in the client appearing to be non-responsive while the documents are processed. This too is normal.

The "Troubleshooting search index" feature is only available from the Tools menu when a search has been executed.

78


Seems like e-mail is deleted randomly Users may notice that some recently synchronized e-mail is being automatically removed from their inbox. There are two options in the mail synchronization preferences (Tools -> Preferences -> Synchronization -> Mail) which, if set a certain way, can cause this issue.

It is possible for the user to set the option "Do not sync messages older than" to a number higher than the option "Remove messages from the device older than." In this case, some messages synchronized in compliance with the first setting will be removed at the next synchronization to comply with the second.

To resolve the problem, set "Remove messages from the device older than" to the same or a higher number than "Do not sync messages older than."

Sending mail to groups without a mail address does not work Sending mail to groups without a mail address does not work. For example, using a Domino 6.5 Directory, supposed you have a group called MailGroup1 with 2 members, susan nagano and jane nagano. This group does not have an Internet mailing address, so when you send mail to the group, the users do not receive their mail, although they should.

Workaround You must define an e-mail address for the group unless your groups are flat groups and the Internet domain is the same as the mail domain.

For Domino 6.5 Directory, create a Global Domain Document in Domino's Directory so that the appropriate mail domain is returned for groups. The Global Domain document will affect the mail attribute returned in an LDAP query against Domino. If the person document or the group document does not have a value in the field labeled "Internet address", the domain and rules in the Global Domain document are used to form the mail address. If there is no Global Domain document, the IP domain of the Domino server will be used to form the mail address.

Spell checker issues � In this release, the cancel function is not available from the spell checker dialog boxes. � Depending on the current portal theme, the browser window may close unexpectedly when you click OK in the No

spelling errors found dialog box. This does not occur when the Home portal theme is used. � In the main spell checker dialog box, text in the Dictionaries field may not appear in the correct language. This

occurs if the user's preferred language is set in the browser but not in the LDAP directory. To set it in the LDAP directory, change the preferred language in the user's profile.

Suspending a rich client mail account does not work When you edit a user policy to disable mail, calendar, and the personal address book for a rich client user, then enable mail for the user through the user policy, the user will not be able to use mail.

Workaround: Delete the user's mail account, then create a new account for the user.

Deleting a user account 1. Remove the local e-mail address from the user's person record in the LDAP directory. 2. From the WebSphere Administrative Console, click Lotus Workplace --> Directories, then under General

Properties, click Directory Settings for Messaging. 3. Select the option, "Delete orphaned accounts automatically" to have IBM Workplace delete mail accounts

marked for deletion. 4. Click OK. 5. Restart the WebSphere Application Server.

79


Creating a user account IBM Workplace Messaging can automatically create mail accounts for users listed in the LDAP directory. The LDAP directory must be configured to map person record attributes to WebSphere Member Manager. IBM Workplace Messaging creates a new mail account automatically the first time a user logs in or when mail is first delivered to the account.

1. Ensure that all users who need an account are listed in the LDAP directory. 2. If you have not specified a local domain in the WebSphere Administrative Console, click Lotus Workplace >

Mail Cell-Wide Settings to specify domains that are considered local. 3. Ensure that each person record in LDAP contains an e-mail address. The mail domain in the e-mail address

must match a local domain specified in Step 2. User e-mail addresses must use the mail or mail alias attribute in the person record.

4. In the WebSphere Administrative Console, click Lotus Workplace --> Users --> Manage User Policies. 5. If you have not specified how users are assigned to user policies, click the Policy Assignment button to

choose the DN scope matching method or policy attribute method. 6. Click New to create a new user policy or click the name of an existing policy. If you do not create a new user

policy or specify an existing policy, users are assigned to the Default User Policy. 7. If you are creating a new policy, enter a policy name in the "User policy name" field. 8. In the field "Scope of user policy", enter a unique scope in distinguished name format only if you use DN

scope matching,. For example, to assign all members of the sales organization to the same policy, enter a DN scope such as "ou=Sales, ou=Boston, o=Acme, c=US" in the policy. If you assign policies based on a policy attribute, remove the asterisk (*) and leave this field blank. Note that only the Default User Policy may have an asterisk in the scope field.

9. (Optional) In the field, Allowed clients, select Rich client to enable policy users to use the rich client for mail. By default, user policies allow access to mail, including access by POP3 clients.

10. Click Apply. 11. Scroll down to the bottom of the policy under Additional Properties and click Mail details, then select

"Automatically create mailboxes". 12. Click OK, then OK again.

Time fields not checked for validity on Save Time fields are not checked for validity when saving a meeting form. Users need to verify that Start Time and End Time are valid before saving.

Toggling Hide Folders/Show Folders may alter folder expand state Clicking on the Hide Folders or Show Folders link may alter the expanded/collapsed state of nested personal folders in the folder list area. To avoid this problem, click on a folder name to open that folder after the expand/collapse state has been established, rather than before.

Using Mailing Lists with installs that generate WMM external IDs IBM Workplace Messaging will not be able to send mail to mailing lists (ibm-mailList LDAP objects) when the system is configured to generate WMM external IDs. Customers using IBM Directory Server 4.1 which uses the ibm-appUUIDAux class will be affected by this. Those customers that upgrade from 4.1 to IBM Directory Server 5.1 and switch to using ibm-entryUUID for an external ID will bypass this issue.

To workaround this issue use your LDAP administration tools to assign an additional objectclass value of 'ibm-appUUIDAux' and a new attribute of type 'ibm-appUUID' with a unique value to each mailing list in the LDAP directory.

80


IBM Workplace Team Collaboration issues

A contributor who is also an owner has moderator access When you change owner to an existing contributor in a team space, discussion application, document library or web conference, the new owner will appear in the UI as a contributor (or attendee), but will actually have moderator (or presenter) access.

Workaround To avoid confusion, choose an existing moderator as owner or reassign the existing contributor to moderator so the actual access matches what is shown in the UI. This will be addressed in a future release.

Assign task or change owner to explicit member only A collaborative application is set to allow access for all authenticated IBM Workplace users. You are trying to assign a task or change owner of a team space or web conference and cannot find the member's name on the list of available users.

Workaround The only users that show on the list are those who are explicitly added to the collaborative application as a contributor or moderator (attendee or presenter). If you want to assign a task or give ownership of a space to this user, you must add the user explicitly in the contributor or moderator role.

Cancel membership in a web conference hosted by a Linux server You have canceled your membership to a web conference hosted on a Linux server and see an error in the membership portlet.

Workaround Log out of WebSphere Portal Server and log back in. You will no longer see the web conference listed on the web conferences tab and you will not have access to the web conference.

Canceling membership in public space You see an error in the membership portlet when you cancel your membership to a public team space, discussion application, document library or web conference.

Workaround Log out of WebSphere Portal Server and log back in. You will still see the space on the public spaces list and can still access the space. Canceling your membership is for members explicitly on the membership list, not for those with access through the public access policy.

Cannot add users with Traditional Chinese locales to team space You add a member with a Traditional Chinese language preference to a team space and see "A problem occurred. The new members were not added." The member appears in the UI, but signed in as this user you cannot see the space in the team catalog and this user cannot be removed from the space.

Workaround Remove the Traditional Chinese notification properties file from the server by doing the following:

1. Stop the servers 2. Remove WAS_HOME\sntemplates\teamspace\notification_zh_TW.properties 3. Restart servers

This will allow members with Traditional Chinese language preferences to be added to the space and email notifications to be sent, although the notifications will be in English rather than Traditional Chinese. This issue will be addressed for a future release.

81


Chat feature generates error messages The Chat feature will generate several errors when sending messages. For example, select a user from the Contact List and right-click to start a chat. Enter text, and Send will cause a "Send Message Failed" error most times.

Contributor has moderator access if a member of moderator group If a contributor of a team space, discussion application, document library or web conference is also a member of an invited moderator group, the contributor will show as a contributor in the membership UI, but will actually have moderator privileges. The reverse is not true. If a moderator of a space is also a member of an invited contributor group, the moderator will show as a moderator in the membership UI and will also have moderator privileges as expected.

Workaround There is no way to have an explicit contributor who is also a member of an invited moderator group. This will be addressed in a future release.

Counts in membership are inconsistent In a team space, discussion application, document library or web conference, the count shown for moderators and contributors (or presenters and attendees) is not the same in the membership portlet people tree as it is in the manage members scenes.

Workaround The counts shown in the people tree are for online users. The counts shown in the manage members scenes are for total number of users. This inconsistency will be addressed in a future release.

Deadlock when users simultaneously create team spaces You might experience deadlocks when users concurrently modify or create pages.

Workaround Follow these steps to reduce deadlocks with the WebSphere Portal databases:

1. DB2 Version 8.1 FP4 or higher users only (skip this step if you use DB2 on OS/390): Enter the following commands on the DB2 server with DB2 instance owner privileges (for Windows, please use the DB2 Command Window):

db2set DB2_EVALUNCOMMITTED=YES db2set DB2_INLIST_TO_NLJN=YES db2 update db cfg for <wpcp_db> using locklist 1024

Note: In order to apply all of these settings you need at least DB2 Fixpack 4 applied.

2. All database users: Connect to the WebSphere Portal database and enter the following commands on the database server:

CREATE INDEX DbUser.IX2110D ON DbUser.PROT_RES (PARENT_OID, OID); CREATE INDEX DbUser.IX2140B ON DbUser.LNK_USER_ROLE (ROLE_INST_OID);

where DbUser is the WebSphere Portal database administrator

Note: If you use WebSphere Portal's document management features with DB2 Version 7.2 or SQL Server databases, you might continue to experience deadlocks. Deadlocks can occur when multiple users update or create documents in high load environments. These issues will be addressed in a future WebSphere Portal release.

Directory search of a team space not returning results If your LDAP directory is Active Directory or Novell eDirectory, using the directory search feature to search members of a team space will not return results. To correct this problem, install WebSphere Portal APAR fix number PQ93014. You can download this fix from http://www-306.ibm.com/software/genservers/portal/support/.

82


Enabling Team Collaboration mail notifications When setting up e-mail notification support for Team Collaboration and a license for Workplace Messaging is not available, you must perform the following steps to ensure that e-mail notification works:

1. Perform steps 1 and 2 of the Messaging configuration checklist by setting the DNS name of the Mail Services and setting the DNS servers from which to retrieve MX attributes. The Messaging configuration checklist is available in the IBM Workplace Information Center. Open the information center and in the navigation pane, click Messaging --> Messaging configuration checklist.

2. Use a text editor and open: <was_root>\wpcp\config\<node>\WebSphere_Portal\author\WCM.properties

3. Edit the last two lines of text (see example below), substituting your company's fully-qualified SMTP server address and the e-mail address to which you want e-mail notifications sent. # # # E-Mail settings for lite workflow # # Please edit for your company's e-mail and smtp settings. # wcm.mail.smtp.host = smtp_host.mycompany.com wcm.mail.return.address = [email protected]


5. Restart the servers.

Error inviting groups to a team space When inviting a group to a team space, you see "A problem occurred. The selected groups were not added." The group cannot be removed and members of that group cannot access the team space.

Workaround If any of the members of a group in the LDAP directory are ill-defined, you will not be able to invite the group to a team space. Correct the users in error in the LDAP directory or disable email notifications for the server.

Extended Search config form cannot handle carriage returns When configuring Extended Search as an additional search source, entering the four required parameter strings separated by semicolons and followed by a carriage return (to bring each parameter entry to the left margin) will cause users' search queries to fail.

Workaround Use semicolons only to separate the parameters and do not press Enter.

For network deployment, a contributor can rename a team space In a network deployment, a contributor to a team space can rename the space.

Workaround This will be fixed in a future release. Note that this contributor cannot perform other managerial functions such as managing members or deleting the team space.

83


Instant Contacts display problems when using high contrast You can set Windows to use colors and fonts designed for easy reading. (Choose Start --> Settings --> Control Panel, open Accessibility Options, click the Display tab and then select Use High Contrast.) If you choose this option, the Instants Contacts controls may appear to "bleed" through like this:

This is a third-party bug. To fix this problem you should install the Microsoft Internet Explorer 6.0 Service Pack 1 patch available from the Microsoft Web site.

Instant Messaging - Livenames and presence indicators When using the non-browser Client, for livenames and presence indicators to appear in views, you need to extract the plugin.properties file from: RCP_HOME\pimclient\eclipse\plugins\com.ibm.ew.pim.client.ommon.src\src.jar, and edit this line to point to the servername you are connecting to:

Servername=peabody.lotus.com

Instant Messaging - On-line tag may show disconnected If a user has an open IM window, and tries to refresh the main IBM Workplace page (by going to a different tab, for instance), their on-line center tag will become disconnected in the main window. The user is actually not disconnected, even though it displays as if they are.

If the user then tries to log into Instant Messaging, the IM window will jump to the front, but will remain showing disconnected. When the user closes all IM windows, and then tries to re-login, the display will be OK.

Limitation in the number of invited groups for an application You have invited 18 or more groups to a team space, discussion application, document library or web conference. The list of members won't display and triggers errors in the membership portlet.

Workaround Remove access for one of the groups. There is a known limit of 17 invited groups at a time in the membership portlet. This will be addressed in a future release.

Membership portlet user names appear in mixed languages In a collaborative application, the membership portlet user names appear in different languages when the current user has "-nothing selected-" chosen for the Preferred language field of the profile.

Workaround Set a specific language for the current user. Sign in to WebSphere Portal Server and click on Edit my Profile. For Preferred language, choose a specific language you would like for the user interface.

84


No warnings if team space exceeds policy size limits In the admin console you should be able to set team space policy to warn when a team space exceeds a specified size limit. In the console:

1. Log in to LWP as an admin user 2. Click Administration link at the top of the page 3. Open Portal Content tab 4. Select Workplace Policies view 5. Select the link to the policy you want to edit

For example, you should be able to set the size limit at 3MB, and when a team space reaches 60% of that size have a warning appear on the welcome page and in an email sent to moderators of the team space. No warnings are appearing in the Welcome page or in emails. This will be fixed in a future release.

Problems with IBM Workplace applications using Cloudscape If you have deployed IBM Workplace using Cloudscape as the back-end data store, and are having problems renaming or deleting team spaces, discussion applications, or document libraries, or are having problems with the task scheduler, apply the following workaround.

Workaround Redeploy IBM Workspace using DB2 as the back-end data store.

See old leave message if cancel and then return to space You have canceled your membership in a team space, discussion application, document library or web conference. If you are added as a member to the space again before signing out of IBM Workplace, you will still see the leave message when accessing the space.

Workaround Log out of WebSphere Portal server and then log back in.

Shared member of two groups may not have correct access to space Two groups who share a member have been invited to a collaborative application. One group has moderator (or presenter) access and the other has contributor (or attendee) access. When the shared member accesses the application for the first time, the member may be added to the contributor list when the higher of the two roles (i.e., moderator) would have been expected.

Workaround Another moderator in the application can reassign the contributor to moderator.

Team Space Search index gets deleted on first restart of server The Team Space Search index is deleted the first time the server is restarted.

Workaround Add more content to the Team Task List, and the index will be recreated on the next indexing cycle; Search will then again return results.

85


UNIX - PowerPoint files not displaying as a preview in Documents Accessing a Unix IBM Workplace server, you open a team space and click the Documents tab. Click New - Microsoft PowerPoint for Windows. Give the new document a title. Then click Open file. Add text to the first slide. Save the PowerPoint file, then save the document. There should be a preview mode showing you what the title page looks like. This may show a broken image instead. The presentation content can still be accessed by click Actions - Download, or by clicking Edit.

Workaround You must launch the Portal Server on a machine that has Windows.

Web conference should not be in catalog It is possible to list "Web conference" as an application type in a catalog. Users cannot create their own web conference, categorize an existing application as a web conference, or edit a web conference in Builder, all of which can be done with other applications available for a catalog list.

This issue will be addressed in a future release.

You must enable cache replication in network deployment In a network deployment you may not be able to create team spaces if you are not a IBM Workplace administrator.

Workaround The cache replication over cluster nodes is disabled by default. You must enable cache replication for the environment to be supported. Follow these steps to check that it is enabled:

1. Open WAS Admin Console2. click 'Application Servers'3. select appropriate server 4. select 'Dynamic Cache Service'5. make sure 'Cache replication' is checked. If it is not checked, check it, save the configuration, and synchronize the configurations. (not sure maybe a server restart is also required)

This has to be done for all nodes in the cluster.

IBM Workplace Forms issues

Edits to a form template title creates a new form portlet When editing a Form Template in the Form Template Library, if the user changes the Form Template Name, a new portlet is created.

The correct action is that the Form Template name should be changed. Although this does happen as expected, an additional form portlet is added to the list of available portlets.

Field displays "changed" after selecting name in People Selector When a user is completing a Form document containing a Name input field, after selecting a name using the pop-up name selector, the Name field will contain the text "changed".

After saving the completed document, the name is reflected correctly in the view. If the user reopens the document in read or edit mode, the name is also correct.

86


Moderator & Contributor roles portlet in application not working Setting Moderator and Contributor roles on Form portlets in an application is not working correctly

New form portlets created by non-admin are not found If a user without Administrator rights creates a Form template, the resulting new form portlet:

1) does not display in the "Add portlets" list, and 2) cannot be found when searching the portlets list.

This issue will be addressed in the Gold release of this product.

Only first name selected displays in form portlet view When completing a form document containing a Name field, if more than one name is selected only the first name selected will display in the form portlet view.

There is no known workaround for this issue.

IBM Workplace Templates and Applications issues

Application parameters display at instantiation When you create an instantiation from a template that contains multiple components of application parameters the format of the application parameters display at instantiation may become intermingled.

Cannot edit a template more than twice After editing a template twice, each time saving changes, you may be unable to open the template to edit it a third time.

Component properties do not show default parameter values If you create a new application template based on the Team Project template and add a Domino Application component with the default parameter values for this component left unchanged, any applications created from this new template will not display the default parameter values as component properties. If an application user tries to edit the component properties for the Domino Application, any default values that appear in the fields of the Component properties edit window will clear when the user clicks OK. The Component properties for the Domino Application will display no values.

Default editor/user policy cannot be re-added A template is given a default soft group of editors and users; if this group is removed, it cannot be re-added. There is also no functionality to view the members in the soft group from the UI.

The workaround is to NOT remove the default soft groups.

87


Edited component properties are not immediately refreshed When you edit the component properties of a Workplace application using the Workplace application editor, the Properties portlet, you will not see the modified component properties until you log out of IBM Workplace Collaboration Services and log in again. Application parameters specified as editable component properties and the values of component properties that you edit are not refreshed in the current browser session. For this reason, you need to close the current browser session for IBM Workplace Collaboration Services and open a new session to see application parameter and component property updates.

Form Template Library title is incorrect The Form Template Library title bar displays "Application Template Library"; it should display "Form Template Library".

Template Catalog shows inaccessible templates The Template Catalog incorrectly shows templates that a user does not have Edit access to.

Template Editors can change Template Owner Template Editors can change the owner of a template. This is not the specified behavior for Template Editors.

Values specified for application parameters are not validated When you specify values for application parameters (using the Parameters portlet of the template editor), the values that you enter are not validated for data type and other consistency checks when they are displayed as editable component properties during application creation. When users create new applications from the template, they might encounter default values for component properties of the application that are not valid. If you discover errors in parameter values that you have specified in the template editor, you will need to edit the parameter values to correct them.

People components

Directory Search results not displaying a user's title When you open a person record for a user found through Directory Search, the user's Title field is empty, even if the LDAP directory stores a personal title for the user. This problem occurs because IBM Workplace assumes the title is stored in the lookaside database rather than in the LDAP directory. To correct the problem, map the lookaside attribute ibm-PersonalTitle to the LDAP attribute used for the personal title. For instructions, see the topic "Mapping lookaside person attributes to custom LDAP attributes" in the IBM Workplace Information Center.

Person tag links not updated when user information changes The Person tag, which users can click to do tasks such as sending an e-mail to someone or inviting someone to a meeting, identifies users by their e-mail addresses. If a user's e-mail address changes, IBM Workplace does not update the e-mail address in existing Person tag links. If your organization needs to change e-mail addresses, you can work around this issue by retaining old e-mail addresses in directory person records along with the new ones.

Pop-up windows can trigger login screen Opening a pop-up window after a user session timeout triggers a new login screen. After logging in again, the user is returned to the Portal page rather than to the pop-up window.

88


Security

Domino CA occasionally refuses to certify Workplace certificates The Domino Certificate Authority, 6.5.2 Gold version, may refuse to process IBM Workplace mail-in certificate requests for some users. It rejects them with an "Error in request >Extensions<" error message. Although the request is not processed, the Domino server does not send a rejection notification to IBM Workplace, so the IBM Workplace Domino PKI adapter continues to periodically retry the request. These retries are also rejected by Domino.

The only way to stop the retries is for the Domino admin to manually reject the request from the Domino certreq database.

This problem will be fixed in Domino 6.5.3. Customers experiencing this problem using Domino 6.5.2 should contact IBM support to request a hotfix, quoting SPR #SFPN5XYRS9.

If the HTTP session times out, you may lose unsaved work The HTTP session is set up to time out if you are not actively using IBM Workplace for a specific amount of time. The timeout is a security feature designed to prevent someone other than the logged in user from accessing IBM Workplace information. However, if you compose a mail message, for example, and leave your machine for longer than the designated session timeout, when you return you are informed that your HTTP session has timed out. You are instructed to log into IBM Workplace again and the mail you started to compose is not preserved.

To change the IBM Workplace HTTP session timeout:

1. Log into IBM Workplace as an administrator. 2. Go to Servers > Application Servers > WebSphere_Portal > Web Container > Session Management > Session

timeout. 3. Change the session timeout to a number you are comfortable with; use discretion in determining a value that

balances the security gains of a lower number and the user convenience of a higher number. The default timeout is 30 minutes.

Incorrect error message importing an invalid PKCS12 objects On the Security Preferences, My Certificates page, if an attempt is made to import an object that is not a valid PKCS12 file, an error message may be displayed indicating a problem reading the local credential store. This message is incorrect - the local credential store is undamaged. The message should say that there was a problem reading the PKCS12 file.

Logout/login required to see newly added certificates When you add a new certificate to the Workplace Client Certificates Store, using the WebSphere Administrative Console, you must log off and log back onto the server before the new certificate displays on the Workplace Client Certificate Store page.

Mail encryption fails for contacts newly added to PAB In a deployment in which a CA is used to issue and distribute certificates, IBM Workplace uses the certificates stored in, and retrieved from, the LDAP directory to encrypt mail messages. In this release, encryption certificates for contacts that are newly added to the Personal Address Book (PAB) on the client are not immediately available. They are retrieved from the LDAP directory by a background task. When encrypted mail is composed, if a new contact's email address is available from the client's PAB, the LDAP directory is not accessed at all. As a result, if a user attempts to send an encrypted message to a new contact between the time the contact's address entry is added to the PAB and the time the background task runs to retrieve that contact's encryption certificate from the LDAP directory, the encryption will fail. Depending on the user's policy settings, this may mean that the message is sent unencrypted or that it is not sent at all.

89


This issue causes message encryption to fail in the following situations:

� Sending an encrypted reply to a message received from a new correspondent. � Adding a correspondent manually to the PAB, then attempting to send an encrypted message to that

correspondent.

Repeating error message: "Authentication failed for <null>" When the LotusWorkplace_Server process is started, the Task Scheduler Service will attempt to run the IBM Workplace PKI task every 5 minutes. If the IBM Workplace PKI has not yet been configured, 2 instances of the following benign error message will appear in the Portal server's SystemOut.log every 5 minutes:

[6/16/04 12:15:01:307 EDT] 5147a250 MethodDelegat A SECJ0055E: Authentication failed for <null>. The user id or password may have been entered incorrectly or misspelled. The user id may not exist, the account could have expired or disabled. The password may have expired.

There are 2 ways to eliminate these error messages, if so desired:

1. Configure the IBM Workplace PKI per the instructions in the InfoCenter.

2. If the PKI is not going to be configured, then:

1. Stop the LotusWorkplace_Server process.

2. Using a text editor, edit the file:

(Windows) <WebSphere install directory>\AppServer\config\cells\cellName\nodes\nodeName \servers\LotusWorkplace_Server/lwpscheduler.xml.

(UNIX) <WebSphere install directory>/AppServer/config/cells/cellName/nodes/nodeName /servers/LotusWorkplace_Server/lwpscheduler.xml.

3. Comment out the following task entry by adding "!--" & "--" to the opening and closing task tags, as shown below:




5. Start the LotusWorkplace_Server process.

NOTE: If #2 above is used, and, at a later date, the IBM Workplace PKI needs to be configured, then repeat #2, this time removing the "!--" and "--" comment designators from the PKI task.

Security implications with WMM In the current release of IBM Workplace, there is a security issue using the WebSphere Member Manager (WMM); the WMM Enhanced JavaBean (EJB) is not currently being secured with EJB roles.

This means that WMM methods can make changes to a directory depending on the rights given to the bind ID that WMM uses to access the directory. Because the EJB is unsecured, an unauthorized user within the firewall can develop code to call the WMM bean remotely. They can then use this bean to perform whatever actions the LDAP bind ID is authorized to perform. This can include modification of Groups membership, deletion of users, an ability to read a weakly-encrypted password, and the ability to modify passwords.

90


Workaround These remote attacks, such as the one described above, can be easily protected by putting the server behind a firewall and shutting off remote access over IIOP.

Alternatively, the bind ID can be given less access to the LDAP directory; most customer deployments give read-only access, and can also prevent this ID from reading passwords. This configuration does prevent the "Sign up" and "Edit profile" pages from working, but these pages are often modified by customers, and their modifications allow for this.

Security issue when IBM Workplace has write access to LDAP There is a security issue with the current release of IBM Workplace and its usage of LDAP. A Java programmer can use the Workplace Member Manager API shipped with IBM Workplace to gain unrestricted access to the LDAP directory. A Java program can then be written to change any directory information accessible through the API. For example, the passwords of arbitrary users could be changed, thereby allowing someone to gain access to any restricted IBM Workplace data.

To limit your exposure, give IBM Workplace only read access to the LDAP server. For information on configuring read-only LDAP directory access, see the IBM Workplace Information Center.

Security vulnerability between Workplace and MS PKI EJB servers If you are using a Microsoft CA to issue client certificates, there is a security vulnerability in the communications between the IBM Workplace server and the machine on which the Microsoft PKI EJB is deployed. The communication over the network is not secure.

Some Verisign CA cert attributes are not supported The Verisign administrator can configure the following attributes for issuing Verisign certificates to IBM Workplace users only: CN (Common Name), E (E-mail), OU (Organization Unit), O (Organization) and C (Country). If the administrator configures the certificates based on any other attributes, such as a SN (SURNAME) field, the certificates issued by the CA may not display in the Security preferences pane in the client.

Special characters could prevent wpsadmin from authenticating On some LDAP vendors, special characters could prevent wpsadmin from authenticating

Avoid including the following special characters in the password for your WebSphere Portal administrator account, as they have been known to cause problems with authentication: ( ! @ # $ % )

You may be prompted twice to trust same certificate After the install of the client, when you log in over SSL and connect to a provisioning server, you are prompted to accept a trust certificate into the personal credential store for that server. If you click Yes to accept the certificate, you may be presented with the same dialog. Click Yes again and you can continue logging onto the server.

91


International language support

Active Content Filtering on non Latin-1(ISO-8859-1) documents If Active Content Filtering (ACF) is enabled and a document contains non ISO-8859-1 characters (for example, Hebrew, Chinese, etc.), the contents may not be displayed correctly (question marks, etc.). A workaround would be to disable ACF.

Browser issues

Back button shows information after logout The browser back button can show a secured page after logout. With some browsers you might be able to view the information from a previous portal session by using the back button after logout. When you log out and click the back button, you can see the page that was last viewed.

For example, you view an e-mail and click Log out. The portal returns to the Login panel. If you then click the back button, you might be able to view the e-mail again, depending on your browser. When you click the back button, the browser returns to the data cached by the browser.

Users can prevent the display of secured pages by either closing the browser after logout, or clearing the browser cache. If you run the browser with SSL enabled, the problem does not exist.

Note: The problem concerns only the display and view of data. The portal or the displayed data cannot be modified as clicking the back button does not undo the logout.

Chat may not work using Mozilla browser If using the Mozilla browser, Chat may not work. When initiating a Chat, you may receive a blank window rather than the expected Chat window.

JavaScript error when performing certain tasks You may encounter a harmless JavaScript error when attempting to compose a mail message, create a new contact, or create a new task or team space.

Workaround Click OK to dismiss the error and continue working.

Problems with SCORM courses not working on Linux/Mozilla Following are the known issues using SCORM courses with Linux/Mozilla:

� Any course that uses the SCORM standard will not track.

� SCORM 1.2 compliant courses may not launch

Workaround : Use Internet Explorer 5.5 or 6.0.

92


Rich Text Editor Spell Check w/ tables in doc concatenates text Running Spell Check on a Rich Text document that contains body text followed by table text may result in unexpected text concatenation. When inserting a table into a document, ensure that white space separates the body text from the table.

Some Learning functionality not supported in Mozilla browser The following Workplace Collborative Learning functionality is currently not supported while in the Mozilla browser :

� Course Chat � Live Virtual Classroom sessions � Learning specific Discussions

Workaround : use IE 5.5 or IE 6.0

Spell Check corrupts tables in Rich Text Editor When running spell checker on mouse selected text within a table, text may be replaced outside of the table. This is a known issue with mouse selection within an HTML table. The user may inadvertently include table formatting tags within the selection. This can be prevented by using the keyboard to select only the text meant to be checked, rather than using the mouse.

Text indentation not visible in HTML view in Presentation editor In Presentation editor, sometimes the indentation or alignment of the text in textboxes or bulleted lists is not visible in the HTML view.

This is a limitation of the HTML view as the positioning of the outer container of the text (For example, Textbox Frame, Items Frame) takes priority over the positioning of the inner text. Therefore, all text is rendered at the same level of indentation.

Portlet issues

Blank page upon login to IBM Workplace When logging in to IBM Workplace, users may see a blank page.

Workaround 1. Log in to the server as a WebSphere Portal administrator.

2. Paste the following string into the browser's address bar, and press ENTER:

http://<server_name><domain_name>/lwp/myworkplace/!ut/p/_s.7_0_A/7_0_3S

This directs you to the My Portal page.

3. Click Manage Pages.

Notice that the Spell Check Handler appears at the top of the page; this is what causes the display to appear blank to the user.

4. Move the Spell Check Handler below My Portal (so that My Portal is at the top of the page).

93


Entries are deleted after logging out Entries created in the Forms portlets are deleted after the user logs out. This includes any content created in all of the following Forms portlets:

AgendaAnnouncementsAttendanceCustomer ContactsDirectionsEmployee DirectoryFAQsInvitationsIssuesLinksMilestonesMinutesProspectsSales TrackingSign Up SheetSurveyVacations

Instant messaging if SIP server fails If the SIP server fails and instant messaging becomes unavailable, you must reboot all servers for instant messaging to become functional again.

No 'Show All' option after search in Manage Document Libraries After a search is performed in the Manage Document Libraries portlet, there is no way to refresh the UI and display all the Document Libraries. The workaround for this known problem is to log out and log back into Workplace. Once the user has logged back into Workplace, the Manage Document Libraries portlet will be refreshed and all the Document Libraries will be displayed.

User is logged out if working in open document over two hours In any IBM Workplace application, users working in an open document for more than two hours will be automatically logged out of IBM Workplace and sent to the log-in page. The user will lose any work they have not saved. The problem occurs because of a forced ltpa token expiration, and will be fixed in a future release.

Web conferencing PowerPoint slide display problems If a firewall (such as Zonelabs Integrity Desktop) is enabled, fonts and symbols in PowerPoint slides may not always display correctly during a Web conference. Click Refresh to correctly display the fonts and symbols in these slides.

Windows may flicker and disappear Some windows, such as the Web conferencing presentation client window and the chat window, may "flicker" (display and then disappear) when you minimize the window and/or navigate to other windows. In some cases, the original window will re-display again, after flickering. If the original window does not re-display, minimize other windows to see it.

94


WebSphere Portal issues

Contact information not always saved successfully Because of a malfunction in the personal address book cache, saving a contact may result in missing information.

Workaround Disable the cache. Take the following steps:

1. Edit the workplace.properties file.

2. Create the following setting: people.PAB.cache.enabled=false

3. Save the file.

4. Restart the Workplace server.


Cannot import or export applications without the data definition When importing or exporting database applications, the data definition always gets imported or exported, even if you de-select it on the Import Database Application or Export Database Application dialog boxes.

Combination box list items don't update when new items are added New list items added to a combination box control in data access viewer will not appear as an option for new records unless the form is saved and closed first, and then reopened. This problem is evident in the following scenario:

1. There is a form that has an editable combination box control that is bound to a column in the same table as the form is bound to, for example the Country column.

2. If you open the form in data access viewer, you can see all the of countries that have been entered in other records.

3. If your country is not in the list of countries, you can type in the value on the form. 4. If you then create a new record, you won't see the country you just entered in the list of countries. 5. To see the new country that you added, you need to save and close the form, and then reopen the form.

Error message 23502: columns cannot accept Null value After creating a form and checking the "Enable auto-save of data" box on the Form Info tab and then previewing the form in data access viewer, if you click the New button, an error message that says that your columns cannot accept a null value may display. To avoid this error, all primary key and non-nullable columns must have a default value assigned. For primary key columns, this default value must be unique for that table.

The following is an example of an XPath expression that will assign a unique default value for a primary key column from a table:

if(count(instance('defaultInstance')/<TABLE NAME>)=0,'1',string(max(instance('defaultInstance')/<TABLE NAME>/@<PRIMARY KEY COLUMN>)+1))

where TABLE NAME is the name of your table and PRIMARY KEY COLUMN is the name of your primary key column.

95


Form closes without warning after deleting last record In IBM data access viewer, if you add records to a form and then decide to delete them, the form will automatically close without any notice after you delete the last record. To avoid closing the form, leave at least one record in the form.

Images on buttons do not appear when previewing forms When previewing forms with buttons that contain images and text, the button displays the text but not the image. This usually happens because the size of the image is greater than the size of the button. To view the image, open the form in data access designer, increase the size of the button to accommodate the size of the image, save the form, and then preview it again. If the image still does not appear, you may need to increase the size of the button again.

Red cross appears instead of error message When de-selecting all the design elements on the Import Database Application or Export Database Application dialog box, a red cross appears at the top of the box instead of an error message telling you that you must select at least one design element in order to proceed.

Renamed columns do not appear in data binding drop-down list After completing the following steps, you may find that newly renamed columns do not appear in the Data binding drop-down list in the attributes editor. Instead, the original column names remain in the list. To correct this, click Add Column beside the Data binding drop-down list, select the newly renamed column, and then click OK to add it. Now the newly renamed column should appear in the Data binding drop-down list and can be used for data binding.

1. Create a table in the data definition of an application. 2. Create a form using that table. 3. Reopen the table in the data definition and rename one of the columns. 4. Reopen the form.

Renaming a table If you rename an existing table that is bound to design elements, and the design elements are not closed when you rename the table, you must close, re-open, and re-bind the existing design elements to the new table name. Existing design elements will not automatically update with the new table name.

Re-binding data will cause all previous selections in the Order by and Conditions tabs of the the data binding wizard to be lost.

Select correct computed expression for summaries to work If you add a Computed Field column to a report, and then add a grand summary to that same column, you need to be sure that the computed expression you choose for the computed field will work with a summary. If you do not select a computed expression that can work with a summary, you will see an error message.

In this release, only simple expressions will work with summaries. Examples of simple expressions are @Salary, @Age, @Name, where Salary, Age, and Name are column names.

Some border styles appear incorrectly in data access designer The following scenario outlines an issue with border styles:

1. In data access designer, create a form and include some table columns from a table in the data definition. 2. Select a control on the form, and then click the Border tab in the Attributes editor. 3. Add a border to the control.

The border styles DOUBLE, GROOVE, HIDDEN, INSET, OUTSET, and RIDGE are all drawn as SOLID style in data access designer. These borders appear correctly in data access viewer.

96


Activity Explorer

Alert notifications not working When an activity explorer user creates or modifies a shared object, an alert bubble should display on the desktop of any member of the object. In this beta version, alerts are not currently working. This issue is scheduled to be fixed in the final 2.5 release.

Default display can become corrupted In some installations, the activity explorer desktop can become corrupted. For example, if you close a tab in the Activity List pane by clicking the X on the tab, you cannot reopen the tab. To restore the desktop, complete the following steps:

1. Close the Workplace client. 2. Delete the following folder:

C:\Documents and Settings\[username]\IBM\RCP.1. Restart the client.

This problem is scheduled to be fixed in a future release.

Modification data for some objects is not updated properly The modification times and modified by values for persistent chats, shared screens and shared files are not always updated properly. This problem is scheduled to be fixed in a future release.If the modification date and modified by values are not updated properly, you might be able to restore the correct values by clicking Refresh from the Activity List pane.

Wrong options included in context menus for restricted objects In the Activity Thread pane and other views that show the hierarchy of an activity, the activity explorer always displays the full path from a given object to the root of the activity. A user who is a member of an object B that is descended from an object A for which the user is not a member will always see a restricted node icon as a placeholder for the actual object A. The user can view the membership list for the restricted object A, but otherwise has no access to it.

Testing has identified an issue in which all of the options for acting on an object (for example, Reply/Add, Open, Add New Members, and Rename) appear on the context menu for a restricted node, even though the user does not have access to perform these operations. Although unauthorized operations initiated from the menu do not succeed, the options for performing these operations should be disabled (dimmed) on the menu. This problem is scheduled to be fixed in a future release.

Technical Preview

Admin mail preference values are default for new portlet users Once the Notes Mail Portlet has been installed and configured for other users by the Notes Mail portlet administrator, if the administrator is logged in and edits the portlet mail preference page, (for example entering in a username, password, domino servername and path to mail file), any values entered and save there by the administrator will become the default for all users that have not yet edited their particular instance of the Notes Mail Portlet. If the administrator does not want these values to be inherited by all new users, the administrator should leave these values blank.

97


All sent messages are saved in the sent folder If you create a new message, and uncheck the box "Save in Sent folder", when you send the message, it actually will be saved in the Sent folder. The workaround is to go to the sent folder and delete the unwanted message from the folder.

Bad email addresses may not return delivery failures If a user composes an email and sends it to a bad email address, the user may not always get a delivery failure report.

Caveats using the 'Move to Folder' button to move messages Users should avoid using the 'Move to Folder' button to move messages from the Inbox to the Drafts, Sent, or Trash Folders. Messages are normally moved to those folders as a result of a different action button (Save As Draft, Save in Sent Folder, and Delete). The 'Move to Folder' button should only be used to move messages from the Inbox to personal folders and between personal folders. If a user does select to move a message to the Drafts, Sent, or Trash Folders, the message may not appear in the desired folder. However the user should still be able to find the message in the 'All Messages' view.

Delete Folder from Notes Mail does not work Deleting folders does not work if the "Allow soft deletions" option is checked in the Mail database properties -> Advanced tab.

The workaround is to uncheck the "Allow soft deletions" option in the Mail database properties -> Advanced tab. Log out and log back in after deleting the folder.

Errors occur when deleting documents or folders If a mail file on the Domino server has soft deletions enabled, a user may experience errors deleting documents and/or folders in the Notes Mail - Technical Preview portlet. This problem is solved by installing the Notes Mail Technical Preview fixpack for Domino 6.0.4/6.5.2.

If Soft delete is disabled, you cannot empty the trash folder If a user navigates to the Trash folder, and chooses to empty the Trash, the Trash folder refreshes, but the documents remain in the trash folder.

Workaround: Go into Domino Database properties - Advanced, and enable Soft Delete for that Domino mail file.

If Soft Delete is enabled, Messages in Trash lose field values If a user has Soft Delete enabled, Messages in the Trash folder lose values in the "From", "Subject", and "Date" fields.

Workaround Go into Domino Database properties -> Advanced, and disable Soft Delete for the Domino mail file.

98


Issues with documents saved as drafts Following are the known issues with documents saved as drafts:

1. Checkbox settings (High priority, Confirm delivery & Save in Sent Folder) are not saved when you 'save as draft.'

Workaround Recheck the desired settings when you edit the draft again.

2. Unable to open a document 'saved as draft' in the All Messages folder.

Workaround Navigate to the Drafts folder and open the document there.

3. If you save a document with rich text elements as a draft, a question mark character appears at the end of the body field, in the draft, when you reopen it.

Workaround Delete the question mark character before you send the message to the recipient.

Junk Mail dialog can't be reinvoked after checkbox is checked When a user performs any of the following three types of actions:

-- deleting a message as junk mail -- moving a message to the Junk Mail folder -- moving a message out of the Junk Mail folder, or designating a message as "Not Junk Mail" from within the Junk Mail folder

the user will see a dialog displaying informational text, and a checkbox labelled "Do not show me this message again." If the user checks the checkbox and clicks the OK button to dismiss the dialog, they will have no way of reinvoking the dialog for that type of action in the future.

The workaround is to open the following file:

websphere\appserver\installedApps\<nodename>\A_LWP_Messaging.ear\lwp.portlets.mailbox.war\mailbox\view\ind ex.jsp

and unset the preferences according to the directions in the file (see the "DO NOT DELETE" section).

Please note that for the 2.0 release of IBM Workplace, the Junk Mail feature is presented as a technical preview only.

Messages are lost after renaming a user's folder If a user renames a folder, the new name does not automatically appear in the view, and all messages in that folder disappear.

Workaround Log out and log back in again.

Misleading wireless message if Notes mail source not configured When using a Wireless or hand-held device to open a Notes mail database using the Common Messaging portlet, if the Notes database name, server details or user name and password have not been configured in the Mail preferences, the error message displayed on the wireless device is vague and does not indicate the cause of the error. To correct this problem, login using an HTML browser, and select Edit on the Notes Mail portlet to display the mail preferences. Complete and save the Notes mail preferences, and ensure that you can then open the mail database using the HTML browser.

99


NotesMail - Changing portlet's mail source The Notes Mail portlet doesn't immediately reflect changes to a new Mail Source setting. Users must log out /in to portal to "apply" the change.

NotesMail - Do not change Mail server type/protocol In the Notes Mail portlet, the "Mail server type/protocol" field should not be visible in the Configuration Page as an editable field. Leave the setting for "IBM Lotus Notes."

NotesMail - Syntax Error when clicking Edit Mail Source button In the Notes Mail portlet, clicking the "Edit Mail Source" button in Mail Preferences invokes a Syntax Error.

NotesMail - Username/Password fields in Mail Preferences The Username and Password fields in the Mail Preferences page should be hidden when the portlet is configured for SSO (set in configuration mode by the Administrator). Values in these fields will be ignored if SSO is being used as the Authentication method; this is appropriate behavior.

Sending mail addressed to Notes name causes Domino to crash If a user sends a message to another user addressed with the Notes hierarchical name or short name, instead of the user's internet address, the Domino server can crash with a "PANIC: LookupHandle: null handle" error. This problem is solved by installing the Notes Mail Technical Preview fixpack for Domino 6.0.4/6.5.2.

Special characters display incorrectly in subject, body of email Some characters such as "<", ">" and "&" that are considered special characters in XML, might be rendered incorrectly in the subject or body of an email message, depending on the editor used to create the message. For example, a "<" might be displayed as "&lt"

Tabbing and focus issue in a Mail message After creating a new mail message you can press the "Tab" key to quickly reach the body of the Rich Text editor, however you will also need to tab through the icon bar as well; you will need to press the "Tab" key 7 times in order to move from the Subject field to the body of the Rich Text editor. Also, there will be a blinking cursor in the Rich Text editor even when focus is not in this area.

Unread marks not working for new messages When receiving new mail in the Notes Mail - Technical Preview portlet, the new messages may not appear as unread (in bold).

Workaround Mark the message unread using the Actions menu in the Inbox.

100


When reading a rich text message, text colors are not displayed When reading a rich text message that has colored text, the text displays only as black. This problem is solved by installing the Notes Mail Technical Preview fixpack for Domino 6.0.4/6.5.2.

When reading rich text messages, inline images are not displayed When reading a rich text message that has an inline image included in the body of the message, the inline image will not dispay. This problem is solved by installing the Notes Mail Technical Preview fixpack for Domino 6.0.4/6.5.2.

Wireless: Body text lost using address lookup on forwarded mail When using a wireless protocol (for example WML) to access the Notes Mail portlet, the following sequence of steps can cause loss of information:

� Open a message � Select Forward to forward the message to another user � Enter text into the Body field � Click the To: link to lookup mail addresses for the message � Return to the forward message form (either by selecting an address from the addressbook, or by cancelling

the lookup)

The mail body text will have been deleted. To work around this problem, always lookup up the addresses for the message before entering the text of the message.

Please note that for the 2.0 release of IBM Workplace, the Wireless access feature is presented as a technical preview only.

Wireless: Error when opening/restoring message in Trash folder When using a wireless protocol (for example WML) to access the Note Mail portlet, the following two errors will be found with the Trash folder if the Notes mail database is configured for soft deletion:

� Opening a message from the Trash folder will cause an error � Restoring a message from the Trash folder to another folder will not generate an error, but the message will

remain in the Trash folder


Wireless: Invalid addresses deleted without error message When using a wireless protocol (for example WML) to access the addressbook portlet, the following sequence of steps can cause loss of information:

� Create a new group � Enter an invalid address in the Members field � Click the addressbook lookup field to lookup additional entries for the Members field � Return to the create group form (either by selecting an address from the addressbook, or by cancelling the

lookup)

The invalid mail address will have been deleted from the Create Group form without an error message. Any valid addresses will be preserved correctly.


101


Wireless: Navigation of Folders w/ Pocket PC IE skips messages Using wireless access via Internet Explorer on a Pocket PC, when using "Next Messages" and "Previous Messages" to navigate through the Inbox, the messages might appear out of order or skipped.

To navigate through the Inbox in this case, open any message and navigate to each message in sequence by selecting "Next Message".

102


Documentation updates

IBM Workplace Information Center

Additional components IDs for messages IBM Workplace message IDs consist of five alphabetic characters followed by a four-digit number and a one-character severity indicator. The five characters for Workplace messages all start with the characters "CL."The following additional component IDs are not documented:

ID Component CLFAH PKI Framework - EJBs CLFAI PKI Framework - client CLFAJ PKI Adapter - Domino CLFAK PKI Adapter - Verisign CLFAL PKI Adapter - Microsoft CLFAM Learning Spam Filter

CLFCQ TeamTaskList Portlet CLFCR TeamTaskList Service

CLFDM SIP Container CLFDN SIP Stack CLFDO SIP Servlets CLFDP Presence service CLFDQ IM service CLFDR Appshare CLFDS PeopleLinks Channel CLFDT Stateless SIP Proxy Channel CLFDU Meeting Channel CLFDV Channel IBM Workplace Service CLFDW Sip Session Manager CLFDX Sip Session Publisher CLFDY Sip Conference Document API CLFDZ Sip Session Description API CLFEA Chat Room Portlet CLFEB Persistent Chat EJB CLFEC webConferencing CLFED webConferencingXI CLFEE Sip Session Proxy CLFEF Persistent Chat Server Side Client CLFFA cdo API CLFFB cdo Portal API CLFFC cdo EJB CLFFD cdo Portlet CLFFE propertybroker API CLFFF propertybroker EJB CLFFG extensions API CLFFH collaborative context API CLFFI collaborative context EJB

103


CLFFJ community API CLFFK community Portal API CLFFL community EJB CLFFM community Portlet CLFFN workplaceurlAP CLFFO workplaceurlEJB CLFFP workplaceurlPortlet CLFFQ workplaceurlPortalAPI CLFFR CDO admin command-line commands CLFFS IBM Workplace Softgroup adder CLFMA Address AutoComplete CLFMB Moscow Blended CLFMC Moscow Buddylist CLFMD Moscow Calendar CLFME Moscow Datepicker CLFMF Moscow Docedit CLFMG Moscow Help CLFMH Moscow Listviewer CLFMI Moscow Mail CLFMJ Moscow Namelookup CLFMK Moscow Navigator CLFML Moscow Perspective CLFMM Moscow Search CLFMN Moscow Subscription CLFMO Moscow Threads CLFMP Moscow Common CLFMQ My Doc's UI CLFMR My Doc's Replication CLFMS Pim Print CLFNA Briefing View User Tier CLFNB Briefing View Workspace Tier CLFNC DIP Workspace Tier CLFND DIP Service Tier CLFNE DIP Resource Tier CLFOA Offline Policy API CLFOB Offline Policy EJB CLFOC RCP Policy plugin CLFOD Offline Account API CLFOE Offline Account EJB CLFOF RCP Account Plugin CLFOG Client Replication Workspace CLFOH Client Replication Service CLFOI Client Replication Resource CLFOJ Replication Workspace CLFOK Replication Service CLFOL Replication Resource CLFOM Preference Service Ejb CLFON Workplace Client Agent Manager CLFOO RCP configuration CLFOP PCM Cache CLFPA Workplace Client Download Center

104


CLHCA Messaging Account Context EJB CLHCB Messaging Admin Workspace CLHCC Messaging Admin EJB CLHCD Wireless Mail CLHCE Wireless Calendar CLHCF Wireless Address Book CLHCG Wireless Aggregator CLPAA IM Service

CLQAI Delivery Server CLQAJ Disconnected Use Client

CLYCA Template Instantiation CLYCB Template Catalog CLYCC Template Serialization CLYCD Template Editor Support CLYCE Forms Builder CLYCF Forms Submission CLYCG Forms Renderer CLYCH Forms Library CLYCI Forms Manage CLYCJ FormWizardPortlet CLYCK Listener CLYCL Managepages CLYCM Managerole CLYCN ManageTemplatePortlet CLYCO ParameterPortlet CLYZA pfcAPI CLYZB pfcEJB CLYZC pfcPortalAPI CLYZD pfcPortlet

Configuring the IMAP service When you configure the IMAP service, you must also enable IMAP in a user policy. The IMAP service acts as an intermediary for communications between IMAP mail clients and IBM Workplace Messaging. You can configure all IMAP Services in a cell by performing the following steps:

1. In the WebSphere Administrative Console, click Lotus Workplace --> Mail Cell-Wide Settings.

2. On the Configuration page, scroll to Additional Properties.

3. Click IMAP

4. Edit the IMAP properties.

5. Click OK.

6. Click Lotus Workplace --> Users --> Manage User Policies to enable IMAP in a user policy.

7. Select the user policy for which you want to enable IMAP access.

8. Scroll down to the option "Allowed alternate mail clients" and select IMAP.

9. Click OK.

Note Users must log out, then log back in to use the changed policy. Note that policy changes take from 15 minutes to an hour to process; therefore it is good practice to make policy changes at the end of the day so that users can begin using the new policy when they log in the next day.

Note To use SSL with IMAP, you must first enable SSL in WebSphere Application Server. Click Security --> SSL to enable SLL in WebSphere Application Server.

105


Help incorrectly references mobile client in user policies The Administrative Console Help incorrectly states that the mobile client is an available client in user policies under the "Allow clients" section. If you want to enable users to use mobile devices with IBM Workplace, select "Allow technical preview" instead.

HTML table of contents cannot be collapsed in Mozilla If you use a Mozilla browser to view the IBM Workplace information center, the HTML version of the table of contents displays fully expanded, and cannot be collapsed.

Installing and configuring the IBM Tivoli Directory Integrator Add the file name "migration.request.jar" to MYCLASSPATH in the file ibmdisrv.bat to successfully migrate accounts from Exchange 5.5 or Exchange 2000. Red text below shows the documentation update.

Installing and configuring the IBM Tivoli Directory Integrator You use the IBM Tivoli Directory Integrator and the migration AssemblyLine, a particular script interpreted by the IBM Tivoli Directory Integrator, to generate migration requests. Or you can use the IBM Tivoli Directory Integrator and a coexistence AssemblyLine to generate person records in a coexisting directory for IBM Workplace Messaging.

You use the Migrate command in IBM Workplace Messaging to process migration requests.

The migration AssemblyLine inspects changes to person records in the legacy directory at a configured poll interval. The migration AssemblyLine looks for person records in the directory that have been flagged for migration. When it discovers a person record with the migration flag, the migration AssemblyLine creates a migration request and writes log information to ibmdi.log at the root directory or the directory where you installed the IBM Tivoli Directory Integrator.

Complete the following tasks to install and configure the IBM Tivoli Directory Integrator for mail migration:

1. Install IBM Tivoli Directory Integrator version 5.2 on a Windows 2000 machine by following the installation instructions on the IBM Tivoli Directory Integrator CD.

2. Set the environment PATH variable on the operating system to include the directory you installed the IBM Tivoli Directory Integrator product to. For example: C:\IBM\IBMDirectoryIntegrator.

3. Copy migration.request.jar from the \lwp.build\setup\cdSetup\coexist folder into the following directory: <drive>:\IBM\IBMDirectoryIntegrator\jars. The migration AssemblyLine uses the migration.request.jar file for generating migration requests.

4. Copy notes.jar from the \lwp.build\setup\cdSetup\coexist folder into the following directory: <drive>:\IBM\IBMDirectoryIntegrator\jars\connectors. The Domino migration AssemblyLine requires this revised version of notes.jar for generating migration requests.

5. Using a text editor, open ibmdisrv.bat located in the root directory where the IBM Tivoli Directory Integrator is installed.

6. If you are going to be connecting to an Exchange 5.5 or Exchange 2000 server, add the following files to MYCLASSPATH in ibmdisrv.bat:

migration.request.jar

g11n.lcu4j.jar

lwputil.jar

icu4j.jar

mailbox.core.res.jar

mailbox.sys.jar

olc.mapping.jar

common.mail.api.jar

7. Save the file.

106


Mozilla for Windows Mozilla for Windows has been dropped for Workplace 2.0; disregard all help system references to Mozilla for Windows.

Quota manager does not delete calendar and address book entries Once enabled, the Quota Manager does the following to enforce user disk space quota for IBM Workplace Messaging:

� Scans all active user accounts and keeps track of all accounts that exceed the warning limit (the default is 90 percent) that you define in user policies.

� Sends a e-mail notification to all user accounts that exceed the warning level. � Beginning with messages in the Trash folder, the Quota manager marks messages older than the

administrator-defined expiration limit (the default is 90 days) for deletion.� Marks only messages for deletion; calendar and address book data are unaffected.

Note A user account may continue to exceed the storage quota after Quota Manager has marked messages for deletion if the account data is younger than the expiration level.

Servers can have Mail services or SIP services, but not both The WebSphere Administrative Console Help incorrectly states that you can create a new application server with a template that provides both Mail and SIP services. This is incorrect. You can apply a Mail services template or a SIP services template only.


Some Virtual Classroom features do not apply to Learning users Lotus Virtual Classroom v1.1.1 Help makes several references to assessments. Assessments are not available in Virtual Classroom courses generated by Workplace Collaborative Learning. The topics where assessments are referred to are "About outlines," "About Lotus Virtual Classroom courses," and "Sending information to students."

Virtual Classroom v1.1.1 Help describes how you can save and retrieve whiteboard presentation files. This feature is not available in Virtual Classroom courses generated by Workplace Collaborative Learning. You can click save in the whiteboard toolbar or choose Session - Save - Whiteboard, but the file doesn't get saved anywhere. The topics where this feature is described are "Saving session information" and "Viewing saved session information." Ignore those references.

Workplace skills are different from WCL instructor skills Users may be confused by the difference between the skills that can be defined and searched in IBM Workplace (IWP) and those that can be defined and searched in IBM Workplace Collaborative Learning (WCL).

Skills defined through the IWP user interface (which are placed into the skills dictionary) are the only ones that can be searched in IWP. These skills can also be searched in a WCL user search, for example, when you click the Users tab and then click Manage Users and select an item in the User Search Skill field.

You can define another kind of skill through the WCL user interface that can only be searched in WCL. You define this kind of skill in the WCL Resources module and assign it to instructors that you define in that module. You can then search for instructors assigned that skill by clicking the Resources tab and then Manage Instructor. This kind of skill is not accessible from IWP and it is not accessible in a WCL user search: it is only relevant in an instructor search in the Resources module.

107



Help system error for "Always encrypt" and "Never encrypt" The IBM Workplace 2.0 Infocenter and the administrative console help topics contain an error.

In the "Encryption options" topics, the option "Always sign" should be "Always encrypt", and the option "Never sign" should be "Never encrypt."

Plug-in Help not provided for some client plug-ins No Help for the following plug-ins is currently provided when you click Help --> About IBM WorkPlace, then click Plug-in Details, select the plug-in from the list, and click More Info:

com.IBM_pdm_1.0.1com.IBM.rcp.systemtray_1.1.0com.IBM.rcp.jsse_1.1.0

The About This Content window contains only the text "TBD".

Security

Enabling non-wpsadmins to manage client certificates To enable a user who is not a member of the wpsadmins group to manage certificates in the Workplace Client Certificate Store, perform the following steps:

1. Login to the WebSphere Administrative Console as an Administrator.

2. Select Applications > Enterprise Applications.

3. Click A_LWP_Infrastructure.

4. Under Additional Properties, click "Map security roles to users/groups."

5. Note that the PKIAdmin role already has a mapped group: wpsadmins. This entry allows members of this group to perform the stated certificate functions.

6. Check the PKIAdmin role & then click "Lookup users."

7. Enter a Search String to find the LDAP user(s) you want to add & then click Search.

8. Select the desired user(s), then click the right arrow button to copy them to the Selected list.

9. Click OK when all desired users have been added for this role.

10. Click OK on the "Map roles" page when done adding all users.

11. Click Save, Save to commit the changes.

12. Restart the WebSphere_Portal server process to initiate the changes.

Error in "Configuring the IBM HTTP server to use a certificate" The Information Center topic "Configuring the IBM HTTP server to use a certificate" instructs you to include the following line in the httpd.conf file as part of the set-up:

SSLCacheDisable

Note that this line should only be added if you are using Linux. If you are setting up security in a Windows environment, do not include this line in the httpd.conf file or you will not be able to start the HTTP server.

108


Update to "Securing the network for IBM Workplace" topic The following steps: #11, #12, and #13 are not required to secure the network for IBM Workplace version 2.0. In fact, performing step #12 may cause problems running IBM Workplace; do not perform step #12.

11. Change the value of the plugin_customization.com.ibm.workplace.configuration/defaulturl in the following property file, which is set by default to connect through HTTP, to connect via HTTPS. For example, change the value from:

plugin_customization.com.ibm.workplace.configuration/defaulturl=http://lemur.lotus.com/lwp/myworkplace/MyS tuff

to

plugin_customization.com.ibm.workplace.configuration/defaulturl=https://lemur.lotus.com/lwp/myworkplace/My Stuff

� <was_root>/installedApps/cell/wctInstall.ear/wctinstall.war/pluginvalues.props

12. Set the pdmWpcpUrl parameter in the PDM portlet to https://<servername>/wps/wcp by following these steps:

� Navigate to https://<servername>/lwp/workplace and log in as an Administrator. � Click Administration. � Select the Portlets tab, and then Manage Portlets. � In the window for Portlets, select Documents. � Click Modify Parameters (wrench icon). � In the Edit Parameters field, enter "pdmWpcpUrl" and for the Value, enter "https://<servername>/wps/wcp." � Click Add (plus sign icon). � Click Save at the bottom of the page. � Log out.

13. Configure the browser to use the SSL protocol instead of SSLv3. This setting is required for the SSL repertoire that the Channel Framework uses for Instant Messaging.

The following step, #9, in the procedure for setting up network security requires an update.

9. Change the value of wpcp.serverUrl in the following properties files, which are set by default to connect through HTTP, to connect via HTTPS. For example, change the wpcp.serverUrl values from wpcp.serverUrl=http://server.yourco.com/lwp/wcp to wpcp.serverUrl=https://server.yourco.com/lwp/wcp: � <was_root>/properties/lwpdiscussion.properties � <was_root>/properties/lwppdmadapter.properties � <was_root>/properties/lwptaistorage.properties � <was_root>/properties/lwpteamtasklist.properties

You should change the protocol of the URL specified in the following properties files in addition to those listed above: � <was_root>/properties/lwpagenda.properties � <was_root>/properties/lwpchatroom.properties � <was_root>/properties/lwpformsadapter.properties

If you have the MyDocs rich client product configured and are connecting to the server using an SSL connection, but are finding that no libraries are displaying the MyDocs view, create a properties file called pcmconfig.properties in your home directory. (Find your home directory by launching a command prompt window and entering echo %USERPROFILE%. A home directory, such as C:\Documents and Settings\mrobinson is returned.) Enter the following text in the pcmconfig.properties text file: pcm.url=https://<servername>:9081/lwp/wcp Replace <servername> with the name of your server. ie pcm.url=https://ashe.acme.com:9081/lwp/wcp

109


Updates to "Importing a certificate into the WAS trust stores" The following steps: #4 and #9 in the procedure for importing a certificate into the WebSphere Application Server trust stores require an update. The blue text should be added to them.

Step #4 should say: Use the IKEYMAN utility that ships with the WebSphere Application Server (<WAS Root>\bin\ikeyman.ba) instead of the IBM HTTP Server utility to import the certificate into the WebSphere Application Server trust file, by selecting Signer Certificates, and then clicking Add.

Step #9 should say: Import the certificate into the WebSphere Application Server Java 1.4.1 trust file by issuing the following command:

java/jre/bin/keytool -import -file [CERTIFICATE] -keystore java141/jre/lib/security/cacerts -alias [CERTIFICATE ALIAS] -trustcacerts

where java/jre/bin/keytool is a command and java141/jre/lib/security/cacerts is a file that resides in the <WAS Root>\workplaceserver directory.

IBM Workplace Portlet Help

Application Membership help refers to team spaces Chat Room and Discussion applications have Membership portlets associated with them. The Membership portlet help in Chat Room and Discussion applications refers to team space membership.

Chat Room or Discussion portlets are part of team spaces created from the Team Project template. However, they can also be individual applications outside a team space. In that context - when they are individual applications - the help is incorrect. It should not refer to team spaces.

Chat Room Archives Help doesn't open In a Chat Room portlet, click the Archives tab, then click "?"; nothing opens. For archive help click the Chat tab, then click Help. All Chat Room Help, including archiving help is in the Help document that opens from the Chat tab.

Mail and rich text editor keystrokes The Compose Message Help page should contain the following information about using the rich text editor's accessibility toolbars and dialog boxes. � To use the pop-up toolbar, press Ctrl+Shift+M. � To use the foreground color picker, press Ctrl+Shift+G. � To use the background color picker, press Ctrl+Shift+J. � To use the insert table dialog box, press Ctrl+Shift+T.

Web conference templates are not customizable The portlet help provides tips and instructions for editing a Web Conference template. Web conferences are not customizable in this release.

110


Wildcard (*) character in People Finder and Directory Search The "Searching guidelines" that appear in the help for People Finder and Directory Search should contain this additional item:

� You can type an asterisk (*) as a wildcard character in the Search field in either People Finder or Directory Search. Type the character only as part of a name, not by itself. For example, you could type Joh*ns*n to find the names Johansen, Johnson, and Johonsen, and other names like them.

Typing a wildcard (*) in the Search field in Directory Search can make the search very slow because of support for online awareness.


Approval process for an Approver If you elect to have 'Approver' approval, this provides you with the ability to have someone other than the manager Approve enrollments. This approval level is equal to that of the Manager; it is not a second level of approval.

IBM Workplace Rich Client Help


Accessibility, Keyboard commands - Help update The "Accessibility" topic should contain the following, additional information:

Windows StickyKeys is supported in IBM Worklplace rich client. Select the option Press modifier key twice to lock in the Settings for StickyKeys dialog box. Once this is selected, you can press the modifier key twice and then click the appropriate keyboard command.

The "Keyboard commands" topic should contain the following, additional information:

SHIFT+F10 exposes the context menu in the preview pane, but you can't manuever up or down to the items in the menu with the keyboard. Press TAB, then DOWN ARROW to move focus to the context menu to navigate.

Emulator icon not available in this release In the Help topic "Navigating IBM Workplace rich client," there is a screenshot of IBM Workplace rich client that shows an icon for the 3270 Emulator on the Switcher bar. The 3270 Emulator is not a feature in this release.

111


Mail Help issues Following are the issues using Mail Help:

� The topic "Opening a message" should include the following procedure for resizing the preview pane using the keyboard:

1. Press Alt+Hyphen. 2. Using the Arrow keys, select Size > Bottom. 3. Press the Up or Down arrow to resize the preview pane. 4. Press Esc to exit focus.

� The topic "Creating a new message" describes how to attach files from your local machine. You can also attach documents from a document library that you have access to. To attach a file from a document library, click the arrow beside Attach, and then click Attach from Document Library. Select the document to attach from a document library, and then click OK.

� The topic "Opening a folder" states that you can display the contents of more than one folder at a time by clicking the folder name, and then clicking File > Open in New Tab. There is a bug with this feature. Following this task will replace the display of the currently opened folder, and then open a duplicate copy of the same folder that you are trying to open in a new tab. For example, if you have your Inbox open and want to also display Drafts in a new tab, the procedure above will replace the Inbox display with Drafts and then open Drafts in a second tab.

� The topic "Working with attachments" states that your administrator must allow you to launch executable files. This is incorrect. File types that will open directly from the rich client are JPG, BMP, GIF, PDF, TXT, SXI, SXC, SXW. All other file types must be saved locally to your computer to be opened.

� The topic "Using Chat to reply to a message" states to click the arrow next to Reply, and then click Reply Using Chat. This is incorrect. The correct option to click is Reply with Chat.

Stand-alone document editor file commands When you launch a stand-alone document editor, you can choose the following commands (which are not included in Help) from the File menu:

�� Save as saves an open file with a new file name or path that you specify to a local directory.�� New creates a new file in the document editor.�� Open opens an existing file that you select in the document editor.


Disable/Enable setting on a control This is an update for the Data access designer Help topic, "Changing the availability of a control or decoration."

Click inside a control, and then click the Basics tab in the attributes editor. Selecting or deselecting Enabled is data specific, not control specific. Setting a control to disabled (deselecting Enabled), changes the flag on the data bind element, which means that all controls bound to that data element will inherit its enablement setting.

Using relationships - Help correction The Help topic "Using relationships" states:

A relationship is made between two tables by matching the foreign key column in the target table to the primary key column in the source table.

Correction: A relationship is made between two tables by matching the foreign key column in the source table to the primary key column in the target table.

IBM data access tool only has support for the above kind of relationship while creating forms, grids, and reports.

112


Using values defined from table columns - Help correction The following procedure is a correction to the topic "Creating the list for a list box, combination box, and radio button group."

To use values from a table that you define, select Values defined from table columns from the Choose selection method drop-down menu. Then follow these steps:

1. Click Add Columns to select the tables and columns that you want to use for the Select table and Select label drop-down list.You can also set a filter condition on the Filters page of the wizard launched using the Add Columns button, which allows filtering of data populated in the control.

2. Select a column value from the list of columns.

3. To display a label for the selected column value, which appears instead of the value, select Select label, and then select the label from the label table.

113


Notices and Trademarks

Notices

Copyright notices and information regarding non-IBM software Excluded Components Your use of the "Excluded Components" listed below is subject to the terms of the agreement by which you are licensed to use the Program (e.g., the IBM International Program License Agreement and accompanying License Information Document), subject to the Excluded Components provision of the License Information Document. Pursuant to the licenses under which IBM has obtained the Excluded Components, IBM is required to provide the following copyright notices and information. The following copyright notices and information do not add, modify, or change the terms pursuant to which you have licensed the Program.

1. Open Office:The Program includes portions of code from the OpenOffice.org project.

The source code version of the original OpenOffice.org code is available under the terms of this Sun Industry Standards Source License version ("SISSL") at http://www.openoffice.org.

2. MATH.DTD Component W3C (R) SOFTWARE NOTICE AND LICENSE http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231

This work (and included software, documentation such as READMEs, or other related items) is being provided by the copyright holders under the following license. By obtaining, using and/or copying this work, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions.

Permission to copy, modify, and distribute this software and its documentation, with or without modification, for any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies of the software and documentation or portions thereof, including modifications:

1. The full text of this NOTICE in a location viewable to users of the redistributed or derivative work.

2. Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, the W3C Software Short Notice should be included (hypertext is preferred, text is permitted) within the body of any redistributed or derivative code.

3. Notice of any changes or modifications to the files, including the date changes were made. (We recommend you provide URLs to the location from which the code is derived.)

THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS. COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.

The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to the software without specific, written prior permission. Title to copyright in this software and any associated documentation will at all times remain with copyright holders.

115


3. BitStream Vera Fonts Copyright (C) 2003 by Bitstream, Inc. All Rights Reserved. Bitstream Vera is a trademark of Bitstream, Inc.

Permission is hereby granted, free of charge, to any person obtaining a copy of the fonts accompanying this license ("Fonts") and associated documentation files (the "Font Software"), to reproduce and distribute the Font Software, including without limitation the rights to use, copy, merge, publish, distribute, and/or sell copies of the Font Software, and to permit persons to whom the Font Software is furnished to do so, subject to the following conditions:

- The above copyright and trademark notices and this permission notice shall be included in all copies of one or more of the Font Software typefaces.

- The Font Software may be modified, altered, or added to, and in particular the designs of glyphs or characters in the Fonts may be modified and additional glyphs or characters may be added to the Fonts, only if the fonts are renamed to names not containing either the words "Bitstream" or the word "Vera".

- This License becomes null and void to the extent applicable to Fonts or Font Software that has been modified and is distributed under the "Bitstream Vera" names.

- The Font Software may be sold as part of a larger software package but no copy of one or more of the Font Software typefaces may be sold by itself.

THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL BITSTREAM OR THE GNOME FOUNDATION BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE FONT SOFTWARE.

Except as contained in this notice, the names of Gnome, the Gnome Foundation, and Bitstream Inc., shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Font Software without prior written authorization from the Gnome Foundation or Bitstream Inc., respectively. For further information, contact: fonts at gnome dot org.

4. Freetype 2.1.4 Portions of this software are copyright © 1996-2002 The FreeType Project (www.freetype.org). All rights reserved.

5. ICU 2.2 International Components for Unicode (ICU) v. 2.0 & later

COPYRIGHT AND PERMISSION NOTICE

Copyright (C) 1995-2001 International Business Machines Corporation and others. All rights reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, provided that the above copyright notice(s) and this permission notice appear in all copies of the Software and that both the above copyright notice(s) and this permission notice appear in supporting documentation.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder.

116


6. JPEG 6b This software is based in part on the work of the Independent JPEG Group.

Independent JPEG Group (IJG) IJG JPEG Library

This software is Copyright (C) 1991-1998, Thomas G. Lane. All Rights Reserved except as specified below.

7. XSLT4J, XML4C and Apache Jakarta Commons HttpClient Apache License Version 2.0, January 2004 http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.

"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.

117


3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:

(a) You must give any other recipients of the Work or Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.

You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions.

Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.

118


9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

8. Expat http://www.jclark.com/xml/copying.txt Copyright (C) 1998, 1999, 2000 Thai Open Source Software Center Ltd

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

9. Portions of Info-Zip Copyright (C) 1990-2003 Info-ZIP. All rights reserved.

This software is provided "as is," without warranty of any kind, express or implied. In no event shall Info-ZIP or its contributors be held liable for any direct, indirect, incidental, special or consequential damages arising out of the use of or inability to use this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

1. Redistributions of source code must retain the above copyright notice, definition, disclaimer, and this list of conditions.

2. Redistributions in binary form (compiled executables) must reproduce the above copyright notice, definition, disclaimer, and this list of conditions in documentation and/or other materials provided with the distribution. The sole exception to this condition is redistribution of a standard UnZipSFX binary (including SFXWiz) as part of a self-extracting archive; that is permitted without inclusion of this license, as long as the normal SFX banner has not been removed from the binary or disabled.

3. Altered versions--including, but not limited to, ports to new operating systems, existing ports with new graphical interfaces, and dynamic, shared, or static library versions--must be plainly marked as such and must not be misrepresented as being the original source. Such altered versions also must not be misrepresented as being Info-ZIP releases--including, but not limited to, labeling of the altered versions with the names "Info-ZIP" (or any variation thereof, including, but not limited to, different capitalizations), "Pocket UnZip," "WiZ" or "MacZip" without the explicit permission of Info-ZIP. Such altered versions are further prohibited from misrepresentative use of the Zip-Bugs or Info-ZIP e-mail addresses or of the Info-ZIP URL(s).

4. Info-ZIP retains the right to use the names "Info-ZIP," "Zip," "UnZip," "UnZipSFX," "WiZ," "Pocket UnZip," "Pocket Zip," and "MacZip" for its own source and binary releases.

119


10. Log4J, STRUTS, AXIS SOAP, Crimson XML Processor, JSTL, Ant 1.5.1, XSLT4C, XML4J The Apache Software License, Version 1.1 Copyright (C) 2002 The Apache Software Foundation. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

3. The end-user documentation included with the redistribution, if any, must include the following acknowledgment:

"This product includes software developed by the Apache Software Foundation (http://www.apache.org/)."

Alternately, this acknowledgment may appear in the software itself, if and wherever such third-party acknowledgments normally appear.

4. The names "Apache " and "Apache Software Foundation" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact [email protected].

5. Products derived from this software may not be called "Apache", nor may "Apache" appear in their name, without prior written permission of the Apache Software Foundation.

THIS SOFTWARE IS PROVIDED `ÀS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Regarding XML4J, XML4J ships W3C interfaces. The W3C requires a reference to its standard W3C Software Notice and License, which is either printed herein and/or can be found at http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231

11. JDOM Copyright (C) 2000-2002 Brett McLaughlin & Jason Hunter. All rights reserved.


1. Redistributions of source code must retain the above copyright notice, this list of conditions, and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions, and the disclaimer that follows these conditions in the documentation and/or other materials provided with the distribution.

3. The name "JDOM" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact [email protected].

4. Products derived from this software may not be called "JDOM", nor may "JDOM" appear in their name, without prior written permission from the JDOM Project Management ([email protected]).

"This product includes software developed by the JDOM Project (http://www.jdom.org/)."

THIS SOFTWARE IS PROVIDED `ÀS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

120


12. Archive Accessor The ArchiveAccessor Bean Suite uses The Open Group Research Institute MoaJar API to work with JAR files and an extended version of this API to work with ZIP files. As such, The Open Group requires publication of the following statement:

Copyright (C) 1997 The Open Group

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appears in all copies and that both the copyright notice and this permission notice appear in supporting documentation, and that the name of ("TOG") or the Open Group is not used in advertising or publicity pertaining to distribution of the software without specific, written prior permission.

THE OPEN GROUP DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL TOG BE LIABLE FOR ANY SPECIAL, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN ACTION OF CONTRACT, NEGLIGENCE, OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

The Open Group Research Institute MoaJar (unencumbered) 3/20/1997

13. Jaxen License Copyright (C) 2000-2002 bob mcwhirter & James Strachan. All rights reserved.




3. The name "Jaxen" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact [email protected].

4. Products derived from this software may not be called "Jaxen", nor may "Jaxen" appear in their name, without prior written permission from the Jaxen Project Management ([email protected]).

In addition, we request (but do not require) that you include in the end-user documentation provided with the redistribution and/or in the software itself an acknowledgement equivalent to the following:

"This product includes software developed by the Jaxen Project (http://www.jaxen.org/)."

Alternatively, the acknowledgment may be graphical using the logos available at http://www.jaxen.org/

THIS SOFTWARE IS PROVIDED `ÀS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE Jaxen AUTHORS OR THE PROJECT CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

14. Saxpath License Copyright (C) 2000-2002 werken digital. All rights reserved.




121


3. The name "SAXPath" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact [email protected].

4. Products derived from this software may not be called "SAXPath", nor may "SAXPath" appear in their name, without prior written permission from the SAXPath Project Management ([email protected]).

In addition, we request (but do not require) that you include in the end-user documentation provided with the redistribution and/or in the software itself an acknowledgement equivalent to the following:

"This product includes software developed by the SAXPath Project (http://www.saxpath.org/)."

Alternatively, the acknowledgment may be graphical using the logos available at http://www.saxpath.org/

THIS SOFTWARE IS PROVIDED `ÀS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE SAXPath AUTHORS OR THE PROJECT CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

15. GTK + Bindings GNU Lesser General Public License Version 2.1, February 1999 Copyright (C) 1991, 1999 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

The source code version of GTK + Bindings is available under the terms of the GNU Lesser General Public License at http://www.eclipse.org.

Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. [This is the first released version of the Lesser GPL. It also counts as the successor of the GNU Library Public License, version 2, hence the version number 2.1.]

PREAMBLE The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public Licenses are intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users.

This license, the Lesser General Public License, applies to some specially designated software packages--typically libraries--of the Free Software Foundation and other authors who decide to use it. You can use it too, but we suggest you first think carefully about whether this license or the ordinary General Public License is the better strategy to use in any particular case, based on the explanations below.

When we speak of free software, we are referring to freedom of use, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish); that you receive source code or can get it if you want it; that you can change the software and use pieces of it in new free programs; and that you are informed that you can do these things.

To protect your rights, we need to make restrictions that forbid distributors to deny you these rights or to ask you to surrender these rights. These restrictions translate to certain responsibilities for you if you distribute copies of the library or if you modify it.

For example, if you distribute copies of the library, whether gratis or for a fee, you must give the recipients all the rights that we gave you. You must make sure that they, too, receive or can get the source code. If you link other code with the library, you must provide complete object files to the recipients, so that they can relink them with the library after making changes to the library and recompiling it. And you must show them these terms so they know their rights.

We protect your rights with a two-step method: (1) we copyright the library, and (2) we offer you this license, which gives you legal permission to copy, distribute and/or modify the library.

To protect each distributor, we want to make it very clear that there is no warranty for the free library. Also, if the library is modified by someone else and passed on, the recipients should know that what they have is not the original version, so that the original author's reputation will not be affected by problems that might be introduced by others.

122


Finally, software patents pose a constant threat to the existence of any free program. We wish to make sure that a company cannot effectively restrict the users of a free program by obtaining a restrictive license from a patent holder. Therefore, we insist that any patent license obtained for a version of the library must be consistent with the full freedom of use specified in this license.

Most GNU software, including some libraries, is covered by the ordinary GNU General Public License. This license, the GNU Lesser General Pubic License, applies to certain designated libraries, and is quite different from the ordinary General Public License. We use this license for certain libraries in order to permit linking those libraries into non-free programs.

When a program is linked with a library, whether statically or using a shared library, the combination of the two is legally speaking a combined work, a derivative of the original library. The ordinary General Public License therefore permits such linking only if the entire combination fits its criteria of freedom. The Lesser General Public License permits more lax criteria for linking other code with the library.

We call this license the "Lesser" General Public License because it does Less to protect the user's freedom than the ordinary General Public License. It also provides other free software developers Less of an advantage over competing non-free programs. These disadvantages are the reason we use the ordinary General Public License for many libraries. However, the Lesser license provides advantages in certain special circumstances.

For example, on rare occasions, there may be a special need to encourage the widest possible use of a certain library, so that it becomes a de-facto standard. To achieve this, non-free programs must be allowed to use the library. A more frequent case is that a free library does the same job as widely used non-free libraries. In this case, there is little to gain by limiting the free library to free software only, so we use the Lesser General Public License.

In other cases, permission to use a particular library in non-free programs enables a greater number of people to use a large body of free software. For example, permission to use the GNU C Library in non-free programs enables many more people to use the whole GNU operating system, as well as its variant, the GNU/Linux operating system.

Although the Lesser General Public License is Less protective of the users' freedom, it does ensure that the user of a program that is linked with the Library has the freedom and the wherewithal to run that program using a modified version of the Library.

The precise terms and conditions for copying, distribution and modification follow. Pay close attention to the difference between a "work based on the library" and a "work that uses the library". The former contains code derived from the library, whereas the latter must be combined with the library in order to run.

GNU LESSER GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License Agreement applies to any software library or other program which contains a notice placed by the copyright holder or other authorized party saying it may be distributed under the terms of this Lesser General Public License (also called "this License"). Each licensee is addressed as "you".

A "library" means a collection of software functions and/or data prepared so as to be conveniently linked with application programs (which use some of those functions and data) to form executables.

The "Library", below, refers to any such software library or work which has been distributed under these terms. A "work based on the Library" means either the Library or any derivative work under copyright law: that is to say, a work containing the Library or a portion of it, either verbatim or with modifications and/or translated straightforwardly into another language. (Hereinafter, translation is included without limitation in the term "modification".)

"Source code" for a work means the preferred form of the work for making modifications to it. For a library, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the library.

Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running a program using the Library is not restricted, and output from such a program is covered only if its contents constitute a work based on the Library (independent of the use of the Library in a tool for writing it). Whether that is true depends on what the Library does and what the program that uses the Library does.

1. You may copy and distribute verbatim copies of the Library's complete source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and distribute a copy of this License along with the Library.

You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee.

123


2. You may modify your copy or copies of the Library or any portion of it, thus forming a work based on the Library, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions:

a) The modified work must itself be a software library.

b) You must cause the files modified to carry prominent notices stating that you changed the files and the date of any change.

c) You must cause the whole of the work to be licensed at no charge to all third parties under the terms of this License.

d) If a facility in the modified Library refers to a function or a table of data to be supplied by an application program that uses the facility, other than as an argument passed when the facility is invoked, then you must make a good faith effort to ensure that, in the event an application does not supply such function or table, the facility still operates, and performs whatever part of its purpose remains meaningful.

(For example, a function in a library to compute square roots has a purpose that is entirely well-defined independent of the application. Therefore, Subsection 2d requires that any application-supplied function or table used by this function must be optional: if the application does not supply it, the square root function must still compute square roots.)

These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Library, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Library, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it.

Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Library.

In addition, mere aggregation of another work not based on the Library with the Library (or with a work based on the Library) on a volume of a storage or distribution medium does not bring the other work under the scope of this License.

3. You may opt to apply the terms of the ordinary GNU General Public License instead of this License to a given copy of the Library. To do this, you must alter all the notices that refer to this License, so that they refer to the ordinary GNU General Public License, version 2, instead of to this License. (If a newer version than version 2 of the ordinary GNU General Public License has appeared, then you can specify that version instead if you wish.) Do not make any other change in these notices.

Once this change is made in a given copy, it is irreversible for that copy, so the ordinary GNU General Public License applies to all subsequent copies and derivative works made from that copy.

This option is useful when you wish to copy part of the code of the Library into a program that is not a library.

4. You may copy and distribute the Library (or a portion or derivative of it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange.

If distribution of object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place satisfies the requirement to distribute the source code, even though third parties are not compelled to copy the source along with the object code.

5. A program that contains no derivative of any portion of the Library, but is designed to work with the Library by being compiled or linked with it, is called a "work that uses the Library". Such a work, in isolation, is not a derivative work of the Library, and therefore falls outside the scope of this License.

However, linking a "work that uses the Library" with the Library creates an executable that is a derivative of the Library (because it contains portions of the Library), rather than a "work that uses the library". The executable is therefore covered by this License. Section 6 states terms for distribution of such executables.

When a "work that uses the Library" uses material from a header file that is part of the Library, the object code for the work may be a derivative work of the Library even though the source code is not. Whether this is true is especially significant if the work can be linked without the Library, or if the work is itself a library. The threshold for this to be true is not precisely defined by law.

124


If such an object file uses only numerical parameters, data structure layouts and accessors, and small macros and small inline functions (ten lines or less in length), then the use of the object file is unrestricted, regardless of whether it is legally a derivative work. (Executables containing this object code plus portions of the Library will still fall under Section 6.)

Otherwise, if the work is a derivative of the Library, you may distribute the object code for the work under the terms of Section 6. Any executables containing that work also fall under Section 6, whether or not they are linked directly with the Library itself.

6. As an exception to the Sections above, you may also combine or link a "work that uses the Library" with the Library to produce a work containing portions of the Library, and distribute that work under terms of your choice, provided that the terms permit modification of the work for the customer's own use and reverse engineering for debugging such modifications.

You must give prominent notice with each copy of the work that the Library is used in it and that the Library and its use are covered by this License. You must supply a copy of this License. If the work during execution displays copyright notices, you must include the copyright notice for the Library among them, as well as a reference directing the user to the copy of this License. Also, you must do one of these things:

a) Accompany the work with the complete corresponding machine-readable source code for the Library including whatever changes were used in the work (which must be distributed under Sections 1 and 2 above); and, if the work is an executable linked with the Library, with the complete machine-readable "work that uses the Library", as object code and/or source code, so that the user can modify the Library and then relink to produce a modified executable containing the modified Library. (It is understood that the user who changes the contents of definitions files in the Library will not necessarily be able to recompile the application to use the modified definitions.)

b) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (1) uses at run time a copy of the library already present on the user's computer system, rather than copying library functions into the executable, and (2) will operate properly with a modified version of the library, if the user installs one, as long as the modified version is interface-compatible with the version that the work was made with.

c) Accompany the work with a written offer, valid for at least three years, to give the same user the materials specified in Subsection 6a, above, for a charge no more than the cost of performing this distribution.

d) If distribution of the work is made by offering access to copy from a designated place, offer equivalent access to copy the above specified materials from the same place.

e) Verify that the user has already received a copy of these materials or that you have already sent this user a copy.

For an executable, the required form of the "work that uses the Library" must include any data and utility programs needed for reproducing the executable from it. However, as a special exception, the materials to be distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable.

It may happen that this requirement contradicts the license restrictions of other proprietary libraries that do not normally accompany the operating system. Such a contradiction means you cannot use both them and the Library together in an executable that you distribute.

7. You may place library facilities that are a work based on the Library side-by-side in a single library together with other library facilities not covered by this License, and distribute such a combined library, provided that the separate distribution of the work based on the Library and of the other library facilities is otherwise permitted, and provided that you do these two things:

a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities. This must be distributed under the terms of the Sections above.

b) Give prominent notice with the combined library of the fact that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work.

8. You may not copy, modify, sublicense, link with, or distribute the Library except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, link with, or distribute the Library is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.

125


9. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Library or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Library (or any work based on the Library), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Library or works based on it.

10. Each time you redistribute the Library (or any work based on the Library), the recipient automatically receives a license from the original licensor to copy, distribute, link with or modify the Library subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties with this License.

11. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Library at all. For example, if a patent license would not permit royalty-free redistribution of the Library by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Library. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply, and the section as a whole is intended to apply in other circumstances.

It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice.

This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License.

12. If the distribution and/or use of the Library is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Library under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License.

13. The Free Software Foundation may publish revised and/or new versions of the Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.

Each version is given a distinguishing version number. If the Library specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Library does not specify a license version number, you may choose any version ever published by the Free Software Foundation.

14. If you wish to incorporate parts of the Library into other free programs whose distribution conditions are incompatible with these, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally.

NO WARRANTY 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

END OF TERMS AND CONDITIONS

126


How to Apply These Terms to Your New Libraries

If you develop a new library, and you want it to be of the greatest possible use to the public, we recommend making it free software that everyone can redistribute and change. You can do so by permitting redistribution under these terms (or, alternatively, under the terms of the ordinary General Public License).

To apply these terms, attach the following notices to the library. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found.

<one line to give the library's name and a brief idea of what it does.> Copyright (C) <year> <name of author>

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. Also add information on how to contact you by electronic and paper mail. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample; alter the names:

Yoyodyne, Inc., hereby disclaims all copyright interest in the library `Frob' (a library for tweaking knobs) written by James Random Hacker.

<signature of Ty Coon>, 1 April 1990 Ty Coon, President of Vice

That's all there is to it!

16. Boost Copyright (C) Boost.org 2001.

Permission to copy, use, modify, sell and distribute this software is granted provided this copyright notice appears in all copies. This software is provided "as is" without express or implied warranty, and with no claim as to its suitability for any purpose.

17. Hyades This product includes software developed by the Eclipse Project (http://www.eclipse.org/).

JReport - license information Congratulations on your order of IBM Lotus learning management tools. Your initial order includes the ability to

TMdownload and use up to three (3) copies of JReport Designer by Jinfonet Software, Inc. However, these copies of JReport Designer are solely for your use with Lotus learning management software, and are not for standalone use. This program allows your team to design customized and dynamic report templates to help enhance the functionality of your Lotus learning software.

To download your 3 copies of JReport Designer, please visit the exclusive IBM Lotus download site at Jinfonet’s website: www.jinfonet.com/lotuslms.htm. There you will find detailed instructions on how to download your copies of JReport Designer, along with details on how you can purchase additional licensed copies directly from Jinfonet at a discounted price from their list price. To gain access to this website, please use the following User ID and Password:

User ID: jinfoandlotusPassword: drj4ega

Thank you for commitment to IBM Lotus learning management software. We look forward to serving you! TM

JReport Server Engine copyright and trademark information Developed by Jinfonet Software, Inc. 9400 Key West Ave., Suite 250 Rockville, MD 20850 www.jinfonet.com Copyright (c) 1998-2003, Jinfonet Software, Inc. All rights reserved.

127


Trademarks

Trademark list IBM, the IBM logo, AIX, Cloudscape, DB2, DB2 Universal Database, developerWorks, Domino, eServer, Freelance Graphics, iSeries, i5/OS, Lotus, Lotus Notes, Notes, Passport Advantage, pSeries, Redbooks, Sametime, SecureWay, Tivoli, WebSphere, Workplace, z/OS, and zSeries are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both.

Intel and Pentium are trademarks of Intel Corporation in the United States, other countries, or both.

Microsoft, Windows, and Windows NT are registered trademarks of Microsoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

128