Workplace Collaboration Services

Version 2.6.1

???IbMr

Release Notes

G325-2619-00

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

First Edition (September, 2006)

This edition applies to IBM® WorkplaceTM Collaboration Services 2.6.1, and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright International Business Machines Corporation 1994, 2006. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Chapter 1 - About this release ............................................................................. 1New in this release..................................................................................................................... 1

Introducing IBM Workplace Designer .................................................................................. 1IBM data access tool ........................................................................................................... 3Notes Application plug-in for IBM Workplace Managed Client ............................................ 4i5/OS: Platform now supported............................................................................................ 6Release note information for WebSphere Portal available online ....................................... 6Technical preview................................................................................................................ 6

Technical preview features ........................................................................................... 6Tech Preview features are not supported by Customer Support .................................. 7

Product compatibility .................................................................................................................. 7Composing rich text e-mail messages using a screen reader............................................. 7Instant messaging interoperability with Sametime .............................................................. 8

Chapter 2 - Installation, migration, upgrade, and configurationinformation ............................................................................................................ 9

Installation notes ........................................................................................................................ 9Planning and requirements.................................................................................................. 9

Configuring Mail Services for Cloudscape .................................................................... 9Prerequisite installation information .............................................................................. 10User limit when Cloudscape is user registry ................................................................. 10

Preparing the environment .................................................................................................. 11Increasing the stack size for DB2 ................................................................................. 11

Installing IBM Workplace Collaboration Services ................................................................ 11Corrupted block characters display in the Config Wizard UI ......................................... 11Installer reports that RedHat 3.x is not supported......................................................... 12Learning server: 2.6.1 dbbuild.properties has blank passwords ................................... 12Restart server after disconnecting a node from the network ........................................ 12Use English install path for Chinese installation ........................................................... 13Use of non-ASCII in the Admin fields causes failures ................................................... 13WCS does not completely uninstall from the Deployment Manager ............................. 13Workaround for installing with Self -Voicing Runtime Environment .............................. 13

Connecting to an LDAP directory ........................................................................................ 14Application group membership can block individual access ......................................... 14Can’t install Managed Client with IIS HTTP server ....................................................... 14Cannot log on if LDAP server is restarted or network goes down ................................ 14Creation of applications can take longer than expected ............................................... 15Disabling security fails when Turkish is the language ................................................... 15LDAP user and group filters can inadvertently change................................................. 15Self-registration can fail with network deployment of LDAP ......................................... 16Self-registration should be hidden with read -only LDAP.............................................. 16User login problem when names contain special characters ........................................ 16

Connecting to a DBMS server ............................................................................................. 17Clear or encode passwords written at config steps ...................................................... 17

Completing external HTTP server setup ............................................................................. 17Configuring the Managed Client to use non -standard HTTP ports .............................. 17HTTP tunnel cluster base URL is hardcoded ................................................................ 18

Completing Collaborative Learning setup............................................................................ 18Learning uses the uid attribute to authenticate user in LDAP ....................................... 18

Installing the Managed Client provisioning server ............................................................... 18

Applet not able to detect existing running instance of download .................................. 18Console mode provisioning server install and relative path .......................................... 19Credential Store error when importing a certificate ....................................................... 19Directory location change for download applet wctpinstall -temp ................................. 19Do not select "Work Offline" during client initialization.................................................. 20Download link will not auto install if JRE is not installed ............................................... 20Empty directories left after uninstall .............................................................................. 21Errors when using provisioning server install Custom option ....................................... 21Failover is not supported when provisioning using the WEDM ..................................... 22HTTP server directories for Managed Client read, execute access.............................. 22Incorrect Custom install summary message ................................................................. 22Install provisioning server from e -image - unpacking ................................................... 22Interrupting the installation /provisioning of the Managed Client .................................. 23Managed Client install problems when path contains Unicode ..................................... 23Managed Client installation program does not support bi -di ........................................ 23Missing Accelerator keys in provisioning components install ....................................... 23Multiple RCPINSTALL.Properties created changing install paths ................................ 23No status message after cancelling provisioning server install ..................................... 24Providing a trusted root certificate to users................................................................... 24Provisioning component uninstall leaves log files ......................................................... 24Provisioning from en_US in a non-US/non-English operating system.......................... 24Provisioning server install panel display in Romanian locale........................................ 25Provisioning server installation filepath cannot contain spaces .................................... 25Provisioning URL wrong for IEOP installation............................................................... 25Repackage of wps.ear reports a warning in repackageWpsEarLog .txt ....................... 25Root or super user login causes inability to provision from CD .................................... 25Salvaging a user’s workspace after an uninstall ........................................................... 26Some provisioning server installation fields are hard -coded........................................ 27Spaces are not allowed in Workplace Managed Client install ...................................... 27Special characters in directory name cause failed CD install ....................................... 28Specifying an install location for the Managed Client ................................................... 28Uninstall icons are different with each install ................................................................ 28Unsupported Managed Client offering policy configurations ......................................... 28User access rights required for Managed Client installation ......................................... 29WAS server name field value for provisioning server installation ................................. 29

Completing Network Deployment setup .............................................................................. 30Enabling Web conferences to work behindi a reverse proxy ........................................ 30Instant messaging does not work in a horizontal cluster .............................................. 31ND: Mixed OS for Search share causes indexing to fail ............................................... 31

Installing IBM Workplace Managed Client ........................................................................... 31CD-based install using -silent option fails ..................................................................... 31CD installation and directory with percent sign causes problems ................................. 31serial.multiuser: Administrator installs and provisions client ......................................... 32serial.multiuser: Check for updates cannot find file ...................................................... 32serial.multiuser: Shortcut and Program menu for current user ..................................... 32serial.multiuser: Uninstall and preserving workspace fails............................................ 33Trust certificate time-out exits client installation ............................................................ 33Users require write access to install directory............................................................... 33

AIX, Linux, and Solaris: Installation notes .................................................................................. 33

Preparing the environment .................................................................................................. 33Linux: Enterprise Edition v5.0 for Network Deployment may fail .................................. 33Linux: Workaround for installing DB2 on Red Hat 3.0 .................................................. 34AIX, Linux: Linking to a JDK that was not installed by DB 2 ......................................... 34

Installing IBM Workplace Collaboration Services ................................................................ 35AIX, Linux, Solaris: " Launch Getting Started" link fails ................................................ 35Error messages during AIX console install ................................................................... 35

Completing Collaborative Learning setup............................................................................ 36Reports not running on Linux, Solaris or AIX ................................................................ 36

Installing the Managed Client provisioning server ............................................................... 36After provisioning, client does not always restart automatically .................................... 36Installing provisioning server on UNIX .......................................................................... 36Linux - Can’t download client from provisioning server................................................. 37Linux - Mozilla bean not showing up in client installer .................................................. 37Provisioning server installation UNIX screen display settings ...................................... 37Uninstall on Linux may take over 7 minutes ................................................................. 38

Installing IBM Workplace Managed Client ........................................................................... 38Download error on UNIX caused by incorrect file permissions ..................................... 38Linux - Mozilla version and file reqs for WMC install .................................................... 38

Windows: Installation notes ....................................................................................................... 39Completing external HTTP server setup ............................................................................. 39

Learning Requirements when connected to MS IIS 5.0 HTTP Server.......................... 39Installing IBM Workplace Managed Client ........................................................................... 39

Clicking Internet Explorer Back button restarts applet download.................................. 39i5/OS: Installation notes ............................................................................................................. 40

Planning and requirements.................................................................................................. 40i5/OS: Getting started with LDAP .................................................................................. 40i5/OS: Database table partitioning not supported ......................................................... 41i5/OS: Performance issues with very large LDAP directories ....................................... 41i5/OS: Vertical clustering not supported........................................................................ 41

Installing IBM Workplace Collaboration Services ................................................................ 42i5/OS: Use the Create IBM Workplace wizard for single -server .................................. 42i5/OS: EXTMEDFMT flag must be set to *YES for DVD install ..................................... 42i5/OS: Canceling an installation .................................................................................... 42i5/OS: Console install program may not display all text ................................................ 43i5/OS: Remote database server must be added to WAS Resources ........................... 43i5/OS: Remote silent config needs added property ...................................................... 43i5/OS: Silent install may fail .......................................................................................... 44

Connecting to an LDAP directory ........................................................................................ 44i5/OS: ibm-entryUUID attribute missing in older LDAP entries ..................................... 44

Connecting to a DBMS server ............................................................................................. 48i5/OS Authorization issue if DB Admin and DB App users different ............................. 48i5/OS: Users may experience problems using Toolbox JDBC driver ............................ 51Remote i5/OS database grant failure............................................................................ 52

Completing Collaborative Learning setup............................................................................ 52i5/OS: Verify FTP attributes before using i 5/OS as FTP server ................................... 52

Installing the Managed Client provisioning server ............................................................... 53i5/OS: Custom install summary information incorrect ................................................... 53i5/OS: Enter absolute path to disk 2 if in console mode ............................................... 54

i5/OS: EXTMEDFMT flag must be set to *YES for CD/DVD install .............................. 54i5/OS: Remote install from CD is not supported ........................................................... 54i5/OS: Users must run lwpGenPluginCfg.sh script before install .................................. 55

Upgrade notes ........................................................................................................................... 56Automatic Update preference removed and functionality revised ....................................... 56Check for updates to CD or HTTP server -installed clients ................................................. 56IBM Workplace Messaging: New Mail settings in user policies ........................................... 56Upgrade produces a benign warning message ................................................................... 57Upgrading IBM Workplace Designer when upgrading to WCS 2.6 ..................................... 57Upgrading provisioning server from 2.5.1 to 2.6.................................................................. 58

Configuration notes .................................................................................................................... 63Activity Explorer: Improving server response during heavy usage ...................................... 63Domino Policies regarding IM in the Workplace client ........................................................ 64IBM Workplace Messaging: Message size default values different..................................... 65Second attempt at db transfer results in violation constraint ............................................... 66WCT_IM_USE_LOOKUP Notes.INI variable ...................................................................... 66Web Conferences and Learning are not enabled by default ............................................... 67Windows XP SP2 users must enable ActiveX scripting ...................................................... 67Workplace Mail Portlet location of temporary files............................................................... 67

Uninstallation information........................................................................................................... 69After 2.6 installs over 2.5, ’Add/Remove programs’ shows 2.5 ........................................... 69Non-English OS desktop icons not removed after uninstalling............................................ 69Productivity tools uninstall panel references WMC ............................................................. 69Uninstalling productivity tools confusion with open document............................................. 69vpd.properties file on Linux not removed by uninstall.......................................................... 69Windows: Uninstall leaves files after CD install - switch to WMC........................................ 70

Chapter 3 - Known limitations, problems, and workarounds........................... 71Limitations .................................................................................................................................. 71

Installation issues ................................................................................................................ 71Standalone tools: Update menu missing ...................................................................... 71

Configuration issues ............................................................................................................ 71i5/OS: CCSID 420 not supported .................................................................................. 71User without e-mail address gets blank page logging in ............................................... 71

Administration issues........................................................................................................... 72Dynacache requirement ................................................................................................ 72LMS server timing out users while they are taking courses .......................................... 72User Policy setting and new categories for catalogs .................................................... 72"Automatically create mailboxes" affects calendar as well............................................ 73

IBM Workplace Collaborative Learning issues .................................................................... 73Create folder with same name displays incorrect error message ................................. 73Discussions: Child documents are not deleted with parent .......................................... 73Do not use Intellexis’ close button; tracking will not work ............................................. 74Offline Client (OLC) does not work on SSL-enabled installations ................................. 74Student interface: Font size changes using Internet Explorer ...................................... 74User search may fail for names with DBCS and accented characters ......................... 74WCL does not Support Multiple Delivery Servers ......................................................... 74Wildcarding in a course search is not supported for all fields ....................................... 74

IBM Workplace Documents issues...................................................................................... 75Client-side size limitation for importing documents ....................................................... 75

Configuring Documents e-mail notification ................................................................... 75Desktop Integration messages do not appear on client terminal .................................. 75Documents with unsupported extensions may cause exceptions ................................. 75Freelance file with a 123 chart does not display correctly ............................................ 75HTML preview of Lotus 1-2-3 Smartmaster support issue............................................ 75Installed templates are locked for editing...................................................................... 76Limited folder hierarchy in document libraries .............................................................. 76ODF files created with external editor may suffer data loss .......................................... 76Private draft copied with document but warning not shown .......................................... 76Productivity tools: General limitations ........................................................................... 77Productivity tools: Presentation editor limitations.......................................................... 79Productivity tools: Project planner limitations ................................................................ 80Productivity tools: Spreadsheet editor limitations ......................................................... 80Productivity tools: Word processing editor limitations ................................................... 81User cannot Undo if a document is not completely loaded ........................................... 81

IBM Workplace Managed Client issues ............................................................................... 81’Cannot Create Security Context’ error not translated .................................................. 81’Home’ button on Linux does not use default home page............................................. 82Calendar documents: Repeat is limited to 99 documents............................................. 82Cannot Reply or Forward in an open Calendar Invite message ................................... 82Cannot skip the update of a .jar file .............................................................................. 82Changing from one user’s workspace to another on one machine ............................... 82Changing language using keyboard commands........................................................... 82Changing the specified provisioning server .................................................................. 83Client mail messages on Linux do not convert URLs to hotlinks .................................. 83Client supports one machine per user (credential store) .............................................. 83Contacts - Typeahead overwrites special characters ................................................... 83Copy and Paste are not available with web browser on Linux...................................... 83F1 functionality in this release ....................................................................................... 84General properties for search do not apply to Managed Client .................................... 84Help button not working on Linux for Print Preview ...................................................... 84Hover text may not display properly .............................................................................. 84IM messages using Notes plugin and Notes client ....................................................... 84Instant Messaging - Saved chat transcript limitation..................................................... 85Issues with spell check on Linux with Managed Client ................................................. 85Keyboard access for the Switcher bar .......................................................................... 85Language to search has to match the client’s Regional Settings ................................. 85Mail, Address Book, and Calendar limits ...................................................................... 85Managed Client does not support Tivoli Access Manager (TAM) ................................. 86Managed Client fails to check if an account has been deleted ..................................... 86MIME messages with GIFs generate errors in client messaging .................................. 86Modifications to Managed Client policies not immediately applied ............................... 86Notes documents (\views) open in Messaging perspective .......................................... 87Outline appears when using non-default theme on Linux............................................. 87Outlook mail background color not displaying in client messaging ............................... 87Rich-client Search does not support use of wild -card characters ................................ 87Search of multilingual documents might fail .................................................................. 87Search rounds some documents score to zero ............................................................ 87Tab key has no effect in Linux Insert Image dialogue................................................... 87

User cannot cancel a search once it begins ................................................................. 88Using Documents over a dial-up connection ................................................................ 88

IBM Workplace Messaging issues....................................................................................... 88Chat with names list not working in Notes app using Workplace IM............................. 88Drag and drop is not supported with mail ..................................................................... 88Import command issues ................................................................................................ 88Instant Contacts - Dragging to resize truncates ............................................................ 89Instant Messaging - Linux issues .................................................................................. 89Maximum Send Size limit is not enforced ..................................................................... 90Notes Application Plug-in server policy setting being ignored ...................................... 90Updating mail forwarding address not immediately effective ........................................ 90

IBM Workplace Team Collaboration issues......................................................................... 90Cannot create team spaces, libraries, or Web conferences ......................................... 90Limitations for Web Conference templates and applications ........................................ 90Managed Client online status has precedence over Portal client ................................. 91Meetings cannot be deleted when Messaging is not installed ...................................... 91Search for Discussion Topic in Subject fails ................................................................. 91

IBM Workplace Designer issues.......................................................................................... 92’Save As’ function in Form editor not working............................................................... 92Accessibility: CTRL+F10 fails to show view menu in shelf Part.................................... 92Accessibility: Jaws is announcing a table as a list box ................................................. 92Color Palette is not accessible...................................................................................... 92Directory searches do not support wildcards ................................................................ 92Discussion Sample App: Inconsistent no. of items listed in page ................................. 92Error dialog created by Eclipse is not accessible.......................................................... 92Exported component renaming ..................................................................................... 93Form with a background image is not shown on the server .......................................... 93Non-Visible UI Control Label is shown at runtime......................................................... 93Readers cannot view forms that store data .................................................................. 93Richtext control with "Store as Attachment" shows no filename ................................... 93Standard Eclipse pop-up is not read correctly by screen reader .................................. 93Standard Eclipse progress bar not being read by screen reader.................................. 94Title area of standard Eclipse Preference page ............................................................ 94Truncation occurs in some dialog boxes in high contrast settings ................................ 94Users cannot deploy Workplace Designer over HTTPS ............................................... 94Wrong icon when Designer and Managed Client both open ......................................... 94"Import Documents" from Import Domino form not supported ...................................... 94

IBM Workplace Forms issues.............................................................................................. 94Do not add the Form Template Library portlet to a page .............................................. 94No way to recover deleted form templates ................................................................... 95Search does not work for Forms ................................................................................... 95

IBM Workplace Templates and Applications issues ............................................................ 95Application templates require limited use of Mist themes ............................................. 95Do not use Portal Administration to maintain applications ............................................ 95No Template information if user has no access to the Template .................................. 97Templates imported from previous release are not upgraded ...................................... 97

IBM Workplace Web Conferences issues ........................................................................... 97PowerPoint file created by WCT can’t be uploaded in agenda ..................................... 97Web Conference e-mail notifications in mixed languages ............................................ 98

Web conferencing - Animations displaying out of sync................................................. 98Web conferencing - Can’t access Web conference ...................................................... 98Web conferencing - Can’t install Web conference tools on Mozilla .............................. 98Web conferencing - Deleting currently presented agenda ............................................ 98Web conferencing - Screen share browser/VM requirements ...................................... 99Web conferencing - Workplace window pops up .......................................................... 99

People components issues.................................................................................................. 99Cannot save contact information if server shuts down ................................................. 99Novell eDirectory user login fails when commas in user names ................................... 99

Security issues .................................................................................................................... 100Certificates in the admin console are improperly formatted .......................................... 100Creation of separate credentials not supported ............................................................ 100Importing of some PKCS12 files is not supported ........................................................ 100

Browser issues .................................................................................................................... 101Directory Search Help problem with Lotus Notes client settings .................................. 101Do not click Trash can icon if it appears in a help dialog .............................................. 101Mozilla and Firefox browser limitations ......................................................................... 101Pages hang if Microsoft VM in Internet Explorer 6.0 is set ........................................... 102Use Ctrl+W shortcut to close Help opened from the toolbar ......................................... 102What the Search Center can and cannot process ........................................................ 102

Portlet issues ....................................................................................................................... 102Accessibility and Content Palette .................................................................................. 102Instant Contacts - Back button behavior ....................................................................... 102Instant Contacts - Can’t add contacts without email addresses ................................... 103Instant Contacts - Chatting with multiple people limit ................................................... 103Instant Contacts - Group names and special characters .............................................. 103Instant Contacts - User policy doesn’t turn off address book........................................ 103Instant Messaging - Chat window pops up ................................................................... 103Instant Messaging - Chatting with multiple people and DND status ............................. 103Instant Messaging - Performance when searching ....................................................... 104Instant Messaging - SIP Presence IM re-start and chat problem ................................. 104Option to overwrite template is given when not applicable ........................................... 104Portlets available for selection do not always work ....................................................... 104Search and Mail portlets may display empty ................................................................ 105Search has limited support for wildcards ...................................................................... 105Web conference tools - Warning message when installing .......................................... 105Web conferences - Removed participant still a participant ........................................... 105Web conferences - Removed presenter can still present ............................................. 106Web conferencing - Poor display of Microsoft Powerpoint slides ................................. 106

WebSphere Portal issues.................................................................................................... 106Content palette is inaccessible using keyboard shortcuts ............................................ 106Pages are invisible after editing if left in inactive state.................................................. 106

IBM Data Access Tool issues.............................................................................................. 107Database application names are limited to 50 or fewer characters .............................. 107Error message when pressing a control character in Name field ................................. 107Favorites list is not retained in team space catalog ...................................................... 107Filter is removed after records are added or deleted .................................................... 107Fonts appear differently when previewing a print ......................................................... 107Foreign key violation error explanation ......................................................................... 107

Image file names with special characters cannot be imported ..................................... 108Input mode values cannot be changed for certain data types ...................................... 108Maximum length of table name is 128 characters ........................................................ 108Printing limitations ......................................................................................................... 108Right-to-Left format is not supported in this release ..................................................... 109Time picker uses period separator in Swedish translations .......................................... 109Using Unicode characters in name fields...................................................................... 110Working with default values in columns ........................................................................ 110

Activity Explorer issues........................................................................................................ 110Cannot add groups to the membership list of a shared object ...................................... 110Cannot open Activity Explorer by dragging file to a contact .......................................... 110Cannot print directly from shared objects ..................................................................... 110Cannot search across shared objects........................................................................... 110No detailed activity logs ................................................................................................ 111No support for off-line use or archiving ......................................................................... 111No versioning or real-time editing of shared notes ....................................................... 111Not all chats are persistent ........................................................................................... 111

Known problems and workarounds............................................................................................ 112Installation issues ................................................................................................................ 112

CD install Productivity Tools icon temporarily placed on desktop ................................. 112i5/OS: lwpGenPluginCfg.sh does not work in clustered environment ........................... 112i5/OS: Runtime 2.6 install shows incorrect WSE instance ............................................ 112Increasing the buffer pools for DB 2 ............................................................................. 112Switching between languages in CD-installed productivity tools .................................. 113Workplace Designer: Install second client to its own directory ..................................... 113

Configuration issues ............................................................................................................ 113Corrupted characters appear in logs for some DBCS systems .................................... 113Mixed-case LDAP groups may cause some apps to fail ............................................... 114

Administration issues........................................................................................................... 114Domino PKI adapter fails with custom user registry ..................................................... 114i5/OS: WebSphere Application Server jobs have incorrect names............................... 115Incorrect default theme ................................................................................................. 115LDAP_OPERATIONS_ERROR (1) message ............................................................... 116Mail details: " When user exceeds maximum mail storage ..." error ............................. 117Non-Workplace theme gives JavaScript errors, missing GIFs...................................... 117SMTP server - LMS Mail (Calendar and Enrollment notifications )............................... 117With SQL datastore, database space needs to be reclaimed ....................................... 118Wpcpaudit.log not found in log directory ....................................................................... 118"Too many open files" exception ................................................................................... 118

IBM Workplace Collaborative Learning issues .................................................................... 119Chinese and Polish characters not appearing correctly................................................ 119Collaboration Space Link not showing for curriculum /certificate.................................. 119Configuring LMS to authenticate by cn instead of uid attribute ..................................... 120Course deployment failures when using FTP ............................................................... 121Course management: Problems with using Turkish and MS SQL ................................ 121Courses need to be added twice while creating a certificate ........................................ 122Errors may lead to server degradation.......................................................................... 122How to prevent Inactive Users showing up in User Searches ...................................... 122i5/OS - Using i5/OS as an FTP server for CLIMP may not work . ................................ 122

i5/OS: Workaround if "Send Package to Server" fails in Learning ................................ 123iCal received but no button to add to calender ............................................................. 123Import error 500 when importing a course in Authoring Tool ........................................ 124Java folder missing for Solaris install of Learning Client CD ........................................ 124Limitation of JReport Server Engine for Bi -di characters display ................................. 124LMS makes excessive query to LDAP Server .............................................................. 124Offline issues ................................................................................................................ 124Performance issue with SQL Server and large database tables .................................. 125Progress data for completed certificate not displaying ................................................. 125Selected skills from current page only added to Skill Management.............................. 125Steps to enable Logging for Learning tools running outside WAS ................................ 126Students can not view Learning Plan from Career Development ................................. 126Synchronization issues ................................................................................................. 126Unable to enter international group names for Learning............................................... 127"Unable to Create Collaboration Space " error in LMS (Oracle DB) ............................. 128"Value must be a double" message when viewing course results ................................ 128

IBM Workplace Documents issues...................................................................................... 128Applications containing Team Tasks limit names to 100 characters ............................ 128Bad content appearance copying spreadsheet cell region to Notes ............................. 129Cannot create ten or more document libraries concurrently ......................................... 129Charts in .123 documents with "by row" are set to "by column".................................... 129File -> Close is missing from the IBM Productivity Tools .............................................. 130IBM productivity tools cannot launch with a remote HTTP server ................................ 130Imported documents file name is truncated .................................................................. 130In High Contrast mode, some text cannot be shown for preferences ........................... 131In Spreadsheet editor, misspelled words cannot be recorded ...................................... 131Linux - new platform fails to launch external applications............................................. 131Linux issues .................................................................................................................. 131Macro recorder issue in IBM spreadsheet editor .......................................................... 131ODF file association is overwritten................................................................................ 132Productivity tools will be suspended if changing region on Linux ................................. 132Productivity tools: General issues................................................................................. 132Productivity tools: Presentation editor issues ............................................................... 133Productivity tools: Spreadsheet editor issues ............................................................... 134Special fonts and vertical text cause .PPT to load slowly ............................................. 134Unable to synchronize large files in Documents ........................................................... 134"3D shadowing on/off" doesn’t work well for 3D chart................................................... 135

IBM Workplace Managed Client issues ............................................................................... 135A 2.5 to 2.6 update of the WEDM client does not work ................................................ 135Accessibility issues ....................................................................................................... 135Accessibility: High Contrast issues ............................................................................... 136Activating URL links will not launch Firefox on Linux .................................................... 136Address book entry issues ............................................................................................ 136Applications do not get moved into new category......................................................... 137Attempt update of most features /plugins; problem w/Linux client ................................ 137Calendar and calendar entry issues ............................................................................. 137Calendar Docs incorrectly read by screen reader......................................................... 137Calendar Document ’Subject’ limited to 765 characters ............................................... 138Calendar documents: Multiple select and open, only opens one doc........................... 138

Calendar globalization issues ....................................................................................... 138Can’t cancel Setup when provisioning operation is in progress.................................... 138Client shortcut replaced on second install to new location ........................................... 138Column Width dialogue has inaccessible elements in High Contrast ........................... 138Contacts - NamePicker search list may be empty ........................................................ 139Context Menu in Monthly Tabbed Calendar ................................................................. 139Context menu incorrect when multiple mixed entries are selected ............................... 139Cursor not displaying after tabbing to the body of mail message ................................. 139Date picker is not handling dates prior to 1926 correctly .............................................. 139Deleting ’Over Quota’ notification message causes log error ....................................... 139Differences in Managed Client Change Password functionality ................................... 140Document editors and document library issues ............................................................ 140Domino server put method must be enabled to save documents ................................. 141Downloading appears to hang for shared applications ................................................. 142Enabling accessibility features for the document editors .............................................. 142Error messages send users to error logs without location ............................................ 142Feature Filtering not working with Eclipse update manager ......................................... 143File - Open on Calendar documents causes an error ................................................... 143Globalization issues ...................................................................................................... 143Grammatical error in Out of Office message ................................................................ 143i5/OS: Directories may not be removed after uninstalling............................................. 144IBM productivity tools icon remains on desktop ............................................................ 144IBM Workplace appears unresponsive and CPU usage spikes.................................... 144IBM Workplace becomes unresponsive after the server goes down ............................ 144If Network outage may need to remove workspace to provision .................................. 145If problem provisioning may need to restart several times............................................ 145Incorrect Message Size displayed ................................................................................ 145Instant Contacts -- reaching maximum number of contacts .......................................... 145Instant Contacts - Adding contacts and address book.................................................. 145Instant Contacts list - How search works ...................................................................... 146Instant Messaging - Chat Messages Preferences text truncated ................................. 146Instant messaging - Reconnecting if network goes down............................................. 146Instant Messaging server specification in network deployment .................................... 146Issue after changing Instant Messaging option in Notes plugin.................................... 147Large Messages may cause excessive memory consumption ..................................... 147Links section in Help is not supported .......................................................................... 147Linux - People Finder/Links may not work in Managed Client ...................................... 147Linux - WEDM update; occasional problem restarting workbench ............................... 147Linux performance: Select online with no network connectivity .................................... 148Linux provisioning tool reset.sh is not executable by default ........................................ 148Linux: No hourglass shown while opening large message ........................................... 148Linux: Print Preview has no mouse-less accessibility ................................................... 148Logoff/logon required after restarting stopped SSO service ......................................... 148Lotus Notes icon displayed on Linux ............................................................................ 149Mail issues .................................................................................................................... 149Manual script edit for IBM Support Assistant plug -in ................................................... 151May experience long delay when accepting an update ................................................ 151Meeting issues .............................................................................................................. 151Must use standard /lwp context root on server for provisioning.................................... 151

Navigating with the keyboard Linux issues ................................................................... 152Need to click twice after correcting invalid provisioning URL........................................ 152Network outage during provisioning - recovery workaround ......................................... 152No error message if no certificates are imported .......................................................... 152No feedback given by the Troubleshooting Search Index Feature ............................... 152No feedback to user during search when index is not created ..................................... 152Occasional crash when closing WEDM client; restart client ......................................... 153Occasional display of blank Preference panes ............................................................. 153Occasional initial problem updating features in the WEDM client ................................. 153Offline Draft meetings need to be saved with out addresses........................................ 153Opening a folder, relaunch and tab title is wrong (Folder View) ................................... 153Page not found / no response from Managed Client download link.............................. 153Pages lost using a multi-page template ........................................................................ 154PC clocks must have same times before synchronization ............................................ 154Performance problems sending very large messages.................................................. 154Persistent error message screen - closure workaround ............................................... 154Pop-up date Picker - Month/Year Navigation not working right .................................... 155Preview pane does not always update ......................................................................... 155Previewed Outbox Message is not cleared................................................................... 155Print Preview limitation with Web browser on Linux ..................................................... 156Print queue does not show title of printed Calendar document .................................... 156Problems getting WEDM updates because of unresolved PREREQS ......................... 156Provision applications can fail if insufficient space or rights ......................................... 156Provisioning can fail without error due to disk space .................................................... 156Remove Invitee from Meeting; Cancellation address wrong ......................................... 157Removing the Managed Client workspace ................................................................... 157Repeating Doc can be modified if only saved............................................................... 157RTL layout not rendered despite locale setting............................................................. 157Search field won’t take Unicode keyboard combination ............................................... 157Search results not displayed ......................................................................................... 158Searching for a name with double -byte characters may not work ............................... 158Shared applications unexpectedly become local only .................................................. 158Sorting in Preferences different in non -English version ............................................... 158Spell checker languages............................................................................................... 158System Admin account has ’Manager’ access by default ............................................. 159Tab name is the same for Learning and Web conferences .......................................... 159Transition EUM provisioned client to WEDM with updates ........................................... 159Update silently installs unsigned features without warning ........................................... 159Update wizard screens are not translated into Hebrew ................................................ 159Use fully qualified server name for provisioning URL ................................................... 160User cannot simultaneously change the local and update features.............................. 160User not warned during install of an unsigned nested feature ...................................... 160Web browser tab in the Workplace Managed Client is not working .............................. 160Web conferences - Screen share problems.................................................................. 160Web conferences and Learning - Launching from Switcher bar ................................... 161WEDM provisioning will not work in an SSL environment ............................................ 161When focus is on top-level menu, Ctrl-F7 does not work ............................................. 161WMC Junk Mail still functions after being disabled on server ....................................... 161Workplace Managed Client not functional during update ............................................. 162

"N-way" chat action menu issue.................................................................................... 162<Esc> is not closing the window tab in Notes plug -in .................................................. 162

IBM Workplace Messaging issues....................................................................................... 162Address book cache issues .......................................................................................... 162Bad forwarding addresses will cause mail not to be forwarded .................................... 162Bad mail address produces ’Person exists outside search bases’ ............................... 163Calendar issues ............................................................................................................ 163ConnectionIOTimeout may need to be tuned for the network ...................................... 163Folder created on back end won’t show up immediately in UI ...................................... 164How to correct a ’bad mail domain’ error ...................................................................... 164Import of some calendar entries causes parser exception ........................................... 165Incorrect message when removing a contact from the address book........................... 165lmadmin Import command doesn’t preserve case of Folders ....................................... 165lmadmin <infile> and <outfile> tags .............................................................................. 165Log messages may be in mixed languages .................................................................. 165Mail issues .................................................................................................................... 166Managed Client does not handle signed and encrypted messages ............................. 166Managed Client status displayed using Sametime in Notes plugin .............................. 166Managing the user preference cache for the mail portlet .............................................. 167Meeting issues .............................................................................................................. 167Message attachment issues ......................................................................................... 167Messages not relayed to list members if members not in LDAP .................................. 168No localization support for Lmadmin commands .......................................................... 168Provisioning a user when sending a mail message ...................................................... 168Restricting users from sending mail to groups does not work ...................................... 168Same mail address for a person and a group............................................................... 168Searching indexing lag time and troubleshooting ......................................................... 168Some Lmadmin commands do not work with Cloudscape and port 8882 .................... 169Spell checker issues ..................................................................................................... 169Toggling Hide Folders/Show Folders may alter folder expand state ............................ 169Treated as Managed Client user when using IM in Notes plugin.................................. 169Update the SMTP greeting ........................................................................................... 170

IBM Workplace Team Collaboration issues......................................................................... 170Administrator always appears online in Instant Contacts portlet .................................. 170Alert window persistently occurs when viewing archives .............................................. 170Assign task or change owner to explicit member only .................................................. 170Auto-away not functioning............................................................................................. 171Cannot create a forum in a new Discussion Forum portlet ........................................... 171Chat feature generates error messages ....................................................................... 171Collation sequence incorrect for discussions on SQL Server ....................................... 171Contributor has moderator access if a member of moderator group ............................ 171Deadlock when users simultaneously create team spaces .......................................... 172Domino Applications configured with remote HTTP do not open ................................. 172Error inviting groups to a team space ........................................................................... 173Extended Search config form cannot handle carriage returns ...................................... 173In Discussion, no visual indicator for more than 30 results ........................................... 173Instant Messaging - Chat isn’t sent even after server re -started ................................. 173Instant Messaging - Livenames and presence indicators ............................................. 173Instant Messaging - On-line tag may show disconnected............................................. 174

Instant messaging unavailable in client when nodes are restarted............................... 174Newly invited group member cannot access an application ......................................... 174No notification given when instant messaging is unavailable ....................................... 175Online status issues when an LTPA token expires ....................................................... 175Systemout.log reports SIP connection fails on node .................................................... 175Team Space Search index gets deleted on first restart of server ................................. 176UNIX - PowerPoint files not displaying in Documents .................................................. 176Weekdays appear in a daily archive schedule of Chat Room....................................... 176

IBM Workplace Designer issues.......................................................................................... 177Background/Border not showing for check box and radio button ................................. 177Cannot copy and paste a view control .......................................................................... 177Cannot create schemas with multiple root elements .................................................... 177Cannot delete a control just dragged to the form.......................................................... 177Cannot import a Domino database with non -ASCII chars ........................................... 177Component fails to run when running on a Linux /DB2 server ...................................... 177DB2: Deleting many designer documents fails ............................................................. 178Deleting a component does not always remove it from Comp Nav .............................. 178Deployment error message is too general when bad username .................................. 178Designer Runtime install UI does not default to WSE................................................... 179Designer Table added to a form does not display ........................................................ 179Discussion Sample App: Author field on Response doesn’t change ............................ 179Discussion Sample App: Large file attachment error .................................................... 179Don’t place two instances of the same component on the same page ......................... 179Edit box needs binding for default value to work .......................................................... 179Error and Parameters tabs persist when the component is deleted ............................. 179Fonts set in Designer are not seen in the deployed apps............................................. 180Help file: Tutorial navigation script is incorrect.............................................................. 180Help link to Applications Development goes to Toolkits page ...................................... 180Importing the sample applications ................................................................................ 180Incorrect values for cell and node displayed during install............................................ 180Install produces "Invalid Directory" error in Rich Client path ......................................... 181Installer reports success, but logs indicate failures ....................................................... 181Link Control in runtime gives error when URL option is selected ................................. 181Linux: " Select a directory" dialog in install does not work ............................................ 181Mozilla: Borders not displayed for Rich Text in deployed apps .................................... 181No properties available after creating a new control ..................................................... 181Proj Mgr Sample App- Delete buttons do not give a warning dialog............................. 182Project Mgr Sample App: Intermittent runtime error ..................................................... 182Project Mgr Sample App: Typo in the isForTesting field ............................................... 182Radio button without schema gives error in runtime ..................................................... 182Sample-Blog-Admin role has Author role access instead of Editor .............................. 182Script editor doesn’t open via Error tab ......................................................................... 182Script errors don’t show in Error tab ............................................................................. 182Scripting not being deployed......................................................................................... 183Space taken by invisible rows ....................................................................................... 184Style category missing in Format of Form and UI controls ........................................... 184Switch Managed Client fails with invalid login............................................................... 185Type validation is not working in edit /multiline edit box ............................................... 185Typing over highlighted form text does not remove the text ......................................... 185

UI Control Styles preference settings are not applied ................................................... 185UNIX - libraries.xml is not modified in a cluster ............................................................ 185Unwanted background color appears in FireFox .......................................................... 185View - Column - Lookup data is not working at runtime................................................ 185vpd.properties file gets created when installing Designer ............................................. 186"All users" access in Roles is not honored.................................................................... 186"Invalid Server" error entering fully-qualified domain node name ................................. 186@DbLookup() function usage ....................................................................................... 186@Name() works in form; does not work in view column ............................................... 186

IBM Workplace Forms issues.............................................................................................. 186Back button fails from text attachment .......................................................................... 186Blank description field can result in data loss in form template .................................... 186Chart design problem on Solaris ................................................................................... 187Considerations for access to form templates ................................................................ 187Deleting field from a template makes form portlet unavailable ..................................... 187Do not use design fields in form portlet views............................................................... 187Field displays "changed" after selecting name in people selector ................................ 187Form portlet not configurable while editing an App Template ....................................... 187Form templates not upgraded with 2.6 ......................................................................... 188Launching a URL link from a form portlet loses Workplace window ............................. 188Lock conflicts for form templates .................................................................................. 188No notification if form portlet is uninstalled ................................................................... 188Non-admin user unable to use Form portlet on private page........................................ 189Only first name selected displays in form portlet view .................................................. 189Requiring value for some selection fields can cause form to fail .................................. 189Save As for Forms not working as expected ................................................................ 189Searching a form’s Author field may fail to return results ............................................. 189Some form icons do not display in high contrast .......................................................... 189

IBM Workplace Templates and Applications issues ............................................................ 190Adding 100 users to a template role can destabilize browser....................................... 190Application parameters display at instantiation ............................................................. 190Application templates not upgraded with Workplace 2.6 .............................................. 190Changing template or application owner requires updating roles ................................. 191Default editor/user policy cannot be re-added .............................................................. 191Deleting from one template role removes from all ........................................................ 191Do not use special characters in template name or category name ............................. 191Edited component properties are not immediately refreshed ....................................... 192Misleading error message when importing a template ................................................. 192Server failover cancels application creation.................................................................. 192Template on Oracle db: Default description shows as "null" ......................................... 192Values specified for application parameters are not validated...................................... 192When you create a custom category you must edit the user policy .............................. 192

IBM Workplace Web Conferences issues ........................................................................... 193Double-byte filenames fail when clicked to Download in Agenda ................................. 193Issues with installing Web Conference tools on Linux systems.................................... 193Session affinity: Creation may fail silently ..................................................................... 194Web Conference Tools download affects multiple monitor display............................... 194Web conferences - Can’t maximize projector appshare on Mozilla .............................. 194Web conferences - Repaint problems on RedHat Linux ............................................... 195

Web conferences - Screen sharing problems............................................................... 195Web conferences - Using the Mozilla browser.............................................................. 195Web conferencing - Don’t receive e-mail notifications .................................................. 195Web Conferencing - International issues ...................................................................... 195Web conferencing - Using the Firefox browser ............................................................. 196"Details" in web conference calendar entry not internationalized ................................. 197

People components issues.................................................................................................. 197Adding a third column to Directory Search results ........................................................ 197Exception for Display/Modify Owner in Resource Permissions page ........................... 198Extending popup contact information on person links .................................................. 198People search can time out when Domino is the LDAP server .................................... 200Person tag links not updated when user information changes ..................................... 200Pop-up windows can trigger login screen ..................................................................... 201Script error in Directory Search with Mozilla on i 5/OS ................................................. 201Unable to search user name with double -byte characters ........................................... 201Workaround for using People Finder "Show Details" on Linux ..................................... 201XML error in Directory Search with Mozilla 1.4 or Firefox 1.0....................................... 201

Security issues .................................................................................................................... 202Changing the SSL repertoire used by the SIP Services ............................................... 202Domino CA occasionally refuses to certify Workplace certificates ............................... 203HTTP/HTTPS on a non-standard port .......................................................................... 203If the HTTP session times out, you may lose unsaved work ........................................ 204Incorrect error message importing an invalid PKCS 12 objects.................................... 204Logout/login required to see newly added certificates .................................................. 204Mail encryption fails for contacts newly added to PAB ................................................. 204Multiple certificates may be marked as default for signing ........................................... 205Portlets require HTTP server’s certificate CN to match DNS name.............................. 205Repeating error message: " Authentication failed for <null> "....................................... 205Security implications with WMM ................................................................................... 206Security issue when IBM Workplace has write access to LDAP................................... 206Some Verisign CA cert attributes are not supported..................................................... 207Special characters could prevent wpsadmin from authenticating ................................. 207User is prompted to trust their own S /MIME certificate ................................................ 207You may be prompted twice to trust same certificate ................................................... 208

Browser issues .................................................................................................................... 208Back button shows information after logout .................................................................. 208Chat may not work using Mozilla browser .................................................................... 208Documents with language set to Other cause poor -quality search.............................. 208Instant Messaging - Chat window does not display ...................................................... 209JavaScript error when performing certain tasks ............................................................ 209Problems with SCORM courses not working on Linux /Mozilla .................................... 209Rich Text Editor Spell Check w/ tables in doc concatenates text ................................. 209Search for Russian and Polish languages .................................................................... 210Search generates error on page in Windows 2000 Professional .................................. 210Some Learning functionality not supported in Mozilla browser ..................................... 210Spell Check corrupts tables in Rich Text Editor ............................................................ 210Text indentation not visible in HTML view in Presentation editor .................................. 210

Portlet issues ....................................................................................................................... 211Entries are deleted after logging out ............................................................................. 211

Exception opening members page in the Pages and Layout portlet ............................. 211Instant Contacts - Lose changes .................................................................................. 211Instant Contacts - Removing a contact added by e -mail address ................................ 211Instant Messaging - Added contacts may not display ................................................... 212Instant Messaging - Adding new contacts limitation ..................................................... 212Instant Messaging - Cannot change online status ........................................................ 212Instant Messaging - Chat window doesn’t open ........................................................... 212Instant Messaging - Chat window loses focus .............................................................. 212Instant Messaging - Chat window still enabled after logging off ................................... 212Instant Messaging - Cluster environments and PIMs ................................................... 213Instant Messaging - IM issue when user logs into different node ................................. 213Instant Messaging - Issues with chat partner no longer chatting .................................. 213Instant messaging - No focus in chat window............................................................... 213Instant Messaging - Using special characters in chats ................................................. 213Instant messaging if SIP server fails ............................................................................. 213Instant Messaging server Help issues .......................................................................... 214Issues with empty categories in the content palette ..................................................... 214JavaScript Errors With Content Palette in IE ................................................................ 215No ’Show All’ option after search in Manage Document Libraries ................................ 215No confirmation box when removing portlets from Content Palette .............................. 215Search treats hyphen as a word space delimiter .......................................................... 215Using vertical scroll bar in IE closes Content Palette.................................................... 215Web conference projector controls and large fonts ...................................................... 216Web conferences - Mozilla 1.4 issues .......................................................................... 216Web conferencing PowerPoint slide display problems ................................................. 216Windows may flicker and disappear ............................................................................. 216"Back to Documents" tab missing after Document Search ........................................... 216

WebSphere Portal issues.................................................................................................... 217Content palette alternative ............................................................................................ 217Content palette can be updated manually .................................................................... 217Content palette paging controls do not work as expected ............................................ 217WebSphere portal indexes required ............................................................................. 217

IBM Data Access Tool issues.............................................................................................. 218Arabic and Hebrew translations .................................................................................... 218Button label font style does not automatically refresh ................................................... 219Cannot import or export applications without the data definition .................................. 219Changing image in image control does not save immediately ...................................... 219Combination box with filtering enabled not working correctly ....................................... 219Compression cannot be turned off during export .......................................................... 219DateTime data type not working correctly when output in grids ................................... 219Default location of cursor in form is in last field............................................................. 219Delete button for deleting custom values in a list does not work .................................. 220Disabled radio buttons appear to be enabled ............................................................... 220Error message 23502: columns cannot accept Null value ............................................ 220Events/Actions that are not working for grids and reports ............................................ 220Floating point numbers are not handled correctly ......................................................... 221Font style changes on printout ...................................................................................... 221Form closes without warning after deleting last record ................................................. 221IBM Data Access tools missing "Close" menu option under File .................................. 221

Images don’t appear on buttons if width of button is too small ..................................... 222Images on buttons do not appear when previewing forms ........................................... 222Looping occurs in grids when using the duplicate record action................................... 222Navigating a new form with keyboard on Linux ............................................................ 222No confirmation when saving form in data access viewer ............................................ 222Non-nullable table columns in grids, forms cause error on save .................................. 222On Save/On Save Error issues with forms, grids.......................................................... 223Printing a grid or report ................................................................................................. 223Problems when using multiple-value design controls ................................................... 223Records do not sort correctly in data access viewer..................................................... 223Red cross appears instead of error message ............................................................... 223Renamed columns do not appear in data binding drop -down list ................................ 223Rename/Save As not supported for more than one design element ............................ 224Renaming a table .......................................................................................................... 224Replace/Find not working for some data types in forms, grids ..................................... 224Reports without data do not display group report column labels .................................. 224Select correct computed expression for summaries to work ........................................ 224Sharing a database application when data definition is open ....................................... 225Simple combination boxes do not display correctly ...................................................... 225Some border styles appear incorrectly in data access designer................................... 225Strikeout and Underline font effects not working .......................................................... 225Triggering an On Hint event on a control ...................................................................... 225Using the Set Value simple action ................................................................................ 226XPath id() function not working as expected................................................................. 226

Activity Explorer issues........................................................................................................ 226’Esc’ key does not dismiss the ’Create shared object’ dialog ....................................... 226Cannot use paste on Linux client to create shared file responses ................................ 226Create shared file dialog appears behind the desktop.................................................. 226File-->Preferences... does not show Activity Explorer settings ..................................... 227Help graphics do not display in some topics ................................................................. 227In ND environment previewed objects retain active (green) status............................... 227Modification data for some objects is not updated properly .......................................... 227Persistent chat window opens behind desktop on Linux client ..................................... 228Remove yourself as last member of a shared object .................................................... 228Shared object does not disappear after removing yourself ........................................... 228Users in cluster cannot use shared files after upgrade ................................................. 228

Chapter 4 - Documentation updates ................................................................... 229IBM Workplace Information Center ............................................................................................ 229

Configuring Workplace Designer to use DB 2 for iSeries .................................................... 229HTML table of contents cannot be collapsed in Mozilla ...................................................... 230i5/OS: New cluster backup/restore functions available ....................................................... 231IBM Workplace Collaborative Learning ............................................................................... 231

Procedure for getting CLIMP to work with SSL............................................................. 231Workplace skills are different from WCL instructor skills .............................................. 232

IBM Workplace Managed Client .......................................................................................... 232Linux permission error in WMC documentation ............................................................ 232Plug-in Help not provided for some client plug -ins ....................................................... 233

Security................................................................................................................................ 233Digest authentication does not work for Instant Messaging .......................................... 233

Enabling non-wpsadmins to manage client certificates ................................................ 233Issuing user credentials through a Certificate Authority................................................ 234Updates to "Importing a certificate into the WAS trust stores " ..................................... 234

IBM Workplace Portlet Help ....................................................................................................... 235Application Membership help refers to team spaces........................................................... 235Mail and rich text editor keystrokes ..................................................................................... 235Not all additional doc links in online help work properly ...................................................... 235Web conference templates are not customizable................................................................ 235Wildcard (*) character in People Finder and Directory Search............................................ 235IBM Workplace Collaborative Learning ............................................................................... 236

Approval process for an Approver ................................................................................ 236Catalog search topic contains an error ......................................................................... 236My Learning Interests only includes recommended jobs .............................................. 236

IBM Workplace Managed Client .......................................................................................... 236Switcher bar graphic in Help not current ....................................................................... 236

IBM Workplace Web Conferences ...................................................................................... 236Web conferencing Help issues ..................................................................................... 236

IBM Workplace Managed Client Help ........................................................................................ 237Accessibility, Keyboard commands - Help update .............................................................. 237Activity Explorer: Adding members to a shared object ........................................................ 237Calendar Help correction ..................................................................................................... 237File -> Work Offline toggle ................................................................................................... 237Incorrect description of Team Spaces being available offline ............................................. 238Launching of Web Conferences and Learning in 2.6 .......................................................... 238Logging in procedure reflects outdated login screen........................................................... 238Lotus Notes, document libraries, and the IBM editors ......................................................... 239Mail and offline Managed Client help corrections ................................................................ 239Switch from standalone productivity tools to server -based WMC ...................................... 239"Working with bookmarks" Help correction.......................................................................... 240IBM Workplace Documents ................................................................................................. 240

Duplicate Help pages.................................................................................................... 240Extended tips cannot display in "Preference" dialog..................................................... 240Failure to locate help page in ’Create -> Graphics’ dialog ............................................ 240Incorrect Help title for chart object bar .......................................................................... 240No general introduction page for IBM productivity tools Help ....................................... 240Stand-alone document editor file commands ................................................................ 240Template support in Workplace Documents ................................................................. 241The content on the Help page "Change" is incorrect .................................................... 243

IBM Workplace Designer ..................................................................................................... 243Associating standalone Workplace Designer to provisioning server ............................ 243Configuring databases to use with Workplace Designer .............................................. 244Configuring Oracle: Help file has incorrect download location...................................... 244Creating a template for a deployed Call Center sample component ............................ 244Deploying to a cluster: How to activate your portlets .................................................... 247Missing information about manually deploying to a cluster........................................... 247

IBM Data Access Tool ......................................................................................................... 247Default value needed for primary keys when using auto -save .................................... 247New custom XPath functions ........................................................................................ 248Right-arrow and left-arrow icon references in Help ....................................................... 248

Updated description of icons in Application catalog...................................................... 248IBM Workplace WebSphere Administrative Console Help ........................................................ 249

Allow import or export of files for Managed Client users only.............................................. 249Document formats supported as trusted mail attachments ................................................. 249Enabling archiving in the Administrative Console................................................................ 249

IBM Workplace Designer Help................................................................................................... 251Choosing a location for an exported component ................................................................. 251Cloudscape users must edit the startNetworkServer file ..................................................... 251Configuring Workplace Designer to use with DB 2 for iSeries ............................................ 251Database must already exist before deploying a component .............................................. 252Date Picker option is missing in Help topic.......................................................................... 253DB2 support for Designer .................................................................................................... 253Deploying a Workplace Designer component to an iSeries cluster ..................................... 255Description of password for Edit Box is incorrect ................................................................ 259IBM Workplace Designer Runtime supports Solaris and AIX .............................................. 259Importing a component and deployment ............................................................................. 259Installation file format incorrect in guide .............................................................................. 259Label positions..................................................................................................................... 260Linux: Change to configuration file may not be required ..................................................... 260Setting form data properties topic........................................................................................ 260Tutorial: / project/status should be /project/currentStatus ................................................... 260

Chapter 5 - Notices and Trademarks .................................................................. 261Notices ....................................................................................................................................... 261

Excluded Components information...................................................................................... 261Copyright notices and information regarding non -IBM software......................................... 261FileUpload 1.0 License ........................................................................................................ 277Jaxen 1.0 License................................................................................................................ 280JDOM 1.0 License ............................................................................................................... 280Lucene 1.3 License ............................................................................................................. 281RegExp 1.3 License ............................................................................................................ 284wcp-wts-sdk 1.03M license.................................................................................................. 285XMLS 0.8 License ............................................................................................................... 288JReport - license information............................................................................................... 289

Trademarks ................................................................................................................................ 289

IBM Workplace Collaboration Services 2.6.1 Release Notes

Chapter 1 - About this release

New in this release

Introducing IBM Workplace Designer What is IBM Workplace Designer? IBM Workplace Designer is an Eclipse, standards-based tool for developers who want to create components and build applications for IBM Workplace Collaboration Services or IBM Workplace Services Express servers using a high-level, visual scripting development environment. Supporting a services-oriented architecture and standards such as XML, J2EE, JavaScript, and portlets, Workplace Designer is ideal for developing composite applications and extending existing applications with collaborative components. Workplace Designer provides a natural path for businesses that have invested in IBM Lotus® Domino® and Visual Basic development skills and want to extend their investments into an IBM Workplace environment.

Workplace Designer's friendly user interface helps script developers leverage existing skills, using forms, drag-and-drop UI controls, views, XML schemas, and scripts in a visually integrated development environment. The tool conveniently includes sample components that you can use to add additional functionality to your composite applications, including a blogging component, a project management tool, a contact management list, an online discussion forum, and a call center component. Workplace Designer also allows you to import forms from existing Domino applications to use when building new IBM Workplace applications.

Here are some of the benefits of using Workplace Designer:

z Enables you to rapidly build, test and deploy open, security-rich, components for IBM Workplace applications

z Helps to lower training costs with an easy-to-use, intuitive visual development environment z Allows you to reuse existing skills with its powerful script capabilities z Provides rapid startup for Domino developers z Allows you to automate existing business processes through a simplified forms-based development

environment

For more information about Workplace Designer, see the resources section at the end of this release note.

How do I make Workplace Designer available to users? You can make Workplace Designer available to users by provisioning it from a Workplace Collaboration Services environment using the Workplace Managed Client and by enabling it in their user policies using the IBM WebSphere Application Server Administrative Console.

1

IBM Workplace Collaboration Services 2.6.1 Release Notes

Provisioning Workplace Designer from a Workplace Collaboration Services environment Provisioning gives users access to Workplace Designer and other rich client capabilities when they install the Workplace Managed Client on their desktops. Updates to these capabilities are available each time users log in or switch from one capability to another while working in the Workplace Managed Client, or are available based on an update interval. When updates are available, users are notified or the updates are installed automatically, depending on their user preference.

Here are the basic provisioning steps: 1. Install the Workplace Collaboration Services server. 2. On the offerings screen, select Workplace Collaboration Services and Workplace Designer . 2. Install the Workplace Managed Client from a server desktop installation. 3. In the Workplace Administration user policies, allow users to install the Workplace Managed Client and Workplace Designer.

For more detailed information about installation and provisioning, see the help topics in the Installation and upgrade section in the Workplace Collaboration Services V2.6 Information Center, available as a self-extracting ZIP file in the Beta kit.

Enabling Workplace Designer in user policies In order to make Workplace Designer available for users, you must enable it in their user policies using the IBM WebSphere Application Server Administrative Console. If user policies are not set properly, Workplace Designer will not be available to those users from the Workplace Managed Client.

For more information about creating and configuring user policies, see the help topics in the Policies > User policies section in the Workplace Collaboration Services V2.6 Information Center, available as a self-extracting ZIP file in the Beta kit.

How do users access Workplace Designer from the Workplace Managed Client?Once Workplace Designer is provisioned and enabled in the user policies, users can launch it from theTools menu of Workplace Managed Client.

What are some of the new features offered with Workplace Designer V 2.6?Here are some of the new features offered with Workplace Designer V2.6:

Support for livenames: Livenames provide the ability to add presence awareness to a person's name in a computed field or view column without programming. This integrates with the livenames support offered with Workplace Collaboration Services and Workplace Services Express servers.

Improved usability when configuring deployment profiles : The deployment profile dialog box is now organized into separate tabs for configuring the Workplace application and database server(s).

Ability to test connection to database server before deploying : The deployment profile dialog box has a new Test Profile button that allows you to test your connection to the database before deploying a component. This will help you catch errors before they occur.

Two new simple actions . Simple actions expand the "no programming" options for simple scripts. The following two simple actions are new in this release:

Request Confirmation - a client script that displays a prompt and OK button as well as a Cancel button.

Execute Script - a server-side script that allows you to combine a client-side script, requesting confirmation for an action, followed by a server script.

2

IBM Workplace Collaboration Services 2.6.1 Release Notes

New sample component . A new Call Center sample component helps demonstrate the power and flexibility of Workplace Designer.

Improved way to create a component : You can create a new component based on an existing sample component instead of creating one from scratch.

Ability to provision Workplace Designer from a server : Users can provision Workplace Designer and other rich client capabilities when they install the Workplace Managed Client.

How do I learn more about Workplace Designer?Several resources are available to help you learn more about Workplace Designer, including articles,tutorials, product documentation, and demos, for example:

Workplace Designer Web site: http://www.ibm.com/developerworks/workplace/products/designer/

General product documentation: (1) Click Help > Help Contents from Workplace Designer's main menu. (2) Click IBM Workplace Designer to expand the topics.

"Creating a component based on the Project Manager sample component" tutorial: (1) Click Help > Help Contents from Workplace Designer's main menu. (2) Click IBM Workplace Designer Reference > Tutorial in the table of contents.

API documentation: (1) Click Help > Help Contents from Workplace Designer's main menu. (2) Click IBM Workplace Designer Reference in the table of contents.

"Introducing IBM Workplace Designer" developerWorks article: http://www.ibm.com/developerworks/lotus/library/workplace-designer/

"An inside look at IBM Workplace Designer" developerWorks article: http://www.ibm.com/developerworks/workplace/library/inside-workplace-designer/

"Designing Workplace Designer: An interview with the IBM Workplace Designer design team" developerWorks article: http://www.ibm.com/developerworks/lotus/library/workplace-designer-interview/

IBM Workplace resource center on developerWorks (collection of learning resources, including training, forums, technical articles, toolkits, and product documentation): http://www.ibm.com/developerworks/workplace/

IBM data access tool The IBM data access tool is part of the IBM Workplace Managed Client. This tool allows users to create, design, modify, and run database applications that are used to access, share, and organize data. The data access tool is powerful enough for expert designers, yet easy enough for novice users who are just getting started.

The data access tool is made up of two parts: data access designer and data access viewer. Data access designer allows users define the type of data used in the database application and add design elements (forms, grids, and reports) for creating and displaying the data. Data access viewer allows users to run the database applications on a local database and work with data in real time.

The data access tool provides templates that are complete with design elements and sample data for building and designing customized database applications. Users have the option to delete the sample data and use only the design elements that are provided with the template.

3

IBM Workplace Collaboration Services 2.6.1 Release Notes

Notes Application plug-in for IBM Workplace Managed ClientThe Notes Application Plug-in is included as part of the Notes / Domino 7.0 release or higher , and isdesigned to work in conjunction with the IBM Workplace Managed Client. The IBM Workplace Managed Client is a new offering that utilizes IBM Workplace Managed Client. For purposes of these ReleaseNotes, IBM Workplace Managed Client will be referred to simply as the "Managed Client" below.

This plug-in was delivered as part of Notes / Domino 7.0 release and, as such, we welcome feedback onthe usage of this capability as we continue our development activities in this area.

At this time we are continuing to verify the functionality provided with all out-of-the-box Notes 7 templates. In the sections below you will find details on how to work with these applications and any current limitations. We are very interested to hear your experiences with running other (custom) Notes Domino applications.

System Requirements

In addition to having the IBM Workplace Managed Client 2.5.x or higher installed, the following arerequired:

z IBM Lotus Notes Client 7 or higher for Windows, installed on the same machine as the Managed Client

z Minimum System Memory 512 MB (recommended 1 GB)

z Diskspace of 275MB

Configuration Instructions

z Install IBM Workplace Managed Client 2.5.x or higher.

z Install IBM Lotus Notes 7 Client or higher

Operating Instructions

z The Notes applications are accessed via the Managed Client by selecting from the Switcher Bar and selecting the Lotus Notes icon.

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

z Once the Notes Application is active the menus available to the Notes Client will also be available from within the Managed 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 Managed 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 Managed Client.

3. If a database is open in Notes, and you try to open the same one in the Managed Client, the Managed Cient will bring standalone Notes to the foreground to display the opened database there. The same behavior will occur if you open a database first in the Managed Client and then try to open the same db in Notes. Notes will bring the Managed Client to the foreground to display the database.

4

IBM Workplace Collaboration Services 2.6.1 Release Notes

4. If you have Designer opened and you open a database in the Managed Client, you cannot closeDesigner until the Workplace client has been closed.

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

6. The Startup folder bookmarks are not available from the Notes Application navigator.

7. Some Accelerator keys that move the main window are not available when accessing Notesapplications in the Managed Client.

8. 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.

9. If the Managed 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.

10. 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 Managed Client will hang.

11. When using the IBM Workplace and the Managed 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 Workplace application after editing the entry without first dismissing the dialog.

12. When using IBM Workplace and the Managed 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.

13. When using IBM Workplace and the Managed 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.

14. When using the Managed 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.

15. When using IBM Workplace and the Managed 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.

16. If Notes or the Managed Client crashes or hangs and you need to shut down the Managed Client, when you restart and try to open Notes you may get a message stating that Notes cannot be displayed because it is not installed. If this occurs, shut down the Managed Client and restart it again. Most times Notes will open.

17. Under the File menu there are two Preferences items. The first is for Managed Client preferences and the second, identified as Lotus Notes - Preferences, is for Note Preferences.

18. There is an accelerator conflict when using Notes within the Managed Client. In the Notes client, pressing Alt+E+D deselects any selected files in a view. However, when using Notes within the Managed Client, pressing Alt+E+D (+ENTER) deletes any selected files in a view. To deselect selected files while using Notes within the Managed Client, press Alt+E+D, and then press D again, followed by ENTER.

5

IBM Workplace Collaboration Services 2.6.1 Release Notes

i5/OS: Platform now supportedStarting with version 2.5, IBM Workplace Collaboration Services is available on the IBM i5/OS platform. i5/OS users can take advantage of the integrated database, LDAP and HTTP functions of the IBMeServer i5 server to deploy and manage Workplace Collaboration Services on an enterprise scale.

For single-server environments, IBM Web Administration for i5/OS provides a Web-based wizard to configure Workplace Collaboration Services after installation. The Create IBM Workplace CollaborationServices wizard simplifies configuration by automatically detecting system settings, providing usefuldefault values, and reducing the number of steps that have to be performed manually. The Create IBM Workplace Collaboration Services wizard creates a production-ready, single-server environment usingIBM DB2 Universal Database, IBM HTTP Server, and optional LDAP authentication.

Starting with version 2.6, i5/OS users can also deploy Workplace Collaboration Services in a clusteredenvironment. Note, however, that the Create IBM Workplace Collaboration Services wizard does notsupport configuration in a clustered environment. To configure Workplace Collaboration Services oni5/OS in a clustered environment, use the Configuration Wizard that ships with Workplace CollaborationServices 2.6.

Release note information for WebSphere Portal available onlineThe 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

Technical preview

Technical preview features There are three technical previews in IBM Workplace Collaboration Services 2.6. 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.

The IBM Workplace 2.6 technical previews can be downloaded from the same Web site from which you download the IBM Workplace server. They are bundled in this package:

z IBM Workplace Managed Client Technical Preview - Other

Note: IBM Workplace Mobile Client is not available for technical preview for this release.

IBM Workplace Managed Client Technical Preview - Other contains the following:

Web Services for Remote Portlets The Web Services for Remote Portlets (WSRP) Technology Preview for IBM Workplace Managed Client 2.6 enables server-managed deployment and client-side aggregation of WSRP applications. This Technology Preview is the initial IBM Workplace offering of technology based on the WSRP standard. For all documentation, see the "Technical Preview of Web Services for Remote Portlets" PDF that comes packaged with the feature.

6

IBM Workplace Collaboration Services 2.6.1 Release Notes

Lotus 1-2-3 Filter Lotus 1-2-3 Filter is a feature for IBM Workplace Managed Client that allows users to work with Lotus 1-2-3 documents (.123). For installation and user documentation, see the ReadMe.txt file that comes packaged with the feature.

VoiceChat Voice Chat is a feature for the IBM Workplace Managed Client that allows users to speak to each other using their computers' microphone and speakers. For installation and user documentation, see the ReadMe.txt file that comes packaged with the feature.

Tech Preview features are not supported by Customer Support IBM Workplace Collaboration Services 2.6 ships 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.

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

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.

7

IBM Workplace Collaboration Services 2.6.1 Release Notes

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.

Instant messaging interoperability with Sametime IBM has developed the "IBM Lotus Instant Messaging Gateway" to enable users in an IBM Lotus Sametime environment and users in an IBM Workplace environment to communicate using online presence and instant messaging.

The IBM Lotus Instant Messaging Gateway can be downloaded from the IBM Lotus developerWorks Web site (www.lotus.com/ldd/down.nsf).

This gateway operates as an intermediary, or translator, between the Sametime instant messaging infrastructure and IBM Workplace instant messaging infrastructure and performs operations that enable users connected to these two separate infrastructures to communicate through presence and instant messaging.

The IBM Lotus Instant Messaging Gateway is designed primarily for an organization that uses both Sametime and IBM Workplace servers. For example, if your organization deploys IBM Workplace servers in a test or pilot environment, but uses Sametime servers in its production environment, you can deploy the gateway to enable users in these two environments to communicate through presence and instant messaging.

8

IBM Workplace Collaboration Services 2.6.1 Release Notes

Chapter 2 - Installation, migration, upgrade, and configuration information

Installation notes

Planning and requirements

Configuring Mail Services for Cloudscape IBM Cloudscape is not recommended for IBM Workplace Messaging in production environments. Cloudscape may be used to simplify installing demonstration and test systems and as a temporary datastore when setting up a production system using a relational database management system such as DB2, Oracle, or SQL Server. The IBM Cloudscape drivers lack support for XA transactions, which are necessary for a fully functioning Workplace Messaging environment. There are several administrative components that do not work properly when running on Mail_Server_1, the IBM Workplace messaging server. These components include the Administrative, Import, Export, and Archive tasks.

Note: To use Cloudscape as a relational database for IBM Workplace Messaging, you must move the mail task scheduler service from the Mail_Server_1 server to the WebSphere_Portal server. However, if you plan to federate the WebSphere_Portal server node into a cluster, you must first undo the steps that follow and move the mail task scheduler service back on Mail_Server_1

Perform the following steps to use Cloudscape as the relational database for IBM Workplace Messaging:

1. Stop each server by typing the following commands from the \WebSphere\AppServer\\bin directory, keeping in mind that server names are case-sensitive:

AIX, Linux, and Solaris

./stopServer.sh WebSphere_Portal

./stopServer.sh Mail_Server_1

Windows

stopServer WebSphere_PortalstopServer Mail_Server_1

9

IBM Workplace Collaboration Services 2.6.1 Release Notes

2. Move \WebSphere\AppServer\ \config\cells\MACHINE_NAME\nodes\machine_name\servers\Mail_Server_1\lwpscheduler.xml to this folder:

workplace_server_root\config\cells\MACHINE_NAME\nodes\machine_name\servers\WebSphere_Portal

where workplace_server_root is the default installation path for the workplace server, typically c:\Program Files\IBM\Workplace\WorkplaceServer for installation on Windows or /opt/IBM/Workplace for installations on Unix/Linux.

3. Start Cloudscape Network Server, if necessary, using workplace_server_root\config\wpsconfig start-ncs

4. Restart the servers:

.AIX, Linux, and Solaris

./startServer.sh WebSphere_Portal

./startServer.sh Mail_Server_1

Windows

startServer WebSphere_PortalstartServer Mail_Server_1

Notes z Log messages for the tasks now appear in the Portal logs at <wp_root>\logs. Any changes to the

trace settings for tasks should be done for the WebSphere_Portal server. z The effective configuration settings for the Messaging tasks in the WebSphere Administrative

Console are now under the Application Server > WebSphere_Portal > Workplace Mail Services > Task Scheduler Service .

Prerequisite installation information All IBM Workplace Collaboration Services customers should visit the website below to secure the latest information about installation, fixes, technical bulletins, and enhancements prior to installing. Fixes/enhancements will be regularly posted to this website; you are invited to check here often:

http://www-306.ibm.com/software/lotus/support/workplace/support.html

User limit when Cloudscape is user registry If you use the Cloudscape database as your user registry, when the registry reaches approximately the 800-user level, People Finder and Directory Search performance degrades. When the registry reaches approximately the 2000-user level, People Finder and Directory Search stop working.

10

IBM Workplace Collaboration Services 2.6.1 Release Notes

Preparing the environment

Increasing the stack size for DB 2 If you are using a Microsoft Windows server for IBM Workplace Collaboration Services with a remote DB2 8.1 FP7b database, you may need to increase the stack size of the db2syscs process. The symptoms of the failure include the termination of this process. If you run the netstat -an command on the DB2 server, you will see that no process is LISTENing on port 50000, so the Workplace server cannot connect to it.

You will also see an Application Error entry in the Windows Event Viewer that states:

ADM0501C A stack overflow exception has occurred. The DB2 instance has terminated abnormally. To remedy this problem, you may increase

the default stack size for db2syscs.exe using the db2hdr utility as follows: db2hdr \sqllib\bin\db2syscs.exe /s:<stackreserve>[, <stackcommit>] Note that increasing the default stack size willconsume virtual memory space and may reduce the maximum number ofconcurrent connections. Contact IBM Support for further assistance.

Workaround

1. Shut down all applications connected to the DB2 server.

2. On the DB2 server, open a DB2 Command Window and enter the following commands:

cd <C:\Program Files\IBM>\SQLLIB\misc < ---- Location depends on your installation db2stopdb2hdr "<C:\Program Files\IBM>\SQLLIB\BIN\db2syscs.exe" /s:512,32 < ---­Location depends on your installation db2start

3. Restart all of the IBM Workplace Collaboration Services applications.

Installing IBM Workplace Collaboration Services

Corrupted block characters display in the Config Wizard UI There is a known intermittent problem with UNIX double byte character set (DBCS) systems and the use of font.properties files by the JRE that the Config Wizard uses. On some configurations, running the Configuration Wizard with a DBCS language like Chinese, Japanese, etc., even on a system configured for that DBCS language, produces corrupted block characters in the UI.

If you were able to run the installer successfully without corrupted (block) characters, but you do see these corrupted characters when running the Config Wizard for Security / Database Transfer, then perform the following workaround steps:

11

IBM Workplace Collaboration Services 2.6.1 Release Notes

1. Make a backup copy of the <install_root>/PortalServer/config/wizard/configwizard.sh script.

2. Edit the <install_root>/PortalServer/config/wizard/configwizard.sh script in an editor and replace /AppServer/ with /WorkplaceServer/ on line 8.

3. Run the Configuration Wizard again.

Installer reports that RedHat 3.x is not supported The installer may report a warning that the operating system prerequisite check failed on some versions of RedHat 3.x; it is just a warning, and you are allowed to continue with the install.

The particular error in the install log is:

Red Hat Enterprise AS for Linux (x89) 3.0 is a supported operating system for non-clustered configurations.

This is a benign error and can be ignored.

Learning server: 2.6.1 dbbuild.properties has blank passwordsThe lmmserver_password and dsserver_password properties are blank. You need to fill them in beforeyou can run WPSconfig lwp-httpserver-config and LWPdbconfig updateSettings successfully.

Restart server after disconnecting a node from the networkIf, after disconnecting a node from the network, the WebSphere Portal server and Mail server crash,follow these steps to recover the Workplace servers.

1. Restore network connectivity to the node.

2. Start Workplace Collaboration Services (WebSphere Portal server, Mail_Server_1, and Cloudscape Network Server) with the following case-sensitive command.

IBM AIX, Linux, and Sun Solaris

./startWorkplaceServices.sh

Microsoft Windows

startWorkplaceServices.bat

i5/OS

startWorkplaceServices.sh

12

IBM Workplace Collaboration Services 2.6.1 Release Notes

Use English install path for Chinese installation The install program does not read Chinese native characters in install directories correctly. You may use a Simple Chinese locale and an English install path to install Workplace Collaboration Services.

Use of non-ASCII in the Admin fields causes failures Currently, installation will fail if non-ASCII characters are entered into the "Admin credential" fields in the installation UI. Until this is fixed, please refrain from using non-ASCII characters in these installer panel fields. The Turkish 'i' character particularly causes issues if used in any field in the installer.

The underlying WebSphere PortalServer has similar issues, please see this InfoCenter topic for more details:

http://publib.boulder.ibm.com/pvc/wp/502/ent/en/InfoCenter/wpf/sec_chars.html

WCS does not completely uninstall from the Deployment Manager WCS cannot be completely uninstalled from the deployment manager. After running the uninstaller, the Workplace menu items will still appear in the admin console although they will not function. Also, the configuration items and jars added for WCS will remain. To remove all traces of WCS from the deployment manager, ND must be reinstalled.

Workaround for installing with Self -Voicing Runtime Environment To run the install program with Self-Voicing Runtime Environment (SVRE), perform the following steps:

1. Set up your own Java environment setup.

2. Copy the jars and .properties file from the CD (..\cdinstall\dist) to local directories with the same name.

3. Run java -jar lwpinstall.jar from the dist directory.

13

IBM Workplace Collaboration Services 2.6.1 Release Notes

Connecting to an LDAP directory

Application group membership can block individual access If you have configured IBM Workplace Collaboration Services with a Novell eDirectory LDAP server or a Sun Java System Directory Server, users will encounter the following limitation with group membership for applications: If a user is an application member as part of a group, the individual will not be able to see or open the application.

To work around this problem, follow this procedure for Novell eDirectory: 1. Stop IBM WebSphere Portal server. 2. Open the WebSphere Member Manager XML in a text editor:

\WebSphere\PortalServer\shared\app\wmm\WMM.xml. 3. Edit WMM.xml, removing the attribute memberOfAttributeName=groupMembership. Save the file. 4. Restart IBM WebSphere Portal server.

To work around this problem, follow this procedure for Sun Java System Directory Server: 1. Stop IBM WebSphere Portal server. 2. Open the WebSphere Member Manager XML in a text editor:

\WebSphere\PortalServer\shared\app\wmm\WMM.xml. 3. Edit WMM.xml, removing the attribute memberOfAttributeName=nsRoles. Save the file. 4. Restart IBM WebSphere Portal server.

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

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

If the Managed 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_ma nualWebServer.html#configIIS

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

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

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

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

To correct the problem, restart the Workplace Collaboration Services servers.

14

IBM Workplace Collaboration Services 2.6.1 Release Notes

Creation of applications can take longer than expected The Ignore Case option setting in the WebSphere Application Server and the Deployment Manager and LDAPIgnoreCase setting in the LDAP Help file is not enforced when LDAP servers are configured to work with IBM Workplace Collaboration Services. This problem causes the creation of applications (Team Spaces, Document Libraries, Workplace Applications, and Web Conferences) to take a significantly long time.

When enabling LDAP security using the Configuration Wizard, make sure to enter all administrator IDs in the same case in which they are stored in the LDAP directory. For example, if your admin ID is stored in the LDAP directory as WPSADMIN, be sure to type it as WPSADMIN in the appropriate fields of the Configuration Wizard. Mismatched cases can cause ID cache misses in WebSphere Application Server, which results in a network trip to the LDAP server to retrieve the administrator ID. This can result in performance degradation. This WebSphere Application Server problem will be corrected in a future release of that product and reflected in Workplace Collaboration Services.

Disabling security fails when Turkish is the language Disabling security fails when Turkish is the language configured for Workplace Collaboration Services. To avoid this problem, before disabling security, install PK05258, which is a Member Manager cumulative fix for WebSphere Portal V5.0.2.1,5.0.2.2 & 5.0.2.3. Then, disable security after you install the fix. For information about PK05258 and how to install it, go to:

http://www-1.ibm.com/support/docview.wss?rs=0&q1=PK05258&uid=swg1PK05258&loc=en_US&cs=utf-8&cc=us&lang=en

LDAP user and group filters can inadvertently change If you select Security -> User Registries -> LDAP in the WebSphere Administrative Console, then change any LDAP setting and apply the change, the User Filters and Group Filters values revert to WebSphere Application Server default values, causing authentication failures.

To work around this problem:

1. Before changing an LDAP setting in the WebSphere Administrative Console:

a) Select Security -> User Registries -> LDAP.b) Under Additional Properties, click Advanced LDAP Settings .c) Make a note of the values for the User Filters and Group Filters properties. For example, copy the values to the Clipboard.

2. Select Security -> User Registries -> LDAP and change LDAP settings as desired.

3. Under Additional Properties, click Advanced LDAP Settings and retype (or paste) the User Filters and Group Filters values noted in step 1.

4. Apply the changes.

15

IBM Workplace Collaboration Services 2.6.1 Release Notes

Self-registration can fail with network deployment of LDAP If you have configured IBM Workplace Collaboration Services for network deployment that uses writeable LDAP directories in clustered LDAP servers, the self-registration feature might fail, depending on the LDAP service. The self-registration feature is provided by the Sign up and Edit my profile links in the toolbar. You will encounter this problem if your network deployment of Workplace Collaboration Services uses a cluster of IBM Tivoli Directory Server LDAP servers, implemented with IBM WebSphere Edge Server. The problem is caused by the fact that IBM Tivoli Directory Server with IBM WebSphere Edge Server uses master server and subordinate server LDAP directory updates instead of using multi-master replication.

Most LDAP servers synchronize directory information using multi-master replication. Multi-master replication enables multiple replicas to exist, all of which can be independently updated by applications or administrators at any time. Directory changes automatically propagate to all the replicas. When the system reaches a steady state with no replica updates, the replicas eventually converge to the same state. Multi-master replication provides highly available access to write to directory objects because several servers contain updateable copies of an object. Each server accepts updates independently, without communicating with other servers. The system resolves any conflicts in updates to a specific directory object. If updates cease and replication continues, all copies of an object eventually contain the same value.

Because IBM Tivoli Directory Server implemented with IBM WebSphere Edge Server uses a master server and subordinate server approach to providing directory updates, the lack of synchronization between updates to the master directory and updates to all subordinate directory copies causes the self-registration feature to fail. For this reason, you must configure IBM Tivoli Directory Server for read-only LDAP access, as documented in the IBM Workplace Collaboration Services Information Center. Refer to this topic path: Installation and upgrade -> Phase 4: Connecting to an LDAP directory server -> Connecting to IBM Tivoli Directory Server -> Step 5. Optional: Configure read-only directory access.

Please see the related release note "Self-registration should be hidden with read-only LDAP".

Self-registration should be hidden with read -only LDAP If you have configured IBM Workplace Collaboration Services to use a read-only LDAP directory, the self-registration feature should not be available because write access to the LDAP directory is blocked. The self-registration feature is provided by the Sign up and Edit my profile links in the toolbar. These links display before and after users log in to the site. With read-only LDAP security enabled, users can see these links and begin to create or edit user profiles. When users attempt to continue to the next page of the user profile, they receive a non-informative error message: "An error has occurred. User subsystem failed. Please contact system administrator."

To remove Sign up and Edit my profile links in the toolbar, run the configuration command WPSconfigaction-fixup-signup-link as documented in the IBM Workplace Collaboration Services Information Center. Refer to the topics for Installation and upgrade, Phase 4: Connecting to an LDAP directory server. See the topic for configuring read-only access for the particular LDAP server that you are using with Workplace Collaboration Services.

In a future release of the product, the self-registration links (Sign up and Edit my profile) will be hidden when LDAP security is enabled using a read-only LDAP directory.

User login problem when names contain special characters Some LDAP users whose distinguished name contains special characters -- for example, slashes or non-ASCII characters -- may be unable to log on to Workplace Collaboration Services.

16

IBM Workplace Collaboration Services 2.6.1 Release Notes

Connecting to a DBMS server

Clear or encode passwords written at config steps There are two instances where passwords are populated in clear text. Do the following to clear or encode these passwords to ensure that this information is not compromised.

1) The userid (wcm.database.userid = value) and password (wcm.database.password = value) fields in the properties file:

AppServer/wpcp/config/WebSphere_Portal/author/WCM.properties

are not used. Initially at install, the values for both of these fields are empty. However, after a database transfer, both of these values are populated. Consequently, after a database transfer, you should edit this file and clear out both values.

2) The userid and password fields in the file

AppServer/wpcp/config/WebSphere_Portal/runtime/pznConfig/persconfig.xml:

are used. The password exists in the file before and after database transfer, and is not encoded. It is recommended that you run the encrypt-persconfig-password task (see below) after database transfer to encode the password.

The syntax for the task is as follows:

C:\Program Files\WebSphere\PortalServer\config>wpsconfigencrypt-persconfig-password -DWpcpDbPassword=yourPassword

where yourPassword is the value of your database user's password.

Completing external HTTP server setup

Configuring the Managed 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 Managed 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).

17

IBM Workplace Collaboration Services 2.6.1 Release Notes

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".

Completing Collaborative Learning setup

Learning uses the uid attribute to authenticate user in LDAPIBM WebSphere Portal Server authenticates using the LDAP "cn" attribute, while Learning uses the "uid" attribute. This results in an authentication error:

usermod_unable_get_authuser_wmmsettings

Workaround Update Learning or the LDAP so that the "uid" and "cn attributes contain the same value.

For example, to update Learning, edit settings.xml (on the Learning Server) and ds-settings.xml (on the Delivery Server) as follows,changing the wmmAttribute for ldapid and userid to "cn", instead of "uid"; then restart WebSphere Portal Server.

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

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

. . .Note User wpsadmin can already authenticate because its LDAP entry uses the same value (wpsadmin) for both the "uid" and "cn" attributes.

Installing the Managed Client provisioning server

Applet not able to detect existing running instance of download When downloading the Workplace Managed Client applet from an HTTP server, the applet is not able to detect an existing, running instance of the download. If users click more than once on the 'Start download' button, multiple executables will be saved into wctpinstall.temp, wctpinstall.tem1, etc. On systems with low memory, it will cause the downloads to be extremely slow.

18

IBM Workplace Collaboration Services 2.6.1 Release Notes

Console mode provisioning server install and relative pathInstalling the IBM Workplace Managed Client provisioning server using console mode fails if you enter arelative path when prompted for the path to disk2. Installation does not complete successfully, no errormessages are issued, and files are not created in htdocs/lwpinstall/wct. Failure to install the provisioningserver prevents users from successfully installing the Workplace Managed Client on their desktop. Entering an absolute path when prompted to specify the path to disk 2 does not yield this problem anddoes enable the provisioning server to be installed successfully.

Credential Store error when importing a certificateIn order for a Managed Client user to import a certificate (PKCS12 object) using the File > Preferences >Security > My Certificates panel, the administrator must configure the system to use unrestricted policy. Without this configuration, the user will receive an error such as the following when he attempts to importa certificate.

"Error extracting private keys from PKCS12 object. Check encryption algorithm is supported."

To set the unrestricted policy, replace two JAR policy files for the JCE. There are two different versions of these JAR files in the Managed Client installation path, one inrcp\eclipse\features\com.ibm.rcp.jre.win32.feature_1.2.0\jre\lib\security and another inrcp\eclipse\plugins\com.ibm.rcp.jce_1.2.0. You must replace the files in both directories to successfullyimport a PKCS12 object.

Directory location change for download applet wctpinstall -tempThe directory location for the wctpinstall-temp download applet has changed.

WindowsThe IBM Workplace Managed Client download applet wctpinstall-temp is now placed under C:\temp on the drive where the Windows operating system is installed. For example, if Windows is installed on the D:drive then the wctpinstall-temp directory is placed under D:\temp. Previously, it was placed under theDocuments and Settings folder.

LinuxThe wctpinstall-temp download applet is now placed under /tmp.

When the Workplace Managed Client is uninstalled, the wctpinstall-temp directory is removed.

If a user chooses to download multiple installers on the same machine without uninstalling the previousversion, an additional wctpinstall-temp directory is created as wctpinstall-temp.1, and so on for each subsequent installation.

19

IBM Workplace Collaboration Services 2.6.1 Release Notes

Do not select "Work Offline" during client initialization Once you have completed downloading the appropriate Managed Client application software from the server, the Managed Client launches itself automatically and prompts you to log in. At this point, the Managed 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 appear when the Managed Client starts up in offline mode. If you restart the Managed Client and select to work online after this occurs, the Managed Client will still not work correctly. You should not choose to work offline during initialization.

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

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.3 then the IBM Workplace Managed Client install will not be able to run automatically from thedownload 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: CHMOD 777 setup_wct_platform.bin e. 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.

2. After running the platform install, the Managed 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) and enter it here. Note that this URL is case-sensitive.

20

IBM Workplace Collaboration Services 2.6.1 Release Notes

Empty directories left after uninstall On the Windows platform, after uninstalling the Workplace client, the user will be asked to reboot so that files can be deleted from the Workspace directory and the Installed directory. After restarting the system, the following directories should be left behind, and should be empty if the user selected "Yes" during uninstall, in order to delete all local IBM Workplace user data, documents, and configuration settings:

Workspace \Documents and Settings\Username\IBM\RCP\Workspace #\username\

\applications \com.ibm.pdm.sodc.feature

\eclipse \plugins

\com.ibm.superodc.base.app.win32_1.5.0

\com.ibm.superodc.base.framework.win32_1.5.0

\com.ibm.superodc.base.infra.win32_1.5.0

\com.ibm.superodc.base.system.win32_1.5.0

\com.ibm.superodc.sc.lib.win32_1.5.0

\com.ibm.superodc.sd.lib.win32_1.5.0

\com.ibm.superodc.sw.lib.win32_1.5.0

Installed Directory <root drive>\IBM\Workplace Managed Client\

\rcp \eclipse

\features

On the Linux platform, the IBM\RCP directory remains, and is empty.

Errors when using provisioning server install Custom option Installing the Managed Client provisioning server on Windows, using the Custom option, and deselecting the IBM Components option, may yield the following two error messages:

Cannot find log file C:\Program Files\IBM\WorkplaceRichClientProvisioning\Logs\add_app_pagesLog.xmlCannot find log file C:\Program Files\IBM\WorkplaceRichClientProvisioning\Logs\add_app_portletsLog.xml

21

IBM Workplace Collaboration Services 2.6.1 Release Notes

Failover is not supported when provisioning using the WEDM Failover is not supported if you are using WEDM for provisioning. If you experience a network outage during provisioning when using WEDM, your client may launch with a blank perspective or missing features. If your client does not automatically provision missing features, after the outage is restored, you may need to perform the following manual workaround to restart provisioning.

Exit the client and remove the %WORKSPACE%\.metadata\.plugins\com.ibm.rcp.pagebuilder directory and restart. This should force a reprovisioning.

HTTP server directories for Managed Client read, execute access In order for the Managed Client download program to run in an environment where server file permissions have been secured, the HTTP server's document root directories lwpupdate and lwpinstall and their contents must be set to allow read and execute access for all users. Do not remove these permissions or the Managed Client download program will not be successful.

Incorrect Custom install summary message When installing the provisioning server and selecting to use the Custom install method, a summary screen may display incorrect information.

1. Start the provisioning server installation program.

2. When prompted, select a Custom install.

3. Only select the installation options that go on the external HTTP server.

Just before installation starts, a screen appears stating that the installer is going to install all the pieces (not just those that go on the HTTP server).

However, the installer will install only those pieces that you selected on the Custom screen.

Install provisioning server from e -image - unpacking When installing the IBM Workplace Managed Client provisioning server from an e-emage, follow the instructions in the Information Center topic entitled, "Installing the provisioning server from an e-image". The instructions omit the unpacking instructions, which are as below:

For UNIX, use the tar command to extract the files as shown below: tar xvf C87USIE.tartar xvf C87UTIE.tar

For i5/OS, start the QShell Interpreter and use the pax command to extract the files as shown below: pax -rv -C 819 -f C87USIE.tar pax -rv -C 819 -f C87UTIE.tar

22

IBM Workplace Collaboration Services 2.6.1 Release Notes

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

If you install Managed Client applications from the Managed Client tab of the IBM Workplace server and successfully complete the install, then begin the provisioning of the Managed 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 Managed 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, "InstallShield has successfully installed IBM Workplace products Managed Client."

Managed 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.

Managed Client installation program does not support bi -di The Managed Client installation program does not currently support bi-directional displays. See your IBM representative for details.

Missing Accelerator keys in provisioning components install In some panels of the Managed 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.

Multiple RCPINSTALL.Properties created changing install paths When users install IBM Workplace Managed Client, the file rcpinstall.properties gets created. If a user clicks on 'Next' after specifying the inital install directory, and then clicks on 'Back' and changes the destination directory, the first rcpinstall.properties file in the first destination remains; it is not removed when the user changes the destination drive. Users will need to go back to the initial directory specified and delete it after the installation is completed.

23

IBM Workplace Collaboration Services 2.6.1 Release Notes

No status message after cancelling provisioning server install If you cancel provisioning server installation from the screen that prompts you to insert Disk 2, messages may indicate a successful installation. Even though the installer reports that it has finished successfully, nothing has been installed. The system will be in a stable state, as all installed files are backed out as though a provisioning server uninstall had been run.

Providing a trusted root certificate to users One of the windows in the Managed Client installation wizard asks you to specify a root certificate to install into the Managed 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 Managed 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.files win32.mozilla.downloads.files linux.mozilla.downloads.files This 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 samedirectory as the installer, and adds the certificate to the HTTP stack in the client.

Provisioning component uninstall leaves log filesAfter uninstalling the IBM Workplace Managed Client provisioning components, a set of log files willremain 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 from en_US in a non-US/non-English operating systemIn a scenario in which you install the Workplace Managed Client provisioning server to en_US, under thehttp server installation path, and then provision the client from a non-US, non-English operating system,you'll be unable to run setup.exe because the executable defaults all requests to the user's language. Specifically, the document root specified in the httpd.conf file is set to be different from the following:

Documentroot "<install path for IHS>/htdocs/en_US"

For example, when installing the IBM HTTP Server on a German operating system, it defaults to de_DE inthe httpd.conf; yet the provisioning server installation program defaults to en_US.

As a solution, you can override the default directory and install the provisioning server content to a moreappropriate directory. When you install the provisioning server, override the default en_US directory andspecify an appropriate OS directory on the HTTP server screen under htdocs.

24

IBM Workplace Collaboration Services 2.6.1 Release Notes

Provisioning server install panel display in Romanian locale With the Romanian locale, there are display problems on one or more of the provisioning server installation panels. Widening the panels improves display clarity. The WebSphere Application Server panel fields remain somewhat illegible. See the provisioning server installation documentation in the Information Center to guide you through the provisioning server installation process.

Provisioning server installation filepath cannot contain spaces When specifying a directory name in which to install the Managed Client provisioning components during provisioning server installation, do not use spaces or special characters in the path name. Certain platforms cannot process provisioning server calls if the path contains spaces or any of the following characters: '"^()\{}[]<>

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.

Repackage of wps.ear reports a warning in repackageWpsEarLog .txt During provisioning server installation on the Workplace Collaboration Services server, there is a task (repackage-wps-ear) that updates the wps.ear. When installation is complete, the documentation tells the administrator to check the provision_server_root/logs/repackage/WpsEarLog.txt log file. When reviewing WpsEarLog.txt log file, ignore the following warning:

[war] Warning: selected war files include a WEB-INF/web.xml which will be ignored (please use webxml attribute to war task)

Root or super user login causes inability to provision from CD Linux users who install the IBM Workplace Managed Client from a CD must not be logged in as either root or super user (SU). If you run the setup_wct_platfom.bin installation program from a terminal window logged in as either root or super user, the system will be unable to provision your installation from the CD.

25

IBM Workplace Collaboration Services 2.6.1 Release Notes

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

Gather the following information first:

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

z 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>.

z What path will you install the Managed 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 Managed Client is uninstalled from a userworkstation:

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 IBMWorkplace Managed Client (in Windows, use Add / Remove Programs, on Linux, run the uninstallexecutable).

3. Create, or verify the existence of, the rcp_home directory. Under the rcp_home directory, create, orverify the existence of, a folder called rcp. In that folder, create a file called rcpinstall.properties.

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

z rcp.installId=%WORKSPACE% z rcp.install.id=%WORKSPACE% z rcp.product.installId=IBM_LWP_C%WORKSPACE% z rcp.product.name=IBM Lotus Workplace products Managed Client 2.0%WORKSPACE% z rcp.beanBootstrapInstaller_bean66.name=beanBootstrapInstaller_component3%WORK

SPACE% z rcp.beanBootstrapInstaller_bean31.name=beanBootstrapInstaller_component2%WORK

SPACE% z rcp.beanJavaSecurityFilesInstaller_beanJavaSecurityFiles2.name=beanJavaSecurityFile

sInstaller_component3%WORKSPACE% z rcp.beanBootstrapInstaller_bean66.installId=IBM_LWP_C_WCTbootsc%WORKSPACE

% z rcp.beanJavaSecurityFilesInstaller_beanProductJavaSecurityFiles.installId=IBM_LWP_C

_RCPmjre%WORKSPACE% z rcp.beanBootstrapInstaller_bean31.installId=IBM_LWP_C_WCTbootcf%WORKSPACE% z rcp.beanRCPClientInstaller_rcpComponent.installId=IBM_LWP_C_RCP_RCPa%WORK

SPACE% z rcp.beanRCPClientInstaller_rcpWin32Component.name=beanRCPClientInstaller_rcpWin

32Component%WORKSPACE% z rcp.beanRCPClientInstaller_RCP-Linux-MozillaFileDelete.installId=38ef825dfb3f3fb6025

2500b75261e5f%WORKSPACE% z rcp.beanBootstrapInstaller_bean16.installId=IBM_LWP_C_WCTboot%WORKSPACE% z rcp.beanApplicationInstaller_ProductAppsInstaller.installId=IBM_LWP_C_WCTapps%W

ORKSPACE% z rcp.beanRCPClientInstaller_rcpComponent.name=beanRCPClientInstaller_rpcCompone

nt%WORKSPACE% z rcp.beanRCPClientInstaller_rcpInstall.name=beanRCPClientInstaller_rcpInstall%WORK

SPACE%

26

IBM Workplace Collaboration Services 2.6.1 Release Notes

z rcp.beanJavaSecurityFilesInstaller_productWindowsThemeSupport.installId=IBM_LWP_ C_RCPmjrewinXP%WORKSPACE%

z rcp.beanBootstrapInstaller_bean16.name=beanBootstrapInstaller_IBM Workplace Client Technology - Install Bootstrap%WORKSPACE%

z rcp.beanRCPClientInstaller_rcpInstall.installId=IBM_LWP_C_RCP%WORKSPACE% z rcp.beanRCPClientInstaller_RCP-Linux-MozillaFileDelete.name=beanRCPClientInstaller

_MozillaFileDelete%WORKSPACE% z rcp.beanBootstrapInstaller_LicenseFilesCompBean.installId=IBM_LWP_C_WCTbootlf%

WORKSPACE% z rcp.beanJavaSecurityFilesInstaller_beanJavaSecurityFiles.name=beanJavaSecurityFiles

Installer_component2%WORKSPACE% z rcp.beanJavaSecurityFilesInstaller_beanJavaSecurityFiles.installId=IBM_LWP_C_RCPm

jresf%WORKSPACE% z rcp.beanJavaSecurityFilesInstaller_beanJavaSecurityFiles2.installId=IBM_LWP_C_RCP

mjresf2%WORKSPACE% z rcp.beanJavaSecurityFilesInstaller_productWindowsThemeSupport.name=beanJavaSec

urityFilesInstaller_component10%WORKSPACE% z rcp.beanJavaSecurityFilesInstaller_beanProductJavaSecurityFiles.name=beanJavaSecu

rityFilesInstaller_IBM Workplace Client Technology - Security%WORKSPACE% z rcp.beanApplicationInstaller_ProductAppsInstaller.name=beanApplicationInstaller_IBM

Workplace Client Technology - Install Applications%WORKSPACE% z rcp.beanRCPClientInstaller_rcpWin32Component.installId=IBM_LWP_C_RCPw32%WO

RKSPACE% z rcp.beanBootstrapInstaller_LicenseFilesCompBean.name=beanBootstrapInstaller_Licen

seFilesComponent%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 Managed 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 Managed Client launches; the data it launches with should be that of the

orphaned workspace, which is now linked to the Managed Client that has just been installed. 11. Wait for the Managed Client to perform an update check and download any additional components it

may need.

Some provisioning server installation fields are hard -coded When installing the Workplace Managed Client provisioning server, as described in the Workplace Collaboration Services Information Center, note that the values for the Portal Server configuration URL , WAS server bootstrap address , and WAS server SOAP connector port fields are preset and cannot be manually changed using the installation screens.

Spaces are not allowed in Workplace Managed Client install When a user installs the Managed Client, the default path is c:\Program Files\IBM Workplace Managed Client. Users are not able to change the path to a new directory name that contains spaces such as "c:\ \IBM Workplace Managed Client".

27

IBM Workplace Collaboration Services 2.6.1 Release Notes

Special characters in directory name cause failed CD install The presence of non-ASCII characters in the host directory name on the installation CD (namely characters & and #) causes the CD-based IBM Workplace Managed Client framework and IBM Productivity Tools installation to fail. Although it may appear that the CD-based installation is proceeding, nothing is actually installed because the required Java Virtual Machine does not resolve. In some instances, the installer may not start at all.

Specifying an install location for the Managed Client If a user without administrative rights to install programs on the workstation or who does not have write access to the default Managed Client install location tries to install the IBM Workplace Managed 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 Managed Client.

Uninstall icons are different with each install In the Add/Remove Programs listing, the icon for the IBM Workplace Managed Client may appear as any of the following:

The uninstall of the product will still function, despite the different icons.

Unsupported Managed 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 calendarAllow instant messaging

If you set up the Managed 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 Managed 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.

28

IBM Workplace Collaboration Services 2.6.1 Release Notes

User access rights required for Managed Client installation In order to install the Managed Client, you must have write access to the parent directory into which it is being installed.

You can specify an installation directory during Managed Client installation.

Once the Managed Client is installed, you no longer need 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> (onWindows)

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

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

WAS server name field value for provisioning server installation The installation screen seen in step 11 of the Workplace Managed Client provisioning server installation instructions ( http://publib.boulder.ibm.com/infocenter/jwphelp/v2r6m0/topic/com.ibm.wcs26.ic.doc/infocenter/i_inst_t_in stall_prov_server_singleserver.html and/or http://publib.boulder.ibm.com/infocenter/jwphelp/v2r6m0/topic/com.ibm.wcs26.ic.doc/infocenter/i_inst_t_in stall_prov_server.html) contains a field named WAS server name. The WAS server name field name is misleading. The WAS server name field value must be WebSphere_Portal , which is the default value. Because there is an ability to enter a different value in this field, administrative users may erroneously enter a value such as server1 or a WAS (WebSphere Application Server) cell name. Using any value in this field other than WebSphere_Portal causes users to be unable to download and install the Workplace Managed Client as described here http://publib.boulder.ibm.com/infocenter/jwphelp/v2r6m0/topic/com.ibm.wcs26.ic.doc/infocenter /i_inst_t_install_rich_client_user.html.

29

IBM Workplace Collaboration Services 2.6.1 Release Notes

Completing Network Deployment setup

Enabling Web conferences to work behindi a reverse proxy It may be necessary to customize a setting in the lwpagenda.properties file to enable Web Conferencing to work behind the reverse proxy, as discussed below.

In a Web conference, the agenda servlet on the IBM Workplace server builds the URLs used by clients to access the content presented during a Web conference. When an IBM Workplace server is deployed behind a reverse proxy server, the agenda servlet may not build these URLs appropriately and users will be unable to view content presented in Web conferences.

The property value that determines how the Web conference URLs are constructed is located in the lwpagenda.properties file available in the <root>\websphere\workplaceserver\properties directory on the IBM Workplace server. In the lwpagenda.properties file, the agenda.serverUrl property specifies the path to use for building the URL to content served by the agenda servlet.

In some cases, the default value for the agenda.serverUrl value (agenda.serverUrl=/lwp.meeting.agendabuilder.servlet) will enable Web conferences to function correctly behind a reverse proxy server. The default value should work if the reverse proxy can be configured to route a rooted URL to the IBM Workplace server. Note: It is important to distinguish between a "rooted URL" and a "purely relative URL". The Agenda servlet constructs rooted URLs (for example, "/some_webcontext/some_resource") as opposed to relative URLs (for example, "../some_webcontext/some_resource"). Generally, any reverse proxy server can successfully handle relative URLs. Rooted URLs require special proxy features to ensure that subsequent client requests for the Web resources are routed to the correct server.

Some reverse proxies may not provide the functionality to route a rooted URL to the IBM Workplace server. In this case, you must set the agenda.serverUrl property to a custom value that is appropriate for your environment. For example, you might need to set the agenda.serverUrl property to a fully-qualified URL that clients would use to connect to the IBM Workplace server through the reverse proxy. For example, if the reverse proxy is named proxy.myco.com, you might set the property as:

agenda.serverUrl=http://proxy.myco.com/lwpserver/lwp.meeting.agendabuilder.servlet

This example setting forces browsers to build HTTP requests to the reverse proxy. If the reverse proxy is configured to route requests beginning with /lwpserver to the IBM Workplace server, the reverse proxy will forward the requests correctly. In other cases, it may be necessary to set the agenda.serverUrl property to a rooted URL such as:

agenda.serverUrl=/lwpserver/lwp.meeting.agendabuilder.servlet

This example setting causes the browser to make a request for the agenda servlet directly from the host where the Web page was retrieved. As the host is the reverse proxy, the reverse proxy must be configured with the rules needed to ensure that requests for resources that begin with "/lwpserver" are routed to the IBM Workplace server.

Note that when you change the default value of the agenda.serverUrl to a custom value, users who access the IBM Workplace server directly (without going through the reverse proxy) may be unable to receive Web conference content from the agenda servlet. When you customize the agenda.serverUrl property as described above, agenda content is always routed to the reverse proxy. In some cases, network configurations may prevent clients that access the IBM Workplace server directly from receiving the agenda content via the reverse proxy. Also note that if you set the agenda.serverUrl property to a fully-qualified URL, and SSL is required in your environment, you must use the prefix "https" in the fully-qualified URL specified in the agenda.serverUrl property.

30

IBM Workplace Collaboration Services 2.6.1 Release Notes

Instant messaging does not work in a horizontal cluster When IBM Workplace servers are deployed in a horizontal cluster configuration, instant messaging may not work. If you see this problem, perform the following procedure:

1. Add port 9083 to the default Virtual Host (default_host) associated with the cluster Deployment Manager.

2. From the WebSphere Administrative Console on the Deployment Manager computer, regenerate the WebServer plug-in.

3. Restart all of the IBM Workplace servers in the cluster.

ND: Mixed OS for Search share causes indexing to fail For a Network Deployment: any combination of mixed operating systems (Windows - AIX, Windows - Solaris, or Windows - Linux) Search fails if the shared Search directory involves two different operating systems. The Index directories are not created and indexing will fail.

Installing IBM Workplace Managed Client

CD-based install using -silent option fails Although not currently documented in the Workplace Collaboration Services Information Center, it is possible to run a CD-based Workplace Managed Client framework and IBM productivity tools installation using the silent method in conjunction with a response file. However, there is a caveat. Using the standard format below fails because default response file, in combination with the License Panel call, terminates the installation process:

setup_wct_platform -silent -options response_file.txt

where "response_file.txt" contains the following single executable line:

-P installLocation="c:\wct\current"

For this release, it is suggested that you not run a CD-based Workplace Managed Client framework and IBM productivity tools installation using the silent method. However, you can optionally add the following line to the response file and silent install should run successfully.

-G licenseAccepted=true

For related information, see knowledge base article Q105185 at http://support.installshield.com/kb.

CD installation and directory with percent sign causes problems You should not use the "%" (percent) sign in the directory name in which the CD-based Workplace Managed Client installation program resides. If you try to install the client from such a directory, using the setup_wct_platform.exe program, you will receive a launch script error screen. To correct the problem, rename the directory in which the CD-based installation script resides then restart the installation program.

31

IBM Workplace Collaboration Services 2.6.1 Release Notes

serial.multiuser: Administrator installs and provisions client The administrator, not one of the serial multiuser users, must perform the initial installation and provisioning of the Workplace Managed Client to properly configure the serial multiuser environment for all other users of the machine.

Note that this release note is written for a Windows environment but the condition is also true for Linux.

The recommendation is that the administrator provision the client immediately after install when configuring a serial multiuser installation. If the administrator doesn't provision, then only the user that provisioned will be able to see and access the desktop shortcut and start menu program items for the IBM client.

serial.multiuser: Check for updates cannot find file When a user installs a serial.multiuser Workplace Managed Client from CD, for example when installing the IBM productivity tools from CD, the url for the install.xml on initial provisioning is stored for that user only. If another user of the client operating system logs in and receives the following error message when using Help -> Check for Updates:

get error in Setup wizard dialog "cannot find file:///"

then type in the directory name (for example file:///D:/deploy/install.xml) and the updates will occur as expected. The url will then be stored for the current user so that any future updates for that user will also occur as expected.

serial.multiuser: Shortcut and Program menu for current user This release note documents a condition where desktop shortcuts and Program menu items can be created only for the current user.

During the provisioning process, code can run that creates desktop shortcuts and program menu items. In that code (called installhandlers), while a non-administrative user of the client operating system is logged in, only that currently logged-in user will see any desktop shortcuts and program menu items. No other users of the client will see those items in a serial.multiuser configuration.

Workaround Copy the desktop shortcuts and program menu items created during the provisioning process, from the current users profile to the All Users profile/shared location of the operating system -- for example, on the Windows platform:

1. Copy the IBM client desktop shortcuts from C:\Documents and Settings\CurrentlyloggedinUserAccount\Desktop to C:\Documents and Settings\All Users\Desktop.

2. Copy IBM client program menu items from C:\Documents and Settings\CurrentlyloggedinUserAccount\Start Menu to C:\Documents and Settings\All Users\Start Menu.

32

IBM Workplace Collaboration Services 2.6.1 Release Notes

serial.multiuser: Uninstall and preserving workspace fails Using the Do not uninstall user workspaces option is not supported in a serial multiuser Workplace Managed Client uninstall on Windows XP when using Windows XP Switch User functionality. This issue will happen if one user is still logged in to the Workplace Managed Client while it is being uninstalled by another user (when the operating system is switched to another user). Since another session of Workplace Managed Client is loaded, and the system is switched to another user, the uninstall will not work and is unsupported in this configuration.

When uninstalling a Workplace Managed Client serial multiuser installation, uninstall displays the following error and fails if the administrator selects the No option when prompted to remove user workspaces.

An error occurred and product uninstallation failed. Look at the log file <name> for details.

You can still click Next on this panel and continue.

Trust certificate time-out exits client installation For an SSL-enabled Workplace Managed Client installation, if a trust certificate appears during provisioning, you must accept the on-screen certificate acceptance options within 60 seconds, or a time-out will occur and cause a provisioning error during end-user client installation.

Users require write access to install directory Users need write access to the directory in which Workplace Managed Client and the IBM productivity tools are to be installed or are already installed. The error message that appears when a user attempts to access Workplace Managed Client and/or the productivity tools installed to a directory to which they do not have write access is not clear. For example, the error message may read, "An error has occurred, see the log file."

AIX, Linux, and Solaris: Installation notes

Preparing the environment

Linux: Enterprise Edition v5.0 for Network Deployment may fail The installation of WebSphere Application Server Enterprise Edition v5.0 for Network Deployment may fail on Linux platforms. This is a limitation in the WebSphere Application Server installation.

A workaround is available on the IBM Support site. For more information, go to:

http://www-1.ibm.com/support/docview.wss?rs=180&context=SSEQTP&uid=swg21173121

33

IBM Workplace Collaboration Services 2.6.1 Release Notes

Linux: Workaround for installing DB 2 on Red Hat 3.0 This information is excerpted from the "Frequently Asked Questions for IBM Db2 Universal Database Version 8.1 on Red Hat Enterprise Linux 3 (RHEL 3)" at http://www-306.ibm.com/software/data/db2/linux/validate/rhel3faq.html.

How do I install DB 2 UDB on RHEL 3? RHEL 3 has known issues with the Java runtime environment currently shipped with DB2 UDB V8.1. You should use the command line utility db2_install instead of the graphical db2setup. Note that db2_install only lays down the DB2 product filesets. It does not create DB2 instances, users, groups, or setup communications, etc. You will need to perform these steps manually or use the db2isetup utility after the product has been installed. Please refer to the RedBook Up and Running with DB2 for Linux or the appropriate Quick Beginnings product manual for details on how to install and setup using the db2_install utility.

You can locate the documention mentioned above at the following Web addresses:

z RedBook Up and Running with DB2 for Linuxhttp://publib-b.boulder.ibm.com/Redbooks.nsf

z Quick Beginningshttp://www-306.ibm.com/software/data/db2/udb/support/manualsv8.html

AIX, Linux: Linking to a JDK that was not installed by DB 2 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).

34

-------------------------------------------------------------------------------

IBM Workplace Collaboration Services 2.6.1 Release Notes

Installing IBM Workplace Collaboration Services

AIX, Linux, Solaris: "Launch Getting Started " link fails If clicking on the "Launch Getting Started" link does not correctly launch that Web page, you can locate the IBM Workplace Collaboration Services Information Center by pointing your Web browser at the following address:

http://publib.boulder.ibm.com/infocenter/lwpphelp/index.jsp

Error messages during AIX console install The following error messages are harmless and can be ignored if encountered on AIX 5.2 or 5.3:

Checking for required operating system and software prerequisites. Please wait.

Operating System prerequisite check failed. Refer to the message log file /tmp/lwai/lwpinstalllog.txt for additional information.

[OK]

Setup will install IBM Workplace in the following directory. To install to a different directory, click Browse and select another directory.

Directory: (requires 7.5 GB available space)

Enter a directory: [/opt/IBM/Workplace] /usr/WebSphere

ERROR: JNI: Could not get file system info for /cd1-10.

Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

35

IBM Workplace Collaboration Services 2.6.1 Release Notes

Completing Collaborative Learning setup

Reports not running on Linux, Solaris or AIX If Learning Reports do not run successfully on Linux, Solaris or AIX IBM Workplace deployments, ensure that Xvfb is running and DISPLAY is set to the same display as Xvfb is using. This should be done before the server is started

For example, for "server.ibm.com" where Xvfb is set to use display 1.0:

z Stop all servers

z Export DISPLAY=server:1.0

z Start all servers

Note: Although in most cases you can use either, if the fully-qualified name does not work, use the short name instead.

Installing the Managed Client provisioning server

After provisioning, client does not always restart automatically Occasionally a problem occurs while the client attempts to shutdown after provisioning, preventing it from restarting automatically. If this happens, check for any leftover 'rcp' processes using the following command-line command:

ps -eadf | grep rcp

If there are any remaining 'rcp' processes, kill them and then launch the client from the desktop icon. The client should then function normally.

Installing provisioning server on UNIX When installing the IBM Workplace client provisioning components on a UNIX server, if the administrator launches with "./setupLinux.bin" or "./setupAix.bin," the CD-ROM drive will not open after the installer prompts for a second disk. Attempting to unmount the drive returns an Unmount error: "unmount: /mnt/cdrom: device is busy." This is because the shell that was used to launch the installer still has /mnt/cdrom as its current working directory, and the shell has thus locked that directory.

To run the installer, change the directory to /mnt instead of /mnt/cdrom, and use the command "cdrom/setupLinux.bin" or "cdrom/setupAix.bin." Alternatively, launch the installer by double-clicking it in a graphical explorer window such as Nautilus or Konqueror.

If the installer has already partially completed, reboot the system to unlock the drive, use rpm -e <package> to remove the packages it installed (all beginning with IBM_LWP_S_MC), then re-launch the install as described.

36

IBM Workplace Collaboration Services 2.6.1 Release Notes

Linux - Can't download client from provisioning server After installing IBM Workplace Managed 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 - Mozilla bean not showing up in client installer When installing the Workplace Managed 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 following ftp URL http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.4.1/contrib/mozilla-1.4.1-gtk2-xft-svg-c alendar-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 Managed Client platform.

Provisioning server installation UNIX screen display settings When installing the provisioning server on a UNIX system, logged in as root, the following errors may appear:

Xlib: connection to ":0.0" refused by serverXlib: No protocol specified

This is an XWindows configuration issue that can be solved by opening up permissions for all users (including root) to bind to the desktop.

1. As a normal user, issue xhost + to allow anyone to connect to the local display. 2. Become root using su - syntax. 3. Issue an export DISPLAY=:0.0. 4. Run the installation.

37

IBM Workplace Collaboration Services 2.6.1 Release Notes

Uninstall on Linux may take over 7 minutes Uninstall on Linux may take over 7 minutes. This is due to the fact that the Uninstaller is trying to uninstall files that it did not lay down. When Provisioning occurs, other files are installed into the same directories that Install had laid down, therefore during uninstall, it takes a bit longer because it is trying to remove files that it did not put in those directories.

Installing IBM Workplace Managed Client

Download error on UNIX caused by incorrect file permissionsWhen downloading the IBM Workplace Managed Client from a UNIX server, such as a SuSE Linuxserver, incorrect file permissions can cause the download to fail.

To correct this situation, change file permissions on the following two directories (and subdirectories) to 755. For example, use chmod -r 755 directoryname for these directories, and then restart the Workplace Managed Client download.

z /opt/IBMIHS/htdocs/en_US/lwpupdate z /opt/IBMIHS/htdocs/en_US/lwpinstall

Linux - Mozilla version and file reqs for WMC install When installing Workplace Managed Client onto a Linux Red Hat release 4 system, users may receive a "cannot validate Mozilla version" error following the License Agreement panel. This will occur if the gre.conf file is missing from the /etc/gre.d path. The gre.conf file is installed when the Mozilla Web browser is installed from a Red Hat Package Manager (.RPM) file. The /etc/gre.d/gre.conf file informs the Workplace Managed Client installation program what to use for an embedded browser. This error will cause the installation program to fail.

To avoid this problem, administrators should run the Mozilla RMP file (located on RHEL4 U3 CD#3) and install Mozilla so that /etc/gre.d/gre.conf is on the user's system. Users can then download and installWorkplace Managed Client .

If you do not use the Mozilla RPM file to install Mozilla, you must install Mozilla 1.4.1 or greater with gtk2+ binding and create the gre.conf file manually to include the text below.

[1.7.10]GRE_PATH=/usr/lib/mozilla

The first line contains the version number which should be >= 1.4.1 and the second line contains theGRE_PATH variable which should point to where you have Mozilla installed on your machine.

Refer to the following URL for details:http://developer.mozilla.org/en/docs/GRE_Registration

38

IBM Workplace Collaboration Services 2.6.1 Release Notes

Windows: Installation notes

Completing external HTTP server setup

Learning Requirements when connected to MS IIS 5.0 HTTP Server When setting up a 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

Installing IBM Workplace Managed Client

Clicking Internet Explorer Back button restarts applet download In a server-based Workplace Managed Client installation, the user clicks the Workplace Managed Client link on the server's Downloads page and then clicks Start Download to initiate applet download and client installation. When using an Internet Explorer browser in conjunction with this process, clicking the browser's Back button restarts the download process.

39

IBM Workplace Collaboration Services 2.6.1 Release Notes

i5/OS: Installation notes

Planning and requirements

i5/OS: Getting started with LDAPIf you haven't used LDAP on IBM i5/OS before, the IBM eServer iSeries Information Center is a greatresource for finding more information. Visit the Information Center on the Web at:

http://publib.boulder.ibm.com/infocenter/iseries/v5r3/ic2924/index.htm

The following sections may be of interest:

e-business and Web Serving -> Security and Directory Server -> Directory Server (LDAP) -> ConceptsIf you are not familiar with LDAP as a technology, you should start here. Pay particular attention to thetopics "Directories", "Distinguished Names (DNs)", and "Suffix (naming context)".

e-business and Web Serving -> Security and Directory Server -> Directory Server (LDAP) -> Get Started -> Plan This section has information on how to plan your directory.

e-business and Web Serving -> Security and Directory Server -> Directory Server (LDAP) -> Get Started -> Configure The Directory Server is installed with a default configuration. This topic gives instructions on how to reconfigure the directory using iSeries Navigator. It also gives instructions on how to use iSeries Navigator to configure the IP address and port the directory will listen on.

e-business and Web Serving -> Security and Directory Server -> Directory Server (LDAP) -> Administer Server This topic has lots of good information like how to start and stop the directory server, how to add and remove Directory Server suffixes, import entries from an LDIF file, etc. It also has links to information on how to add entries to the directory and work with them, but you’ll want to check out the next topic first to learn how to set up the Web Administration tool before trying these steps.

e-business and Web Serving -> Security and Directory Server -> Directory Server (LDAP) -> Get Started -> Web Administration One tool that can be used to work with the entries in your directory is the Web Administration tool that is available starting with V5R3. In order to use the Directory Server Web administration tool, the following products must be installed on the IBM eServer i5 server:

z IBM® HTTP Server for iSeries (5722-DG1) z IBM WebSphere® Application Server - Express (5722-IWE Base and Option 2)

40

IBM Workplace Collaboration Services 2.6.1 Release Notes

Networking -> TCP/IP applications, protocols, and services -> Email -> Manage e-mail -> Host DominoLDAP and Directory Services on the same iSeries

The Directory Server is not the only LDAP directory that can run on i5/OS. Domino LDAP on i5/OS is also an option. Both types of LDAP directories can be run at the same time in the same partition, but there is the possibility of port conflicts. Read this topic for instructions on how to resolve these issues.

If you select to allow write access to the LDAP directory, the IBM Web Administration for i5/OS - Create Workplace Collaboration Services wizard will help you create the proper container objects for users and groups and the Workplace administrator user if they don’t exist. To select this option you will have to supply the DN and password of a user that has the proper write authority to the directory. The LDAP administrator DN and password are recommended, so you’ll want to make sure you know what those are before running the wizard. The LDAP administrator’s DN can be found in the Directory Server properties interface accessed with iSeries Navigator. The administrator’s password can also be changed through that interface.

Finally, you will also want to review the following release notes related to Directory Server on i5/OS:

z "ibm-entryUUID attribute missing in older i5/OS LDAP entries" z "Performance issues with very large i5/OS LDAP directories"

i5/OS: Database table partitioning not supported Database table partitioning is not supported on IBM i5/OS for this release. Support for table partitioning on i5/OS is planned for future releases of Workplace Collaboration Services.

Note: The "Requirements for i5/OS" topic of the local Information Center, which shipped with the product, incorrectly states that database table partitioning is supported for Workplace Collaboration Services on i5/OS. This has been corrected in the release notes and the latest version of the Information Center available on the Web.

i5/OS: Performance issues with very large LDAP directories Performance issues may arise when IBM Workplace Collaboration Services uses an IBM Tivoli Directory Server for iSeries that contains more than 10,000 users. If you plan on having a very large number of users in your LDAP directory, it is recommended that you run the directory server on another platform. This will be the recommendation for very large directories until the problem can be fixed in a future release of IBM i5OS.

i5/OS: Vertical clustering not supportedIBM Workplace Collaboration Services does not support vertical clustering on the IBM i5/OS platform. In other words, on i5/OS, each node in the cluster must reside on a different system.

41

IBM Workplace Collaboration Services 2.6.1 Release Notes

Installing IBM Workplace Collaboration Services

i5/OS: Use the Create IBM Workplace wizard for single -server If you are installing IBM Workplace Collaboration Services on a single server on IBM i5/OS, it is strongly recommended that you use IBM Web Administration for i5/OS to set up your environment. IBM Web Administration for i5/OS includes a Create IBM Workplace Collaboration Services wizard to help you configure all the components of a production-ready environment.

To use the Create IBM Workplace Collaboration Services wizard, make sure you select the IBM Workplace setup wizard for i 5/OS option when installing the software. If you select this option, the last screen of the installation program will provide a link to the wizard.

Custom configuration is also available for advanced users. If you will be performing custom configuration, select the Custom configuration option in the installation program. After installation, you will need to configure each component of your environment individually following the product documentation. This includes configuring Virtual Network Computing, setting up database and LDAP using the Configuration Wizard, and manually configuring an external HTTP server.

i5/OS: EXTMEDFMT flag must be set to *YES for DVD install If you are installing on i5/OS from a DVD, the Support extended media formats (EXTMEDFMT) flag must be set to *YES on your server. To set this flag, enter the following on an i5/OS command line:

CHGOPTA EXTMEDFMT(*YES)

i5/OS: Canceling an installation If you need to Cancel an active configuration of a Workplace instance, you need to follow these steps to ensure all the running processes are properly ended:

1. Press the Cancel button on the configuration screen.

2. If the screen remains active, end the application named "IBM Workplace Installer" using Windows task manager.

3. Login to the i5/OS system and run the following command to view all running jobs by your user profile.

WRKOBJLCK <user-profile> *USRPRF

4. End the jobs named QP0ZSPWP.

5. Remove the lock file /tmp/InstallShield/lwai/lwpinstall.lockfile on the i5/OS system.

42

IBM Workplace Collaboration Services 2.6.1 Release Notes

i5/OS: Console install program may not display all text If you are using IBM Personal Communications to install IBM Workplace Collaboration Services in console mode, your session must be configured with a screen size of 27 x 132. Smaller screen sizes may cut off portions of text displayed by the installation program.

To change an existing Personal Communications session to the correct screen size:

1. Start IBM Personal Communications.

2. Start the session you wish to configure.

3. Select Configure from the Communication menu.

4. Click Session Parameters ...

5. In the Screen Size menu, select 27 x 132.

6. Click OK to save changes in the Session Parameters dialog box.

7. Click OK to save changes to the session.

i5/OS: Remote database server must be added to WAS Resources The Create IBM Workplace Collaboration Services wizard for i5/OS does not set a value for serverName custom property in the LWPAPP data source (resources.xml). If you are running Workplace with a remote database, perform the following additional steps:

1. Login into WebSphere Administrative console with administrator authority . 2. Click Resources on the left panel. 3. Click JDBC Providers > lwp25JDBC > Data Sources > lwpApp > Custom Properties. 4. Enter the fully qualified host name of the database server under the field Value.

5. Save.6. Restart the Workplace server.

i5/OS: Remote silent config needs added propertyWhen running a remote silent configuration for i5/OS, add the following property to the install responsefile:

################################################################################## IBM Lotus Workplace Configuration type (i5/OS ONLY)## Description: Select the type of configuration for IBM workplace. Configuration# type can be set to "wizard" or "custom".################################################################################

-W i5configType.selectedSetupTypeId="custom"

43

IBM Workplace Collaboration Services 2.6.1 Release Notes

i5/OS: Silent install may fail Installation of the Managed Client on i5/OS will fail if you are using the silent install method, and have not run the lwpGenPluginCfg.sh script ahead of time. For instructions on running this script, see the release note "i5/OS users must run lwpGenPluginCfg.sh script before install."

Connecting to an LDAP directory

i5/OS: ibm-entryUUID attribute missing in older LDAP entries IBM Workplace Collaboration Services requires the ibm-entryUUID attribute to be associated with the LDAP entry of each user. When entries are created in i5/OS V5R3, this attribute is created automatically. However, if you have entries in the LDAP directory that were created before i5/OS V5R3 (i.e. OS/400 V5R2 or earlier), and those users will use Workplace Collaboration Services, then you must follow the steps in this release note to add the ibm-entryUUID attribute to those entries.

Determining if the ibm-entryUUID attribute exists Follow these steps to determine if the ibm-entryUUID attribute exists:

1. Start the QShell Interpreter by entering the following on an i5/OS command line:

STRQSH

2. Enter the following command:

ldapsearch -h <ldap_host_name> -b "<ldap_suffix>" objectclass=personibm-entryUUID

If the ibm-entryUUID attribute exists, you will see the ibm-entryUUID attribute listed as it is in the following example:

uid=wpsadmin,cn=users,DC=LP05Y7M,DC=RCHLAND,DC=IBM,DC=COM ibm-entryUUID=74c97805-74c7-1896-98ff-0004ac0395e3

Adding the ibm-entryUUID attribute The easiest way to add the ibm-entryUUID attribute if it does not exist is to export the LDAP directory, and then import it back into i5/OS. When the directory is imported into i5/OS V5R3, the ibm-entryUUID attribute is automatically created for all entries.

To add the ibm-entryUUID to all LDAP entries, follow these steps:

1. Start IBM iSeries Navigator.

2. In the left-hand navigation pane, select Network -> Servers -> TCP/IP.

3. Find the i5/OS library that contains the LDAP database library (default is QUSRDIRDB). To find out which library contains the LDAP database library:

z Right-click IBM Directory Server in the right-hand pane. z Click Properties.

44

IBM Workplace Collaboration Services 2.6.1 Release Notes

z Note the Database library listed on the Database/Suffixes tab:

4. Back up the current LDAP database library by entering these commands on an i5/OS command line:

CRTSAVF <mylib>/<mysavf>SAVLIB LIB(<ldap_database_library>) DEV(*SAVF) SAVF(<mylib>/<mysavf>)

where mylib and mysavf are the library and save file you are using to back up the LDAP database library, and ldap_database_library is the LDAP database library noted in the previous step.

5. Export the LDAP directory:

z Right click IBM Directory Server in the right-hand pane. z Click Tools -> Export File.

45

IBM Workplace Collaboration Services 2.6.1 Release Notes

z Specify the name of the file to contain the exported data and click OK.

6. End the LDAP server:

z Right-click IBM Directory Server in the right-hand pane. z Click Stop.

7. Clear out the existing LDAP database library:

z Enter the following command on an i5/OS command line:

CLRLIB LIB(<ldap_database_library>)

z Reply to the message "Receiver QSQJRN0005 in QUSRDIRDB never fully saved" with an "I"

8. Import the directory. This will create the missing ibm-entryUUID attributes.

z Right-click IBM Directory Server in the right-hand pane. z Click Tools -> Import File. z Specify the name of the file that contains the exported data and click OK.

46

IBM Workplace Collaboration Services 2.6.1 Release Notes

9. Start the LDAP server:

z Right-click IBM Directory Server in the right-hand pane. z Click Start.

10. If the LDAP server is replicated, export the LDAP directory again:

z Right-click IBM Directory Server in the right-hand pane. z Click Tools -> Export File. z Specify the name of the file to contain the new exported data and click OK.

11. Repeat steps 1-4 and 6-9 on each replicated LDAP server, using the export_with_ibm-entryUUID.ldif file in step 8 instead of export.ldif.

Restoring the LDAP directory to its original state If for some reason you need to restore the LDAP directory to its original state, follow these steps to restore the backup you created in step 4 of the previous procedure:

1. End the LDAP server:

z Start iSeries Navigator. z Right-click IBM Directory Server in the right-hand pane. z Click Stop.

2. Enter these commands on an i5/OS command line:

CLRLIB LIB(<ldap_database_library>)RSTLIB SAVLIB(QUSRDIRDB) DEV(*SAVF) SAVF(<mylib>/<mysavf>)

3. Start the LDAP server:

z In iSeries Navigator, right-click IBM Directory Server in the right-hand pane. z Click Start.

47

IBM Workplace Collaboration Services 2.6.1 Release Notes

Connecting to a DBMS server

i5/OS Authorization issue if DB Admin and DB App users different If you used the Database Transfer wizard to configure IBM Workplace Collaboration Services on i5/OS manually, note the following:

You may experience SQL errors while users are taking courses if you specified different values for the DB Admin user and DB App user (LWPDBAdminUser and LWPDBAppUser). This screen shot is an example of where you fill in these values:

48

IBM Workplace Collaboration Services 2.6.1 Release Notes

Example 1 Errors found in the log file /qibm/userdata/webas5/base/<instance>/portalserver/log/systemout.log

[3/10/05 9:54:37:194 UTC] 889bf197 SystemOut O [3/10/05 9:54:37:194 UTC] 13d31be0 persist E CLPAA0038E: [SQL0551] Not authorized to object LRNPA00001 in LWPLDS24 type *FILE. on thread [Servlet.Engine.Transports : 4].::SITUATION: FeatureSituation::CLPAA::E5998D5B19E2DDE969BFDF90914A11D9::9.5.63.41::IPV4::th read=Servlet.Engine.Transports : 4 [3/10/05 9:54:37:211 UTC] 13d31be0 persist E TRAS0014I: The following exception was logged java.sql.SQLException: [SQL0551] Not authorized to object LRNPA00001 in LWPLDS24 type *FILE.

Example 2 Error you would see on your browser:

Workaround

z Find out what the name of your DS schema is. To do this, look for the LWPLDSSchema property in:

/QIBM/UserData/WebAS5/Base/<instance name>/WorkplaceServer/config/database/dbbuild.properties:

LWPLDSSchema=

z Find the user profile that is missing authority to the tables. Use the wrkobj OS400 command to determine this; for example, if lwplds24 = DS schema then do:

wrkobj lwplds24

49

IBM Workplace Collaboration Services 2.6.1 Release Notes

then "Display authority" (option 5):

The user with the *USE authority is the one that needs to be added to the tables. In this example,LWPAPP is the user that needs to be added.

z Run the following OS400 command to grant the user the correct access rights to the LRNPARTITION and LRNUSER_PARTITION tables

GRTOBJAUT OBJ(LWPLDS24/LRN*) OBJTYPE(*FILE) USER(LWPAPP) AUT(*ALL)

Here is an example of the output if the command was successful:

Authority given to user LWPAPP for object LRNPA00001 in LWPLDS24 object type *FILE. Authority given to user LWPAPP for object LRNUS00001 in LWPLDS24 object type *FILE. Authority given to 2 objects. Not given to 0 objects. Partially given to 0 objects. Objectauthority granted.

z The authority SQL errors should go away (no need to restart the servers).

50

IBM Workplace Collaboration Services 2.6.1 Release Notes

i5/OS: Users may experience problems using Toolbox JDBC driver To ensure the Toolbox JDBC driver (for remote databases) functions properly with IBM Workplace Collaboration Services, i5/OS users must manually update the WCM.properties file and add the serverName property to the WPCP datasource.

Updating the WCM .properties file To update the WCM.properties file when using the Toolbox JDBC driver, follow these instructions:

1. Open the following file in a text editor or with the EDTF i5/OS command:

/QIBM//UserData/WebAS5/Base/<instance>/wpcp/config/WebSphere_Portal/author/WCM.properties

where instance is the name of the Workplace Collaboration Services instance.

2. Add the following line to the file:

wcm.as400.WpcpDbSchema=<wpcp_schema>

where wpcp_schema is the name of the WPCP schema associated with the instance. If you don't know the name of the WPCP schema, look for the value listed for the property WpcpDbSchema in the following file:

/QIBM/UserData/WebAS5/Base/<instance>/PortalServer/wpconfig.properties

3. Save your changes to the WCM.properties file.

Adding the serverName property to the WPCP datasource To add the serverName property to the WPCP datasource when using the Toolbox JDBC driver, follow these instructions:

1. Start the IBM WebSphere Application Server Administrative Console by entering the following into theaddress bar of a Web browser:

http://<hostname.yourco.com>:<port>/admin

where hostname.yourco.com is the host name of your server, and port is the port assigned to the administrative console. On i5/OS, this is the base port of the instance, plus 10. For example, if you specified 30000 as your base port number of your instance, the WebSphere Administrative Console would be port 30010.

2. Click Resources -> JDBC Providers -> wpcp50JDBC -> Data Sources -> wpcpdfds -> Custom Properties -> New.

3. In the Name field, enter serverName.

4. In the Value field, enter the host name of the system that contains the remote database.

5. Click Apply.

6. Save the changes in the WebSphere Application Server Administrative Console.

7. Restart Workplace Collaboration Services.

51

IBM Workplace Collaboration Services 2.6.1 Release Notes

Remote i5/OS database grant failure When Workplace Collaboration Services schemas are located on a remote i5/OS database, and the database administrator's user ID is different from the application user's ID, then after running a database transfer, the database administrator must sign on to the remote system and manually grant *USE authority to the database application user ID, for access to the schemas.

The command to run for each schema is:

GRTOBJAUT OBJ(QSYS/<schema name>) OBJTYPE(*LIB) USER(<db app user>) AUT(*USE)

To find the schema names, look for the following properties in /QIBM/UserData/WebAS5/Base/<instance name>/WorkplaceServer/config/database/dbbuild.properties:

LWPMsgSchema= LWPLMSSchema= LWPLDSSchema= LWPComSchema= LWPArcSchema=

Completing Collaborative Learning setup

i5/OS: Verify FTP attributes before using i 5/OS as FTP server If you want to use i5/OS as the FTP server when you import courses via the Authoring Tool, make sure the i5/OS FTP attributes are set properly. Use the CHGFTPA command, to do this. Note that this will change the behavior of FTP on the entire system.

Change the "Initial name format" from *LIB to *PATH and "Initial directory" from *CURLIB to *HOMEDIR.

52

IBM Workplace Collaboration Services 2.6.1 Release Notes

Also make sure the user profile you use for FTPing of courses has a valid home directory. Use the chgusrprf command if necessary:

Be sure the directory you specify exists (in the above example, /home/ftpuser).

Installing the Managed Client provisioning server

i5/OS: Custom install summary information incorrect When installing the Managed Client on i5/OS using the Custom install method, the installation program's summary panel will indicate that all components are being installed rather than just those selected by the user. The user should ignore the information displayed on the summary panel and assume that only the selected components are being installed.

53

IBM Workplace Collaboration Services 2.6.1 Release Notes

i5/OS: Enter absolute path to disk 2 if in console mode If you are installing in console mode on IBM i5/OS, you must specify the absolute path to the contents of disk 2 when prompted. If you specify a relative path to this directory, the installation will still complete without error; however, it may cause problems with your deployment.

Example of absolute path (correct): /opt/downloads/WmcSCI2

Example of relative path (incorrect): ../WmcSCI2

i5/OS: EXTMEDFMT flag must be set to *YES for CD/DVD install If you are installing the Managed Client provisioning server on i5/OS from a CD or DVD, the Support extended media formats (EXTMEDFMT) flag must be set to *YES on your server. To set this flag, enter the following on an i5/OS command line:

CHGOPTA EXTMEDFMT(*YES)

i5/OS: Remote install from CD is not supported The Managed Client provisioning server does not install properly from the CD media when doing a remote installation from a workstation connected to an IBM System i server. When a remote installation is performed from CD, the contents of the first CD fail to be installed in /QIBM/ProdData/Workplace/WMC26/WMCSCI1. Also, when prompted for the second CD, the path to the CD/DVD drive will be incorrect (for example, Please insert disk 2 D:").

Workarounds To work around this issue, do one of the following:

z Install the provisioning server locally by inserting the CD into the optical drive of your server and running the setupi5OS.sh script.

z Copy installation files from the CDs to your workstation and run the installation remotely from there, as described below.

Installing remotely from files copied to your workstation Follow these steps to install the Workplace Managed Client provisioning server remotely from installation files copied to your workstation. To copy the installation files, you will need at least 1.1 GB free space on your hard drive.

1. On your remote workstation, create the following folders to store the installation files for the ManagedClient provisioning server:

C:/ManagedClientInstall C:/ManagedClientInstall/disk1 C:/ManagedClientInstall/disk2

2. Insert the first disk of the Managed Client provisioning server into your CD-ROM drive and copy the entire contents of the disk to C:/ManagedClientInstall/disk1.

54

IBM Workplace Collaboration Services 2.6.1 Release Notes

3. Insert the second disk and copy the entire contents into C:/ManagedClientInstall/disk2.

4. Start installation of the Managed Client provisioning server by double-clicking C:/ManagedClientInstall/disk1/setupi5OS.bat.

5. When prompted for disk2, enter the path C:/ManagedClientInstall/disk2.

i5/OS: Users must run lwpGenPluginCfg .sh script before install If you are installing the Managed Client on an i5/OS server using the Managed Client installation program, run the lwpGenPluginCfg.sh script to ensure the correct default information is displayed on the installation panels.

Note: You do not need to follow these steps if you are using IBM Web Administration for i5/OS to set up the Managed Client.

To run the script, follow these steps:

1. Start the QShell Interpreter by entering the following on an i5/OS command line:

STRQSH

2. Change to the Workplace Collaboration Services bin directory by entering the following:

cd /QIBM/UserData/WebAS5/Base/<instance>/workplaceserver/bin

where instance is the name of your Workplace Collaboration Services instance.

3. Enter the following command:

lwpGenPluginCfg.sh

55

IBM Workplace Collaboration Services 2.6.1 Release Notes

Upgrade notes

Automatic Update preference removed and functionality revisedThe Workplace Managed Client menu sequence File > Preferences > Update /Install > AutomaticUpdates preference page has been removed. An update search occurs on an a preset schedule, whichcan be configured with administrator- set preferences. The default setting checks for updates threeminutes after login and then hourly thereafter.

Check for updates to CD or HTTP server -installed clientsA "Check for updates" menu item has been added that enables the standalone IBM Productivity Tools,which may have been installed from a CD-ROM or from an HTTP server, to search for updates.

For clients installed from a CD, selecting this action will look for updates on a CD; for HTTPserver-installed clients, this action will look for updates on the HTTP server. The location from which toobtain updates matches the location from which the client was first provisioned. For example, the locationfrom which CD-installed updates are obtained is typically the updateSite directory on the CD.

IBM Workplace Messaging : New Mail settings in user policiesMail size enforcement and Out of Office notification are new features in WCS 2.6. However, whenupgrading from 2.5.1 to 2.6, existing user policies do not inherit the default settings for these new mailsettings. If you want to take advantage of these new features, you must edit your existing user policies tomanually select these options.

In a user policy, the mail details page has a new setting that prevents a user from sending mail when the user reaches the mail quota size limit; it also limits a user to composing messages no larger than 4 MB, and it allows a user to send Out of Office notifications. Mail quota enforcement is an enhanced feature in2.6 - the only option before 2.6 was to automatically delete all messages older than the retention period. In 2.6, the new and default behavior is to disable Send, Forward, andRreply operations when a user's mail size reaches the quota limit.

For servers upgraded from pre-2.6 releases, custom user policies and the default user policy will contain these three new user policy settings, but you must select these options and change your policies to usethese feature and quota limit:

-- When user exceeds maximum mail storage: Disable Send, Forward, and Reply-- Maximum size of a message (MB): Limit 4 MB. -- Allow out of office messages

56

IBM Workplace Collaboration Services 2.6.1 Release Notes

Upgrade produces a benign warning message The following warning is logged during the upgrade from IBM Workplace Collaboration Services 2.5.1 to 2.6:

[xmlaccess] <message>com.ibm.wps.command.xml.XmlCommandException : XMLC0060W: A user or group with ID cn=wpsContentAdministrators,o =default organization could not be retrieved from the portal datastore, possibly because it does not exist . Related access-control configuration data will not be updated. [content-node Content.Root.Administration.Portal uniquename=wps.Portal Content]</message>

This error occurs because security is enabled and the configuration process does not create the administrator group wpsContentAdministrators . You can safely ignore this message.

Upgrading IBM Workplace Designer when upgrading to WCS 2.6 You can upgrade Workplace Collaboration Services server from version 2.5.1 to version 2.6 by installing a service pack using the portal upgrade installer (PUI) utility. If Workplace Designer 2.5 is installed on the Workplace Collaboration Services 2.5.1 server, you must perform these steps to upgrade to Designer 2.6 when upgrading to Workplace Collaboration Services 2.6 server:

1. Users must export any existing components they want to save. 2. Users must uninstall the Designer 2.5 tool from client computers. 3. An administrator must upgrade to Workplace Collaboration Services 2.6 server with the PUI. 4. Users must install the Designer 2.6 tool on client computers. 5. Users must import the components back into Designer.

For information on exporting and importing Designer components, see the Designer Help.

For information on upgrading Workplace Collaboration Services server, see the topic "Upgrading to IBM Workplace Collaboration Services 2.6" in the IBM Workplace Collaboration Services 2.6 information center, available on the Web at http://www.ibm.com/developerworks/workplace/documentation/collaborationservices/.

For information on uninstalling Workplace Designer 2.5, see the Workplace Designer 2.5 Installation Guide on the Web at http://www.ibm.com/developerworks/workplace/documentation/designer/.

For information on installing Workplace Designer 2.6, see the Workplace Designer 2.6 Installation Guide on the Web at http://www.ibm.com/developerworks/workplace/documentation/designer/. (Note that the topic "Installing the IBM Workplace Designer Runtime" is located in the section on installing in an IBM Workplace Services Express server environment. Normally, you would not need to install the Designer runtime on a Workplace Collaboration Services 2.6 server, because the runtime is part of the server. This upgrade scenario is exceptional however, and you must follow these instructions to install the runtime on Workplace Collaboration Services 2.6 server.)

57

IBM Workplace Collaboration Services 2.6.1 Release Notes

Upgrading provisioning server from 2.5.1 to 2.6If you have enabled the IBM Workplace Managed Client for users, you must upgrade the WorkplaceManaged Client provisioning server from release 2.5.1 to 2.6. Upgrading the provisioning server to thelatest release will enable each user's Workplace Managed Client installation to provision the client withthe latest features and plug-ins when the client connects to the provisioning server for updates.

Single node deployment : If upgrading from 2.5.1 to 2.6 in a single node environment, the adminstrator should uninstall the oldversion and then (re-) install the new version provisioning server.

Clustered deployment : If upgrading from 2.5.1 to 2.6 in a clustered deployment, the administrator must follow these steps (as also described in the readme and Informationcenter help):

Upgrading theWorkplace Managed Client from one release to another®

Each time a user starts the IBM Workplace Managed Client™, the system checks the provisioning server to determine if there are updates available. If updates are available, or if user policy settings have changed, the user is prompted to update his client. This is also true when the user, while active and working online in the Workplace™ Managed Client, selects an application from the switcher bar. Typically the system checks for updates three minutes after starting the Workplace Managed Client and then subsequently using an update interval set by the administrator or the default 24 hour interval.

Feature and plug-in update is associated to user policy settings. User policy settings are downloaded from the server to a file (RCPML file format) on client desktops. The RCPML file is an integral part of the update and release upgrade process.

Note: RCPML is a programmatic markup language used internally to set client capabilities for a user or ®

user group. For example, user policy information established in the WebSphere Application Server Administrative Console is transferred to the user's desktop as RCPML settings. This type of RCPML controls, for example, which Workplace Managed Client feature capabilities a particular user or user group is authorized to use.

If you have enabled the Workplace Managed Client for users, you must upgrade the Workplace Managed Client provisioning server from the old release to the new release. Upgrading the provisioning server to the latest release will enable each user's Workplace Managed Client installation to provision the client with the latest features and plug-ins when the client connects to the provisioning server for updates.

For Workplace Managed Client user -- After the administrator upgrades the provisioning server, the user should log in to the Workplace Managed Client to access the latest Workplace Managed Client capabilities. The user should not uninstall an old release and install a new release in order to access the latest capabilities.

For Workplace Managed Client administrator -- To upgrade to a new Workplace Managed Client release, uninstall the provisioning server and install the latest version provisioning server.

In a single server deployment, if all provisioning server components are on the Portal server, uninstall the old release and install the new release provisioning server using the uninstall and install instructions provided in the Information Center help system using the related links at the bottom of this page. z In a single server deployment, if all provisioning server components are on the Portal server then

uninstall everything. z In a single server deployment, if the provisioning server components are on the Portal server and

the HTTP components are on a separate server HTTP server then uninstall both separately. z After uninstalling the provisioning server from the Portal server, check that the wctinstall and

wctplaceholder items are no longer resident in the enterprise applications. If they still remain, they should be uninstalled using the WebSphere administrative console.

58

IBM Workplace Collaboration Services 2.6.1 Release Notes

Note: The administrator may need to apply an iFix or fix pack from the IBM software support site. Note: Additional provisioning server upgrade instructions may be found in the release notes and in the Upgrade section of this Information Center help system.

To upgrade the provisioning server in a clustered environment, perform the following tasks: 1. Locate the archive copy of wps.ear. Make a backup copy of this version of the wps.ear in case

you need to roll back the upgrade to the original 2.5.1 version. Note: To locate this copy, view the properties for the wps application in the WebSphere Administrative Console and find the value of the Application Binaries field. This will be something like $(APP_INSTALL_ROOT)/cell_name/wps.ear (or app_server_root/config/cells/cell_name /applications/wps.ear/wps.ear) where cell_name is the name of the cell created for the Workplace Collaboration Services servers. On the primary node (Node 1) the value of APP_INSTALL_ROOT is normally the AppServer/installApps subdirectory of where you have installed WebSphere.

2. On the HTTP server, uninstall the 2.5.1 Workplace Managed Client provisioning server and select only the following customized options from the Custom Install panel: Update bundles (installed on HTTP server)

License files

Installation files (installed on HTTP server)

Note: If you have multiple HTTP servers, repeat the above steps on each server. 3. Install the Workplace Managed Client provisioning server and select only the following

customized options from the Custom Install panel: Update bundles (installed on HTTP server)

Installation files (installed on HTTP server)

CD script to create installation disks (installed on HTTP server)

Note: Selecting these options installs the update bundles and bootstrap installer. 4. Verify that the bundles are placed in IBMHttpServer\htdocs\en_US\lwpupdate\wct and that

setup_wct_platform.exe and setup_wct_platform.bin are placed in directory IBM HTTP server\htdocs\en_US\lwpinstall\wct.

5. If you have multiple HTTP servers, repeat the above steps 1-3 on each server or copy the updated content from the server where the updates have been installed to the remaining servers.

6. On all nodes, verify that the files cmm.jar and cmmImpl.jar exist in app_server_root/lib and that they are exactly the same versions as cmm.jar and cmmImpl.jar on the Deployment Manager in deploy_manager_root/lib. If either or both are missing or differ from those on the Deployment Manager, then copy cmm.jar and cmmImpl.jar from the Deployment Manager to each node.

7. On all nodes, verify that the cluster name WebSphere_Portal cluster is of the same value as the key wps.appserver.name in portal_server_root /shared/app/config/services/DeploymentService.properties cluster name.

8. Make sure that all Node 1 node agents and the Web Portal Server are running. Then, on Node 1, uninstall the Workplace Managed Client provisioning server and select only the following customized options from the Custom install panel: WebSphere Portal content (deployed to WebSphere Portal server)

IBM Workplace Managed Client content 9. Check the WebSphere Administrative Console on the Deployment Manager under Enterprise

Applications. If the application wctplaceholder (which will have a suffix such as _PA_1_0_IP ) is still installed, use the Administrative Console to uninstall it.

10. Perform synchronization and then check the synchronization log file at app_server_root /logs/nodeagent/SystemOut.log to determine that the synchronization has completed. Look for something similar to the following log entry: Successful synch: [10/11/06 22:09:58:328 EDT] 2d3f3487 NodeSyncTask A ADMS0003I: Configuration synchronization completed successfully.

59

IBM Workplace Collaboration Services 2.6.1 Release Notes

11. Uninstall the wctinstall.war application on the Deployment Manager by following these steps: a. Open the WebSphere Administration Console b. Click Applications > Enterprise applications. c. Select wctinstall.war and stop the application d. Once the application has successfully stopped, select wctinstall.war and uninstall the

application. e. Click OK or Apply and then Save.

12. Again, ascertain the location of wps.ear, which should be app_server_root/config/cells/cell_name /applications/wps.ear/wps.ear. Depending on the date on which wps.ear was last updated, cell_name may either be the name of the Deployment Manager server (for example, MyDMNetwork) or the name of the primary node. Any errors in updating wps.ear are noted in WorkplaceManagedClientServerInstall>/logs/repackageWpsEarLog.txt and WorkplaceManagedClientServerInstall>/logs/repackageWpsEarErr.txt.

13. With the node agent on Node 1 and the WebSphere Portal Server running, install the Workplace Managed Client provisioning server on Node 1 and select only the following customized options from the Custom install panel: Note: When asked to enter the cell name where wps.ear exists, enter the cell name from step 12.

WebSphere Portal content (deployed to WebSphere Portal server)

IBM Workplace Managed Client content 14. Perform a full synchronization from the Deployment Manager and then check the synchronization

log file at app_server_root/logs/nodeagent/SystemOut.log. Look for something similar to the following log entry: Successful synch: [10/11/06 22:09:58:328 EDT] 2d3f3487 NodeSyncTask A ADMS0003I: Configuration synchronization completed successfully. All nodes should now be running and synchronized.

15. Activate the RCPML portlets associated with wctplaceholder.war, lwp.dbtoolsPortlets.war, webconfplaceholder.war, and learningplaceholder.war.

a. Log in to the Portal Application Server as an administrator. b. Click the Administrator link. c. Click Portlets. d. Click Manage Applications. e. Select the four .war files, and activate the portlets that are displayed.

16. On Node 1 (where the provisioning server was installed in step 13), copy the wctinstall.war file found in app_server_root/installableApps/wctinstall.war, to the Deployment Manager directory deploy_manager_root/WebSphere/DeploymentManager/installableApps.

17. Deploy wctinstall.war as follows: a. Open the WebSphere Application Console. b. Click Expand Applications. c. Click Enterprise Applications. d. Click Install Application. e. In the local path, type the location to which you copied wctinstall.war in a previous step

and then click Next. f. Specify the context root as /lwp/downloads/wct and then click Next. g. Click Generate Default Bindings and then click Next. h. Choose the default name (wctinstall_war) or enter wctinstall. Use the same name that

you specified when you installed the provisioning server. Typically, this name is wctinstall.

i. Accept all defaults. In Map modules, make sure that wctinstall.war is mapped to the cluster.

j. Save the configuration. k. Click Enterprise Applications and select wctinstall (or the name you specified in step e.)

and then start the application l. Click Environment > Update Webserver plugin and click OK.

Note: If wctinstall fails to start, you must restart the cluster. Verify that the application has been installed correctly by checking the address http://hostname/lwp/downloads/wct to verify the download applet URL.

60

IBM Workplace Collaboration Services 2.6.1 Release Notes

18. The newly installed wctinstall.war contains properties files that must be copied to and updated on the remote HTTP server as specified in the following substeps:

a. On the HTTP server machine, create the http_server_root\htdocs\en_US\wctprops directory.

b. From Node 1, or the system on which you installed the latest version Workplace Managed Client™ provisioning server, copy fileList.props, pluginvalues.props and token-values.props from app_server_root\installed_apps\yourNode \wctInstall.ear\wctinstall.war to the HTTP server http_server_root\htdocs\en_US\wctprops directory.

c. On the HTTP server machine, update the token-values.props file to change the value of 'host=getParameter' to host=http://dispatcher_cluster.notesdev.ibm.com and change the value of 'host-name=getParameter' to host-name=dispatcher_cluster.notesdev.ibm.com. Note: For related information, see the Workplace Collaboration Services installation section "Chapter/Phase 6." The topic in which the .props file are described is entitled "Connecting services on the provisioning server in a clustered environment".

Sample resultant settings are as below: z host=http://dispatcher_cluster.notesdev.ibm.com z host-name=dispatcher_cluster.notesdev.ibm.com

d. On the HTTP server machine, update the pluginvalues.props file. Change the value of 'plugin_customization.com.ibm.workplace.security/com.ibm.wkplc.remote.server.name=$ host-name$'

to

plugin_customization.com.ibm.workplace.security/com.ibm.wkplc.remote.server.name= fully qualified DNS address of your dispatcher cluster.

Also add the following two lines to the pluginvalues.props file:

plugin_customization.com.ibm.workplace.security/com.ibm.wkplc.remote.server.port=The bootstrap port of the nodeagents

and

plugin_customization.SIPSERVER=fully qualified dns name of the host providing SIP services (This should be your dispatcher cluster.)

Sample resultant settings are as below: z plugin_customization.com.ibm.workplace.security/com.ibm.wkpl

c.remote.server.name=dispatcher_cluster.notesdev.ibm.com z plugin_customization.com.ibm.workplace.security/com.ibm.wkpl

c.remote.server.port=2809The bootstrap port of the nodeagents

z plugin_customization.SIPSERVER=dispatcher_cluster.notesdev.i bm.com

e. On the HTTP server machine, leave the fileList.props as is; it does not need to be updated.

19. Ensure that all nodes are synchronized by opening the System Administration/Nodes page and making sure all node agents for all nodes in the cluster are running. Select all nodes and click Full Resynchronize. This operation may take several minutes to complete.

61

IBM Workplace Collaboration Services 2.6.1 Release Notes

20. Redeploy wps.ear on the Deployment Manager as follows: a. Update the workplace_server_root/install/installDM.properties on the Deployment

Manager, based on the values for your organization's deployment, using the information in the Workplace Collaboration Services installation section "Chapter/Phase 9." The topics in which the installDM.properties file is described are entitled "Adding Node 1..." and "Adding subsequent nodes...".

b. Copy the wps.ear file from Node 1 (typically /opt/IBM/Workplace/AppServer/config/cells/applications/wps.ear/wps.ear) to /opt/WebSphere/DeploymentManager/installableApps.

c. Run the wct-dm-config target using the following syntax: ®

Windows :

lwpDMconfig.bat wct-dm-config

®Linux :

lwpDMconfig.sh wct-dm-configNote: The Deployment Manager and node agents should be started before running the wct-dm-config target.

d. Perform a full synchronization of all nodes. e. Restart WebSphere Portal on each node.

21. Verify that all URL providers are created properly using the following steps: a. Log in as the WebSphere Application Server administrator. b. Click Resources > URL Providers. c. Clear any values from Node or Server fields and click Apply. d. Click Default URL Provider. e. Open the Additional properties section and click URLs. f. Verify that the URL providers are set as below and create or correct to reflect the

following content.

Name JNDI Name Description Specification

Workplace Client url/lwpprovisioning Workplace Client http://dns address of http server/Edge Installer download server Installer download ServerDispatcher server server

Workplace Client url/wctprovisioning Workplace Client http://dns address of http server/Edge provisioning server url provisioning server ServerDispatcher

/lwpupdate/wct/site.xml

Workplace Client url/wctpinstall-plugi PluginValue http://dns address of http server/Edge plugin values nvalues properties file ServerDispatcher

/wctprops/pluginvalues.props

Workplace Client url/wctpinstall-toke TokenValue http://dns address of http server/Edge token values nValues properties file ServerDispatcher

/wctprops/token-values.props

Workplace Client url/wctpinstall-files Install file list http://dns address of http server/Edge files list List ServerDispatcher/wctprops/filesList

22. On Node 1, copy WPS_home/shared/app/rcpportal.jar and WPS_home /shared/app/WEB-INF\tld\rcpportal.tld in the Portal_server directory to all other nodes in the cluster.

62

IBM Workplace Collaboration Services 2.6.1 Release Notes

23. Update the HTTP server plug-in, using the following steps: a. Open the WebSphere Administrative Console. b. Click Environment > Update Web Server plugin. c. Click OK.

24. Copy the plug-in.xml to the HTTP server. 25. Change all the DeploymentManager instances to AppServer in the HTTP server's plug-in.xml file. 26. Reboot the HTTP server.

The next time that the user starts the Workplace Managed Client, she will be provisioned with the latest release Workplace Managed Client capabilities.

Configuration notes

Activity Explorer: Improving server response during heavy usage An IBM Workplace Collaboration Services server running Activity Explorer might experience slow performance or become unresponsive when processing a high number of concurrent Activity Explorer operations.

To improve response times on servers that process multiple simultaneous Activity Explorer requests, a governor mechanism on the server limits the number of concurrent Activity Explorer operations by enforcing a wait time on received requests. The wait time increases in proportion to the number of current Activity Explorer operations on the server.

The server calculates the wait time for each request as the product of the number of current Activity Explorer operations and a configurable wait time constant. The number of current operations is taken as the sum of the number of operations in progress and the number of pending operations. The wait time constant is specified by the property ae.governorWaitTime in the Activity Explorer properties file.

When a client initiates an operation, it first requests a wait time from the server. Upon receiving the request from the client, the server returns a wait time and adds the request to its tally of pending operations. The server also records the expected start time of the most recently requested operation. After the client waits for the specified interval, it proceeds with the operation. The server then decrements its tally of pending operations, and adds the operation to its tally of active operations.

The server only enforces a wait time on Activity Explorer requests received while another Activity Explorer operation is still in progress. If there is no operation in progress, a client requesting an operation receives a wait time of zero seconds and is allowed to proceed with its operation immediately. The server only considers processes related to Activity Explorer when calculating the wait time; other server processes do not have an effect on the delay calculation.

To prevent the count of pending operations from being effected by clients that receive a wait time from the server but then disconnect before completing the operation, the server resets the count of pending operations to zero if the last scheduled operation fails to start within five seconds of its expected time.

63

IBM Workplace Collaboration Services 2.6.1 Release Notes

Configuring the wait time constant You can change the value of the constant that is used to calculate wait times.. To modify the wait time constant, perform the following steps:

1. In a text editor, open the server's Activity Explorer properties file, lwpae.properties, located in the following directory:

<workplace_server_root >/lwp_ext/

where <workplace_server_root> is the directory in which Workplace Collaboration Services is installed, for example:

C:\Program Files\IBM\Workplace\WorkplaceServer

2. Locate the following property: ae.governorWaitTime.

The property specifies a value in milliseconds for the wait time constant.

3. Set a value for the constant by typing the number of milliseconds that you want to use for the delay constant.

For example, to specify a wait time constant of 3 seconds, set the value to 3000, as in the following entry: ae.governorWaitTime=3000. To specify a wait time constant of 1.5 seconds, set the value to 1500.

To receive maximize the benefit of the governor mechanism, each IBM Workplace Collaboration Services server that runs Activity Explorer, and each Workplace Managed Client that runs Activity Explorer, must be running version 2.6.1. Clients are updated automatically after they connect to a 2.6.1 server and accept an update from that server.

Although a client that is running version 2.6 and has not received the update can continue to access the server, only clients that are running 2.6.1 will request a wait time from the server before starting an operation and contribute to the server's tally of pending operations. However, in calculating the total number of active operations, includes operations that originate from clients running version 2.6.

If a client running 2.6.1 attempts to connect to a server that is running version 2.6, the client will be prevented from performing any operations, because the server will not return a wait time. In cases such as the preceding, the client log file will report an error similar to the following entry: Unimplemented method

Domino Policies regarding IM in the Workplace client The Notes Application plug-in (NAP) uses Workplace Instant Messaging (SIP) by default. To use Sametime (VP) in the NAP, select the Lotus Notes User Preference 'Use IBM Lotus Sametime Instant Messaging'. Instant Messaging can be enforced by the Domino Server in a Desktop Settings server policy.

To enforce SIP (Workplace) in the Notes plug-in, choose "IBM Workplace Collaboration Services" as the 'Instant messaging provider:' in the Notes Application Plug-in section on the Basics tab of the Desktop Settings policy document.

64

IBM Workplace Collaboration Services 2.6.1 Release Notes

To enforce VP (Sametime IM) in the Notes plug-in, choose "IBM Lotus Sametime" as the 'Instant messaging provider:' in the Notes Application Plug-in section on the Basics tab of the Desktop Settingspolicy document. The first time a user who has a Sametime Desktop policy logs into the Notes plug-in,they may not get the Sametime log on dialog. Restart the Workplace client and log back into the Notesplug-in and now the Sametime log on dialog will be available.

To allow the end-user to choose SIP or VP, choose "Don't Change" as the 'Instant messaging provider:' inthe Notes Application Plug-in section on the Basics tab of the Desktop Settings policy document. If the"Allow users to change the settings in this section" option is selected, and the 'Instant messagingprovider:' is "IBM Workplace Collaboration Services" or "IBM Lotus Sametime", and if the end-userchanges the IM option via the 'Use IBM Lotus Sametime Instant Messaging' Lotus Notes User prefence,that change will be overwritten by the Domino Server policy.

Note: After you choose "Don't Change" as the 'Instant messaging provider:' in the Notes ApplicationPlug-in section on the Basics tab of the Desktop Settings policy document and save the document, the'Instant messaging provider:' will be null; this is by design.

IBM Workplace Messaging : Message size default values differentNew Mail Policy default limits a user (WCS Browser Client or WCT Managed Client) to composing messages no larger than 4M. The maximum size of an outbound message is 2M by default. Although auser can create messages up to 4M, they will not be able to send any message larger than 2M to externalusers. If you wish implement different mail sizes for local and external users, notifying your usercommunity is a good idea to prevent confusion. If you wish to implement consistent limits on local andexternal messages, configure the same size for both the mail message size policy, and the maximum sizeof an outbound message.

Users can compose messages as large as the mail policy will allow. When the user clicks send, there is no further size check if the message is addressed to a local user. If the message is addressed to an external user, there is one more size check - the maximum size of an outbound message. If the message is larger than the maximum send size, the message will not be sent. Instead, when the user clicks send, they will get an error message indicating that the message is too large. If a browser client user composes a message addressed to both local and external recipients, and the message is larger than the configuredmaximum size of an outbound message, the message will not be sent to any recipients. The user will getthe same error message indicating the message is too large.

Message size policy configuration can be found in the Admin UI at: + IBM Workplace Software > Users >Manage User Policies > Default User Policy > [Additional Properties] Mail Details > Maximum Size of aMessage (MB). The default is 4M. Maximum size of an outbound message configuration can be found in the Admin UI at: + IBM Workplace Software > Mail Cell-wide settings > [Additional Properties] > SMTP Outbound/Local Delivery > "Maximum size of an outbound message (KB): 2000".

65

IBM Workplace Collaboration Services 2.6.1 Release Notes

Second attempt at db transfer results in violation constraint If a Portal Database Transfer fails, on the next run, the following error or one similiar to it occurs during the WPCP portion of the task:

1. [java] 09:16:48.375 com.ibm.wps.config.db.transfer.TransferDatabaseTable

transferDatabaseTable main [java] java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for

JDBC][SQLServer]Violation of PRIMARY KEY constraint'PK__DISCUSSIONRES_M__754E3E91'. Cannot insert duplicate key in object 'DISCUSSIONRES_M'.

[java] Transferring table --{ WCMDBADM.DISCUSSIONRES_M}-- to table --{WCMDBADM.DISCUSSIONRES_M }--

[java] at com.microsoft.jdbc.base.BaseExceptions.createException(Unknown Source)

[java] at com.microsoft.jdbc.base.BaseExceptions.getException(Unknown Source)

[java] 09:16:48.375 com.ibm.wps.config.db.transfer.TransferDatabaseTable populateDatabaseRow main

[java] ERROR 1288-- Transferring data of table --DISCUSSIONRES_M-- FAILED 2.

[java] java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for JDBC][SQLServer]Violation of PRIMARY KEY constraint'PK__DISCUSSIONRESOUR__6DAD1CC9'. Cannot insert duplicate key in object 'DISCUSSIONRESOURCE'.

[java] 09:35:56.984 com.ibm.wps.config.db.transfer.TransferDatabaseTable transferDatabaseTable main

[java] at com.microsoft.jdbc.base.BaseExceptions.createException(Unknown Source)

[java] at com.microsoft.jdbc.base.BaseExceptions.getException(Unknown Source)

[java] Transferring table --{ WCMDBADM.DISCUSSIONRESOURCE}-- to table --{WCMDBADM.DISCUSSIONRESOURCE }--

[java] 09:35:57.000 com.ibm.wps.config.db.transfer.TransferDatabaseTable populateDatabaseRow main

[java] ERROR 1288-- Transferring data of table --DISCUSSIONRESOURCE-- FAILED

At this point, you must access your SQLServer database and drop all of the WPCP tables from the WPCP database. They will all be owned by the WPCP user that you created earlier. After all tables have been dropped, rerun the Portal Database Transfer task again.

WCT_IM_USE_LOOKUP Notes .INI variable When using IBM Workplace Collaboration Services Instant Messaging (IWCSIM) in the Notes application plug-in (NAP), i.e., using Workplace IM, not Sametime IM, users may not be seeing Instant Message (IM) awareness in Notes views. If this is the case, be sure you have the variable WCT_IM_USE_LOOKUP in the client Notes.INI set. Here are the settings for that variable:

WCT_IM_USE_LOOKUP=0 (NAP resolves names using the Workplace Member Management (WMM)) WCT_IM_USE_LOOKUP=1 (NAP resolves names using the Domino Directory found in client location doc)

66

IBM Workplace Collaboration Services 2.6.1 Release Notes

This capability is provided to support those who prefer to use Domino user's internet names as opposed the values stored in WMM. Since this new setting is for IWCSIM, which is the default service provider for instant messaging for the NAP, this setting only appears in a server's Desktop Policy.

Note: This setting has no corresponding UI in the Notes client; it can only be manipulated via the Desktop Policy, or by manual editing of the Notes.INI file.

Web Conferences and Learning are not enabled by defaultBy default, Web conferences and Learning are not accessible and do not display in the Switcher bar. If you want to make these applications available to your users, follow these steps:

1. User should exit from the Managed Client. Log on to a Workplace server as an administrator. 2. Click Administration at the top of the page. 3. Click the "Portal User Interface" tab. 4. Click "Manage Pages." 5. In the list of pages, select "WorkplaceRCPPages." 6. In the list of pages, select "Web Conferences". 7. Click the Edit icon (A pop-up displays "Edit page layouts" when you hover over this icon.) 8. Click "Edit properties" (available on the top right). 9. Check "rcpml" in the section entitled "This page supports (at least one must be selected)."

10. To display Learning in the Switcher bar, select "Learning" in Step 6 and then repeat steps 7-10. 11. Relaunch the Managed Client.

Note that when you click Web conferences in the Switcher bar, the Web conference opens in a separate (external) browser window. If you close this browser window, click Launch in the Workplace Managed Client to re-open the Web conferences list. Learning also opens in a separate browser window whenlaunched from the Switcher bar. Both applications will launch using your default web browser (Internet Explorer or Mozilla). Firefox is not supported at this time in this manner.

Windows XP SP2 users must enable ActiveX scriptingIf 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.

Workplace Mail Portlet location of temporary filesDuring normal operation it is often necessary for the Workplace Mail Portlet to save temporary files to thefilesystem. This occurs in two situations.

1. When file attachments to messages being uploaded from the browser client exceed a certain size (the default is 1 MB). In this case the attachment contents are stored in the filesystem until the message is sent or the session is closed (on logout or session timeout) - whichever comes first.

2. When the end user selects the option to view an attachment as HTML. The HTML version of the attachment and any generated images are saved in the filesystem, and removed when the browser session is closed.

67

IBM Workplace Collaboration Services 2.6.1 Release Notes

The location these files are written to defaults to the value of the 'java.io.tmpdir' JVM environment variable. It can be overridden using the following property in the Workplace.properties file:

file.storage.temp.directory=<path> # Temporary store location for all Mail portlet temp files. Windows paths should 'escape' the backslash, i.e. C:\\temp

To change this value:

1. Using a text editor, create the file workplace.properties in the user folder on the Collaboration Services server:

® ®z For Microsoft Windows machines, create the file in the Documents and

Settings\<username> folder, where <username> is the account name used to start IBM Workplace™ Collaboration Services.

® ®z For AIX , Solaris, and Linux machines, create the file in the /usr/<username> folder,

where <username> is the account name used to start Collaboration Services. z For iSeries machines, create the file in the /home/qejbsvr folder.

2. Restart the Collaboration Services server.

In deployments that use Workplace Mail the temporary storage area location should be accounted for during deployment planning to ensure that it satisfies IT requirements. Specifically, the storage location should be sufficiently:

z Secure. It should satisfy any corporate requirements for temporary storage of potentiallysensitive information.

z Sized. The capacity of the temporary storage area should be planned based upon the expected number of users sending Email messages with large attachments and viewing files converted to HTML.

z Optimized. High rates of usage (e.g. due to high #s of large attachments) could result in fragmentation in the storage area filesystem. If high usage is expected the storage area should be dedicated for temporary files on a volume which is defragmented periodically.

z Available. Note that the data stored to this location can typically be regenerated in the case of files converted to HTML for viewing or resubmitted as with attachments uploaded with an email message, so making this location available across a cluster might not be necessary. That said, making the storage location a network accessible filesystem and sharing it across clustered Workplace servers will ensure that the temporary data is not lost if a server fails and improves the likelihood that failover will happen transparently to end users.

68

IBM Workplace Collaboration Services 2.6.1 Release Notes

Uninstallation information

After 2.6 installs over 2.5, 'Add/Remove programs' shows 2.5 After you install the Workplace Designer 2.6 Runtime over an old 2.5 Runtime, you will still see Workplace Designer 2.5 in Add/Remove programs (on Windows). If you run the uninstall program however, you're actually uninstalling 2.6.

Non-English OS desktop icons not removed after uninstalling On some non-English operating systems the Productivity Tools and Workplace Designer desktop icons may not be removed after uninstalling, and restarting the system.

Workaround To manually remove these icons, delete the links from the following directories:

C:\Documents and Settings\Username\Desktop C:\Documents and Settings\Username\Start Menu\Programs

Productivity tools uninstall panel references WMC The IBM productivity tools uninstall screen references the Workplace Managed Clint application only; not the productivity tools. This causes user confusion. The screen and uninstall process will correctly uninstall the productivity tools.

Uninstalling productivity tools confusion with open document Prior to uninstalling the IBM productivity tools, the user should ensure that no productivity tools applications are open. The uninstall process does not prompt the user to save and close the productivity tools applications before uninstalling. The program lets the user work on, and even create, a document and gives the appearance of saving that document when the user clicks File -> Save. However, the document does not get saved because the application itself has been uninstalled.

vpd.properties file on Linux not removed by uninstall IBM productivity tools and Workplace Managed Client installation on a Linux system yields a vpd.properties file in the user's directory. The uninstall program does not remove the file. Users can manually remove it after uninstall.

69

IBM Workplace Collaboration Services 2.6.1 Release Notes

Windows: Uninstall leaves files after CD install - switch to WMC In some scenarios, uninstalling the Workplace Managed Client using the Windows Add/Remove programs utility leaves files and folders that it should remove. For example, if you perform the following tasks, and then uninstall the Workplace Managed Client using Add/Remove programs, not all files and folders will be removed.

1. Install the Workplace Managed Client.

2. Uninstall the Workplace Managed Client by either of the following methods:

z Windows Add/remove programs utility to uninstall the Workplace Managed Client

- or ­

z In Windows Explorer, navigate to the <install_root>\IBM\Workplace Managed Client\_uninst and run the uninstaller.exe file

If the user has other programs opened such as Windows Explorer while uninstalling the Workplace Managed Client, some files may remain in the Workplace Managed Client directory structure after restarting the system.

70

IBM Workplace Collaboration Services 2.6.1 Release Notes

Chapter 3 - Known limitations, problems, and workarounds

Limitations

Installation issues

Standalone tools: Update menu missing The Check for updates menu item is missing in trial installations and IBM Productivity Tools installations in which an existing installation was not first uninstalled using the 'delete all user data' option.

Configuration issues

i5/OS: CCSID 420 not supported Arabic CCSID 420 is not supported by WebSphere Application Server. 425 is the recommended CCSID for this environment. The QEJB and QEJBSVR user profiles default to the system CCSID setting. If the QCCSID system value is set to 420, the CCSID attribute of the QEJB user profile must be changed to prevent the WebSphere Application Server Monitor and Administration server jobs from trying to start with a CCSID of 420. The QEJBSVR user profile, and any other user profiles used to run WebSphere Application Server instances, must also be changed.

User without e-mail address gets blank page logging in All users of IBM Workplace Collaboration Services should have e-mail addresses, or they will see a blank page when logging in.

71

IBM Workplace Collaboration Services 2.6.1 Release Notes

Administration issues

Dynacache requirement Portal requires dynacache to be enabled, as several components within IBM Workplace Collaboration Services 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.

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.

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

72

IBM Workplace Collaboration Services 2.6.1 Release Notes

Catalog Template Category User Policy 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

"Automatically create mailboxes " affects calendar as wellThe 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 createdas well.

IBM Workplace Collaborative Learning issues

Create folder with same name displays incorrect error message If you are attempting to create a folder with the same name as an existing folder, you will see an error message, as in the following scenario:

1. Login to http://<servername>/lwp/workplace 2. Click on "Learning"; the learning portlet appears 3. Click on the "Manage Folders" button; the Manage Folder page appears 4. Create a folder with the same name as an existing folder

The error message displayed is as follows :

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

73

IBM Workplace Collaboration Services 2.6.1 Release Notes

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.

Offline Client (OLC) does not work on SSL-enabled installations There is a problem running the Offline Client on SSL-enabled installations of Workplace Collaboration Services. After Downloading the Offline Learning Client and installing it, when you try to start the OLC the following error will display: "Unable to load remote services ."

There is currently no workaround available.

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.

WCL does not Support Multiple Delivery Servers IBM Workplace Collaborative Learning does not support Multiple Delivery Servers. Please refer to Technote 1206966. Workplace Collaborative Services maintains a single data source for all Workplace applications.

For Workplace we believe it is better to have multiple content servers and to site these at different geographical locations. This can be implemented with Workplace in a load-balanced environment (i.e., each content server stores all of the content and has the same URL). An added advantage of this approach is that there is a reduced infrastructure requirement at each site.

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.

74

IBM Workplace Collaboration Services 2.6.1 Release Notes

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.

Configuring Documents e-mail notification When you configure e-mail notification for Documents, and your site does not have a license for Workplace Messaging, you must perform the steps listed in "Setting up the Mail Service for Documents." This topic is available in the IBM Workplace Collaboration Services information center. Open the information center and in the navigation pane, click Workplace Documents --Setting up the Mail Service for Documents.

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.

Documents with unsupported extensions may cause exceptions Documents with unsupported extensions may cause exceptions. For example, using the Workplace Managed Client, users can open an unsupported document type by changing the document extension, but when that document is then converted, the new document size may be 0 bytes.

Freelance file with a 123 chart does not display correctly When a Freelance document with an embedded Lotus 123 chart is viewed in HTML, the chart is not visible and there are color changes in the document. This is a known limitation due to the version of Stellant being used during the conversion.

HTML preview of Lotus 1-2-3 Smartmaster support issue Using Document Conversion Services (DCS), certain file types can be viewed as HTML in Portal Document Manager. However, if you upload a Lotus 1-2-3 file with a Smartmaster which does not display the cells, the HTML view of the file is shown with cells. HTML preview of Lotus 123 files in Portal Document Manager does not support a Smartmaster without cells.

For example, if you use Personal Budget Smartmaster to create your Lotus 1-2-3 file, you see the contents without cells while using 1-2-3. The HTML preview in Document Manager does not support this Smartmaster, and so the contents will be shown with cells.

This is a known limitation of DCS.

75

IBM Workplace Collaboration Services 2.6.1 Release Notes

Installed 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 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.

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.

Limited folder hierarchy in document libraries The document library database schema limits the path of a document to 256 bytes. For double-byte folder names that make up the path, this is a limitation.

Workaround Create shallow depth folder structures in your document libraries.

ODF files created with external editor may suffer data loss The following OpenDocument features are not yet supported in this release; therefore, the related content will be skipped if the ODF files are created with external editor: SMIL, Custom shape, presentation header and footer, and XForms.

Private draft copied with document but warning not shown The Document Management tool preference "Copy or move documents with a private draft (private drafts are not copied or moved)" does not work correctly. If unchecked, private drafts will still get moved.

76

IBM Workplace Collaboration Services 2.6.1 Release Notes

Productivity tools: General limitationsFollowing are the general limitations associated with the IBM productivity tools (word processing editor, spreadsheet editor, presentation editor, and project planner) in Workplace:

Accessibility

z Accessibility information is provided by the Java Accessibility API; accessibility tools need to support this API, and need the Java Accessibility Bridge 1.1 or above.

z Accessibility tools need to be launched before the productivity tools windows are opened,otherwise, those windows should be re-opened for accessibility tool access.

Globalization

z If a productivity tools or Microsoft Office document uses a font on the Windows platform that does not exist on the Linux platform, for example Webding, the productivity tools render the document on Linux with a different font than the original font (some characters may not be displayed correctly, but as "box" characters).

z In the menu "Tools -> Document Editor Options -> Languages", there is a checkbox "Asia language support“. When the locale is Chinese or other Asian languages, the checkbox can not be unchecked.

z In the Hebrew locale, the "Layout -> Page Design" operation may cause the editor to crash

z The keyboard layout of the productivity tools does not change after pressing the 'Shift' and 'Alt' keys a second time, on Windows 2000. Users must release the 'Alt' key after the first keyboard layout switch.

Open and Save

z No error message dialog displays when opening a file with zero bytes, and a blank view iscreated; users must close the blank view manually.

z When opening a text file (.txt) that contains one or two bytes, the editor's view becomes blank, and the file cannot be opened.

z Floating windows remain open after switching to another document, if the floating window does not move before switching. For example, if you press "Line" on the menu bar in a Word document to open that floating window, then switch to another document such as Spreadsheet, you will find that the floating "Line" window still appears on the Spreadsheet. Move the floating window to another position before switching to another application to keep it from appearing.

z The 'Undo' command doesn't work when a document is loading (i.e., the page number in the status bar keeps increasing).

z Editing and saving a document when it is under loading (i.e., the page number in the status bar keeps increasing), results in the save taking longer than expected.

z Larger files (for example, a file with serveral thousand pages), may freeze the client if it is saved during file loading.

z Users cannot save a recorded macro to the existing system library "Tools". Saving a recorded macro to this library will cause the system to crash.

z If an exception occurs when a user tries to save a file, the content of the document will be lost.

Search z Searching the Document Title or Document Description of a document fails to return results.

Instead, search for content in the Body of the document.

77

IBM Workplace Collaboration Services 2.6.1 Release Notes

Interoperability with Microsoft Office

z Neither encrypted Microsoft Office, nor encrypted OpenOffice documents can be opened. This issue is related to interoperability with encrypted Microsoft Office files and OpenOffice files, and will be improved in a future release.

z Converting a large Microsoft Office document (for example, larger than 5M) into an IBMproductivity tool on Linux, and then exporting it into a PDF format, the file will be empty ifre-opened in a productivity tool, and the data will be lost.

z Copy and Paste between productivity tools editors and Microsoft Officer may lead to unexpected results.

z The Spreadsheet Editor cannot accept skipped parameters in a formula. For instance, "=SUM(1,,,5)" in Microsoft Excel will display as an error in the Spreadsheet Editor.

z Some formulas return different results in Microsoft Excel than in the Spreadsheet Editor. For example, the TYPE function is used to return the type of value; in Spreadsheet Editor, TYPE of a formula returns 8, while in Excel the return value depends on the return value of the formula. In the case of using the result as an input parameter, this may cause an error.

z The Spreadsheet Editor can only display one chart type in a canvas. Charts in Microsoft Excel with more than one type will lose that information when the document is opened in the Spreadsheet Editor.

z The following functions are available in Microsoft Excel, but are not supported in the Spreadsheet Editor:

Double-byte character handling: FINDB, LENB, MIDB, LEFTB, RIGHTB, REPLACEB, CALL,REGISTER.IDFinancial functions: EFFECT, EUROCONVERTDatabase functions: SQL.REQUEST, GETPIVOTDATA(pivot_table,name)Date & Time function: DATEDIF(start_date,end_date,unit)Information function: INFO(type_text)Lookup & Reference functions: HYPERLINK(link_location,friendly_name); RTD(ProgID,server,topic1,[topic2])Math & Trig function: FACTDOUBLE(number)Other functions: ASC, YEN, WIDECHAR, JIS, PHONETIC

z The word processing editor does not support the display of a single table cell across pages. If a cell's content is large enough to extend the cell out of a page in Microsoft Word, the display of these contents in the word processing editor will be lost.

z Table diagonals are not supported in the word processing editor. Tables with diagonals inMicrosoft Word will lose this information when loaded into the word processing editor.

z The word processing editor has limited table border line styles available to display. Currently, the dotted line and curved line borders are not supported. Also, table shading patterns are of limited support.

z Microsoft macros are disabled, and do not work in the productivity tools.

z The productivity tools do not support saving to Microsoft template files.

Macros

z Currently, the "Run Macro" option in Preferences only applies to the existing document. So, even if "Run Macro" is set to 'Never' (do not allow macros to execute), users can still run a macro from the Macro dialog. If the user writes a new macro in a newly-created document, and assigns the macro to an event, the macro will be executed when the event occurs.

78

IBM Workplace Collaboration Services 2.6.1 Release Notes

Object editing

z "Align Left", "Align Center", and "Align Right" for the text in a drawing object (for example,rectangle and Ellipse), does not work.

z Copy and Paste between different applications in the productivity tools editors may cause the object property to change, or lose data.

z An OLE object in productivity tools cannot be activated by its associated application after the document has been saved. When the document is saved, the link between the OLE object and its associated application is lost.

Text box editing

z The Position attribute of certain special characters may be changed incorrectly. For example, inputting "1st" into a text box, and then pressing the "Enter" key, changes the "1st" to "1^st".

z "Undo" doesn't work for the deleted text in a text box when the focus is moving out of the box.

z While a Presentation Editor document is loading, selecting and editing the content in a text box object will not execute normally until the document has finished loading.

z On Linux, an application may fail to respond when clicking the Type tab on the Frame Styles dialog.

z An OLE object in productivity tools cannot be activated by its associated application after the document has been saved. When the document is saved, the link between the OLE object and its associated application is lost.

Links

z Sometimes, the focus of items in the "Target in document" dialog is incorrect when creating a Hyperlink with the Document type.

z If there is a file link (a reference to another document) in a Spreadsheet document, the contents of the referenced document can't be displayed correctly.

z Linked objects in productivity tools, for example linked graphics, will be lost if the local linked file is renamed, or the location of that file is changed.

Productivity tools: Presentation editor limitations Following are the limitations associated with the presentation editor:

z Managed Client can't be launched again after closing WCT while the presentation editor has been launched.

z Dialog boxes will jump between Managed Client and the presentation editor when they arerunning concurrently, or may not launch at all.

z The presentation editor does not support auto-save.

z 'Undo' operation may cause the editor to crash

z The *.* type in the Open File dialog box is not supported.

z If a Presentation document's current slide contains both a rectangle and a rounded rectangle, the view will show an error after reloading.

z Users can not save a document to a Microsoft Office template file (*.dot, *.xlt, *.pot).

79

IBM Workplace Collaboration Services 2.6.1 Release Notes

z If users open a template file from the document library server, the template document can not be saved back to the server.

z Users need to change the file extension in the Save As dialog box manually in order to save the document to another format.

z The presentation editor does not lock opened documents; these documents can be modified by other editors.

z The status of a Presentation document may changed incorrectly in some circumstances.

z The presentation editor does not support setting the position of a tab stop in a paragraph.

z There is no a file type list in the "Save As" dialog on Linux.

Productivity tools: Project planner limitations Following are the limitations associated with the project planner:

z When using the "Start-Finish" link, the project planner does not change the constrained task if that task does not end before the constraining task starts.

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

z When using "Finish-Start" to constrain a milestone, the project planner does not adjust themilestone's start date.

z A Task Start Date cannot be set before a Project Start Date.

z "Resource" in the project planner only refers to people resources.

z Multi-level subtasks are displayed without border and hierarchy in tables.

z The project planner inherits some defects that result from Eclipse and GEF, like task multilevel display on Linux, and GANTT chart drag-and-drop on Linux.

z The GANTT chart in the project planner has a right-to-left deviation.

z All GANTT figures move down when the mouse drags to the margin between the GANTT head and the first task.

z Non-working days cannot be viewed in a different background color in the GANTT chart.

z The project planner only supports "day"-based calculations.

z The project planner does not support Auto-save.

z Accessibility features, including keyboard access, are not fully-documented.

z The Preference page is not completely accessible when set to High Contrast mode.

Productivity tools: Spreadsheet editor limitations Following are the limitations associated with the spreadsheet editor:

z Spreadsheet documents may not display correctly if they are contained in a Presentationdocument.

80

IBM Workplace Collaboration Services 2.6.1 Release Notes

Productivity tools: Word processing editor limitations Following are the limitations associated with the word processing editor:

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

z Two tables wrap together in Online Layout mode.

z Two characters in a vertical textbox will not be displayed correctly in Online Layout mode.

z A file type of HTML is not supported.

z All graphics will be lost when exporting a word processing editor file as an HTML file.

User cannot Undo if a document is not completely loaded The "Undo" command doesn't work when a document is still loading (i.e., the page number in the status bar keeps on increasing), until loading is finished.

IBM Workplace Managed Client issues

'Cannot Create Security Context' error not translated As shown in the sample screenshot below, the 'Cannot Create Security Context" error message is not currently being translated in non-English environments.

81

IBM Workplace Collaboration Services 2.6.1 Release Notes

'Home' button on Linux does not use default home page Note that the following is only an issue with Linux and Mozilla:

1. Load Mozilla and change the default page: Edit -> Preferences 2. Load the Managed Client 3. Select the Web Browser and press the 'Home' button

The home button takes you to Mozilla's old home page, prior to changing it in Step 1 above. This is an issue with Mozilla, and has been reported via Bugzilla.

Calendar documents: Repeat is limited to 99 documents If you repeat a calendar entry, there is a limit of 99 instances of the document.

Cannot Reply or Forward in an open Calendar Invite message For calendar invitations, the Reply and Forward options are available in the listviewer. After opening the message in the docviewer, these actionbar buttons are no longer available.

Listviewer actionbar buttons:

Meeting Invitation actionbar buttons:

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.

Changing from one user's workspace to another on one machine The Managed Client supports multiple users on a single workstation only if none of the users have write access to the Managed 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 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 Managed Client re-install is required. If the language pack is installed, a restart of the client is required.

82

IBM Workplace Collaboration Services 2.6.1 Release Notes

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_serv er.com>/<url> Currently, there is no way for a server administrator to change the users' provisioning server from the server.

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.

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.

Contacts - Typeahead overwrites special characters If you have a DPAB and you enable the typeahead function, when you enter an address, typeahead may overwrite comma and space characters you entered even when they occur at the end of the text. Typeahead will remove these characters and fill in a matched address instead,

Copy and Paste are not available with web browser on Linux After highlighting text and/or graphics while using the internal web browser, the copy-and-paste menu options will not be available from the Edit menu. This is a limitation of the internal web browser, which uses Mozilla 1.4.3. You can use Ctrl+c and Ctrl+v to copy and paste text and/or graphics.

83

IBM Workplace Collaboration Services 2.6.1 Release Notes

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 Managed Client, including in each component's navigator, opens IBM Workplace Managed Client Help. An alternate way to opening IBM Workplace Managed Client help is to click Help --> Help Contents .

General properties for search do not apply to Managed Client In the WebSphere Administrative Console under User Policies there is a section for Search Details > General Properties. The first item "Allow users to search across document and messages" is not relevant to the Managed Client. The Managed Client only indexes e-mail documents but does not yet index other documents.

Help button not working on Linux for Print Preview There are three buttons in the Print Preview dialog - Print, Help, and Close. The Help button does not work at all. This is generated by Mozilla, and has been reported to them as an issue. Please note this is only an issue on Linux, as outlined below:

1. Launch Managed Client and select Messaging 2. Open the default sample message 3. Select File, Print Preview 4. Select Help button

Nothing happens when selecting Help button.

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.

IM messages using Notes plugin and Notes client If a user starts the Lotus Notes client AFTER already being logged into the Notes plugin, and they are using WMC IM in the Notes plugin, that user will not be able to use Sametime in the stand-alone client for that session. Conversely, if a user starts the Lotus Notes client and is using Sametime, and then start the Notes plugin during that same session, the Notes plugin will use Sametime regardless of the Notes plugin IM preference.

84

IBM Workplace Collaboration Services 2.6.1 Release Notes

Instant Messaging - Saved chat transcript limitation Not all chat participants are saved in the chat transcript when you are chatting with more than one person and your system is set to save chat transcripts. In this case, only the chat transcript of the first person to leave the chat will correctly include all chat participants. When other participants leave the chat, any participants who left prior to this time will not be included in the chat transcripts; only those still in the chat will be saved in the chat transcript.

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

The Spell checker on Linux may experience the following issues:

z 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.

z 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

Keyboard access for the Switcher barYou can use Control and the F8 key to "cycle" through the Switcher bar (at the left side of the ManagedClient). You can also press Control+Shift+F8 to "cycle" back through the Switcher bar.

When the cursor is actually on the Web Browser, the above key commands will not work. If keyboard access is needed while on the Web Browser icon, use the Windows menu which will allow you to select a specific application, as well as any specific open tabs.

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

Mail, Address Book, and Calendar limitsMailz 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. z You cannot create more than 498 messages. If you go over the limit, you will see a gray window. z You cannot specify more than 200 recipient names in the address fields of a message. To send a

message to more than 200 people, create one or more groups in your address book, add the recipients to the groups, and then address the message with the group names.

85

IBM Workplace Collaboration Services 2.6.1 Release Notes

Address Bookz 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.

z You cannot save a group that contains more than 100 e-mail addresses.

Calendar z After approximately 800 calendar entries are created, the Messages navigation section disappears. z You cannot add more than 1536 characters to the Location field of a calendar entry. z If you open 70 or more tabbed pages (such as mail messages and calendar entries) and leave them

open, the mail client becomes unusable. z 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.

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

Managed 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 Managed Client user cannot log in to My Workplace by having IBM Workplace create a new account. The Managed 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.

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

Modifications to Managed Client policies not immediately appliedThe Managed Client will not immediately honor changes made to a user's policy if that user has alreadyprovisioned (installed) the Managed Client. There is a delay before the Managed Client will recognizeand apply modifications to the user policy.

The effect is that, if components are removed, then the Managed Client user will still be able to use those features, even though they may not be available when using the portal. In addition, if components are added, then those components will not be immediately available to the Managed Client.

86

IBM Workplace Collaboration Services 2.6.1 Release Notes

Notes documents (\views) open in Messaging perspective When you click a Notes link (document, view, Notes URL) in the Messaging perspective of the IBM Workplace Managed Client, that Notes item will be opened in the Messaging perspective, and will not switch to the Lotus Notes perspective.

In addition, if you have the New Mail icon in your system tray and you click that icon with the Messaging perspective open in the Managed Client, the Notes Mail will be opened in the Messaging perspective.

Outline appears when using non-default theme on Linux Field outlines will appear on Linux if a user changes the default theme on the desktop.

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.

Search of multilingual documents might fail In a message that contains some N-gram language characters, such as Chinese or Japanese, but where most of the content is not an N-Gram language, for example. European languages, the language detector will set the language as a non N-gram language. The search engine attempts to stem the tokens (words) and might break up longer character sequences into individual tokens, for example, finding a two-character sequence, but not a three-character sequence. This is a known system limitation for multilingual documents.

Search rounds some documents score to zero The rich-client search feature incorrectly rounds off documents with a low score to zero. This would be likely to happen to documents scoring in the lowest third of matches.

Tab key has no effect in Linux Insert Image dialogue Normally, the tab key will move focus from field to field in most dialogues. On Linux however, the tab button currently does not have any effect in the 'Insert Image' dialogue.

Note: The 'Insert Image' dialogue is opened by clicking the 'Insert Image' button in the rich text Editor for new messages.

87

IBM Workplace Collaboration Services 2.6.1 Release Notes

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

Using Documents over a dial-up connectionWhen you are working with Documents over a dial-up connection, do not access remote documentlibraries. When you synchronize offline document libraries with those stored on the server, remember toallow plenty of time for synchronization to complete. Do not begin a new synchronization before thecurrent synchronization has completed.

IBM Workplace Messaging issues

Chat with names list not working in Notes app using Workplace IMWhen using Workplace Instant Messaging in the Notes Application plug-in, users cannot Chat with anames list; only one-to-one chatting is supported when using Workplace Instant Messaging in the NotesApplication plug-in. Sametime Instant Messaging in the Notes Application plug-in does support chattingwith a names list,

WorkaroundSelect one user to chat with, and click the "Add Invitees" button to add other users to the chat. This isfixed in Notes 7.01 and WMC 2.6

Drag and drop is not supported with mail You will not be allowed to drag and drop files from Windows or Linux into a new or existing mail message. This also means that you can not drag a file from the Document library and drop it into a new mail message.

Import command issues

Import command behavior is listed below:

z '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.

88

IBM Workplace Collaboration Services 2.6.1 Release Notes

z '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.

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

z 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.

Instant Contacts - Dragging to resize truncatesResizing the Instant Contacts window by dragging it from left to right truncates the Actions menu options. Resize the window to display all the text.

Instant Messaging - Linux issuesThe following outlines Instant Messaging limitations when using Linux:

z Setting the on-line status preference "automatic status change " does not change status The Automatic Status Changes setting (found by selecting File -> Preferences, clicking the + beside Instant Messaging and then Status) lets you change your status from "I am available" to"I am away" when you are not using your mouse or keyboard for the number of minutes you specify. On the Linux operating system, this setting does not work.

z Chat window gets smaller Opening and closing the chat window repeatedly makes the window get smaller and smaller, sometimes hiding parts of the window such as the Send button. Resize the window whenever this happens to return it to its original size.

z Ctrl-A does not work in Chat window In the chat window, Ctrl-A does not select all text. Instead, click Edit -> Select All.

z Double menu options displays Double menu options display when you hold down the right-mouse menu. Simply select the option you want.

z Unexpected display of New Contacts dialog box When you right-click a name in Instant Contacts, the New Contacts dialog box may display unexpectedly. Click Cancel to close the New Contacts dialog box.

89

IBM Workplace Collaboration Services 2.6.1 Release Notes

Maximum Send Size limit is not enforcedWhen users send mail, the maximum size of an outbound message cannot be limited. The size isnormally set in the WebSphere Administration Console by clicking Lotus Workplace > Mail Cell -WideSettings > SMTP outbound /Local Delivery > Maximum Size of an outbound message (KB). This settingis ignored.

Notes Application Plug-in server policy setting being ignored In the Notes Application plug-in section of the Desktop Policy form in the server NAB, there is a checkbox to 'Allow users to change the settings in this section'. When this option is not checked, the 'Use IBM Lotus Sametime Instant Message' Lotus Notes User Preference should be hidden, but is not.

This issue has been addressed in Notes 7.0.1.

Updating mail forwarding address not immediately effective When updating an account's mail forwarding address with lm admin updateaccount, one must connect to the Mail_Server_1 instance (typically port 8882) for the change to be immediately effective. Since lm admin updateaccount is not supported on Cloudscape deployments, the mail forwarding address may not be effective until the MTA cache times out which can take as long as an hour.

IBM Workplace Team Collaboration issues

Cannot create team spaces, libraries, or Web conferencesIf your User ID is more than 32 characters long or contains special characters, you cannot create newteam spaces, document libraries, or Web conferences. You will receive an error message.

A valid User ID can contain only the characters a-z, A-Z, period (.), and underscore ( _ ).

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

z You cannot view, edit, or create new templates based on the Moderated Web Conference template.

z 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).

90

IBM Workplace Collaboration Services 2.6.1 Release Notes

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

z 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 andcustomizing Web Conference applications. Web Conference applications and components are availablefor general use by anyone with a user policy that provides access to Web Conferences. Applicationmanagers can control the life cycle of their Web Conferences by maintaining the policy assigned to theWeb Conferences.

Managed Client online status has precedence over Portal clientOnline presence is supported in both the Workplace Managed Client and Web browser clients (or Portalclients). Both the Workplace Managed Client and the Portal clients provide options to change a user'sonline status. For example, a user can change the online status from "I am available" to "I am away" or "Do not disturb" in either of these clients.

If a user is simultaneously logged into the SIP Services from both the Workplace Managed Client and aPortal client, the online status setting that is specified in the Workplace Managed Client always takesprecedence over the setting specified from the Portal client.

For example, consider the following scenario:

1. A user logs in from the Workplace Managed Client and sets the status to "Do not disturb."

2. The same user later logs in to a Portal client and sets the online status to "I am available" from the Portal client.

In this scenario, the user's status continues to display as "Do not disturb" in the Contact Lists of all users even though the most recent change to the online status was made from the Portal client. The Workplace Managed Client setting always takes precedence over the Portal client setting.

If the user changes the status to "I am available" from the Workplace Managed Client, this change is then reflected in all Contact Lists.

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.

91

IBM Workplace Collaboration Services 2.6.1 Release Notes

IBM Workplace Designer issues

'Save As' function in Form editor not working The "Save As" function for the Form editor (available from the context menu and File menu) is not working in the current release of Workplace Designer.

Accessibility: CTRL+F10 fails to show view menu in shelf Part In the Data Navigator and UI Control View, using standard CTRL+F10 Keyboard commands doesn't display the view menu part.

Accessibility: Jaws is announcing a table as a list box Access privileges are not being read as a table by Jaws; instead, the table is being announced as a list box. This is a Jaws issue, and can be considered a third-party defect.

Color Palette is not accessible Designer is using the standard SWT color palette which ultimately uses the one coming from the Windows OS, which is not accessible.

Directory searches do not support wildcards The current version of the IBM Workplace Designer Directory Service package does not support regular expressions in search filters (e.g., wildcards).

Discussion Sample App: Inconsistent no. of items listed in page On pages with hierarchical views of discussion topics, more topics may be displayed than is expected. This is due to Response documents of topics being displayed, which are not counted towards the total desired topic display count.

Error dialog created by Eclipse is not accessible Whenever Designer can, it uses its own version of a dialog that is solving the issue. But in this case, the message dialog is thrown by Eclipse automatically without Designer being able to intercept it. This is related to a broader Eclipse limitation where the Image in a standard Eclipse message dialog does not contain Alt+Text information.

Note: For this specific issue, the error is expected to be fixed in a subsequent release.

92

IBM Workplace Collaboration Services 2.6.1 Release Notes

Exported component renamingIf you need to import a component that was recently exported, the name will need to be changed;otherwise, a "File already exists" error will be displayed.

There cannot be duplicate component names.

Form with a background image is not shown on the serverThe option to create an image as a form background is not available.

Non-Visible UI Control Label is shown at runtimeThis issue occurs as in the following scenario:

z Create a new form z Insert a control z In the 'Basics' properties set Visible to "False".

Deploy the component and, at runtime, the Label for the control appears.

Readers cannot view forms that store data In Workplace Designer, if you bind controls in your form to elements, data entered into those controls is saved in a document, which is then stored in a back-end database. Each time a user opens the form, a new document is created to save the data. Users with Reader component-level access cannot create new documents, therefore they cannot open forms that store data.

Workaround If you want Readers to access forms that store data you must uncheck "Specify document" to allow them access. To store data entered into the same form you can create a panel control in the form, add the controls to the panel, and specify a document for the panel.

Richtext control with "Store as Attachment " shows no filenameIf a richtext control is placed on a form with the 'Store as Attachment' option checked on the Basics tab,you must also specify a filename, or else a deployment error will occur when the user deploys thecomponent. The UI currently allows the user to not specify a filename.

You must specify an attachment file name to deploy with the 'Store Data as Attachment' option.

Standard Eclipse pop-up is not read correctly by screen readerThe standard Eclipse pop-up that allows view and perspective navigation control (CTRL+F6 / CTRL + F7) is not read correctly by screen reader; this is an Eclipse bug that should be fixed in the next release.

93

IBM Workplace Collaboration Services 2.6.1 Release Notes

Standard Eclipse progress bar not being read by screen reader The standard Eclipse progress bar status is not being read correctly by screen reader; this is an Eclipse bug that should be fixed in the next release

Title area of standard Eclipse Preference page The Title area of the standard Eclipse Preference page is not responding to font changes, and is using a hard-coded image as a background. This is an Eclipse bug that should be fixed in the next release.

Truncation occurs in some dialog boxes in high contrast settings Truncation occurs in some dialog boxes when high contrast settings are used. This is caused by an Eclipse dependency, and is expected to be fixed in the next release.

Users cannot deploy Workplace Designer over HTTPS Use of HTTP to deploy Workplace Designer applications is not supported in the current release.

Wrong icon when Designer and Managed Client both open When both IBM Workplace Designer and IBM Workplace Managed Client are open, the wrong icon displays in the IBM Workplace Designer tab. This is an issue with Eclipse.

"Import Documents" from Import Domino form not supported The ability to import documents from the Import Domino form is not available in this release.

IBM Workplace Forms issues

Do not add the Form Template Library portlet to a page Although the Form Template Library appears on the list of portlets you can add to the page of an application, doing so results in a Java error when you try to access the page. Avoid adding this portlet to an application.

94

IBM Workplace Collaboration Services 2.6.1 Release Notes

No way to recover deleted form templates If you delete an out-of-the-box form template from your system, there is no way to restore it. You will have to reinstall the product to restore the form template. The form templates are locked by default to discourage unintentional deletion.

Search does not work for FormsThe in-line help for the Search portlet indicates that you can search forms, but that is not the case in thisrelease.

IBM Workplace Templates and Applications issues

Application templates require limited use of Mist themes When selecting themes for components (portlets) on the same page of an application template, do not mix the Mist theme and the Mist With Border theme. If you select the Mist theme for one component and the Mist With Borders theme for another component on the same page of an application template, you will not be able to save the application template. This limitation only applies to the Mist themes when they are selected for components on the same page of a template.

Do not use Portal Administration to maintain applicationsAlways maintain applications using the application editor. Do not use Portal Administration to modifyapplications. Here are some examples:

z To create and arrange the pages of your 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 an 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.

z To add application components (portlets) to the pages of an 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 application will not work because they rely on corresponding business component objects.

If you ignore this warning and use Portal Administration portlets to maintain 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. Applications require the infrastructure provided by the collaborative domain object (CDO), 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 application templates and application instances.

95

IBM Workplace Collaboration Services 2.6.1 Release Notes

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

The following usage scenario is not recommended: If you uninstall any of the portlets provided by IBM Workplace Collaboration Services (application components) and remove these portlets from the pages of an application, you cannot reinstall them and add them back onto pages of an 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 application templates and applications that come with IBM Workplace Collaboration Services.

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

Portlets common to most templates and applications of IBM Workplace Collaboration Services: 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 and 2.6: Announcements Agenda Attendance Customer Contacts Directions Employee Directory FAQs Invitations and RSVPs Issues Links Milestones Minutes Prospects Sales Tracking Sign Up Sheet Survey Vacations

Please also refer to the related release note: "Portlets available for selection do not always work."

96

IBM Workplace Collaboration Services 2.6.1 Release Notes

No Template information if user has no access to the TemplateWhen an Application is open in Builder, the Properties Portlet displays at its bottom sone informationabout the Application Template used to create this Application, such as the Application Template nameand creation date.

However, if the user does not have access rights to read the Template, this info will not be displayed.

Templates imported from previous release are not upgraded Application templates provided with IBM Workplace 2.0 and 2.01 are included, but not upgraded, in IBM Workplace Collaboration Services 2.5 and 2.6. The old ready-to-use templates have the prefix MIGRATED added to their names. The ready-to-use application templates from the prior release of the product are preserved in case you have customized those templates and want to copy your customization into the Workplace Collaboration Services 2.5 or 2.6 templates. After you copy your customizations into the new templates, you should delete the old templates and start using the new templates.

If you create or customize an application template using IBM Workplace 2.0 or 2.01 and import it into IBM Workplace Collaboration Services 2.5 or 2.6, you will encounter the following limitations:

z If you have added portlets that are not application components provided by the ready-to-use application templates to the pages of an application template or a particular application, these portlets will not work in the application. For example, Document Manager portlets that are provided by IBM WebSphere Portal Document Manager will not work on the pages of an application assembled from an application template. However, Document Library components, which are provided as ready-to-use components by application templates, will work on the pages of an application assembled from an application template, Do not confuse the Document Manager portlet provided by IBM WebSphere Portal with the Document Library application component provided by IBM Workplace Collaboration Services. See the related release note "Do not use Portal Administration to maintain applications".

z Parameters that you specified for applications assembled with IBM Workplace 2.0 or 2.01 templates are lost in IBM Workplace Collaboration Services 2.5 and 2.6 because of a discrepancy in the syntax of application template XML between versions 2.0/2.01 and 2.5 and 2.6. The XML syntax discrepancy prevents you from re-specifying the application parameters using the template editor in IBM Workplace Collaboration Services 2.5 and 2.6. To restore application parameters specified in IBM Workplace 2.0 or 2.01 in the applications that you want to reuse in IBM Workplace Collaboration Services 2.5 or 2.6, you must export the template from IBM Workplace 2.0 or 2.01, edit the template XML, and import the template to IBM Workplace Collaboration Services 2.5 or 2.6. If you need assistance with editing the application template XML, contact IBM Software Support.

IBM Workplace Web Conferences issues

PowerPoint file created by WCT can't be uploaded in agenda When you try to upload a Microsoft PowerPoint presentation (.ppt) that was created in the IBM Workplace Managed Client to a web conference, an error message displays and the presentation is not added. This happens because the exported .ppt format cannot write to the web.

You can work around this issue by opening the presentation and using Save As --> Save as type --> PowerPoint 95; you will then be able to upload the presentation to the web conference.

97

IBM Workplace Collaboration Services 2.6.1 Release Notes

Web Conference e-mail notifications in mixed languages Web Conference notifications use the preferred language set for the user. Preferred languages can be set in the Portal Preferences. If a language is not selected, then the text in certain fields will be written by default in the English language; the notifications do not check the browser for a language setting.

Web conferencing - Animations displaying out of sync Individuals in a Web conference using Internet Explorer will not see animations in the following situation:

1. A presenter with PowerPoint and Internet Explorer, uploads a file.

2. During the Web conference, another user becomes the current presenter, and that person uses Mozilla, not Internet Explorer. In this case, participants in the Web conference, who are on Internet Explorer, will not see the animations, even though the original presenter used the ActiveX control when uploading the file.

Web conferencing - Can't access Web conference You set Web conference user policy by logging into the IBM (R) WebSphere(R) Administrative Console, clicking Lotus Workplace -> Users -> Manage User Policies in the left-hand navigator and then clicking the Default User Policy to display the properties for that policy. Scroll to Allow Web conferencing . If you check Schedule, but not Attend, users will not be able to attend nor schedule Web conferences and Web conferences will not display as an application under Team Collaboration in the navigation bar. In other words, despite what the use interface implies, you can not set Web conferences so that users will be able to schedule but not attend conferences.

Web conferencing - Can't install Web conference tools on Mozilla When using Mozilla 1.4 on Windows 2000, left-clicking the link to install the Web conference tools from the Web conference details page displays a page with junk characters. During a Web conference, left-clicking the link to install the tools causes Mozilla to hang. If the Web conference tools are not installed on the computer of the presenter who will be showing the application(s), then this presenter will not be able to take advantage of the increased performance offered by the tools nor use the floating Stop Sharing button. Likewise, participants will not be able to see the presenter's cursor movements.

To install the tools, right-click the link and select the "Save as" option and then install the tools. Or, to avoid the problems described here, download the tools using Mozilla 1.7 or Internet Explorer instead.

Web conferencing - Deleting currently presented agenda If the current presenter clicks an agenda item to display it in the projector and then clicks Edit Agenda, removes the item, and then returns to the Web conference, both the agenda and Downloads and Links area may display "empty." Click Edit agenda and then return to the Web conference or leave and then return to the conference.

98

IBM Workplace Collaboration Services 2.6.1 Release Notes

Web conferencing - Screen share browser/VM requirements Before you join a Web conference, make sure that you are using a supported browser. Note also that if you are using the Firefox browser, you must be sure to use it only with the Sun plug-in version of Java Virtual Machine (JVM) 1.4.2, not 1.5, or you may crash after joining a Web conference.

Note: All Web conference participants must have JavaScript enabled in their browser.

There is an additional browser requirement for those who want to share their screen during a Web Conference. In order to share your screen, you must be using the Sun Java Virtual Machine (JVM) version 1.4.2 or higher with any supported browser. Viewing a screen share does not require the Sun 1.4 JVM.

There is a known issue where, infrequently, a Firefox or Mozilla browser may crash after viewing a screen share for several minutes, even using the supported configurations.

Web conferencing - Workplace window pops up If you minimize the Workplace window and switch to another application, the Workplace window may pop up unexpectedly in front of your current application. Minimize the Workplace window to resume your current task.

People components issues

Cannot save contact information if server shuts down If a user enters contact information, but the IBM Workplace Collaboration Services server shuts down before the user selects Save, the user sees the following message:

Error : An error occurred and the last action wasn't completed. Try the action again.

In this release, there is no failover for the address book into another server in a cluster. The contact data is transient data that cannot be recovered if the java processes on the server stop before the save occurs.

Novell eDirectory user login fails when commas in user names Users in Novell eDirectory who have commas in their user names cannot log in to Workplace Collaboration Services. Novell eDirectory users should not have commas in their user names.

99

IBM Workplace Collaboration Services 2.6.1 Release Notes

Security issues

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 Managed Client products enforces restrictions regarding the cryptographic algorithms and maximum cryptographic strengths available for use by the Managed 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 Managed 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.

100

IBM Workplace Collaboration Services 2.6.1 Release Notes

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 Collaboration Services opens the browser within the Notes user interface on a tabbed page. If a user then opens the Directory Search window while performing a 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).

Do not click Trash can icon if it appears in a help dialog If you click on the Trash can icon in a help dialog the help window stays open, but all the help content disappears. If you close the help dialog, then open it again, the help topic should display, but an image of your workplace desktop appears in the help dialog instead.

Mozilla and Firefox browser limitations Following are the issues you encounter using a Mozilla or Firefox browser:

z If you are using the Mozilla 1.4, 1.7 or Firefox 1.0 browser, you will need to click twice on many buttons and links in order to open the target context in the product.

z If you are using the Mozilla 1.4, 1.7 or Firefox 1.0 browser, you will notice that tabbing through the WebSphere Administrative Console stops at the Servers node of the navigation tree. You cannot continue to press the Tab key when you reach the Servers node. Pressing the Tab key expands and collapses the Servers node; you cannot tab forward to children objects under the Servers node. To workaround this problem, use your mouse to select a specific page under Servers; then you can tab through the page.

z If you are using the Windows operating system and the Mozilla 1.4, 1.7 or Firefox 1.0 browser with the High Contrast accessibility option set for white-on-black screen display, you will not be able to see any dropdown action menus. The high-contrast accessibility setting for white-on-black screen display makes action menus invisible.

z The Firefox browser loses focus when you tab through the My Work Welcome page and open the IBM Workplace Show Details /Hide Details link.

101

IBM Workplace Collaboration Services 2.6.1 Release Notes

Pages hang if Microsoft VM in Internet Explorer 6.0 is setIf you are using Microsoft Internet Explorer (IE) 6.0 and your browser Internet Options have Microsoft VM selected, pages will hang when you navigate through the site. Microsoft VM in IE 6.0 is not a supported configuration for IBM Workplace Collaboration Services; therefore, this option should not be selected inyour browser. From your browser menu bar, click Tools -> Internet Options -> Advanced; then scroll toMicrosoft VM and uncheck any options that are selected.

Workplace Collaboration Services browser support is based on Mozilla or IE 6.0 with Sun JVM 1.4.2; therefore, you must use Sun JVM 1.4.2 or later version as your Java Virtual Machine (JVM) when running Workplace Collaboration Services. If your browser does not show the advanced option for Sun Microsystems Java Virtual Machine, you need to obtain the SUN JRE 1.4.2.

JRE (Java 2 Runtime Environment) is one of two principal products in the Java 2 Platform, StandardEdition (J2SE) family. J2SE v 1.4.2_05 JRE includes the JVM technology. Refer to this site for morebackground information: http://java.sun.com/j2se/overview.html

Use Ctrl+W shortcut to close Help opened from the toolbarAccessibility keyboard shortcuts allow you to use the Tab key to navigate through the product toolbar andpress Enter to act on any control. If you open the product introduction Help (Welcome to IBM WorkplaceCollaboration Services) by tabbing to it and pressing Enter, the only way you can close this Help windowis to press Ctrl+W, the operating system shortcut.

What the Search Center can and cannot processThe Search Center portlet only can search discussions, documents, chats, and team task lists. If anapplication does not contain any of these portlets, for example a Domino application, then its content willnot be searchable.

Portlet issues

Accessibility and Content Palette The Content Palette is a tool that lets you drag and drop portlets onto a page. You cannot access all of the Content Palette's functionality using only the keyboard. However, anything you can do using the Content Palette can also be done using only the keyboard under Administration -> Portal User Interface -> Manage Pages.

Instant Contacts - Back button behavior Selecting an option from the Actions menu and then clicking the browser Back button, does not display the previous page. The current page continues to display. In some cases, it also displays a "Warning: Page has expired" message.

102

IBM Workplace Collaboration Services 2.6.1 Release Notes

Instant Contacts - Can't add contacts without email addresses You can add a contact to your Contacts List only if that contact has an email address. In other words, when you click New contact or Organize list from the Actions menu and then click Find Person to search for a person to add, only names that display with email addresses in the Search results field can be added to your Instant Contacts list.

Instant Contacts - Chatting with multiple people limit If two people (Person1 and Person2) are chatting and then Person1 clicks the chat window Invite Others button to invite another person to join the chat, all chat participants correctly display in the chat window Participants list. However, if Person1 tries to start a chat with Person2 (while the chat window for multiple participants remains open) after one or two times, the chat window for that chat will not open. Only the chat window for multiple participants will be open.

Instant Contacts - Group names and special characters You cannot use certain special characters, such as @, %, (, ), and * in group names. If you do, the group will not be created. If you use the backslash :\" in a group name,the group is created, although the \ character will not display in the name.

Instant Contacts - User policy doesn't turn off address book You use the WebSphere(R) Administrative Console to assign user policies, including that which allows users to add entries to the personal address book. Note that even if you uncheck "Allow personal address book" when you create a new policy, the "Add to address book" option still displays when you add new contacts and search for names in Instant Contacts.

Instant Messaging - Chat window pops upThe chat window pops up in front of other windows under the following circumstances:

z On the Linux platform using Mozilla (1.4 and JVM 1.4.2), when you start a chat with someone in your Instant Contacts list, minimize the chat window, and then click outside Instant Contacts, the chat window pops up.

z On the Windows platform using either Mozilla or Internet Explorer, when you are chatting with someone (with the chat window on top), click elsewhere so the chat window goes behind the main window, and then change your status from "Do Not Disturb" to another status, the chat window pops up on top of the other window. This also happens if you choose "Log in to instant messaging" if instant messaging becomes disconnected.

Instant Messaging - Chatting with multiple people and DND status If you are chatting with more than two people and one chat participant changes their online status to "Do Not Disturb," participants can still send chat messages to that person.

103

IBM Workplace Collaboration Services 2.6.1 Release Notes

Instant Messaging - Performance when searching With the Mozilla browser, performance may be slow (a 2- 3 minute wait) when you try to type a name in the Search for field in the Directory Search dialog box when searching for someone to invite to join a chat. Switching to another application and then returning to the Directory Search dialog reduces the delay.

Instant Messaging - SIP Presence IM re-start and chat problem If an administrator re-starts the LWP_SIP_Presence_IM application, and two chat partners (User1 and User2) engage in a chat, User2's chat message will display twice in User1's chat transcript. In addition, a script error may display. Click OK in the error message dialog box to continue to chat.

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. The option to overwrite is shown, but 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

Portlets available for selection do not always work When you add a portlet to a portal page or to an application page, be aware that incompatibility between IBM WebSphere Portal infrastructure and IBM Workplace Collaboration Services infrastructure will trigger a variety of code exceptions instead of explanatory error messages. These exceptions are caused by the fact that the product allows you to select from the full set of administrative and productivity portlets when you add content (portlets) to the pages of your portal site or application. The list of portlets, including application components, that is available to you for selection and deployment on a page is not limited; however, it should be. You can choose to add any portlet to any page, regardless of the permissions granted by portal access control for the page or the portlet (or both) and the requirements of application components, which are specialized portlets that require the collaborative domain object (CDO) and related objects (business components, community role mappings, etc.) to function properly. If the required infrastructure objects are not available when the system attempts to place the selected portlet on the page, exceptions will display.

This problem will be corrected in a future release of the product, when the portlet selection list is filtered for various contexts, thereby ensuring tighter synchronization and seamless coexistence between the IBM WebSphere Portal foundation and IBM Workplace Collaboration Services. In the meantime, you will discover by experience the following general conditions when you attempt to add portlets to pages:

1. Some portlets are not allowed on any page. 2. Some portlets are allowed only on application pages. 3. Other portlets are allowed on any page.

Please see the related Release Note "Do not use Portal Administration to maintain applications".

104

IBM Workplace Collaboration Services 2.6.1 Release Notes

Search and Mail portlets may display empty This situation only happens when restoring a saved image of WCS 2.6 (including the database) before starting an upgrade. It does not occur using a clean database or when restoring the pre-populated database after the upgrade.

Search has limited support for wildcards Search only accepts wildcards at the end of a search term, in the format wildcar*, not *ildcard or wil*card.

Web conference tools - Warning message when installing While installing the Web conference tools so that you get the most out of screen sharing, you may see the following warning message:

Do not stop the installation. Click Continue Anyway to proceed with the installation; this will have no adverse effects.

Web conferences - Removed participant still a participant In some cases, people may be participants in a Web conference because they were added both as an individual and as part of a group. If the group is then removed from the Web conference, all members of the group receive notification about the removal. However, if any users in that group have visited the Web conference information page or have also been invited as an individual, they will still be able to access the Web conference, even though they receive a notification that they have been removed.

105

IBM Workplace Collaboration Services 2.6.1 Release Notes

Web conferences - Removed presenter can still present If two conference participants with the presenter role join a web conference and one of them is removed from the Participants list during the conference, the removed participant can still access the Web conference and can click the Click to Present button to become the current presenter.

Web conferencing - Poor display of Microsoft Powerpoint slides If you are viewing Microsoft Powerpoint slides during a Web conference, and the file contains multiple slide masters, the display may be not be optimal. For example, you may see blank pages, missing text, and so forth. To avoid this problem, make sure your Powerpoint slides use only one slide master per file.

WebSphere Portal issues

Content palette is inaccessible using keyboard shortcuts If you use the content palette to add portlets to the pages of your portal or application, you will notice that you cannot navigate in the palette using keyboard shortcuts. In addition, the drag-and-drop functionality provided by the content palette has no keyboard alternative within the palette. The content palette is accessible with mouse actions only. This IBM WebSphere Portal limitation will be corrected in a future release of that product and integrated in a future release of IBM Workplace Collaboration Services.

As an alternative to using the content palette to select and drag-and-drop portlets or components to a portal or application page, you can use the Administration portlets for managing pages and editing page layout: From the toolbar, click Administration -> Portal User Interface -> Manage Pages and navigate the page hierarchy to select the page where you want to add portlets or components. At the target page, click the Edit Page Layout icon to open the Edit Layout portlet, where you can add and arrange portlets and components on the page.

Pages are invisible after editing if left in inactive state A page is deactivated when you start making changes to it. When you edit the page of a portal or work site or an application, all changes are effective immediately and cannot be undone or cancelled. While you edit the page, it remains inactive. Other users will not be able to see the page until you commit the changes by clicking Done. Make sure that you click Done before you leave the page editor to activate the page for users. If you fail to click Done after editing a page, the page will not display because it is inactive. If you have editor access to the page, you can return to the page editor and activate the page to restore its display in the portal site or the application.

You are apt to encounter this limitation of IBM WebSphere Portal more frequently when you edit portal pages than when you edit application pages. The application editor of IBM Workplace Collaboration Services displays the Done button in the navigation bar of the editor, making it difficult to leave the editor with pages left inactive and, consequently, invisible to users. In IBM WebSphere Portal, however, the Edit Layout portlet (Administration -> Portal User Interface -> Manage Portlets) displays the Done button at the bottom of the portlet, where it can be hidden from view.

In general, avoid using the Back button of the browser to navigate through your portal or work site. For more information about managing portal pages, refer to the IBM WebSphere Portal Information Center.

106

IBM Workplace Collaboration Services 2.6.1 Release Notes

IBM Data Access Tool issues

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.

Error message when pressing a control character in Name field When entering or modifying a name in the Name field, located in the Basics tab of the form attributes editor in data access designer, you can only use valid name characters from the set: { a-zA-Z0-9 _}. If you press any control characters, such as CTRL or ALT, and then move your focus out of the field, you will get an error message that says the control name already exists.

Favorites list is not retained in team space catalog When you choose some Team Spaces as Favorites in a browser catalog, the Favorite settings are not retained in the Workplace Managed Client Team Spaces catalog view.

Filter is removed after records are added or deleted If you are filtering a set of records that have a common value and then add or delete a record, the current filter is removed before the record is added or deleted. This means that all the records associated with that particular design element now display (and not just the ones that have the value specified in the filter).

Fonts appear differently when previewing a print When previewing a printout of a form, grid, or report, the font in the print preview may appear differently than the font used in the database application. This usually occurs when the system on which you are viewing the application does not support the font used in the application. To correct this, set the font in the application to one that is supported on your system.

Foreign key violation error explanation If you get an error message in the data definition editor of data access designer that says Data access is unable to save data because it would have caused a foreign key violation, it means that you have attempted to create a duplicate relationship. Data access does not support having more than one relationship using the same foreign key or having foreign keys with the same name in one database application.

107

IBM Workplace Collaboration Services 2.6.1 Release Notes

Image file names with special characters cannot be imported If the file name of an image that you are importing into data access designer contains a special character, the OK button in the import dialog box will be disabled. You must rename the file name to not include special characters to be able to import the image into the database application.

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.

Maximum length of table name is 128 characters The name of a table in a data access data definition cannot exceed 128 characters. Data access will not let you enter more than 128 characters in the table's Name field.

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. When printing a form that contains a button with an image, the image does not print.

108

IBM Workplace Collaboration Services 2.6.1 Release Notes

6. In order to preview and 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 Microsoft 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 the built-in version of Linux Mozilla V1.4, take the following steps: 1. Click Web Browser in the Managed Client Switcher bar. 2. Click Print > Page Setup from the browser toolbar. 3. In the Page setup window, check the Print Background (colors and images ) option. 4. Click Done to save your changes.

7. 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 printingbackground images, do not enable the fit-to-size option for the image.

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

9. For Linux/Mozilla users, if you disable wrapping for a field with a Multiline Edit control, be sure to enable the horizontal scroll bar. If you disable wrapping but leave the horizontal scroll bar disabled (the default), 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.

10. When printing a form, grid, or report that has a text decoration, you may notice that the font style on the printout does not look the same as the font style displayed in data access viewer. To make sure they appear the same, uncheck the Use default font check box in the Font tab of the attributes editor and click Choose Font to select a new font. If you want to continue using the default font but want to ensure that it displays correctly when printing, simply select the default font from the list of fonts.

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

Time picker uses period separator in Swedish translations If you are using a Swedish translation of data access tool, and there is a time picker in a form that you are using, you must enter time in the time picker with the hours and minutes separated by a period (HH.mm), for example 13.32. Using a time format with the hours and minutes separated by a colon (HH:mm), for example 13:32, is not valid because the Unicode Common Locale Data Repository specifies that a period separator should be used.

109

IBM Workplace Collaboration Services 2.6.1 Release Notes

Using Unicode characters in name fields Unicode characters that are not in the Letter class cannot be used in table names, column names, or relationship names. If you try to use a Unicode character that is not in the Letter class in a name field, you will get an error.

Working with default values in columns Default values for a table column are treated as XPath expressions. In order to specify a string literal value in the column to appear in data access viewer, the value must be included in single quotes in data access designer. For example, 'Example Default Value'.

Activity Explorer issues

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 public group names. However, you can add multiple members to a shared object by dragging their names or the name of a personal group from Instant Contacts to the object.

Cannot open Activity Explorer by dragging file to a contact When a user has the Workplace Managed 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 will succeed.

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 theclipboard, pasting the text to a text editor, and then printing from the text editor.

Cannot search across shared objectsYou 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.

110

IBM Workplace Collaboration Services 2.6.1 Release Notes

No detailed activity logs Activity Explorer does not currently provide a detailed event log that describes the actions taken on a member's shared objects.

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.

111

IBM Workplace Collaboration Services 2.6.1 Release Notes

Known problems and workarounds

Installation issues

CD install Productivity Tools icon temporarily placed on desktop When installing Workplace Designer, the Productivity Tools icon is temporarily placed on the desktop; the icon will disappear after the installation is complete.

i5/OS: lwpGenPluginCfg.sh does not work in clustered environmentOn IBM i5/OS, the script lwpGenPluginCfg.sh does not regenerate the WebSphere Application Server plug-in on the Deployment Manager in a clustered environment.

WorkaroundBefore running lwpGenPluginCfg.sh on the Deployment Manager in a clustered environment, open thescript file in a text editor and make the following changes:

z Replace all occurrences of XYZWEBSPHEREXYZ with the name of the Workplace Collaboration Services instance.

z Replace all occurrences of /Base/ with /ND/ z Replace all occurrences of /PME/ with /PMEND/

i5/OS: Runtime 2.6 install shows incorrect WSE instanceWhen installing Designer Runtime 2.6 on a WSE 2.5.1 server, with an i5/OS platform, if you choose, forexample, to install Designer Runtime 2.6 in QIBM/UserData/WebAS5/Base/<InstanceName>, where<InstanceName> is the WSE instance, the <InstanceName> may show as having changed in the WSE summary screen.

The workaround is to enter the correct <InstanceName> parameter again.

Increasing the buffer pools for DB 2For DB2, the default buffer pool size is 500. This may lead to problems during installation where thePortal, WPCP, and WMM database tables are incorrectly bound to the LWP4K buffer pool instead of theexpected IBMDEFAULT buffer pool.

You can avoid this problem by increasing buffer pool sizes in DB2 as follows:

db2 alter bufferpool IBMDEFAULTBP size 20000db2 alter bufferpool LWP4K size 20000db2 alter bufferpool LWP32K size 12000

112

IBM Workplace Collaboration Services 2.6.1 Release Notes

Switching between languages in CD-installed productivity toolsUsers cannot switch between group 1 and 2 languages in a CD-installed IBM productivity tools worksession. You can switch between languages that are in the same group.

Not all possible languages are downloaded during a CD-based installation. Only certain languagecomponents are installed, depending on the chosen language. Examples are listed below.

z If the user installs in English (default), no other language fragments are installed. z If the user installs in French, all group 1 languages are available, but not group 2 languages, such as

Arabic. z If the user installs in Arabic, all group 2 languages are available, but not group 1 languages, such as

French.

A workaround is to provision (or install from CD) one installation in a group 1 language (not English) and a second with the OS set to a group 2 language, which could also be English.

Workplace Designer: Install second client to its own directoryIf you have a Designer (2.5.x or 2.6) client installed on a Linux system, and you attempt to install a newDesigner 2.6 client to the directory of the existing client, you get the error message: "The product is installed in the specified location: . . .". If you then attempt to install to a different, valid directory, you willget the same error.

WorkaroundCancel out of the installation program and then re-start it. When prompted for an installation directoryenter a valid one (i.e., not the existing version's directory).

Configuration issues

Corrupted characters appear in logs for some DBCS systemsOn some DBCS systems, like Windows 2000 Traditional Chinese, after installing Workplace and viewingthe SystemOut.log in PortalServer/log, you may notice some corrupted characters that display as "??????", as in the example below:

Specifically, this happens for Traditional Chinese. The problem is that the country code and language properties are set incorrectly in the WebSphere Portal Localizer Service.

113

IBM Workplace Collaboration Services 2.6.1 Release Notes

To correct this, open up: <wcs_install_directory> /PortalServer/config/services/LocalizerService .properties and make sure thelocale.default.language and locale.default.country properties are set correctly, then restart the server. For example, the correct settings for Traditional Chinese should be:

locale.default.language=zh locale.default.country=TW

You can find additional information about the Localizer Service in the WebSphere Portal InfoCenter at: http://publib.boulder.ibm.com/pvc/wp/502/ent/en/InfoCenter/index.html

Mixed-case LDAP groups may cause some apps to fail When you enable security against a node deployment of Workplace Collaboration Services 2.6, and your administrator group in the LDAP directory contains characters in mixed case, for example wpsAdmins, certain applications such as LWP_Persistent_Chat and LWP_CAI may be unable to start causing the Team Space and Web Conference applications to fail.

The administrator can work around this problem by re-installing the server and enabling security using all lower-case characters for their Administrators group, or by re-mapping the roles for the applications that are failing in the WebSphere Administration Console by doing the following:

1. Log into the Administration console. 2. Go to Applications > Enterprise Applications. 3. Click LWP_Persistent_Chat. 4. Go to Additional Properties. 5. Click "Map security roles to users/groups", and replace the value in there. Change "cn=wpsadmins,o=default organization " to the group name specific to your LDAP directory for example: "cn=wpsAdmins,o=acme" in place of the previous entry.

Administration issues

Domino PKI adapter fails with custom user registry There is a known problem that occurs if the IBM Workplace Collaboration Services server is configured to use:

z a Custom User Registry (CUR) backed by Cloudscape or DB2, and z one or more Domino PKI adapters, and z a PKI role mapping to a user other than wpsadmin

If this configuration exists, he setup for any and all Domino adapters will fail, and the adapter can not be used.

Workaround Don't provide any role mappings for the PKI role. This makes wpsadmin the effective user for the adapter.

114

IBM Workplace Collaboration Services 2.6.1 Release Notes

i5/OS: WebSphere Application Server jobs have incorrect names In a clustered environment on i5/OS, all WebSphere Application Server jobs appear as "JAVA" when viewed through the WRKACTJOB command. In previous releases, the jobs had names indicating their individual functions, for example, "Web_Sphere_" and "Mail_Serve".

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

Workaround

z Start the WPS server and click 'Administration'

z Click 'Manage Pages'

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

115

IBM Workplace Collaboration Services 2.6.1 Release Notes

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

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

LDAP_OPERATIONS_ERROR (1) message An LDAP_OPERATIONS_ERROR(1) in the systemout log file indicates an internal error on the LDAP directory server. If you see this error, restart the LDAP server, and then restart the Workplace Collaboration Services servers.

116

IBM Workplace Collaboration Services 2.6.1 Release Notes

Mail details: "When user exceeds maximum mail storage ..." error If either of the following error messages appear:

verify that the value in the field outlined below has a valid numeric value between 0 and 65534.

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"

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 .

117

IBM Workplace Collaboration Services 2.6.1 Release Notes

With SQL datastore, database space needs to be reclaimed File attachments to mail messages are temporarily stored in the LWPMSG.NGN_FILESTORE table. There is an issue in the current release where the Attachment cleanup task does not delete the appropriate records in this table.

Please execute the following commands to reclaim database space; normally, this task runs once a day at 3 AM:

1. Startup a SQL Server command line prompt

2. If SQL server is on local host: osql -E -d <database_Name> -i FileStore.sql -o FileStore.log

If SQL server is on remote host: osql -d <database_Name> -i FileStore.sql -o FileStore.log -U sa -P <sapw> -S <server_DNS>

3. DELETE FROM LWPMSG.NGN_FILESTORE WHERE (DATEDIFF(mi, LASTMOD, GETDATE()) > 60) go

Wpcpaudit.log not found in log directory Team spaces and Documents activity is recorded to the wpcpaudit.log, but the log file cannot be found in any likely \log directory. You need to edit the wcm.properties file to enable logging activity and to write the audit file to the correct \log directory path. The current default path is only an example.

Open the wcm.properties file with an editor. Change the wcm.audit.enable and wcm.audit.log properties to the following values:

wcm.audit.enable = true wcm.audit.log = <wp_root>\log\wpcpaudit.log where wp_root is the proper value for your site.

NOTE: Because the wpcpaudit.log is not in <wp_root>\log\wpcpaudit.log, it will not be found by the collector tool and therefore will not be sent to Support.

"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.

118

IBM Workplace Collaboration Services 2.6.1 Release Notes

IBM Workplace Collaborative Learning issues

Chinese and Polish characters not appearing correctly Chinese and Polish characters may not appear correctly Simply add the following setting in the WAS admin console to fix this issue:

Application Servers > server1 > Process Definition > Generic JVM arguments -Dclient.encoding.override=UTF-8

(Where "server1" is the name of the WAS server).

Collaboration Space Link not showing for curriculum /certificate When a Collaboration Space is created for a curriculum or certificate, and a user goes to enroll in either of them, the link for the Collaboration Space does not show.

Steps to Reproduce 1. Log in to LMS as "Administrator" 2. Go to Course Catalog --> Register Master --> Certificate/Curriculum Master and fill the in details (no

pre-req needed). Add in a course and then Save 3. Go back to Course Catalog --> Register Course Entry --> Certificate/Curriculum, and choose the

Certificate/Curriculum you just created 4. Select the "Allow Self-Enrollment" box 5. At the 'Discussion' section, select "Course Space Collaboration", and give it a name 6. Save the course 7. Log in to Workplace as a Student 8. Go to the Learning Portlet, and use "Search Catalog" to search for the Certificate/Curriculum you just

created:

119

IBM Workplace Collaboration Services 2.6.1 Release Notes

Expected Result Name of Collaboration Space, with no link, before enrollment; Name of Collaboration Space with link after enrollment

Actual Result Nothing is shown

Workaround If you go to the Curriculum or Certificate section (depending on what you enrolled in) you can get to the Collaboration Space by clicking on the Discussion Link, as shown below:

Configuring LMS to authenticate by cn instead of uid attribute Some configurations authenticate users by their 'cn' attribute and not their 'uid' attribute (default for LMS). The System Administrator may change this behavior by editing the ds-settings.xml and settings.xml files in each of the LMS's components, i.e., LMM and DS. These files are found in the following locations:

\WebSphere\AppServer\installedApps\<servername>\LWP_LMS_LMM.ear\lmmWeb.war\WEB -INF\classes\settings.xml \WebSphere\AppServer\installedApps\<servername>\LWP_LMS_DS.ear\dsWeb.war\WEB-I NF\classes\settings.xml \WebSphere\AppServer\installedApps\<servername>\LWP_LMS_LMM.ear\lmmWeb.war\WEB -INF\classes\ds-settings.xml \WebSphere\AppServer\installedApps\<servername>\LWP_LMS_DS.ear\dsWeb.war\WEB-I NF\classes\ds-settings.xml

The following lines inside the <commonschema> section of the <ldap> section in each file should be edited as follows:

120

IBM Workplace Collaboration Services 2.6.1 Release Notes

Original <ldap>

.

.<commonschema>

.. <mapping name="LdapId" wmmAttribute="uid"/>

. .<mapping name="UserId" wmmAttribute="uid"/>

</commonschema></ldap>

Revised: <ldap>

.

.<commonschema>

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

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

</commonschema></ldap>

That is, replace 'uid' with 'cn' to get LMS to authenticate against the 'cn' rather than the 'uid' attribute value. The server should be restarted after making the above changes.

Note that any of the other attributes may also be used. However, the LMS assumes that users' credentials are unique, so no two users should have the same username, be it the uid attribute value, cn attribute value, or other values.

Course deployment failures when using FTP When using FTP with learning content servers in certain network environments, creation of new course offerings may fail. The following message will be repeated several times in the WebSphere_Portal SystemOut.log file:

[dd/mm/yy hh:mm:ss:sss GMT] 575e34d5 SystemOutO java.io.InterruptedIOException: Read timed out

Workaround Use a remotely mounted file system for access to the learning content servers.

Course management: Problems with using Turkish and MS SQL There are issues with searching for courses, updating masters, and running reports with Turkish and MS SQL. These are known issues; there is no workaround at this time.

121

IBM Workplace Collaboration Services 2.6.1 Release Notes

Courses need to be added twice while creating a certificate Courses may not get added to a certificate at first. Click on the 'Add courses' button again, select the courses, and click 'Continue' to save that Certificate into the Masters Catalog.

Errors may lead to server degradation You may see any of the following error messages in the SystemOut*.log files running a large workload:

ResourceException with error code WS_INTERNAL_ERRORFunction sequence errorFatal error occurred during Connection reassociation

These errors all have the same cause, and can be addressed by installing the WAS cumulative fixpack 5.0.2.11.

How to prevent Inactive Users showing up in User Searches To prevent Inactive Users from showing up in User searches it is not sufficient to remove them from the LDAP. The correct process is to de-roster the user first, before deleting the user from the LDAP. This will ensure that, in addition to not appearing in a user search, the user will also not appear in places like Results by Course, or enrollment history reports.

Removing a user directly from the LDAP without first de-rostering that user will mean that, while the user will not appear in user searches, they will show up in areas that query the database directly, such as enrollments for a course.

i5/OS - Using i5/OS as an FTP server for CLIMP may not work . If you use i5/OS as the FTP server when using the CLIMP utility to import an on-line course to the Learning server, the course may not import properly. There will be no error messages, but the unregistered master won't show up when you look for it in the LMS Admin GUI.

Workaround: Use the Authoring Tool to send and import the course to the Learning server. The Authoring Tool works fine when you use i5/OS as the FTP server. For more details on setting up the system for this type of FTP operation, see "i5/OS - Verify FTP attributes before using i5/OS as FTP server" in these release notes.

If you want to use CLIMP, then use a Windows or Unix FTP server instead of i5/OS.

122

IBM Workplace Collaboration Services 2.6.1 Release Notes

i5/OS: Workaround if "Send Package to Server" fails in Learning When sending a package to the Learning server from the Authoring & Assembly Tool, you may encounter the following error:

Network error detected during the operation

This error occurs if the FTP server is down, or if it has a network problem.

Workarounds 1. Use a different FTP server.

2. If you don't have another FTP server available:

A. Use Microsoft Windows Explorer to manually copy the package to the target server.

B. Use the "Server import" option in the Authoring & Assembly Tool tool to import the course into IBM Workplace Collaborative Learning.

iCal received but no button to add to calender When Students enroll in a course, they should be able to go to their Mail Portlet, check their mail and there should be an e-mail notification. When the e-mail notification is opened there should be a button "Add to Calendar", as shown below.

Workaround:If there is no "Add to Calendar" button, increase the e-mail timeout. In the LMS, go to Settings\LMM\EMailand increase it from the default of 60.

123

IBM Workplace Collaboration Services 2.6.1 Release Notes

Import error 500 when importing a course in Authoring ToolFor all servers running on IBM HTTP server 2.0.47 or later, an error is reported while importing a coursefrom the Authoring Tool. This is due to an inconsistency in the server plugin DLL for newer versions ofthe HTTP server and can be ignored.

WorkaroundInclude the port number of the LMS server running on workplace - 9080, e.g., http://servername:9080/lms-lmm/import, rather than http://servername/lms-lmm/import. On a networkdeployment, the name of the LMS server will need to be listed, not the HTTP server.

Java folder missing for Solaris install of Learning Client CD After the installation of the Learning Client CD on Solaris, there is a known issue where the Java folder is not created in the 'utils' folder; only the 'bin' and 'lib' folders are installed. As a result, the utilities cannot be executed after installation has completed.

WorkaroundModify the .sh files to use the JVM on the machine where the Learning Client is installed.

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.

LMS makes excessive query to LDAP ServerThis issue can be caused by using LDAP groups as criteria for Automatic Role Assignments andCustomization settings. In this scenario, if some of the groups have a large number of users, the LMSwould poll the LDAP for each user in the group in order to match the current user. This causes the LMS Server to continuously query the LDAP Server, making the LDAP server unable to authenticate users toLMS.

The workaround is to avoid using groups and add users into the Auto Role Assignments manuallyinstead.

Offline issues z 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.

z A problem with the local data store is usually only repaired by removing the Managed Client's workspace directory and running Setup again. This will re-initialize the data store, and synchronize it with the server data store.

124

IBM Workplace Collaboration Services 2.6.1 Release Notes

z 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.

z When in Offline mode, messages addressed to groups must include the domain name of the group (for example, GroupName@domain.com), 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.

Performance issue with SQL Server and large database tables There are performance issues with a SQL server and large database tables. This only applies to systems that have been upgraded to WCS 2.6; it does not affect new installations.

WorkaroundOpen the WebSphere Admin Console - http://{yourservername}:9091/admin JDBC Providers -- Microsoft JDBC driver for MSSQLServer 2000 -- Data Sources -- wps50Press [Custom Properties] under the Additional Properties section

If the parameter "sendStringParametersAsUnicode " does not exist, it must be created:

Click [New] at the top of the page - For "Name" enter the following (exactly as below, java is case sensitive):

sendStringParametersAsUnicode - For "Value" enter:

false

If the parameter does exist, make sure its value is false.

Progress data for completed certificate not displayingOnce a user has completed an online course and certificate, choosing the Progress Summary view andselecting the icon for the Certificate results in a blank page being displayed.

WorkaroundStudents can use LMS to view progress details for Certificates.

Selected skills from current page only added to Skill Management In the Skills Management section, if you click on a job and choose 'Add existing skills', and select skills on multiple pages, only the current page selections are remembered, while previous page selections are ignored.

WorkaroundAdd skills from each page individually.

125

IBM Workplace Collaboration Services 2.6.1 Release Notes

Steps to enable Logging for Learning tools running outside WASLogging is not being generated for Learning applications running outside of a WebSphere environment. This issue applies to Data Archiver, Data Restorer and Learning Data Collector tools. In order to enablelogging for these applications, the following workaround needs to be applied:

z Copy and paste the following into a text file: workplace.logging.factory.was=com.ibm.workplace.util.logging.Log4jLogMgrFac tory

z Save the new text file as "workplace.properties".

z Copy the workplace.properties file into the directory from where the application is launched, i.e., the same directory as the .bat or .sh file used to launch the application.

Students can not view Learning Plan from Career DevelopmentThere is a known issue whereby students cannot view their Learning Plan from the Career Developmentportlet. To view the Learning Plan, follow the workaround as below.

WorkaroundStudents can view it from My Learning Portlet; the 'My Learning Plan' option will show that User'sLearning Plan.

Synchronization issuesFollowing are the known issues with synchronization:

z If you enter a partial host name when setting up the Workplace Managed 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 and clear the Managed 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.

z If the computer running the Workplace server 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 Workplace Managed Client is next started, synchronization and instant messaging errors, and exception messages in the SystemOut.log and SystemErr.log files in the Managed Client's <workspace>\logs directory. Since the data store is damaged, it should be repaired by removing the Managed 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.

z If the computer running the Workplace server 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 display the Stop Synchronization button and the synchronization activity indicator on the status bar. This does not affect synchronization itself.

126

IBM Workplace Collaboration Services 2.6.1 Release Notes

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.

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).

127

IBM Workplace Collaboration Services 2.6.1 Release Notes

"Unable to Create Collaboration Space " error in LMS (Oracle DB)When Saving an Offering that includes a Collaboration Space, this may result in an "Unable to Create Collaboration Space" error in the LMS. This issue only affects deployments using Oracle databases.

Workaround

z Log into Workplace as an administrator or student user.

z Go to Team Collaboration / Team Spaces

z Click on New

z Enter a Name

z Choose the "Team Project: Extended" template from the list

z Add a brief description if you wish

z Click on OK.

z Click OK in the next dialog.

z Wait until the Team Space has been successfully created

Once the above steps have been completed, you will be able to save Course Offerings that include Collaboration spaces.

"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.

128

IBM Workplace Collaboration Services 2.6.1 Release Notes

Bad content appearance copying spreadsheet cell region to NotesWhen copying a spreadsheet cell region and pasting it into Lotus Notes, the contents do not displaycorrectly. To bypass this limitation:

z Copy a spreadsheet cell region

z Paste it to Notes with the menu commands "Edit -> Paste Special"

- Choose "Rich Text", and it will be pasted as an editable table - Choose "HTML", and it will be pasted as an HTML form - Choose "Text", and it will be pasted as text - Choose "Device Independent Bitmap", and it will be pasted as a picture

Cannot create ten or more document libraries concurrentlyWhen ten or more users try creating document libraries at the same time, they receive error messages. The new document libraries do not have links, so the users could not use them.

WorkaroundThe problem is caused by database deadlock. Follow these steps to reduce deadlock with theWebSphere Portal database:

1. DB2 Version 8.1 FP4 or higher users only (skip this step if you use DB 2 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=YESdb2set DB2_INLIST_TO_NLJN=YESdb2 update db cfg for <wpcp_db> using locklist 1024

Note: In order to apply all of these settings, you need at least DB2 Fixpak 4 applied.

2. All database users : Connect to the WebSphere Portal database and type 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 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.

Charts in .123 documents with "by row" are set to "by column"Charts created in Lotus 1-2-3 with "Series by row" are set to "By column" when opening in ProductivityTools, which makes the chart display incorrectly.

WorkaroundTo bypass this issue:

1. Modify data rangez Right click chart, and then select "modify data range" menu to show the "modify chart data range"

dialog z If the series/legend labels are the first row/column in the data range, enlarge the data range to

include the first row and/or column and select "first row as label" and/or "first column as label" z Click "Create" button

129

IBM Workplace Collaboration Services 2.6.1 Release Notes

2. Change the "by column" to "by row" z Double click chart to move the focus on chart, and then right click chart and select "Instant

Formatting..." menu z Change "Data Series in" from "Columns" to "Rows" z Click "Create" button

File -> Close is missing from the IBM Productivity Tools

There is a "File -> Save and Close" menu option, but no "File -> Close" option in IBM Productivity Tools. This causes users to be unable to get out of a new document that they do not wish to save.

In addition, the shortcut key 'Esc' for "File -> Save and Close" does not work when adocument/spreadsheet/presentation file is opened in IBM Productivity tools. This is because the 'Esc' key is intercepted by the backend office service, and used for other functions.

WorkaroundUse Ctrl+F4 to close the current document directly.

IBM productivity tools cannot launch with a remote HTTP serverWhen the HTTP server is remote, the IBM productivity tools such as the word processing editor, thespreadsheet editor, and the presentation editor cannot start .

Workaround:Upgrade the plugin for the HTTP server by applying a WebSphere® Application Server patch.

This cumulative fix is applicable to the WebSphere® Application Server V5.0 plug-in component that has been installed during a base V5 installation. This cumulative fix is alsoapplicable to any remote Web server running a WebSphere® Application Server V5.0 plug-in component from a previous V5.0 Fix Pack or cumulative fix.

To obtain the fix, go to http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24007265 and followthe instructions for applying the patch.

Imported documents file name is truncatedIf you are using Microsoft Internet Explorer 6, and you import a document with a file name of 17 double-byte characters or more into a document library, the initial characters in the file name get cut off.

WorkaroundA hotfix is available from Microsoft. Go to support.microsoft.com and search the Knowledge Base for issue 897168, "A file may save with an incorrect file name or with a truncated file name in MicrosoftInternet Explorer 6."

130

IBM Workplace Collaboration Services 2.6.1 Release Notes

In High Contrast mode, some text cannot be shown for preferencesWhen the display mode is set to "High contrast white (Extra large)", some text and controls are truncated, or displayed incompletely on some preference pages.

In Spreadsheet editor, misspelled words cannot be recorded When you use the IBM spreadsheet editor, misspelled text cannot be recorded as macro commands.

Workaround To record macros with misspelled text, turn off the instant spell checker before you begin.

Linux - new platform fails to launch external applications An external application launched from Documents may fail depending on the Linux version to which Workplace Managed Client is installed.

RHEL 4 contains new default application behavior with the implementation of SELinux. Also, with GNOME 2.8 the menu and MIME definitions have changed, such that the legacy .gnome, .gnome-desktop, and .gnome2 directories no longer work. If you are associating the extensions to applications, and putting those files in any of these directories, you must reconsider the new locations and the new formats. Detailed reference information can be found at the following Web addresses:

http://www.ces.clemson.edu/linux/fc4_desktop.shtml

http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/desktop-guide/ch-ddg-menus.html

Linux issues The IBM productivity tools 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.

Macro recorder issue in IBM spreadsheet editor In the Spreadsheet editor, if input text has a spelling error, it will not be recorded in macros. Disabling the instant spellcheck will work around this issue.

131

IBM Workplace Collaboration Services 2.6.1 Release Notes

ODF file association is overwritten The following file extension associations that are defined by the OpenDocument standard are overwritten on Windows platforms when you install IBM Workplace Managed Client: .odt, .ott, .ods, .ots, .odp, .otp. If you want to change the association, please consult your system administrator. The following gives one possible way to change the association of certain file extensions.

1. In the file explorer, right-click on a file with the extension whose association you want to change, and then click "Open With".

2. In the "Open With" dialog, click the program that you want to use to open, or click "Browse" to choose the program on a disk.

3. Select the check box "Always use the selected program to open this kind of file".

Productivity tools will be suspended if changing region on LinuxIn the IBM Productivity tools, there is a regional setting for the preference. On Linux platforms, afteropening a document, or doing some other operation, if the user changes the regional setting, the systemwill be suspended. This is caused by an error in a sort method for the regional list.

The workaround is to change the regional setting first when running the IBM Productivity tools, and thennot change it after opening documents.

Productivity tools: General issuesFollowing are the general issues associated with the IBM productivity tools (word processing editor, spreadsheet editor, presentation editor, and project planner) in Workplace:

Interoperability with Microsoft Office

z If a Microsoft Word document contains a graphic object as its footer, and the object has some special layout property, it may cause the object to displayed on the wrong page when the document is opened with the IBM Workplace Managed Client word processing editor.

"Special layout property" means some combination of the wrap and anchor properties of the object in Word. For example, the object should have a "wrap through" property, with the options "Move with the text" and "Allow overlap".

Workaround: Find the object on the displayed page and move it slightly, it will be displayed in the correct place.

z The focus does not switch to the main menu bar when pressing the 'Alt' key on Windows XP platform.

Workaround: Users can switch focus to the main menu bar using the F10 key.

z When loading some Microsoft Word documents, only part of the contents may be shown.

Workaround: Click someplace else in the editor; it will refresh and the contents will then be displayed correctly.

132

IBM Workplace Collaboration Services 2.6.1 Release Notes

Object editing

z When loading a document containing a 3D object, the 3D object may not always be displayed correctly.

Workaround: Press page up/page down, or resize the document so that a repaint is forced; the 3D object will be displayed correctly.

Note: When saving a Microsoft PowerPoint document with 3D objects, or when saving an SXC document with 3D objects to .XLS (Microsoft Excel) format, the 3D object may not display correctly. There is currently no workaround for this issue.

Links

z Although there is a setting for the default web browser in the Preferences menu which sets the default browser to use the embedded browser in the Workplace Managed Client, this setting cannot be used in Productivity tools.

Workaround: For Windows, when a user clicks a URL link in Productivity tools, the program will try to use an external browser to launch the link. On Linux, an error dialog is displayed, which allows users to set the default external HTTP program by using Preference -> Productivity tools -> external program.

Productivity tools: Presentation editor issues Following are the issues associated with the presentation editor:

z Multiple instances of the presentation editor can be launched if users double-click two associated documents (.sxw/.sxc/.sxi) during a short interval when the presentation editor has not started. If users close one editor, the edit area in another editor will be grey out and the document data will be lost.

Workaround: Do not double-click two associated documents in the short interval before the presentation has been launched completely.

z In a slide with a Background on, creating and then double-clicking on a 3D object, you prevent users from being able to exit the associated state in order to select another object.

Workaround: Do another operation; for example, switch to another slide, insert a new page, etc.

z When creating a Presentation document OLE object via "Copy" and "Paste Special" in either the word processing editor or spreadsheet editor, double-clicking and entering the object's Edit status only allows for part of the Presentation document to be seen on the screen after clicking Presentation -> Screen Show.

Workaround: The whole page can be seen by dragging the scroll bars when editing the Presentation document OLE.

133

IBM Workplace Collaboration Services 2.6.1 Release Notes

z Microsoft PowerPoint cannot open a .ppt file that is saved from a Presentation editor file in which View -> Master -> Drawing fields are modified.

Workaround: Open th .ppt file in the Presentation editor and remove the values from any of these View -> Master -> Drawing fields, re-save the .ppt file, and it can then be opened in PowerPoint.

z Presentation backgrounds can use customized template files, following these steps:

1. Create a Presentation document.

2. Locate the template folder in the local file system by searching for the base folder whose name starts withcom.ibm.superodc.base.share in the user folder, for example, C:\Documents and Settings\username for Windows platforms. The template folder is: base folder/template/language/layout.

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

Productivity tools: Spreadsheet editor issues Following are the issues associated with the spreadsheet editor:

z The legend name of a chart will change after opening and saving a Microsft Excel document in the Spreadsheet Editor if the legend name is input in the Insert -> Chart -> Series page while building the chart, rather than being fed from cells.

Workaround: The problem may be avoided by referring the text string from cells.

z The source data of a chart will be lost after editing and saving a Microsoft Excel document if the source data is input in the Insert -> Chart -> Series page while building the chart rather than being fed from cells.

Workaround: Bypass this problem by getting the source data from cells.

Special fonts and vertical text cause .PPT to load slowly It may take some time to load .PPT documents that contain text with special fonts and/or vertical text direction.

Workaround Change the font of the text, or the text direction.

Unable to synchronize large files in Documents In the Managed Client, when you import a large file (approximately 9.5 MB or more) into an offline document library and then try to synchronize, an error occurs.

Workaround You must increase the value of the PostSizeLimit in plugin-cfg.xml. This value represents the largest file you can synchronize in Documents.

134

IBM Workplace Collaboration Services 2.6.1 Release Notes

For a local HTTP configuration :

Stop the Workplace server, and find \websphere\appserver\config\cells\plugin-cfg.xml. Make a backupcopy of this file (for example, plugin-cfg.xml.ORIG). Open plugin-cfg.xml in an editor and locatePostSizeLimit="10000000". The value is 10000000 bytes. Increase this value to accommodate the largest size file you will be importing into Documents. Start Portal, Mail_Server_1 and http.

For remote HTTP configuration and cluster :

While the Workplace server and the remote HTTP server are down, modify the values on both servers,and then restart them.

"3D shadowing on/off" doesn't work well for 3D chartWhen choosing 'Format -> 3D Effect', the item "3D shadowing on/off" does not work correctly for 3D charts. There are two ways to work around this defect:

z Deactivate the chart, then activate it again and the shadow will disappear z Close the "3D effects" window and re-open it; the icon buttons will work again

IBM Workplace Managed Client issues

A 2.5 to 2.6 update of the WEDM client does not workUpdating a 2.5 WEDM client to a 2.6 WEDM client does not work.

Accessibility issues z 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.

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

z 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.

135

IBM Workplace Collaboration Services 2.6.1 Release Notes

Accessibility: High Contrast issuesWhen a user is using High Contrast and opens the File -> Preferences -> Document Management Tools and Security, the Other Peoples Certificates information, when viewed, will have some truncation.

Document Management Tools has the server button missing and Security -> Other Peoples Certificate,has the whole Certificate Purpose section truncated.

Activating URL links will not launch Firefox on Linux You can activate URL links in the Managed Client, and you can also control how this URL is launched via the Web Browser preference. By default, when a URL is activated, the internal Web browser is used in the Managed Client. However, you can change this to use the default browser in Windows or Linux by selecting File -> Preferences, and then selecting Web Browser and the second option "Use OS default browser".

There is one limitation to this preference, the Firefox browser will not be used even though it may be setas your default OS browser on Linux.

Address book entry issues z 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.

z 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.

z 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.

z 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.

z If you use Get Information from Directory to retrieve contact information, the retrieved information appears to be editable. However, if you edit the retrieved information and save the contact, the edits to the retrieved information are not saved.

z 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.

z 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.

z 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.

z You may be able to save a group with a name that contains invalid characters. z 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.

136

IBM Workplace Collaboration Services 2.6.1 Release Notes

Applications do not get moved into new categoryWhen moving an application into a different category from the Workplace browser, the application issuccessfully moved in the browser but not in the Managed Client. For example, from the browser, if youcreate a Team Space application, move the application from the Team Space catalog to the Applicationcatalog, and then open the Managed Client, the application will be listed in the Team Space catalog andnot in the Application catalog. Currently, there is no workaround for this issue.

Attempt update of most features /plugins; problem w/Linux client If you add updated versions of most/all features and plugins to the update site, and then attempt to do a Silent Update with a Linux client, it is possible that the update will fail part of the way through, and you will not be able to restart the Linux client.

Before attempting to update most features/plugins on a Linux client, create backup copies of the platform and the workspace. If the update fails part of the way through, restore the backup copies and repeat the update with a smaller number of updated features/plugins in the update site.

Calendar and calendar entry issuesFollowing are the issues with Calendar and calendar entries in WCS 2.6:

z 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.

z File > Open does not work for calendar entries in the side calendar. To open an entry, select it and press Enter instead.

z If you repeat a calendar entry daily for a year, the limit is 99 days. z 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. z 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.

z If you create a calendar entry that repeats daily for one month, the calendar uses the number of days in the month the entry ends in as the number of days to repeat. (For example, if an entry's start date is January 31st, the entry ends on February 27th because February has 28 days.) If this does not result in the number of days you want, select Daily and type a specific number of days or a specific end date instead.

z The Today is value will not be updated if you leave the Managed Client running overnight. You must close and restart the Managed Client to update the value.

z When you print calendar views, the vertical bar that indicates conflicts between calendar entries is not printed.

z If you select the Expand rows, time slots print option, rows and time slots may not expand as expected.

z 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.

Calendar Docs incorrectly read by screen readerThe Screen Reader reads "Start" and "End" dates on Calendar Documents incorrectly when changingthem; this is a third-party software issue.

137

IBM Workplace Collaboration Services 2.6.1 Release Notes

Calendar Document 'Subject' limited to 765 characters The 'Subject' field in Calendar Documents is limited to 765 characters.

Calendar documents: Multiple select and open, only opens one doc 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 only on the first entry in the selection.

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

z 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).

z 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.

z 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.

z Meeting invitations may display the untranslated English word "Invitation" when languages other than English are in use.

Can't cancel Setup when provisioning operation is in progress If you attempt to cancel Setup while a provisioning operation is in progress, you will get the following error message: "Wizard can not be closed due to an active operation. You must cancel the operation before you can close the wizard." On the Windows platform, to cancel the operation and end Setup, press Ctrl-Alt-Delete and select the Task Manager. In the Applications tab select IBM Workplace - Setup and select "End Task". On the Linux platform open the System Monitor using System Tools. Find the Process name "richclient\eclipse\java". Select java and click "End Process".

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.

Column Width dialogue has inaccessible elements in High ContrastWhen a computer display is in High Contrast mode, the Column Width dialogue (View -> Column Width) will have some elements that cannot be accessed, making them unavailable.

138

IBM Workplace Collaboration Services 2.6.1 Release Notes

Contacts - NamePicker search list may be empty When you compose a new email message using the message editor and click on the "To" button to select recipient(s), if you click on the "Search in:" drop down control too soon, the search list may be empty. You may want to wait for a few seconds to allow the system to populate the search list before you click on the "Search in:" drop down control.

If the network connection to your server is lost while you are using NamePicker to select recipient(s) when you compose a message, you may get an empty search list when you click on the "Search in:" drop down control. The workaround is to dismiss the "Select recipient" dialog and restart it again. This time, the drop down list will contain the "Local Address Book" item for you to do the name search.

Context Menu in Monthly Tabbed Calendar Users are unable to see a context menu in the Tabbed Calendar - Monthly, for an Empty Day.

Context menu incorrect when multiple mixed entries are selected The Context menu displays incorrectly when multiple mixed entries are selected.

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.

Date picker is not handling dates prior to 1926 correctly The Date picker is not handling dates prior to 1926 correctly; those dates are being converted to, for example, 2026.

Deleting 'Over Quota' notification message causes log error When the client exceeds the Mail Quota, the server sends the user a message, informing them that their mailbox is over quota and must be cleaned up.

When this notification message is deleted on the Workplace Managed Client, it generates an error message in the log file. This is caused by the fact that the message from the server does not contain a valid "return" address, since it was sent by the server.

Example of error message in rcp 0.log

SEVERE common CLFMD0177E: Error converting MailAddress ::thread=Worker-10 ::loggername=com.ibm.eworkplaces.pim.client.common

139

IBM Workplace Collaboration Services 2.6.1 Release Notes

Differences in Managed Client Change Password functionalityIn the IBM Workplace Managed Client File --> Preferences menu sequence, there are two "ChangePassword" 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.

Document editors and document library issuesFollowing are the issues using document editors and documentation library in WCS 2.6:

z 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.

z 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.

z 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.

z In the document editors, the File menu does not contain a Close command. To close a document without saving, press Ctrl+F4.

z 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.

z 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.

z 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.

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

z 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.

z 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.

z 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.

140

IBM Workplace Collaboration Services 2.6.1 Release Notes

z 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.

z 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.

z 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.

Domino server put method must be enabled to save documentsWhen you save a document using Workplace Documents in the Workplace Managed Client, you mightreceive the following error: "An error occurred. The current document was not saved".

Workaround The Workplace Managed Client uses HTTP put to save documents to the server. You must enable HTTP put on the Domino server. Follow these steps to enable HTTP put:

1. Open the Domino server record by typing http://yourservername/webadmin.nsf in your browser.

2. Click Configuration -> Server -> Current Server Document .

3. Click the Basic tab and select Load Internet configurations from Server\Internet Sites documents . If this is already selected, then you skip steps 6 through 9.

4. Click Save and Close.

5. Click Web -> Internet sites.

6. Add a new Web site document by clicking Add Internet Site -> Web.

7. Click the Basic tab and type a name in Descriptive name for this site, for example WebDAV. If you do not type a name, the default name assigned is the type of Internet Site document with the host name or address appended.

8. Type the name of the registered organization that hosts the Internet Site document. The name must correspond to the organization's certifier .This is required for all Internet Site documents.

9. Click Yes or No in the Use this Web site to handle requests which cannot be mapped to any otherWeb sites according to your preference.

z Yes -- This Web site processes incoming HTTP requests if Domino cannot locate the Web sites that were entered in the "Host names or addresses mapped to this site" field.

z No (default) -- This Web site does not process incoming HTTP requests for which Domino cannot locate a Web site.

If you selected "No" in this field, then you have to type your Web server hostname or ip address in Host names or addresses mapped to this site field. If the site uses SSL, you must specify IP addresses.

10. Click the Configuration tab.

11. Under DSAPI in the middle-right side of the page, type the path to the Domino plug-in, which isinstalled in the WebSphere Application Server bin directory.

12. Select all the methods listed under Allowed Methods.

13. Select WebDAV as enabled, where WebDAV is the name that you assigned the Web site in step 7.

14. Click Save and Close.

15. Restart the WebServer.

141

IBM Workplace Collaboration Services 2.6.1 Release Notes

Downloading appears to hang for shared applications When sharing database applications, users with designer access can edit an application and promote their changes to the server. If you attempt to open the application once someone else has edited it, the Managed Client displays a message that asks if you want to download the updates from the server. Once you click OK and begin downloading, you may notice that the progress bar appears to hang about halfway through the download. In this case, the Managed Client may be waiting for you to take action on another window that is underneath the Application catalog window. To display any open windows, continue pressing CTRL + Tab or click the open Managed Client application located to the right of the Start menu in your system tray (Windows).

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 V 1.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 Managed 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 Managed Client. They are:

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

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

z .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.

142

IBM Workplace Collaboration Services 2.6.1 Release Notes

Feature Filtering not working with Eclipse update manager This issue applies to IBM Workplace features that have child features. If you have an update site that has an updated version of an IBM Workplace feature, and an updated version of an associated child feature, and if you have your client set up for a wizard update, when the Search Results panel appears, the "Filter features included in other features on the list" checkbox does not work correctly.

File - Open on Calendar documents causes an errorFile --> Open does not work for calendar entries in the side calendar. To open an entry, select it andpress Enter instead.

Globalization issues z 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. z 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.

Grammatical error in Out of Office message When the client cannot connect to the server while trying to submit Out-of-Office information, the following error is currently shown:

"The client cannot connect to the server and display out-of-office optionsat this time. Try again later."

The grammatically correct text of this message should be:

"The client cannot connect to the server and submit out-of-office optionsat this time. Try again later."

143

IBM Workplace Collaboration Services 2.6.1 Release Notes

i5/OS: Directories may not be removed after uninstalling When uninstalling the Workplace Managed Client provisioning server from a remote HTTP server or Node 1 of a clustered environment, some file directories may not be properly deleted.

Workaround: After uninstalling the Workplace Managed Client provisioning server from a remote HTTP server or Node 1 of a clustered environment, verify that the "WMC" directory no longer exists on your System i server. If it is still there, manually delete it.

On a remote HTTP server, the directory is:

/www/<instance>/WMC/

where instance is the name of the HTTP server instance.

On Node 1, the directory is:

/QIBM/UserData/WebAS5/base/<instance>/WMC26

where instance is the name of the Workplace Collaboration Services instance.

IBM productivity tools icon remains on desktopA non-functional productivity tools icon remains on the Windows desktop after productivity tools uninstall,and before system restart. The icon is not visible upon system reboot.

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

IBM Workplace becomes unresponsive after the server goes downWhen the IBM Workplace server goes down, the Managed Client will become unresponsive after sometime. You should exit IBM Workplace Managed Client and log in again after the server has been restartedsuccessfully. You can check if a server is online by entering its URL in a Web browser. If the server page does not appear, or shows an error, the server is still unavailable.

A workaround to using the Managed Client when the server goes down is to work in offline mode (File ->Work Offline), and continue working in the Managed Client offline until the server becomes availableagain. You may see a synchronization error if your preferences are set to synchronize when you gooffline, but you can clear the error message and continue working offline.

144

IBM Workplace Collaboration Services 2.6.1 Release Notes

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 Workplace server when prompted. Proceed through the dialogs and continue with provisioning the client. The client should display properly after reinitiating provisioning.

If problem provisioning may need to restart several times If you experience an error provisioning the client, you may be prompted several times to restart for features to be functional. If you see this message:

New features have been downloaded on to your system. To take advantage of the new features you need to restart your client. Do you wish to restart now?

respond "Yes" to restart.

Incorrect Message Size displayed Occasionally, messages containing a large amount of text will display an incorrect message size. This becomes evident if the message is larger than the 'Message Size Limit' policy value. The client will display an error if the message exceeds the Size Limit which states the size of the message. This may differ from the size value shown in the Listviewer.

Instant Contacts -- reaching maximum number of contacts Contact or contacts may appear in the Instant Contacts list when a user has reached the maximum number of contacts allowed, but the new contact or contacts will not be saved. Users who receive the message below may see the contact or contacts as being added but the contact or contacts will not be saved and will not appear in the list after the user restarts.

The contact or contacts will not be saved to your Instant Contacts list because you have reached the maximum number of contacts allowed. The maximum number of contacts is set by your system administrator.

Instant Contacts - Adding contacts and address book When you add a contact to Instant Contacts via e-mail address, it is also added to the list of contacts in the Address Book. However, sometimes the Address Book view is not automatically refreshed with the newly added contact. As a result, if you try to add one of these contacts to the Address Book, you are unable to do so and the message "The contact could not be saved successfully!" displays. Press F5 to refresh the list of contacts in the Address Book.

145

IBM Workplace Collaboration Services 2.6.1 Release Notes

Instant Contacts list - How search works There are some guidelines you should keep in mind when searching your Instant Contacts list for someone to chat with (for example, when you choose File -> New -> Chat or from the chat window, when you invite someone to join a chat):

z Search using the full name or e-mail address as it appears in your Instant Contacts list, depending on how the name was originally added. If it was added via a name search, enter the full name as it appears in your Instant Contacts list. If it was added via an e-mail search, enter the full e-mail address.

z Search using a partial name (for example, for the name Joseph Smith, enter "Joseph," not "Jo") works if the name was originally added using the name search method and was not edited (it is not a nickname ).

z Search using a wildcard (*) works if the name was originally added via an e-mail search. whether the name is a nickname or not.

z You cannot search for nicknames that were added to the Instant Contacts list using the name search method. This does not work.

Instant Messaging - Chat Messages Preferences text truncatedYou set chat message preferences by clicking File -> Preferences, the + beside Instant Messaging, and then Chat Messages. Note that some text in the Preferences dialog box for chat preferences is cut off(truncated). Click and drag the right side of the dialog box to resize it and display all the text.

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 in the upper-right hand in the status bar. (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, make sure you are logged onto IBM Workplace Managed Client and then click the "Reconnect to Instant Messaging" button.

Instant Messaging server specification in network deployment The name of the Instant Messaging server is specified in the pluginvalues.props file, which, for a Workplace Collaboration Services network deployment resides in the deployed WAR file for every node of the cluster. If the name needs to be changed because of a network topology change, then it must be updated on every node in the cluster. The Instant Messaging server name should instead be represented as a URL resource (in the same manner as the provisioning server) using the WebSphere Application Server Administrative Console. For now, you can change the value of the Instant Messaging server in a single properties file located on an HTTP server by defining the URL resource and pointing the URL resource value to that properties file. There is a patch and a workaround for this process documented in the Tech Notes database as FAQ # 1225228.

146

IBM Workplace Collaboration Services 2.6.1 Release Notes

Issue after changing Instant Messaging option in Notes plugin A Lotus Notes User Preference allows users to use either IBM Lotus Sametime OR Workplace Instant Messaging. Users can change this preference at any time and are not required to restart the Workplace client. There is functionality specific to the type of Instant Messaging being used in the Notes plugin. Hide-when formulas are used to display the proper components depending on the IM option. However, when a user toggles from one instant messaging option to the other, some hide-when formulas may get out of synch and will only work if the Notes window is reloaded. To reload a Notes window, simply close and reopen it. To reload the Workplace Welcome page, click on another tab. For example, if you are currently on the Today window of the Workplace Welcome page, click the Collaboration tab and then click back to the Today tab.

Large Messages may cause excessive memory consumption In cases where a very large attachment (10mb or more) is sent, the message may fail to be sent and the client may receive an OutofMemory Exception in the log.

If this occurs, the workaround is to delete the large message and restart the client. Then resend the message with a smaller message. Error handling for this problem will be improved in future releases.

Links section in Help is not supported When selecting Help -> Help Contents (or F1) there is a section called Links (located on the bottom left tab). Links is a Help feature that only works with Eclipse 3.0, it is not intended to work with the managed client.

Linux - People Finder/Links may not work in Managed 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 IBM Workplace Client software install directory >/Mozilla/plugins3. Launch the IBM Workplace client. Using links or the People Finder should now work.

Linux - WEDM update; occasional problem restarting workbench After a successful WEDM update, occasionally clicking 'Yes' in the "Update Check" dialog box that says "You will need to restart the workbench for the changes to take effect. Would you like to restart now?" does not result in the client being closed and restarted.

The workaround is to manually close and restart the client.

147

IBM Workplace Collaboration Services 2.6.1 Release Notes

Linux performance: Select online with no network connectivity If you choose the Workplace Managed Client Work online option but are not connected to the network, the system attempts to make the online connection. When it cannot, it reverts to offline. The period it takes to determine that online connectivity is not available can be up to 4 minutes.

Linux provisioning tool reset.sh is not executable by default The Workplace Managed Client installation program bundles a script tool to help remove the user's applications and configuration in order to provision to a fresh environment. On Linux, the script $INSTALL_DIR/rcp/eclipse/features/com.ibm.rcp.platform.feature_1.3.0.0400/utilities/serviceability/reset. sh is installed on the client desktop with only read/write permission by default. The administrator must manually give this script execute permission, which can be done using the chmod command.

Linux: No hourglass shown while opening large message While trying to open a large document, the client is still available (not frozen), but the mouse cursor is a standard pointer, not an hourglass; the user has no indication that their command to open the document in the documentation editor was received and is being processed. In tests, it took approximately 5 minutes for the client to open what was originally a 3MB message.

Linux: Print Preview has no mouse-less accessibility On Linux only, if you select a large document (more than one page) or multiple documents, and then choose Print Preview, the only way to get to the next page is by using the scroll bars; there is no "mouse-less" way to get to the next page or previous page.

Logoff/logon required after restarting stopped SSO service Once you enable Single Sign-on (SSO) for Managed Client products, an SSO service runs on the operating system, independent of the Managed Client. If you are running the Managed 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 Managed 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 Managed Client.

For example, if you stop the service from the Services pane of the Administrative Tools application, then you start the Managed Client, a log on is required as expected. If you then restart the service from this pane and start the Managed 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 Managed 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.

148

IBM Workplace Collaboration Services 2.6.1 Release Notes

Lotus Notes icon displayed on Linux When a user provisions the Workplace Managed Client (WMC) on Linux, by default the Lotus Notes icon is displayed on the Application Switcher (left navigation pane). It's up to the system administrator to install the setuplinux.bin on the update site located at: (\lwpupdate\features\com.ibm.workplace.notesinstall.linux.feature.<version #>\linux). If the user clicks the Lotus Notes icon and the setuplinux.bin is not on the update site, an HTML error page will be displayed.

If you don't want the Lotus Notes icon to be displayed, create a User Policy in the WebSphere Administrator Console (IBM Workplace software\User\Manage User Policies) and ensure that the "Allow Notes application plug-in" checkbox is not checked. Alternatively, one can use the default user policy and make sure the "Allow Notes application plug-in" checkbox is not checked.

Mail issuesFollowing are the Mail issues in the current release:

z Messages that you have in the Trash folder will appear in the All Messages folder in this release. z New links that you create in the Links section will appear in the All Messages folder in this release. z 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.

z You may be prompted with the error message, "The message could not be sent successfully" for any, but not only, these reasons: z 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.

z 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.

z If the mail address cannot be resolved successfully you will get a general error message in some cases. More detailed information is currently missing.

z 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.

z 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.

z 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 .

z 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.

z 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.

z 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.

z 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.

z 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.

149

IBM Workplace Collaboration Services 2.6.1 Release Notes

z 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.

z 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.

z 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.

z 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.

z 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.

z 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.

z To send an encrypted e-mail to a group, do not append the @domain name to the group name. Encryption will not work.

z We do not support archive and restore for this release. z 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.

z 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".

z 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.

z 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.

z 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.

z When using Typeahead to fill in a recipient's address in a new message, the following issues will happen: z 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.

z 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.

z 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 six 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.

150

IBM Workplace Collaboration Services 2.6.1 Release Notes

Manual script edit for IBM Support Assistant plug -in

For the IBM Support Assistant plug-in for the Workplace Managed Client, there are scripts used to run Support Assistant calls manually in cases where a user interface has not yet been created. The "cl_collect.sh" collection script for the Linux platform has a bug on line 31. There is no longer a "richclient.sh" script in the Linux directory, so the collection script fails to execute. To correct the problem, manually change line 31:

if [ -f "$1/rcp/richclient.sh" ]; then

to read as the below:

if [ -f "$1/rcp/richclient" ]; then

May experience long delay when accepting an update After accepting the dialog which indicates that new updates are available, you may experience a long delay before the client responds. The Product Update dialog may also go blank. Be patient - the process will complete successfully and you will see another dialog asking you to restart, to take advantage of the new features.

Meeting issues z 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.

z 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.

z 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.

z 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.

z 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.

z If you specify a meeting location with more than 1536 characters, it will be truncated to 1536 characters.

Must use standard /lwp context root on server for provisioningYou will not be able download and install the Managed Client from a server, unless you configure theserver to use the standard /lwp context root.

151

IBM Workplace Collaboration Services 2.6.1 Release Notes

Navigating with the keyboard Linux issues Following are issues encountered when navigating with the keyboard in the Managed Client, using Linux:

z 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.

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

Need to click twice after correcting invalid provisioning URLIf you enter an invalid URL during the initial provisioning in the "Provisioning server URL" field, you willreceive an error message, which is expected. If you then subsequently correct the URL and click 'Next', you will continue to get an error message. You need to click 'Next' one more time to proceed withprovisioning with the corrected URL.

Network outage during provisioning - recovery workaround If you experience a network outage during provisioning your client may launch with a blank perspective. If your client does not automatically provision missing features, after the outage is restored, you may need to perform the following manual workaround to restart provisioning.

Exit the client and remove the %WORKSPACE%\.metadata\.plugins\com.ibm.rcp.pagebuilder directory and restart. This should force a reprovisioning.

No error message if no certificates are imported When importing certificates from a file into the credential store using the client Security Preferences panel, the algorithm works through all certificates found in the file, and for each certificate, if it is of the correct "type" for the certificate page you are on, it will be imported, otherwise it will be skipped. A certificate is of the correct type if it is a CA certificate and you are on one of the CA certificates pages, or if it is an end-user certificate and you are on the "Other People's Certificates" page. If none of the certificates in the file are of the correct type, no certificates will be imported, but no error message will be displayed.

No feedback given by the Troubleshooting Search Index Feature If the user decides to use the Troubleshooting Search Index feature of the Managed Client, no feedbackis given once the rebuilding of the index is completed. To the user, the only indication that the rebuildprocess has completed is when the Create Index dialog is no longer displayed on the screen.

No feedback to user during search when index is not created When a user provisions (installs) the client for the first time, there is a delay before the local search index is created. If the user attempts to execute a search before the search index is created, then no feedback is given to the user that the index has yet to be created. Once the index is created, search will work normally.

152

IBM Workplace Collaboration Services 2.6.1 Release Notes

Occasional crash when closing WEDM client; restart client Occasionally, a crash occurs when closing a WEDM client after a feature update. Immediately afterwards, the client can be restarted and closed successfully.

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.

Occasional initial problem updating features in the WEDM client Occasionally a WEDM update of a feature (with associated child features and plugins) will fail one time, and then succeed a few minutes later. Running the client in debug mode indicates that this is casued by problems in the network.

Offline Draft meetings need to be saved with out addresses Users cannot edit a draft meeting while offline if the Invitee field does not contain a correct e-mail address.

Opening a folder, relaunch and tab title is wrong (Folder View) If you have an Inbox open, then go to the navigator and right-click on a folder (i.e., Drafts), then the 'Open in New Tab', it works correctly. If you then close the client and relaunch, the folder you opened in the new tab will have an incorrect tab title (in the example, using Drafts, after relaunch the tab title is "Folder View").

When a view part changes it's name, the new name is not saved to the workbench state file. However, once the view is restored (the user activates the view with a mouse click, etc.), the view will render the proper name. This is an issue caused by Eclipse and is expected to be addressed in a future release.

Page not found / no response from Managed Client download link When users click the "Download IBM Workplace Managed Client" link in the Downloads tab, and get no response or see a "Page Not Found" error, it is likely that the Managed Client provisioning components have not been installed on the server. To fix this, an administrator should follow the IBM Workplace Collaboration Services Information Center instructions on the "IBM Workplace Managed Client (Server Install)" CDs, to install the Managed Client provisioning components on the Workplace Collaboration Services server.

153

IBM Workplace Collaboration Services 2.6.1 Release Notes

Pages lost using a multi-page template When creating a new presentation document from a multiple-page template, the newly-created document will have only one page, with the other pages being lost.

PC clocks must have same times before synchronization In a recommended configuration, the Workplace server uses a remote DB2 server for data storage. In order for synchronization between the IBM Workplace Managed Client and the Workplace server to work efficiently, and to avoid data errors if there are edit conflicts when synchronizing, all PC clocks for all machines must be set to within 5 seconds of each other. Currently, synchronization conflict-resolution uses a "last saved wins" criteria: the last data change to a record overwrites anything earlier.

If the client's clock is several minutes behind the Workplace server's clock, and an e-mail message isedited and saved on both the client and server, the server change will always overwrite the client changeduring synchronization. In a similar fashion, if the DB2 server clock is behind the Workplace server andManaged Client time, a client change will be synchronized over a server change, even if the serverchange is later than the client.

Performance problems sending very large messagesFollowing are several performance issues around sending large messages:

z Large email messages (including all attachments, in-line images, and text/rich text) of up to 20 MB sent from the Managed Client will experience significant delays during processing to the Outbox, sending & receiving (synchronizing). These delays may be on the order of minutes.

z Sending extremely large email messages (20-30+ MB) from the Managed Client is not recommended. Doing so may cause memory errors on the server, and the message may be lost.

z The Managed Client on the Red Hat Enterprise Linux (RHEL) platform sometimes experiences memory errors when attempting to send large email messages (approximately 20 MB). If this occurs, the message may be lost.

z The IBM Workplace email server is configured with a maximum email message size that can be sent to or received from an outside email server. Attempting to send an email message from the Managed Client which is larger than these limits will appear to send the message, but it may be refused by the server, which may return an error at a later time. Contact your server administrator to determine the email message size limits for email to external servers.

Persistent error message screen - closure workaroundUsers may receive a "Cannot Create Security Context" error when starting the Workplace ManagedClient. This can happen when they shut down Workplace Managed Client and a javaw.exe processremains in the Windows Task Manager. It may also happen if the user is using Notes within theWorkplace Managed Client.

For example, after installing the IBM Productivity Tools, select 'Connect to server' to provision the Workplace Managed Client. Exit the IBM Workplace Managed Client when it appears, then re-launch the Workplace Managed Client. An error message screen appears, displaying the following content:

[Cannot create security context:Could not retrieve data...Could not retrieve connector data.]

154

IBM Workplace Collaboration Services 2.6.1 Release Notes

Note: If multiple javaw.exe processes are visible in the Task Manager, and it is not apparent which is connected to the Workplace Managed Client, the user should reboot the system rather than use the following instruction.

To close this error message screen, open the Task Manager and end the javaw.exe process. For example, on a Windows system do the following steps:

1. Press Ctrl-Alt-Delete. 2. Click Task Manager.3. Click the Processes tab.4. Locate and select the javaw.exe process. 5. Click End Process.6. Restart the Workplace Managed Client.

Pop-up date Picker - Month/Year Navigation not working right 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/year, or hold the Mouse key and select.

Preview pane does not always update Occasionally, a message will be selected in the listviewer that will "stick" in the Preview pane. Selecting other messages in the listviewer after this will not update the Preview pane.

At this time, the workaround to this problem is to restart the client.

Previewed Outbox Message is not cleared Messages in the Outbox can be viewed in the Preview pane. If an Outbox message is viewed in the Preview pane and then leaves the Outbox, the Preview pane does not get updated. Clicking the 'Delete' button in the Preview pane at this point causes the following error:

In future releases, the Preview pane will be cleared when the message is no longer present.

155

IBM Workplace Collaboration Services 2.6.1 Release Notes

Print Preview limitation with Web browser on Linux The internal Web browser has a print preview limitation on Linux, as outlined below:

1. Launch the Managed Client. 2. Select Web browser and enter a URL; then select a document to read. 3. Select the down arrow just to the right of the Print action button, and select Print Preview.

The format in the Web browser changes to a print preview look (with a header and footer), however there is no UI provided to allow the user to select 'Close' and change the format back to the original state. You need to either select 'Refresh' or press 'Print' to return to the original state.

Print queue does not show title of printed Calendar document 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.

Problems getting WEDM updates because of unresolved PREREQS If you are using WEDM provisioning and updates or provisioning is not occuring as expected on your client and you see messages in your SystemError.log such as PREREQS COULD NOT BE RESOLVED - Primary Package is NOT Registered as bundle in the database, you should contact your system administrator and have him reboot the PC that is running your WEDM server. You should relaunch your client and try provisioning again.

Provision applications can fail if insufficient space or rights If you attempt to provision applications to a disk that does not have sufficient diskpace or write access to provision applications, you may get error messages such as these:

"An error occurred while trying to provision this client, please refere to the log file for more details." "An error has occurred and could nto be logged; null"

In some cases, the client will launch with a blank perspective. In your log file you may also see errors such as "No space left on the device".

To provision applications not including the platform, you need to have 300MB available without language pack, or 325MB with language packs.

Provisioning can fail without error due to disk space Provisioning the Managed Client uses approximately 400 MB for English clients and 500 MB with language packs, not including application data. If you attempt to provision the Managed 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.

156

IBM Workplace Collaboration Services 2.6.1 Release Notes

Remove Invitee from Meeting; Cancellation address wrong When removing an Invitee from a Meeting, the Cancellation notice will not be correctly addressed; the notice in your out box will show it as being From/To the chair, but the notice will be sent to the correct person.

Removing the Managed Client workspace Removing the Managed 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 Managed Client workspace.

3. Delete the workspace folder/directory.

Repeating Doc can be modified if only savedWhen creating an all-day event, and expanding the Repeat "twisty" (which makes it a repeating all-day event), clicking the 'Save' button, as opposed to the 'Save and Close' button, allows you to still modify therepeating cycle. In fact, this modification should not be allowed.

RTL layout not rendered despite locale settingThe Managed 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 Managed Client. On Windows, edit the Target field of the desktop shortcut, byappending a space, then -dir rtl to the richclient.exe command. On Linux, append the -dir rtl parameter tothe command that starts the richclient in the richclient.sh file stored in the rcp directory.

Search field won't take Unicode keyboard combinationThe "Search for" field in the Managed Client will not take Unicode characters entered by using theUnicode keystroke combination. For example, the user will not be able to enter 'ALT+0212' and expect to see the appropriate character displayed. Unicode characters may be entered using Copy & Paste.

157

IBM Workplace Collaboration Services 2.6.1 Release Notes

Search results not displayed If a user performs a Search in a view of the Lotus Notes Application plug-in, zero results are returned from the search. if the user then modifies the search and clicks the "Search" button, the status bar shows a number of documents are returned, but no documents are shown in the Search view.

Workaround Click the "Search" button again, and the documents will be displayed in the Search view

Searching for a name with double-byte characters may not work If you select People Finder in the Search bar, and you try to search a double-byte encoded name (such as a name in Chinese), the result displayed in the embedded browser window will say "No matches were found".

Shared applications unexpectedly become local only If you notice that a shared application unexpectedly becomes local only, most likely the server copy became corrupted and was deleted from the server. If an error occurs while refreshing the data on the server, the server automatically deletes the application so the corrupted data does not get passed to other users. In this case, the application will need to be shared again.

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 languages This release includes spell checker dictionaries for the following locales.

User locale Locale code Dictionary Czech cs czech.dic Danish da dansk.dic Dutch nl nederlnd.dic English en us.dic English (Australia) en_AU aus.dic English (United Kingdom) en_GB uk.dic English (US) en_US us.dic Finnish fi suomi.dic French fr francais.dic French (Canada) fr_CA canadien.dic German (Switzerland) de_CH dschweiz.dic German de deutsch.dic Greek el hellas.dic Hungarian hu magyar.dic Italian it italiano.dic

158

IBM Workplace Collaboration Services 2.6.1 Release Notes

User locale Locale code Dictionary Norwegian no norbok.dic Norwegian (Nynorsk) no_NY nornyn.dic Polish pl polska.dic Portuguese pt portugal.dic Portuguese (Brazil) pt_BR brasil.dic Russian ru russian.dic Spanish es espana.dic Swedish sv svensk.dic Turkish tr turkiye.dic

System Admin account has 'Manager' access by default When giving users access control to shared database applications, you may notice that when you assign the user access role to the System Admin account such as wpsadmin, the System Admin may actually have edit rights that are available only to users with 'Manager' or 'Designer' access. This is because the System Admin account has 'Manager' rights to the system by default.

Tab name is the same for Learning and Web conferences When you select 'Web Conferences' or 'Learning' from the Switcher bar on the left of the Managed Client, a tab name will be added to the Windows menu. Selecting 'Web Conferences' will result in a duplicate name on the Windows menu. This will also happen when selecting 'Learning'.

Transition EUM provisioned client to WEDM with updates If your Administrator transitions your Workplace server from EUM to WEDM and modifies your policy such that you have additional features available, when you restart your client, you may lose functionality until all new features have been downloaded. When you receive the following message, click "Yes":

"New features have been downloaded on to your system. To take advantage of the new features you need to restart your client. Do you wish to restart now?"

You may have to restart your client several times, after waiting for the restart message, before full functionality is available.

Update silently installs unsigned features without warning With the Update Silently option enabled, unsigned features will be installed/updated without a warning.

Update wizard screens are not translated into Hebrew If Update/Install -> Automatic Updates Preferences is set to "Update using a wizard" and updates are available, the screens for the update wizard are not translated into Hebrew. The workaround is to set the Update/Install -> Automatic Updates Preferences to "Update silently".

159

IBM Workplace Collaboration Services 2.6.1 Release Notes

Use fully qualified server name for provisioning URL After downloading and installing the Managed Client, you will be prompted for a provisioning server URL. Be sure to use the fully-qualified server name and not the short name in this field, otherwise you will receive the error: "Failed to retrieve configuration file - check the provisioning URL to be sure it is valid".

User cannot simultaneously change the local and update features The user should always do an update check prior to switching locales. This can be done by setting the update period to 0 days, restarting and then waiting until the check has been performed (this could take a few minutes). If updates are available, the user should install them prior to stopping and restarting to do a locale-switch.

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.

Web browser tab in the Workplace Managed Client is not working Clicking the 'Web Browser' tab in the Workplace Managed Client causes the message "Page cannot be displayed" to be shown.

Workaround Choose "File -> Open in New Tab"; the web browser will then work as expected until the managed client is closed, and has to be re-done every time you start the client.

Web conferences - Screen share problems If you access Web conferencing through the IBM (R) Workplace (TM) Managed Client Teamspace calendar and, as a presenter, try to share your screen, you will be unable to do so. Instead, you will see a message saying that your browser does not support screen share, and that it must be using an up-to-date Java Virtual Machine.

In order to share your screen in a Web conference you need to have a separate (external) browser window open. Click Start --> Programs and open your browser. Note that your browser must also be running Sun Java 1.4 Virtual Machine (Sun plug-in version of Java Virtual Machine (JVM) 1.4.2 and Microsoft Internal Explorer 6.0 with Service Pack 1, Mozilla 1.4, or Firefox 1.0.

160

IBM Workplace Collaboration Services 2.6.1 Release Notes

Web conferences and Learning - Launching from Switcher bar By default, Web conferences and Learning are not accessible and do not display in the Switcher bar. If you want to make these applications available to your users, follow these steps:

1. Exit the Managed Client. 2. Log on to a Workplace server as an administrator. 3. Click Administration at the top of the page. 4. Click the "Portal User Interface" tab. 5. Click "Manage Pages." 6. Scroll the list of pages and select "WorkplaceRCPPages." 7. In the list of pages, select "Web Conferences". 8. Click the edit icon. (A popup displays "Edit Page Properties" when you hover over this icon.) 9. Click the + to show the Advanced options. 10. Check "rcpml" in the section entitled "This page supports (at least one must be selected)." 11. Click OK button to save changes. 12. To display Learning in the Switcher bar, select "Learning" in Step 7 and then repeat steps 8-11. 13. Relaunch Managed Client.

Note that when you click Web conferences in the Switcher bar, the Web conference opens in a separate (external) browser window. If you close this browser window, click Launch in the Managed Client to re-open the Web conferences list. Learning also opens in a separate browser window when launched from the Switcher bar. Both applications will launch using your default web browser (Internet Explorer or Mozilla). Firefox is not supported at this time in this manner.

WEDM provisioning will not work in an SSL environment If your provisioning environment is configured to use SSL and WEDM, provisioning will not work. If you choose to use WEDM provisioning, you cannot use an SSL configuration.

When focus is on top-level menu, Ctrl-F7 does not work Normally, Ctrl-F7 will bring up the perspective switcher context menu, which allows the user to switch between active perspectives in the WMC.

However, when focus is on the top-level menus in the WMC, hitting Ctrl-F7 has no effect.

WMC Junk Mail still functions after being disabled on server If the Junk Mail filter is disabled in the Admin Console (Mail Cell-Wide Settings), the Workplace Managed Client will still display the Junk Mail folder and action bar buttons. Users can still move messages into the Junk Mail folder, however this will no longer register a 'vote' with the Learning Spam Filter on the server.

In the future, the Workplace Managed Client will not display the Junk Mail folder or action bar buttons if Junk Mail filtering is disabled on the server.

161

IBM Workplace Collaboration Services 2.6.1 Release Notes

Workplace Managed Client not functional during update The Workplace Managed Client periodically checks the provisioning server for updates. If it finds updates, it prompts the user to accept the updates. If the user clicks Yes, the client will not be usable until the update process has completed. This is expected behavior, however the update process should warn the user they will be unable to use the client during the update and that they, for example, should log out of Instant Messaging during client update.

"N-way" chat action menu issue For a "n-way" chat, a chat partner can not be added to the Instant Messaging Contact list. For example, clicking 'Invite others', and selecting another user to bring up a "n-way" chat, then selecting that other user and choosing Actions ->Chat Partners -> Add to My Contacts does not work.

<Esc> is not closing the window tab in Notes plug -inWhen you open a bookmark by double-clicking a link in the Notes Applications bookmarks pane (e.g., Mail), and then immediately open another link by double-clicking a link in the Notes Applicationsbookmarks pane (e.g., Calendar), using the <Esc> key closes the current window tab, but using <Esc> again does not close the other window tab.

Workaround Click the "X" in the corner of the window tab to close the window or click anywhere in the window to give it focus, then press <Esc> to close the window.

IBM Workplace Messaging issues

Address book cache issues z If you create a new contact in your address book, use Directory Search,

and select someone that's already in your address book, an error occurs. z If you try to save a contact with an e-mail address that is the same as an

existing contact's address, the save fails and an empty contact is created instead.

z If you delete a contact from a group, the contact may not appear to be deleted immediately. If you close and reopen the group, the contact will be deleted.

z Due to an address book cache problem, saving a contact may result in missing information. Disable the cache by adding the setting people.PAB.cache.enabled=false to the workplace.properties file, saving the file, and restarting the Workplace server.

Bad forwarding addresses will cause mail not to be forwardedForwarding is effectively disabled for a user if the forwarding address contains a non-RFC822 compliantmail address or if it is a local address which can't be found in the organizational directory. In either case,these errors are logged.

162

IBM Workplace Collaboration Services 2.6.1 Release Notes

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 z Incorrect server time causes calendar entry rendering problems. Make sure the time of the server's

clock is set correctly to avoid potential problems. z 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. z 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.

ConnectionIOTimeout may need to be tuned for the network If the SystemOut.log contains error messages like the following, then the ConnectionIOTimeout needs to be tuned for the network. The default value is 5 seconds but values from 10-60 seconds are considered reasonable. See http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/x run_transport.html on how to set the value.

[2/16/05 13:01:49:514 GMT] 8b471dd SRTServletReq E SRVE0120E: IO Error java.io.InterruptedIOException: Read timed out

at java.net.SocketInputStream.socketRead(Native Method)

Code))at java.net.SocketInputStream.read(SocketInputStream.java(Compiled

at com.ibm.ws.io.Stream.read(Stream.java(Compiled Code)) at com.ibm.ws.io.ReadStream.read(ReadStream.java(Compiled Code)) at

com.ibm.ws.http.ContentLengthInputStream.read(ContentLengthInputStream.java(Co mpiled Code))

at com.ibm.ws.io.ReadStream.read(ReadStream.java(Compiled Code))at

com.ibm.ws.webcontainer.http.HttpConnection.read(HttpConnection.java(Compiled Code))

at com.ibm.ws.webcontainer.srp.SRPConnection.read(SRPConnection.java(Compiled Code))

at com.ibm.ws.webcontainer.srt.SRTInputStream.read(SRTInputStream.java(Compiled Code))

at com.ibm.ws.webcontainer.srt.http.HttpInputStream.read(HttpInputStream.java(Com piled Code))

at java.io.InputStream.read(InputStream.java(Inlined Compiled Code))at

com.ibm.ws.webcontainer.srt.SRTServletRequest.finish(SRTServletRequest.java(Co mpiled Code))

at

163

IBM Workplace Collaboration Services 2.6.1 Release Notes

com.ibm.ws.webcontainer.srt.SRTConnectionContext.finishConnection(SRTConnectio nContext.java(Compiled Code))

at com.ibm.ws.webcontainer.srt.WebAppInvoker.doForward(WebAppInvoker.java(Compile d Code))

at com.ibm.ws.webcontainer.srt.WebAppInvoker.handleInvocationHook(WebAppInvoker.j ava(Compiled Code))

at com.ibm.ws.webcontainer.cache.invocation.CachedInvocation.handleInvocation(Cac hedInvocation.java(Compiled Code))

at com.ibm.ws.webcontainer.srp.ServletRequestProcessor.dispatchByURI(ServletReque stProcessor.java(Compiled Code))

at com.ibm.ws.webcontainer.oselistener.OSEListenerDispatcher.service(OSEListener. java(Compiled Code))

at com.ibm.ws.webcontainer.http.HttpConnection.handleRequest(HttpConnection.java( Compiled Code))

at com.ibm.ws.http.HttpConnection.readAndHandleRequest(HttpConnection.java(Compil ed Code))

Code))at com.ibm.ws.http.HttpConnection.run(HttpConnection.java(Compiled

at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java(Compiled Code))

Folder created on back end won't show up immediately in UIA 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 theback end to appear in the front end user interface.

How to correct a 'bad mail domain' errorUsers are allowed to enter their own mail addresses on the Workplace Sign Up page. If they add anincorrect mail domain to this address, accessing the Mail or Calendar portlets will result in an error pagestating "user does not have a local mail domain". To correct this situation, user should

z Click 'Edit My Profile' in the upper right-hand menu z Fix the mail address with correct domain z Click Continue till user ends up back in the error page z Then LOGOUT

Subsequent login will register the correct mail address.

164

IBM Workplace Collaboration Services 2.6.1 Release Notes

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. When accounts are exported and contain calendar entries that have multi-line descriptions, the calendar information in the exported zip file cannot be imported. This will result in all the other account information being correctly imported, but no calendar information will be imported.

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.

lmadmin Import command doesn't preserve case of Folders When the lmadmin "Import" command restores folders, it does not preserve the original case of the folder name, but instead creates a folder with all lower-case letters in the name. The user can rename this folder with upper-case characters, but cannot use the identical name, i.e., 'test' cannot be renamed to 'Test', but can be renamed to 'Test1'.

lmadmin <infile> and <outfile> tags By default, the lmadmin code should be looking for the files specified with the <infile> tag, in the /WorkplaceServer subdirectory. However, lmadmin is looking for the file in the /AppServer directory. The same is true with the <outfile> tag that is used with some lmadmin commands. The files generated by the command are being created in the /AppServer subdirectory.

For example:

lm createaccount -user <infile -f abc.txt>

lmadmin will look for the abc.txt file in the /AppServer directory, when it should be looking for it in the /WorkplaceServer directory.

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.

165

IBM Workplace Collaboration Services 2.6.1 Release Notes

Mail issues z 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.

z 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.

z 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.

z 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.

z For those who use both the Managed Client and the portal client for IBM Workplace Messaging, if you use the Managed Client offline and create mail folders, use the Managed 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.

z 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.

z The order that recipients are entered in the To, cc, or bcc fields of a message may be changed when the message is sent.

z If you use Mozilla or Firefox, right-clicking an attachment and selecting Save Link As causes an error.

Managed Client does not handle signed and encrypted messagesThere are two ways to sign a mail message:

z Append the digital signature as an attachment z 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 beencoded. When this happens, mail content is unreadable by the recipient.

Managed Client status displayed using Sametime in Notes pluginWhen using the Notes plugin and Sametime, you still may see the IBM Workplace Managed Client IMstatus for the authenticated Managed Client IM user.

Workaround Maximize the Notes plugin and the IBM Workplace Managed Client IM status icon and message text is no longer displayed.

166

IBM Workplace Collaboration Services 2.6.1 Release Notes

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 thefollowing 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 Managed 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.

Meeting issuesFollowing are the issues with meetings in WCS 2.6:

z 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.

z 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.

z If you create a meeting on a team calendar and then try to edit the meeting from your personal calendar, a message indicates that you cannot edit the meeting because you're not the chair. This is incorrect; to edit the meeting, open it from the team calendar instead.

Message attachment issues z You cannot open an attachment with a space in its file name. z Using Internet Explorer, you cannot view an attachment with a DBCS file name.

167

IBM Workplace Collaboration Services 2.6.1 Release Notes

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.This issue only affects external addresses included in a local mail list group

No localization support for Lmadmin commands Lmadmin scripting commands are in English only.

Provisioning a user when sending a mail message Sending mail to a messaging user that has not been provisioned can have inconsistent results when simultaneous messages are sent to the same user. If UserA and UserB both send a mail message to UserC (who is not provisioned in the system) at the same time, one of the messages may get lost. UserC will be provisioned however, and the sending User will get a Mail Message rejected notice.

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.

Same mail address for a person and a group The system currently doesn't detect if a person and a group have the same mail address. In such a case, the mail will be delivered to the person. It is expected that the LDAP administrator will ensure that mail addresses are unique.

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.

168

IBM Workplace Collaboration Services 2.6.1 Release Notes

Some Lmadmin commands do not work with Cloudscape and port 8882 The following Lmadmin commands do not work on port 8882 (Mail_Server_1) when using Cloudscape as the RDMS.

z ListAccounts z CreateAccount z DeleteAccount z UpdateAccount z Export/Import z Restore z Migrate

Use port 8881 (Portal_Server) for to run account-related commands. For all other Lmadmin commands, use port 8882.

Spell checker issues z In this release, the cancel function is not available from the spell checker dialog boxes. z 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.

z 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.

Toggling Hide Folders/Show Folders may alter folder expand stateClicking on the Hide Folders or Show Folders link may alter the expanded/collapsed state of nestedpersonal folders in the folder list area. To avoid this problem, click on a folder name to open that folderafter the expand/collapse state has been established, rather than before.

Treated as Managed Client user when using IM in Notes plugin In the Notes plugin, if an end-user is utilizing the Workplace Instant Messaging offering (as opposed to Notes Sametime), Name Awareness in views and documents uses the IBM Workplace Managed Client end-user authentication information and not the Lotus Notes authentication information. For example, if you log into the IBM Workpalce Managed Client as user1, that maps to an internet name of user1@domain.com. However, when you start the Notes plugin, you are prompted for you Notes authentication information (e.g., notesuser1/organization). All instant messaging functionality in the Notes plugin is done as user1@domain.com.

If you were using Sametime, when you logged into the Notes plugin you would be treated asnotesuser1/organization for Sametime instant messaging.

169

IBM Workplace Collaboration Services 2.6.1 Release Notes

Update the SMTP greeting Please update the SMTP greeting in the WebSphere Administrative Console. The greeting "Lotus Workplace Messaging" should be changed to "IBM Workplace Messaging".

1. In the IBM WebSphere Administrative Console, click IBM Workplace software > Mail Cell -Wide Settings.

2. Under Additional Properties, click SMTP Inbound. 3. Change the SMTP greeting to IBM Workplace Messaging. 4. Click OK, then Save, and Save again. 5. If you have a single-server deployment, restart Mail_Server_1. 6. If you have a clustered environment, wait a few minutes for the configuration change to propagate to

all mail servers, and then restart all mail servers.

IBM Workplace Team Collaboration issues

Administrator always appears online in Instant Contacts portlet An administrator's online status may not function correctly in the Instant Contacts portlet. Specifically, the administrator may appear to be online in the portlet contact list when the administrator is offline.

Note also that an internal component of the Workplace Collaboration Services server logs in using the name "wpsadmin." End users may see the name wpsadmin displayed in the Instant Contacts portlet even though this name does not represent an end user.

Do not assign the name wpsadmin to any end user or administrator who will access the WCS server.

Alert window persistently occurs when viewing archives In Chat Room, when you try to view a deleted archive, the following alert displays as expected, "The selected archive has been deleted by the moderator." However, if you try to view subsequent archives that have not been deleted, the same alert redisplays in error. Ignore the subsequent appearances of the alert.

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.

170

IBM Workplace Collaboration Services 2.6.1 Release Notes

Auto-away not functioning When accessing Workplace via a browser, the Auto-away functionality does not work. Users will not go into an "Away" state after a set period of time.

Cannot create a forum in a new Discussion Forum portletIf you try to drag and drop a Discussion Forum portlet from the Add Content list to an existing page in aTeam Project, the portlet is added but you cannot create a forum in the portlet.

WorkaroundIf you create a new page and then add the Discussion Forum portlet either from the Add Content list or byusing Add Portlet, you can create forums in the portlet.

Chat feature generates error messagesThe Chat feature will generate several errors when sending messages. For example, select a user fromthe Contact List and right-click to start a chat. Enter text, and Send will cause a "Send Message Failed" error most times.

Collation sequence incorrect for discussions on SQL ServerThe collation sequence is incorrect for discussion threads on SQL Server. When the threads are sorted,the sequence is B b C c D d instead of B C D b c d.

To resolve this problem, the database administrator should set the collation sequence manually in theSQL Server console. For detailed instructions, see Technote #1225078 "Collation sequence incorrect fordiscussion threads on SQL Server" on the Web at www.ibm.com/support.

Contributor has moderator access if a member of moderator groupIf a contributor of a team space, discussion application, document library or web conference is also amember 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 amember of an invited contributor group, the moderator will show as a moderator in the membership UIand will also have moderator privileges as expected.

WorkaroundThere 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.

171

IBM Workplace Collaboration Services 2.6.1 Release Notes

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=YESdb2set DB2_INLIST_TO_NLJN=YESdb2 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 onthe 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.

Domino Applications configured with remote HTTP do not open Log in to a site configured with a remote HTTP Server such as Microsoft's Internet Information Server (IIS). Create an Application using the Domino Application Access template (Click Team Collaboration --> Application -> New). Select the Domino Application Access template and set the component properties according to the procedure described in the IBM Workplace Collaboration Services Information Center, the topic "Configuring Domino Application Portlet")

When you try to open the Domino Application portlet, you receive the error message:

Exception: Java.lang .NullPointerException

This situation does not occur with any other HTTP Server, for example, IHS or SunOne.

Workaround Add the host server machine name and its IP address to the Host file: For example, if you are running WindowsXP, open C:\WINDOWS\system32\drivers\etc\hosts in a text editor and add an entry for the host server.

172

IBM Workplace Collaboration Services 2.6.1 Release Notes

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.

In Discussion, no visual indicator for more than 30 results When you perform a search in Discussion, no visual indicator displays if the number of results found is more than the number of results returned. For example, by default the maximum number of search results returned is 30. If your search found more than 30 results, there is no way for you to know this.

Instant Messaging - Chat isn't sent even after server re -started This problem is evident in a cluster (ND) environment. If User1's node in the cluster goes down and is restarted during an active chat session, after User1 refreshes his/her browser, User2 (who is logged onto another node) will still not be able to successfully send messages to User 1 from his/her existing chat window. However, User1 is able to send messages to User2 from User1's existing chat window. To continue with the chat, User2 must close his/her old chat window and open a new one.

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

173

IBM Workplace Collaboration Services 2.6.1 Release Notes

Instant Messaging - On-line tag may show disconnectedIf a user has an open IM window, and tries to refresh the main Workplace page (by going to a differenttab, 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.

Instant messaging unavailable in client when nodes are restarted The Workplace Managed Client includes a "Reconnect to instant messaging" user interface option (in the upper-right corner of the client). An end user clicks this option to re-establish an instant messaging connection (or SIP connection) if the client loses instant messaging connectivity for any reason.

When multiple Workplace Collaboration Services (WCS) 2.6 servers operate in a network deployment (ND), a problem occurs where clicking the "Reconnect to instant messaging" option does not re-establish the instant messaging connection. This problem occurs when nodes in the network deployment are stopped and restarted while an instant messaging session is active.

The example below illustrates this problem.

In this example, assume the following:

z Two WCS 2.6 servers operate in a network deployment.

z Four Workplace Managed Client users are currently engaged in a single multi-user chat session.

z If the administrator stops and restarts both of the WCS 2.6 nodes, all four users are disconnected from the chat session.

z After the administrator restarts both of the WCS 2.6 nodes, the users can click the "Reconnect to instant messaging" option in the managed client but the client cannot re-establish the connection.

z To re-establish the instant messaging connection, each of the four users must close the current instance of the managed client and then open a new instance of the client.

The only workaround for this problem is for the end user to close the current instance of the rich client and then open a new rich client.

Newly invited group member cannot access an applicationA newly-added member of an LDAP group, who has been invited to a collaborative application, cannotaccess the application because it does not show up in the catalog.

WorkaroundSign out of Workplace and try again once the user cache has expired (approximately two hours).

174

IBM Workplace Collaboration Services 2.6.1 Release Notes

No notification given when instant messaging is unavailableIf the Workplace Collaboration Services server is down, or a configuration problem exists, the WorkplaceManaged Client will not be able to connect to the SIP Services to provide users with instant messagingand presence capabilities.

In this scenario, either of the following can occur:

z The client does not go online and up to five minutes may pass before there is any indication of a connectivity problem.

z The client user interface may lock up.

Online status issues when an LTPA token expiresIf a user is online and the user's LTPA token expires, the user's online status may not be accuratelyreflected in the contact lists of other users.

To illustrate this issue, consider the following scenario:

1. User 1 logs in to a portlet that supports presence and instant messaging. 2. User 1 appears online and available in the contact list of User 2. 3. User 1's LTPA token expires. 4. User 1 refreshes the browser or starts a new browser session to receive a new LTPA token.

Following this sequence of events, User 1 may continue to appear online and available in the contact listof User 2 even after User 1 has:

z Changed to a new online status, such as "Do Not Disturb" or "I Am Away." z Logged out of the instant messaging portlet.

WorkaroundYou can minimize this problem by ensuring that the LTPA token expires value is longer than the Portalsession timeout value.

By default, the LTPA token expires value is set to 120 minutes and the Portal session timeout value is set to 30 minutes. The Portal session timeout value resets itself each time the portal is accessed, but the LTPA token value does not reset. If you use the default values, a situation occurs where the LTPA token can expire if a user works continuously in the portal for 120 minutes. You may want to increase the LTPA token expiration value to enable users to work in the portal for a longer period of time before the LTPA token expires.

Systemout.log reports SIP connection fails on nodeWhen WCS servers are installed in a network deployment, the systemout.log on one of the nodes in thenetwork deployment may report an "Error on server connection" message for the address and port usedfor TCP connections to the SIP proxy.

Although the systemout.log reports a SIP connectivity problem, all instant messaging and presencefunctionality continues to operate normally.

175

IBM Workplace Collaboration Services 2.6.1 Release Notes

This problem occurs because the WCS network deployment process has caused the creation of an additional WebSphere Portal server on the node. If you open the WebSphere Administrative Console, and select Servers -> Application Servers, you should see the following two WebSphere Portal entries:

z WebSphere_Portal z WebSphere_Portal2

To prevent this SIP connectivity error from recurring, follow the instructions below to disable the SIP Container on the WebSphere_Portal server by setting its Initial State to Stopped. Leave the SIP Container enabled on WebSphere_Portal2.

1. Open the WebSphere Administrative Console. 2. Click Servers > Application Servers. 3. From the list of application servers, click WebSphere_Portal. 4. In the Additional Properties table, click SIP Container. 5. In the Initial state field, select Stopped to ensure that the SIP container is stopped, and then click

Apply or OK. 6. Save the configuration.

Team Space Search index gets deleted on first restart of serverThe Team Space Search index is deleted the first time the server is restarted.

WorkaroundAdd more content to the Team Task List, and the index will be recreated on the next indexing cycle;Search will then again return results.

UNIX - PowerPoint files not displaying in DocumentsAccessing a Unix 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 thefirst 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.

WorkaroundYou must start the Portal Server on a server that is running XWindows with the appropriate packageinstalled.

Weekdays appear in a daily archive schedule of Chat RoomIn Chat Room, when you attempt to schedule a daily archive, the interface lets you select the days of theweek you want the archive to run. Since you want the archive to run daily, you shouldn't have to selectthe days of the week.

176

IBM Workplace Collaboration Services 2.6.1 Release Notes

IBM Workplace Designer issues

Background/Border not showing for check box and radio button The background color and border is not displaying for checkboxes and radio buttons in Mozilla and Firefox. This can be considered a third-party defect:

https://bugzilla.mozilla.org/show_bug.cgi?id=183247.https://bugzilla.mozilla.org/show_bug.cgi?id=150176

Cannot copy and paste a view control In the current release, you cannot copy and then paste a view control either on the same form or onto a different form.

Cannot create schemas with multiple root elements Designer does not handle schemas with multiple root elements properly.

Cannot delete a control just dragged to the form After dragging a control from the Control Palette area to the form, the Palette will retain focus. To give keyboard focus to the form, either click in the form or on the form's table; you will be able to delete the control you just created.

An alternate way to create controls using the palette, that does not leave focus in the palette, is to click on the control you wish to create, and then click on the form where you wish to put the control.

Cannot import a Domino database with non -ASCII chars Domino databases containing non-ASCII characters cannot be imported. Rename the Domino database .nsf file to some other name, and then import the database.

Component fails to run when running on a Linux /DB2 server When running a component on a Linux Workplace Server with a DB2 database, you may encounter an error that looks like this:

IBM Workplace Designer Runtime Error

com.ibm.workplace.designer.docdb.TDBException : Document id '3f7dbac2f4ee3' does not exist in database 'ProjectManager_pop'

177

IBM Workplace Collaboration Services 2.6.1 Release Notes

Java runtime exceptionXSP Page name : DepartmentProjectStatusHTML Tag ID : XSP_7_0_12L_XSPPageContainer0XSP Bean : com.ibm.workplace.designer.xsp.components.XSPBeanXmlDocument/documentXSP Event : com.ibm.workplace.designer.xsp.event.MainHtmlEvent

This may be due to a missing DB2 JAR file (db2jcc.jar). To correct the problem, do the following:

z Log into the WAS admin console

z Navigate to Servers->Application Servers->WebSphere_Portal->Process Definition->Java Virtual Machine You should see a Classpath property that already contains a path to db2java.zip. Add an entry for db2jcc.jar in the same directory as db2java.zip

z Restart the server

DB2: Deleting many designer documents failsDeleting a large number of documents can fail if the DB2 transaction log is full. The error will looksomething like this:

Exception while while calling method DBDatabase.removeAllDocuments()Error while removing all documents from database 'WorkloadTestRig'

The transaction log for the database is full. SQLSTATE=57011

This can be resolved by increasing the size of the DB2 transaction log using the following:

z DB2 connect to <database> user <username> using <password> z DB2 update db cfg for <schema_name> using LOGFILSIZ <new_log_file_size>

Deleting a component does not always remove it from Comp NavSometimes when you delete a component, the component will not be removed from the ComponentNavigator. This is an intermittent problem.

To work around this issue, restart Designer, at which time the deleted component no longer appears inthe Component Navigator.

Deployment error message is too general when bad username When there is an authentication error during deployment (e.g., caused by a bad Workplace username), a generic error message is displayed requesting that the user see the error logs for details; this error message will be made more specific in a later release.

To determine whether the error is caused by a bad username, please look in the error log for the serverresponse text (in XML format) which describes the deployment error.

178

IBM Workplace Collaboration Services 2.6.1 Release Notes

Designer Runtime install UI does not default to WSE With WSE installed, starting the Designer Runtime install UI, the field "Installation location of IBM Workplace Collaboration Services Server" does not default to the actual installation location of 'WorkplaceServicesExpress'.

Workaround Manually enter the WSE installed location in the above field.

Designer Table added to a form does not display A table on its own is just a layout, and does not have any visible areas. If there is no border set on the table, or if there are no controls put inside the table, it would not be displayed in deployed applications.

Workaround Set the border on the table, or put controls in the table cells.

Discussion Sample App: Author field on Response doesn't change When filling out a Response document to a topic in the discussion database, the Author field may not get appropriately set.

Discussion Sample App: Large file attachment error Based on the way the web server is configured, users may experience errors when uploading very large files using the File Upload control.

Don't place two instances of the same component on the same page Two instances of the same Designer component placed on the same page will cause navigation problems when editing or viewing documents.

Edit box needs binding for default value to work Default value for an edit box is not working when the edit box is not bound to a schema field; a schema field is required for this to work.

Error and Parameters tabs persist when the component is deleted This problem comes from the interaction between component navigator selection and the sticky tabs. The workaround when other components are in the navigator is to select one of the remaining components, and the error/parameters tab will refresh. If there are no components left, then the only way to refresh the sticky tabs is to disable and then re-enable them through Preferences.

179

IBM Workplace Collaboration Services 2.6.1 Release Notes

Fonts set in Designer are not seen in the deployed apps If any font set for any control in Designer is not available in the Client machine where the Portlet page is seen, then the target browser (Client browser) will subsititute its own default font.

Help file: Tutorial navigation script is incorrect There is an error in the Tutorial section of the IBM Workplace Designer Reference help. The tutorial is intended to show the development of the ProjectManager sample application. The script provided in the tutorial topic Creating a script library and navigation does not accurately represent the ProjectManager sample application. For the correct script, open the NavigationScripts script library in the actual ProjectManager sample application.

Help link to Applications Development goes to Toolkits page The Applications Development page the Help was linking to has been removed from the developerWorks web site. The page that now comes up (Toolkits) is not entirely inappropriate.

Importing the sample applications There are no instructions for how to import the sample applications into Workplace Designer.

Workaround Perform the following steps to import the sample applications into Workplace Designer: 1. Click File > Import > Component. 2. In the Import Workplace Component dialog box, click Browse. 3. Navigate to one of the following directories: z [WMCInstallDir]\applications\eclipse\plugins\com.ibm.workplace.designer.sampleApps_1.0.0\sam

pleApps (Microsoft® Windows®) z [WMCInstallDir]/applications/eclipse/plugins/com.ibm.workplace.designer.sampleApps_1.0.0/sam

pleApps (Linux™). Note: [WMCInstallDir] is the directory where the IBM Workplace Managed Client is installed.

4. Select one of the following .JAR files, and then click Open. ProjectManager.jar DiscussionDatabase.jar ContactList.jar Blog.jar

5. Click OK.

Incorrect values for cell and node displayed during installDuring install, the user is asked to provide the cell and node names. Typically, these are just thehostname of the computer. However, these values default to the fully-qualfied hostname (e.g., hostsystem.ibm.com) when the value should actually be the hostname excluding the domain (e.g., hostsystem).

180

IBM Workplace Collaboration Services 2.6.1 Release Notes

Install produces "Invalid Directory" error in Rich Client path If you encounter this "Invalid Directory" error, specify the root directory name of IBM Workplace Rich Client

Installer reports success, but logs indicate failures If you are seeing failures indicated in your log files after the installer has reported a successful installation, please look at the InstallLog[1-5].txt and InstallErr[1-5].txt files in the Designer directory. If you don't see "Application LWP_Designer_Runtime installed successfully" at the end of InstallLog5.txt, it means that deployment of the Designer .ear file has failed. Manual deployment may be necessary

Link Control in runtime gives error when URL option is selected If the link control references is a website link (URL), then the standard, accepted way for entering the URL is of the format http:// or ftp://. Also, if the referenced file exists in the workspace, the absolute or relative location of the file can be entered.

Linux: "Select a directory" dialog in install does not work When using an InstallShield implementation, to select /opt/WebSphere, you need to open the /opt directory, select WebSphere, and click Open.

If you open /opt/WebSphere, and enter "WebSphere" in the filename field, the InstallShield mistakenly believes you have entered "/opt/WebSphere/WebSphere", which does not exist.

Mozilla: Borders not displayed for Rich Text in deployed apps In deployed applications, borders are not appearing properly at Runtime for Rich Text Control, in Mozilla and FireFox; in Internet Explorer, they are displayed properly.

Workaround In Workplace Designer, set the height of the Rich Text control to be equal to or greater than 220px.

No properties available after creating a new control When a new control is dragged-and-dropped onto a form, the Properties panel will display "No properties available." This is because the Controls palette still has focus. To view the properties of the control, click on the control or the window tab of the form, which will give the form focus.

This problem only occurs when you drag and drop a control on the form, not when you click the control in the palette, and then click on the form to create the control.

181

IBM Workplace Collaboration Services 2.6.1 Release Notes

Proj Mgr Sample App- Delete buttons do not give a warning dialog This issue applies to the Project Information/Project Edit page. When a user selects the checkbox next to the issue, and clicks the Delete Issue button, they may not receive a confirmation dialog.

Project Mgr Sample App: Intermittent runtime error If a large component is imported and immediately deployed, a runtime error may occur. To workaround this problem, the importer should wait briefly for some Designer runtime import mechanisms to complete their cycles.

Project Mgr Sample App: Typo in the isForTesting field When users answer "Yes" to the 'Application Is For Testing' query on instantiation of the Project Manager application, the resulting document autogeneration dialog prompt may refer to generating contacts instead of generating projects and issues.

Radio button without schema gives error in runtime Placing a radio button on a form without associating the radio button with a schema element gives an error at runtime.

Workaround Define a schema element for that radio button.

Sample-Blog-Admin role has Author role access instead of Editor Users set up with Administrator rights instead of Author rights in a template or application which includes the Blog sample application may find their privileges restricted to Author access. Users with Author access are unable to edit blog properties or post new blog entries.

Script editor doesn't open via Error tab Double-clicking an error on the Error tab for a form property script does not open the script editor where the error is located.

Script errors don't show in Error tab Errors for scripts entered on the Data tab for Forms do not show up on the Error tab.

182

IBM Workplace Collaboration Services 2.6.1 Release Notes

Scripting not being deployed If your scripts are not being deployed to your server and your System.err file (located in your runtime workspace) is showing the following exception:

java.lang.ClassCastException: com.ibm.workplace.des.formtools.ui.table.LWPTableControl

at com.ibm.workplace.des.formtools.ui.panel.XSPControlRuntimeFormatter.contribute ToRuntimeFormattingSession(XSPControlRuntimeFormatter.java:60)

at com.ibm.workplace.des.ide.model.ide.provider.IControlModelItemProvider.contrib uteToRuntimeFormattingSession(IControlModelItemProvider.java:1058)

at com.ibm.workplace.des.ide.model.ide.provider.IContainerControlModelItemProvide r.contributeToRuntimeFormattingSession(IContainerControlModelItemProvider.java :340)

at com.ibm.workplace.des.formtools.ui.form.layout.provider.ITableModelItemProvide r.contributeToRuntimeFormattingSession(ITableModelItemProvider.java:488)

at com.ibm.workplace.des.ide.core.rtformat.BaseRuntimeFormattingSession.processMo delPart(BaseRuntimeFormattingSession.java(Compiled Code))

at com.ibm.workplace.des.ide.core.rtformat.BaseRuntimeFormattingSession.processMo delPartList(BaseRuntimeFormattingSession.java(Compiled Code))

at com.ibm.workplace.des.formtools.ui.form.layout.provider.IFormModelItemProvider .contributeXSPToRuntimeFormattingSession(IFormModelItemProvider.java:1092)

at com.ibm.workplace.des.formtools.ui.form.layout.provider.IFormModelItemProvider .contributeToRuntimeFormattingSession(IFormModelItemProvider.java:884)

at com.ibm.workplace.des.ide.core.rtformat.BaseRuntimeFormattingSession.processMo delPart(BaseRuntimeFormattingSession.java(Compiled Code))

at com.ibm.workplace.des.ide.core.rtformat.BaseRuntimeFormatter.createRuntimeForm at(BaseRuntimeFormatter.java:190)

at com.ibm.workplace.des.ide.model.design.PersistedEMFMediator.doSave(PersistedEM FMediator.java:321)

at com.ibm.workplace.des.formtools.ui.form.design.FormPersistedMediator.doSave(Fo rmPersistedMediator.java:177)

at com.ibm.workplace.des.ide.model.design.DesignTimeModelController.buildModelIns tance(DesignTimeModelController.java:211)

at com.ibm.workplace.des.ide.core.resources.LWPDBuilder.buildFiles(LWPDBuilder.ja va:152)

at com.ibm.workplace.des.ide.core.resources.LWPDBuilder.fullBuild(LWPDBuilder.jav a:102)

at com.ibm.workplace.des.ide.core.resources.LWPDBuilder.build(LWPDBuilder.java:76 )

at org.eclipse.core.internal.events.BuildManager$2.run(BuildManager.java:564)

183

IBM Workplace Collaboration Services 2.6.1 Release Notes

at org.eclipse.core.internal.runtime.InternalPlatform.run(InternalPlatform.java(I nlined Compiled Code))

at org.eclipse.core.runtime.Platform.run(Platform.java(Compiled Code)) at

org.eclipse.core.internal.events.BuildManager.basicBuild(BuildManager.java:157)

at org.eclipse.core.internal.events.BuildManager.basicBuild(BuildManager.java:249 )

at org.eclipse.core.internal.events.BuildManager.basicBuild(BuildManager.java:202)

at org.eclipse.core.internal.events.BuildManager$1.run(BuildManager.java:229)

at org.eclipse.core.internal.runtime.InternalPlatform.run(InternalPlatform.java(I nlined Compiled Code))

at org.eclipse.core.runtime.Platform.run(Platform.java(Compiled Code)) at

org.eclipse.core.internal.events.BuildManager.basicBuild(BuildManager.java:232 )

at org.eclipse.core.internal.events.BuildManager.basicBuildLoop(BuildManager.java :268)

at org.eclipse.core.internal.events.BuildManager.build(BuildManager.java:297)

at org.eclipse.core.internal.events.AutoBuildJob.doBuild(AutoBuildJob.java:155)

at org.eclipse.core.internal.events.AutoBuildJob.run(AutoBuildJob.java:212)

at org.eclipse.core.internal.jobs.Worker.run(Worker.java:66)

then you have a corrupt cache registry file.

The path of this registry file, relative to the runtime workspace of the user, is ".config\org.eclipse.core.runtime\.registry.1". Renaming or deleting the cache registry file will solve the problem.

Space taken by invisible rows When you add Visible logic to a row in a table, the row data will be invisible, but the empty space will still be there in the table.

To simulate hiding the row, you can create multiple tables and add the row that needs to be hidden in a seperate table. You can then set the Visible attribute as 'False' on that table and on any paragraphs between these tables. This would make the extra space go away.

Style category missing in Format of Form and UI controls If any style category is missing in the list box of the Format tab for a control, check the selection of that particular style category in the Styles table shown in the Component format tab.

For example, click on the component name in the Component Navigator, then click on the Format tab; this tab allows the user to select which style categories should be shown for controls in this component.

184

IBM Workplace Collaboration Services 2.6.1 Release Notes

Switch Managed Client fails with invalid login From the Designer CD, the option "Switch to Managed Client" always fails after initially entering invalid login information. The user can cancel out of this without exiting Designer by going back to Help -> Switch to Managed Client again, and entering the correct information for a WCS server.

Type validation is not working in edit /multiline edit boxSetting a schema type on an edit or multi-line edit control is not generating a runtime error message whenan invalid type is entered into that control during runtime, and the subsequent submit event occurs.

Typing over highlighted form text does not remove the textThe normal behavior for a text editor is to delete highlighted text automatically when new typing occurs;the Form Editor, however, does not implement this behavior. The text needs to be deleted manually,using the delete key, before entering new text.

UI Control Styles preference settings are not appliedIn the Designer preferences (File -> Preferences), the UI Control Styles preferences (Workplace Designer-> Forms -> UI Control Styles) currently are not applied, and have no effect.

1. The UI Control type when dragging an element from the Data palette to a form is always determined bywhat is set as the default in the schema, and the option to prompt for the control type has no effect.

2. Selecting a default layout and style for form Controls currently has no effect. To set a layout and style for a Control, use the Format tab on the control Properties after placing a control on the form.

UNIX - libraries.xml is not modified in a cluster In UNIX installations, Java (JDK 1.3.1 and above) must be installed and included in the path.

Unwanted background color appears in FireFox When you create a form with a panel, then deploy the component, a background color appears in the panel when viewing with the FireFox browser.

View - Column - Lookup data is not working at runtimeUnder some circumstances, it may appear that using a view lookup for a column value does not work. This occurs when users do not have a sortable column in the view in which they are doing the lookup.

For example, if you are using a value in the current view to lookup a Zip Code field in a target view, thecolumn that contains the zip codes in the target view should be sortable so the lookup can succeed.

185

IBM Workplace Collaboration Services 2.6.1 Release Notes

vpd.properties file gets created when installing Designer The file vpd.properties gets created in a non-installation/non-workspace directory when installing Workplace Designer.

"All users" access in Roles is not honored When a Workplace Designer Built Collaborative Application is deployed to the Workplace Server, and after it is instantiated via Builder, then opened, the member page allows this selection: "Give All Users Access as: Contributor". This Public Access will not work; members of the Roles Contributor must be added individually.

"Invalid Server" error entering fully-qualified domain node name If you encounter this "invalid Server" error, find the correct cell and node names in the <WCS/WSE>/AppServer/config directory.

@DbLookup() function usage When using the @DbLookup function, the view needs to have at least one sorted column.

@Name() works in form; does not work in view column As database deployment is done from the client side, some scripts that are relying on the Workplace API (like the directory) may not work. This is typically the case of @Name() which may call the directory API for some advanced features ([CN], [S], [G], [C], [O], [OUn], [ABBREVIATE]).

IBM Workplace Forms issues

Back button fails from text attachment If you open a text file attachment from a form, the file displays in the form window. Using the browser's back button to return to the form results in a JavaScript error. Click OK until the error window stops reappearing.

Blank description field can result in data loss in form template If you remove the text from the Description field of a form template, changes you make subsequent to that will not be saved. The workaround is to leave text in the Description field. If you do not want the text to display in forms created from the template, uncheck the "Show description on main page" option.

186

IBM Workplace Collaboration Services 2.6.1 Release Notes

Chart design problem on Solaris If you are designing a form on a Solaris platform, and you create a view of the type Pie or Bar chart, the list that should display fields upon which you can base the chart is empty.

Considerations for access to form templates When you are designing a form template that might be deployed in an application, keep in mind that only users who are granted access to the form template will be able to use the resulting form in an application that includes the form template. The simplest way to make sure the form is available is to add All Authenticated Users to the Template User role for access to the Form Template. That is the default for the form templates that ship with the product.

Deleting field from a template makes form portlet unavailable If you delete a field from a form template, and then put the form portlet on a page, you might get a message that the form portlet needs to be configured before you can use it. This happens when the field you delete is the field used to create the view in the form portlet. For example, if you create a Custom form template, you will find that the only field supplied is the Name field. The Name field is required to build the default All Items view when you deploy that form template. If you delete the Name field and add another field, you must then go to the Views tab for the form template editor, and edit the All Items view so that is builds the view based on the new field rather than the deleted field.

Do not use design fields in form portlet views When you are designing a view, avoid using design fields, such as section headers or rich text design fields, as view columns. Using them might result in unexpected behavior, such as displaying raw HTML instead of formatted text.

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 now contains 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.

Form portlet not configurable while editing an App Template When you are creating or editing an application template and you are in the Pages and Layout editor, if you add a Form portlet to a template page, you will see the pencil icon display for the Forms portlet. If you click on this icon, it appears that you can set edit mode parameter values for the Form portlet, but these settings do not take effect and can cause unexpected results.

To work around this, first create your custom Form portlet using the Form Template Editor. Then add the new Form portlet to your Application Template. Do not try to edit the portlet while creating or editing an application template.

187

IBM Workplace Collaboration Services 2.6.1 Release Notes

Form templates not upgraded with 2.6 When you upgrade to IBM Workplace 2.6, form templates are not updated. You can use a batch file on the IBM WebSphere Portal server to import Workplace Collaboration Service 2.6 form templates into the Form Template Library.

1. On the IBM WebSphere Portal server, run the batch file/${WebSphere}/WorkplaceServer/bin/importFormTemplates.

2. Supply an absolute pathname that specifies the location of the template files you want to import. If a form template with the same name already exists, the utility will update that template with the new template xml. In this way, updated templates will retain all ACL settings. If you do not want an existing template overwritten, rename it before importing the newer version.

For example, importFormTemplates /myFolder/myForms will find form template xml files in /myFolder/myForms, and import them into the Forms Template Library. The default form templates that ship with the product are located in:

/<WAS_ROOT>/WorkplaceServer/forms/Forms

To import the latest out-of-box form templates, use the following command:

importFormTemplates /<WAS_ROOT>/WorkplaceServer/config/forms/Forms

Note: If changes to updated templates do not appear immediately, it may be due to a cached version of that template. Clear your cache and try again.

Launching a URL link from a form portlet loses Workplace window Clicking a link that is in a multi-line rich text field in a form document can result in the Workplace Collaboration Services window disappearing. You will have to use the back button to return to the state you were in before clicking the link.

Lock conflicts for form templates If you unlock a form template that someone else is editing, make changes to the template and save your changes, the changes are not applied to the form template. You do not receive an error message when this type of editing conflict occurs. You can try to avoid this conflict by asking the lock holder to release the lock on the form template before you make changes. In another type of conflict, if two editors are making changes to a form template and save changes at the same time, one editor will get an exception error. The other should be able to save successfully.

No notification if form portlet is uninstalled You can uninstall the form portlet, by going to the Administration tab and choosing Portlets -> Manage Applications and deleting formportlet.war from the Web modules list, The next time you launch the product and open the Form Template Library, the list of form templates displays, but clicking on any of them results in a blank display. You should be warned with an error message that the form portlet module has been uninstalled.

188

IBM Workplace Collaboration Services 2.6.1 Release Notes

Non-admin user unable to use Form portlet on private page A non-admin user will be unable to use a Form portlet on a private Portal page. The user will get the following error message: "This form portlet needs to be configured first before being used. " There is no edit icon available to do the required configuration.

Note that on a Workplace application page, even though the non-admin user will not be able to see the pencil icon to edit the portlet, he will be able to use the "Customize" menu item from the Actions menu.

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.

Requiring value for some selection fields can cause form to fail If you design a form template that uses a field with check boxes or radio buttons with a required value for the field, users will get a JavaScript message when trying to save a form based this form template. Use "Display choices as List box" instead of check boxes or radio buttons for this field.

Save As for Forms not working as expected When you are creating a new form template from an existing one and you click the Save As button, you should proceed to the form template editor so that you can complete the design work for the template. Instead, you are returned to the Form Template Library. The new form is created, and you can select the new form template to open it for editing. Note that clicking Cancel from the Save As dialog box also produces unexpected behavior. You should be returned to the template editor for the existing form template; instead, you are returned to the Form Template Library.

Searching a form's Author field may fail to return results Searching a form may fail to return results from the Author field.

Some form icons do not display in high contrast If you view a form portlet in high contrast for low-vision users, some icons, such as the icon for sorting forms, or the icons for changing a time setting do not display. The icons still work -- for example, clicking the space where the sort icon should display will sort the list of forms, but the icons remain invisible. Restoring the display to normal mode restores the display of the icons.

189

IBM Workplace Collaboration Services 2.6.1 Release Notes

IBM Workplace Templates and Applications issues

Adding 100 users to a template role can destabilize browser Adding a large number of individual user names to a template role can destabilize the browser session. You might get a "Page cannot be loaded message" and need to shut down and reopen the browser to resume. You might still experience instability when you return to the template. The workaround is to add the users in smaller numbers, use groups to add large numbers of users, or use the "Add All Authenticated Users" option if it is available through the user policy setting and if it is appropriate for the application template.

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.

Application templates not upgraded with Workplace 2.6 When you upgrade to IBM Workplace 2.6, the application templates are not upgraded. You can use a batch file on the IBM WebSphere Portal server to import new or updated application templates into the Application Template Library.

1. On the IBM WebSphere Portal server, run the batch file: /${WebSphere}/WorkplaceServer/bin/importFormTemplates.

2. Supply an absolute pathname that specifies the location of the template files you want to import. If an application template with the same name already exists, the utility will update that template with the new template xml. In this way, updated templates will retain all ACL settings. If you do not want an existing template overwritten, rename it before importing the newer version.

For example, importFormTemplates /myFolder/myForms will find application template xml files in /myFolder/myForms, parse them for their name, category and description values, and import them into the Application Template Library. The default application templates that ship with the products are located in:

/<WAS_ROOT>/WorkplaceServer/config/templates/<template categories>

For example, to import the Blank template in the default category, you would use the following command:

importAppTemplates /<WAS_ROOT>/WorkplaceServer/config/templates/default

Note: If changes to updated templates do not appear immediately, it may be due to a cached version of that template. Clear your cache and try again.

190

IBM Workplace Collaboration Services 2.6.1 Release Notes

Changing template or application owner requires updating roles Changing the owner of a template or an application requires explicit synchronization of role assignments. If you change the owner of an application or a template to a user who holds a non-manager role, the new template or application owner receives the manager access inherent in template and application ownership and appears in the list of roles that provide manager access (for example, Template Editor or application Moderator). However, the name of the new template or application owner will also still appear with his or her original non-manager role in the Template Roles portlet and in the application membership portlets (Members or Participants). The new template or application owner will also retain the permissions provided by both the old and the new role assignments.

To correct this discrepancy, you will need to remove the new template or application owner from the original non-manager role and add the new owner to the role that provides manager access. For a template, open the Template Roles portlet to remove the new template owner from the Template Users role and promote him or her to the Template Editor role. For an application, open the Members or Participants portlet to remove the new application owner from the original non-manager role (for example, Contributor, Employee, or Participant) and promote him or her to the respective manager role (for example, Moderator or Instructor).

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.

Deleting from one template role removes from all If a user is listed in both the Template User and Template Editor roles for access to an application template, deleting a user from one role automatically deletes from both. If you want the user name to appear in one role, but not another, delete the user name, removing it from both roles, then add it back to the correct list.

Do not use special characters in template name or category name If you are creating a new application template, or editing an existing one, avoid using these special characters in the name of the template or in the category name: \ / : * ? " < > | & =.

If you are editing an existing template or category name and you enter an illegal character, you may get an error message, but note that the error message does not list every illegal character. For example, the backslash, though not listed in the error message, is illegal.

If you are creating a template and create a new custom category name which includes one or more illegal characters, you will get an unrelated error message claiming the name is not unique. In another case, you may be able to create templates with an illegal character in the name, but you will not be able to delete the template. The workaround for all of these situations is to remove the illegal characters.

191

IBM Workplace Collaboration Services 2.6.1 Release Notes

Edited component properties are not immediately refreshedWhen you edit the component properties of an application using the application editor, the Propertiesportlet, you will not see the modified component properties until you log out of IBM WorkplaceCollaboration Services and log in again. Application parameters specified as editable componentproperties and the values of component properties that you edit are not refreshed in the current browsersession. For this reason, you need to close the current browser session for IBM Workplace CollaborationServices and open a new session to see application parameter and component property updates.

Misleading error message when importing a templateIf you try to import a template for which you have insufficient access, you will not be allowed to do so. The behavior is correct, but the error messages can be misleading, indicating the file is invalid.

Server failover cancels application creationIf you are creating an application and the server on which you are working fails over to another server inthe cluster, the new application is lost in the transfer. You might see a blank screen and then be unable tofind the new application. You can successfully create the new application on the new server after thefailover.

Template on Oracle db: Default description shows as "null"The text "null" appears in the description field when creating a new template in a configuration based onan Oracle database. The text can be edited and removed by the user.

Values specified for application parameters are not validatedWhen 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 newapplications from the template, they might encounter default values for component properties of theapplication that are not valid. If you discover errors in parameter values that you have specified in thetemplate editor, you will need to edit the parameter values to correct them.

When you create a custom category you must edit the user policyIf you create a new category for applications, the resulting application catalog gets the user policy AllowWorkplace Applications applied by default to any application in the catalog. All users with access to thecatalog will see the New button and be able to create new applications. If this policy is more permissivethan what you want, you must edit the policy to be more restrictive. For example:

1. From the Application Template Library create a new application template in a new category. 2. Login as an administrator and click on the Team Space tab. 3. In the Team Space Tab Click on the wrench . 4. Choose the New Category you created in Step 1. 5. Login to the Admin console and create a new user policy. 6. Add one or more users to the User Policy and uncheck the box for Create in the Allow Workplaceapplications to restrict them from creating applications.

Note that restrictions you make will also apply to application in the Applications catalog.

192

IBM Workplace Collaboration Services 2.6.1 Release Notes

IBM Workplace Web Conferences issues

Double-byte filenames fail when clicked to Download in Agenda There is a known issue with the IBM HTTP Server WebSphere Plug-in when it receives an HTTP request which is encoded with UTF-8 URL encoding. The plug-in will attempt to re-write the URL when it forwards the request to WebSphere and will not properly re-encode the URL. This results in the Web Conference ABFileServlet being unable to resolve the request for files having international characters in their filename.

There is an IBM HTTP Server Plug-in APAR # PK09023 available for the following releases:

WAS 5.0.2.13WAS 5.1.1.7WAS 6.0.2.1

You can get the latest plug-in from the following links:

http://www-1.ibm.com/support/docview.wss?uid=swg24007265http://www-1.ibm.com/support/docview.wss?uid=swg24007227http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24010719

Issues with installing Web Conference tools on Linux systemsThere are several issues associated with installing the Web Conference tools on Linux systems.

z The Linux installer places the libasnat.so library in the /usr/lib directory. If the LD_LIBRARY_PATH does not include the /usr/lib directory, the library file is not found and users do not see the floating toolbar in the Web Conference tools. To work around this issue, do one of the following:

- Set LD_LIBRARY_PATH to include the /usr/lib directory - After installing the tools, move libasnat.so to a directory specified by LD_LIBRARY_PATH

z A user must download the setuplinux.bin file from the server and then run the setuplinux.bin file to install the Web Conference tools. After the user downloads the setuplinux.bin file, the user must provide the file with execute permissions before running the file. To provide the file with execute permissions, run this command from the directory into which setuplinux.bin was downloaded:

chmod +x setuplinux.bin

After running this command from the download directory, the user can run the file to install the tools.

z You cannot install the Linux tools unless you are the root user. If you attempt to install the tools, and you are not the root user, the following error message appears:

"Error: /opt/ibm/Lotus Workplace Web Conference Tools is not writable."

193

IBM Workplace Collaboration Services 2.6.1 Release Notes

Session affinity: Creation may fail silently Using clustered Workplace servers, when a user is creating a Web Conference and the node they are attached to fails, the user will be redirected to the new server, but will be returned to the Web Conference creation page instead of receiving an error message or completing the creation. If the user then re-enters the information and submits, the Web Conference will be created successfully.

Web Conference Tools download affects multiple monitor display Most computers provide display modes that enable a user to connect a computer to external monitors and display images from the computer on multiple external monitors. (On some IBM laptops, these display modes are called "External Desktop" and "Dual Display".) Installing the Web Conference Tools on a computer prevents a user from displaying a single image across multiple monitors. The user can display the image on each monitor of the multiple monitor display system but cannot use a display mode that spans the single image across multiple monitors.

To illustrate this issue, consider the following example:

1. The user has downloaded the Web Conference Tools from the Workplace server to a laptop computer.

2. The user is making a presentation in a conference room and connects the laptop computer to a display system consisting of two external monitors.

3. The user opens a spreadsheet application and displays a bar chart on the computer.

4. The user can display the same bar chart on both Monitor 1 and Monitor 2. (In this scenario, the same image displays on both Monitor 1 and Monitor 2 so that the people in the conference room see two identical versions of the same bar chart. This display mode is called "Dual Display" on some IBM systems.)

5. The user cannot display one image of the bar chart that spans both Monitor 1 and Monitor 2. (In this scenario, half of the bar chart appears on Monitor 1 and the other half of the bar chart appears on Monitor 2. This display mode is called "External Desktop" on some IBM systems.)

Display modes that span an image across multiple monitors as described in step 5 above will not function correctly after the user installs the Web Conference Tools from the Workplace server. Display modes that display the same image on multiple monitors as described in step 4 above will function correctly after the user installs the Web Conference Tools.

If the user uninstalls the Web Conference Tools from the computer, the user can then use a display mode that spans an image across multiple monitors, as described in step 5.

Web conferences - Can't maximize projector appshare on Mozilla If a user on Mozilla 1.4 on Windows viewing appshare clicks the Maximize button, the browser crashes. On a server with any other version of Mozilla, or Firefox on Windows, if a user who is viewing appshare clicks the Maximize button, the browser hangs.

Workaround Have the projector maximized before appshare begins, or use Internet Explorer to view appshare.

194

IBM Workplace Collaboration Services 2.6.1 Release Notes

Web conferences - Repaint problems on RedHat Linux You may experience some repaint problems when using the Firefox browser on the Linux platform during a Web conference. Specifically, when you click Click to Present to become the current presenter and then click the "Sharing" tab, what was in the "Agenda" tab still displays. Click Refresh (not the browser Refresh) to correctly display the items in the tab. You will need to refresh again if you go back to the Agenda tab, and return to the Sharing tab.

Web conferences - Screen sharing problems Sometimes, presenters may have trouble sharing their screens and security exceptions display in the Java Console, or they will see a message that says the user cannot use screen sharing without first granting the required security. If this happens, make sure that your installation is using a 1.4 or higher JVM. IBM Java Runtime 1.4.2 for Windows is not supported. If you are using this JVM, please upgrade to IBM Java Runtime 1.4.2 SR1.

Web conferences - Using the Mozilla browserWhen using a Mozilla browser to attend a Web conference where a Screen Share is occurring, you may experience the following issue:

z If you are viewing the Screen share (you are not the person sharing your screen) and you use the scroll bars or choose the "Maximize Projector" option, a persistent blank area may appear on the left side of the Screen Share viewing area.

z If in "Maximized Projector" mode, selecting the "Restore View" option will normally eliminate the problem.

z If scroll bar usage lead to the problem, minimizing and then restoring the browser window will normally eliminate the problem.

Web conferencing - Don't receive e-mail notifications If your installation stores user information in a custom user registry database (the default), rather than in an LDAP directory on an LDAP server, and a group is added to a Web conference, members of that group do NOT receive e-mail notifications for the conference.

Web Conferencing - International issuesThe following identifies known Web conferencing international issues:

z Japanese - To ensure that all Japanese characters (for example, file names) display correctly, both the operating system locale and client browser language must be set to Japanese.

z Hebrew and Arabic - During a Web conference, the Agenda and Sharing tabs under Projector Controls are truncated and may not be legible. In your browser, click View -> Text Size and change your browser font size to Smaller text to fix the display.

z Arabic and other bi -directional languages - If your operating system is running with Arabic or another bi-directional language and you try to install the Web conferencing tools, your language will not be listed in the InstallShield wizard's Regional and Language Options dialog box pop-up, from which you choose a language. InstallShield does not support these languages. However, if you choose a language that is listed and respond to the prompts by clicking Next, you should be able to complete the installation. Once installed, the Web conferencing tools will work correctly.

195

IBM Workplace Collaboration Services 2.6.1 Release Notes

Web conferencing - Using the Firefox browserIf you are using the Firefox browser, you must be sure to use it only with the Sun plug-in version of Java Virtual Machine (JVM) 1.4.2, not 1.5, or you may crash after joining a Web conference.

Even with the appropriate Java Virtual Machine, you may experience the following problems when usingthe Firefox browser for Web conferences:

z Resizing the browser window and maximizing and restoring the projector results in intermittent repaint problems which may cause the user interface to appear incorrect.

z When a slide with animations is uploaded on Internet Explorer and the current presenter using Internet Explorer is in the middle of animations and then a presenter using Firefox becomes the current presenter, the Next animation button for the Firefox presenter will be enabled and both users will see all animations when the Firefox presenter clicks the Next animation button once. The button remains enabled for the Firefox presenter, although clicking it does nothing.

z Scrolling during a Web conference results in intermittent repaint problems which may cause the user interface to appear incorrect. For example:

Scrolling to the left results in the word "Click" looking incorrect:

With other scrolling, the border does not line up correctly and the horizontal border doesn't display correctly (see the letter "r" in "Current presenter"):

z The Screen sharing tab may display the online text "Click Share My Screen . . ." with the first two letters of "Click" missing:

z There may be an issue where the blue bar extends beyond the projector border:

196

IBM Workplace Collaboration Services 2.6.1 Release Notes

In addition, you may also experience significant repaint problems (identified on Bugzilla), such as the following, which result in a half-painted UI:

- Open a couple Firefox browser windows and open certain URLs within them.

- Open a couple (or just one) other applications (for example, Paint).

- Resize the application to a smaller window and then move it over Firefox window(s).

Clicking "Edit agenda", and then returning to the Web conference, fixes many of these UI problems.

"Details" in web conference calendar entry not internationalized To internationalize the "Details" item, select a preferred language in User Profile, or set the preferredLanguage attribute in the LDAP user entry.

People components issues

Adding a third column to Directory Search results You can use the Administration Console to specify results for two columns of search results in the Directory Search window. Directory Search is the component that appears when users search for people while performing a task such as sending a mail message or adding people to a contact list.

If you want to display a third column in the search results, you can modify the pickersettings.properties file for all three columns. In the file, you specify the WebSphere Member Manager attributes to use when displaying search results for either people or group names.

Perform these actions to specify attributes for the three columns:

1. Edit the pickersettings.properties file in the following location: was_root\properties\pickersettings.properties

2. Enter up to three lines, using the workplace.people.picker.wmm.adapter.peopleDisplayAttribute setting to specify attributes to display for each person name. For example, these three lines would display the common name, e-mail address, and telephone number for each person. WMM1.peopleDisplayAttribute.1=cn

WMM2.peopleDisplayAttribute.2=ibmprimaryEmail

WMM3.peopleDisplayAttribute.3=telephoneNumber

197

IBM Workplace Collaboration Services 2.6.1 Release Notes

3. Enter up to three lines using the workplace.people.picker.wmm.adapter.groupDisplayAttribute setting to specify attributes to display for each group name. For example, these three lines could display the common name, department number, and meeting room number for a group. WMM1.groupDisplayAttribute.1=cn

WMM2.groupDisplayAttribute.2=departmentNumber

WMM3.groupDisplayAttribute.3=roomNumber

4. Save the properties file.

5. Restart the IBM Workplace Collaboration Services server.

Exception for Display/Modify Owner in Resource Permissions page The following steps generate an Exception message. You can ignore the message and continue to the next step in your task. To prevent the message from occurring, download WebSphere Portal fix PK03525 available at http://www-1.ibm.com/support/docview.wss?uid=swg24009698.

Steps to reproduce error:

1. Log in to Workplace as wpsadmin.2. Select Administration3. Select Portal Content. 4. Select Manage Document Libraries. 5. Select any document library and select Access Control button on the right (the key icon). 6. A Resource Permission page opens. 7. Select the Display/Modify Owner link. 8. An Exception occurs : GNRL0002E: Exception occurred.

Extending popup contact information on person links When users click a person link, the Person menu displays a set of contact information about the selected person (such as telephone number) that is configurable through the CSEnvironment.properties file on the WebSphere Portal server. You can extend the information that appears by specifying the WebSphere Member Manager attributes corresponding to fields you want to display in the person link contact information. You can also control the order in which the items of information appear.

Perform the following actions: 1. Open the file CSEnvironment.properties from the following location:

iwp_root/shared/config2. Locate the CS_SERVER_PERSONTAG.businessCardItems property. If the property does not

exist, add it to the file. 3. Modify the string after the property with valid Member Manager attributes separated by commas

(,). The items appear when a person link is clicked, top to bottom, in the same order in which you type them.

4. Save the properties file. 5. Restart the WebSphere Portal server.

198

IBM Workplace Collaboration Services 2.6.1 Release Notes

Default attributes are: z jobTitle z roomNumber z telephoneNumber

WebSphere Member Manager attributes valid for including in person link contact information are: z businessCategory z carLicense z cn z countryName z departmentNumber z description z displayName z employeeNumber z employeeType z facsimileTelephoneNumber z givenName z homePostalAddress z ibm-gender z ibm-generationQualifier z ibm-hobby z ibm-middleName z ibm-otherEmail z ibm-personalTitle z ibm-primaryEmail z ibm-regionalLocale z ibm-timeZone z Initials z jobTitle z localityName z manager z mobilez o z ou z pager z postalAddress z postalCode z preferredLanguage z roomNumber z secretary z seeAlso z sn z stateOrProvinceName z street z telephoneNumber z uid

199

IBM Workplace Collaboration Services 2.6.1 Release Notes

People search can time out when Domino is the LDAP server If your LDAP server is Domino, searches for people using People Finder and Directory Search can time out. Searches for the displayName attribute cause the timeout because they require a full-text search rather than a quicker view search. To correct the problem, follow the steps below to remove the displayName attribute from the WebSphere Member Manager search template. Perform these steps only if the displayName attribute is not populated.

1. Stop Workplace Collaboration Services.

2. Type the following command to set up your command line environment: Windows call <install_root>\AppServer\bin\setupCmdLine.bat UNIX call <install_root>\AppServer\bin\setupCmdLine.sh

3. Navigate to the <install_root>\WorkplaceServer\lwp_ext directory.

4. Make a backup copy of the lwp.peopleProtoWmmDelegate.jar file located in the lwp_ext directory.T

5. Type the following command to unzip the templates.properties file from the lwp.peopleProtoWmmDelegate.jar file.

jar xf lwp.peopleProtoWmmDelegate.jarcom/ibm/wkplc/people/wmm/workspace/templates.properties

6. With a text editor, open the templates.properties file and delete the text indicated in bold, strikethrough format below:

one.word.template=((cn=?0*) OR (givenName=?0*) OR (sn=?0*) OR (displayName=?0*)) two.word.template=((cn=?0*?1*) OR (cn=?1*?0*) OR (givenName=?0 ?1*) OR (sn=?0 ?1*) OR

((givenName=?0*) AND (sn=?1*)) OR ((givenName=?1*) AND (sn=?0*)) OR (displayName=?0*?1*)) gt.two.word.template=((cn=?0*?1*) OR (cn=?1*?0*) OR (givenName=?0 ?1*) OR (sn=?0 ?1*) OR

((givenName=?0*) AND (sn=?1*)) OR ((givenName=?1*) AND (sn=?0*)) OR (cn=?3*?2*) OR ((givenName=?2*) AND (sn=?3*)) OR

((givenName=?3*) AND (sn=?2*)) OR (displayName=?0*?1*))

one.word.one.comma.template=((cn=?0) OR (cn=*?0) OR (sn=?0) OR (displayName=?0*)) two.word.one.comma.template=((cn=?0 ?1*) OR (cn=?1* ?0) OR (givenName=?1* ?0) OR

(sn=?1* ?0) OR ((givenName=?1*) AND (sn=?0)) OR (displayName=?0 ?1*))gt.two.word.one.comma.template=((cn=?0*?1*) OR (cn=?1*?0*) OR

((givenName=?1*) AND (sn=?0)) OR (displayName=?0*?1*))

group.search.template=(cn=?0*)

7. Type the following command to zip the updated templates.properties file into the lwp.peopleProtoWmmDelegate.jar file.

jar uf lwp.peopleProtoWmmDelegate.jarcom/ibm/wkplc/people/wmm/workspace/templates.properties

8. Restart Workplace Collaboration Services.

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, Workplace Collaboration Services 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.

200

IBM Workplace Collaboration Services 2.6.1 Release Notes

Pop-up windows can trigger login screenOpening 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.

Script error in Directory Search with Mozilla on i 5/OS If the user's browser is Mozilla and the platform is i5/OS (iSeries), attempting to add a selection of multiple names to a group of contacts fails with a script error.

WorkaroundAdd the names one at a time.

Unable to search user name with double -byte characters If your Workplace deployment is configured with Microsoft Active Directory 2000 LDAP, any non-administrator user faces an issue using the People Finder. Searching for a user with the People Finder from the Workplace Managed Client displays the People Finder portlet instead of the search result.

WorkaroundUse the People Finder portlet from the browser.

Workaround for using People Finder "Show Details" on LinuxWhen Mozilla 1.4 users perform a People Finder search from the same page as the Mail portlet whenfolders are displayed , if they click "Show Details," they see the message "no result found." Use either of the following methods to work around this problem:

z Select "Hide Folders" in the Mail portlet. z Maximize the People Finder portlet.

XML error in Directory Search with Mozilla 1.4 or Firefox 1.0When a user's browser is Mozilla 1.4 or Mozilla Firefox 1.0, a user who is searching for names to add as new contacts will see the error "Error transforming xml object" in the Directory Search window.

WorkaroundAdvise users to switch to the Internet Explorer browser for this purpose.

201

IBM Workplace Collaboration Services 2.6.1 Release Notes

Security issues

Changing the SSL repertoire used by the SIP Services An administrator can encrypt client connections to the SIP Services with SSL by selecting an "Enable SSL" option in the SIP cell-wide settings available from the WebSphere Administrative Console on the Workplace server. When enabling SSL, the administrator must also specify the address and port on which the SIP Services listen for SSL connections.

When the administrator selects the "Enable SSL" option, the SIP Services must use an SSL repertoire defined on the WebSphere server to support the SSL encryption. By default, the SIP Services are coded to use the default SSL repertoire (named "DefaultSSLSettings") of the WebSphere server.

In a production environment, an administrator may create new SSL repertoires and the default SSL repertoire (DefaultSSLSettings) may not be available on the WebSphere server. IBM does not recommend using the default SSL repertoire in a production environment.

Note: You can view the SSL repertoires that are defined for the WebSphere server from the Security -> SSL menu of the WebSphere Administrative Console.

If SSL is enabled for the SIP Services, the SIP Services will always use the default SSL repertoire unless the administrator manually configures the SIP container to use a different SSL repertoire.

Currently, there is no user interface option available in the SIP cell-wide settings of the WebSphere Administrative Console that enables the administrator to change the SSL repertoire used by the SIP Services. To manually configure the SIP container to use a different SSL repertoire, the administrator must perform the following procedure:

1. Open a text editor on the Workplace server and create a new text file.

2. Save this text file with the name of "sipcontainer.properties."

3. In the sipcontainer.properties file that you have just created, manually type the following parameters and values. These parameters and values are needed by the SIP Container to use a different SSL repertoire. You can begin typing these parameters and values on the first line of the sipcontainer.properties file.

com.ibm.ssl.protocol = SSL com.ibm.ssl.contextProvider = IBMJSSE com.ibm.ssl.keyStoreProvider = IBMJCE com.ibm.ssl.trustStoreProvider = IBMJCE com.ibm.ssl.clientAuthentication = false com.ibm.ssl.keyStore = c:/Workplace/AppServer/etc/ServerKeyFile.jks (See the note below.) com.ibm.ssl.keyStorePassword = password for the keyStore file specified above (See the note below.) com.ibm.ssl.keyManager = IbmX509 com.ibm.ssl.keyStoreType = JKS com.ibm.ssl.trustStore = c:/Workplace/AppServer/etc/ServerTrustFile.jks (See the note below.) com.ibm.ssl.trustStorePassword = password for the trustStore file specified above (See the note below.) com.ibm.ssl.trustManager = IbmX509 com.ibm.ssl.providerClassName = com.ibm.jsse.IBMJSSEProvider

202

IBM Workplace Collaboration Services 2.6.1 Release Notes

Note: The parameters com.ibm.ssl.keyStore= and com.ibm.ssl.trustStore= must point to the key store file and trust store file used by the SSL repertoire that you want the SIP Container to use. The correct value for these parameters will vary depending on the SSL repertoire. Note also that you must specify the correct password for the key store file and the trust store file in the line immediately below each of those parameters.

4. After populating the sipcontainer.properties file with all needed parameters and values as shown above, save the sipcontainer.properties file to the following location on the Workplace server:

<root>:\Workplace\AppServer\properties

5. Restart the WebSphere Portal server that hosts the SIP Container.

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.

HTTP/HTTPS on a non-standard port In order to customize the HTTPS port over which the Instant Messaging applet connects, you must edit a properties file.

In the file

was_home/installedApps/node/LWP_Synchronous_Applets.ear/synchronousappletsW EB.war/applets/AppletConnectionConfig.properties

change: valid.ssl.connection.ports=443,-1

to: valid.ssl.connection.ports=yourPortNumber,-1

For example: valid.ssl.connection.ports=444,-1

203

IBM Workplace Collaboration Services 2.6.1 Release Notes

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 PKCS 12 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.

This issue causes message encryption to fail in the following situations:

z Sending an encrypted reply to a message received from a new correspondent. z Adding a correspondent manually to the PAB, then attempting to send an encrypted message to

that correspondent.

204

IBM Workplace Collaboration Services 2.6.1 Release Notes

Multiple certificates may be marked as default for signing In the My Certificates panel of the Security preferences, a user may select which certificate is to be the default signing certificate through the 'Edit Purpose . . .' action button. However, if the newly selected certificate has been imported by the user, both the original and the newly-selected certificates may be marked as the default for signing.

This is easily corrected by selecting the original certificate and, using the 'Edit purpose . . .' action button, manually removing the default signing attribute.

Portlets require HTTP server's certificate CN to match DNS name ODC editors and reverse proxy portlets are validating that the HTTP server's certificate common name matches the DNS name of the HTTP server. If the HTTP server certificate is named in some other manner - like "generic HTTPServer" - some functionality will fail. Known areas to fail include rich text, sheet, and presentation editor file creation, as well as the Reverse Proxy Portlet. Others may fail as well.

Workaround Make the common name of the HTTP server certificate match the DNS name of the HTTP server machine found in the HTTP server's key file.

Repeating error message : "Authentication failed for <null> " When the LotusWorkplace_Server process is started, the Task Scheduler Service will attempt to run the Workplace PKI task every 5 minutes. If the 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 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.

205

IBM Workplace Collaboration Services 2.6.1 Release Notes

3. Comment out the following task entry by adding "!--" & "--" to the opening and closing task tags, as shown below:

<!-- task xmi:id="Task_11" name="@@=pkirequestprocessor.task.name" enabled="true" description="@@=pkirequestprocessor.task.description" className="com.ibm.workplace.security.pki.scheduler.PkiProcessRequestsTask" capability="MAIL" scheduleType="5"><taskSchedule xmi:id="TaskSchedule_11" minute="-5" hour="-1" dayOfWeek="-1" dayOfMonth="-1" month="-1"/></task -->

4. Save and close the file.

5. Start the LotusWorkplace_Server process.

NOTE: If #2 above is used, and, at a later date, the 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 Collaboration Services, 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.

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 Collaboration Services and its usage of LDAP. A Java programmer can use the Member Manager API shipped with the product 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 Workplace Collaboration Services data.

To limit your exposure, give Workplace Collaboration Services only read access to the LDAP server. For information on configuring read-only LDAP directory access, see the IBM Workplace Collaboration Services information center.

206

IBM Workplace Collaboration Services 2.6.1 Release Notes

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: ( ! @ # $ % )

User is prompted to trust their own S /MIME certificate In an environment where the administrative policy requires newly created S/MIME credentials to be submitted via the PKI Framework to an external CA for certification, the user may be prompted to trust their own certificate when viewing signed messages sent by themselves. This problem will happen intermittently, and will most frequently occur when the user opens a signed message from the sent messages folder.

In this situation, the user will be presented with a dialog box similar to the one shown below. The user should simply choose the Cancel button.

207

IBM Workplace Collaboration Services 2.6.1 Release Notes

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.

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.

Documents with language set to Other cause poor -quality search If the user preference for language is set to Other, only the stemmed words, variants on the original search term, are stored in the Index but not the original term itself.

The workaround is always set your user-preference language when saving a document to ensure both stemmed and original words are saved to the index.

208

IBM Workplace Collaboration Services 2.6.1 Release Notes

Instant Messaging - Chat window does not displayThe chat window - and other "pop-up" windows - will not display unless you disable the "block pop-up windows" setting for the following browsers:

z Firefox 1.0 on any platform (Microsoft Windows 2000, Windows XP, Red Hat, or SuSE) z Microsoft Windows Internet Explorer on Windows XP with Service Pack 2

Follow the appropriate procedure below to disable the "block pop-ups" setting.

Firefox on Windows platform 1. In the browser, click Tools -> Options -> Web Features. 2. Uncheck "Block Popup Windows." 3. Click OK.

Firefox on Linux platform 1. In the browser, click Edit -> Preferences -> Web Features. 2. Uncheck "Block Popup Windows." 3. Click OK.

Windows Internet Explorer on Windows XP with Service Pack 2 1. In the browser, click Tools -> Internet Options. 2. Click the Privacy tab. 3. Uncheck "Block Popups." 4. Click OK.

JavaScript error when performing certain tasksProblem: 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.

Solution: Click OK to dismiss the error and continue working.

Problems with SCORM courses not working on Linux /MozillaFollowing are the known issues using SCORM courses with Linux/Mozilla:

z Any course that uses the SCORM standard will not track.

z SCORM 1.2 compliant courses may not launch

Workaround : Use Internet Explorer 5.5 or 6.0.

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.

209

IBM Workplace Collaboration Services 2.6.1 Release Notes

Search for Russian and Polish languagesRussian issueData is indexed in Russian, but Search parses the search terms according to the user's profile setting, notthe browser's settings.

WorkaroundClick on the "Edit my profile" link and set the user's language to "Russian", logout and then login again,then perform the search.

Polish issueUnexpected search results might occur because words are being tokenized incorrectly. Polish documentsare being indexed incorrectly using trigram-mixed, but should be indexed as tri-gram. Search results willbe returned, but could include false matches.

Search generates error on page in Windows 2000 ProfessionalRunning a search in the Microsoft Windows 2000 Professional environment can cause attempts to open other tab pages, such as Team Spaces or Applications, to fail with an "error on page" message.

WorkaroundAfter running a search, return to the Welcome page before trying to access another tab page.

Some Learning functionality not supported in Mozilla browserThe following Workplace Collborative Learning functionality is currently not supported while in the Mozillabrowser:

z Course Chat z Live Virtual Classroom sessions z Learning specific Discussions

Workaround Use Internet Explorer (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.

210

IBM Workplace Collaboration Services 2.6.1 Release Notes

Portlet issues

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

Exception opening members page in the Pages and Layout portlet The upgrade script will not work if back slashes are used. The correct way to run the script is to use foward slashes, as follows: importAppTemplates.bat C:/MyTemplates.

Instant Contacts - Lose changes You click the People palette icon to the right of the online status icon in the upper-right corner to display and close People Finder and your Instant Contacts list. If you choose New group from the Actions menu at the top of Instant Contacts, type a new group name in the New group page, and then either click the People palette icon to close People Finder and Instant Contacts or click in the left-hand navigator to go somewhere else, such as Documents, when you click the People palette again to re-display People Finder and Instant Contacts, the New group pages displays, but without the new name you had typed.

Instant Contacts - Removing a contact added by e -mail address If you add a person to your Instant Contacts list via e-mail address, un-check "Add to address book," and then try to remove that person by clicking their name and selecting "Remove from Instant Contacts list" from the Person menu, the person is not removed. You can remove this person from your Contact List by clicking Organize list from the Actions menu and then clicking the Remove icon beside the contact's name and then OK to confirm the removal. Note that if you check "Add to address book" when you first add the person to your Contact List via e-mail address, you will be able to use the Person menu to remove the contact.

211

IBM Workplace Collaboration Services 2.6.1 Release Notes

Instant Messaging - Added contacts may not display If your Instant Contacts list includes many public groups, each of which has many members, after performing certain actions, some contacts may not display in the Contact Lists. For example, your LDAP server is set up with over one hundred public groups, each with over ten members. Then ten or more additional/extra users log into Workplace Collaborative Services and add more than ten public groups to their respective Contact Lists. If they then perform some actions, such as changing their status, their Contact List may not display all their contacts. If this happens, they should log out of Workplace Collaborative Services and then log back in to restore their list of contacts.

Instant Messaging - Adding new contacts limitation You add one or more contacts to your Instant Contacts list by clicking New contacts from the Actions menu, clicking Find person, and then selecting the contacts to add. If you try to add twenty or more contacts at once - or if you add many contacts with long names or email addresses - an error may display. To avoid this, add fewer contacts, click OK, and then click Find person to add other contacts.

Instant Messaging - Cannot change online status If you are logged on to both Workplace Managed Client and the WebSphere Portal at the same time, you will be unable to change your online status in Workplace Managed Client. You can, however, change your status in WebSphere Portal.

Instant Messaging - Chat window doesn't open The chat window won't display if a modal dialog is open. Specifically, when two people are logged in (Person1 and Person2) and Person2 opens a modal dialog box, for example, when trying to find a name when adding a new contact, Person1 can send a chat to Person2. However, the chat window won't display for Person2 until Person2's modal dialog box - in this case the search directory dialog - is closed.

Instant Messaging - Chat window loses focus When two people (Person1 and Person2) are chatting and Person2 sets their online status to Do Not Disturb and then closes and reopens the chat window, Person1's chat window input area does not get focus so Person1 will not be able to type anything. Click Invite Others to regain focus.

Instant Messaging - Chat window still enabled after logging off If a chat with multiple chat partners is underway and one participant logs out of Workplace Collaborative Services, the chat window for this user is still enabled.

212

IBM Workplace Collaboration Services 2.6.1 Release Notes

Instant Messaging - Cluster environments and PIMsIn a cluster environment, users may connect to any of the nodes in the cluster. However, each user musthave a single (the same) Presence and IM server (PIM), regardless of the node to which they areconnected. Therefore, a user cannot be online when their "home" PIM is not running. Note that all nodesin a cluster must be up and running. If any node is stopped for a reason, it should be removed from thecluster.

Instant Messaging - IM issue when user logs into different nodeThe Presence and IM server (PIM) is not designed to handle failover situations in WorkplaceCollaborative Services 2.6. In a cluster environment, users may connect to any of the nodes in thecluster. However, each user must have only a single (the same) PIM, regardless of the node to whichthey are connected. Therefore, users who connect to the node in which their PIM resides will becomedisconnected when their node fails or is stopped. Other users logged in to other nodes will remain online. They will see the disconnected users as offline (as if they logged off or closed their client). After the failedor stopped node is re-started, all disconnected users can log in again, and any issues resolved.

Instant Messaging - Issues with chat partner no longer chattingA user who was engaged in a chat will still appear in his/her partner's chat window Chat Participant list,even after closing his/her chat window. For example, User1, User2, and User3 are all logged intoWorkplace Collaborative Services. User1 and User2 chat; User2 then closes his/her chat window. User1 clicks the "Invite Others" button to invite User3 to chat. User3 correctly receives the chat invitation anddisplays in User1's Chat Participant list. However, User2 also appears in User1's Chat Participant list andreceives an invitation to chat.

Instant messaging - No focus in chat windowWhen you open a new Chat window using the Mozilla/Firefox browser, no cursor displays in the "Type your message here" field, so the assumption is that there is no focus in this field. You should, however, still be able to type your message in that field. After exchanging several messages with your chat partner,the cursor display should return.

Instant Messaging - Using special characters in chatsIf you insert an ampersand (&) or "<"in the invitation message when inviting additional partners to chat,your chat partner(s) receive the message, but the & or < and all text following it is truncated.

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.

213

IBM Workplace Collaboration Services 2.6.1 Release Notes

Instant Messaging server Help issuesThe following areas documented in instant messaging Help differ from the instant messaging interfaceand/or functionality:

z The Instant Contacts "Removing groups" Help topic states that "when you remove either a personal or public group from Instant Contacts, it is also removed from your address book." This statement is incorrect. Removing groups from your Instant Contacts list does not affect your address book.

z The Instant Contacts "Moving contacts" Help topic incorrectly states that you can move a contact that is a member of only one group by editing the contact's associated group. Instead, create a new group and add the contact to that group (or, add the contact to an existing group); then remove the contact from the original group.

z The Instant Contacts, "Logging in to instant messaging" and "Logging out of instant messaging" Help topics incorrectly state where the user name and online status appears. In 2.6, the user's online status displays in the upper-right corner and the logged in user name does not display.

Issues with empty categories in the content palette Empty categories in the content palette (the portlet palette) cause problems with displaying and using the palette. Specifically, the display of the content palette may be corrupted, and you may not be able to drag portlets onto a page from the palette. To avoid these problems do not create empty categories in the content palette.

In a page where you have the ability to add portlets to the page, click the vertical bar on the right edge ofthe browser window to open and close the content palette. The content palette displays a list of portlets;you can drag portlets from the palette and drop them onto the page. If you open the content palette andclick the wrench icon at the top of the palette to edit the palette, then click New to create a new category,enter a name in the Category Name field, and click OK, you have created an empty category.

If you create an empty category and experience problems with displaying and using the content palette, you must delete the empty category.You may have to log out of workplace and log back in before deleting the empty category. To delete the empty category, open the content palette and click the wrench icon at the top of the palette to edit the palette, then select the category you want to delete, click Delete, and click OK. After you delete the empty category, you can follow the procedure below create the category again, this time adding at least one portlet.

To create a new category and simultaneously add one or more portlets to the category, begin by opening the content palette and clicking the wrench icon at the top of the palette to edit the palette. Next, click New to create a new category, and enter a name in the Category Name field. After entering the name in the Category Name field, click Add to add one or more portlets to the new Category. Enter the name of the portlet you wish to add, or another valid search string (for example, "portlet") in the "Title contains:" field, then click search. Select one or more portlets from the list by selecting the checkbox next to each portlet, and click OK to add the portlets to the new category.

214

IBM Workplace Collaboration Services 2.6.1 Release Notes

JavaScript Errors With Content Palette in IE In a page where you have the ability to add portlets to the page, you click the vertical bar on the right edge of the browser window to open and close the content palette (the portlet palette). The content palette displays a list of portlets; you can drag portlets from the palette and drop them onto the page.

In Internet Explorer, if you open the content palette in a browser window with a horizontal scroll bar, clicking the horizontal scroll bar while the palette is open causes a JavaScript error. To continue using the content palette after this error occurs, you must refresh your browser window.

In Internet Explorer, you can choose Tools > Internet Options > Advanced, and deselect "Display a notification about every script error." This will not prevent the error, but will prevent display of a dialog box notifying you that the error has occurred.

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.

No confirmation box when removing portlets from Content Palette In a page where you have the ability to add portlets to the page, you click the vertical bar on the right edge of the browser window to open and close the content palette (the portlet palette). The content palette displays a list of portlets; you can drag portlets from the palette and drop them onto the page. If you open the content palette and click the wrench icon at the top of the palette to edit the palette, then click on the name of a category in the list, select one or more portlets in the category by selecting the check boxes next to the portlet names, and click Remove to remove the portlet(s) from the category, a JavaScript error occurs and the portlet(s) are removed from the category; you are not given the opportunity to confirm or cancel the removal.

Search treats hyphen as a word space delimiter To ensure a search query returns correct results, use quotation marks when a search term includes a hyphen.

Using vertical scroll bar in IE closes Content Palette In a page where you have the ability to add portlets to the page, you click the vertical bar on the right edge of the browser window to open and close the content palette (the portlet palette). The content palette displays a list of portlets; you can drag portlets from the palette and drop them onto the page.

In Internet Explorer, if you open the content palette in a browser window with a vertical scroll bar, clicking the vertical scroll bar while the palette is open causes the palette to close. If your IE browser window is not maximized, or if your screen is set to 640x480 display mode, this can mean that some icons in the content palette are inaccessible. To work around this problem, either maximize your browser window (if your display is set to display more than 640x480 pixels) or use a different browser (in 640x480 mode).

215

IBM Workplace Collaboration Services 2.6.1 Release Notes

Web conference projector controls and large fontsIf your system is set to use large fonts, when you're in a Web conference, there may be some displayproblems in the Projector control area. For example, on-line text may bleed into the Project Control tabsand the Share My Screen/Stop Sharing buttons may be misaligned. Minimize the Attending orDownloads and Links sections to better display the on-line text. For high resolution screens, maximizingthe browser window will also fix this problem.

Web conferences - Mozilla 1.4 issuesYou may experience the following problems when using Mozilla 1.4:

z Resizing a web conference window to a larger and then smaller size cuts off some of the window content, displaying no scroll bars. To fix this problem, maximize the window, or press F5 to refresh it. Note that refreshing will re-load the entire page.

z If you click Maximize Projector and Restore View to maximize and restore the Projector size more than once during a Web conference, the Preview page and Next page buttons are no longer visible on the page. To avoid this problem, click maximize and restore in the browser tool bar instead.

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 disappearSome windows, such as the chat window, may "flicker" (display and then disappear) when you minimizethe 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.

"Back to Documents" tab missing after Document SearchInstead of clicking on the "Back to Documents" link (which isn't available), click the "My Work" link at thetop of the page to return to where you were before.

216

IBM Workplace Collaboration Services 2.6.1 Release Notes

WebSphere Portal issues

Content palette alternative If you encounter difficulty adding components to application pages by dragging and dropping components (portlets) from the content palette, use the application editor as an alternative. From the toolbar of your application, click Actions - Edit; then click Pages and Layout to display the list of application pages to which you can add content (portlets or components). See the Help topics for Pages and Layout for more information about adding content to application pages.

Content palette can be updated manually The content palette should contain the Custom, Domino Application, Invitations, and Search portlets, but it does not. You can add these missing portlets and any other portlets to the content palette. Click Add at the bottom of the palette and follow the instructions to search for and add the portlets you need to the palette.

Content palette paging controls do not work as expected If you use the content palette to add portlets to the pages of your portal or application, you will notice that the page navigation controls do not work as expected. Open the content palette and click the Edit icon to display Add Content. Click the Portlets category name to display the portlet selection list. At the bottom of the portlet selection list, find the page buttons to move forward, backward, or jump through the pages of the portlet selection list. When you click any of the available page navigation buttons (First page, Previous page, Next page, Last page, or Jump to page <number>), you always return to the first page of Add Content. From here, simply click the Portlets category name again to get to the correct target page within the portlet selection list. Repeat this action each time the page navigation buttons take you out of the portlet selection list and back to the first page of Add Content.

WebSphere portal indexes required To improve the performance of some Workplace-specific data access in the WebSphere Portal databases, the following indexes should be created. If you used schema names different than the ones shown below when installing WebSphere Portal, you should substitute your schema names for the ones below. These statements can be executed using the vendor supplied interactive SQL tools. Example command line tools would be:

DB2 db2 connect to <dbname> user <dba username> using <password>db2 -tvcreate index IX2110D on prot_res (parent_oid, oid );create index IX2140B on lnk_user_role ( role_inst_oid );create index lambr_idxfix1 on wmmlambr (WMMLAMBR_ID, MEMBER_TYPE);create index laasval_idxfix3 on wmmlaasval (WMMLAMBR_ID, WMMLAATR_ID);create index laasval_idxfix2 on wmmlaasval (WMMLAMBR_ID, HAS_CONTEXT);create index disresidx2 on DISCUSSIONRESOURCE (uri, parenturi, path);create index disresidx3 on DISCUSSIONRESOURCE (uri, rooturi, projectid,workspace);create index disres_midx2 on DISCUSSIONRES_M (uri, wpcpguid);create index metaidx4 on wpcpmetadata ( wpcpguid, wpcpdeleted);

217

IBM Workplace Collaboration Services 2.6.1 Release Notes

Oracle sqlplus <dba_username>/<password>@<dbserver>

create index IX2110D on WPSDBUSR.prot_res (parent_oid, oid ); create index IX2140B on WPSDBUSR.lnk_user_role ( role_inst_oid ); create index lambr_idxfix1 on WMMDBUSR.wmmlambr (WMMLAMBR_ID, MEMBER_TYPE); create index laasval_idxfix3 on WMMDBUSR.wmmlaasval (WMMLAMBR_ID, WMMLAATR_ID);create index laasval_idxfix2 on WMMDBUSR.wmmlaasval (WMMLAMBR_ID, HAS_CONTEXT);create index disresidx2 on WCMDBADM.DISCUSSIONRESOURCE (uri, parenturi, path);create index disresidx3 on WCMDBADM.DISCUSSIONRESOURCE (uri, rooturi, projectid, workspace);create index disres_midx2 on WCMDBADM.DISCUSSIONRES_M (uri, wpcpguid); create index metaidx4 on WCMDBADM.wpcpmetadata ( wpcpguid, wpcpdeleted);

Microsoft SqlServer isql -S <servername> -U <dba username> -d <database>

create index IX2110D on WPSDBUSR.prot_res (parent_oid, oid ); create index IX2140B on WPSDBUSR.lnk_user_role ( role_inst_oid ); create index lambr_idxfix1 on WMMDBUSR.wmmlambr (WMMLAMBR_ID, MEMBER_TYPE); create index laasval_idxfix3 on WMMDBUSR.wmmlaasval (WMMLAMBR_ID, WMMLAATR_ID);create index laasval_idxfix2 on WMMDBUSR.wmmlaasval (WMMLAMBR_ID, HAS_CONTEXT);create index disresidx2 on WCMDBADM.DISCUSSIONRESOURCE (uri, parenturi, path);create index disresidx3 on WCMDBADM.DISCUSSIONRESOURCE (uri, rooturi, projectid, workspace);create index disres_midx2 on WCMDBADM.DISCUSSIONRES_M (uri, wpcpguid); create index metaidx4 on WCMDBADM.wpcpmetadata ( wpcpguid, wpcpdeleted);

IBM Data Access Tool issues

Arabic and Hebrew translationsNote the following regarding Arabic and Hebrew translations:

z Arabic and Hebrew translations will not be provided for the data access tool in this release. Note that this does not include the Application catalog.

z The Import and Export buttons located in the Application catalog will be translated into Arabic and Hebrew, but the dialog boxes that appear when those buttons are clicked will appear entirely in English because those dialog boxes are part of the data access tool code. Note that there may be other situations where Arabic or Hebrew translations will switch to all English throughout the user interface.

218

IBM Workplace Collaboration Services 2.6.1 Release Notes

Button label font style does not automatically refresh In data access designer, if you change the font style attribute of a button label, the label does not automatically refresh with the new font style. To see the new font style, click the selected button once, then click outside the button. The new font style will then appear on the label. You can also change another attribute for the button to see the new font style appear for the button label.

Cannot import or export applications without the data definitionWhen 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.

Changing image in image control does not save immediatelyIn data access designer, if you add an image control to a form, save and close the form, re-open the form, and then change the image that the image control is pointing to, you will not be able to save the form withthe new image. You must make an additional change to the form and then save the form for the newimage to appear in the image control.

Combination box with filtering enabled not working correctlyIn a combination box that is displaying values from a table, if the value and label columns are from thetable that the form is based on, then any filter that you set in a query by clicking the Add Columns button in the attributes editor won't work.An example of a query: With an Employees table that included empName, isMgr, and MgrName tablecolumns, if you bind a combination box to the MgrName table column and then specify a query throughthe Add Columns button that indicates SELECT empName from Employees WHERE isMgr=1, then thequery won't work.

Compression cannot be turned off during exportWhen exporting a database application, regardless of whether or not you select Compress the contentsof the JAR file in the Export to file system dialog box, the database application will always getcompressed.

DateTime data type not working correctly when output in gridsComputed Field columns or Output columns in a grid that are bound to a DateTime table column will onlydisplay the associated Date value, not the Time value in data access viewer.

Default location of cursor in form is in last field When creating new records in a form in data access viewer, after you save a new record and then click New to create a new record, the cursor will default to the last field in the form. Simple actions can be used by the database application designer to change the default cursor location if desired.

219

IBM Workplace Collaboration Services 2.6.1 Release Notes

Delete button for deleting custom values in a list does not work If you are in the Options tab of the attributes editor in data access designer, designing a Custom values list for a List Box, Combination Box, or Radio Button Group control in a form, you must use the keyboard command DELETE to delete any values listed in a row under Value and Label. If you click in a row that contains text and then click Delete above the list, the text will not delete properly.

Disabled radio buttons appear to be enabled Radio button groups may still appear to be enabled when there is no available record to edit, or when you have disabled them while creating the form in data access designer. Although the buttons appear to be enabled (not greyed out), you will not be able to select the radio buttons nor give them keyboard focus.

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.

Events/Actions that are not working for grids and reports In reports, the following actions will work: z Close z Exit z Load z Message

In reports, the following actions will not work: z Delete z Insert New Record z Duplicate Records

In reports, the following events will not be triggered: z On Hint z On Help z On Focus

220

IBM Workplace Collaboration Services 2.6.1 Release Notes

In grids, the following actions will not work: z Set Attribute z Set Focus z Trigger Event

In grids, the following events will not be triggered: z On Focus z On Hint z On Help

Floating point numbers are not handled correctly Floating point numbers are not handled correctly in the data access tool. When creating a new table using the New Table dialog box, if you select FLOAT in the Data type drop-down list for a table column, the Precision field becomes enabled. Note the following two issues that happen when using the Precision field with the FLOAT data type:

1. If an edit box is bound to a float table column, then when the form or grid is run it will only accept the number of characters specified in the Precision field. This behavior is incorrect, as the number of characters that you enter in the Precision field is largely unrelated to the precision of a number. For example, both of the numbers 4 and 32768 have only 1 significant bit and would require nearly the same precision.

2. The value entered in the Precision field does not determine the precision allowed in the numbers that can be entered in a form in data access viewer. The actual precision is always 32bit.

Font style changes on printout When printing a form, grid, or report that has a text decoration, you may notice that the font style on the printout does not look the same as the font style displayed in data access viewer. To make sure they appear the same, uncheck the Use default font check box in the Font tab of the attributes editor and click Choose Font to select a new font. If you want to continue using the default font but want to ensure that it displays correctly when printing, simply select the default font from the list of fonts.

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.

IBM Data Access tools missing "Close" menu option under File The missing "Close" menu option can be an issue when you are in a new or existing document that you want to exit without saving.

Workaround The only way to do this by clicking the tab for the document, and selecting the "X" button to close the tab.

221

IBM Workplace Collaboration Services 2.6.1 Release Notes

Images don't appear on buttons if width of button is too small When adding an image to a button in data access designer, make sure the button is wide enough to fit both the image and the button label. If the button is not wide enough, the image will not appear on the button.

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.

Looping occurs in grids when using the duplicate record action If you add the Duplicate Current Record simple action to a grid column that is an Edit Box, Check Box, or Combination Box, then when the grid column is double-clicked in preview mode or in data access viewer an endless loop will start as the newly created row becomes active, activating the grid column again. The data access tool will eventually crash.

If you want to add the Duplicate Current Record simple action to a grid column, add it to a grid column of control type Output or Computed Field as these control types do not cause the looping to occur.

Navigating a new form with keyboard on Linux In data access designer on Linux, you cannot use any key to navigate within an open form, grid, or report that you just created. To navigate within a new form, grid, or report, you must switch to any other application (using ALT+ TAB) and then come back to the open form, grid, or report, OR close the new form, grid, or report and then re-open it again.

No confirmation when saving form in data access viewer If you are creating a new record in a form in data access viewer, and then click Save to save the record, you will not get a confirmation that the record was saved. Use the actions provided in the bottom action bar see the saved records.

Non-nullable table columns in grids, forms cause error on save If you create a grid or form by choosing a table that includes table columns that are not nullable (excluding the primary key table column), but do not include the non-nullable column(s) in the grid or form, then when you try to save the data that you enter in the grid or form in data access viewer, you will get an error. You must include the non-nullable column(s) in the grid or form to be able to save the data.

It is recommended that you either include the non-nullable table columns in your grid, or make the table columns that you do not want in your grid nullable to avoid getting errors.

222

IBM Workplace Collaboration Services 2.6.1 Release Notes

On Save/On Save Error issues with forms, grids If you are entering data into a form or grid and you do not enter a value for a required field, such as in the primary key field, then any action that is associated with an On Save or On Save Error event in the form or grid will not be executed.

Printing a grid or report If you print a grid or report, the top border of the grid or report appears only on the first printed page. The top border will not appear on the pages following the first page.

Problems when using multiple-value design controls In data access viewer, when using a multiple-value design control (List Box, Combination Box, and Radio Button Group) in a form, you may notice one or more of the following problems:

z values get deleted when selecting a different item in an existing record z error messages in log files z inability to save the record z navigation buttons are disabled

To avoid this, when designing the form, do not bind design controls and their values to the same table column.

Records do not sort correctly in data access viewer When designing a form, report, or grid using tables with relationships, you may notice that the records do not display in data access viewer in the order you specified in the Order by tab of the Add columns dialog box. To correct this, click Sort in the bottom action bar to sort the records in the desired order.

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.

223

IBM Workplace Collaboration Services 2.6.1 Release Notes

Rename/Save As not supported for more than one design element If you select more than one design element when viewing each list of design elements in data access designer, and then right-click on the selection, the Rename or Save As actions will be performed only on the selected design element that is closest to the top of the list. You cannot rename or perform a 'save as' action on more than one design element at a time.

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.

Replace/Find not working for some data types in forms, grids If a form in data access viewer contains a field that is bound to a Date or Datetime datatype, clicking Find Next or Replace in the Replace dialog box does not search those fields.

If a grid in data access viewer contains a grid column that is bound to a Date, Datetime, Name, or Namelist datatype, clicking Replace in the Replace dialog box (click Edit -> Find/Replace) does not search those columns.

Reports without data do not display group report column labels If you create a report that contains group report columns (select a report column, click the Group tab in the attributes editor, Group column is selected), all of the report column labels will appear in data access viewer, except for the group report column labels if there is no data for the report to display. When data is available for the report, the group report column labels will also appear.

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.

224

IBM Workplace Collaboration Services 2.6.1 Release Notes

Sharing a database application when data definition is open If you share a database application while data access designer is open, and while any design editor (data definition, forms, grids, reports) is open for that database application, you will get an error message when you either close the design editor or close data access designer. In addition, if you attempt to use the open the design editors to make any design changes after sharing that application you will receive the same error. These errors do NOT indicate a loss of existing design info, but further edits require that you simply close and re-open the design editors for those design elements.

To prevent getting any error messages, close any open design editors for a database application prior to sharing it.

Simple combination boxes do not display correctly After creating a combination box on a form and selecting 'simple' as the style in the attributes editor in data access designer, the simple combination box incorrectly displays as a normal combination box when viewing the form in data access designer, printing, and previewing printouts. However it displays correctly in data access viewer. A normal combination box displays as a text box with a button that drops down a list of values when clicked. Once a value is selected, the list disappears. A simple combination box displays as a normal combination box with a drop-down list but with no button to hide the list.

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.

Strikeout and Underline font effects not working In data access designer, the font effects Strikeout and Underline, available for a control through the Font tab in the attributes editor, are not working in this release. If you select Strikeout or Underline, that choice will not save when you close the Font dialog box.

Triggering an On Hint event on a control When in a design element in data access designer, you can assign Hint text to a control by adding text to the Hint field in the control's attributes. To have the assigned Hint text appear in data access viewer, you should be able to use an On Hint event that can be activated with a Trigger Event simple action. If you use an On Hint event that uses a Trigger Event simple action, the Hint text that is supposed to appear for a control will not appear, but any additional actions that are associated with the event will be performed.

However, if you hover the mouse over a control that has Hint text assigned to it, then the On Hint event will work, any actions will be performed, and Hint text will appear.

225

IBM Workplace Collaboration Services 2.6.1 Release Notes

Using the Set Value simple action When designing a form in data access designer, if you use the Set Value simple action, note that a user using the form in data access viewer will not be prompted to save the changes that are made from the Set Value simple action. If you use the Set Value simple action, make sure the user knows that the form must be saved. Or make sure that the Set Value simple action only occurs when other values are changed or reverted, which will enforce the user to save. Otherwise, the data entered from the Set Value simple action could get lost.

XPath id() function not working as expected The XPath id() function in data access designer appears as a function that can be used in a computed field, but id() is not working as expected in this release. Using the id() function will result in an "illegal binding" error when the form is run.

Activity Explorer issues

'Esc' key does not dismiss the 'Create shared object' dialog In the "Create shared object" dialogs, the 'Esc' key does not dismiss the dialog if the cursor is in the member field.

Workaround Tab to another field, and then press the 'Esc' key, or use Alt + F4 to dismiss the dialog.

Cannot use paste on Linux client to create shared file responses Using a Linux client, you cannot create a response to an existing shared object by pasting a file from the file system.

Workaround Drag and drop the file from the file system onto the existing shared object.

Create shared file dialog appears behind the desktop When dragging a file onto a contact to create a shared file, you may notice the "Create shared file" dialog appears behind the desktop.

Workaround Click on the dialog to give it focus.

226

IBM Workplace Collaboration Services 2.6.1 Release Notes

File-->Preferences... does not show Activity Explorer settingsFrom a client perspective other than Activity Explorer, if you select File -> Preferences . . . from the menu,you do not see Activity Explorer settings.

WorkaroundSwitch to Activity Explorer and select File -> Preferences . . .

Help graphics do not display in some topicsIt has been reported that in localized versions of the Activity Explorer Help, some topics are missinggraphics. A placeholder displays in the location where the missing graphic belongs.

The following topics are effected:

Activity Explorer: The exclamation point icon in the last paragraph does not display.

Activity Explorer -> Shared objects -> Shared screens: In the first paragraph, the camera icon does notdisplay.

Working with activities and objects ->Activity Views->Identifying new objects In the first bullet, the newshared note icon does not display. In the second bullet, the exclamation point icon does not display.

Working with activities and objects -> Capturing a screen area to share : In Step 7 the camera icon does not display.

Working with people -> Identifying active people : In the first bullet, the icon representing a member withan opened object does not display.

In ND environment previewed objects retain active (green) statusIn a Network Deployment, when a user previews an object and then leaves it idle, the object continues todisplay as "Active" on the desktops of its other members. To indicate that an object is active, ActivityExplorer displays a green background around the object icon. An object becomes active in one of twoways: when a member opens the object, or when a member previews the object -- that is, when amember selects the object so that the object's content displays in the Preview pane (for 30 seconds, bydefault).

When an object becomes active as the result of being previewed (rather than opened), its status shouldeventually return to inactive. By default, the return to inactive status occurs after the object is idle for 60 seconds.

WorkaroundFrom the Activity List tab, click Refresh.

Modification data for some objects is not updated properlyThe modification times and modified by values for persistent chats and shared screens are not alwaysupdated properly. This problem is scheduled to be fixed in a future release.If the modification date andmodified by values are not updated properly, you might be able to restore the correct values by clickingRefresh from the Activity List pane.

227

IBM Workplace Collaboration Services 2.6.1 Release Notes

Persistent chat window opens behind desktop on Linux client When initiating a persistent chat on a Linux client, the chat window may open behind the desktop.

Workaround Use Alt-Tab to bring the Chat window into the foreground.

Remove yourself as last member of a shared object Users may find that if they remove themselves as the last member of a shared object, nothing happens.

Workaround Removal of the last member of a shared object is prevented; delete the shared object instead.

Shared object does not disappear after removing yourself If you remove yourself from a shared object with no responses in an activity thread, the shared object shows up as a restricted object when it should disappear.

Workaround Refresh the activity list and the restricted object will disappear.

Users in cluster cannot use shared files after upgrade In cluster environments, after upgrading all nodes from 2.5.1 to 2.6, users cannot initiallly perform any actions on shared files created before the upgrade. The first time a user attempts to open, replace, or save a shared file, nothing happens. However, subsequent attempts to perform these actions are successful.

This problem occurs in an upgraded clustered server environment only. The problem does not affect single-server environments, or newly-installed 2.6 clusters.

228

IBM Workplace Collaboration Services 2.6.1 Release Notes

Chapter 4 - Documentation updates

IBM Workplace Information Center

Configuring Workplace Designer to use DB 2 for iSeriesThe following two topics in the IBM Workplace Collaboration Services Information Center have beenupdated:

z In the table of contents, click Installation > Single-server deployment > Phase 7: Completing setup of Workplace Collaboration Services components > Completing Workplace Designer setup in a non-clustered environment > Configuring Workplace Designer databases > Configuring Workplace Designer to use with DB 2 for iSeries

z In the table of contents, click Installation > Clustered-server deployment > Phase 7: Completing setup of Workplace Collaboration Services components > Completing Workplace Designer setup in a clustered environment > Configuring Workplace Designer databases > Configuring Workplace Designer to use with DB 2 for iSeries

Following is the updated content; it includes both single-server and clustered-server deployment:

Configuring Workplace Designer to use with DB 2 for iSeriesThis topic provides steps for configuring Workplace™ Designer to use with DB2 for iSeries. These stepssupplement the information in the IBM Workplace Designer > Data > Databases and IBM WorkplaceDesigner > Components > Deploying components sections in the Workplace Designer online help.

Take the following steps:

1. Tell the Workplace Designer developer to type the following information in the Database tab of the deployment profile:

a. In the Type field, select DB2 iSeries. b. Be sure that the name you type in the User name field is the same as the owner of the

DB2 iSeries tables. c. Make sure that User-defined JDBC URL is selected. d. In the URL field, type the URL of the form in this format: jdbc:as400://host /schema ,

where host is the name of the host and schema is the name of your schema. e. Leave the Driver class field blank. It will default to

com.ibm.as400.access.AS400JDBCDriver.

229

IBM Workplace Collaboration Services 2.6.1 Release Notes

2. Locate the JDBC driver file called jt400.jar located in the /qibm/proddata/http/public/jt400/lib directory and copy it to the following directory:

workspace_directory \applications\com.ibm.workplace.designer.corelibs. feature\eclipse\plugins\com.ibm.workplace.designer.corelibs_1.0.0.00x\jd bc

where workspace_directory is the Workplace Designer workspace directory. You may need to restart IBM Workplace Managed Client to allow it to find the JAR file.

Note: The workspace directory is where your user information is stored, for example your user ®

credentials. The default location for Windows is C:\Documents and Settings\user_name \IBM\RCP\number\user-name, where user-name is your Windows user name and number is a unique number for your version of Workplace Designer.

3. Create a schema on the database system using the STRSQL command and the CREATE SCHEMA schema-name SQL statement, where schema-name is the name of the schema. This is the schema that will be used with Workplace Designer, as specified above.

Note: If you use CRTLIB to create the schema instead of STRSQL, you may get the following error message: java.sql.SQLException: [SQL7008] table_name in database_name not valid for operation. You can resolve this by enabling journaling for your library and the tables contained in it.

4. If the user that created the schema above is also the JDBC database user, then skip to the next step. Otherwise run the following commands to set permissions that allow the JDBC database user to access the schema from the Workplace application:

CHGAUT OBJ('/qsys.lib/<schema_name> .lib') USER(<db_user_name> )DTAAUT(*RWX) OBJAUT(*ALL), where <schema_name> is the name of the schema and <db_user_name> is the database user name.

CHGAUT OBJ('/qsys.lib/<schema_name> .lib/*') USER(<db_user_name> )DTAAUT(*RWX) OBJAUT(*ALL), where <schema_name> is the name of the schema and <db_user_name> is the database user name.

5. Issue the following command to grant public access to the root directory of any shared subdirectories you created for the server applications: chmod -R 777 <cluster_shared_directory_root> /designer, where <cluster_shared_directory_root> is the name of the root directory.

® ®For more information about i5/OS , see the IBM eServer™ iSeries™ Information Center at:

http://publib.boulder.ibm.com/iseries/.

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.

230

IBM Workplace Collaboration Services 2.6.1 Release Notes

i5/OS: New cluster backup/restore functions availableNew functions are available via iFix for backing up and restoring clustered environments on i5/OS. Previously, the backup and restore scripts provided with Workplace Collaboration Services only workedfor non-clustered environments.

For more information, see technote 1243921: "Guide for Cluster Save/Restore Support."

IBM Workplace Collaborative Learning

Procedure for getting CLIMP to work with SSLFor CLIMP to work with an SSL-enabled system (Note: variables are shown in bold text):

z Accept the self-signed certificate

1. Navigate to the server https://SERVERNAME.ibm.com/lms-lmm using Internet Explorer

2. When the certificate dialog "The security certificate was issued by a company you have chosen not to trust . . ." appears, click 'View Certificate'

3. Click the 'Details' tab

4. Click "Copy to file"

5. Go through the wizard and export the certificate to the CLIMP\Utils\BIN directory; name the file CLIMPSSL.cer

z Run the keytool utility

1. In the command prompt, navigate to the CLIMP\Utils\bin directory

2. Enter ..\java\jre\bin\keytool -import -file CLIMPSSL.cer -keystoremystore.jks -alias SERVERNAME -trustcacerts

3. Enter CLIMPPASS as the keystore password

z Modify the run4.cmd file

Add the following to the run4.cmd file: -keystore mystore.jks -storepass CLIMPPASS

So a sample command in step 3 that you would run might appear as follows:

-climp -cm https://SERVERNAME.ibm.com/lms-lmm/import -d -p climp.properties -u -keystore mystore.jks -storepass CLIMPPASS -e Username@ibm.com C:\course.zip

You can now use CLIMP to import into an SSL environment.

231

IBM Workplace Collaboration Services 2.6.1 Release Notes

To CLIMP to an SSL-enabled system from a Linux client machine

1. Get the Security certificate from the Internet Explorer browser. Copy it to the Linux client machine, into the CLIMP/utils/bin folder

2. Follow the steps as mentioned above: Run the keytool utility, and Modify the run4.cmd file

Before running climp.sh for the first time As root:

z Make sure climp.sh is executable with "chmod a+x climp.sh"

z Run CLIMP from the directory where it is stored, for example:

./climp.sh -d -cm https://SERVERNAME.ibm.com/lms-lmm/import -cmu wpsadmin -cmp wpsadmin -keystore mystore.jks -storepass CLIMPPASS -ftpFTPSERVERNAME.ibm.com -ftpu ftpuser -ftpp =ftp=1 -e Username@ibm.com -u /path_to_course/course.zip

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 Collaboration Services and those that can be defined and searched in IBM Workplace Collaborative Learning (WCL).

Skills defined through the Workplace Collaboration Services user interface (which are placed into the skills dictionary) are the only ones that can be searched in Workplace Collaboration Services. 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 Workplace Collaboration Services and it is not accessible in a WCL user search: it is only relevant in an instructor search in the Resources module.

IBM Workplace Managed Client

Linux permission error in WMC documentation The Workplace Managed Client failed to download when the permission on the Linux server were set to "644" (as was specified in the version 2.6 Workplace Managed Client release note) for the following subdirectories: /opt/IBMIHS/htdocs/en_US/lwpupdate /opt/IBMIHS/htdocs/en_US/lwpinstall

If the permission is set to "755" the installer is downloaded. The correct Linux permission setting is 755.

232

IBM Workplace Collaboration Services 2.6.1 Release Notes

Plug-in Help not provided for some client plug -insNo 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

Digest authentication does not work for Instant Messaging The topic "Instant Messaging Authentication" provides instructions for using digest authentication to encrypt passwords during a chat session initiation. Digest authentication is not supported in IBM Workplace 2.0. SSL encryption, which is configured by default, is used to encrypt the passwords and data transferred during IBM Workplace Instant Messaging chats.

Enabling non-wpsadmins to manage client certificatesTo enable a user who is not a member of the wpsadmins group to manage certificates in the WorkplaceClient 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.

233

IBM Workplace Collaboration Services 2.6.1 Release Notes

Issuing user credentials through a Certificate Authority The IBM Workplace Managed Client 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.

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 theserver, and may prevent subsequent certification requests from being generated. Also, any namemapping rules needed for the configured CAs must be provided - please see the IBM Workplace Helpdocumentation for more details.

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 ApplicationServer 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 WebSphereApplication 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 byissuing 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.

234

IBM Workplace Collaboration Services 2.6.1 Release Notes

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.

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. z To use the pop-up toolbar, press Ctrl+Shift+M. z To use the foreground color picker, press Ctrl+Shift+G. z To use the background color picker, press Ctrl+Shift+J. z To use the insert table dialog box, press Ctrl+Shift+T.

Not all additional doc links in online help work properly Additional documentation links that appear at the bottom of some online help topics point to old pages or incorrectly refer to "Lotus Documentation".

Workaround To find the latest Workplace Collaboration Services documentation, use:

http://www.ibm.com/developerworks /workplace.

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.

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:

z 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.

235

IBM Workplace Collaboration Services 2.6.1 Release Notes

IBM Workplace Collaborative Learning

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.

Catalog search topic contains an error The documentation for searching the Course Catalog incorrectly states that when you separate words with a "+" in order to search for courses containing all of those words the "+" should not be preceded by a space. In fact, each "+" must be preceded by a space (for example Nepal +ferocious +tigers).

Note also that the name of the field in which a multiple keyword search is supported is Search all, notSearch For.

My Learning Interests only includes recommended jobsThe documentation incorrectly states that My Learning Interests can include skills, subjects, groups, ordepartments. This feature has not been implemented.

IBM Workplace Managed Client

Switcher bar graphic in Help not currentIn the Help topic "Navigating IBM Workplace Managed Client," there is a screenshot of IBM Workplace Managed Client. The version of the Switcher bar that is being shown in the graphic is not current.

z The order of icons in the Switcher bar is different in the Managed Client than what is being shown in the graphic.

z By default, Web conferences and Learning are not accessible and do not display in the Switcher bar. z The 3270 Emulator icon is not a feature in this release.

IBM Workplace Web Conferences

Web conferencing Help issuesThe Help topic, "Web Conference Information," in the Web conference information Help states thatconference attendees can view Web conference information. In fact, all attendees - chairs, presenters,and participants - can view Web conference information.

236

IBM Workplace Collaboration Services 2.6.1 Release Notes

IBM Workplace Managed Client Help

Accessibility, Keyboard commands - Help update The "Accessibility" topic should contain the following, additional information:

Windows StickyKeys is supported in IBM Worklplace Managed 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.

Activity Explorer: Adding members to a shared object The following information should be included in the topic "Adding and removing members" in the Activity Explorer section of the Managed Client help.

You can use drag and drop to add a member to a shared object that is displayed in the Activity Thread pane, Activity List tab, or Activity Tree tab. Drag a contact's name from the Instant Contacts pane and drop it on the object to be shared. After you complete the information in the Add New Members dialog box, the contact is added to the membership list for the object.

To add multiple members at one time, use SHIFT-click or CTRL-click to select two or more contacts, and then drag the selected names to the object.

Calendar Help correction To open the tabbed calendar you must first click Messaging (rather than My Mail), if necessary, before clicking Calendar.

File -> Work Offline toggle A Workplace Managed Client help screen states that you can toggle between online and offline using File --> Work Offline and File --> Work Online; there is, in fact, no File --> Work Online menu item. Selecting File --> Work Offline will switch the client between online and offline states.

237

IBM Workplace Collaboration Services 2.6.1 Release Notes

Incorrect description of Team Spaces being available offline The Team Spaces catalog displays an Available offline column, even though team spaces are only available online. The help topic that describes the Application catalog incorrectly describes this. The help topic should say:

In the Available Offline column, the following two icons indicate the offline status of each database application (team spaces are not available offline):

the application is available offline. You either created this application locally or made a shared application available locally. the application is available online only. You will have to make the application available offline in order to access it.

Launching of Web Conferences and Learning in 2.6 Neither the Web Conference nor Learning applications are supported by the internal web browser provided with the Managed Client in 2.6, due to Java limitations. When you select 'Web Conferences' or 'Learning', the Managed Client will launch an external browser instead; on Windows, Internet Explorer will be launched and on Linux, Mozilla will be launched.

Logging in procedure reflects outdated login screen The procedure documented in the topic entitled "Logging in" in the "Welcome to IBM Workplace Managed Client" section of online help is incorrect in that it references an outdated user interface. The steps should read as below:

1. Double-click the Workplace Managed Client shortcut on your desktop or start the program using your UNIX procedure. Note: If you used File > Preferences > Security to request operating system single sign-on, skip steps 2 and 3.

2. Type your password. When you are ready to log in, click Login.

3. Optional: Click Options to display the following choices: -- Automatically connect to network - Check this option to log in and work in online mode. Uncheck to log in and work in offline mode. -- Automatically log in to instant messaging - Check this option to enable instant messaging. Uncheck to disable instant messaging. If you checked both options above, specify a display status in the IM status field.

4. Optional: If instructed by your administrator, click Connectivity to change connection settings then click Apply and OK. -- Host name specifies the server name used during data synchronization. It can be the server from which you downloaded and installed the client. It can also be the update, or provisioning, server. -- Port corresponds to the port setting on the IBM WebSphere® Portal server that your client connects to. -- Managed Client URL specifies the update, or provisioning, server. Note: The IBM Workplace Collaboration Services Information Center describes the Connectivity functions.

5. If a security warning appears, you may click Trust this certificate and OK and then contact your administrator for details.

6. If the system detects that there are updates available and you are prompted to accept the updates,click OK to install the updates on your machine.

238

IBM Workplace Collaboration Services 2.6.1 Release Notes

Lotus Notes, document libraries, and the IBM editors If you use Lotus Notes within the Managed Client, you can save attachments to a document library within the Managed Client and you can attach files from document libraries to Notes documents. Additionally, you can use the IBM editors available in the Managed Client to view and edit files attached to Notes documents.

Mail and offline Managed Client help corrections On the main Mail page for Managed Client Help, the sentence "If you choose to work online, the mail in your Inbox will be based on the latest server version." should be replaced with "If you choose to work online, the mail in your Inbox will also be based on the data stored on your local drive. However, when a feature requires data that is only available on the server, the client will contact the server for it."

On the Welcome to IBM Workplace --> Working Offline page, the following changes are needed:

-- The final bullet should read "Use the type-ahead feature to address messages. As you type a name in an address field, the type-ahead feature finds the name, based on the letters that you type." The mail application populates the type-ahead feature with names found in the user's mail Inbox.

-- The term "Links" should be removed from the page.

Note that the smart type-ahead feature is available in online and offline modes when addressing mail. Also note that in both online and offline modes, the client works with local data, although in online mode it will connect to the server to access server-only data.

Switch from standalone productivity tools to server -based WMC The menu option Connect to server enables a standalone IBM productivity tools user to switch to an IBM Workplace Managed Client environment, provided that the environment is available to that user. If you have installed the standalone productivity tools and the Workplace Managed Client framework from a CD-ROM or HTTP server, you can use this menu option to associate your client with an IBM Workplace Collaboration Services server. The Workplace Collaboration Services server will then take over management of your client and provision any additional applications that your administrator has established in your user policy.

When you first click Connect to server , the application displays the login and provisioning configuration page containing the user name, password, and Server URL fields. The administrator should set the default URL value using the plugin_customization.ini file. The application then downloads, installs, and enables any applications (to which your user policy permits) that are not already installed. The next time you click the Connect to server menu option, Workplace Managed Client will start, if it is not already running, or will appear with focus if it is already running.

Note to administrators: If possible, the administrator should pre-configure the CD or HTTP-provisioned Workplace Managed Client framework and Productivity Tools with the address of the Workplace Collaboration Services server to which the user should connect. In this way the server URL field would be pre-populated and the user would not need to know or enter that value. The default URL should be set using the plugin_customization.ini file, typically located at com.ibm.workplace.configuration/defaulturl=http://yourserver/lwp/myworkplace. For a CD installation of Productivity Tools, the plugin_customization.ini file must be next to the client installation program on the CD. For an HTTP installation of Productivity Tools, the download applet used for the client installation program must be configured so that it downloads or creates a plugin_customization.ini file that is placed next to the client installer before the client installer is launched.

The user's Internet browser must be Java-enabled. Choosing to save the file to disk rather than running the installation program from the HTTP server will only download the installation program (.exe or .bin) and will not download the necessary plugin_customization.ini file.

239

IBM Workplace Collaboration Services 2.6.1 Release Notes

"Working with bookmarks" Help correction To open a bookmarked item, single-click the bookmark rather than double-click it.

IBM Workplace Documents

Duplicate Help pages The topic "Welcome to the Word Processing Editor Help" displays multiple times in descending levels of the table of contents (Help -> Help topics).

The topic text appears three times in all descending levels of the first-level subtopics in this section, with the exception of "Common Help Topics".

Topics also appear in duplicate, and sometimes triplicate (e.g., Command Reference) for most, but not all, of the second-level topics in the table of contents, for example, "Creating Word Processing Documents".

Extended tips cannot display in "Preference" dialog The Extended Tips aren't able to be displayed in the Preference dialog

Failure to locate help page in 'Create -> Graphics' dialog In the "Create -> Graphics" dialog, clicking the "Help" button does not load the correct Help page.

Incorrect Help title for chart object bar In Help, the title for the Chart Object Bar incorrectly reads as "Main Toolbar".

No general introduction page for IBM productivity tools Help In the Help table of contents, no text displays when the book for "IBM Productivity Tools" is selected.

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:

z Save as saves an open file with a new file name or path that you specify to a local directory. z New creates a new file in the document editor. z Open opens an existing file that you select in the document editor.

240

IBM Workplace Collaboration Services 2.6.1 Release Notes

Template support in Workplace Documents There are no standard templates included with Workplace Documents, but you can import any existing templates that you have into a document library.

Creating documents from templates If you have selected IBM productivity tools as your preferred tools for creating documents, you can create a document from a template. If you select a template that is not an IBM productivity tool file type, the template might contain features that you cannot save including:

z Macros and form controls z Spreadsheets over 32000 rows

In addition, formatting, layouts, animations, spreadsheet formulas and sorting results might change. The IBM productivity tool file types for templates are .ott, .otp, .ots, .stw, sti, and .stc.

Follow these steps to create a document from a template:

1. Right-click the template that you want to use to create your new document. 2. Click New Document from this Template. 3. When you finish working in the document, perform one of the following actions to save the

document. You can save the document in a location different from the template location.

Task Action

Save the document but keep it open so that you can continue to work on it. Click Save.

The document becomes visible in the library. If locking is enabled, the document locks so that others cannot edit it while you continue to work on it.

Save and then close the document Click Save and Close.

Editing templates You can edit a template in a library if the following conditions are true:

z Your administrator has given you permission to use the IBM productivity tools. z You have selected IBM productivity tools as your preferred tools for creating documents. z The library owner has given you access to create and edit documents.

If you are working online and locking is enabled, when you edit a template the template automatically locks so that another person cannot edit the template while you are editing it. To lock a template manually, right-click the template and choose Lock.

If you edit a template is not an IBM productivity tool file type, you cannot save the template in its original format. Save the templates as the file types specified in the following table:

Template File types

Word processing .ott, .stw

Presentation .otp, .sti

Spreadsheet .ots, .stc

Note: Saving a template in a different file type might result in the loss of formatting and content.

241

IBM Workplace Collaboration Services 2.6.1 Release Notes

Follow these steps to edit a template: 1. Right-click the template that you want to edit. 2. Depending on the template type, you are presented with one of the following options: .

z Click Edit if its an IBM productivity tool template. z Click Edit with > IBM Productivity Tool for other template types.

3. When you are finished working in the template, perform one of these actions:

Task

Save the template but keep it open so that you can continue to work on it.

The template remains locked so that others cannot edit it while you continue to work on it.

Save and then close the template

Save the template as a private draft

Save the template as a new template in a different folder or library

Save the template as a new template or document with a different file type.

Action

Click Save.

This action only is available if the template can be saved in its original format.

Click Save and Close.

This action only is available if the template can be saved in its original format.

Click the arrow beside Save, and then click Save as Private Draft.

This action only is available if the template can be saved in its original format.

1. Click the arrow beside Save, and then click Save as New Document.

2. Select the folder, and then click OK.

1. Click the arrow beside Save, and then click Save as New Document.

2. Select the file type, and then click OK.

Note: If you want to edit a library template using an editor other than an IBM productivity tool, you can export a template from the library by downloading and saving it to the file system on your local machine. Edit the template and then import it back to the document library.

Macro conversion When you save a Microsoft Office template as an IBM productivity tool template, Microsoft Office macros are not converted. The macro code is saved, but it is commented. You can use the Macro dialog to determine the Microsoft Office macros that need to be recreated in your IBM productivity tool template.

1. Right-click a Microsoft Office template. 2. Click Edit with > IBM productivity tool. 3. Select Tools > Macros > Macro.... 4. Click NewMacros in the Macro from box. 5. Click Edit. The code for Microsoft Office macros that have not been converted displays

commented.

242

IBM Workplace Collaboration Services 2.6.1 Release Notes

Here is an example of a macro created in a Microsoft Word template that has been saved as the IBM Word Processing Document template. The macro has been saved and commented, but not converted. Sub NewMacros Rem Sub searchlist()Rem ' Rem ' searchlist Macro Rem ' Rem k = 0 Rem Do Rem Selection.PasteAndFormat (wdPasteDefault)Rem Selection.MoveDown Unit:=wdParagraph, Count:=1Rem k = k + 1 Rem Loop Until k > 800Rem End Sub Rem End Sub

Replacing text form fields When you save a Microsoft Office template as an IBM productivity tool template, text form fields are not converted. Text form fields are "fill-in" fields where users can type text. These fields are typically labeled "Click here and type...." As a workaround, these fields can be removed and replaced with normal text.

1. Right-click a Microsoft Office template. 2. Click Edit with > IBM productivity tool. 3. Select a text form field, and click Delete. 4. Enter the text that you want to replace the text form field.

For example, you can replace a "Click here and type your name" text form field, with normal text that displays "Type your name."

The content on the Help page "Change" is incorrect In the text shown under 'Insertion' of the Help page "Change", it reads: "Specifies the color to highlight deletions in a document".

The word "deletions" here should be changed to read "insertions".

IBM Workplace Designer

Associating standalone Workplace Designer to provisioning server If you are using the standalone version of IBM Workplace Designer and want to associate it with an IBM Workplace Collaboration Services server in order to provision applications through the IBM Workplace Managed Client, click Switch to Managed Client from the Workplace Designer Help menu.

The first time you click Switch to Managed Client , Workplace Designer will prompt you for the URL of the Workplace Collaboration Services server as well your user name and password. Once you connect to the server, any applications that are available to you (per your user policy) will provision down to your client.

If you have already associated your standalone version of Workplace Designer with a Workplace Collaboration Services server, you can click Switch to Managed client either to launch the Workplace Managed Client or bring the client into focus on your machine if it is already running.

243

IBM Workplace Collaboration Services 2.6.1 Release Notes

Configuring databases to use with Workplace Designer The IBM Workplace Designer > Data > Databases section in the online help provides instructions for configuring databases such as DB2, DB2 iSeries, SQL, and Oracle to use with Workplace Designer. However, since publishing those topics, several updates have occurred. For the most up-to-date information, see the Installation > Single-server deployment > Phase 7.0: Completing Workplace Designer setup and Installation > Clustered-server deployment > Phase 7.0: Completing Workplace Designer setup sections in the Workplace Collaboration Services 2.6 Information Center, located at:

http://www.ibm.com/developerworks/workplace/documentation/collaborationservices

Configuring Oracle: Help file has incorrect download location In the IBM Workplace Designer > Data > Databases > Configuring Workplace Designer to use Oracle help file, the download location for the JDBC driver is incorrect. The step should read as follows:

3. Download it toapplications\com.ibm.workplace.designer.corelibs.feature\eclipse\plugins\com.i bm.workplace.designer.corelibs_1.0.0.005\jdbc under your Workplace Designer install.

Creating a template for a deployed Call Center sample component The following steps provide instructions for creating and configuring a Workplace application template for a Workplace Designer component based on the Call Center sample component. Before you start, you must deploy your component to the Workplace application server. Be sure to take note of the component name; you will need to refer to it later.

Step 1: Create the Workplace application template . 1. Log in to the Workplace application server as a user with the following two options enabled in your userpolicy (see your Workplace administrator for more information):

- Allow users to create and edit Workplace templates - Allow Workplace applications

2. Click Templates at the top of the page. 3. Click New to begin creating a new template. 4. In the Application template name field, type an application name. 5. In the Category field, select Workplace Application in the drop-down list. 6. In the Starting point field, select Blank Template (default). 7. Click OK.

Step 2: Create and configure the Call Center and FAQs pages in the Workplace application . 1. Click Pages and Layout . 2. Delete Page 2 and Search from the list of pages using the trash can icon to the right of each page title. Members should be the only remaining page. 3. Take the following steps to create the Call Center page:

A. Click New Page to open the page editor. B. In the Title field, type Call Center. C. For the Choose a layout option, click the single-portlet layout (the solid box). D. Click Add Portlets inside the single box. E. In the Search For field, type the name of the Workplace Designer component and click Search.

The component should appear in the portlet list. F. Check the check box next to the portlet name and click OK. The page layout page appears. G. Click OK to return to the template editor.

244

IBM Workplace Collaboration Services 2.6.1 Release Notes

4. Take the following steps to create the FAQs page: A. Click New Page to open the page editor. B. In the Title field, type FAQs. C. For the Choose a layout option, click the single-portlet layout (the solid box). D. Click Add Portlets inside the single box. E. In the Search For field, type the name of the Document Manager component and click Search.

The component should appear in the portlet list. F. Check the check box next to the portlet name and click OK. The page layout page appears. G. Click OK to return to the template editor.

5. Change the page order to the following order by using the up and down arrows to the right of the pagetitles:

- Call Center - Members - FAQs

Step 3: Create the Call Center Manager role and set the level of access .This step creates a role and sets the level of access for Call Center managers who work with Call Centerdocuments and manage members.

1. Click Roles on the right side of the page. 2. Delete the Contributors role using the trash can icon to the right of the role name. Moderators should be the only remaining role. 3. Click New to create the Call Center Manager role. 4. In the Role name field, type Manager. 5. In the Description field, type Call Center Manager. 6. Check the Members of this role can manage members check box. 7. Use the following table to set the levels of access for the Call Center Manager role:

Note: For more information about levels of access, see the information at the end of these steps. Pages and Components Level of Access Call Center (page) User Call Center Administrator Members (page) User FAQs (page) User Document Library Manager

8. Click OK to save the new Call Center Manager role.

Step 4: Create the Call Center Agent role and set the level of access .This step creates a role and sets the level of access for Call Center agents who work with problem tickets.

1. Click New to create the Call Center Agent role. 2. In the Role name field, type Agent.3. In the Description field, type Call Center Agent.4. Use the following table to set the levels of access for the Call Center Agent role:

Note: For more information about levels of access, see the information at the end of these steps.

Pages and Components Level of Access Call Center (page) User Call Center Editor Members (page) User FAQs (page) User Document Library Editor

245

IBM Workplace Collaboration Services 2.6.1 Release Notes

5. Click OK to save the new Call Center Agent role.

Step 5: Create the Call Center User role and set the level of access . This step creates a role and sets the level of access for Call Center users who open problem tickets.

1. Click New to create the Call Center User role. 2. In the Role name field, type User.3. In the Description field, type Call Center User.4. Use the following table to set the levels of access for the Call Center User role:

Note: For more information about levels of access, see the information at the end of these steps.

Pages and Components Level of Access Call Center (page) User Call Center Author Members (page) No Access FAQs (page) User Document Library Reader

5. Click OK to save the new Call Center User role.

Step 6: Save the template.

Click Save and Close at the top of the page. The template is complete and ready to use as a starting point for creating new Workplace applications.

Levels of access

The User role allows users to do the following actions: z read all tickets z create tickets z edit tickets they created or are assigned as the Customer z read all FAQs

The Agent role allows users to do the same actions as the User role, plus the following: z edit any ticket z open a new ticket z close an open ticket z create a FAQ from a ticket z create FAQs directly inside library z view current members

The Manager role allows users to do the same actions as the Agent role, plus the following: z delete FAQs z add/remove application members

The Administrator role allows users to do the same actions as the Manager role, plus the following: z modify the Workplace application (delete, add new portlets, change roles, etc.)

246

IBM Workplace Collaboration Services 2.6.1 Release Notes

Deploying to a cluster: How to activate your portlets In the IBM Workplace Designer > Components > Deployment > Performing Manual Deployment help file, the second bullet in Step #6 doesn't mention how to synchronize the application across all nodes in the cluster and activate the portlets after you deploy the WAR file. Here is the updated content:

After deploying the WAR file, replicate your WebSphere Portal applications to all application nodes in the cluster. Next, take the following steps to ensure that each application is successfully synchronized across all nodes in the cluster and that the portlets are activated (use the WebSphere Portal documentation for more detailed steps).

a. Open the administrative console for the WebSphere Portal Deployment Manager.

b. Click System Administration > Nodes . c. Select all the nodes in the cluster. d. Click Synchronize. e. Click Applications > Enterprise Applications . f. For each individual application, select the portlets. g. Click Start to start the application. h. Click Administration > Portlets > Manage Applications . i. In the Web Modules list, select the application. j. Select the portlets for the selected application. k. Click Activate/Deactivate.

Missing information about manually deploying to a clusterIn the help topic called Performing manual deployment (click IBM Workplace Designer > Components >Deploying components > Performing manual deployment ), step 7d should read as follows:

Paste the file into the \WebSphere\AppServer\installedApps\<cell-name>\wps.ear\wps.wardirectory, where <cell-name> is the cell name of the application server. If you are deploying to aclustered environment, you must copy this file into the\WebSphere\AppServer\installedApps\<cell-name>\wps.ear\wps.war directory on eachnode of the cluster.

IBM Data Access Tool

Default value needed for primary keys when using auto -save If you enable auto-save in a form, the data entered in the form in data access viewer will be saved each time a change is made in the form, including when new records are created. However, primary key fields must contain unique data in order for the record to be saved. To make sure auto-save works correctly, you must specify a default value expression for all primary key table columns that will automatically generate a unique value for the primary key field.

247

IBM Workplace Collaboration Services 2.6.1 Release Notes

New custom XPath functions The following four new custom XPath functions are available to use in Data access:

Record Functions

number ibmforms:record-index()The ibmforms:record-index function returns the index of the current record.

number ibmforms:record-count()The ibmforms:record-count function returns the count of records. Note: Any records that are currentlyhidden or not included in the filtered set are not included in this count.

NodeSet ibmforms:current-record()The ibmforms:current-record function returns a NodeSet containing all of the values in the current record.

NodeSet ibmforms:current-table()The ibmforms:current-table function returns a NodeSet containing all of the values in the current table. Note: All records are included in this nodeset even if they have been hidden or are not included in thefiltered set.

Right-arrow and left-arrow icon references in HelpThroughout data access designer Help, there are references to use the right-arrow or left-arrow icons to move items from one list to another list. The right-arrow and left-arrow icons have been replaced with add (+) and remove (-) icons. The double right-arrow or double left-arrow icons have been replaced with add all (multiple + signs) and remove all icons (multiple - signs).

Updated description of icons in Application catalogIn the help topic that explains the Application catalog, a table incorrectly describes the icons in theAvailable offline column. The table should look like this:

the application is available offline. You either created this application locally or made a shared application available locally. the application is available online only. You will have to make the application available offline in order to access it.

248

IBM Workplace Collaboration Services 2.6.1 Release Notes

IBM Workplace WebSphere Administrative Console Help

Allow import or export of files for Managed Client users only In the topic, User Policies: Primary Details, you can enable Managed Client users only to import or export files.

z Allow import of files - Select this setting to allow Managed Client users to import files into document libraries. The default setting is selected.

z Allow export of files - Select this setting to allow Managed Client users to export files from document libraries to a file system. The default setting is selected.

Document formats supported as trusted mail attachments When configuring user policy settings that apply to IBM Workplace Managed Client mail attachments, the following default file extensions are accepted as attachments in mail: jpg, bmp, gif, tif, txt, rtf, pdf, zip, mpp, ppt, xls, prz, 123, lwp, wpm, sxi, sxc, sxw, odt, ods, odp.

Enabling archiving in the Administrative Console The Adminsitrative Console help topics, Archive Custom Properties, does not mention that you must set the directory path for the ZIP archive system by editing the DefaultZipMessageArchivePath path in IBM Workplace software > Archive > Custom Properties.

The help has been revised to include this information and is presented here:

Archive Custom Properties

DefaultZipMessageArchivePath

If you are using the default ZIP archive system, you need only set the default archive path where ZIP archive files are stored on disk.

This property describes the directory where the ZIP archive files will be stored. The default directory path is c:/temp/ziparchive, but this path should be changed to something other than a temporary directory.

® ®Modify the path directory notation accordingly if you are using an i5/OS, AIX or Linux machine. You must create the archive directory on disk before Workplace Messaging™ can archive messages.

Click IBM Workplace software > Archive, then under Additional Properties, click Custom Properties, and then click DefaultZipMessageArchivePath. In the Value field, type the directory path for the ZIP archive system.

249

IBM Workplace Collaboration Services 2.6.1 Release Notes

Using a different archive system

To use a different archive system, you must first type the name of the archiving system on the IBM Workplace software > Archive page, then add custom properties. Custom properties are particular to the archive system and its configuration needs. You need to specify three custom properties for an archive system: z Service type z Java™ class z Setup file

These three properties are stored in the lwparchive.xml file as:

<CustomProperty xmi:id="CustomProperty_1" name="ServiceType1" value="DefaultZipMessageArchive"/> <CustomProperty xmi:id="CustomProperty_2" name="DefaultZipMessageArchiveClass" value="com.ibm.workplace.mailbox.msgarchive.ZipIMessageArchiveImpl"/> <CustomProperty xmi:id="CustomProperty_3" name="DefaultZipMessageArchivePath" value="c:\temp\ziparchive"/>

Service type

The service type name is "ServiceType" with an integer appended to the name. The service type name for the default archive system is named ServiceType1. You must increase the integer as services are added. The service type name connects an archived message to the archive system that the message is stored in and the archive system's custom properties.

The service type property's value is the actual archive system name. For example, the name for the default archive system is DefaultZipMessageArchive; this name is arbitrary and used only to tie the active archive system to its set of properties.

Java class

The Java class property name is created using the value of the service type property and by appending Class to the name. For example, the value of the default archive system is DefaultZipMessageArchive. By appending Class to value, you obtain the name of the Java class property. The Java class property's value is the Java class name, for example, the JAVA class name for the default archive system is com.ibm.workplace.mailbox.msgarchive.ZipIMessageArchiveImpl.

Setup file

The setup file property describes a setup file for the archive system. This property name is created by using the value of the service type property and by appending Path to the name. For all archive systems other than the default ZIP archive system, the value for the property is the directory path and setup file name that contains the setup information required.

Name

Type the service type, Java class, or setup file name for the property.

Value

Type the string value paired with the specified name.

Description

Type information about the property name and value. This field is optional..

250

IBM Workplace Collaboration Services 2.6.1 Release Notes

IBM Workplace Designer Help

Choosing a location for an exported component The component export dialog allows you to either browse to a file system location and enter a file name, or manually enter an absolute path in the file name field. If you only manually enter a file (without browsing), or enter a relative path, the file will be placed in the last selected directory used for a component export or import. This is a convenience that allows you to quickly export several components in succession without having to browse to, or enter, a directory path each time.

However, if you have never exported, or imported, a component before, the last used directory defaults to a directory in your client workspace, so you should at least initially browse to a valid directory that you wish to export components to. The default initial export directory in the WMC client workspace is C:\Documents and Settings\<user name>\IBM\RCP\<client id>\<user name>\.metadata\.plugins\com.ibm.workplace.des.ide.ui. For example: C:\Documents and Settings\janedoe\IBM\RCP\723676099\janedoe\.metadata\.plugins\com.ibm.workplace.des.ide.ui.

Cloudscape users must edit the startNetworkServer file In the topic, "Installing IBM Workplace Designer in an IBM Workplace Collaboration Services environment," step 3 describes an edit that is needed in the startNetworkServer script file if you are using Cloudscape with Workplace Collaboration Services. The same edit is needed if you are using Cloudscape with Workplace Services Express.

Configuring Workplace Designer to use with DB 2 for iSeries This topic provides steps for an administrator configuring Workplace Designer to use with DB2 for iSeries in a single-server environment. These steps supplement the information in the IBM Workplace Designer > Data > Databases and IBM Workplace Designer > Components > Deploying components sections in the Workplace Designer online help.

For information about clustered-server environments, see the Installation > Clustered-server deployment > Phase 7.0: Completing Workplace Designer setup section in the Workplace Collaboration Services 2.6 Information Center, located at http://www.ibm.com/developerworks/workplace/documentation/collaborationservices.

Take the following steps:

1. Tell the Workplace Designer developer to type the following information in the Database tab of the deployment profile:

a. In the Type field, select DB2 iSeries. b. Be sure that the name you type in the User name field is the same as the owner of the

DB2 iSeries tables. Also, be sure that the database user has all permissions. c. Leave the Driver class field blank. It will default to

com.ibm.as400.access.AS400JDBCDriver. d. In the URL field, type the URL of the form in this format: jdbc:as400://host /schema ,

where host is the name of the host and schema is the name of your schema.

251

IBM Workplace Collaboration Services 2.6.1 Release Notes

2. For the Port field in the Workplace Application Server tab of the deployment profile, tell the Workplace Designer developer to delete the default port number (9081) and replace it with the internal HTTP port number for your instance of the Workplace application server. To locate the internal HTTP port number, take the following steps:

a. Go to http://host_name:2001/HTTPAdmin to open the iSeries HTTP Administration user interface, where host_name is the host name of your iSeries server.

b. Select Manage > Application Servers. c. In the Server field, select the WebSphere_Portal server for your instance in the

drop-down list. d. Once the page loads, select Server Ports in the left navigation bar. e. Find the internal HTTP port for your instance in the table.

3. Locate the JDBC driver file called jt400.jar located in the /qibm/proddata/http/public/jt400/lib directory and copy it to the following directory:

workspace_directory \applications\com.ibm.workplace.designer.corelibs. feature\eclipse\plugins\com.ibm.workplace.designer.corelibs_1.0.0.00x\jd bc

where workspace_directory is the Workplace Designer workspace directory. You may need to restart IBM Workplace Managed Client to allow it to find the JAR file.

Note: The workspace directory is where your user information is stored, for example your user credentials. The default location for Windows is C:\Documents and Settings\user_name \IBM\RCP\number\user-name, where user-name is your Windows user name and number is a unique number for your version of Workplace Designer.

4. Create a schema on the database system using the STRSQL command and the CREATE SCHEMA schema-name SQL statement, where schema-name is the name of the schema. This is the schema that will be used with Workplace Designer.

Note: If you use CRTLIB to create the schema instead of STRSQL, you may get the following error message: java.sql.SQLException: [SQL7008] table_name in database_name not valid for operation. You can resolve this by enabling journaling for your library and the tables contained in it.

5. Update the authentication of the database tables using the following command: CHGAUT OBJ('/qsys.lib/<schema_name> .lib/*') USER(<db_user_name> ) DTAAUT(*RWX) OBJAUT(*ALL), where <schema_name> is the name of the schema and <db_user_name> is the database user name.

For more information about i5/OS, see the IBM eServer iSeries Information Center at http://publib.boulder.ibm.com/infocenter/iseries/v5r3/ic2924/index.htm.

Database must already exist before deploying a component The topic "Databases" located in IBM Workplace Designer > Data is missing the following information:

Regardless of your database type, you or your administrator must create a database or schema (depending on your database type) to use exclusively with Workplace Designer before you can successfully deploy a component.

252

IBM Workplace Collaboration Services 2.6.1 Release Notes

Date Picker option is missing in Help topic The topic "Setting Parameter properties for components" in IBM Workplace Designer > Components is missing information in step 3d. Here is the corrected step:

Select whether the entry will be a Edit Box, Combo Box, or Date Picker (Date type only).

DB2 support for Designer This release note details how Designer can be configured to deploy to IBM Workplace servers that use a DB2 database. This does not include instructions for DB2 on iSeries.

Additional Server Configuration For DB2 UDB 8.2, some server configuration is required to add a JAR containing additional DB2 classes to the classpath. These classes are not included, so .../ibm/sqlllib/java/db2jcc.jar needs to be added to the WAS system classpath. To do this:

1. Log into the WAS admin console 2. Navigate to Servers -> Application Servers -> WebSphere_Portal -> Process Definition -> Java Virtual

Machine 3. You should see a Classpath property that already contains a path to db2java.zip. Add an entry for

db2jcc.jar in the same directory as db2java.zip 4. Restart WPS.

Client-side (JDBC) Configuration DB2 supports a number of JDBC drivers each of which requires slightly different configuration both in Designer client and on the server. One driver is a pure Java driver that communicates directly with a JDBC server that is collocated with the DB2 server. The other consists of both Java and native code and communicates with the DB2 server via client-side proxy. These are often referred as the "net" (or JDBC type 4) and "app" (or JDBC type 2) drivers respectively. There's also a 3rd driver called the "universal driver" which is not currently fully supported by Designer.

The "app" driver is typically preferred since its use of native code gives it much better performance, compared to the "net" driver. However, the "app" driver requires additional install and configuration steps on the client. It also contains native code which could potentially crash the JVM in certain error cases (although this is typically a rare occurrence).

It is recommended that you review the following for more background information:

Connectivity cheat sheet for Application Developers (Part 4) Hooking Up with IBM DB2 Universal Database Version 8 Using Java

253

IBM Workplace Collaboration Services 2.6.1 Release Notes

Configuring Designer to use the DB 2 "app" driverDesigner uses the "app" driver by default when DB2 is chosen as the database type. The configurationsteps are as follows:.

z Install the DB2 Runtime Client. This is available from the DB2 support site. The runtime client contains the native code for the "app" driver, as well as certain configuration utilities that must be run in order to "catalog" the remote databases. With the "app" driver, a remote database is referenced via an "alias" rather than directly via hostname/database name.

z Configure the catalog . Once the DB2 runtime client has been installed, you need to catalog the remote DB2 server to set up aliase(s) for the remote database(s). This procedure is documented in the "Hooking Up with IBM DB2 Universal Database Version 8 Using Java" link above..

Create the aliases. On the client machine go into the db2 command prompt by typing 'db2cmd' to open a command window and then 'db2' to enter the DB2 command interpreter. Run the following commands:

catalog tcpip node <anynodenameyouwant> remote <your_remote_server>server 50000 catalog database <db_alias_name> at node <anynodenameyouwant>

The node name must be 8 characters or less. The node is just a local pointer to your remote database server. Name it, for example, "WPDES" for "workplace designer". Make sure you have the proper server name and domain for your server. If you did a default install of DB2, your server will be listening on port 50000.

If you get an error indicating that a node or database alias already exists, perhaps from a previous run, you can see what nodes and databases you have cataloged. From a DB2 Command Line Processor, run "terminate", close the old DB2 CLP window, and open a new one. Then execute:

list database directory

Check: After running this step you should be able to connect to the WPS50 databse from your client machine. Bring up a DB2 command window and execute:

connect to <databasename> user <your_db2admin_acct> using <your_db2admin_password>

z Install the JDBC driver ZIP file in the Designer JDBC directory . The JDBC driver ZIP is called db2java.zip and can be found in the DB2 install directory under ...\sqllib\java\db2java.zip. Copy this file to the <designer_install>\applications\eclipse\plugins\com.ibm.workplace.designer.corelibs_1.0.0\jdbc directory. It's extremely important that the zip file on the client and server match. Even a fixpack installed on the server can include a different version of the db2java.zip file.

z Fill in the database parameters in the deploy profile . Database: DB2 Driver Class: This can be left blank. The driver class defaults to COM.ibm.db2.jdbc.app.DB2Driver. URL: The URL is of the form jdbc:db2:<db_alias_name> where the db_alias_name was configured using the "catalog" command above.

254

IBM Workplace Collaboration Services 2.6.1 Release Notes

Configuring Designer to use the DB 2 "net" driver

z Install the JDBC driver ZIP file in the Designer JDBC directory . The JDBC driver ZIP is called db2java.zip and can be found in the DB2 install directory under ...\sqllib\java\db2java.zip. Copy this file to the <designer_install>\applications\eclipse\plugins\com.ibm.workplace.designer.corelibs_1.0.0\jdbc directory. It's extremely important that the zip file on the client and server match. Even a fixpack installed on the server can include a different version of the db2java.zip file.

z Ensure that the JDBC (a/k/a JDBC Applet Server ) service is running on the DB 2 server. The "net" driver communicates with this server--not directly with the DB2 server. This service can be started by issuing the "db2jstrt" command on the DB2 server. By default, the service listens on port 6789.

z Fill in the database parameters in the deploy profile

Database: DB2Driver Class: COM.ibm.db2.jdbc.net.DB2DriverURL: The URL is of the form jdbc:db2://<host>:<port>/<dbname> e.g., jdbc:db2://myhost.notesdev.ibm.com:6789/mydb.

Troubleshooting The following is a list of possible errors you might encounter and their cause. You'll typically need to look a few levels into the stack trace in the "Details" pane of the deploy error dialog to find these errors.

Error Possible cause java.lang.UnsatisfiedLinkError:SQLAllocEnv" You're using the "app" driver but you haven't

installed the DB2 client runtime Error connecting to socket or Error opening socket Make sure the JDBC URL contains the correct or CLI0615E Error receiving from socket, server is hostname and port. If you're using the "net" driver, not responding. SQLSTATE=08S01 make sure the JDBC Applet service has been

started on the DB2 server machine. CLI0621E Unsupported JDBC Server configuration. The db2java.zip file you installed in Designer is

incompatible with the DB2 server. Make sure you obtained the db2java.zip file from the DB2 server installation.

Deploying a Workplace Designer component to an iSeries cluster ®

Take the following steps to deploy an IBM Workplace Designer component to an iSeries cluster. As a prerequisite, you must have a working installation of Workplace Designer in a networked environment. See the IBM Workplace Designer 2.6 Installation and Upgrade Guideat http://www.ibm.com/developerworks/workplace/documentation/designer/.

Steps for the Workplace Designer developer

The following steps should be performed by the Workplace Designer developer: 1. Create a Workplace Designer component. 2. Create a new Workplace Designer deployment profile (or edit an existing one). Both of these

servers may be on the same machine.

255

IBM Workplace Collaboration Services 2.6.1 Release Notes

3. In the Database tab of the deployment profile, fill in the following fields: a. In the Type field, select DB2 iSeries. b. Be sure that the name you type in the User name field is the same as the owner of the

DB2 iSeries tables. Also, be sure that the database user has all permissions. c. Leave the Driver class field blank. It will default to

com.ibm.as400.access.AS400JDBCDriver. d. In the URL field, type the URL of the form in this format: jdbc:as400://host /schema ,

where host is the name of the host and schema is the name of your schema. 4. Select the deployment profile that you want to use when deploying this component by taking the

following steps: a. Click File > Preferences. b. Click Workplace Designer > Deployment . c. Click the radio button beside the deployment profile to make it the default profile. d. Click OK.

5. From the Workplace Designer user interface, export the WAR and DDL files by taking thefollowing steps:

a. Click the component name in the Component Navigator. b. Click File > Export > .WAR file. c. In the Export WAR dialog box, specify the save location and name of the WAR file. d. Click Save. e. Click File > Export > .DDL file. f. In the Export DDL dialog box, specify the save location and name of the DDL file. g. Click Save.

6. Send the WAR and DDL files to the server administrator.

Steps for the server administrator

The following steps should be performed by the server administrator: 1. Locate the JDBC driver file called jt400.jar located in the

/qibm/proddata/http/public/jt400/lib directory and copy it to the following directory:

workspace_directory \applications\com.ibm.workplace.designer.corelibs.feature\eclipse\plugin s\com.ibm.workplace.designer.corelibs_1.0.0.005\jdbc

where workspace_directory is the Workplace Designer workspace directory. You may need to restart the IBM Workplace Managed Client to allow it to pick up the JAR file.

Note: The workspace directory is where your user information is stored, for example, your user credentials. The default location for Windows is C:\Documents and Settings\user_name \IBM\RCP\number\user-name, where user-name is your Windows user name and number is a unique number for your version of Workplace Designer.

2. Select the system on which you are planning to store the shared schema. 3. Create a schema on the database system using the STRSQL command and the CREATE

SCHEMA schema-name SQL statement, where schema-name is the name of the schema. This is the schema that will be used with Workplace Designer.

Note: If you use CRTLIB to create the schema instead of STRSQL, you may get the following error message: java.sql.SQLException: [SQL7008] table_name in database_name not valid for operation. You can resolve this by enabling journaling for your library and the tables contained in it.

4. Update the authentication of the database tables using the following command:

CHGAUT OBJ('/qsys.lib/<schema_name>.lib/*') USER(<db_user_name>) DTAAUT(*RWX) OBJAUT(*ALL)

256

-- --------------------------------------------------------------------------

-- ---------------------------------------------------------------------------- --------------------------------------------------------------------------

-- --------------------------------------------------------------------------

IBM Workplace Collaboration Services 2.6.1 Release Notes

5. Create a subdirectory in the cluster's shared directory for the Workplace Designer component, for example:

<cluster_shared_directory_root> /designer/DiscussionDatabase/XSPPool

where <cluster_shared_directory_root> is the shared directory root of the cluster. This directory will contain a file-based document cache.

Note: If you are working with multiple Workplace Designer components, you will need to create a separate subdirectory for each component.

6. Grant access to any subdirectory that you created in the previous step using the followingcommand:

chmod -R 777 <cluster_shared_directory_root> /designer

7. Add the following property to the global.properties file in the WAR file, for example:

fb.xsp.documentpool.directory=<cluster_shared_directory_root> /designer/DiscussionDatabase

8. Copy the component parameter file into the following directory in each node of the cluster:

<was_user_root> /installedApps/<cell_name>/workplace_cell/wps.ear/wps.war

where <was_user_root> is the WebSphere Application Server's user root directory. The component parameter file contains any parameters you've defined for the component. The file name is the same as the component name.

9. Re-zip the WAR file. 10. If you have deployed a component using this database before, you will need to edit the DDL's

SQL script to remove the system table and index creation and initialization statements. To do this, take the following steps:

a. Remove all the CREATE TABLE and CREATE INDEX statements that are located between the System tables and XML Database comments, for example:

-- System tables

-- XML Database: DiscussionDatabase

b. Remove the first INSERT statement in the last section of the DDL file, for example: INSERT INTO FB__OBJ (FBTYPE,FBNAME,FBSUBTYPE,FBCREDAT,FBAUTHOR,FBMODDAT,FBLOCKED,FBDATA) VALUES ('ACLServer','ACLServer','',TO_DATE('1-7-2005 16:29:51', 'DD-MM-YYYY HH24-MI-SS'),'anonymous',TO_DATE('1-7-2005 16:29:51', 'DD-MM-YYYY HH24-MI-SS'),0,'<?xml version="1.0" encoding="UTF-8"?><ACLServer id="Obj-1" xmlns:SOAP-ENC=" http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd=" http://www.w3.org/1999/XMLSchema/instance/" xmlns:xsi=" http://www.w3.org/1999/XMLSchema/" xmlns:fb=" http://www.flowbuilder.com/namespaces/datatypes "><maxQueryFields>60</maxQueryFields><perInstance>true</perInstanc e><tbSeqID>1</tbSeqID><version>5</version></ACLServer>');

11. Create the component data store by running the SQL script. Note that this step does not create the database for you. You must have already done this in advance.

12. Deploy the WAR file on any WebSphere Application Server node in the cluster using a standard method such as the IBM WebSphere Portal administrative user interface or XMLAccess scripts.

257

IBM Workplace Collaboration Services 2.6.1 Release Notes

13. Replicate your WebSphere Portal applications to all application nodes in the cluster. Use the WebSphere Portal documentation to perform this task. Next, take the following steps to ensure that each application is successfully synchronized across all nodes in the cluster and that the portlets are activated:

a. Open the administrative console for the WebSphere Portal Deployment Manager. b. Click System Administration > Nodes . c. Select all the nodes in the cluster. d. Click Synchronize. e. Click Applications > Enterprise Applications . f. For each individual application, select the portlets. g. Click Start to start the application. h. Click Administration > Portlets > Manage Applications . i. In the Web Modules list, select the application. j. Select the portlets for the selected application. k. Click Activate/Deactivate.

For more details about synchronizing applications and activating portlets, see the WebSphere Portal documentation.

14. If the Workplace Designer developer defined any parameters for the component using the Parameters tab in the Properties panel in Workplace Designer, take the following steps. If no parameters were defined, you can bypass this step.

a. Unzip the component's WAR file. b. Locate the file that has the same name as your component. For example, if the name of

your component is ProjectManager, locate the file called ProjectManager (without a file extension).

c. Copy the file into the \WebSphere\AppServer\installedApps\<cell-name>\wps.ear\wps.war directory, where <cell-name> is the cell name of the application server. If you are deploying to a clustered environment, you must copy this file into the \WebSphere\AppServer\installedApps\<cell-name>\wps.ear\wps.war directory on each node of the cluster.

Note: If you have defined parameters for the component and therefore had to follow these steps, you will need to create a new Workplace template for the component application. Existing templates will not recognize the new file that you just added to the wps.war directory.

15. Test your deployment by taking one of the following actions. z Create an application instance from an existing Workplace template and add the

component to a page in that application. z Create a new Workplace template, set up an application based on that template, and then

add the component to a page in the application. z Add your component directly to a page without attaching it to a template. Note: If you test

your component this way, your component will not have the same functionality as a template-based component. For example, all instances of the component will share the same data, component parameters will not exist, user roles will not apply, and you will not be able to run scripts for instance lifecycle and membership.

For more information about iSeries servers, see the IBM eServer iSeries Information Center at http://publib.boulder.ibm.com/infocenter/iseries/v5r3/ic2924/index.htm.

258

IBM Workplace Collaboration Services 2.6.1 Release Notes

Description of password for Edit Box is incorrect In the Help topic called Edit Box options, located in the contents pane under IBM Workplace Designer > UI controls> Edit Box, the description for password is "Select the check box to prompt users to specify a password before they can type any characters in the edit box." This description is incorrect. Instead, it should say "Select the check box to display an asterisk for each letter users type in the edit box."

IBM Workplace Designer Runtime supports Solaris and AIX In the IBM Workplace Designer Installation and upgrade guide (not the Workplace Collaboration Services installation guide), in the topic "Installing the IBM Workplace Designer Runtime," step 3 should include the following platforms:

On Solaris, run DesignerServerSetupSolarisSparc.bin.

On AIX, run DesignerServerSetupAIX.bin.

Importing a component and deployment When importing a component, you have the option to "Preserve Deployment information" (default selection) or "Make a Copy". When you opt to preserve the deployment information, this allows whatever changes you make to the component to be immediately reflected on the server version when you deploy it. This, of course, assumes that the component has already been deployed on the server, perhaps by somebody you are collaborating with in the component design. If not, the option has no immediate effect. But it still may be very important to preserve the deployment info if you are collaborating with another designer who will be re-deploying the component after you initially deploy your version.

If you choose the "Make a Copy" option, a completely new copy of the component will be generated. It will be "disconnected" from any currently existing version of the component, deployed or not. So, when you deploy the component it will always create a completely new instance on the server, even if the original component was already deployed. This may be of use if you are, for example, using the imported component as a base for a completely different component.

Note: When selecting to "Preserve Deployment information", you can not change the name of the component. Since it is essentially a replica of the original component, the name must remain as-is. If you do attempt to change the name, the option to preserve deployment information will be disabled, and the "Make a Copy" option will be automatically selected.

Installation file format incorrect in guide In the topics "Installing the IBM Workplace Designer Runtime" and "Installing the IBM Workplace Designer Tool" the Designer installation files for Microsoft Windows computers are referred to as being in the .ZIP format. For example, the runtime is called C87UAML.zip and the tool is called C87UBML.zip. This is incorrect. The file format is .exe, so the runtime file is C87UAML.exe and the tool file is C87UBML.exe.

259

IBM Workplace Collaboration Services 2.6.1 Release Notes

Label positions For controls that have an attached label, there are two choices for the label position, "Left" and "Right". If the value is "Left", the label is positioned to the left of the control; if the value is "Right" the label is positioned to the right.

Linux: Change to configuration file may not be required In the step 3 of the topic "Installing IBM Workplace Designer in an IBM Workplace Collaboration Services environment", the following line references a change that is required to a configuration file for Linux, without which users would not be able to deploy to the WCS server.

"On Linux, open the WebSphere/PortalServer/rootscripts/subtasks/startNetworkServer.sh file on the Workplace Collaboration Services server, locate the line that contains -Xms512M -Xmx1024M, and modify the line as shown: "$JAVA_HOME/bin/java -Xms512M -Xmx1024M -Ddb2j.drda.host=0.0.0.0 -Ddb2j.drda.sendLongBitVaryingAsBlob=true -Ddb2j.drda.sendLongVarcharAsClob=true -cp $CNS_CLASSPATH com.ibm.db2j.drda.DB2jServer start -ld >/opt/WebSphere/PortalServer/log/NetworkServer.log &"

This change may no longer be required for Linux installations

Setting form data properties topic The Document action property in the form properties Data tab is documented like this:

"New Document - A new document is created with its own ID each time users open the form. You must create a script that produces an ID for each new document in the Parent ID field. Users must have Author or Editor component level access in order to create new documents.

Note Since users with Reader component level access cannot create new documents, they cannot open this form. If the form contains a view that you want Readers to access, you can uncheck "Specify a data source for this form." After this is unchecked however, you cannot store data entered into this form."

The note is incorrect. If you uncheck "Specify a data source for this form" so that users with Reader access can see the form, you can still store user data in documents. You must add a panel control (or controls) to the form and put the controls that accept data into that panel. Then in the panel's Data properties you select "Specify a data source for this form" and set the panel to generate a document. The form will not generate a document, but the panel will.

Tutorial: /project/status should be /project/currentStatus The following error occurs in the Tutorial section of the Workplace Designer reference help:

Step 7 in the topic "Creating a component and schema" lists a completed schema including a currentStatus element.

Step 21 in the topic "Creating a form for listing documents" includes the statement:

var status = document.getIntValue("/project/status");

This statement references the currentStatus element and should therefore be:

var status = document.getIntValue("/project/currentStatus");

260

IBM Workplace Collaboration Services 2.6.1 Release Notes

Chapter 5 - Notices and Trademarks

Notices

Excluded Components information Information included in this section relates to certain "Excluded Components"; the terms governing usage of Excluded Components are as set forth in the IBM product license. Pursuant to the licenses under which IBM has obtained the Excluded Components, IBM is required to provide the following copyright notices and information. They are provided for informational purposes only, and do not change the terms of the IBM product license.

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:

261

IBM Workplace Collaboration Services 2.6.1 Release Notes

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.

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.

262

IBM Workplace Collaboration Services 2.6.1 Release Notes

4. Freetype 2.1.4Portions of this software are copyright © 1996-2002 The FreeType Project (www.freetype.org).All rights reserved.

5. ICU 2.2International 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.

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.

263

IBM Workplace Collaboration Services 2.6.1 Release Notes

"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 thisLicense.

"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.

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.

264

IBM Workplace Collaboration Services 2.6.1 Release Notes

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.

265

IBM Workplace Collaboration Services 2.6.1 Release Notes

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 thislist 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.

266

IBM Workplace Collaboration Services 2.6.1 Release Notes

3. Altered versions--including, but not limited to, ports to new operating systems, existing ports withnew 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.

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 andthe 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 apache@apache.org.

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 ``AS 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

267

IBM Workplace Collaboration Services 2.6.1 Release Notes

11. JDOM Copyright (C) 2000-2002 Brett McLaughlin & Jason Hunter. 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, andthe following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions, andthe 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 license@jdom.org.

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 (pm@jdom.org).

"This product includes software developed by the JDOM Project (http://www.jdom.org/)."

THIS SOFTWARE IS PROVIDED ``AS 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.

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

268

IBM Workplace Collaboration Services 2.6.1 Release Notes

13. Jaxen License Copyright (C) 2000-2002 bob mcwhirter & James Strachan. 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, andthe following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions, andthe disclaimer that follows these conditions in the documentation and/or other materials provided with the distribution.

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 license@jaxen.org.

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 (pm@jaxen.org).

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 ``AS 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.

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, andthe following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions, andthe disclaimer that follows these conditions in the documentation and/or other materials provided with the distribution.

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 license@saxpath.org.

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 (pm@saxpath.org).

269

IBM Workplace Collaboration Services 2.6.1 Release Notes

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 ``AS 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; XInclude Engine 1.0d11 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.

270

IBM Workplace Collaboration Services 2.6.1 Release Notes

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.

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 noticeplaced 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.

271

IBM Workplace Collaboration Services 2.6.1 Release Notes

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, inany 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.

2. You may modify your copy or copies of the Library or any portion of it, thus forming a work based on theLibrary, 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.

272

IBM Workplace Collaboration Services 2.6.1 Release Notes

3. You may opt to apply the terms of the ordinary GNU General Public License instead of this License to agiven 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 theLibrary 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.

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.

273

IBM Workplace Collaboration Services 2.6.1 Release Notes

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 providedunder 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.

274

IBM Workplace Collaboration Services 2.6.1 Release Notes

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 conditionsare 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.

275

IBM Workplace Collaboration Services 2.6.1 Release Notes

NO WARRANTY

15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THELIBRARY, 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 WILLANY 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

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 1990Ty Coon, President of Vice

That's all there is to it!

276

IBM Workplace Collaboration Services 2.6.1 Release Notes

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/).

FileUpload 1.0 License 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 bycontract 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.

277

IBM Workplace Collaboration Services 2.6.1 Release Notes

"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.

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.

278

IBM Workplace Collaboration Services 2.6.1 Release Notes

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.

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

APPENDIX How to apply the Apache License to your work.

To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

279

IBM Workplace Collaboration Services 2.6.1 Release Notes

Jaxen 1.0 License $Id: LICENSE.txt,v 1.3 2003/06/29 18:22:02 ssanders Exp $ Copyright 2003 (C) The Werken Company. All Rights Reserved.

Redistribution and use of this software and associated documentation ("Software"), with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain copyright statements and notices. Redistributions must also contain a copy of this document.

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 name "jaxen" must not be used to endorse or promote products derived from this Software without prior written permission of The Werken Company. For written permission, please contact bob@werken.com.

4. Products derived from this Software may not be called "jaxen" nor may "jaxen" appear in their names without prior written permission of The Werken Company. "jaxen" is a registered trademark of The Werken Company.

5. Due credit should be given to The Werken Company (http://jaxen.werken.com/).

THIS SOFTWARE IS PROVIDED BY THE WERKEN COMPANY AND CONTRIBUTORS ``AS 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 WERKEN COMPANY 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. */ © 2001-2004, Codehaus

JDOM 1.0 License Copyright (C) 2000 Brett McLaughlin & Jason Hunter. 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 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 license@jdom.org.

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 (pm@jdom.org).

280

IBM Workplace Collaboration Services 2.6.1 Release Notes

5. If appropriate, the end-user documentation included with the redistribution and/or the software itself must include a text acknowledgement equivalent to the following:

"This product includes software developed by the JDOM Project (http://www.jdom.org/)."

Alternatively, the acknowledgment may be graphical using the logos available at http://www.jdom.org/images/logos.

THIS SOFTWARE IS PROVIDED ``AS 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.

This software consists of voluntary contributions made by many individuals on behalf of the JDOM Project and was originally created by Brett McLaughlin <brett@jdom.org> and Jason Hunter <jhunter@jdom.org>. For more information on the JDOM Project, please see <http://www.jdom.org/>.

*/

Lucene 1.3 License 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).

281

IBM Workplace Collaboration Services 2.6.1 Release Notes

"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 suchDerivative Works in Source or Object form.

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 suchlicense applies only to those patent claims licensable by such Contributor that are necessarily infringed bytheir 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-claimor counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Workconstitutes direct or contributory patent infringement, then any patent licenses granted to You under thisLicense 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 orwithout 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

282

IBM Workplace Collaboration Services 2.6.1 Release Notes

(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.

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

283

IBM Workplace Collaboration Services 2.6.1 Release Notes

APPENDIX How to apply the Apache License to your work.

To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives.

Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License isdistributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, eitherexpress or implied. See the License for the specific language governing permissions and limitations underthe License.

RegExp 1.3 LicenseCopyright (c) 1995-1999 The Apache Group.All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted providedthat 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. All advertising materials mentioning features or use of this software must display the following acknowledgment:

"This product includes software developed by the Apache Group for use in the Apache HTTP server project(http://www.apache.org/)."

4. The names "Apache Server" and "Apache Group" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact apache@apache.org.

5. Products derived from this software may not be called "Apache" nor may "Apache" appear in their names without prior written permission of the Apache Group.

6. Redistributions of any form whatsoever must retain the following acknowledgment: "This product includes software developed by the Apache Group for use in the Apache HTTP server project ( http://www.apache.org/)."

THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP ``AS 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 GROUP 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.

284

IBM Workplace Collaboration Services 2.6.1 Release Notes

==================================================================== This software consists of voluntary contributions made by many individuals on behalf of the Apache Group and was originally based on public domain software written at the National Center for Supercomputing Applications, University of Illinois, Urbana-Champaign. For more information on the Apache Group and the Apache HTTP server project, please see <http://www.apache.org/>.

wcp-wts-sdk 1.03M license Eclipse Public License - v 1.0 THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.

1. DEFINITIONS

"Contribution" means:

a) in the case of the initial Contributor, the initial code and documentation distributed under this Agreement, and

b) in the case of each subsequent Contributor:

i) changes to the Program, and

ii) additions to the Program;

where such changes and/or additions to the Program originate from and are distributed by that particular Contributor. A Contribution 'originates' from a Contributor if it was added to the Program by such Contributor itself or anyone acting on such Contributor's behalf. Contributions do not include additions to the Program which: (i) are separate modules of software distributed in conjunction with the Program under their own license agreement, and (ii) are not derivative works of the Program.

"Contributor" means any person or entity that distributes the Program.

"Licensed Patents " mean patent claims licensable by a Contributor which are necessarily infringed by the use or sale of its Contribution alone or when combined with the Program.

"Program" means the Contributions distributed in accordance with this Agreement.

"Recipient" means anyone who receives the Program under this Agreement, including all Contributors.

2. GRANT OF RIGHTS

a) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, distribute and sublicense the Contribution of such Contributor, if any, and such derivative works, in source code and object code form.

b) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free patent license under Licensed Patents to make, use, sell, offer to sell, import and otherwise transfer the Contribution of such Contributor, if any, in source code and object code form. This patent license shall apply to the combination of the Contribution and the Program if, at the time the Contribution is added by the Contributor, such addition of the Contribution causes such combination to be covered by the Licensed Patents. The patent license shall not apply to any other combinations which include the Contribution. No hardware per se is licensed hereunder.

285

IBM Workplace Collaboration Services 2.6.1 Release Notes

c) Recipient understands that although each Contributor grants the licenses to its Contributions set forth herein, no assurances are provided by any Contributor that the Program does not infringe the patent or other intellectual property rights of any other entity. Each Contributor disclaims any liability to Recipient for claims brought by any other entity based on infringement of intellectual property rights or otherwise. As a condition to exercising the rights and licenses granted hereunder, each Recipient hereby assumes sole responsibility to secure any other intellectual property rights needed, if any. For example, if a third party patent license is required to allow Recipient to distribute the Program, it is Recipient's responsibility to acquire that license before distributing the Program.

d) Each Contributor represents that to its knowledge it has sufficient copyright rights in its Contribution, if any, to grant the copyright license set forth in this Agreement.

3. REQUIREMENTS

A Contributor may choose to distribute the Program in object code form under its own license agreement, provided that:

a) it complies with the terms and conditions of this Agreement; and

b) its license agreement:

i) effectively disclaims on behalf of all Contributors all warranties and conditions, express and implied, including warranties or conditions of title and non-infringement, and implied warranties or conditions of merchantability and fitness for a particular purpose;

ii) effectively excludes on behalf of all Contributors all liability for damages, including direct, indirect, special, incidental and consequential damages, such as lost profits;

iii) states that any provisions which differ from this Agreement are offered by that Contributor alone and not by any other party; and

iv) states that source code for the Program is available from such Contributor, and informs licensees how to obtain it in a reasonable manner on or through a medium customarily used for software exchange.

When the Program is made available in source code form:

a) it must be made available under this Agreement; and

b) a copy of this Agreement must be included with each copy of the Program.

Contributors may not remove or alter any copyright notices contained within the Program.

Each Contributor must identify itself as the originator of its Contribution, if any, in a manner that reasonably allows subsequent Recipients to identify the originator of the Contribution.

4. COMMERCIAL DISTRIBUTION

Commercial distributors of software may accept certain responsibilities with respect to end users, business partners and the like. While this license is intended to facilitate the commercial use of the Program, the Contributor who includes the Program in a commercial product offering should do so in a manner which does not create potential liability for other Contributors. Therefore, if a Contributor includes the Program in a commercial product offering, such Contributor ("Commercial Contributor") hereby agrees to defend and indemnify every other Contributor ("Indemnified Contributor") against any losses, damages and costs (collectively "Losses") arising from claims, lawsuits and other legal actions brought by a third party against the Indemnified Contributor to the extent caused by the acts or omissions of such Commercial Contributor in connection with its distribution of the Program in a commercial product offering. The obligations in this section do not apply to any claims or Losses relating to any actual or alleged intellectual property infringement. In order to qualify, an Indemnified Contributor must: a) promptly notify the Commercial Contributor in writing of such claim, and b) allow the Commercial Contributor to control, and cooperate with the Commercial Contributor in, the defense and any related settlement negotiations. The Indemnified Contributor may participate in any such claim at its own expense.

286

IBM Workplace Collaboration Services 2.6.1 Release Notes

For example, a Contributor might include the Program in a commercial product offering, Product X. That Contributor is then a Commercial Contributor. If that Commercial Contributor then makes performance claims, or offers warranties related to Product X, those performance claims and warranties are such Commercial Contributor's responsibility alone. Under this section, the Commercial Contributor would have to defend claims against the other Contributors related to those performance claims and warranties, and if a court requires any other Contributor to pay any damages as a result, the Commercial Contributor must pay those damages.

5. NO WARRANTY

EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED 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. Each Recipient is solely responsible for determining the appropriateness of using and distributing the Program and assumes all risks associated with its exercise of rights under this Agreement , including but not limited to the risks and costs of program errors, compliance with applicable laws, damage to or loss of data, programs or equipment, and unavailability or interruption of operations.

6. DISCLAIMER OF LIABILITY

EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), 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 OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

7. GENERAL

If any provision of this Agreement is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this Agreement, and without further action by the parties hereto, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.

If Recipient institutes patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Program itself (excluding combinations of the Program with other software or hardware) infringes such Recipient's patent(s), then such Recipient's rights granted under Section 2(b) shall terminate as of the date such litigation is filed.

All Recipient's rights under this Agreement shall terminate if it fails to comply with any of the material terms or conditions of this Agreement and does not cure such failure in a reasonable period of time after becoming aware of such noncompliance. If all Recipient's rights under this Agreement terminate, Recipient agrees to cease use and distribution of the Program as soon as reasonably practicable. However, Recipient's obligations under this Agreement and any licenses granted by Recipient relating to the Program shall continue and survive.

287

IBM Workplace Collaboration Services 2.6.1 Release Notes

Everyone is permitted to copy and distribute copies of this Agreement, but in order to avoid inconsistency the Agreement is copyrighted and may only be modified in the following manner. The Agreement Steward reserves the right to publish new versions (including revisions) of this Agreement from time to time. No one other than the Agreement Steward has the right to modify this Agreement. The Eclipse Foundation is the initial Agreement Steward. The Eclipse Foundation may assign the responsibility to serve as the Agreement Steward to a suitable separate entity. Each new version of the Agreement will be given a distinguishing version number. The Program (including Contributions) may always be distributed subject to the version of the Agreement under which it was received. In addition, after a new version of the Agreement is published, Contributor may elect to distribute the Program (including its Contributions) under the new version. Except as expressly stated in Sections 2(a) and 2(b) above, Recipient receives no rights or licenses to the intellectual property of any Contributor under this Agreement, whether expressly, by implication, estoppel or otherwise. All rights in the Program not expressly granted under this Agreement are reserved.

This Agreement is governed by the laws of the State of New York and the intellectual property laws of the United States of America. No party to this Agreement will bring a legal action under this Agreement more than one year after the cause of action arose. Each party waives its rights to a jury trial in any resulting litigation.

XMLS 0.8 License Copyright (c) 2001, Sosnoski Software Solutions, Inc.

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.

288

IBM Workplace Collaboration Services 2.6.1 Release Notes

JReport - license information JReport - license Congratulations on your order of IBM Lotus learning management tools. Your initial order includes the

TMability to download 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 off of their list price. In order 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!

TMJReport Server Engine copyright and trademark informationDeveloped 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.

Trademarks

Trademark listIBM, 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 registeredtrademarks 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 the Windows logo are registered trademarks of Microsoft Corporation in theUnited 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 SunMicrosystems, 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.

289