IBM Lotus Notes, Domino, Domino Designer 7 Release Notes

IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Lotus Notes , Domino , Domino Designer
®
®
®
®
Version 7
Release Notes
G210-1992-00
Note: Before using this information and the product it supports, read the information in "Notices" on page 201.
First Edition (August, 2005)
This edition applies to IBM® Lotus® Notes® and IBM Lotus Domino® 7, and to all subsequent releases and
modifications, until otherwise indicated in new editions.
© Copyright International Business Machines Corporation 1994, 2005. All rights reserved.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with
IBM Corp.
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Contents
Chapter 1 - About this release .............................................................................
1
New in this release.....................................................................................................................
Welcome to IBM Lotus Notes, Domino, and Domino Designer 7.0 .....................................
Directory install and CD-ROM structure ..............................................................................
Additional items on Notes and Domino CD-ROMs ..............................................................
Help databases - usage and availability ..............................................................................
Please replace Administrator Help file with updated version...............................................
Upgrading to Lotus Notes 7 and Domino 7 documentation.................................................
Release notes - updated information available on-line........................................................
New features .......................................................................................................................
Overview - New features in IBM Lotus Notes and Domino 7 ........................................
DB2 feature in Domino 7 released with Limited Availability ..........................................
New Features in Domino Web Access 7 ......................................................................
Notes Application plug-in for IBM Workplace Managed Client .....................................
Server.load new features in R7.....................................................................................
New enhancements.............................................................................................................
AdminP - Rename Reversion Approval ........................................................................
Domino 7 plug-in for HTTP Server (powered by Apache) and V5R3 ...........................
Domino Console - Ability to connect through a firewall.................................................
LDAP special character handling ..................................................................................
Rooms and Resources Manager ..................................................................................
SSL Cryptographic Accelerators ...................................................................................
zSeries hardware-assisted data compression for Transaction Log ..............................
Backward compatibility ..............................................................................................................
Differences in Java 1.3.1 and 1.4.x .....................................................................................
Obsolete Notes.ini variables ................................................................................................
Product compatibility ..................................................................................................................
AIX - Concurrent I/O, Direct I/O not supported on Domino servers .....................................
Need correct IE browser plug-in to access live console ......................................................
1
1
1
4
11
12
12
12
13
13
21
21
22
24
25
25
25
25
26
29
30
31
32
32
32
33
33
34
Chapter 2 - Installation, migration, upgrade, and configuration
information ............................................................................................................
35
Hardware requirements .............................................................................................................
Notes and Domino 7 hardware requirements ......................................................................
i5/OS (iSeries) hardware requirements ...............................................................................
Tested Smartcard packages................................................................................................
Software requirements ...............................................................................................................
Notes and Domino 7 platforms and system requirements...................................................
i5/OS (iSeries) software requirements.................................................................................
Domino Web Access system requirements .........................................................................
Domino Access for Microsoft Outlook Requirements ..........................................................
DOLS system requirements ................................................................................................
DECS - supported data drivers list ......................................................................................
AIX platforms supported ......................................................................................................
AIX patch requirements .......................................................................................................
AIX - IOCP required.............................................................................................................
AIX - Java needs X11 libraries ............................................................................................
AIX - Java requires X11.fnt.ucs.ttf for Far Eastern locales..................................................
AIX - Installing bos.adt.debug..............................................................................................
Linux platforms supported ...................................................................................................
35
35
35
36
38
38
43
44
44
45
45
45
46
46
46
46
46
47
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Linux patch requirements ....................................................................................................
Solaris platforms supported .................................................................................................
Solaris patch requirements ..................................................................................................
Windows platforms supported .............................................................................................
Windows service pack requirements ...................................................................................
Web browsers supported.....................................................................................................
File formats supported .........................................................................................................
Web Administrator: Domino LIVE console requires Sun Java 1.4.2 ...................................
z/OS Software levels: PTF checker.....................................................................................
z/OS DB2 requirements for LS:DO, LCLSX and DECS ......................................................
Linux for zSeries SLES9 DB2 requirements........................................................................
IBM HTTP Domino Plugin for z/OS .....................................................................................
Domino 7 and IPv6 ..............................................................................................................
Hyper-threaded CPUs treated as SMP systems .................................................................
Installation notes ........................................................................................................................
Notes 7 and Notes 6.x coexistence .....................................................................................
Installing Domino 7 on UNIX using multiple CDs ................................................................
Installing Domino on UNIX and on Linux on zSeries...........................................................
Installing Domino Web Access 7.0 ......................................................................................
Installing Domino Access for Microsoft Outlook ..................................................................
Installing Domino 7 for i5/OS...............................................................................................
CD batch installation............................................................................................................
Display issue with server’s Japanese license agreement dialog .........................................
DOLS install on Linux Mozilla..............................................................................................
For verification of a silent install, add "+" to the command ..................................................
New default install directory for Domino on UNIX ...............................................................
Notes.jar and other Java archives moved ...........................................................................
Remove any Beta versions before installing .......................................................................
Renaming desktop icons will have to be manually deleted .................................................
Scriptable Client Setup & the ’AdditionalServices’ variable.................................................
Scriptable Client Setup: ’File cannot be created’ error ........................................................
Scriptable Client: Setup for Roaming Users ........................................................................
Scriptable Client: Setup & deployment to multiple users .....................................................
Select Migrations Tools to "run from network" for shared install .........................................
Shared uninstall fails w/ Admin Migrations Tools installed ..................................................
Single logon: Admin rights restart after install/upgrade/repair.............................................
Single Logon: Feature upgrade and disable........................................................................
Specify the Server Controller as an NT service at installation.............................................
To enable Progress Bar during silent Client install ..............................................................
Upgrading Lotus Notes must be to the same directory .......................................................
Wire protocol drivers installed with Domino .........................................................................
Migration notes ..........................................................................................................................
Internet Access and the Outlook Express Migration tool.....................................................
Migrating from Exchange to Domino ...................................................................................
Upgrade notes ...........................................................................................................................
Flat names and ID files are not supported in Domino and Notes 7 .....................................
Online Help after upgrade of Notes, Admin Client, and Designer .......................................
Sametime customization saved to STLINKS.SAV on upgrade ...........................................
SmartUpgrade Web kits command line options ..................................................................
Contents
47
47
47
47
48
48
49
50
50
50
50
51
51
51
51
51
52
54
54
55
58
59
59
59
59
59
60
60
60
60
61
61
62
62
62
63
63
63
63
63
63
64
64
64
65
65
66
66
67
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Contents
Configuration notes ....................................................................................................................
Autosave - Clean up autosave.nsf from pre-release installation .........................................
Choose the format of HTTP log files. ..................................................................................
Console logging default state is "On" ..................................................................................
Domino for AIX configuration...............................................................................................
Domino for Linux on x86 configuration ................................................................................
Domino for Linux on zSeries configuration ..........................................................................
Domino for Solaris configuration .........................................................................................
Domino memory pre-allocation configuration ......................................................................
Domino Server Controller configuration ..............................................................................
Enabling additional printer fonts ..........................................................................................
Hardware Cryptography Support .........................................................................................
Java JVM property settings on a per Domino server basis .................................................
Notes’ Sametime client identifier has been updated ...........................................................
Previous Domino Domain Monitor database needs to be deleted ......................................
Rooms & Resource databases require Administrator configuration....................................
Setup Wizard supports selection of server release to configure .........................................
z/OS Configuration Settings ................................................................................................
z/OS IEFUSI User Exit ........................................................................................................
Security................................................................................................................................
Rename of user through User Security panel, via mail.................................................
Users should locally encrypt databases on multi-user machine ...................................
Domino Web Access ...........................................................................................................
Domino Web Access in Portal Views ............................................................................
Sametime Integration does not work with JRE 1.4.1_05 ..............................................
Using Lotus Instant Messaging and Web Conferencing with UNIX ..............................
Uninstallation information...........................................................................................................
Uninstall 7.0 server before downgrading to pre-7.0 builds ..................................................
67
67
67
68
68
68
69
71
72
73
73
73
75
75
75
76
76
76
78
78
78
78
78
78
78
79
79
79
Chapter 3 - Known limitations, problems, and workarounds ...........................
81
Limitations ..................................................................................................................................
Applet issues .......................................................................................................................
Java Debugger can’t attach to JVM for "Preview . . ." applets ......................................
Calendar and scheduling issues..........................................................................................
’Print calendar to a document’ causes different line indenting ......................................
’Propose New Time’ feature not working between Outlook and Notes .........................
Calendar cleanup will crash with some types of archive policies ..................................
Filtered Private entries ..................................................................................................
Icons for Recipient in the To/cc: field are on Delegated Meeting..................................
Icons for Recipient in the To/cc: field are on responses ...............................................
IPv6: Meeting Threads not showing name by design ...................................................
Managed Client opens C&S entry in Workplace preview window ................................
Repeating meetings not automatically accepted on Domino 6 router...........................
Using Go To options shows the Meetings tabs when it should not...............................
Workplace not restored when opening C&S notice from Alarm dialog .........................
Client issues ........................................................................................................................
Client Reconfiguration Wizard and location document .................................................
Database open fails if query view is set to default ........................................................
Limitations using Sametime Server with IMLU .............................................................
Limitations with Mozilla .................................................................................................
81
81
81
81
81
81
82
82
82
82
82
82
82
83
83
83
83
83
83
84
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
New Autoprocess feature not in Webmail for current release.......................................
QV fails to return expected error in pre-r7 or non-DB2 server ......................................
Sametime Meetings require Internet Explorer or Netscape (< 6)..................................
DB2 issues ..........................................................................................................................
Archive and calendar cleanup can’t be used on DB2-enabled mail..............................
Domino and DB2: Compact -B delays Domino server shutdown .................................
LNDFR.NSF not supported as DB2-enabled Notes database ......................................
Query views cannot be used with Depositor-level access ............................................
Refreshing a query view in Designer doesn’t show correct data ..................................
Designer issues ...................................................................................................................
@DB2Schema syntax not working ...............................................................................
Directory issues ...................................................................................................................
LDAP Domino Upgrade Service group migration limited to 500 ...................................
LDAP will not honor abandon operations over SSL connections..................................
IPv6 addresses in Directory Assistance........................................................................
DOLS issues........................................................................................................................
Dircat not being deleted when shared subscription is deleted ......................................
Win2K - Sync Details box opens behind Sync Manager ...............................................
DOLS does not support hyperthreading .......................................................................
DOLS does not support Simplified Chinese GB18030 Unicode ...................................
Domino Access for MS Outlook issues ...............................................................................
Domino Access for Microsoft Outlook issues ................................................................
Use Domino Access for Microsoft Outlook 6.5.4 ..........................................................
Domino Domain Monitoring issues......................................................................................
DDM memory probe on i5/OS reports 2x usage for Java agent ...................................
General Domino Domain Monitoring (DDM) information ..............................................
z/OS DDM Limitations...................................................................................................
Domino Web Access issues ................................................................................................
Attachment icon does not display with S/MIME encryption ..........................................
Cannot change Internet password when authenticating via LDAP ...............................
Cannot clear browser history from the logout screen ...................................................
Don’t use Adobe Distiller to create PDF files ................................................................
In clusters, replicator deletes message when it is sent to self ......................................
In Mozilla browsers, spellcheck does not check Subject line........................................
Interoperability issue with delegates .............................................................................
Mail rule that filters by high delivery priority may not work............................................
Offline not available on Linux Mozilla............................................................................
Secure mail issue with offline subscriptions on same system ......................................
Update calendar notice not generated for repeat meetings ..........................................
Upload control does not load ........................................................................................
Installation issues ................................................................................................................
Blank service description issue on Windows 2003 .......................................................
Multiple User Client Installation information ..................................................................
Notes Single Logon and Windows Terminal Server/Client ...........................................
Notes Single logon restrictions .....................................................................................
Time Range cannot span midnight for Client Setup .....................................................
Uninstall Designer/Administrator via Modify leaves icons behind .................................
Internet issues .....................................................................................................................
Java Console will not accept IPv6 addresses ...............................................................
Contents
84
84
84
85
85
85
85
85
85
86
86
86
86
86
87
87
87
87
87
87
88
88
91
91
91
91
92
92
92
92
92
92
92
92
92
93
93
93
93
93
93
93
94
94
94
95
95
95
95
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Not all mapped network drives appear when browsing ................................................
On Linux, request log filenames do not link to HTTP thread IDs ..................................
Mail issues ...........................................................................................................................
New archive criteria type won’t work if db is on earlier server ......................................
Reply to All will not work on Collapsed Personal Groups .............................................
Policy issues ........................................................................................................................
Custom Welcome Page for Client Setup via modem ....................................................
General Setup and Desktop Policies information .........................................................
Proxy Server settings not always being pushed down to the client ..............................
Setup & Desktop Policies on a shared Notes Client .....................................................
Printing issues .....................................................................................................................
Print previewing text in color shows up as black and white ..........................................
Programming issues............................................................................................................
Java applets need same JVM used to create Domino Objects ....................................
NotesDatabase.GetModifiedDocuments.......................................................................
z/OS LS:DO in codepage IBM-939 or 5039 not supported ...........................................
Roaming User issues ..........................................................................................................
Roaming User upgrade not supported via Passthru server ..........................................
Search issues ......................................................................................................................
Restricted field names in full-text indexing....................................................................
Security issues ....................................................................................................................
LDAP SSL SASL bind ignores Allow and Deny Server Access lists .............................
LDAP using SASL authentication doesn’t fail-over to Anonymous ...............................
Misleading error message re: validating agent execution access .................................
Importing Certificates from Smartcards ........................................................................
Key rollover for DWA users not supported....................................................................
LDAP SSL SASL bind ignores Allow and Deny Server Access lists .............................
LDAP using SASL authentication doesn’t fail-over to Anonymous ...............................
Running LDAP over SSL crashes MS Outlook Express ...............................................
Server issues .......................................................................................................................
Compact -a and -A will not work on DB2 enabled servers............................................
Domino 7 for i5/OS Java Console Limitations ..............................................................
Domino for i5/OS Java Console limitations...................................................................
Domino for Linux on zSeries jconsole program limitation .............................................
Domino Profile Setup can’t get system databases from filesystem ..............................
Features not available in Domino 7 for i5/OS ...............................................................
Limitations and Restrictions for i5/OS ...........................................................................
Live Mode Memcheck requires AIX 5.3 or greater ........................................................
Message reporting on non-Windows machines ............................................................
NSD does not capture domdsmc stack .........................................................................
Problem with memory leak tracing code .......................................................................
Relative directories issue with ISMP installation ...........................................................
Remote server Setup from UNIX to W32 cannot be silent............................................
Spaces in directory names on UNIX causes nsd.sh to fail ...........................................
STOP PORT console command may hang the server .................................................
z/OS Native Console Restriction ...................................................................................
z/OS: zFS filesystem limitation .....................................................................................
"System" databases cannot be compacted ..................................................................
Web Services issues ...........................................................................................................
Contents
95
96
96
96
96
96
96
97
97
97
97
97
98
98
98
98
98
98
98
98
99
99
99
99
99
99
100
100
100
100
100
100
101
101
101
101
102
102
102
102
102
102
103
103
103
104
104
104
104
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Cannot deserialize multi-dimensional array in LotusScript ...........................................
Earlier Web Service design elements do not open .......................................................
LotusScript runtime deserialization into empty dynamic arrays ....................................
LS Web Services do not yet support SOAP multireference encoding ..........................
Multi-byte characters in WSDL documents ...................................................................
XML schema mechanisms "include" and "import" are not supported ...........................
Known problems and workarounds ............................................................................................
Application Development issues..........................................................................................
Java Debugger needs file copied into Notes binaries directory ....................................
Calendar and scheduling issues..........................................................................................
nd-level delegator in iCalendar receives unexpected reschedule .................................
Calendar Managers always go to the Week View tab ..................................................
Error responding delegated repeating invitation in meeting views ................................
iCal: responses from Outlook Invitee comes as winmail.dat .........................................
Invitations via SMTP can now transmit images ............................................................
Online Meeting Password and Restricted Options .......................................................
Renamed users can not transfer direct-booked R&R reservations...............................
Reschedule to non-Notes should apply to "Just this instance" .....................................
Client issues ........................................................................................................................
Autosave - Enabling option in User Preferences doesn’t roam ....................................
Autosave - Garbage characters may show up when server is down ............................
Autosave - May cause errors to printing .......................................................................
Autosave - Recovered mail always get appended with a signature..............................
Autosave - Response created in 6.x or prior cannot be recovered ...............................
Black Toolbar icons.......................................................................................................
Buddy list doesn’t get populated with "Show online people only" .................................
Compacting a desktop with private views .....................................................................
Delivered message has no Sender on Notes Client UI.................................................
Hovertext for embedded contact lists not working ........................................................
iCalendar: All Day events are not converted properly ...................................................
Invite at least two persons to Instant Chat Meetings ....................................................
Known issues with IM Meetings if POP-UP blocker is turned on ..................................
Notes crashes if Admin Client is opened from Tools menu twice .................................
Opening Preferences of a Notes Mail Database Results in Error .................................
TweakUI and Notes ......................................................................................................
"Formula must evaluate to text" error on Welcome page..............................................
"Searchresults No Documents Found" searching via browser......................................
DB2 issues ..........................................................................................................................
Actions run on federated data in query views may cause errors ..................................
Date ranges are not being utilized with DAVs...............................................................
DB2 databases may appear as NSF in the Files list.....................................................
Document locking introduces problems with DAVs ......................................................
DOMCHANGE.NSF database should not be DB2-enabled ..........................................
Inserts during DAV population ......................................................................................
Moving a database to another DB2 group on AIX ........................................................
Moving a DB2-enabled Notes database containing a DAV ..........................................
Moving a DB2 container to another physical location ...................................................
New copy of DB with QV causes ’Invalid or nonexistent document’ .............................
Query view - updates return incorrect data ...................................................................
Contents
104
104
104
105
105
105
105
105
105
105
105
106
106
106
106
106
106
106
107
107
107
107
107
107
108
108
108
108
108
108
108
109
109
109
109
109
110
110
110
111
111
111
111
112
112
112
113
114
114
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Query view does not show docs with stored form.........................................................
Query views cannot view federated data external to DB2 table ...................................
Refreshing Query View returns incorrect data ..............................................................
Views w/ both categories and responses in DB2-enabled Notes dbs...........................
Web Admin database created as DB2-enabled Notes database..................................
Designer issues ...................................................................................................................
Crash copying form actions to view ..............................................................................
Errors in agents imported by DXL not highlighted in Designer .....................................
Query view & View Selection formula with specific Form selected ...............................
Simple Actions cannot be used for new or changed view selections ............................
Directory issues ...................................................................................................................
LDAP service clients using Microsoft Windows XP and SSL........................................
Directory catalog sort ordering ......................................................................................
Enabling SSO for foreign LDAP directory entries with @ signs....................................
Problem with enabling anonymous queries through LDAP...........................................
DOLS issues........................................................................................................................
Problems installing subscriptions with IE 5 ...................................................................
Limit subscription names to fewer than 30 characters/bytes ........................................
Multiple directory catalogs may be confusing ...............................................................
Problem viewing "Out of Service" databases on a clustered server .............................
Internet password not synchronizing ............................................................................
Subscription desktop icons may not appear .................................................................
Sync gets stuck with multiple subscriptions set at 1 minute .........................................
Users must be Reader or higher to install DOLS database ..........................................
When browser prompts to "Work Offline?" choose ’No’ ................................................
Be consistent when encrypting subscriptions with shared files ....................................
DOLS on a Domino Configuration Directory server ......................................................
Moving extended mail files from one server to another ................................................
Cancelling sync after wrong password causes security problem ..................................
Desktop icon not changing when customized ...............................................................
Dircat path not removed from notes.ini when subscription removed ............................
Error during sync about public key not matching the Address Book .............................
If configuration document deleted, users must re-install ...............................................
Multi-user subscriptions are deleted by Notes "clean up" .............................................
Users can’t access encrypted subscription if ID overwritten .........................................
Disabled subscriptions synchronize during upgrade.....................................................
Need proper format to use wildcard for Optional files ...................................................
Password lost when Offline Security doc is changed after upgrade .............................
Problems with DOLS SSO "Enter application Password" dialog ..................................
Can’t use alternate organization unit to login offline .....................................................
Cannot log into offline subscription with user short name.............................................
Subscription doesn’t failover when outside a company’s DNS .....................................
Upgrading the iNotes Sync Manager to the Domino Sync Manager ............................
Using an alternate name to go offline ...........................................................................
With IIS, delay before install path dialog is displayed ...................................................
Domino Access for MS Outlook issues ...............................................................................
Cannot edit MAPI profile ...............................................................................................
Domino Access for Microsoft Outlook issues ................................................................
Exchange to Domino Migration issues ..........................................................................
Contents
115
115
115
115
116
116
116
116
116
116
117
117
117
118
119
119
119
119
120
120
120
120
120
121
121
121
121
121
121
122
122
122
122
122
122
123
123
123
123
123
123
124
124
124
124
124
124
124
128
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Troubleshooting the Exchange to Domino migration ....................................................
Domino Domain Monitoring issues......................................................................................
’Open Monitoring...’ opens new instance each time .....................................................
’View Unread’ button presents mixed results in Collapsed views .................................
DDM ’Restore Default Probes’ action ...........................................................................
Domino Domain Monitor best viewed w/bookmarks unpinned .....................................
IBM Lotus Instant Messaging in Domino Domain Monitor ............................................
Log Filter configuration documents ...............................................................................
Orphaned documents left in DDM.nsf ...........................................................................
Removing multiple copies of TCP and Mail probe documents .....................................
Router "complains" about messages that contain no recipients ...................................
Security Configuration probe cannot be enabled from view level .................................
Domino Web Access issues ................................................................................................
Add Sender to Contacts not working correctly ..............................................................
Attachments larger than 10 MB require change to Server doc .....................................
Cannot insert multiple links in a table in a mail message .............................................
Cannot install a subscription after cancelling ................................................................
Cannot install Offline subscription from full DWA portlet ..............................................
Cannot search in NamePicker hierarchy views in Domino Web Access ......................
Cannot send a meeting invitation to a group in CDC from offline .................................
Cannot use Web Admin to set default Welcome Page .................................................
Changing your internet password in Domino Web Access ...........................................
Close the browser before uninstalling Domino Sync Manager .....................................
Domino Web Access 7.0 limitations on Linux Mozilla ...................................................
Domino Web Access 7.0 offline issues .........................................................................
Domino Web Access secure mail issues ......................................................................
DOMWS Convert AddIn task loads by default ..............................................................
Firefox does not support awareness in DWA on Windows ...........................................
Format preference for incoming mail ............................................................................
Lotus Instant Messaging Limited Use version requires variable ...................................
Meeting update notices do not get sent ........................................................................
New message may be discarded without prompting ....................................................
Problem opening attachments with Chinese file name .................................................
Problem opening offline on Linux Mozilla .....................................................................
Rich Text Editor issues in Domino Web Access ...........................................................
Server archiving in Portal UI requires Notes.INI variable ..............................................
Setting quick links in Domino Web Access Welcome page ..........................................
TAM WebSEAL 5.1 on Mozilla and Firefox displays error ............................................
Unable to load Inbox in Domino Web Access ...............................................................
Use LDAP Mail attribute for Domino Web Access Instant Messaging ..........................
Installation issues ................................................................................................................
Continue past "File does not exist" error for Notes client ..............................................
Domino 7 cannot install Partition Server over Single Server ........................................
Domino installation may fail when WRKDOMSVR cmd active on i5/OS ......................
Domino installation may fail with signature violation on i5/OS ......................................
Installing Domino 7 on UNIX from a CD-ROM ..............................................................
Instant Messaging Proxy Password doesn’t flow through.............................................
Invalid directory path value in script.dat issue ..............................................................
Notes/Domino 7 cannot be installed into a non-ASCII name folder ..............................
Contents
129
129
129
130
130
130
130
130
131
131
131
131
132
132
132
132
132
132
132
132
133
133
133
133
135
135
136
136
136
136
136
136
137
137
137
137
137
138
138
138
139
139
139
139
139
140
140
140
140
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Scriptable Client Setup and Instant Messaging configuration.......................................
Smart Upgrade doesn’t support Full Kit install for multi-users ......................................
Threshold chgs in Replication Settings apply to current location..................................
Total size in summary panel issue ................................................................................
Upgrade warning message (dominoSelfRegistering) issue ..........................................
Upgrading to Domino 7 changes the services startup type ..........................................
Windows server install displays security warning .........................................................
Mail issues ...........................................................................................................................
’Preferences’ menu option won’t be available if using Notes 6 .....................................
Ambiguous name dialog appears when adding followup to memo ...............................
Automatic folder upgrade does not upgrade all folder styles ........................................
Disclaimer text is dropped if angle brackets are included .............................................
Linux - Internet client background color is "Black" ........................................................
Notes crash when open IMAP proxy db after disconnect RAS dialup ..........................
Notes crashes when replicating IMAP proxy db with options .......................................
Preferences need to be resaved after name change ....................................................
Rule folder action for QuickRule, moved rule, not refreshed ........................................
Server - IMAP "Other user’s domain delimiter" Netscape setting .................................
Servers not in DST time give errors on iCal repeat meetings .......................................
Webmail: Preference setting in mail delegation not updated ........................................
"Forward notices . . ." from a local replica doesn’t work................................................
Policy issues ........................................................................................................................
’Default Welcome Page’ field becomes blank ...............................................................
Delete Policies and Settings from previous releases ....................................................
Desktop Policies: customized My Work page on pre-6.5 Clients ..................................
Desktop Settings and ’Accounts’ tab ............................................................................
Mail policy settings documents .....................................................................................
Setup fails if Policy doc was edited by Admin w/ removed access ...............................
Setup Policies not supported for Roaming Users .........................................................
Setup Profiles, Setup Settings & Bookmark creation ....................................................
Setup/Desktop Policies: need to exit & re-launch Notes Client ....................................
Setup/Desktop Policies: no Bookmarks, Welcome Page/Workplace ............................
Printing issues .....................................................................................................................
Multi-page mail doesn’t print properly in Internet Explorer............................................
Programming issues............................................................................................................
DXL/XSL issues on i5/OS .............................................................................................
Long formula language expression can cause stack overflow ......................................
NotesDocument.CreateMIMEEntity() can result in error ...............................................
Recompiling Visual Basic programs that use backend COM APIs ...............................
XML parsing and Transformation Engines for Java ......................................................
@Contains does not work properly with DBCS containing nulls...................................
Replication issues................................................................................................................
Cannot set replication schedule from Replicator page .................................................
Roaming User issues ..........................................................................................................
Other databases replicated using ’Send data to servers’ prompt .................................
Replication on launch/exit remains enabled on Roaming downgrade ..........................
Roaming Downgrade fails to remove databases from Replicator Page .......................
Roaming User Client setup - ’Connection denied’ message .........................................
Roaming User Client Setup that requires server connection doc .................................
Contents
140
140
141
141
141
141
141
142
142
142
142
142
142
143
143
143
143
143
143
143
144
144
144
144
144
144
145
145
145
145
145
146
146
146
146
146
146
147
147
147
148
149
149
149
149
149
149
150
150
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Roaming User Client setup & Instant Messaging configuration ....................................
Roaming User Upgrade: User says ’No’, remains In Progress .....................................
Roaming Users should replace design of Personal Address Book...............................
Roaming Users & IM Server connection: no simultaneous connection ........................
Search issues ......................................................................................................................
’Using LDAP to search a Domain index’ is not available ..............................................
Arabic character highlighting not supported in Notes client ..........................................
Avoid full-text indexing error caused by failed IO operation ..........................................
File system deletion error in catalog.nsf .......................................................................
File types not supported by Verity Keyview Filters 7.4.21 ............................................
First time creating the file system .................................................................................
Help may need new full-text index after multiple upgrades ..........................................
Improve full-text search performance and memory usage............................................
Manually loading domain index need quit the scheduled task ......................................
Multiple words can not be highlighted from a web browser ..........................................
Notes error with report when reports.nsf is full-text indexed .........................................
OLE attachment search doesn’t support Asian languages well ....................................
Preventing a full-text indexing GTR crash during a GTR merge...................................
Search CJK character strings in Text field ....................................................................
Search query troubleshooting and limitations ...............................................................
Setting a character set for full-text indexing plain-text files ...........................................
Syntax: [<fieldname>] IS PRESENT .............................................................................
To eliminate highlight \ attachment re-filtering ..............................................................
Uncleared Search results if document is left opened ....................................................
Verity Keyview Filter Support switches off/on for z/OS .................................................
z/OS HFS expand option for full-text indexes ...............................................................
"Word variant" searches - i.e., "stemming" ...................................................................
Security issues ....................................................................................................................
MIME - Body of message is blank on received encrypted message ............................
Browser caching can interfere with revocation checking ..............................................
Benign Internet Explorer error message .......................................................................
Calculation of password warning date ..........................................................................
Creating a Certificate Authority db requires adding Role to ACL ..................................
Import Internet cert status from Smartcard is not updating ...........................................
Internet Site documents require IP address only for SSL .............................................
Known limitations with SSL and Notes/Domino 7 .........................................................
Missing key file name generates errors in SSL-enabled lookup ...................................
Notes Password History cannot be disabled ................................................................
Problem when trying to create cross-cert by typing in key value ..................................
Smartcard configuration details fail to update for new user ..........................................
Smartcards no longer need to be in the first occupied "slot" .........................................
SSL Session Resumption .............................................................................................
Warning dialog box does not appear before certificate expires ....................................
"No Trusted Root Certificate" error message ................................................................
"The requested item does not exist" error .....................................................................
Server issues .......................................................................................................................
Server - IMAP "Other user’s domain delimiter" Netscape setting .................................
Adding Domino 6 server to 7.0 domain replaces events4.nsf design ...........................
Combinations of statistics/metrics can make Server.load quit. .....................................
Contents
150
150
151
151
151
151
151
151
152
152
152
152
153
153
153
153
153
154
154
154
155
155
155
156
156
156
157
157
157
157
158
158
158
158
159
159
161
161
161
161
162
162
162
162
163
163
163
163
164
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Contents
Domino Java Console - Make LocalDomainAdmins group Multi-purpose ....................
Domino Server Controller - Don’t run in the background on AIX ..................................
Invoking Domino with Server Controller causes exception ...........................................
Java agents on UNIX using 4.6 Domino Java package will fail ....................................
Java controller does not start - IbmX509 not available .................................................
Preventing non-KeyView filtering when using "conversion filters" ................................
RMEval cannot restart when another runjava application is loaded .............................
Running NSD manually can cause Domino to crash ....................................................
Server - Domino Console..............................................................................................
Server Health Monitoring - false ’Server not responding’ status ...................................
Server Health Monitoring - missing components for Linux ...........................................
Server setup error: Special database object cannot be located ...................................
SMTP servers and Symantec AntiVirus Corporate Edition ...........................................
UNIX - Running background Server Controller may cause error ..................................
UNIX - "Could not lock System prefs" error in the Java console...................................
Web Services issues ...........................................................................................................
DWA with Sametime chat/awareness only work with port 80 .......................................
Enumerations are not supported in LotusScript ............................................................
Failure serializing strings with embedded nulls in Java ................................................
Importing WSDL containing xml:lang types ..................................................................
Importing WSDL containing xsd:date-based simpleTypes ...........................................
Improperly serialized derived simple type in LotusScript ..............................................
Init all values to be returned by a LotusScript Web Service ..........................................
LotusScript Constructors called by Web Services sometimes fail ................................
LotusScript Doc/literal services fail ...............................................................................
LotusScript Web services and fixed-size arrays ...........................................................
LS Web Service definitions should all be in Declarations section .................................
Recompile LotusScript Web Services that include lsxsd.lss .........................................
User defined data in WS_Fault subclass are not serialized ..........................................
Web services and Agents should have unique names .................................................
Web services and SOAPENC arrays ............................................................................
164
164
165
165
165
166
166
166
167
171
171
172
172
172
172
173
173
173
173
173
174
175
175
176
176
176
176
176
176
177
177
Chapter 4 - Documentation updates ...................................................................
179
Notes Client Help .......................................................................................................................
Changes in local database encryption depend on compact ................................................
Client - Client configuration (setup) changes in Notes 7 .....................................................
Location must point to server address if LAN connection needed ......................................
Rollover certificates dialog box ............................................................................................
Using keys stored on Smartcards........................................................................................
Workplace Welcome page renamed ...................................................................................
"Local free time info" Replicator page entry shown with old icon ........................................
Domino Administration Help ......................................................................................................
’Linear Growth Correlation’ field in Activity Trends ..............................................................
Corrected spelling for Notes.INI variable DDETIMEOUT ....................................................
Creating a response file using a template ...........................................................................
Creating mail database replicas in a cluster........................................................................
Custom Welcome page deployment requires ACL change to database .............................
DB2 purge interval setting ...................................................................................................
Desktop Policies: deploying a customized My Work Welcome page ..................................
Documentation update: Console_Log_Enabled ..................................................................
179
179
179
179
179
180
180
180
181
181
181
181
181
182
182
182
182
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Contents
Inheriting policy settings requires a parent policy ................................................................
Installing Domino Server - documentation correction..........................................................
International issues in Java-based Domino Console...........................................................
Pushing updated policies to the local cache........................................................................
Removing password policy restores password quality defaults ..........................................
Run missed probes at next interval setting..........................................................................
Scriptable Setup for client install - Sample file ....................................................................
Seamless mail upgrade requires Multi-user install ..............................................................
Server - Setup and Desktop Policies ...................................................................................
Server statistics generated by the Update task ...................................................................
Setting up Domino Web Access with Sametime error .........................................................
Some Domino Admin tools available only with Service Provider ........................................
Starting the Domino server controller as a Windows service ..............................................
Synchronizing Notes client and Domino HTTP passwords .................................................
System and application templates .......................................................................................
Domino Designer Help ...............................................................................................................
Adding actions to right mouse button menus for views .......................................................
Agent and Web services profiling ........................................................................................
Autosave for Notes documents ...........................................................................................
Changes to accessibility for Web applications ....................................................................
Correction to Web Services topic ........................................................................................
Design list usability improvements ......................................................................................
Editing fields in a design element without opening the element ..........................................
NotesDXLExporter SchemaLocation and ValidationStyle ...................................................
Script Libraries for Web Services ........................................................................................
Server requirements for running a Java program ................................................................
Shared columns...................................................................................................................
Domino Web Access Help .........................................................................................................
Certificate information stored in Contact document.............................................................
Errata: Changing Calendar Display Preferences.................................................................
Filter mail using blacklists and whitelists .............................................................................
Valid internet certificate cannot be located ..........................................................................
183
183
183
183
184
184
184
185
185
186
187
187
187
188
188
189
189
189
190
192
192
193
193
193
196
197
197
198
198
198
198
199
Chapter 5 - Notices and Trademarks ..................................................................
201
Licensing information .................................................................................................................
License agreement ..............................................................................................................
Domino includes DB2 UDB components.............................................................................
Licensing information - Excluded Components ..........................................................................
Excluded Components information......................................................................................
Apache Axis 1.1 information ................................................................................................
DNS Resolver software information ....................................................................................
Independent JPEG Group software information ..................................................................
InstallShield information ......................................................................................................
Net-SNMP software information ..........................................................................................
Reg Exp Parser information ................................................................................................
SNIA/CIMOM information ....................................................................................................
S/MIME license information .................................................................................................
zlib software information ......................................................................................................
Notices .......................................................................................................................................
Trademarks ................................................................................................................................
201
201
201
201
201
201
202
203
208
209
210
211
211
212
213
214
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Chapter 1 - About this release
New in this release
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
Welcome to IBM Lotus Notes, Domino, and Domino Designer 7.0
Welcome to IBM Lotus Notes® and the IBM Lotus Domino Server family of software products. Notes/Domino
Release 7 is the latest release of the world's leading products for information management, messaging, collaboration
and application development.
TM
These Release Notes contain information on the many new features and enhancements included in all Notes/Domino
7 products. For an overview of the features in this release, see the "About this release" chapter of these release notes.
Before installing, please review the "Installation, migration, upgrade, and configuration information" chapter of these
Release Notes.
To ensure that you have the very latest version of these Notes and Domino Release Notes, please visit the Lotus
Documentation page at:
http://www.lotus.com/ldd/doc
For exhaustive on-line searches of the README.NSF Release Notes database, without using a full-text index, use the
Search view.
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
Directory install and CD-ROM structure
Notes CD-ROM directory structure
AUTORUN.INF
LICENSE.TXT
README.NSF
README.PDF
APPS
DICTIONARIES
FONTS
SWIFTFILE
IS TUNER FOR LOTUS NOTES
FREE TIME WEB SERVICE DATABASE
CLIENTS
W32INTEL
AUTORUN
1
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Notes/Domino Designer CD-ROM directory structure
AUTORUN.INF
INSTALL.PDF
LICENSE.TXT
README.NSF
README.PDF
APPS
DGW
SYNCINST
DICTIONARIES
FONTS
SWIFTFILE
IS TUNER FOR LOTUS NOTES
FREE TIME WEB SERVICE DATABASE
CLIENTS
W32INTEL
AUTORUN
Domino Intel Server CD-ROM directory structure
AUTORUN.INF
INSTALL.PDF
LICENSE.TXT
README.NSF
README.PDF
APPS
DB2 ACCESS FOR LOTUS DOMINO 7_WIN.EXE
SERVERS
WIN32INTEL
AUTORUN
Domino AIX Server CD-ROM directory structure
INSTALL.PDF
LICENSE.TXT
README.NSF
README.PDF
APPS
DB2 ACCESS FOR LOTUS DOMINO 7_AIX.EXE
IBMPOW
INSTALL
LICENSE
SCRIPT.DAT
SETS
DATA
FGINV
FGROUPS
TOOLS
BIN
AIX
LIB
PERL5
NLS
2
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Domino Solaris/Sparc Server CD-ROM directory structure
INSTALL.PDF
LICENSE.TXT
README.NSF
README.PDF
SUNSPA
INSTALL
LICENSE
SCRIPT.DAT
SETS
DATA
FGINV
FGROUPS
TOOLS
BIN
SOL
LIB
PERL5
NLS
Domino Linux CD-ROM directory structure
INSTALL.PDF
LICENSE.TXT
README.NSF
README.PDF
LINUX
INSTALL
LICENSE
SCRIPT.DAT
SETS
DATA
FGINV
FGROUP
TOOLS
LIB
PERL5
NLS
Domino Linux on zSeries CD-ROM directory structure
INSTALL.PDF
LICENSE.TXT
README.NSF
README.PDF
README.TXT
ZLINUX.TAR.GZ
ZLINUX_CLIENT.TAR
- Domino for Linux on zSeries installation package
- Workstation utility for Remote Server Setup
3
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
Additional items on Notes and Domino CD-ROMs
In addition to the Notes installation files, there are the following items on the Notes and Domino CDs. Please note
that Lotus provides support only for Lotus software in the \APPS directory, and we support it on a best-effort basis.
For other, non-Lotus software applications included in the \APPS directory, please refer to the appropriate third-party
vendor for support.
Domino Global Workbench
Domino Global WorkBench is a fully integrated component of the Domino Designer development environment. Domino
Global WorkBench enables Web application developers to quickly and cost-effectively deliver multilingual Web and
intranet applications.
1.
Documentation
Please refer to online Help for more detailed information about the specifics of using Domino Global
WorkBench 6. Our printable documentation, Guidelines for Developers and Translators, in Adobe Acrobat® PDF
format, is available for download, from the Lotus Web site at www.lotus.com/international.
2.
Overview of features
Please refer to the "What's new in IBM Lotus Notes 7" topic in Help for information about features that are
new in Notes 7.
3.
System Requirements
The following hardware is recommended:
A Pentium® or equivalent processor
A minimum of 32Mb of memory
Approximately 32Mb of hard disk space to install the software
Operating system:
Windows 98®, Windows XP®, Windows 2000® or Windows NT® Release 4 is required to use this product.
To use the WorkBench:
Domino Designer 6 or above
To translate Domino Global WorkBench glossaries:
Notes 6 client, or above, or
Domino 6 server and Internet Explorer 5.5 or later
To use databases built by Domino Global WorkBench:
Server: Domino 6 or above
Client: Notes 6 or above, or a Web browser (see below)
To install the Language Synchronizer:
Server: Domino Release 5 or above
Browsers:
To work with Web-enabled language databases, a browser must be capable of supporting HTTP language detection, for example Netscape Navigator® 4.0 or later, or Microsoft Internet Explorer® 5.0 or later.
4.
Download and Installation
To install from the Notes 7 CD:
Open the Apps\DGW folder and run Setup.exe.
To install after downloading from the Web:
You will have one file, DGW700.ZIP. Download this file to a temporary directory on your hard disk. Unpack it
then run SETUP.EXE which will begin the installation process.
4
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Installation issues
Before installing Domino Global WorkBench, be sure that your Notes program directory is in your path. Add
it if necessary. (For example, in Windows 98, edit your C:\AUTOEXEC.BAT file and add C:\LOTUS\NOTES to
the PATH= statement.)
If you are installing under Windows NT, 2000 or XP, and the user account being used does not have
administrator privileges, you may find that installation terminates prematurely. This is because the install
program is refused permission to copy the Microsoft MFC shared DLL, MFC42.DLL, resulting in install
terminating before it completes. The solution is to ensure that the user account you use to install Domino
Global WorkBench has administrator rights on the NT machine. (For the majority of users this is the case, so
the problem does not arise.)
5.
Glossaries
The design of the Domino Global WorkBench glossary application (DGWGLOSS.NTF) has been enhanced. You
can update the design of glossaries created using earlier versions of Domino Global WorkBench by choosing
File - Database - Replace Design.
6.
Multilingual databases and browsers
The default language of a multilingual database will only be observed if:
1.
You choose a language for your browser that does not exist in the multilingual database, and
2.
No other languages that are used in your multilingual database are present in the language listbox
of your Web browser.
7.
Language switching and browsers
When using Netscape or Internet Explorer to view multilingual databases created with Domino Global
WorkBench, you must remove cached files before you can switch languages from the browser's 'Preferences'
or 'Internet Options' dialog box. This is primarily relevant to developers, during testing.
Workarounds
Netscape: The cache size can be set to zero (0) in the 'Preferences' dialog. Otherwise, the cache must be
emptied, again through the 'Preferences' dialog, when switching languages.
Internet Explorer: The cache size reduction in this browser is limited to 1% of the machine's hard-disk size,
so it cannot be set to zero (0). The cache may be emptied via the 'Internet Options' dialog, or the option to
delete cached files may be set in the 'Advanced' tab of the 'Internet Options'dialog (see below) when the
browser is closed. The cached files are then deleted by closing and then reopening the browser.
8.
Synchronization
The language synchronizer has not changed in this release of Domino Global WorkBench.
Synchronized databases
Performance issues have been noted when synchronizing large numbers of new documents ( > 1,000 ) where
the databases are located on a server other than that on which the synchronizer server task is running. It is
best to locate databases on the same server as the synchronizer server task.
9.
Bi-Directional language support
Domino Global WorkBench includes bi-directional functionality for the Hebrew and Arabic languages. For
details, see the topic "Support for bi-directional languages" in the documentation.
5
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
10.
Chapter 1 - About this release
LotusScript compile and Notes documents
You may encounter problems if you use Domino Global WorkBench to localize Notes documents that contain
LotusScript or formulas. This can happen if:
1.
The form used by the documents contains some LotusScript and has the "Store form in document"
property set (on the Info tab of Designer form infobox). The entire contents of the form are then included with
every document created from it, but the LotusScript is not recompiled as part of the build process, even if it
has been translated. The original (source database) version of the script will execute in the built database.
2.
The documents have hotspots that contain script. This only applies to hotspots in the document
content (in other words, added by the author in a rich text field). All hotspots in document content are signed
as a security measure. Because Domino Global WorkBench cannot sign these hotspots it cannot translate the
associated LotusScript. If the WorkBench encounters LotusScript in a signed hotspot, it issues the following
warning:
Warning: A signed hotspot could not be translated. The untranslated data may include scripts and/or
formulas.
The script is then copied to the target database without any changes (in other words, without tagging or
translation).
Workaround: LotusScript or formulas associated with signed hotspots must be translated by hand in the
Notes 6 client after building is complete.
11.
Editing documents in a projects database
Documents in a projects database are, by default, not editable. If a document must be edited, then it must
be opened and View\Switch Form... selected. The form for the document is then chosen, and the document
placed in edit mode.
If a folder document name is edited in the project database, then the names of any project documents for
this folder must also be modified to match or unexpected results may occur in the WorkBench.
12.
Keywords and values in help documents
Sometimes a Notes application may span several databases, with all keywords and values grouped in help
documents in one of the databases. Formulas referencing the database with the keywords and values will
only continue to work if they contain the correct name of the database file they are calling. When localizing,
you can either translate the database name in the calling formulas, in which case you must take care to
rename the built database to the translated name, or you can leave the database name untranslated in the
calling formulas, in which case the different language versions of the application will have to reside in
different directories. The help documents themselves can be processed in the usual way by Domino Global
WorkBench.
13.
Project icons in Windows XP
In Windows XP, the display of project icons on the left frame of the WorkBench can be obscured if you create
too many of them (more than about 25). You can alleviate the problem by organizing your projects into
folders.
6
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Language dictionary files
The language dictionary files are used for spell-checking within Notes. The following language dictionary files are
included in a self extracting file located in the \APPS\DICTIONARIES directory. Notes automatically installs certain
dictionary files that correspond to your language version of Notes. If you want to use one of the dictionary files listed
below and find that it has not been installed automatically by Notes, simply decompress the contents of the
DICTIONARIES.EXE (DICTIONARIES.SEA for Macintosh) self-extracting file on the CD-ROM to a temporary directory on
your hard drive and copy the appropriate dictionary file (listed below) into your Notes data directory.
Language
Dictionary File Name
Afrikaans*
AFRIKAAN.DIC
Arabic*
ARABIC.DIC
Catalan
CATALA.DIC
Chinese*
CLKCHS.DIC
CLKCHT.DIC
Czech*
CZECH.DIC
Danish
DANSK.DIC
Dutch
Dutch Belgian
NEDERLND.DIC
Dutch Preferred
NEDPLUS.DIC
English (Australia)
AUS.DIC
English (Canada)
English (Caribbean)
English (Jamaica)
English (New Zealand)
English (United States)
US.DIC
English (Ireland)
English (South Africa)
English (United Kingdom)
UK.DIC
Finnish
SUOMI.DIC
French
French
French
French
(Belgium)
(Luxembourg)
(Standard)
(Switzerland)
FRANCAIS.DIC
French (Canada)
CANADIEN.DIC
German (Austria)
German (Liechtenstein)
German (Luxembourg)
German (Standard)
DEUTSCH.DIC
German (Reform)
DEUTSCH2.DIC
German (Switzerland)
DSCHWEIZ.DIC
Greek*
HELLAS.DIC
Hebrew*
HEBREW.DIC
Hungarian*
MAGYAR.DIC
Icelandic*
ISLENSK.DIC
Italian (Standard)
Italian (Switzerland)
ITALIANO.DIC
7
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Language
Dictionary File Name
Medical (American)
Medical (British)
Medical (British IZE)
US.MED
Norwegian (Bokmal)
NORBOK.DIC
Norwegian (Nynorsk)
NORNYN.DIC
Polish*
POLSKA.DIC
Portuguese (Brazil)
BRASIL.DIC
Portuguese (Standard)
PORTUGAL.DIC
Russian*
Russian (Io)*
RUSSIAN.DIC
Spanish
Spanish (Argentina)
Spanish (Bolivia)
Spanish (Chile)
Spanish (Colombia)
Spanish (Costa Rica)
Spanish (Dominican Republic)
Spanish (Equador)
Spanish (Guatemala)
Spanish (Mexico)
Spanish (Modern Sort)
Spanish (Panama)
Spanish (Paraguay)
Spanish (Peru)
Spanish (Uruguay)
Spanish (Venezuela)
ESPANA.DIC
Swedish
SVENSK.DIC
Thai*
SPELLT.GRA
Turkish*
TURKIYE.DIC
* is available for Windows platform only.
Monotype WorldType fonts
TM
Monotype WorldType fonts support Unicode-based display of multilingual text. Five different fonts are available, each
tuned to a different multilingual environment. Subsetting the fonts-based character set usage significantly reduces the
size of a font, thus improving performance. Information about Monotype's Unicode fonts can be found at
http://www.monotype.com.
The following fonts are included in a self extracting file located in the \APPS\FONTS directory:
�
MTSANS_W.TTF -- Monotype Sans WT (True Type) version 5.02 Covers the WGL4 character set. This font is
suitable for use with most uses of the Latin alphabet (including all diacritical marks), as well as Greek, Cyrillic,
Slavic, Turkish, Arabic and Hebrew languages.
�
MTSANS_JOUTLINE.TTF -- Monotype Sans WT J (True Type) Covers the WGL4 character and the Japanese
language with some support for other Asian languages.
�
MTSANS_KOUTLINE.TTF -- Monotype Sans WT K (True Type) Covers the WGL4 character set and the Korean
language with some support for other Asian languages.
8
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
�
MTSANS_SOUTLINE.TTF -- Monotype Sans WT SC (True Type) Covers the WGL4 character set and Simplified
Chinese with some support for other Asian languages.
�
MTSANS_TOUTLINE.TTF -- Monotype Sans WT TC (True Type) Covers the WGL4 character set and Traditional
Chinese with some support for other Asian languages.
These fonts are designed for Windows use only. Execute the self extracting file FONTS.EXE in the \APPS\FONTS
directory on the CD-ROM to decompress the contents to a temporary directory on your hard drive. The fonts can
then be installed using the normal operating system procedure for installing fonts:
On Windows systems:
1.
Open the Control Panel.
2.
Open the Fonts folder.
3.
Choose File - Install New Font.
4.
Specify the drive and directory of the temporary directory containing one the above fonts.
5.
Normally only one of the above fonts should then be selected for installation.
You may want to make a WorldType font your default Multilingual Font in Notes; open the User Preferences -> Basics
panel and set the default Multilingual font in the "Default Fonts" dialog.
SwiftFile Mail Assistant 2.0
SwiftFile is an add-on to the Notes client that helps users file their e-mail into folders. SwiftFile learns to predict
where the user is likely to file each incoming message. Based on its predictions, SwiftFile adds three shortcut buttons
to the top of each message that can be used to quickly file a message into one of the suggested folders. When one of
SwiftFile’s predictions is correct, the effort required to file a message is reduced to a single button click.
Installation
SwiftFile can be installed from the Notes 7 CD by running setup.exe in the Apps\SwiftFile directory. After the
SwiftFile installer completes, follow the directions in the SwiftFile ReadMe file to enable SwiftFile for your mail
database.
International Support
SwiftFile supports all languages supported by Lotus Notes. Multiple languages can be mixed within the same
database and even within the same document without adversely affecting SwiftFile's prediction ability.
System Requirements
Windows 98/NT SP4/2000/XP
32 MB RAM
10 MB free disk space
Lotus Notes 7 or later
InstallShield Tuner for Lotus Notes
Creating a transform file to customize the IBM Lotus Notes 7 client installation package requires a third-party tool,
such as InstallShield® Tuner. Lotus Notes 7 contains an OEM version called InstallShield Tuner for Lotus Notes that
lets you create customization transforms to add resources, change defaults, or hide features present in the standard
Lotus Notes 7 kit. Note that InstallShield Tuner for Lotus Notes works with both Lotus Notes 7 client packages (Notes
only and All Clients), but cannot be used to customize any other MSI packages.
To install InstallShield Tuner for Lotus Notes, run setup.exe from the Apps\InstallShield Tuner for Lotus Notes folder
on the Lotus Notes 7 Installation CD.
Please note that IBM Technical Support does not provide assistance for InstallShield Tuner for Lotus Notes. However,
InstallShield Tuner for Lotus Notes does include comprehensive online help to familiarize you with the process of
customizing an industry-standard Windows Installer (.MSI) package. For additional details about InstallShield Tuner
OEM, please visit the InstallShield web site at http://www.installshield.com.
9
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Free Time Web Service database 7.0
The Busy Time Web Service database (BUSYTIMEWS.NSF) allows a Domino Server to provide busy time information
about the users in its Domino Directory through a Web Service.
This is a sample application and may change in future releases.
Using this Database
This is a sample application and may change in future releases.
Accessing the Web Service
The Domino 7.0 server now does free/busy time lookup for meeting attendees whose names are Internet e-mail
addresses. If an attendee whose name is an Internet e-mail address is in the same Domino Domain as the server,
the server obtains the attendee's free time information from the Free Time database (BUSYTIME.NSF) as usual. If
the attendee is not in the local Domino domain, the server sends the lookup request to the Web Service gateway,
wsconn. Wsconn then makes a Web service request for the information to the Web service defined by the
NOTES.INI variable WSCALCONN_URL. The URL should have the following syntax for a remote Domino server
providing the Web service:
http://host/busytimews.nsf/busytimelookup?OpenWebService
To run wsconn at server startup, add wsconn to the NOTES.INI variable ServerTasks.
Any Web service client can obtain free time information using this Web service
Providing the Web Service
To provide the web service on a Domino server:
1. Add a new person document to the Domino directory that includes an HTTP password. No Notes ID is
required for this user.
2. Modify the ACL of the database BUSYTIMEWS.NSF to give this user Reader access.
3. Provide this user's name and HTTP password to the manager of the server or Web service client that wants to
access the Web service.
Tip: Use a full name without spaces to make the use of this name in URLs easier to manage.
Obtaining the WSDL of the Web Service
To obtain the WSDL (the formal definition of the Web Service, encoded in XML) for this Web Service, use the
following URL:
http://host/busytimews.nsf/busytimelookup?WSDL
Securing the Web Service
You can secure the Free Time Web Service by doing one of the following:
�
Protect the service using HTTP transport level security. To do this, create a new user in the server's Domino
Directory and assign that user an HTTP password. The user does not need a Notes ID. Then set the database
ACL for BUSYTIMEWS.NSF to "no access" for Default and "no access" for Anonymous. Set the access for this
new user to Reader.
To provide the user name and password when a Domino server accesses this Web service, include the
username and password in the URL as follows. Remember that URLs cannot contain spaces.
http://username:[email protected]/busytimews.nsf/busytimelookup?OpenWebService
�
Encrypt the data exchange with the Web service using SSL. You can do this if the server's Web server is
configured to support SSL and the URL contains HTTPS rather than HTTP.
10
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
IBM DB2 Access for Lotus Domino
IBM DB2 Access for Lotus Domino is a server that acts as an extension to DB2, in order to enforce Domino database
security (such as ACLs and reader lists) for DB2-enabled data. If IBM DB2 Access for Lotus Domino is not installed
properly, the DB2 Designer functions will not be available, and you will not be able to access DB2 using SQL. IBM
DB2 Access for Lotus Domino facilitates your use of the Designer view functions for DB2 by enabling Domino's user
security. Install and enable IBM DB2 Access for Lotus Domino to allow DB2 to access Domino data.
Be sure to install IBM DB2 Access for Lotus Domino on the DB2 server which hosts Notes data. This can be the same
computer on which Domino is installed for a local configuration, or it may be a different computer in a remote
configuration. When you install IBM DB2 Access for Lotus Domino, a DB2 Access Server Connection document is
created when the Domino server is started. This DB2 Access Server Connection document connects IBM DB2 Access
for Lotus Domino and a Domino server that you designate using the Domino Administrator.
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
Help databases - usage and availability
Lotus Notes 7 and Lotus Domino 7 include Help databases for Lotus Notes, Lotus Domino Designer, and Lotus
Domino Administrator (Server). The Help databases are installed by default in the HELP directory of your Notes or
Domino data directory.
Title
Database file name
Description
Lotus Notes 7 Help
HELP7_CLIENT.NSF
Lotus Notes Client Help
Lotus Domino Designer 7
Help
HELP7_DESIGNER.NSF
Lotus Domino Designer and programming language
Help
Lotus Domino Administrator
7 Help
HELP7_ADMIN.NSF
Lotus Domino server and Lotus Domino
Administrator Help
You can access Help in the following ways:
�
Click the link to Help on the Notes, Domino Designer, or Domino Administrator Welcome pages
�
Choose Help --> Help Topics from the menu bar
�
Press F1
�
Click the "?" in the top right corner of most dialog boxes
�
Choose File --> Database --> Open and browse to your local directory or a Domino server
�
Visit the Domino and Notes User Assistance Web site at http://www-10.lotus.com/ldd/notesua.nsf/
11
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Domino Administrator Client, Domino Server
Please replace Administrator Help file with updated version
The Domino Administrator Client Welcome screen includes the link "Upgrading to Release 7 . . .". If you click on that
link, you will see the following error message:
To resolve this issue, please download and replace your Lotus Domino Administrator 7 Help file with an updated
version available on the developerWorks Lotus website at: http://www-10.lotus.com/ldd/doc.
Your Lotus Domino Administrator 7 Help file is located in the Notes/Data/Help directory.
Domino Administrator Client, Domino Server
Upgrading to Lotus Notes 7 and Domino 7 documentation
The "Upgrading to Lotus Notes 7 and Domino 7" documentation will be updated at a later time. See the
developerWorks Lotus web site for the updated "Upgrading to Lotus Notes 7 and Domino 7" documentation when it is
available.
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
Release notes - updated information available on-line
The Release Notes that are available on-line are more up-to-date than the Release Notes that are shipped with the
product. This is due to production schedules; after the product ships, updates are sometimes made to the Release
Notes and posted on the Lotus developerWorks website.
To ensure that you have the very latest version of the Notes and Domino Release Notes, please visit the Lotus
Documentation page at:
http://www.lotus.com/ldd/doc
12
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
New features
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline Services (DOLS), Domino for z/OS, Domino for i5/OS
Overview - New features in IBM Lotus Notes and Domino 7
The following list represents an overview of the new features that are available in IBM Lotus Notes and Domino 7. For
more comprehensive information about new features, please refer to the on-line Help files, and to the Documentation
Updates chapter of these release notes.
Client
Accessibility
�
You can designate row and column headers in tables so that screen-reader applications can detect them.
Desktop
�
New menu option (File - Close All Window Tabs) allows a user to quickly close all open windows.
�
No longer necessary to wait while a view which needs updating is being opened.
�
IBM Workplace has been integrated into the Welcome Page Wizard, allowing users to create multiple Workplace
welcome pages.
�
Users can now save their open window state on shutdown. For example, if a user has 5 windows open, then shuts
down Notes, those 5 windows will open when Notes is restarted.
�
Preferences set via policies (both Desktop and Mail) can now be locked down by the administrator.
�
AutoSave option for selected documents (see Designer section below).
Calendar and Scheduling
�
A new Calendar Cleanup action allows users to easily and quickly delete old entries from their calendar.
�
AutoProcessing can automatically accept a Calendar event even if there is a schedule conflict.
�
In the Calendar View, display of calendar entry information has been extended from 4 to 9 lines.
�
Conflicting Calendar entries are now optimized in the Calendar view, instead of spanning multiple columns.
�
Users can cancel Calendar/Scheduling workflow when Sending with comments.
�
The ability to filter data in Calendar views in the mail template by Type, Chair, and State has been added.
@GetViewInfo(. . .) has been extended to return 'True' if the view is filtered @GetViewInfo([IsViewFiltered])
�
The Calendar Mini-view has the ability to be expanded and collapsed.
�
Calendar Managers can now mark messages for follow up in mail files that they manage.
�
Calendar Managers: mail forwarded by a calendar manager will now be created/saved in the correct mail file.
�
Meetings now allow you set up the Online portion of the meeting to restrict attendees to only those on the invite
list and to provide a password for the online meeting.
�
Meetings View renamed to All Calendar Entries and has new views and many usability improvements.
�
Embedded graphics in the Description field now appear when sending an Invitation through iCalendar.
Rooms and Resources
�
Users are able to specify a preferred site and a preferred list of rooms/resources to use when scheduling
meetings.
�
There is the ability to see which rooms/resources are restricted when scheduling meetings.
�
Rooms and Resources workflow changed to eliminate double bookings - Rooms or Resources booked directly
through the R&R database now get processed in the same way as Rooms/Resources booked through Calendaring
and Scheduling.
13
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
�
Rooms and Resources template has usability improvements to forms and views, including a simple form to create
a reservation, and the ability to transfer a reservation.
�
Administrators can limit how far in the future reservations can be made in the Resource Reservation database.
Users who attempt to book a room or resource over the administrator set limit will receive a separate decline
notice that will tell them that their reservation exceeded the limit.
�
Administrators can set automatic reminder notices to be sent to the Chairperson who booked a particular room
and/or resource, so that if a meeting is cancelled, the room and/or resource can be released.
�
Room & Resources databases may now have replicas. If there are replicas of Rooms & Resource databases in a
cluster, the Rooms & Resource Manager will take advantage of this and automatically fail over processing of
requests when the responsible clustermate becomes unavailable.dministrators can now set up Room & Resources
Manager to prevent overbooking of rooms and resources by users.
Mail
�
Users are warned if no Subject has been entered in a document.
�
A new status bar icon indicates whether e-mail you receive is digitally signed, encrypted, or both.
�
New icon indicates whether a mail item was sent to the recipient only; no cc: or bcc: recipients.
�
Sort by Subject is now available on the Inbox and other views in Mail.
�
Added Delivery Option to allow Personal Groups to remain collapsed.
�
Mail Rules support for: Stop Processing Action, BlackList/WhiteList spam, and Form name.
�
Attachment processing has been improved; users are warned to save edits to attachments before closing the
Notes editor window.
�
The Quick Follow Up feature allows a user to flag a document or set of documents for Follow Up, without
displaying the Follow Up dialog box, by using defaults that are set in Preferences. Also, the user can now display
the Follow Up dialog box by dragging and dropping to the Follow Up view.
�
Follow Up actions are available via the right-click mouse menu.
�
The right-click mouse menu options have been optimized for ease of use.
�
Mail threads can now be displayed as part of the Memo header.
�
Mail views now have a new Folder action - Discover Folders - when a document is selected in the view, and the
Folder-Discover Folders action is selected, a dialog box will be displayed showing which folders the selected
document is in.
�
When upgrading a folder design manually, you can now choose to base the design on All Documents.
�
Mail Preferences can now be set via policies, allowing administrators to roll out a single set of preferences to all
users. These preferences can be locked down by the administrator so that the end user cannot modify them.
�
Users can now display a view level icon within the Inbox that shows if they are the only one, or one of a few listed,
in the "To" and/or "cc:" field.
�
A 'Date/Time deleted' column has been added to the Trash folder.
�
Archiving - UI usability improvements.
�
Archiving - Creation Date can now be used when archiving.
�
Archiving - Administrators can now set a maximum retention time for archiving.
�
Archiving - Administrators can now use a custom generated expiration field.
Roaming
�
When Roaming users with the same name cannot be distinguished, an error message is displayed.
Interoperability
�
Smart Tags integration - Access to Notes is available using the Smart Tags feature in Microsoft Office XP. Smart
Tags work by recognizing certain types of text (for example, person names), and then offering related functions
and commands. You can now send Notes mail, show name details and/or invite the person to a meeting.
14
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Template
�
Lotus Instant Messaging and Web Conferencing (formerly Sametime) integration has been added to the Mail,
Calendar, and Scheduling views; to the Teamroom and Discussion templates, to the Personal Name and Address
Book; to the Domino Directory; and to the Rooms and Resources template. Users can see who is online,
indicated by a Globe icon, and click a button to start a chat session.
�
The TeamRoom and Discussion templates, Rooms and Resources, and Document Library, support Mozilla
browser.
Instant Messaging integration
�
Chat transcripts can now be saved to a "Chat transcript" view in a Mail database.
�
The 'File' menu bar now includes Instant Messaging options.
�
Notes Instant Messaging Chat windows are now in a separate thread - they are no longer blocked when the Notes
client is blocked.
�
Notes Instant Messaging buddy Contact list can now be minimized to the Windows task bar.
�
Notes Instant Messaging preferences now support three new options for when a new IM message or invitation
arrives: Bring message window to front, Blink window and Play sound.
�
Instant Messaging preference options have been added to the Status bar.
�
Notes Instant Messaging buddy Contact list includes three new options: Show online people only, Show short
names, and Sort list.
�
The 'Create' menu bar item now includes Instant Meeting options.
�
If your Sametime server includes Web conferencing capabilities, Notes Instant Messaging Meetings now support
Screen Sharing, Whiteboard, Audio and Video.
�
If your Sametime server includes Web conferencing capabilities, the Toolbar now has icons for Screen Sharing,
Whiteboard, Audio and Video Instant Meetings.
�
Notes URLs can now be pasted into and activated within Notes Chat windows.
�
Auto-reconnect to a Sametime server when that server goes down is allowed.
Notes Application Plug-in for use with the IBM Workplace Collaboration Services Managed Client
�
The Notes Application Plug-in is included as part of the Notes / Domino 7 release, and is designed to work in
conjunction with the IBM Workplace Collaboration Services 2.5.x Managed Client. For more information, see the
IBM Workplace Collaboration Services 2.5.x release notes.
�
The Workplace document repository is available for selecting files to attach and detach from a Notes Rich text
field.
Designer
DB2 Access View and DB2 Query View
Support for DB2 data store is introduced with Domino 7. For more information about this new feature, please refer to
the Domino 7 Designer Help documentation.
�
DB2 Access View is a new design element available for DB2-enabled databases.
�
DB2 Query View is a new type of view available for DB2-enabled databases. Query views display a unique view
icon.
Forms
�
Designers now have the ability to specify that a form supports AutoSave - documents being edited with that form
will be saved out locally based on a user specified time, so that they will be available after a system failure/crash.
Users will also have the option to save out documents that use that form to the local store in the event the server
they were working on goes down.
15
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Fields
�
Text, Names, Dialog List, Radio Button and Check box fields now respect the Input Enabled method.
Views
�
Application developers can now have actions added to right-click menus in views.
�
View Shared Column support has been added.
�
Support for multiple "User Profile" columns in a view
UI
�
The design lists have been redesigned for better display of information, and to provide the Designer the ability to
edit design elements directly in the design lists.
�
A new toolbar icon to toggle the LotusScript debugger state also shows the state of the debugger (on/off).
�
Java debugger support allows Designers to prepare design elements that contain Java code for subsequent
debugging by using the checkbox provided for agents, web services, and script libraries. A remote Java Debugger
(like Eclipse) can then be attached to the Notes Client JVMs in order to debug those design elements.
�
There is a new dialog box available (Tools-Java Debugging Preferences) to set required variables for Java
debugger support.
�
New design element to create a web service.
�
Agents can now be enabled for Agent Profiling and the results of the profiling can be viewed from the Designer.
Domino Web Access
�
A new Domino Web Access client template (dwa7.ntf) is available to provide new features in a concise user
interface for the browser.
�
Mail threads can be viewed while reading mail, or from the Mail Threads view.
�
Users can sign, send, and read S/MIME messages.
�
Users can create their own personalized Stationery, which can be used for their mail messages.
�
Users can import country-specific holidays into their calandar.
�
The Instant Messaging awareness integration more closely mirrors the Notes client awareness features.
�
The "IBM Lotus Instant Messaging and Web Conferencing Connect for browsers" client is integrated as the default
Instant Contact List manager.
�
Productivity enhancements including:
�
�
�
�
Single-click Followup support
Quick Mail Rule support
Ability to forward any Domino Web Access object in a message
Mozilla-specific improvements including:
�
�
Drag and drop support
Offline support for scheduled synchronization
�
Administrators can prohibit access to attachments in Mail, Calendar, and Scheduling events (via the Domino
Web Access server configuration document).
�
Administrators have a Browser Cache Management option to support IE browser cache scrubbing (via the
Domino Web Access server configuration document).
�
Administrators can configure the Domino Activity Logging to tracking Domino Web Access requests and usage.
16
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Lotus Domino Access for Microsoft Outlook
IBM Lotus Domino Access for Microsoft Outlook allows Microsoft Outlook users to use many of the Domino/Notes mail, address book, calendar, and scheduling functions over a Domino server (instead of Microsoft Exchange) including:
�
Changing the owner of their mail database
�
Changing their password in Domino Access for Outlook
�
Setting up user security
�
Customizing replication settings
�
Setting up an out-of-office message
�
Setting up their free time schedule
�
Processing meeting invitations automatically.
�
Users can sign, send, and read S/MIME messages.
Domino Server
Administrator
�
1
DB2 administration support has been added, including:
- A tool to enable Domino to run with a DB2 data store
- An integrated API to allow DB2 users/passwords to be added
- Support in the Status and Analysis panels
- A tool to allow configuration of a connection document from DB2 to Domino
- Ability to create and use Domino Access Views (DAVs) and SQL Query Views on some platforms
�
Support for Domino Domain Monitoring (DDM) has been added, including:
- A DDM administrative UI
- The ability to combine information generated on one or more DDM-enabled servers into one database on
another server.
- A database probe that ensures a database(s) can be opened. Optionally, the database(s) can be checked
for unused space and for user inactivity, according to configurable thresholds.
- A database probe that monitors key locations in the database software layer (NSF/NIF), and generates
events for errors that occur; because some errors occur naturally, an error exclusion list can be configured.
- Directory probes that include checks for: the health of the LDAP task and associated user response,
directory replication, directory indexing, NRPC and secondary LDAP search response times, directory
aggregation of source-to-destination, scheduled aggregation for missed or long-running aggregations,
availability of directories and secondary LDAP/Notes domains, and view/update LDAP serving reports.
- Mail probes that include: verification of local mail routing by sending a message to a known destination
and verifying its delivery, alerting the administrator to the number of inflight messages if the router cannot
keep up with the mail flow, and alerting the administrator when too much mail is pending to a particular
destination, or if mail to that destination is failing.
- SMTP probes that: verify mail can be delivered to a SMTP recipient via a Delivery Status Notification (DSN)
report, check the SMTP task by verifying the processes threads, and verify protocol requests by connecting to
the appropriate port and performing a minimal protocol-specific conversation.
- Replication probes that check for: replication errors, for databases which have not replicated according to
their configured schedule, for last successful replication, and for replication conflicts, including doclinks to
the replication conflict documents.
- Security probes that include: verification of a database ACL against a pre-determined configuration, and a
check for inconsistencies in security configurations across multiple servers based on a "gold standard" set of
configuration values.
17
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
- Agent probes that report total number of agents run, agent security errors, time-out errors, agents diabled
by the Design Update task, full-text operations performed against non-indexed databases, CPU usage,
memory usage by LotusScript and Java agents executed by Agent Manager and HTTP, and agents that run
long or start late.
- Integration of the Tivoli Autonomic Monitoring Engine (TAME) into Domino, which provides event reporting
capabilities to other Tivoli Interfaces (i.e., Tivoli Enterprise Console), and which provides a framework for
third-party Resource Module plug-ins to evaluate/report on Domino and OS resources.
- Domino Resource Modules, built for Domino TAME, can report CPU, memory, disk, and network utilization
statistics. The resource modules are configured with and report to DDM interfaces, and to Tivoli Enterprise
2
Console .
�
Ability to write status bar history to a log file
�
Ability to supress the Roaming User Upgrade prompt
�
The new Domino Web Administrator now supports Mozilla browsers.
�
Three new event notification methods which are programmable via LotusScript, batch language, Java, C, etc.
�
An enhanced Message ID feature allows a message ID to be prefixed to console messages, via the Notes.INI
settings Display_MessageID=1, and Display_MessageSeverity=1.
�
The Administration process will no longer automatically revert name changes and will require that the
administrator either approve or reject the name change reversion. For additional information about this feature,
please see "AdminP - Rename Reversion Approval" in these release notes.
DB2
�
1
Support for DB2 data store is introduced with Domino 7. For information about this new feature, please refer to
the Domino 7 Administration Help document.
Directories
�
Aliases have been added. An alias is an entry in an LDAP directory which points to another entry in the directory;
on a search request the derefAlias protocol element specifies whether to dereference the alias to the entry it
points to, or not. For example, specifying an alias of "cn=Bruce Kent,o=ACME" as the base and
"derefAlias=Always" on a search request returns the entry the alias points to, cn=Bruce Kent,ou=Boston,o=ACME.
The Domino LDAP service supports limited alias dereferencing for LDAP search requests.
�
The Domino 7 LDAP service now supports Universal Notes IDs (UNID) through 32-character values of the new
"dominoUNID" operational attribute.
�
LDAP searches have been enhanced to work with IBM Workplace products that use the WebSphere Member
Manager (WMM) service to access user/group objects.
Install
�
Enhancements to Smart Upgrade include:
- Detaching kits in the background, to prevent time lost to a non-working client
- Failover from a shared (network) upgrade kit to another server's attached kit
- If clustered, use of a cluster mate if the first server is unavailable
- Prevent excessive server load by limiting the number of downloads from a single server
- Notification to administrators, via a mail-in database, of the Smart Upgrade status by user/machine
(Success, Failed, or Delayed)
- Provisioning of Smart Upgrade Tracking database
�
ISMP - a new Java-based installer for Windows from InstallShield. For additional details, please visit
http://www.installshield.com.
18
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Java
�
A new version of Java; JVM 1.4.2.
�
Ability to remotely debug Java code (agents, script libraries, and Web previews) in the Notes client.
LEI
�
Enterprise failover support in the Domino cluster environment is provided, so that if one server in a given
implementation fails, activities continue processing on secondary, or subsequent, servers.
�
The LEI Administrator incorporates new functionality such as Lotus Instant Messaging and Web Conferencing
awareness, and form-based connection testing.
�
Ability to control how dependent activities are run, based on the results of the calling activity.
�
Ability to have Data Management activities that use Notes connections to run under different Notes IDs.
�
Domino remote script debugging will now be able to debug the scripts used in Scripted Activities.
�
Scripted Activities now record the connections used by the scripts, providing improved servicability.
�
LEI, DECS and the LSXLC are now fully integrated into Domino's NSD services.
�
LEI scheduling dexterity is now improved, with better handling when you need to "RESTRICT TO SCHEDULE".
�
LEI Connection documents let you directly test your connections for validity.
�
Virtual Documents now properly handle backend update and deletion synchronization
Mail/Messaging
�
Private whitelist filters for SMTP connections
�
Private blacklist filters for SMTP connections
�
DNS whitelist filters for SMTP connections
�
The new delivery option preference default for "Do not expand personal groups" is customizable.
�
Stop processing action available for mail server rules
�
Ability to create and add message disclaimers to email messages
Network
1
�
IPv6 protocol support has been upgraded to include additional platforms and services .
�
CIDR format now supported in IP address pattern strings
�
IOCP support in Linux Intel
�
New configurations of SPX are not supported for Domino 7.
�
Private blacklist/whitelist filters for SMTP connections; DNS whitelist filters for SMTP connections
Performance
�
An internal API gathers CPU times for the Domino Domain Manager.
�
CPU utility and performance statistics are gathered and analyzed using an improved process.
Policies
�
New Mail policy settings document
�
New client policy lockdown feature allows you to specify which policy settings can be modified by end users.
19
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Programmability
�
New formula function @PolicyIsFieldLocked
�
New formula command @Command([DiscoverFolders]) will bring up a dialog showing all folders the current
document is within.
�
New @function: @IsEmbeddedInsideWCT to determine if Notes is running embedded within a WCT rich client
�
New @function: @DbBuildVersion to determine what server version there is for a database
�
New @functions: @DB2Schema and @IsDB2
�
New properties and methods:
- NotesAdministrationProcess.ApproveHostedOrgStorageDeletion (LotusScript) and AdministrationProcess.approveHostedOrgStorageDeletion (Java)
- NotesDatabase.GetModifiedDocuments (LotusScript) and Database.getModifiedDocuments (Java)
- NotesDocumentCollection.UntilTime (LotusScript) and DocumentCollection.getUntilTime (Java)
- NotesDOMDocumentNode.CreateAttributeNodeNS, CreateElementNodeNS, GetElementsByTagNameNS
(LotusScript)
- NotesDOMElementNode.GetAttributeNodeNS, GetAttributeNodeNS, GetElementsByTagNameNS,
RemoveAttributeNS, SetAttributeNodeNS, SetAttributeNS (LotusScript)
�
Web services (provider entities) can be created as LotusScript or Java design elements and accessed through a
Domino server.
�
Performance Profiler for Java and LotusScript Agent and Web Services.
�
Integration of a new version of XML parser.
Security
�
Domino 7 supports the use of 1024-bit RSA and 128-bit RC2 Notes keys.
Serviceability
�
Autonomic Diagnostic Collection - This feature is used to evalutate call stacks that are generated from a Notes
Client or Domino Server crash via the Automatic Diagnostic Collection feature that was first introduced in Release
6.0.1 of Notes and Domino. It adds to the functionality of the Automatic Data Collection feature by analyzing the
call stacks that are located in the Fault Report mail-in database and evaluating to see if there are other instances
of the same problem.
�
When using the automatic diagnostic collection tool to gather information about server crashes, the server is now
first checked to see if it is being run under the Domino Controller and, if so, uses the Controller logs. If not, the
server is checked to see if console logging is enabled and, if so, uses the console output. Finally, data is
extracted from log.nsf if neither the Domino Controller nor console logging has been set.
�
Customers can configure what files (using wildcards) will be collected by the automatic diagnostic collection tool
when it runs on clients or servers. This allows for the option to collect diagnostic files from other IBM products as
well as third-party add-ins.
�
When the "quit" or "restart server" command is issued to the server, and the server doesn't terminate in the alloted
time, then the server will forcefully terminate and an NSD log will be generated before termination. The time limit
is specified in the "Automatic Server Restart" section of the server document in the Basics tab; the default is 5
minutes. This time limit is the time that no shutdown activity occurs; when a process successfully terminates
then the timer restarts. This feature can be disabled using the Notes.INI setting
SHUTDOWN_MONITOR_DISABLED=1.
20
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Web Server
�
DB2 management features are now available from Domino's Web Administrator client.
�
Support for web applications to compress data sent to HTTP servers.
�
The Web Administrator client works in Mozilla browsers (Mozilla 1.7.x or higher).
�
JSP tags work in Portal.
Footnotes
1
These features do not apply to i5/OS for the current release.
2
For the current release, Domino Resource Modules built for Domino TAME can report CPU and memory utilization statistics on z/OS; and CPU, disk, and network statistics on Domino for Linux on zSeries.
Domino Administrator Client, Domino Designer, Domino Server
DB2 feature in Domino 7 released with Limited Availability
Domino 7 with DB2 - Limited Availability
Domino 7 with DB2 is released with Limited Availability; as such, it is not available for general usage, but is provided for evaluation purposes only. For more information about the Limited Availability program and other important information on this topic, see the URL http://www.ibm.com/lotus/nsfdb2.
To enable Domino 7 with DB2, you'll need the DB2 key for Domino, and DB2 Access for Domino.
�
To enable DB2 functionality within Domino, add the DB2 key to the Domino Program directory. The default
Domino Program directory on Microsoft Windows is C:\Program Files\Lotus\Domino; the default Domino
Program directory on IBM AIX is /opt/lotus/ibm.
�
To view and manipulate Notes data through DB2 using the DB2 Access View (DAV) and Query View features
introduced in Domino Designer 7, download "DB2 Access for Lotus Domino 7".
Domino Web Access
New Features in Domino Web Access 7
This release note provides a general overview of new features in Domino Web Access 7.0. For additional information about these features and other updates to the Domino Web Access documentation, see the Documentation Updates -
Domino Web Access section of these release notes, or the Domino Web Access 7 help.
Disable drag and drop -- Users can set a Calendar preference to disable drag-and-drop and in-place editing, in their Calendar. This feature is documented in the Domino Web Access 7 help.
Prohibit access to attachments -- Domino administrators can use a new NOTES.INI setting to prohibit access to attachments in calendar and scheduling documents, online meetings, and e-mail. For more information about this feature, see the Domino Administrator 7 Help topic "Editing the Configuration Settings Document for Domino Web Access."
Instant Messaging -- The integrated Instant Messaging feature is more robust and more closely mirrors the Notes
client awareness features. Name awareness has been added in views such as Contacts, Calendar and Scheduling, and
meetings, with right-click menus available for each of the views. New in 7.0, Domino Web Access users will be able to
use the Lotus Sametime Connect 6.5.1 contact list manager, and will be able to share contact lists with the Notes
client. For more information about this feature, see the release note "Instant Messaging enhancements in Domino Web
Access" in the Documentation Updates - Domino Web Access section.
Import Corporate holidays -- Through preferences, users can import holidays into their calendar using predefined sets
that are country specific. This feature is documented in the Domino Web Access 7 help.
21
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Mail Threads -- Users can now view mail threads, which groups a message together with the responses to it. Mail threads can be viewed from the Mail Threads view, or when reading mail. To view mail threads when reading mail, users set a Mail - Display user preference. This feature is documented in the Domino Web Access 7 help.
S/MIME support -- S/MIME is now supported in Domino Web Access. For more information about S/MIME support in
Domino Web Access, see the release note "S/MIME support in Domino Web Access" in the Documentation Updates Domino Web Access section.
Stationery -- Users can create stationery that they can re-use for their mail messages. The stationery can include text
and graphics and other optional information, such as mail delivery options. Users can create standard stationery that
includes recipients, which is useful for messages that routinely get mailed to the same group of people. They can also
create personal stationery that can include personalized text or graphics. This feature is documented in the Domino
Web Access 7 help.
Notes Client
Notes Application plug-in for IBM Workplace Managed Client
The Notes Application Plug-in is included as part of the Notes / Domino 7.0 release, and is designed to work in conjunction with the IBM Workplace Collaboration Services Managed Client. The IBM Workplace Managed Client is a new offering that utilizes IBM Workplace Client Technology. For purposes of these Release Notes, IBM Workplace Managed Client will be referred to simply as the "managed client" below. System Requirements
In addition to having the IBM Workplace Managed Client 2.5 installed, the following are required:
�
IBM Lotus Notes 7 Client for Windows, installed on the same machine as the managed client
�
Minimum System Memory 512 MB (recommended 1 GB)
�
Diskspace of 275MB
Configuration Instructions
�
Install IBM Workplace Managed Client 2.5.
�
Install IBM Lotus Notes 7 Client
Operating Instructions
�
The Notes applications are accessed via the managed client by selecting from the Switcher Bar and selecting the
Notes Applications icon.
�
The Notes Application component provides access to your Notes Applications which can be selected through the
Notes Application navigator. Initially the application displayed will be the default page configured for the Notes
client.
�
Once the Notes Application is active the menus available to the Notes Client will also be available from within the
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 IBM
Lotus 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. Notes Auto Logout is not putting up the Logout screen in the managed client. The databases are locked and cannot be edited without a password, but the top database is visible. 22
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
4. If a database is open in Notes, and you try to open the same one in the managed client, it will not open. However,
if you open it 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.
5. If you have Designer opened and you open a database in the managed client, you cannot close Designer until the
Workplace client has been closed.
6. 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.
7. The Startup folder bookmarks are not available from the Notes Application navigator.
8. Some Accelerator keys that move the main window are not available when accessing Notes applications in the managed client. 9. When clicking on the 'X' to close a document, if the document needs to be saved, the tab disappears and then you
are prompted to save your document. If you are closing several documents, you will not be able to tell which
document is prompting you to be saved. If you click Cancel, the tab will be restored and will allow you to close it
again.
10. Hitting the F10 key with a Notes database open and then clicking on the top-level menu will cause the managed
client to hang. You must restart the managed client to recover.
11. Clicking on a database bookmark will sometimes bring up the "Search for Database" dialog. However, if you
right-click on the bookmark, select "Open Replica," and choose your database from there, it will open correctly.
12. If the 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.
13. Double-clicking on an attachment from a document that is in the Autosave directory will display the error
message "Note item not found" and the managed client will hang.
14. When working with an outside application, such as IE, if you give focus back to the managed client by clicking on
the File menu in the Notes Application view, your application could hang. When giving focus to the managed
client, we recommend you click on the title bar or within a view and then select the menu.
15. 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.
16. 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.
17. 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.
18. 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.
19. 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.
20. If you cancel out of the password prompt while opening Notes from within the managed client, you must restart
the managed client in order to be able to reopen Notes.
21. If you cancel out of the password prompt while opening Notes from within the managed client and then select File
- Database - Open, Notes crashes and you must restart the managed client.
22. 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.
23. 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.
23
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Domino Administrator Client
Server.load new features in R7
Following are the new Server.load features introduced in Domino 7. Please see the Domino Administrator Help
database for complete information on these new features:
1. New Server.load script commands
SetReplID
Sets the database replica ID.
DBClose
Closes the open database.
CheckForNewMail
Checks for new mail on the specified mail database.
NewReplicateDB
Creates an empty replica of a database
2. Workload data rollup feature
The Server.Load workload data rollup feature allows test data from a group of test drivers and a SUT to be
combined into a single datafile for analysis.
3. Server authentication now optional
The field "Server to receive Console Commands" in the Server.load metrics window can be left blank for
workloads & scripts that do not need to authenticate with a server, such as the new Workload Data Rollup
script. Also this allows scripts such as internet based mail to be run without NRPC authentication, so you
could create a custom script that uses SMTP and POP3 against any type of mail server, such as an IBM
Workplace mail server.
4. Collection of per-command response times in Server.load
NB_Collect_Response_Times in the test driver's notes.ini will enable output of per command response times.
The file will be in the resultsdirectory and will have the name RespTime_OutFile-#, where # is the driver
number.
To enable collection of per-command response times add the following settings to the client driver's notes.ini
file:
NB_Collect_Response_Times=1
RESULTSDIRECTORY=Z:\
To disable collection of per-command response times set NB_Collect_Response_Times=0 or remove the ini
setting.
5. Agents and files in namagent.nsf have been updated for new workloads.
See the Using This Database document in namagent.nsf
6. Domino SSL in the R6IMAP workload
To enable SSL in the R6IMAP workload add the following setting to the client driver's notes.ini file:
NB_SSL_OPTION=USE_SSL
To disable SSL in the R6IMAP workload remove the notes.ini setting. Issue: for this release you must put a
space in the Server.load script variables window for this variable if you are not using SSL.
The R7 Server.load client can be used to drive an SSL R6IMAP workload on a Domino R6 server.
24
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
New enhancements
Domino Server
AdminP - Rename Reversion Approval
The Administration process will no longer automatically revert name changes and will require that the administrator
either approve or reject the name change reversion.
In order to provide uninterrupted access to users' databases while a name change is in progress, there is a period of
time where both the old and new names will be allowed access to the systems and databases. This period of time is,
by default, 21 days, but may be defined by the administrator when the rename is performed (from 14 to 60 days).
After this time period is expired, the old name will no longer be supported.
However, there are some situations where the old name must remain active and the new name abandoned; for
example, when the user is unable to accept the name change because that user may be out of the office for an
extended period of time (e.g., maternity leave). In a case like this, the name change initiated by the administrator
would need to be reverted, in order to provide continued access to the user whose name was being changed. Prior to
the new approval process, the reversion was performed automatically after the expiration time had expired. Now, with
the addition of the new approval process, the capability to approve or reject a name change reversion is provided to
the administrator.
This feature mirrors the approval process activated when the user rejects a name change, and is described in the
Domino Administrator Help documentation.
Domino for i5/OS
Domino 7 plug-in for HTTP Server (powered by Apache) and V5R3
Customers can take advantage of the HTTP Server (powered by Apache) to forward HTTP traffic to their Domino 6 and
7 servers. This is an alternative to exclusively using the built in HTTP server provided in Domino. Refer to the Lotus
Domino 7 for i5/OS HELP (Installing and Managing Guide) and the Web site
http://www.ibm.com/servers/eserver/iseries/domino/apache.html for more information.
Domino Administrator Client, Domino Server
Domino Console - Ability to connect through a firewall
The Domino Console in Domino 6.x used to work only within an intranet scope for connecting to the Server Controller.
In Domino 7, administrators are now able to connect to the Controller from outside a firewall. On the controller end,
you need to run a simple program, "service binder", and the Controller has to 'advertise' the service on the binder.
This service binder program runs on a machine which is outside the firewall of a company, and it listens on a port for
Domino Console requests to connect to a Controller which has published services. The binder then connects both
Console and Controller if the services match.
In the current release, there isn't a separate installation for this binder program on a new machine, however, you may
follow the instructions below, and copy these files from a machine where you have Domino or Notes installed.
Installation and starting binder program:
You need to copy the following files from the Domino Installed machine to the machine where service binder will be
running.
�
Create a directory on the binder machine.
�
Copy the following files which ever way you prefer (FTP, ZIP, or TAR).
sbinder.exe (sbinder on UNIX)
dconsole.jar
jvm and all its subdirectories
notes.ini ( a dummy file)
startup (only for UNIX)
luname (only on UNIX)
execbin (only on UNIX)
�
To run the program issue the following:
sbinder -ip <IpAddress> -port <portnum>
parameters are options. Default port is 2055.
25
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Controller end operations:
Start the Controller and Console on the server box where you will define services (Edit -> Manage Services should
bring the Edit services dialog up). Define the binder machine name and port on which it will be listening, then also
give the SOCKS proxy hostname and port, if they are enabled, in your environment. Next, define a service by clicking
the "New" button; a new Edit Service dialog should pop up. Define a service and enable it, if you want to start the
service (the binder machine should already be running for this to work). Controller then sends the service information
to the binder based on the Binder service and SOCKS proxy enabled.
Console end operations:
Start the Console on the machine from where you want to connect a Controller outside the firewall; File -> Open
Server(Firewall) should bring up an 'Open server through firewall' dialog. Enter username, password, binder machine
name, binder port, and service name. Enter proxy name and proxy port if your environment is using a proxy server.
The Console and Controller should now be connected.
Domino Administrator Client, Domino Server
LDAP special character handling
Note: for clarity, punctuation marks discussed in text are followed by their proper names in parentheses
Introduction
Release 7.0 includes a set of fixes for the conversion of a distinguished name (DN) between LDAP syntax and Notes
syntax. A simple example of a conversion from LDAP to Notes is CN=Mary Smith,OU=West,O=Acme ->
CN=Mary Smith/OU=West/O=Acme. More complex DNs get tricky to convert back and forth correctly, and
previous Domino releases did not handle all of them correctly or consistently. For example, the LDAP DN
CN=This\+That,OU=West,O=Acme should be converted to the Notes DN
CN=This"+"That/OU=West/O=Acme. However, previous revisions did not correctly escape the + (plus) char with
double-quotes, resulting in a Notes DN (CN=This+That/OU=Westford/O=Acme) that appears to have a
multi-valued RDN.
The representation of an LDAP DN is defined in RFC 2253. Notes DNs are (more loosely) defined in the topic
"Hierachical naming for servers and users" in the Installation section of the Lotus Domino Administrator 7 Help.
Conversions between the two are described below.
These fixes are not enabled by default in Domino 7. Administrators must enable them by including the line
DN_PARSE_REV=2 in the server's Notes.ini file and then restarting the Domino server.
Important: The fixes for special character handling should only be implemented when satisfied that no backward
compatibility issues exist. These are described in more detail below.
Common DN conversion scenarios
The most common contexts in Domino where name conversion occurs are the Domino LDAP server, name lookups to
LDAP directories configured in DA (i.e.NAMELookup->LDAP gateway), and LTPA single sign-on authentication. The
Domino LDAP server must convert an LDAP DN it receives from a client to its Notes equivalent in order to save it in
the Domino directory database (that is, the Add operation) or compare it to other names in the directory. It must also
convert from Notes to LDAP when returning search results. When the Domino server or some server task (for example,
the mail router) searches for directory information in an LDAP directory, the gateway must convert results to Notes
DNs. This is typically done when searching for mail recipients, authentication credentials, and ACL groups. LTPA
tokens typically have the name encoded in LDAP syntax, so when receiving a token for authentication, Domino must
convert the DN to Notes. If Notes is the generator of an LTPA token it typically converts the person's DN from Notes to
LDAP and stores it in the token.
Also, when dealing with multi-directory scenarios that include person or group entries that reside in both Domino and
LDAP directories, it's important to understand in what contexts a Notes DN is expected and in what contexts an LDAP
DN is expected. The general rule is that Notes DNs are used in Domino database fields (for example, the Fullname
field or any other names field) or ACLs, and LDAP DNs are used in LDAP directory attributes. In scenarios like this,
DN conversion between Notes and LDAP is necessary. For instance, when entering the DN of an entry that resides in
an LDAP directory into the ACL of a Domino database (or secondary value of Fullname), you need to convert it to its
Notes DN equivalent. Or, when using the Notes DN mapping feature in Directory Assistance, you should convert the
Notes DN to its LDAP equivalent and use that value in the specified attribute of the LDAP directory.
26
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Converting DNs between LDAP and Notes
The fundamental transformation that must be made is substituting the , (comma) char used to separate name components in an LDAP DN with the / (forward-slash) character used for the same purpose in a Notes DN (as in the first example above), and vice versa. Most other characters in the DN are used as is.
However, as defined in RFC 2253, certain characters must be escaped with a \ (back slash) character when used in a
name component attribute value (attrValue). For example, the comma character must be escaped since it is also used
as a name component separator. So, a correct LDAP representation is CN=Warren\+
Rabbit,OU=East,O=Acme, not CN=Warren + Rabbit,OU=East,O=Acme. When this name is converted to
Notes syntax the plus character must be escaped in the Notes style by surrounding it with double-quote characters
(see the second example above). However, not all LDAP-escaped characters need to be Notes-escaped. See the table
below for other characters that must be escaped in an LDAP DN, and which must be escaped with double-quotes when
converting to Notes.
In addition, the forward-slash and @ (at-sign) characters must be escaped when used in a attrValue of a Notes DN, otherwise the canonicalization and abbreviation of these names will fail. So, the correct representation is MAIL=bob"@"www.acme.com/OU=South/O=Acme, not [email protected]/OU=South/O=Acme . When this name is converted to LDAP syntax, the at sign is not escaped, which results in [email protected],OU=South,O=Acme. This is also shown below.
The
�
�
�
�
�
following table is a helpful reference for determining:
which characters require LDAP escaping
which characters require Notes escaping
how to convert an LDAP escaped char to its Notes equivalent
how to convert a Notes escaped char to its LDAP equivalent
conversion differences with past revisions of Domino
LDAP DN
New Notes DN
(in Domino 7 servers with
DN_PARSE_REV=2 enabled)
Old Notes DN
(prior to Domino 7)
=
+
"
\
/
\=
\+
\"
\\
/
"="
"+"
"""
"\"
"/"
@
@
"@"
,
>
<
#
;
\,
\>
\<
\#
\;
,
>
<
#
;
=
+
"
\
/ (prior to Domino
6.5.4)
"/" (starting with
Domino 6.5.4)
@
"@" (hotfix ???)
,
>
<
#
;
Desired character
in attrValue
27
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Here are some more conversion examples:
LDAP DN
New Notes DN
cn=This\=That,o=Acme
cn=This\+That,o=Acme
cn=This\"That,o=Acme
cn=This\\That,o=Acme
cn=This/That,o=Acme
cn=This"="That/o=Acme
cn=This"+"That/o=Acme
cn=This"""That/o=Acme
cn=This"\"That/o=Acme
cn=This"/"That/o=Acme
[email protected],o=Acme
cn=This"@"That/o=Acme
cn=This\,That,o=Acme
cn=This\<That,o=Acme
cn=This\>That,o=Acme
cn=This\#That,o=Acme
cn=This\;That,o=Acme
cn=This,That/o=Acme
cn=This<That/o=Acme
cn=This>That/o=Acme
cn=This#That/o=Acme
cn=This;That/o=Acme
Old Notes DN
cn=This=That/o=Acme
cn=This+That/o=Acme
cn=This"That/o=Acme
cn=This\That/o=Acme
cn=This"/"That/o=Acme
(w/6.5.4)
cn=This"@"That/o=Acme
(w/hotfix ???)
cn=This,That/o=Acme
cn=This<That/o=Acme
cn=This>That/o=Acme
cn=This#That/o=Acme
cn=This;That/o=Acme
Other conversion problems that have been resolved with this set of fixes include:
�
Stricter validation of LDAP and Notes DNs, such as:
-- Unescaped special chars
e.g. cn=this<that,o=Acme
-- Illegal/non-ascii chars in attrTypes
e.g. 1two=foo,o=Acme
big$=spender,o=Acme
-- "#" hexstring attrValues where one or more of the hexpairs in hexstring is illegal
e.g. cn=#hij,o=Acme
-- Illegal backslash escaped attrValues
e.g. cn=not\YY right,o=Acme
-- Other bad syntax
e.g. cn=thats,,ou=+just,#ou=not,o;=right
�
OID style attrTypes
e.g. 1.2.3.4.5=foo,o=Acme
oid1.2.3.4.5=foo,o=Acme
�
attrValues encoded as "\" hexpair
e.g. cn=foo\41bar,o=Acme
�
attrValues encoded as "#" hexstring
e.g. cn=#414243442C31323334, o=Acme
Enabling DN_PARSE_REV=2
In order to correctly perform round-trip conversion of DNs (i.e. LDAP->Notes->LDAP and Notes->LDAP->Notes), it was
necessary to change the behavior for how certain escaped characters are handled. As shown in the tables above, when
converting from LDAP the = (equals),(comma) + (plus), " (double-quotes), and \ (back slash)
characters are escaped by surrounding them with a double-quote char in the resulting Notes DN. So, a server with
DN_PARSE_REV=2 enabled will convert the LDAP DN cn=George\+Abraham,cn=users,dc=acme,dc=com to
the Notes DN cn=George"+"Abraham/cn=users/dc=acme/dc=com. A server without this Notes.ini variable will convert the LDAP DN to cn=George+Abraham/cn=users/dc=acme/dc=com, which will cause problems when attempting to convert it back to LDAP, as the parsing code can not determine whether the back slash used to escape the plus sign is a separator for a multi-valued RDN or just part of the attrValue. Unfortunately, this can result in incompatibility between servers that have DN_PARSE_REV=2 enabled and those that don't. It is safe to enable DN_PARSE_REV=2 if:
�
There are no DNs that contain the = (equals), + (plus), " (double quotes), or \ (back slash)
characters in attrValues, or
�
All DNs stored in Domino directories that contain these chars in attrValues are stored in the new Notes syntax. In
this case, DN_PARSE_REV=2 should be enabled on all 7.0 servers.
When DN_PARSE_REV=2 is enabled, the DNs specified in LDAP protocol operations will be subject to stricter syntax checking. This may result in invalid DN syntax errors being returned by the Domino LDAP server. Correct the DN specified on the request and retry.
28
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Known caveats and issues
�
These characters should be avoided in DNs: \ (back slash) and ; (semicolon).
�
These characters should not be used in DNs that begin with CN= : = (equals) and " (double quotes). However,
other LDAP identifiers, such as UID and email will work.
For example, this will not work: CN=this\=that,
This will work: UID=this\=that,
o=Acme
o=Acme
�
The use of the + (plus) and @ (at sign) in DNs will only work in an all-Domino 7.0 server environment.
�
If the > (greater than) is used in a DN, the derived RDN is not correct. For example, if the original DN is
cn=user>greaterthan,o=abc, the derived RDN is user/greaterthan, which is wrong.
�
Avoid using < (less than) and > (greater than) together in a DN.
�
LDAP searches for attributes of type DN are now stricter with DN_PARSE_REV=2, consequently, the search filter,
"secretary=name*" will not work. The filter must look like this: "secretary=cn=name*".
�
The Domino LDAPsearch.exe tool does not handle ; (semicolon) and " (double quotes) in base-level searches.
DNs that use the . (comma), # (pound) , and / (forward slash) have no known caveats..
Notes Client, Domino Server
Rooms and Resources Manager
The Rooms & Resources (R&R) functionality in Domino 7 has been redesigned with the primary purpose of preventing
overbookings of rooms or resources. There is a new Domino 7 server task, the Rooms & Resources Manager (RnRMgr),
that is responsible for both processing all reservation requests and updating busytime for room and resources. As a
result, there have been some changes made to the previous Rooms & Resources (R&R) experience that Administrator
should be aware of.
�
Room and resource reservations will not be processed unless the RnRMgr task is loaded on the server where
the R&R database resides. To ensure that the RnRMgr task is loaded on server startup or restart, it should
be added to the ServerTasks= line of the servers NOTES.INI file if it is not already there. To manually load
the task use the "load rnrmgr" console command.
�
The Schedule Manager (SchedMgr) task is no longer responsible for updating busytime for rooms or
resources. All console commands previously used by SchedMgr can be used with the RnRMgr. For example,
to have the current busytime data for Room A/Floor 2/Site1 displayed on the console simply issue the
console command "tell rnrmgr show Room A/Floor 2/Site1".
�
The Administration Server setting for each R&R database needs to be set before any administrative changes
can be made to it. This value MUST be the same as the "Server" setting for any pre-exsting rooms or
resources in the database. If the value is different, autoprocessing of requests for new rooms or resources
may experience sporadic delays due to conflicting data in the Name & Address Book.
If users book conference rooms via Calendar & Scheduling (i.e., their mail file), they will see no difference in booking
rooms or resources. Users request the room, and the R&R system will autoprocess the request and respond as it did
before. If users book conference rooms directly in a Conference Room database, however, they will see some slightly
different behavior than they may have been used to in the past. The views are still the same, but there are now several
new icons:
A green checkmark icon indicates that a reservation request has been processed and accepted by RnRMgr.
An hourglass icon indicates a pending reservation request for the time shown in the view. This is a request that
the RnRMgr has yet to process, or that requires some form of Owner intervention first. The majority of Hourglass
icons represent a pending request; users should not see many of them since RnRMgr is seeing and processing
requests within a few seconds of them being written to the Conference Room database.
A red "X" icon indicates a rejected reservation request for the time shown.
29
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
When an owner accepts a room reservation for a room that is "Waiting for Owner Approval", the accepted request may
remain in the Waiting for Approval view for a few seconds until the Rooms & Resource manager has time to process
the request. If this happens, the "Requested by" field will change from the name of the original requestor to the name
of the owner, and remain that way until the system processes it.
Prior to Domino 7, room reservation processing occurred in several places such as the Router or the R&R template.
This kind of distributed decision-making had some drawbacks; the biggest being that it was possible for multiple users
to reserve the same room at the same time, for different meetings. For Domino 7, the R&R system was redesigned so
that it would prevent overbookings and improve the overall user experience.
The biggest change to the direct booking experience is a change to the way directly booked reservation requests are
handled. Before RnRMgr, if a user managed to save their new Reservation request in the R&R database, they had the
expectation that they had reserved the room, though this may not always have been the case.
Now, the user is able to save their request to the database only if there is no pre-existing conflict for the desired
dates/times, but this does not mean that they have actually reserved the room. RnRMgr makes the final decision
whether or not to accept or decline the reservation request, and the new icons are used to inform users of the current
status of their reservation request.
Domino Server
SSL Cryptographic Accelerators
Starting in Notes/Domino 7, the SECManipulateSC API function can be used to push the server's RSA keypair from an
SSL keyring file onto a cryptographic token that supports PKCS#11. This will cause all private key operations
involving the server key to be performed upon the token. This cryptographic token can be a traditional smartcard
(which will result in terrible performance issues) or an SSL cryptographic accelerator that provides a PKCS#11
interface.
The only cryptographic accelerator that has been tested with Notes/Domino 7 is the Rainbow CryptoSwift eCommerce
Server Accelerator PCI CS400 model 2.2.6a, using the PKCS#11 DLL installed to c:\WINNT\system32\Cryptoki22.dll
with the PKCS11_NO_HWCHECK=1 Notes.ini variable set.
In Domino 7, the server's ID file must be smartcard-enabled in order for the PushKyrKey operation to succeed.
Here is some pseudocode to demonstrate the use of SECManipulateSC. As always, real code should check for and
handle errors.
error = SECManipulateSC (SC_manip_GetVersion,
NULLSCMCTX,
NULL,
&Version,
NULL);
/* SC_manip_PushKyrKey was added in Version 5 of this interface. If Version is not at least 5, then that operation will fail. */
/* Initialize the PKCS#11 context.
*/
SCMCTX Context = NULLSCMCTX;
error = SECManipulateSC (SC_manip_InitializeContext,
&Context,
NULL, NULL, NULL);
/* Set up the server's ID file
*/
error = SECManipulateSC (SC_manip_EnterIDFile,
&Context,
NULL, &dwIDLen,
ServerIDPath);
30
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
/* Unlock the smartcard
*/
error = SECManipulateSC (SC_manip_EnterPIN,
&Context,
NULL,
&dwPINLen,
PIN);
/* Note -- SC_manip_EnterPIN will use an external authentication path if it exists. If the token doesn't support a protected authentication path, SC_manip_EnterPIN will use the supplied PIN if one exists or generate a prompt if a NULL or zero-length PIN was used. */
/* Smartcard-enable the server's ID file
*/
error = SECManipulateSC (SC_manip_SCEnableID,
&Context,
NULL,
&dwPwdLen,
ServerIDPwd);
/* Push the keyring private key to the token */
if (Version >= 5) error = SECManipulateSC (SC_manip_PushKyrKey,
&Context,
NULL,
&dwKyrLen,
KyrPath);
/* Clean up */
SECManipulateSC (SC_manip_TerminateContext,
&Context, NULL, NULL, NULL);
Domino Server, Domino for z/OS
zSeries hardware-assisted data compression for Transaction Log
Domino 7 on the zSeries platforms (z/OS and Linux) can optionally exploit hardware-assisted data compression for
transaction logging. With the option turned on, data written to the transaction log will be compressed using the
zSeries CMPSC instruction instead of Domino software. If data is then accessed from the transaction log the Domino
7 zSeries server will use the appropriate technique (CMPSC instruction or Domino software) to decompress. Data in
transaction logs that has been compressed using zSeries hardware-assisted data compression cannot be used on
non-zSeries Domino platforms or pre-Domino 7 zSeries servers.
By default, hardware-assisted data compression for transaction logging is enabled. The feature can be disabled by
starting the Domino server with "TRANSLOG_HardwareCompress=0" set in notes.ini.
The CMPSC instruction requires less CPU cycles then Domino software to do the compression. Depending on the
server workload, using the hardware-assisted data compression for the transaction logging feature can result in a CPU
utilization improvement.
The Domino software to compress the transaction logs uses a more comprehensive technique to do the compression
than the CMPSC instruction. Therefore, the storage required for transaction logs may be greater when the
hardware-assisted data compression for the transaction logging feature is enabled.
31
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Backward compatibility
Notes Client, Domino Designer, Domino Server
Differences in Java 1.3.1 and 1.4.x
There have been some changes made by Sun in the Java 1.4.x release that is included in Notes/Domino Release 7.
These changes could affect the behavior of existing Java agents, applets, etc. in a Notes/Domino application. A
complete list can be found at: http://java.sun.com/j2se/1.4/compatibility.html#incompatibilities1.4.
For example, as a result of the new focus architecture introduced in 1.4.0, the following incompatibilities were
introduced:
�
Focus traversal keys (in most cases this means the TAB key) are now consumed, which can cause problems if
a program depends on a key listener being notified of these key events. Previously, AWT components saw
these events and had an opportunity to consume them before AWT initiated focus traversal. To avoid focus
traversal keys being consumed, use the following code:
component.setFocusTraversalKeysEnabled(false);
where component is the Component that is firing the key events. Focus traversal can then be handled
manually. Alternatively, the code can use an AWTEventListener or KeyEventDispatcher to pre-listen to all key
events. For more information, see bug 4650902.
�
The default focus traversability for all components is now true. Previously, some components (in particular,
all lightweights), had a default focus traversability of false. Note that despite this change, however, the
DefaultFocusTraversalPolicy for all AWT containers will preserve the traversal order of previous releases.
�
A request to focus a non-focus traversable (i.e., non-focusable) component will be denied. Previously, such
requests were granted.
�
Window.toFront() and Window.toBack now perform no operation if the window is not visible. Previously, the
behavior was platform-dependent.
Changes specific to Microsoft Windows:
�
Window.toBack() changes the focused window to the top-most window after the Z-order change.
�
requestFocus now allows cross-window focus change requested in all cases. Previously, requests were granted for heavyweights, but denied for lightweights.
Domino Administrator Client, Domino Server, Domino Web Access
Obsolete Notes.ini variables
The Notes.ini variables listed below have been made obsolete; either because UI settings exist to enable the
functionality or because the functionality is longer required:
Variable
LDAPAddress
namelookup_trust_dircat
NWNDSPASSWORD
NWNDSUSERID
Shared_Mail
WebAuth_AD_Group
iNotes_WA_Chat
iNotes_WA_LiveNames
Reason for obsolescence
In Domino 5.0.1a and subsequent releases, including the Lotus Domino 6 release
and later, the LDAPAddress NOTES.INI variable is ignored. For Domino R5 servers
and later, bind a Notes TCP port to a specific address, and then have the LDAP
service use the Notes port.
Functionality enabled by the Directory Information setting "Trust the server based
condensed directory catalog for authentication with internet protocols" in the Server
document of the Domino Directory server.
IPX/SPX is not supported as of Domino 7.0
IPX/SPX is not supported as of Domino 7.0
Functionality enabled by the Active Directory search filter option, which allowes for
searches of Active Directory groups
Functionality enabled by the Domino Web Access Instant Messaging setting "Instant
Messaging features" in the Configuration Settings document of the Domino
Directory server.
Functionality enabled by the Domino Web Access Instant Messaging setting "Online
awareness" in the Configuration Settings document of the Domino Directory server.
32
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
Variable
iNotes_WA_NoLocalArchive
Reason for obsolescence
Functionality now enabled by the Domino Web Access setting "Local Archiving" in
the Configuration Settings document of the Domino Directory server.
iNotes_WA_OOO_RunOnWeekends This setting was used to run the Out-of-Office agent for mail databases based on the
inotes5.ntf template only, and is not necessary for iNotes6.ntf or DWA7.ntf mail
templates. The iNotes5.ntf mail template is not an available in Domino 7.
iNotes_WA_SametimeJavaConnectFunctionality enabled by the Domino Web Access Instant Messaging setting "Prefer
Sametime Java Connect for browsers" in the Configuration Settings document of the
Domino Directory server.
iNotes_WA_SametimeServer
Functionality enabled by the Domino Web Access Instant Messaging setting "Set an
Instant Messaging server hostname for all DWA users" in the Configuration Settings
document of the Domino Directory server.
iNotes_WA_SametimeToken
Functionality enabled by the Domino Web Access Instant Messaging setting "Allow
secrets and tokens authentication" in the Configuration Settings document of the
Domino Directory server.
iNotes_WA_STLinksLocal
Functionality enabled by the Domino Web Access Instant Messaging setting
"Loading \stlinks from Domino application server" in the Configuration Settings
document of the Domino Directory server.
This setting was used to run the Out-of-Office agent for mail databases based on the
iNotes_WA_OOO
inotes5.ntf template only, and is not necessary for iNotes6.ntf or DWA7.ntf mail
_RunOnWeekends
templates. The iNotes5.ntf mail template is not an available in Domino 7.
iNotes_WA_NoLocalArchive
Functionality now enabled by the Domino Web Access setting "Local Archiving" in
the Configuration Settings document of the Domino Directory server.
Product compatibility
Domino Server
AIX - Concurrent I/O, Direct I/O not supported on Domino servers
Concurrent I/O (CIO) and Direct I/O (DIO) are not supported for use with Lotus Domino servers. CIO is a new file
system feature that has been introduced in AIX 5.2.0.10 (also known as maintenance level 01), in the Enhanced
Journaling File system (JFS2). The documentation for this feature states that it improves performance for many
environments, particularly for relational databases.
Because the CIO feature is not supported for use with Domino servers, you should not enable this option on file
systems that Domino will access. Having this option enabled has been reported to cause Domino data corruption that
may result in server crashes, or in serious performance issues.
Certain core file system items (such as file buffer cache, per-file lock or inode lock, and sync daemon) are managed
differently by the operating system with the CIO option enabled. Currently, Domino has not been coded to address
these changes in behavior.
The CIO option is normally enabled as a flag, given when a file system is mounted. To disable this mount option, use
the following steps:
1. For each file system that is mounted with CIO, run the following command:
chfs -a options=rw /FS_NAME
Where /FS_NAME is the name of the mount point.
2. Next, unmount and remount each file system. Or, you can reboot, which has the same effect if done after the chfs
commands.
33
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 1 - About this release
3. To verify the change was applied, run 'mount' and make sure you do not see "cio" in the mount options column, as
shown in the example below.
Example
output with CIO disabled:
/dev/test05lv
/test05 jfs2 Oct 04 23:13 rw,log=INLINE
output with CIO enabled:
/dev/test03lv /test03 jfs2 Sep 19 19:25 rw,cio,log=INLINE
NOTE: DIO poses the same problems to Domino as CIO does. Evaluation for including support for CIO and DIO will be considered for a future release, based on customer demand.
For additional information on the CIO feature, refer to the AIX whitepaper "Improving Database Performance With AIX Concurrent I/O" at http://www-1.ibm.com/servers/aix/whitepapers/db_perf_aix.pdf
Domino Web Access
Need correct IE browser plug-in to access live console
If a user attempts to use the live console through the webadmin.nsf, and the browser which is used does not have the
correct plug-in, it will display the following error:
om.ms.com.ComFailException: (0x80004002) No such interface supported
at com/ms/com/IServiceProvider.QueryService
The user must apply the correct plug-in.
34
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Chapter 2 - Installation, migration, upgrade, and configuration
information
Hardware requirements
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino for z/OS, Domino for i5/OS
Notes and Domino 7 hardware requirements
For a list of the Notes and Domino 7 hardware requirements for each supported platform, please see the release note
titled "Notes and Domino 7 platforms and system requirements" in the 'Software requirements' section of this chapter.
Domino for i5/OS
i5/OS (iSeries) hardware requirements
i5/OS (iSeries) Server Hardware
One of the following hardware models:
�
IBM iSeries model 8xx servers The following models are recommended: �
810, 825 , 800-2464 and above.
Model 800-2463 is not recommended.
-OR­
�
eServer i5 model 520 or higher The following models are recommended: �
520-0901 and above
Model 520-0900 is not recommended. Memory and disk requirements:
�
Minimum 288 MB memory, 512 MB recommended
�
Minimum 1.6 GB free disk space, 2 GB recommended
Although a Domino server can run on any PowerPC model, the iSeries server models are optimized for client/server
applications such as Domino.
Note: Use these values as general guidelines for minimum memory and disk space. The requirements for your
environment may be different. For more information about sizing an iSeries server for Domino, use the IBM Workload
Estimator for iSeries. The Estimator is available at the following Web site:
http://www.ibm.com/eserver/iseries/support/estimator
35
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Administrator Client, Notes Client, Domino Server
Tested Smartcard packages
Smartcard functionality has only been tested under Win32-based operating systems. Untested smartcards that
include PKCS #11 libraries may work with Notes/Domino 7. The following smartcard packages have been tested, and
indicated (*) packages have caveats listed below:
Smartcard Package
ActivCard Gold 2.2
Belgian eID v2.3.13 (*)
Datakey CIP 4.07
Estonian eID (*)
Eutron CryptoIdentity Cryptokit
3.5.3
Eutron CryptoIdentity
CryptoKit 3.2.1
GemSafe Libraries 4.1
GemSAFE libraries 3.1 SP4
(GPK16000)
GemSAFE Enterprise
Workstation 2.21 (GPK8000)
(*)
GemSAFE Enterprise
Workstation 2.0 (GPK4000) (*)
IBM Embedded Security
System 2.0
with Client Security Software
v5.41
IBM Embedded Security
System 1.0
Rainbow iKey 2032 SDK v4.7.0
Rainbow CryptoSwift
eCommerce Server Accelerator
PCI CS400 model 2.2.6a (*)
Schlumberger Cyberflex Access
SDK V4.3
Schlumberger Cyberflex Access
SDK V2
Login with
the token
yes
yes (*)
yes
no (*)
yes
Removing token will generate 512-bit RSA keys
'F5'-style logout
on the token
yes
yes
no (*)
no
yes
yes
no (*)
n/a
yes
yes
1024-bit RSA keys
on the token
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
*
yes
*
yes
yes
no
no
yes
yes
no
no
yes
yes
n/a
no
no
yes
n/a
no
no
yes
yes
yes
n/a
yes
yes
yes
yes
yes
yes
no
yes
yes
yes
no
yes
Smartcard Package Caveats:
�
Version 2.2 is the required minimum version of ActivCard Gold supported for Notes 7.
�
The Belgian eID was tested with run-time version 2.3.13. A number of bugs are present in this version of the
library: pressing the "Select Slot" button in the User Security Panel will result in the PKCS #11 library
crashing; users may receive PIN prompts from the PKCS#11 library as well as Notes; the ID file can be
successfully locked with certificates imported from the token using the "Lock ID With Key on Smartcard"
action, but starting Notes with the token in the reader subsequently will take 5-30 seconds; removing the
token from the reader will lock Notes if the ID is locked with a key on the smartcard, but the PKCS #11
library will never report that the token has been re-inserted, forcing the user to shut down Notes, remove the
token from the reader, restart Notes, then re-insert the token into the reader. Updating to the most recent
version of the Belgian eID token may fix some or all of these problems.
�
The Estonian eID was tested with the PKCS#11 library from OpenSC version 0.9.4mp5. Using this version of
the library, S/MIME signing was functional with the pre-loaded certificates and keys, but smartcard login was
nonfunctional. It is probable that version 0.9.4mp6 will fix a bug that prevented the "Lock ID With Key on
Smartcard" action from succeeding.
�
The Rainbow CryptoSwift eCommerce Server Accelerator fails to report that RSA cryptographic operations are
performed in hardware. If you are having difficulty performing cryptographic operations (including importing
X.509 certificates or exporting RSA keys) with this device, setting PKCS11_NO_HWCHECK=1 or
PKCS11_TOKEN_BUGS=2 in the notes.ini file will activate a workaround in Notes/Domino for this problem.
36
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
�
The GemSafe Libraries 4.1 claim support for hash and sign mechanisms that they do not actually provide. If
you are having difficulty signing S/MIME messages with a key on these smartcards, setting
PKCS11_TOKEN_BUGS=1 in the notes.ini file will activate a workaround in Notes for this problem.
�
GemSAFE 2.21's NT Lock Workstation feature has been known to crash some versions of NT and deadlock
with Notes. When installing GemSAFE 2.21, the NT lock workstation feature defaults to on. Un-check the
box.
�
There may be problems when installing GemSAFE 2.21 on a laptop running NT 4.
Caveats and Warnings:
�
The only way to recover from losing or breaking a smartcard or to revert a smartcard-protected ID file to a
password is through ID File Recovery. ID File Recovery should be configured for an ID file before the ID file is
smartcard-enabled. Recovering a smartcard-protected ID file will revert the ID file to use a password and will
restore any keys that were pushed onto the smartcard, as long as the recovery information was not changed
after the key was pushed down to the smartcard.
�
Password expiration should be disabled in a user's person record before they smartcard-enable their ID file.
�
Password checking will result in only a single smartcard being usable with a given ID file, even across
multiple computers or platforms. In this scenario, one copy of the ID file should be smartcard-enabled, and
then that version of the ID file should be copied to all of the other respective computers. That single
smartcard will now be required for all of the copies of the ID file.
�
Server setup will not function with a smartcard-protected server ID. In order to use a smartcard-protected ID
with a server, finish server setup with a password-protected version of the ID file, then add the path to the
PKCS #11 library in the server's notes.ini (PKCS11_Library=<path to library>), and finally smartcard-enable
the server's ID file on a client or using the SECManipulateSC C-API function.
�
Single Logon, which synchronizes the Notes and Windows passwords, cannot be used with a
smartcard-protected ID file. You must restart Notes after disabling Single Logon before smartcard-enabling
an ID file.
�
The format in which smartcard-related information is stored in the ID file has changed since the earliest beta
releases of Notes 6. Using an ID file that was smartcard-enabled with one of these early beta releases will
result in an "Incomplete or incorrect smartcard configuration" with Notes 7.
�
Notes uses version 2.01 of the PKCS #11 API to communicate with smartcards and other PKCS#11 devices.
PKCS #11 libraries that only implement version 2.0 will not result in an "F5"-style logout when the card is
removed from the reader. Updated libraries may be available from the smartcard vendors.
Sample PKCS #11 Library Install Paths:
�
�
�
�
�
�
�
�
�
�
�
�
c:\WINNT\system32\acpkcs201.dll (ActivCard Gold 2.2)
c:\WINNT\system32\dkck201.dll (Datakey CIP 4.07)
c:\WINNT\system32\opensc-pkcs11.dll (Estonian eID)
c:\WINNT\system32\sadaptor.dll (Eutron CryptoIdentity CryptoKit 3.2.1 & 3.5.3)
c:\WINNT\system32\gclib.dll (GemSAFE Libraries 3.1 and 4.1)
c:\WINNT\system32\pk2priv.dll (GemSAFE 2.21)
c:\windows\system32\ibmpkcss.dll (IBM Embedded Security System 1.0)
c:\WINNT\system32\dkck201.dll (Rainbow iKey 2032)
c:\WINNT\system32\Cryptoki22.dll (Rainbow CryptoSwift eCommerce Sever Accelerator)
c:\Program Files\Netscape\Communicator\Program\acpkcs.dll
c:\Schlumberger\Smart Cards and Terminals\Cyberflex Access Kits\v4\slbck.dll (Schlumberger Cyberflex
Access V4.3)
c:\Schlumberger\Smart Cards and Terminals\Common Files\slbck.dll (Schlumberger Cyberflex Access V2)
37
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Software requirements
Domino Administrator Client, Notes Client, Domino Designer, Domino Server
Notes and Domino 7 platforms and system requirements
The platforms and operating systems listed in the table below are applicable to the Notes/Domino 7.0 release, and
may not necessarily pertain to other Notes/Domino releases.
For Domino Web Access system requirements, please refer to the release note titled "Domino Web Access system
requirements".
Operating system patches, service packs, and other updates are not specified in the tables that follow. Note that
operating system vendors frequently release updates. For the most recent information regarding updates, see the
Lotus Knowledge Base online at http://www-3.ibm.com/software/lotus/support/ or contact your local Lotus Support
representative.
Notes Client
Platform
Supported operating system versions
Microsoft Windows 2000
Microsoft Windows XP
Microsoft Windows 2000 Professional
Microsoft Windows XP Professional;
(see the "Windows service pack
requirements" Release Note for Service Pack
information)
Microsoft Windows XP Tablet PC
Edition
(see the "Windows service pack
requirements" Release Note for Service Pack
information)
Processors supported
Intel Pentium
Intel Pentium
128 MB minimum
128 MB minimum
256 MB or more recommended
256 MB or more recommended
275 MB required
275 MB required
Color monitor required
Color monitor required
Yes
No (NetBEUI)
NetBIOS over IP
(2)
Yes
Yes
NetBIOS over IPX
Yes
Yes
SPX
No
No
SPX II
No
No
TCP/IP
Yes
Yes
X.PC
Yes
Yes
RAM
Disk space
(The minimum amounts are the disk space required for
installing default files. More disk space is required if
databases are replicated locally or copied locally)
Monitors supported
Protocols
supported
(1)
NetBEUI/NetBIOS
(3)
38
(3)
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Administrator Client, Domino Designer
Microsoft Windows 2000
Microsoft Windows XP
Microsoft Windows 2000 Professional
Microsoft Windows XP Professional
(see the "Windows service pack
requirements" Release Note for Service Pack
information)
(see the "Windows service pack
requirements" Release Note for Service Pack
information)
Intel Pentium
Intel Pentium
128 MB minimum
128 MB minimum
256 MB or more recommended
256 MB or more recommended
275 MB required
275 MB required
Color monitor required
Color monitor required
Yes
No (NetBEUI)
NetBIOS over IP
(2)
Yes
Yes
NetBIOS over IPX
Yes
Yes
SPX
No
No
SPX II
No
No
TCP/IP
Yes
Yes
X.PC
Yes
Yes
Platform
Supported operating system versions
Processors supported
RAM
Disk space
(The minimum amounts are the disk space required for
installing default files. More disk space is required if
databases are replicated locally or copied locally)
Monitors supported
Protocols
supported
(1)
NetBEUI/NetBIOS
(3)
(3)
Footnotes
1
2
3
Only Microsoft NetBEUI is supported. Starting with Windows XP, Microsoft has discontinued support of the NetBEUI.
Only Microsoft TCP/IP is supported.
Both Novell NetBIOS and Microsoft NetBIOS over IPX are supported.
39
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
4
Domino Server - Table 1
Platform
Microsoft Windows 2000
Microsoft Windows 2003
Supported operating
system versions
Microsoft Windows 2000
Server;
Microsoft Windows 2000
Advanced Server
Microsoft Windows 2003 Server
Standard Edition;
Microsoft Windows 2003 Server
Enterprise Edition
(see the "Windows service pack
requirements" Release Note for
Service Pack information)
(see the "Windows service pack
requirements" Release Note for Service
Pack information)
Processors supported
Intel Pentium or higher and
compatibles
Intel Pentium or higher and
compatibles
RAM
256 MB minimum
512 MB or more recommended
per CPU
512 MB minimum
512 MB or more recommended
per CPU
Disk space
1.5 GB minimum per partition
1.5 GB minimum per partition
Disk swap space
2 times the physical RAM
installed
2 times the physical RAM
installed
Monitors supported
Color monitor required
Color monitor required
Yes
No
NetBIOS over IP
(2)
Yes
Yes
NetBIOS over IPX
Yes
Yes
SPX
No
No
SPX II
No
No
TCP/IP
Yes
Yes
TCP/IP IPV6
No
Yes
X.PC
Yes
Yes
Protocols
supported
(1)
NetBEUI/NetBIOS
40
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Server - Table 2
Platform
IBM AIX
Supported operating
system versions
IBM AIX 5.2
IBM AIX 5.3
(5)
(see the "AIX patch
requirements" Release Note
for Service Pack
information)
Linux
Sun Solaris
Novell SuSE Linux
Enterprise Server
(SLES) 8
Novell SuSE Linux
Enterprise Server
(SLES) 9
Sun Solaris 9
(5)
(see the "Linux patch
requirements" Release
Note for Service Pack
information)
(see the "Solaris patch
requirements" Release Note for
Service Pack information)
Processors supported
PowerPC
Intel Pentium or
higher and
compatibles
UltraSPARC and newer
RAM
512 MB minimum;
512 MB or more
recommended per CPU
512 MB minimum;
512 MB or more
recommended per
CPU
512 MB minimum
512 MB or more
recommended per CPU
Disk space
1.5 GB minimum
1.5 GB or more
recommended
1.5 GB minimum
1.5 GB or more
recommended
1.5 GB minimum
1.5 GB or more
recommended
Disk swap space
Same amount as
Physical memory
required; recommend
2 times the physical
RAM installed
2 times the physical
RAM installed
recommended
3 times the physical RAM
recommended
Monitors supported
Any standard display
(local or remote)
Any standard display
(local or remote)
Any standard display (local
or remote)
No
No
No
NetBIOS over IP
(2)
No
No
No
NetBIOS over IPX
No
No
No
SPX
No
No
No
SPX II
No
No
No
TCP/IP
Yes
Yes
Yes
TCP/IP IPV6
Yes
Yes
Yes
X.PC
Yes
Yes
Yes
Protocols supported
(1)
NetBEUI/NetBIOS
(3)
41
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Server - Table 3
Platform
Domino for IBM i5/OS
Supported operating
system versions
IBM i5/OS
TM
V5R3
IBM z/OS
Linux on zSeries
IBM z/OS Version 1, Release 5
and above
Novell SuSE Linux Enterprise
Server (SLES) 8 on zSeries
(31-bit)
Novell SuSE Linux Enterprise
Server (SLES) 9 on zSeries
(64-bit)
(see the "i5/OS system
requirements" Release Note for
additional information)
(see the "Domino for Linux on
zSeries service pack requirements"
Release Note for service pack
information)
Processors supported
IBM iSeries server based on
Any that supports your release
TM
PowerPC (RISC) technology level of z/OS
Any that supports your release
level of Linux on zSeries
eServer i5 model 520 or
higher
RAM
288 MB minimum;
512 MB or more
recommended
1 GB minimum;
2 GB or more recommended
1 GB minimum
2 GB or more recommended
Disk space
1.6 GB minimum
2 GB or more recommended
3 3390-3 volumes minimum
2.5 GB minimum
2.5 GB or more recommended
Disk swap space
N/A
N/A
N/A
Monitors supported
Any standard display (local
or remote)
Any standard display (local or
remote)
Any standard display (local or
remote)
No
No
No
NetBIOS over IP
(2)
No
No
No
NetBIOS over IPX
No
No
No
SPX
No
No
No
SPX II
No
No
No
TCP/IP
Yes
Yes
Yes
TCP/IP IPV6
No
Yes
Yes
X.PC
No
No
No
Protocols supported
(1)
NetBEUI/NetBIOS
(3)
Footnotes
1
2
Only Microsoft NetBEUI is supported. Starting with Windows XP, Microsoft has discontinued support of the NetBEUI.
Only Microsoft TCP/IP is supported.
3
Domino clusters and partitioned server configurations do not support the IPX/SPX protocol. At this time, Lotus does not plan to
provide IPX/SPX network support for future releases of these features.
4
If you are running with DB2 as the Domino datastore then you must add additional DB2 install requirements. DB2 8.2 is
supported. For additional install requirements, please see "Setting up and using Domino 7 and DB2" in these release notes.
5
The 64-bit kernel must be installed and in use on these systems, even though the OS is 32-bit. The use of the 32-bit kernel is no
longer supported on these platforms. Please see the OS vendor documentation for questions on enabling/using the 64-bit kernel.
(On Solaris, the 64-bit kernel is used by default on supported hardware; this is not the case for AIX).
42
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino for i5/OS
i5/OS (iSeries) software requirements
Operating System Software
The following iSeries software is required for Domino 7:
TM
�
IBM i5/OS
V5R3
�
OS/400 - Host servers, 5722SS1 (option 12)
�
TCP/IP Connectivity Utilities for iSeries, 5722TC1
�
IBM Developer Kit for Java , 5722JV1 plus the 1.4 JDK option for 5722JV1 (option 6)
�
OS/400 - QShell Interpreter, 5722SS1 (option 30)
TM
Make sure you have the latest PTF levels applied on your system. Refer to the Preventive Service Planning (PSP) Web
site for the latest cumulative, group and individual PTFs available for the relelase (
http://www-912.ibm.com/s_dir/sline003.nsf/sline003home).
If you would like to manage your Domino environment using iSeries Navigator, the graphical user interface for
managing an iSeries server, you must install the following additional software:
�
IBM iSeries Access Base, 5722XW1 (V5R3).
�
IBM iSeries Access for Windows, 5722XE1 (V5R3)
�
Latest iSeries Navigator service pack available (
http://www-1.ibm.com/servers/eserver/iseries/access/casp.htm)
�
V5R3 - SI15176
If you plan to use the Java server controller [STRDOMSVR SERVER(server-name) JSC(*YES)] you must also install the
following additional software:
Crypto Access Provider 128-bit , 5722AC3 (V5R3).
�
Domino software
�
Lotus Domino 7 for i5/OS (5733LD7) There are three options that can be installed. �
5733LD7 *BASE - This is the base option of Domino 7; this option is required.
�
5733LD7 option 1 - This contains the C API related files; installation of the C API is optional. If you want
to run any application that uses the C API interfaces, you must install this software.
Note: The C API option is not multi-version capable.
�
5733LD7 option 10 - This option contains the Domino 7 server code; installation of this option is required.
After installing all three options of Domino 7 for i5/OS, the following will be displayed on the DSPSFWRSC panel:
5733LD7
5733LD7
5733LD7
5733LD7
5733LD7
*BASE
*BASE
1
10
10
5050
2924
5050
5050
2924
Lotus
Lotus
Lotus
Lotus
Lotus
Domino
Domino
Domino
Domino
Domino
7 (5724E62)
7 (5724E62)
7: C API
7: Release 7.0.0
7: Release 7.0.0
The Resource ID "5733LD7" is the i5/OS installed licensed program (LICPGM) value and the text "(5724E62)" that
follows the Description is the IBM Lotus Passport Advantage product ID. While both values may be used to refer to
the Lotus Domino 7 product, the 5733LD7 LICPGM value is specific to i5/OS.
Individual V5R3 PTFs recommended
5722SS1 SI16689 - OSP-INCORROUT C RUNTIME SETLOCALE CHANGE
�
In certain situations, calls to the setlocale() routine will return an empty string rather than the correct locale
string. The locale will have been set correctly by setlocale(), but the string result will be empty rather than
having the correct value.
5722999 MF34557 - LIC-COMM JSSE does not detect when 5722AC3 is installed
�
This PTF addresses Java controller/console connect errors that may occur if the controller is the only SSL
application and no other SSL servers/applications have been previously started.
43
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Web Access
Domino Web Access system requirements
Client Requirements
�
Recommended for better performance --Pentium IV 1 GHZ with 512 MB of memory (Windows and Linux
clients)
�
Minimum -- Pentium III 400 MHz with 128 MB of memory (Windows client); Pentium III 500 MHz with 192
MB of memory (Linux client)
Client Operating Systems
�
Windows 2000 Professional
�
Windows XP
Client Operating Systems for Mozilla
�
Novell SuSE Linux Enterprise Server (SLES) 8
�
Novell SuSE Linux Enterprise Server (SLES) 9
Supported Browsers
�
Win32 Internet Explorer 6.0
�
Mozilla 1.4.1 and 1.7.x (Linux clients only)
�
Mozilla Firefox 1.0 on Win32 and Linux (supported by the DWA7 mail template only; not supported by iNotes6 templates)
Attempting to access Domino Web Access through unsupported browsers results in the display of an unsupported
browser notice. Netscape 4.x users may see hangs and/or crashes when encountering the Domino Web Access
unsupported browser page. If you are a Netscape 4.x user and you encounter these problems, you should open your
mail file using the WebMail UI directly through the &ui=webmail switch. This is documented in the topic "Switching to
WebMail" in the Domino Web Access help.
Note: Domino Web Access will not work if JavaScript is disabled or if session cookies are disabled.
Server Requirements
See "Notes and Domino 7 platforms and system requirements" in the Release Notes for a complete list of server
operating systems and requirements.
Certified Proxy Servers
�
SunOne Portal Server 6.2
�
IBM WebSphere Edge Server 2.0.2 efix 49
�
Tivoli Access Manager 5.1
Adobe Acrobat
Adobe Acrobat Reader, Version 4.0 or higher to print calendars.
Domino Access for Outlook
Domino Access for Microsoft Outlook Requirements
IBM Lotus Domino Access for Microsoft Outlook allows Microsoft Outlook 2000, 2002 (XP), or 2003 users to connect
to an IBM Lotus Domino Server running Domino 7.0. If you are upgrading from an earlier beta version, please refer to
the "Upgrade Instructions" before installing.
System
�
�
�
�
and Outlook requirements
Windows OS (Window 2000 Professional or Windows XP Professional)
Microsoft Outlook 2000 or Outlook XP with SP3, and Outlook 2003 with SP1
Domino Server running 6.5.1 or higher
Mail databases created using a Mail7.NTF, Mail7ex.NTF or DWA7.NTF template
Client System Memory
�
Windows 2000 Professional Edition and Windows XP Professional Edition with Service Pack 3: 128 MB RAM
required; 256 MB or more recommended
Client Disk Space
�
Windows OS: 275 MB disk space
44
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Administrator Client, Domino Server, Domino Offline Services (DOLS)
DOLS system requirements
DOLS is supported on Win32 clients. DOLS is supported on Win32, AIX, Solaris, and Linux servers.
Client System Requirements:
�
�
�
�
Intel Pentium
Minimum RAM, 128MB; recommended RAM, 256MB
500MB free disk space recommended for basic operation
Additional disk space for each subscription, depending on size
Browser Requirements:
�
Internet Explorer 6.0 or higher
Domino Designer
DECS - supported data drivers list
Win2000, Win2003
Oracle 8i, 9i, 10g
DB2 8.x
Sybase 12.5
MS SQL Server 2000
Data Direct ODBC 5.0
AIX 5.2, AIX 5.3
Oracle 8i, 9i, 10g
DB2 8.x
Sybase 12.5
Data Direct ODBC 5.0
Solaris 9
Oracle 8i, 9i, 10g
DB2 8.x
Sybase 12.5
Data Direct ODBC 5.0
SuSE Linux Enterprise Server 9 (SLES 9)
Oracle 8i, 9i, 10g
DB2 8.x
Data Direct ODBC 5.0
i5/OS V5R3
DB2 8.x
Data Direct ODBC 5.0
z/OS 1.5
DB2 8.x
Domino Server
AIX platforms supported
AIX 5.2 and AIX 5.3 are supported platforms for the Domino 7 server.
45
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Server
AIX patch requirements
The following AIX patch level is required for Domino 7:
AIX 5.2
ML2 is required.
Oct 2003 Visual Age C/C++ RTE Patch or higher
bos.perf.proctools 5.2.0.31
In order to have nsd.sh use procstack instead of dbx (for speed purposes) customers should install this patch (APAR
IY55355). This will be included in ML4 for AIX 5.2, and the base code for AIX 5.3
AIX 5.3
PTF IY58143
PTF IY58691 *
* also upgrade bos.net.nis.client to version 5.3.0.10 if NIS is installed on the system and NIS is not at this level (or
higher) after this APAR installed
Optional patch
If you experience Domino failures in "_DoThrow" then you should follow this link:
APAR IY34980 - http://www-1.ibm.com/support/docview.wss?uid=isg1IY34980
and apply the patch to your system. It deals with an issue with the C++ runtime of AIX 5.x. You only need to apply
this APAR if you run into failures of this type, otherwise it is not required.
Domino Server
AIX - IOCP required
Domino 7 requires that you install and enable IOCP on AIX systems.
Domino Server
AIX - Java needs X11 libraries
For Java to run, the following packages must be installed, even if running a "minimal" AIX installation:
X11.base.lib
X11.base.rte
along with any "prerequisite" software for these packages.
Domino Server
AIX - Java requires X11.fnt.ucs.ttf for Far Eastern locales
In order for Java to properly display Unicode glyphs for Far Eastern languages on AIX, it requires the installation of
X11.fnt.ucs.ttf from the AIX installation CDs.
Domino Server
AIX - Installing bos.adt.debug
On some AIX versions, it is possible that bos.adt.debug will not be installed by default. If this package is not installed
on your system, then you need to manually install it in order for the nsd program to work. This package,
bos.adt.debug, contains the dbx program which is used by nsd to attach to the running processes and provide the
stacks necessary for debugging problems with Domino.
46
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Server
Linux platforms supported
SLES 8 Linux on x86 and Linux on zSeries (31-bit) and SLES 9 Linux on x86 and Linux on zSeries (64-bit) are
supported platforms for the Domino 7 server.
Domino Server
Linux patch requirements
The following Linux patch levels are required for Domino 7:
SLES 8
Requires Service Pack 3 (or higher).
pstack-1.1.7.IBM-1 - downloaded from ftp.suse.com. The location is /pub/projects/pstack/ and then architecture (sles8-i386, sles8-s390).
SLES 9
Requires Service Pack 1 (or higher).
(gdb 6.3 may be needed on x86 if issues with stacks in nsd)
Domino Server
Solaris platforms supported
Solaris 9 is a supported platform for the Domino 7 server.
Note: Domino 7 only supports systems with UltraSPARC and newer processors.
Domino Server
Solaris patch requirements
The following Solaris patch level is required for Domino 7:
Solaris 9
Solaris Cluster patch for 11/14/2003 or higher
As applicable, patches 111703-03, 111711-06, 111712-06, 111722-04, 112758-01, 112760-04, 112762-04,
112763-05, 113817-03, 113820-01, 113823-03, 114801-02 (or higher os same patch type)
Domino Administrator Client, Notes Client, Domino Designer, Domino Server
Windows platforms supported
Notes Client
The following are supported platforms for the Notes, Domino Designer, and Domino Administrator 7 Clients:
�
Windows 2000 Professional
�
Windows XP Professional
�
Windows XP Tablet PC Edition (Digital Ink Input will not be supported in the Notes 7 client)
Domino Designer, and Domino Administrator Clients
The following are supported platforms for the Notes, Domino Designer, and Domino Administrator 7 Clients:
�
Windows 2000 Professional
�
Windows XP Professional
Domino Server
The following are supported platforms for the Domino 7 server:
�
Windows 2000 Server; Windows 2000 Advanced Server
�
Windows 2003 Server Standard Edition; Windows 2003 Server Enterprise Edition
47
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Administrator Client, Notes Client, Domino Designer, Domino Server
Windows service pack requirements
Notes/Domino 7 is initially supported on Windows platforms with the application of the Service Packs listed below. Although individual operating system patches and Service Packs are not certified, IBM/Lotus realizes that there are later service packs that may become publicly available after testing, and acknowledges that these more recent updates may fix additional problems. You may wish to apply these newer service packs as they become available.
You can obtain and install the following patches from Microsoft Corporation or download them from Microsoft's Web site:
http://www.microsoft.com/downloads
Notes, Domino Designer, and Domino Administrator Clients:
�
Windows 2000 Professional: Service Pack 4
�
Windows XP Professional: Service Pack 1
Domino Server
�
Windows 2000 Server; Windows 2000 Advanced Server: Service Pack 4
Not required, but highly recommended - Windows 2003 Service Pack 1 and Windows XP Service Pack 2, to fix an
UnmapViewofFile performance issue.
Domino Server
Web browsers supported
The following are the Web browsers supported, by application.
Application
Notes Client
1
Browsers supported
� Internet Explorer 6.0 on Windows XP Professional and Windows 2000 Professional
� Mozilla 1.7.6 on Red Hat Enterprise Linux 3.0
� Mozilla 1.7.6 on Novell Linux Desktop 9.0
Web Mail and
Web-enabled templates
� Mozilla 1.7.6 on Windows XP Professional and Windows 2000 Professional
� Mozilla 1.7.6 on Mac OS 10.2 and Mac OS 10.3
� Mozilla 1.7.6 on AIX
� Mozilla 1.7.6 on Solaris
� Mozilla 1.7.6 on Red Hat Enterprise Linux 3.0
� Mozilla 1.7.6 on Novell Linux Desktop 9.0
� IBM Browser for OS/2, version 2
Domino Web
Administrator
� Mozilla 1.7.6 on Windows XP Professional and Windows 2000 Professional
� Mozilla 1.7.6 on AIX
� Mozilla 1.7.6 on Solaris
� Mozilla 1.7.6 on Red Hat Enterprise Linux 3.0
� Mozilla 1.7.6 on Novell Linux Desktop 9.0
1
Not applicable to Domino Designer.
48
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
File formats supported
The following file formats are supported in Notes 7 through the Verity 7.4.21 viewer.
Format
Adobe PDF
Lotus Freelance (PRE, PRZ)
Microsoft Powerpoint for Mac (PPT)
Microsoft Powerpoint for PC
Microsoft Powerpoint for windows
Applix Spreadsheets (AS)
Lotus 123 SmartSuite (123)
MS Excel for Windows (XLS)
ANSI (TXT)
ASCII (TXT)
Lotus Word Pro (LWP)
MS Word for Windows (DOC)
Rich Text Format/WorkPad (RTF)
Unicode Text
WordPerfect for Windows
Lotus 123 (WK4)
MS Excel for Mac (XLS)
Applix Words (AW)
HTML (HTM)
JustSystems Ichitaro (JTD) (support via an alternate filter)
MS Word for MAC (DOC)
MS Word for PC (DOC)
Word Perfect for Linux - New
Word Perfect for Windows (WO)
Microsoft Outlook (msg) - New
Microsoft Outlook (eml) - New
Applix Presents (AG)
Corel Presentations (SHW)
Microsoft Project (MPP)
Comma Seperated Values (CSV)
Corel Quattro Pro (QPW, WB3)
MS Excel Charts (XLS)
Display Write (IP)
Folio Flat File (FFF)
MS Windows Write (WRI)
MS Works (WPS)
WordPerfect for MAC
XyWrite (XY4)
DynaZip
PKZIP (ZIP)
WinZip
MS Outlook Express (EML)
AutoCAD Drawing Format (DWG)
AutoCAD Drawing Format (DXF)
Computer Graphics Metafile (CGM) embedded
Enhanced Metafile (EMF) embedded and standalone
49
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Format
Lotus Pic (PIC)
MS Visio
Tagged Image File (TIFF) standalone
Windows Metafile (WMF) embedded and standalone
MPEG 1 Audio layer 3 (MP3)
Lotus 123 Charts
MS Works Spreadsheets (S30, S40)
Fujitsu Oasys (OA2)
IBM DCA/RFT (DC)
Domino Administrator Client, Domino Server
Web Administrator: Domino LIVE console requires Sun Java 1.4.2
The Sun Java 1.4.2 plugin is required for the Domino LIVE console in Web Administrator.
Domino Server, Domino for z/OS
z/OS Software levels: PTF checker
The following web site contains the list of z/OS service required to run Domino 7 for z/OS:
http://www.ibm.com/servers/eserver/zseries/software/domino/servrel6.html
Additionally, a tool (the PTF checker) is provided that uses SMP/E to verify that this service has been applied on a
z/OS system. The PTF checker is also provided at the web site listed above. To use the PTF checker, follow the
directions in the comments section of the file.
The web site should be reviewed frequently and service should be applied and verified whenever there are changes to
the list.
Domino Server, Domino for z/OS
z/OS DB2 requirements for LS:DO, LCLSX and DECS
Following are the z/OS Enterprise Integration restrictions (LS:DO, DECS, LCLSX)
�
DB2 ODBC must use the DB2 for OS/390 and z/OS Recoverable Resource Manager Services attachment
facility (RRSAF). Set MVSATTACHTYPE=RRSAF in the Subsystem section for any database used by LCLSX or
DECS
Any Stored Procedure must be defined to use RRSAF.
�
DB2 PTF AQ91824 must be installed
Domino Server, Domino Offline Services (DOLS)
Linux for zSeries SLES9 DB2 requirements
If using LS:DO, LC LSX, or DECS with Domino on Linux for zSeries (64-bit), there is a special consideration for DB2
connections. DB2 on Linux for zSeries will only support a 64-bit application interface at this time. Domino is built as
a 31-bit application, and runs in toleration mode on the 64-bit Linux operating system. A communication interface
must be in place for Domino to interact with DB2. This interface, the "IBM DB2 Universal Database Runtime Client
(31-bit) for 64-bit Linux for zSeries", can be downloaded from http://ibm.com/db2/udb/support/downloadv8.html
The DB2 UDB Runtime Client must be installed in the same image(s) as Domino, however it may not coexist in the
same image as DB2 UDB (64-bit). See the Runtime Client documentation for details.
50
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Server, Domino for z/OS
IBM HTTP Domino Plugin for z/OS
Domino for IBM HTTP Server (WebConnector) is no longer supported. WebSphere to Domino connectivity is now achieved through the use of a general-purpose WebSphere plugin. Customers desiring the Domino Plugin for use with the IBM HTTP Server should contact their IBM Sales Representative to obtain it.
Domino Administrator Client, Domino Server
Domino 7 and IPv6
Domino 7 offers additional platform support above the IPv6 support previously in the product as well as a new feature -- Notes client's attempted use of all addresses for a name until one is resolved. By default, IPv6 is disabled. To enable IPv6 for Domino 7, see the topic "Enabling IPv6 on Notes and Domino 7" in the Domino Administrator documentation.
Support for IPv6 by hardware and operating system suppliers and the Internet is still in the early stages; therefore, moving to the IPv6 standard is a gradual process for most organizations. In Lotus Domino 6, you can enable IPv6 support for Domino (NRPC), SMTP, POP3, IMAP, LDAP, and HTTP services on AIX®, Solaris®, and Linux systems. IPv6 is an emerging standard. Vendors that have implemented (or are implementing) IPv6, have done so in varied ways. Enable and configure IPv6 in your enterprise according to the client and server platforms you are using. Supported platforms
IPv6 with Notes Domino 7 is supported on the following platforms
�
Windows XP for the Notes client
�
Microsoft Windows 2003 server
�
AIX
�
Solaris
�
Linux on zSeries and Linux on x86
Note: IPv6 is not available on Domino for i5/OS.
See the Domino Administrator documentation for more information about Domino 7 and IPv6.
Domino Server
Hyper-threaded CPUs treated as SMP systems
Due to the "virtual" CPU that is inherent with a hyper-threaded CPU, hyper-threaded CPUs are counted as SMP systems.
Installation notes
Domino Administrator Client, Notes Client, Domino Designer
Notes 7 and Notes 6.x coexistence
Do not install both Lotus Notes 7 and Lotus Notes 6.x on the same machine. Instead, upgrade Lotus Notes 6.x to Lotus Notes 7. If you need to install both Lotus Notes 7 and 6.x on the same machine, be aware that this installation could have adverse effects on the operation of the 6.x Client that was previously installed, for example, OLE/COM settings will point to the Notes 7 directory, default email client settings, etc. With that understanding, follow the steps below to install Notes 7 on a machine that also has 6.x installed:
Note:
You must have local administrator privileges to complete this procedure. These instructions apply to single user installs only: they do not apply to multi-user client installs.
1. Shut down the Notes client and all Notes-related tools, utilities and add-ins running on your computer.
2. Rename the Notes 6.x directory. Notes 6.x is typically installed to \Program Files\Lotus\Notes on Windows.
For example, you could rename the directory "Notes6."
51
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
3. Rename the entire Notes registry key HKEY_LOCAL_MACHINE\Software\Lotus\Notes. For example, you can
rename it HKEY_LOCAL_MACHINE\Software\Lotus\Notes6
4. Rename the entire Installer registry key HKEY_CURRENT_USER\Software\Lotus\Notes\Installer. For
example, you can rename it HKEY_CURRENT_USER\Software\Lotus\Notes\Installer6
5. Run the Notes 7 install program (SETUP.EXE). Select new locations for the program and data directories.
For example, you can select \Program Files\Lotus\Notes7 and \Program Files\Lotus\Notes7\Data
6. During the install you may see an error message ""Error 1905.Module c:\program files\lotus\notes\nlsxbe.dll
failed to unregister. HRESULT". Click OK and installation will proceeed.
7. When the install program has finished, rename the 6.x directory back to the original directory name, for
example, \Program Files\Lotus\Notes)
Domino Administrator Client, Domino Server
Installing Domino 7 on UNIX using multiple CDs
The Domino 7 server installation files do not fit on a single CD on some UNIX platforms; therefore, a new multiple-CD installation is provided. To maintain a consistent installation across all UNIX platforms, and to prepare for the time when additional platforms require more than one CD for server installation, the multiple-CD installation is used on all UNIX platforms, including those whose install files fit on one CD. The multiple-CD install unpacks and joins the contents of each CD into a single joined installation. Multiple-CD installation is only available for UNIX systems.
Running the multiple-CD install
Run the multiple-CD install in one of these two ways:
Note Run the multiple-CD install as the "root" user.
�
�
Run the install directly from CD1*
Copy the files from the CD(s) to a directory** and run the install from there. Copy all of the contents from CD1 but
do not copy the file, Install.dat, from any subsequent CDs when copying their contents to the directory. On CDs
other than CD1, Install.dat is only used when running the install from physical CDs. If the file Install.dat from CD1
is overwritten, the multiple-CD install will fail.
* You cannot be "physically" on the CD when you run the install from CD1 due to mounting/unmounting considerations. You must be in a directory other than the CD directory and then run the install. For example, if the CD is mounted on /mnt/cdrom, you must be in a directory such as /tmp and then run the Install as /mnt/cdrom/Install.
** For Linux on zSeries, or z/OS; you must use the "copy the files to a directory" method.
There is an initial install script (Install) on CD1 which when run, pulls together the "parts" on each CD to create the
final joined installation. You specify where to put the joined installation; the multiple-CD install then uses the specified
directory both for the joined installation and for temporary storage of the multiple-CD parts. Keep this in mind when
selecting the directory to use, because the install requires an amount of space equal to approximately twice the
number of CDs. For example, if there are two CDs, the size needed is approximately 2*2*600Mb=2.4Gb; however, this
is a "burst" usage because the temporary storage area will be removed and the size will shrink by approximately half.
When multiple-CD install finishes creating the joined installation directory, it prompts you to start the standard "interactive" install process which actually installs Domino on the system. You can choose not to continue the install and then do so manually at a later time. This option is useful when setting up a network installation directory.
On some UNIX platforms, you must manually mount the CD because the OS does not automatically do so. The multiple-CD install then handles mounting and unmounting of the CDs but it does not handle ejecting the CDs. IBM AIX and some versions of Linux require that you manually mount and unmount CDs; Solaris automatically mounts the CD.
52
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
On AIX, to allow the multiple-CD install to work correctly, you must define a CDRFS file system in /etc/filesystems.
For example, /mnt/cdrom has the entry:
/mnt/cdrom:
dev
vfs
mount
options
account
=
=
=
=
=
/dev/cd0
cdrfs
false
ro
false
On Linux for zSeries systems, copy the Domino installation files as follows:
�
Using a binary method to transfer the files, copy the files, Install, Install.dat, zlinux.taz.aa and zlinux.taz.aa.c,
from the CD ROM at your workstation to a Linux on zSeries file system where they can be expanded and used for
installation.
On z/OS systems, copy the Domino installation files as follows:
�
Using a binary method to transfer the files, copy the files, Install, Install.dat, zos.taz.aa, zos.taz.aa.ck, zos.taz.ab,
and zos.taz.ab.cks, from the CD-ROM at your workstation to a z/OS system where they can be expanded and used
for installation.
Sample runs of the multiple-CD install:
Case 1 -- AIX Multi-CD install from CD (2 CDs in the example set)
# mount /mnt/cdrom
# cd /tmp
# /mnt/cdrom/Install
Please enter the location for the unpacked install kit
Install kit location: /local1/aixkit
Relocating CD 1 (1 of 2) contents to: '/local1/aixkit/CD_images'
Done with CD1 (1 of 2)
Remove current CD and insert the next CD
Press the RETURN or ENTER key to cotinue:
...Sleeping for 10 seconds to allow drive to settle...
Relocating CD 2 (2 of 2) contents to: '/local1/aixkit/CD_images'
Done reading/relocating all CDs.
Remove this last CD 2 (2 of 2)
Press the RERTURN or ENTER key to cotinue:
Now verifying the saved tarfile contents...
Now unpacking the saved tarfile(s) contents...
Do you want to start Domino installation (interactive) now? (y/n)
n
*** Please perform the following commands to proceed with the installation:
cd /local1/aixkit
/local1/aixkit/install
*** Now exiting...
Case 2 -- Linux Multi-CD install - Copied from CD, installed, and ready to be run from the network (1 CD in the example set):
#
#
#
#
#
#
#
mkdir /tmp/CD
mount /mnt/cdrom
cd /mnt/cdrom
cp * /tmp/CD
cd /tmp/CD
umount /mnt/cdrom; eject
./Install
53
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Please enter the location for the unpacked install kit
Install kit location:
/local2/inst
Relocating contents of CDS (1) to: '/local2/inst/CD_images' Done relocating all CDs.
Now verifying the saved tarfile contents...
Now unpacking the saved tarfile(s) contents... Do you want to start Domino installation (interactive) now? (y/n)
n
*** Please perform the following commands to proceed with the installation:
cd /local2/inst
/local2/inst/install
*** Now exiting ...
#
Domino Administrator Client, Domino Server
Installing Domino on UNIX and on Linux on zSeries
The Domino Administrator documentation contains the topic "Installing Domino on UNIX and on Linux on zSeries
systems." The numbered procedure in that topic should be replaced with this new procedure:
1. Copy the following Domino installation files from the CD ROM at your workstation to a Linux on zSeries file system
where it can be expanded and utilized for the installation steps. Be sure to transfer the file using a binary method.
For example, for FTP, set the transfer mode to binary. Neither the tar file nor its contents are required after
installation has completed:
�
�
�
�
install
install.dat
xlinux.taz.aa
zlinux.tax.aa.ck
Domino Web Access
Installing Domino Web Access 7.0
DWA7.NTF is our latest, feature rich template available in Domino 7. The user visible name has changed to Domino
Web Access 7. When registering users, choose Domino Web Access 7 as the mail file template.
To upgrade users, convert existing INOTES5.NTF, INOTES6.NTF and INOTES60.NTF users to DWA7.NTF using the
mail conversion utility.
This example shows how to upgrade all INOTES6 mail databases in a directory:
load convert mail\*.nsf iNotes6 dwa7.ntf
This example shows how to upgrade all INOTES5 mail databases in a directory:
load convert mail\*.nsf inotes5 dwa7.ntf
Note If you execute a convert while the server is running and someone accesses a mail file while their mail file design
is being updated, unpredictable results may occur.
54
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Access for Outlook
Installing Domino Access for Microsoft Outlook
IBM Lotus Domino Access for Microsoft Outlook (DAMO) allows Microsoft Outlook 2000, Outlook XP, or Outlook 2003
users to connect to an IBM Lotus Domino Server running Domino 6.5.1 or higher. If you are upgrading from a 6.5.x
version, please refer to the "Upgrading from 6.5.x to 7.0" instructions before installing.
For information on migrating users from Exchange to Domino, see the release note "Migrating from Exchange to
Domino."
Upgrading from 6.5.x to 7.0
Users can upgrade from Domino Access for Microsoft Outlook 6.5.x to release 7.0. However, if they are upgrading
from 6.5.3 or earlier, the upgrade will continue to use a single data directory that allows multiple users to have
profiles sharing that directory. To take advantage of the Multi-User Installation capabilities of DAMO 7.0, in which each
user can have his or her own data directory, users must first uninstall DAMO 6.5.x, and then install DAMO 7.0. Before
doing this, users may want to back up the existing *.nsf , *.pst and *.ost. files as a precaution. The initialization
process of the new installation will recreate the mail files locally.
During the upgrade users will be asked if they want to create a profile at the end of the upgrade process. If they
choose No, they can create new profiles at anytime in the future by choosing "Create New MAPI Profile" from the Start Programs - IBM Lotus Domino Access for Microsoft Outlook shortcut. Note: Users cannot create a DAMO profile using
the Outlook Setup Wizard. They must use the "Create New MAPI Profile" shortcut on the start menu.
Setting up Condensed Directories for Offline
Domino Access for Microsoft Outlook users can create a local replica of an address book to use when working offline,
disconnected from the network. Using Domino Preferences in Microsoft Outlook, users can select an address book to
take offline. It is strongly recommended that a condensed directory catalog is available for users to conserve space
and improve the time it takes to replicate. For information about creating condensed directory catalogs, see the
Domino Administration help topics on creating Directory Catalogs.
Keeping Your Mail File Secure
There is new capability that allows for multiple users to share the same Domino Access for Microsoft Outlook
installation. This type of installation, however, allows access to other users' .pst files because the .pst and .nsf files are
local. Typically, in both a standard Notes environment and a standard Outlook environment, the mail file is on the
server and the server controls access. And, if a user travels, typically he or she is the only user that has access to the
laptop containing the local replica.But since DAMO requires all files to be on the local workstation, you need to protect
your local mail data file (*.pst) from others by assigning a password to your local data mail file. Additionally, the
individual users can each have their private folder hierarchy as their data directory. For example: c:\Documents and
Settings\<user>\DAMO_Data.
Microsoft Outlook 2000, Outlook XP, and Outlook 2003 each have a different method of assigning a password to the
local data file. Please see the on-line help for your release of Outlook.
DAMO 7.0 Installation Notes for Administrators
Before running the setup.exe that installs Domino Access for Microsoft Outlook, the user must be a registered Domino
user and have the notes.id file available. Also, users need to know their user name as defined in the Domino directory
and the IP address of their mail server.
Administrators can install Domino Access for Microsoft Outlook without end user involvement or end users can install
it on their workstations. If end users are doing their own installs, you should distribute the "End User Installation"
procedure below to end users, along with the sections on differences, known problems and migration Issues. This
information is also available to users in the "Lotus Domino Access for Microsoft Outlook Installation and Setup Guide"
on www.Lotus.com/ldd/doc.
Although this product is for Microsoft Outlook users connected to Domino, access through any client connected to
Domino is also available. Users can be configured using the standard administration tools provided with Domino, as
long as the mail database design is Mail7.ntf, Mail7ex.ntf or DWA7.ntf. Mail files that use the Domino for Web Access
7 (DWA7.ntf) template can connect to their mail file on the Domino server using a browser, Domino Access For
Microsoft Outlook, or a Notes client.
55
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Administrator Installation
If you are installing Domino Access for Microsoft Outlook on a workstation for an end user(s), you must be aware that
Windows security is in play so that it is necessary to create the DAMO user's profile using the identity of that user.
Creating a profile in any other way will hide that profile from the intended user.
There are two ways to create the users' profiles:
�
The simplest method of creating user profiles is to log on to the Windows workstation as the intended DAMO user.
In this way, using the steps below, there is the ability to create the data directory in the user's private folder
(for example, c:\Documents and Settings\<user>).
�
An alternative method is to use the Windows RunAs functionality where a Windows Administrator can assume
the identity of each user to create a DAMO profile.
Note: For a multi-user install, each registered user on the workstation must be a member of the Power Users group to
be able to select their profile when DAMO starts.
Silent Install
The Silent Install option installs Domino Access for Microsoft Outlook and creates a profile without end user
involvement. This process uses the inherent InstallShield capabilities that calls a setup file containing the user's
connection information to the Domino server.
For example, to set up Domino Access for Microsoft Outlook for multiple users on one workstation, the administrator
can run Silent Install and assume the users' logon rights with the RunAs capability for each user.
There is one setup file for each user. The setup file is a text file that contains the following connection information:
-u <User Name> -s <Server IP address> -f <Full path to ID file> -p <id file Password>
For example:
-u Homer Simpson -s 1.11.11.111 -f c:\lotus\notes\data\homer.id -p 123456
The DAMO setup executable is called using the following syntax:
setup.exe /s /v"/qn SETUPFILE=<complete path to setup file>"
For example:
setup.exe /s /v"/qn SETUPFILE=c:\user\info.txt"
Note: The syntax must be exact . Notice that after
quote at the end of the line.
/v there is no space before the quote. Also, there is a closing
Using RunAs on Windows XP
Option 1 - Using the Install Wizard
1. As the Windows Administrator, run setup choosing the desired options, including either the Single User or the
Multi-User install options.
2. Choose to not create a profile.
3. Click Start - Programs - IBM Lotus Domino Access for Microsoft Outlook, and then right click on "Create New
MAPI Profile."
4. Choose "Run As..."
5. In the Run As dialog, select "The following user:"
6. Enter the user's domain, user name, and password.
7. Enter the connection information as described in "Create a User Profile for DAMO."
Option 2 - Using the Silent Install
1. Open a DOS window (cmd.exe) by clicking Start - Programs - Accessories, and then right-click Command Prompt.
2.
3.
4.
5.
Choose Run As ...
In the Run As dialog, select "The following user:"
Enter the user's domain, user name, and password.
At the DOS prompt, enter the setup syntax as described in the "Silent Install"section above.
56
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Using RunAs on Windows 2000
Option 1 - Using the Install Wizard
1. As the Windows Administrator, run setup choosing the desired options, including either the Single User or the
Multi-User install options.
2. Choose to not create a profile.
3. Open a command prompt (Start - Programs - Accessories - Command Prompt)
4. Change to the program directory for Domino Access for Microsoft Outlook.
5. Run the executable file, dfosetup.exe, as the intended DAMO user using the following syntax:
c:\> RunAs /USER:"WinDomain\<DAMO User>" dfosetup.exe
6. Create the profile using the connection information described in "Create a User Profile for DAMO" below.
Option 2 - Using the Silent Install
1. Open a DOS window (cmd.exe) by clicking Start - Programs - Accessories - Command Prompt.
2. Use the RunAs command to open another DOS window so that anything run in that window will be run with rights
of the user who opened that DOS window.
C:\> RunAs /USER:"WinDomain\<DAMO User>" cmd.exe
3. From that new window run the install as that user:
setup.exe /s /v"/qn SETUPFILE=<complete path to setup file>"
4. Although it is more complicated, the RunAs command can be used without the need to open a new DOS window.
Use the following syntax, which is a combination of the Windows RunAs syntax (RunAs /?) and the Silent Install
capability. Note: Because of the possible need for nested quotes, you may need to use an escape character (\) if
spaces are involved.
C:\> RunAs /USER:"WinDomain\<DAMO User>" <path to DAMO setup.exe> /s /v\" /qn
SETUPFILE=<path to setup file>\""
i.e.:
/qn
C:\> RunAs /USER:"ADomain\Homer Simpson"
"C:\Temp\setup.exe> /s /v\" SETUPFILE=C:\User\info.txt\""
Outlook 2000 Users
If you configured Outlook for Internet Only support, you must reconfigure Outlook for Corporate or Workgroup. To
reconfigure Outlook run Outlook and select the menu Options --> Mail Services and select "Reconfigure Mail Support."
You may be required to supply your Microsoft Office install CD for this operation.
End User Installation
To install Domino Access For Microsoft Outlook (DAMO), you need to know the following:
�
Your Notes user name (such as jsmith)
�
The IP address of your mail server
�
The location of your Notes ID
During installation, you choose whether to do a single user or a multi-user install on a workstation. Note: For a
multi-user install, each person who uses the workstation must be a member of the Power Users group to be able to
select their profile when DAMO starts. Only if you have administrative rights to the Windows workstation will you have
the option to choose Single or Multi-User Installations. If you are not a member of the Windows administrator group,
you will not get the option to choose Single or Multi-User Install. The Installation will be a Single User Install.
�
Single User Install -- Choose this option if you are the only one who uses the workstation. In single user installs, the program and data files are in the same directory. �
Multi-User Install -- Choose the Multi-User Install option if more than one person uses the workstation. Multi-user installs allow the creation of data directories specific to each user, thereby providing some security for each.
Note: You must Configure Outlook using the steps below or Domino Access for Microsoft Outlook will not install properly.
Configure Microsoft Outlook
1. Set Microsoft Outlook as the default mail program. For example, open the Control Panel and choose Internet
Options. Select the Programs Tab - E-mail Option, and then select Microsoft Outlook. (This path may vary slightly
depending on which Windows OS you are using and how you have your system set up.)
57
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
2. If this is a new installation of Microsoft Outlook for this user, launch the client as this user to complete the
installation process of Microsoft Outlook.
a.
b.
c.
d.
Start - Microsoft Outlook shortcut
Accept the user name
Outlook 2k - Choose "Manually configure..." Make no more selections and click Finish
Outlook XP (2002) and Outlook 2003 - To the question "Would you like to configure an E-mail account?",
choose No. Click Finish.
3. While Outlook is open, select Tools - Options - Mail Services and select the option "Prompt for a profile to be
used."
Install DAMO
1. Execute the Setup Program.
2. Choose whether to install Domino Access for Microsoft Outlook for a single user (only one mail box is created) or
multiple users (each user will have their own mail box). Only if you are the Windows administrator will you see
these choices.
3. (Optional) Select Single Logon Feature to synchronize your Notes ID password with your Windows password.
When passwords are synchronized, you can change either password and the change will be made to both
passwords.
4. After the installation process is complete, you now need to create a DAMO profile. See Create a User Profile for
DAMO below.
Create a User Profile for DAMO
You cannot create a DAMO profile using the Outlook Setup Wizard. You must use the "Create New MAPI Profile"
shortcut on the start menu.
1. From the Start menu, choose Start - Programs - IBM Lotus Domino Access for Microsoft Outlook - Create New
MAPI Profile.
2. For "Your Name," enter your Domino common user name. For example, jsmith not jsmith/sales/acme.
3. For "Domino server name," enter the name or the IP address of your mail server.
4. If you installed multi-user version, and you want your Data directory to be in a different directory than your
program files, enter a path for your mail files in the "Data Directory" field. For example, c:\Documents and
Setting\jsmith\DAMOData or c:\DAMO jsmith. Tip: You can use Windows folder security settings, to
protect these folders as necessary.
5. If DAMO does not find your Notes ID in your Person Document on the Domino server, you may be prompted for
one. Type the path or Browse to locate your Notes ID.
6. (Optional) Copy your Notes ID file to your data directory. (It is always good to have a backup copy of your ID file.)
7. Your DAMO profile will be created.
For information regarding the differences between using Notes and Microsoft Outlook, and known issues, see these
related release notes:
�
�
Domino Access for Microsoft Outlook issues
Recurring meetings
See also the topic "Working with Domino Access for Microsoft Outlook" in the Domino Access for Microsoft Outlook
help.
Domino Server, Domino for i5/OS
Installing Domino 7 for i5/OS
Installing Lotus Domino 7 for i5/OS
If you have previously installed a Domino 7 beta release, you must first remove the beta software (DLTLICPGM
5733LD7), and then install Domino 7 for i5/OS.
Refer to the following sources of information for more details regarding the Installation of Domino 7 for i5/OS:
�
�
�
the readme file that accompanies the electronic download (readme.txt)
Domino 7 for i5/OS HELP (i400help.nsf)
Installing and Managing Domino 7 for i5/OS (i400help.pdf).
58
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Upgrading from Domino R5
If you are planning to upgrade from Domino Release 5 to Domino Release 7, you must first upgrade your system from
OS/400 V5R2 to i5/OS V5R3, and then install Domino 7. Domino R5 is not supported to run on i5/OS V5R3, but for
the purpose of upgrading from Domino R5 to Domino 7, Domino R5 can reside on V5R3 after an OS upgrade and prior
to the Domino 7 install. Once you install Domino 7, any existing Domino R5 servers will be automatically upgraded.
Only upgrades from Domino 5.0.13 are supported.
Installing on OS/400 V5R2 or i5/OS V5R3 with Domino Release 6
If you are planning to upgrade from Domino Release 6 on OS/400 V5R2 to Domino Release 7, you must first upgrade
your system from OS/400 V5R2 to i5/OS V5R3, and then install Domino 7. Domino 7 for i5/OS may be installed on
i5/OS V5R3 with Domino R6 already installed.
If your Domino release is 6.0, 6.0.1, or 6.0.2, then any existing Domino servers will automatically be upgraded when
you install Domino 7. If your Domino release is 6.0.3 or 6.5.0 or later, then Domino 7 will be installed as a
multi-version capable release and any existing Domino servers must be upgraded manually using the UPDDOMSVR CL
command.
For more information about Multi-version capable Domino, refer to Chapter 12 Using Domino for i5/OS multi-version
capabilities in the Domino 7 for i5/OS HELP (i400help.nsf) or Installing and Managing Domino 7 for i5/OS (i400help.pdf).
Domino for i5/OS
CD batch installation
Domino 7 does not support the batch installation feature using the LODRUN command with physical media. The
OS400/INTLENG/BATCH directory files were removed from the CD when the Domino product grew to require a second
CD for installation.
Domino Server
Display issue with server's Japanese license agreement dialog
If you are using the Japanese locale on Windows 2000, and are having problems viewing the license agreement,
changing your default language to also be Japanese should correct the issue. This is not an issue on Windows 2003.
Domino Server
DOLS install on Linux Mozilla
For this release of Domino 7, the download and installation of Domino Offline Services (DOLS) may take several
minutes to complete.
Domino Administrator Client, Notes Client, Domino Designer
For verification of a silent install, add "+" to the command
To display a prompt when the installation is complete, or when it fails, use the (+) parameter at the end of the
command. Here is an example:
setup.exe /s /v"/qn+"
Domino Administrator Client, Domino Server, Domino for z/OS
New default install directory for Domino on UNIX
On UNIX platforms, the default installation directory for Domino 7 is /opt/ibm/lotus. If an installation directory is
detected during an upgrade to Domino 7, the existing installation directory is used. For previous versions of Domino,
the default directory on UNIX platforms was /opt/lotus.
Note As in previous releases, the default Domino installation directory can be modified to support any third-party
applications which may rely on a particular directory path.
59
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Notes Client, Domino Designer, Domino Server
Notes.jar and other Java archives moved
In previous releases, Notes.jar and many of the other Notes archives were being installed into the Notes or Domino program directory. Now, most of the Notes Java archives are being installed in a new location to take advantage of Java's Extension Class Loading mechanism.
Notes.jar will now be installed in the Notes or Domino program directory under the jvm\lib\ext (Windows) or jvm/lib/ext (UNIX) directories. This is Java's Extension directory, and archives copied there will be automatically added to the classpath.
This is also the suggested way of adding external application code so it can be used by Notes or Domino java applications.
Also starting with the 7.0 release, Notes.jar contains all the classes necessary to support access to the Domino back-end classes through the local interface, and through the CORBA-remoted interface. Or, stated another way, the contents of NCSO.jar have been included in Notes.jar, and if your application needs to use either style it only needs access to Notes.jar.
NCSO.jar still ships with the 7.0 release, and it provides only the CORBA-remoted interface to the back-end classes.
Domino for i5/OS
Remove any Beta versions before installing
Before installing Domino 7 software, you must remove any beta or pre-release versions. To remove the beta or pre-release version, make sure that all Domino servers are stopped and no users are running any Domino CL commands (i.e., WRKDOMSVR). Enter the following command to remove any beta or pre-release version of Domino 7: DLTLICPGM LICPGM(5733LD7)
Domino Administrator Client, Notes Client, Domino Designer
Renaming desktop icons will have to be manually deleted
After installing the Client, new desktop shortcuts will be created for the Notes, Designer, and Administrator Clients. If you rename these desktop icons to customize them, you will need to manually delete them after uninstalling the Client. If you are upgrading an existing install that currently has desktop shortcuts that have been renamed, the old shortcuts will no longer work. Simply remove them from your desktop and use the newly created shortcuts.
Domino Administrator Client, Notes Client, Domino Designer
Scriptable Client Setup & the 'AdditionalServices' variable
The Scriptable Client Setup feature provides the AdditionalServices variable to enable/disable appearance of the 'Additional Services' dialog during a new Client Setup. This variable works in conjunction with the variables for features that are configured via the Additional Services dialog. As a result, this variable is tied to use of the related variables (Internet Mail account, NNTP account, LDAP account, Proxy servers, and Replication).
Specifically, here are some examples of how the AdditionalServices variable works in a configuration file:
�
�
AdditionalServices=1 --> the Additional Services dialog will always display during a new Client Setup,
regardless of other variables in the configuration file. If the configuration file contains some or all of the related
variables, the fields will display the configuration file's data value in each field. If a certain variable is missing
from the configuration file, the field will be blank. In all cases, the user can either leave the field value intact or
change the field value.
�
�
AdditionalServices=-1 --> Setting a value of AdditionalServices = -1 (minus 1) in the config file will suppress the
additional services dialog, regardless of other variables in the configuration file.
�
�
AdditionalServices=0 --> the AdditionalServices dialog will not display as long as sufficient configuration
information is supplied for one or more of the related variables.
60
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Sufficient configuration information:
Internet mail­
First check to see if there are entries for Incoming Server and Outgoing Server.
[mail.incoming.server & mail outgoing.server
�
on the InternetProtocolPane check for a POPServerName entry. [takes the same name as
above]
�
on the InternetMailLoginPane check for a username. [mail.incoming.username]
�
on the InternetAddressPane check for IMailAddress [mail.outgoing.address] and the
SMTPServerName.
NNTP or LDAP- must have server
Proxy - must have HTTP proxy
Reply - must have enable OR threshold
�
Here are some examples:
�
If the configuration file contains all of the variables for all possible accounts/settings, then the Additional
Services dialog will not display during a new Client Setup
�
If the configuration file contains all of the variables for the referenced accounts/settings, then the
Additional Services dialog will not display during a new Client Setup
�
If the configuration file does not contain any of the related variables, the Additional Services dialog will
display during a new Client Setup
�
If the configuration file contains variables to set up an internet Mail account, but is missing a sufficient
information to configure the account (ex. the Mail.Incoming.Server variable), the Additional Services dialog
will display during a new Client Setup.
Domino Administrator Client, Notes Client, Domino Designer
Scriptable Client Setup: 'File cannot be created' error
When performing a new Client Setup using the Scriptable Client Setup feature, you may receive this error:File cannot be created. This occurs if the KeyFileName variable in the configuration file is pointing to a drive that is not accessible on this machine. For example, if the user id file is located on a network drive and the user does not have access to the drive, this error will result. To workaround this, either correct the drive access problem for the user or move the user's id file to another location & update the configuration file to reflect the new path.
Domino Administrator Client, Notes Client, Domino Designer
Scriptable Client: Setup for Roaming Users
Some special factors should be taken into consideration when using the Scriptable Client Setup feature for Roaming Users. Because the Roaming User is configured to store many settings in their roaming databases, some Scriptable Client Setup variables may not be ideal for use in combination with Roaming Users. Below are some examples:
�
It is recommended that the KeyFileName variable not be used for Roaming User Client Setups. This variable is
used to point to a specific user's ID file. Since the Roaming User's ID file is stored in their roaming address book,
the id file will be automatically pulled from this roaming database during a Client Setup. As a result, this variable
is irrelevant for Roaming User Client Setups.
�
There are unique issues for Roaming Users who have an NNTP or IMAP Internet Account, as described in the "
Roaming Users with NNTP or IMAP Internet Accounts" release note. Please reference this release note for
specific details before including these account types in a Script that will be used for Roaming Users.
�
If the network dialup account information differs on each user's machine, use of the NetworkDial.* variables
should be well thought out to assure the values will work on all machines for the user. Specifically, if the user has
a Windows Client & a Macintosh Client, network dialup for the Internet Accounts will not work on both machines
for this user (network dialup is not supported on Macintosh). In addition, if the dialup phonebook name is not
identical on all machines, dialup may fail because it cannot locate the phonebook entry.
�
If you fail to set the Replication.Schedule variable to 1 for a first time Roaming User Client Setup, replication will
not be enabled for this roaming user. As a result, the user's local files will not automatically replicate to the
server on launch & exit of the Notes Client. To work around this, the user can edit their location document(s),
enable replication, & enable the 'Replicate when Notes starts' and 'Prompt to replicate when Notes shuts down'
options.
61
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Administrator Client, Notes Client, Domino Designer
Scriptable Client: Setup & deployment to multiple users
Some special factors should be taken into consideration when using the Scriptable Client Setup feature. Because this feature can be used to roll out a standard configuration to multiple users, care should be taken when using certain variables. Below are some examples:
�
It is recommended that the KeyFileName variable not be used unless the configuration file is intended for one
specific user. This variable is used to point to a specific user's ID file. As a result, if the configuration file is used
to standardize Client Setup for many users, this variable does not apply.
�
It is recommended that the Mail.Incoming.Username and Mail.Incoming.Password variables not be used unless
the configuration file is intended for one specific user. These variables are unique to each user. As a result, if the
configuration file is used to standardize Client Setup for many users, these variables do not apply.
�
It is recommended that the NetworkDial.EntryName, NetworkDial.Username and NetworkDial.Password
variables not be used unless the configuration file is intended for one specific user. The NetworkDial.EntryName
must be exact to the phonebook entry on the users' machines. If the dialup phonebook name is not identical on
all users' machines, dialup may fail for some users because it cannot locate the phonebook entry. The
NetworkDial.Username and NetworkDial.Password are unique to each user. As a result, if the configuration file
is used to standardize Client Setup for many users, these variables do not apply.
Domino Administrator Client, Notes Client, Domino Designer
Select Migrations Tools to "run from network" for shared install
If you are selecting to install the Migrations Tools when doing an end user installation from an admin image (shared network installation), select one of the "run from network" options:
This feature will be installed to run from network.
This feature, and all subfeatures, will be installed to run from the network.
If you select one of the "installed on local hard drive" options you may not be able to successfully uninstall the shared client receiving an error similar to:
Error 1315. Unable to write to the specified folder
<path to network share>\Program Files\Lotus\Notes\.
Domino Administrator Client
Shared uninstall fails w/ Admin Migrations Tools installed
If you are selecting to install the Admin Migrations Tools when doing an end user installation from an admin image (shared network installation), you will not be able to successfully uninstall the shared client receiving an error similar to:
Error 1315. Unable to write to the specified folder
<path to network share>\Program Files\Lotus\Notes\.
It is suggested that administrators use a transform to hide this install option.
Workaround
If a user is in this situation the following can be done to all the end user to successfully uninstall the end user installation:
1.
2.
Make a backup copy of the network share
Temporarily grant the end user full control of the read-only network share
�
This will allow the uninstall to successfully complete as it's failing on the removal or a few shared
network files
3.
End user completes a successful uninstall
4.
Remove the temporary access
5.
Restore the backup copy of the network share
62
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Administrator Client, Notes Client, Domino Designer
Single logon: Admin rights restart after install/upgrade/repair
You need to have Administrator rights on your operating machine in order to install the "Single Logon" feature. If you
have selected the "Single Logon" feature during a Notes Client installation, simply restart your computer to enable the
"Single Logon" feature. You will no longer be prompted to enter a password when launching the Notes Client.
If you upgrade or repair a Notes Client, you also need restart your computer to enable the "Single Logon" feature
again.
Domino Administrator Client, Notes Client, Domino Designer
Single Logon: Feature upgrade and disable
If you currently have an existing Single Logon Notes install you'd like to upgrade, it is advised that you enable Client
Single Logon again during the upgrade.
If you no longer would like this feature enabled on your operating machine, please uninstall the Single Logon feature
(Modify or upgrade).
Domino Server
Specify the Server Controller as an NT service at installation
If you wish to change the parameters of the Server controller, you can then use the SC tool (Sc.exe) included in the
Resource Kit. See Microsoft Knowledge Base Article - Q251192 at
http://support.microsoft.com/default.aspx?scid=kb;en-us;Q251192
To add the -jc to a standalone server installed as a service you would do:
sc config "Lotus Domino Server (lotusdominodata)" binPath= "c:\lotus\domino\nservice.exe
=c:\lotus\domino\notes.ini -jc"
This is of the form: sc <server> [command] [service name] <option1> <option2> . . .
Domino Administrator Client, Notes Client, Domino Designer
To enable Progress Bar during silent Client install
If you'd like to see a progress bar display on your screen during a silent install of the Lotus Notes Client, use the
switch /qb in the command line.
Domino Administrator Client, Notes Client, Domino Designer
Upgrading Lotus Notes must be to the same directory
There can be only one registered Lotus Notes client in your registry, per operating system. Lotus does not support
having multiple Lotus Notes installs on the same operating system. If you currently have an install on your operating
system, and attempt to install a newer version, you must install the newer version to the same program and data path
(upgrading the existing install), otherwise, you will need to uninstall the older version of Lotus Notes before installing
the newer one.
Domino for i5/OS
Wire protocol drivers installed with Domino
Lotus Branded DataDirect Connect for ODBC consists of a number of database drivers that are compliant with the
Open Database Connectivity (ODBC) specification. The drivers enable you to connect to a variety of relational
databases.
The user is no longer required to download and install the drivers.
Starting with Domino 7 and Domino 6.5.3, the Lotus Branded DataDirect Connect for ODBC wire protocol drivers are
installed by the Domino installation program to the directory /QIBM/ProdData/Lotus/DOMINOxxx/EITODBC/, where
DOMINOxxx is the directory corresponding to the release of Domino (for example, DOMINO700 for Domino 7.0).
63
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Migration notes
Domino Access for Outlook
Internet Access and the Outlook Express Migration tool
The Outlook Express migration tool uses short names to connect to the server. In order to use this tool, you must
make sure of the proper internet access settings in the Server Document, under the Security tab.
In the Internet Access section, select: Internet authentication: More name variations with lower security
This will allow Outlook Express users to use the Migration tool and connect to the Notes Mail Server.
Domino Access for Outlook
Migrating from Exchange to Domino
Use the following step-by-step instructions to migrate users and their mail files from Microsoft Exchange to Lotus
Domino using the Domino Migration Tool.
Prerequisites and requirements
�
You must have an admin.id and a cert.id for the Domino server.
�
You must set up an Administrator profile in Outlook for the Exchange server.
�
Microsoft Exchange must be installed as a Foreign Directory Source (part of the Administrator install).
�
You must use the Extended Mail Template (Mail6ex.ntf) for all migrated Domino mail files.
Migration tips
When migrating very long distribution lists (i.e., several hundred users) in the address fields (such as the To, CC or
bcc fields), the distribution list may be truncated or missing altogether when viewed in the Notes or DAMO client. The
distribution list truncates after 768K, and depending on the amount of system memory available, the distribution list
may be empty. The latter issue is an Exchange restriction, and is intermittent.
Make sure users have not renamed the standard Outlook folders in their Exchange mail file prior to migrating from
Exchange to Domino. If a user renames a standard Outlook folder, the data in that folder may not migrate correctly.
The standard Outlook folders are: Calendar, Contacts, Drafts, Inbox, Journal, Notes, Outbox, Sent Items, and Tasks.
For example, if a user renamed the Outlook folder Inbox to "MyFavoriteInbox," the messages in the "MyFavoriteInbox"
folder would not display and function properly after migration.
Contacts migrated from an Exchange mail file to Domino will appear in the Contacts view, but will not be migrated to
a separate .nsf file as in previous releases. A document with the subject "Exchange contacts have been migrated to
Domino" will appear in the All Documents view instructing the user how to replicate the Contacts to a local Personal
Name and Address book.
If the body of an Outlook message in RTF format has been corrupted, the body is converted as text only when the mail
file is migrated from Exchange to Domino. In this case, some attachments present in the Outlook message may not be
present after migration, when viewed through the Notes or Domino Access for Microsoft Outlook client.
Installation
Start the Domino Administrator Client, then follow these steps to migrate users and their associated mail stores from
Exchange to Domino.
1. From the Domino Administrator client, select the People and Groups tab.
2. From the Tools pane, click People, and then click Register - Migrate People.
3. When the Migrate People dialog opens, select Microsoft Exchange Users from the Foreign Directory Source.
4. When prompted, enter the profile of the administrator for the Exchange server from which you are migrating.
5. From the drop-down list of Exchange users, select all users to migrate and add to the People and Groups to
Migrate list, then select Migrate button. Note that you can modify the migration options (for example, you can
elect not to have a password created), or simply use the default settings.
6. Click Done. The entire list is added to the registration queue in the Register Person dialog.
7. In the Register Person dialog, click Register All. When you do this, all users are added to the Domino Directory
(public Name & Address Book) and their mail files migrated.
64
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Convert Microsoft Exchange addresses to Domino addresses
After migrating all users, ensure that all addresses are converted from Exchange to Notes canonical format (such as
CN=John Smith/OU=Sales/O=Acme), using the Mail Convert tool. Note that this tool only converts the addresses of
Microsoft Exchange users who exist in the Domino Directory. If you continue to migrate smaller groups, run this tool
each time a group is migrated.
Complete the following steps to convert Microsoft Exchange addresses to valid Domino addresses:
1. For the address conversion process to work correctly, the cache for NAB entries on the Domino Server which is
used for Exchange Mail to Domino migration must be current. Perform the following task on the Domino Server
Console to make sure the cache is updated and current:
tell router q
load updall <Domino Address Book> (e.g., 'load updall names.nsf')
load router
2. To perform the address conversion on all migrated mail files on the Domino Server (in the \mail subdirectory),
type the following on the Domino Server Console:
load convert -w mail\*.nsf
Other available commands
load convert -w <specific mail file path>
Use this command to run the Address Fix on a specified migrated mail file. For example: load convert -w
mail\chair.nsf
load convert -w -l <text list file path>
load convert -w -l c:\tmp\mailfilelist.txt
Use the first command to generate a text list file with all migrated primary mail file paths on the server, excluding any
replica mail databases. You can then run the Address Fix by using the second command with that text file.
load convert -w -f <text list file path>
Use this command to run the Address Fix on all migrated mail files listed in the specified text file. For example: load
convert -w -f c:\tmp\mailfilelist.txt
For troubleshooting information on migrating from Exchange to Domino, see the release note "Troubleshooting the
Exchange to Domino Migration." For a complete list of Domino Access for Microsoft Outlook issues, including
migration issues, see the release note "Domino Access for Microsoft Outlook issues."
Upgrade notes
Domino Administrator Client, Notes Client, Domino Server
Flat names and ID files are not supported in Domino and Notes 7
Notes 7 and Domino 7 do not support flat name and flat ID usage, renewal, or registration. As you upgrade to 7.0,
you should convert all flat names to hierarchical names. IBM Lotus will continue to support flat names in Release 6 at
the level at which they are currently supported. However, there are no plans to extend existing functionality that
requires hierarchical names to flat names, and new features continue to be added that depend solely on hierarchical
naming. Furthermore, future functional releases of Notes and Domino will have limited interoperability with users and
server with flat names and ID files.
Continuing to use flat names prevents you from using many of the new features in Lotus Notes and Lotus Domino 6
and 7, including the Domino Administration Process, which simplifies many administrative tasks. Using flat names
makes it difficult to exchange information securely with users and servers in a different organization. With flat names,
each user or server in one organization must be individually certified by the certifier ID in the other organization.
Organizations that use flat names often use several certifier IDs and each user ID and server ID can include a separate
certificate generated by each flat certifier ID.
For more information on converting flat names, see the topic "Converting flat names to hierarchical names" in the
Domino Administrator 7 Help.
65
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Administrator Client, Notes Client, Domino Designer
Online Help after upgrade of Notes, Admin Client, and Designer
If you have upgraded to the Gold version of Lotus Notes 7, Domino Designer 7 or Domino Administrator Client 7, and
you have not removed a previous beta build of Notes/Domino 7, you should take the following actions to ensure your
local help databases will be full-text indexed properly:
Take these actions from the Application UI:
1.
2.
3.
4.
5.
6.
7.
8.
Open Help.
Select the File menu, Properties
On the Database Properties dialog, click the Full Text tab (magnifying glass)
Click the Delete button.
If there was a full-text index from a older Notes/Domino 7 help file, it will be deleted.
If there was no full-text index, you will be notified with a message dialog (no harm done).
Close the Database Properties dialog
Recreate your Help file Index from the Help application, if desired.
Or, take these actions from Windows Explorer:
1. Navigate to your Data folder
2. Open the Help folder within the Data folder
3. If present, delete the folder with the same name as your Help database, with an extension of ".ft."
This folder contains the files for the full text index of your Help database.
4. Recreate your Help file Index from the Help application, if desired.
The Help (User Assistance) databases are named per the software release version (e.g., for Notes/Domino 7, the name
of the Notes Client help database is help7_client.nsf). If you are upgrading from a previous version of Notes, Domino
Administrator Client, or Domino Designer, your new Help database will not be full-text indexed until you take this
action.
Domino for i5/OS
Sametime customization saved to STLINKS.SAV on upgrade
The Domino server's data directory <data dir>/domino/html/sametime/stlinks was added in releases 6.0.5/6.5.4
and also exists in Domino 7.0. This directory did not exist in 6.5.3 and prior releases. This directory contains files
that enable Sametime integration with Domino Web Access (DWA) and files in this directory may be customized to
support tunneling.
When a Domino server is upgraded to release 7.0, any files in the existing <data dir>/domino/html/sametime/stlinks
directory are copied to a backup directory called <data dir>/domino/html/sametime/stlinks/stlinks.sav in order to
save any potentially customized settings.
The server upgrade process occurs:
- during install for servers that are not multi-version capable (Domino 6.0.2 and earlier)
- after install when the UPDDOMSVR command is run for a multi-version capable server (Domino 6.0.3/6.5.0 and
later)
Files will only be copied to the stlinks.sav subdirectory during upgrade if the stlinks.sav directory is empty or does not
exist. That is, if an install/upgrade occurs more than once for the same server the copy of the files to stlinks.sav will
only occur during the first install/upgrade.
If you make additional customizations to the files in stlinks, be sure to either copy the new customizations to
stlinks.sav or remove all files from stlinks.sav so that a subsequent install/upgrade will copy the latest files to the
backup directory.
66
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Notes Client, Domino Server
SmartUpgrade Web kits command line options
To accommodate customers who require access to the install kits that are bundled into the self-extracting executable
files that make up the Web kits, we have modified the default behavior of extracting the executable files from the Web
kits. The Web kits now prompt you for a temporary location in which to store the extracted files. This change may have
a negative impact on existing automated install methods, for example, it may cause SmartUpgrade to fail.
You can prevent this change to the install kits from impacting your current install methods by preventing the Web kits
from issuing the prompt for a temporary location.
From the Domino command line, use the command line option:
-px or /px
For example enter
setup.exe -px
Or
setup.exe /px
When the install finishes, the Web kits no longer automatically delete the extracted files from the temporary
directory. To remove extracted files, from the Domino command line, use the command line option
-d or /d to
For example
setup.exe /d /px For more information, see this Web site:
http://helpnet.installshield.com/robo/projects/pftw/Passing_command_line_options_to_the_package.htm
Configuration notes
Notes Client
Autosave - Clean up autosave.nsf from pre-release installation
If you have an existing Autosave.nsf on your system which was installed for Beta use or a pre-release install, please
delete it, then restart Notes. A corrupted autosave.nsf can be cleaned up by simply deleting it and letting the Notes
client re-create it.
Domino for i5/OS
Choose the format of HTTP log files.
HTTP log files are written in EBCDIC format by default on the i5/OS platform. You can change the format of these
files to ASCII by setting the following in the Notes.ini file. The setting will take effect the next time the server starts or
when HTTP starts again (for example, "tell http quit" then "load http").
HTTPLogFormatAscii=1
If HTTPLogFormatAscii is not present in the Notes.ini file or if the setting is HTTPLogFormatAscii=0 then the HTTP log
files will revert to their default EBCDIC format.
67
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Server
Console logging default state is "On"
"The default setting for console logging is now "ON", with a minimum 1K log file size. If the user later specifies the
CONSOLE_LOG_ENABLED Notes.INI setting, or enables logging via the server console command, then the default
console log size is changed to unlimited, unless the Notes.INI command CONSOLE_LOG_MAX_KBYTES is also set.
The user can disable console logging entirely by specifying "CONSOLE_LOG_ENABLED=0".
Domino Server
Domino for AIX configuration
Recommended that /etc/security/limits be modified for each Domino Server Partition userid (domsrv in this example)
to the following values:
domsrv:
fsize = -1
core = -1
data = -1
rss = -1
stack = -1
nofiles = -1
Make these be "unlimited" for the userid and Domino Server programs.
Domino Server
Domino for Linux on x86 configuration
Increasing the per-process filehandle limit
By default, the Linux kernel limits the number of file descriptors that any one process can open; the default is 1024.
This limit includes socket file descriptors that are opened during basic client/server communications, therefore is too
restrictive for the Domino process. Do not assume that having fewer than 1024 databases (or files) in the Domino data
directory is an indicator of the maximum number of open file descriptors that Domino will require. In order to scale
above "tens" of client connections, this default must be overridden by the Linux administrator.
The mechanism for overriding the default varies depending on how the Domino server is started. There are 2 basic
scenarios:
1. Domino is started from a login session
For this case, the default must be overridden by modifying the file /etc/security/limits.conf AND insuring it is
respected by the login. Edit /etc/security/limits.conf using root and add or modify the lines:
domsrvr soft nofile 20000
domsrvr hard nofile 49152
where "domsrvr" is an example of the user id that will run the Domino server. Specify the UNIX user name in the
first column that is the owner of the notesdata directory specified during Domino installation. If more than one
Domino partition exists on the same Linux for zSeries platform, repeat these lines for each user id. The "soft"
value specifies the new default file descriptor limit (ulimit -n), and the "hard" value specifies the maximum file
descriptor limit that may be set by the user.
In order for these limits to be respected following logon, insure the following line is in the appropriate pam.d login
file:
session
required
/lib/security/pam_limits.so
For example, if ssh login is used, this line must appear in /etc/pam.d/sshd
If telnet is used, this line must appear in /etc/pam.d/login
If rlogin is used, this line must appear in /etc/pam.d/rlogin
The user id must login after the above changes are made and saved.
68
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
2. Domino is automatically started through /etc/init.d
Starting a Domino server automatically when Linux is booted is typically accomplished by executing a script
which resides in the /etc/init.d directory (in a "runlevel") . It is worth noting, however, that
/etc/security/limits.conf settings are NOT respected when Domino is automatically started by a /etc/init.d
script. Therefore, a line such as the following MUST appear in the "start" section of such a script:
ulimit -n 20000
Warning: Always make /etc/security/limits.conf change ( 1. above) in addition to modification of the "start"
script. Otherwise, on the occasion that Domino is started from a login session, the file descriptor limit will be
inadequate.
Kernel values modified by Domino
In addition to the above, other Linux kernel value changes are needed for large scale Domino environments. Unlike
the per-process filehandle limit, which must be modified before logon of the Domino user id, these values can be
modified by Domino itself. At startup, a program named "tunekrnl" runs with root authority and sets these values in
the /proc filesystem. Once set, these /proc values will not change until Linux is (re)booted, at which time they revert
to their default values. The exception to this is "mapped_base", which is a process-local setting made at each Domino
startup. The "tunekrnl" log of /proc filesystem changes tends to vary from many (following a Linux boot) to few
(subsequent Domino startups). The kernel values modified by "tunekrnl" are:
kernel parameter
/proc/sys/fs/file-max
default value
(as low as 8192)
/proc/sys/kernel/sem
250 32000 32 128
/proc/sys/kernel/shmmax
32 M
/proc/sys/net/ipv4/tcp_fin_timeout
60
/proc/sys/net/ipv4/tcp_max_syn_backlog
1024
/proc/sys/net/ipv4/tcp_tw_reuse
0
/proc/sys/net/ipv4/ip_local_port_range
32768 61000
/proc/<pid>/mapped_base
1 Gigabyte
tunekrnl value
131072
description
maximum number of system-wide
file descriptors
250 256000 32 1024 shared semaphore allocation sizes
and limits
256 M
maximum shared-memory segment
size
15
retransmission timer for a FIN
(socket close) in seconds
16384
maximum value of the listen()
connection backlog
1
1 enables "time-wait assassination"
allowing for rapid re-use of sockets
1024 65535
increases the range of port values
available for connect()
16 Megabytes
"floor" address value above which
memory allocations may occur on
SLES
Domino Server
Domino for Linux on zSeries configuration
A detailed reference for the planning, installation, and configuration of Domino for Linux on zSeries can be found in
the Redbook "IBM Lotus Domino 6.5 for Linux on zSeries Implementation" found here:
http://www.redbooks.ibm.com/abstracts/sg247021.html
While written for an earlier Domino release, the planning considerations and task descriptions still apply to this
release.
Increasing the per-process filehandle limit
By default, the Linux kernel limits the number of file descriptors that any one process can open; the default is 1024.
This limit includes socket file descriptors that are opened during basic client/server communications, therefore is too
restrictive for the Domino process. Do not assume that having fewer than 1024 databases (or files) in the Domino data
directory is an indicator of the maximum number of open file descriptors that Domino will require. In order to scale
above "tens" of client connections, this default must be overridden by the Linux administrator.
69
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
The mechanism for overriding the default varies depending on how the Domino server is started. There are 2 basic
scenarios:
1. Domino is started from a login session
For this case, the default must be overridden by modifying the file /etc/security/limits.conf AND insuring it is
respected by the login. Edit /etc/security/limits.conf using root and add or modify the lines:
domsrvr soft nofile 20000
domsrvr hard nofile 49152
where "domsrvr" is an example of the user id that will run the Domino server. Specify the UNIX user name in the
first column that is the owner of the notesdata directory specified during Domino installation. If more than one
Domino partition exists on the same Linux for zSeries platform, repeat these lines for each user id. The "soft"
value specifies the new default file descriptor limit (ulimit -n), and the "hard" value specifies the maximum file
descriptor limit that may be set by the user.
In order for these limits to be respected following logon, insure the following line is in the appropriate pam.d login
file:
session
required
/lib/security/pam_limits.so
For example, if ssh login is used, this line must appear in /etc/pam.d/sshd
If telnet is used, this line must appear in /etc/pam.d/login
If rlogin is used, this line must appear in /etc/pam.d/rlogin
The user id must login after the above changes are made and saved.
2. Domino is automatically started through /etc/init.d
The redbook "IBM Lotus Domino 6.5 for Linux on zSeries Implementation" discusses this procedure in detail
(Chapter 9, Section "Automating Domino startup and shutdown"). It is worth noting, however, that
/etc/security/limits.conf settings are NOT respected when Domino is automatically started by a /etc/init.d
script. Therefore, a line such as the following MUST appear in the "start" section of such a script:
ulimit -n 20000
Warning: Always make /etc/security/limits.conf change ( 1. above) in addition to modification of the "start"
script. Otherwise, on the occasion that Domino is started from a login session, the file descriptor limit will be
inadequate.
Kernel values modified by Domino
In addition to the above, other Linux kernel value changes are needed for large scale Domino environments. Unlike
the per-process filehandle limit, which must be modified before logon of the Domino user id, these values can be
modified by Domino itself. At startup, a program named "tunekrnl" runs with root authority and sets these values in
the /proc filesystem. Once set, these /proc values will not change until Linux is (re)booted, at which time they revert
to their default values. The exception to this is "mapped_base", which is a process-local setting made at each Domino
startup. The "tunekrnl" log of /proc filesystem changes tends to vary from many (following a Linux boot) to few
(subsequent Domino startups).
70
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
The kernel values modified by "tunekrnl" are:
kernel parameter
/proc/sys/fs/file-max
default value
(as low as 8192)
/proc/sys/kernel/sem
250 32000 32 128
/proc/sys/kernel/shmmax
32 M
/proc/sys/net/ipv4/tcp_fin_timeout
60
/proc/sys/net/ipv4/tcp_max_syn_backlog
1024
/proc/sys/net/ipv4/tcp_tw_reuse
0
/proc/sys/net/ipv4/ip_local_port_range
32768 61000
/proc/<pid>/mapped_base
1 Gigabyte
tunekrnl value
131072
description
maximum number of system-wide
file descriptors
250 256000 32 1024 shared semaphore allocation sizes
and limits
256 M
maximum shared-memory segment
size
15
retransmission timer for a FIN
(socket close) in seconds
16384
maximum value of the listen()
connection backlog
1
1 enables "time-wait assassination"
allowing for rapid re-use of sockets
1024 65535
increases the range of port values
available for connect()
16 Megabytes
"floor" address value above which
memory allocations may occur on
SLES
Swap configuration for Linux on zSeries
SLES8 (31-bit) supports up to 2 Gigabytes of memory; a Domino server supporting thousands of users will typically
require more than 2 Gigabytes of memory, causing swapping to occur in this environment. At least 1 Gigabyte should
be allocated as a swap "disk", however actually swapping to disk (DASD) hinders performance. One mechanism to
keep swapping within system memory is XPRAM. The following general steps are an example of the configuration of 1
Gigabyte of XPRAM for Linux on zSeries in a native environment:
1. Configure at least 1 Gigabyte extended memory from the hardware console. Linux on zSeries will automatic
detect that.
2. Configure the xpram driver.
3. The following Linux commands set swap space 1G from a 3G partition that was made into a file system and
mounted off of the xpram_fs directory:
insmod xpram devs=1 sizes=2000000
mkswap /dev/slram0
swapon /dev/slram
4. Make sure the xpram swap has higher priority than other disk swap.
5. Note that these settings will disappear on a reboot. To keep them active, place these commands into
/etc/init.d/boot.local
64-bit native environments, such as SLES9 (64-bit), should be configured with more than 2 Gigabytes of real memory
rather than dedicating the memory resource to XPRAM. In these environments, Linux swap should still be configured,
however routine swapping is not expected and using disk for the swap region is acceptable.
Domino Server
Domino for Solaris configuration
/tmp must be configured as TMPFS (this is the default configuration for Solaris 9). In addition, the following line
must be added (or modified if already set) to the /etc/system file:
set rlim_fd_max=65536
This is the minimum required value - higer values are supported. As root, make the change as specified above, and
then reboot the system.
71
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Administrator Client, Notes Client, Domino Designer, Domino Server
Domino memory pre-allocation configuration
There is now code in Domino which, when enabled, will instruct Domino to pre-allocate shared memory at startup,
thus preventing the possibility of the server "crashing" with an error of the type "Error attaching to shared memory" or
"Error on mapping memory" during extended Domino server operation. This is due to the fact that at Domino startup,
we will immediately allocate/map in our maximum amount of useable shared memory and never again create any
more shared memory, thus preventing the possibility of a later process allocating shared memory that other
processes cannot map into their address space. The downside of this is that we will always automatically use up this
amount of virtual memory for shared memory and thus will be capped on available local memory based on the
addressable memory available to Domino on the operating system.
For example, with this code enabled, on Windows we will pre-allocate 1.5 GB of shared memory (default setting for
Constrained Shared memory, changeable via ConstrainedSHMSizeMB notes.ini setting) and with an addressable
memory of 2 GB (default value for Windows to match default setting of OS, changeable via
MEM_AddressableMemSizeMB notes.ini setting and OS configuration) that only leaves 512mb for local memory. The
upside is that running out of memory either in shared or local will not crash the server (or should not), whereas the
inability to map shared memory always will.
This new code is off by default and must be enabled by setting MEM_EnablePreAlloc=1 in notes.ini.
In order for this new code to work, we had to enable the sub-allocation of shared memory when pre-allocation is
turned on (can be manually enabled if desired and do not wish to pre-allocate by setting MEM_EnableSubAlloc=1 in
notes.ini; Sub-allocation is only on by default on AIX). With sub-allocation, we create shared memory as large
"segments" and then sub-allocate our memory pools out of them. For example, on Windows the size for a "segment" is
~200MB (default setting for sub-allocate Shared Memory segment size, changeable via MEM_SHMSubAllocSize (in
bytes) notes.ini setting) and we will then create our memory allocations out of it based on our shared dpool size of
4MB (default setting on Windows, changeable via SHARED_DPOOLSIZE (in bytes) notes.ini setting). This does limit
the maximum single allocation size to the size of a "segment" - in this case ~200MB - but internally Domino makes no
memory requests of this size, nor should any API program; an allocation request over this size will fail.
There are also some changes/additions to our memory variables which are set in the notes.ini file:
1. As stated previously, the variable "MEM_EnableSubAlloc=1" will enable sub-allocation of shared memory.
2. As stated previously, the variable "MEM_SHMSubAllocSize=VALUE" can be used to override our default setting for
the size of a sub-allocated "segment" of shared memory (where VALUE is in bytes, and the default varies by platform).
3. As stated previously, the variable "MEM_EnablePreAlloc=1" will enable pre-allocation of shared memory and will
also enable sub-allocation as well. (Setting this variable enables ConstrainedSHM and MEM_AddressableMem as well).
4. The variable "ConstrainedSHM=1" will now enable the constraining of shared memory only - it will not directly
inhibit "addressable" memory as before but will enable MEM_AddressableMem.
5. The variable "ConstrainedSHMSizeMB=VALUE" can still be used to override our default setting for constrained
shared memory (where VALUE is in megabytes, and the default varies by platform).
6. The variable "MEM_AddressableMem=1" will enable code to limit the amount of memory we see as "addressable".
Without this set there is still a default limit in place of 4GB and with the setting enabled more realistic values are
used.
7. The variable "MEM_AddressableMemSizeMB=VALUE" can be used to override our default setting for the amount of
memory Domino will see as "addressable" memory (where VALUE is in megabytes, and the default varies by platform).
8. There is now a variable on UNIX to enable using "mmap" for shared memory - "MEM_EnableMmap=1". This is on
by default on Solaris only and is not presently supported on any other platform (minimal testing has been done on
Linux x86).
9. There is now a variable to specify the location for where Domino will place "mmap" shared memory files "MEM_Mmap_Location=FOO" where FOO is the absolute path to the new location. This variable is only valid for
platforms running with "mmap" shared memory.
72
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Administrator Client, Domino Server
Domino Server Controller configuration
For Domino 7, the server controller TCP/IP address and the port number should be specified in the server's NAB.
Once the server has been set up, open the server record in the NAB. In the server document, look for the tab "Server
Controller" under Ports -> Internet Ports. There, you can edit the TCP/IP address and the TCP/IP port number for the
server controller of your server.
If you don't edit these fields, the TCP/IP address defaults to be the same as the server's TCP/IP address, and the
TCP/IP port number defaults to 2050. Save, and then restart the server one time without the server controller, so that
it will create the admindata.xml file for this server in the data directory.
Now you can bring down the server and start the server under the Server Controller as you normally do.
Notes Client
Enabling additional printer fonts
Beginning in Notes 7, the Notes client does not add a printer's additional fonts (if any) to the list of fonts.
When Notes users would like to use a printer's additional fonts in the Notes client, add the following line to the
Notes.ini file before running the Notes client program:
EnablePrinterFonts=1
Domino for i5/OS
Hardware Cryptography Support
This release note describes how to set up and use hardware cryptography (System SSL) with Domino for i5/OS. This
SSL can only be used with Domino HTTP at this time.
System
�
�
�
Requirements
5722-SS1 Option 34, Digital Certificate Manager
5722-DG1, IBM HTTP Server for iSeries
5722-AC2, Crypto Access Provider 56-bit for AS/400 or 5722-AC3, Crypto Access Provider 128-bit for AS/400
Hardware Setup
In order to use hardware cryptography (via System SSL) for i5/OS, you must have the hardware cryptography cards
correctly installed and configured. At the writing of this document, Domino for i5/OS supports the 4758 Cryptographic
Coprocessor and 2058 Cryptographic Accelerator hardware. The latest Cryptographic Hardware documentation can be
found in the IBM eServer iSeries Information Center (http://publib.boulder.ibm.com/html/as400/infocenter.html)
under Networking->Networking Security.
A white paper is available with step-by-step instructions on configuring System SSL for Domino HTTP. The white paper
is considered an extension of this release note and is highly recommended. This also covers basic setup of the 2058
Cryptographic Accelerator. The white paper is available on the Web at
ftp://ftp.software.ibm.com/as400/web/domino/pdf/crypto.pdf.
Further information on configuring the 4758 Cryptographic Coprocessor can be found in the Redbook "iNotes Web
Access on the IBM eServer iSeries Server" (http://www.redbooks.ibm.com/redbooks/pdfs/sg246553.pdf). See
sections 3.2.4 to 3.2.6.
Further information about System SSL and hardware cryptography in general are available in the Redbook "IBM
eServer iSeries Wired Network Security: OS/400 V5R1 DCM and Cryptography Enhancements" (
http://www.redbooks.ibm.com/redbooks/pdfs/sg246168.pdf).
Create or Obtain a Certificate for Domino
A certificate to be used by SSL is usually purchased from a trusted Certificate Authority (CA). Optionally you can
create your own certificate for testing purposes by creating your own local CA on the server. Certificate configuration is
done with the HTTP *ADMIN server, using the DCM section. Please refer to the DCM redbook for these procedures.
73
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Assign an Application ID for Domino
Domino for i5/OS uses an 'Application ID' (AID) to access the certificate created using the DCM. Refer to the white
paper or redbook for creating a new AID. Domino servers on the same system can use the same AID or their own AID.
Use the following for the "Add Application" screen:
Application ID: It is recommend to use DOMINO or the name of your Domino server (ex: MYSERVER). This name will
need to be added to Notes.ini in a later step, so write it down.
Application User Profile: Enter QNOTES. You can choose to enable the CA Trust List and authentication options in the
same table if needed. This will give Domino access to the SSL keys.
Application Description: Choose this option instead of Message File, and enter your own description, such as "Domino
Server MYSERVER."
Leave the Exit Program and Message File/ID sections blank and decide which authentication options are needed.
Domino Setup
Notes.INI Variables
The following are the Notes.INI variables that can be set for using System SSL. The variables that have ‘Y’ under the
REQ? column must be set in order to use System SSL.
REQ?
DESCRIPTION
NOTES.INI VARIABLE NAME
SYSTEM_SSL_HTTP=1
Y
Tells Domino to use the System SSL API instead
of SSLPlus for HTTP
SYSTEM_SSL_APPLICATION_ID=MYSERVER
Y
The Application ID created in DCM for this
Domino server
SYSTEM_SSL_TIMEOUT=30000
N
The number of seconds until the SSL V3.0
session identifier expires. The range is 0-86400
(1 day) seconds. System SSL will remember SSL
V3.0 session identifiers for up to this amount of
time. By remembering these SSL V3.0 session
identifiers, the amount of data exchanged during
the SSL handshake can be reduced for peer
applications where a complete initial handshake
has already been performed. The default is
30000 seconds (8 hours)
Domino SSL Setup
Now you can set up SSL on the Domino server just as you normally would following the instructions in the Domino
Help database. There is nothing specific to System SSL that you need to do. Once you set up SSL on Domino, you
should have a Domino key file and stash file.
Note The Domino key and stash SSL files, used by protocols other than HTTP, are different from the i5/OS system key
files used in the example above. Whenever Domino asks for a key file or stash file name, always provide the Domino
key or stash file names.
Additional Notes
�
The System SSL API does not support the thread pool model. System SSL can only be enabled for HTTP.
Therefore, all other Internet protocols (such as POP3, IMAP) will use the software SSL library, SSLPlus, as
they always have.
�
The System SSL API has limited CRL support. Domino has it’s own CRL storage process, and since System
SSL only supports Tivoli PKI Trust Authority, CRLs cannot be used at this time.
�
System SSL and SSLPlus only support SSL V3. SSLPlus (the current SSL package) only supports V2 on z/OS
for Domino 7. Likewise, System SSL only uses the SSL V3 protocol.
74
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino for i5/OS
Java JVM property settings on a per Domino server basis
A new property in the Notes.INI file can be used to specify JVM Properties for the Domino server. This new property,
JavaUserOptionsFile, specifies a text file which contains the properties to add to the JVM. This text file can be either
ASCII or EBCDIC and have up to 256 properties specified. Each entry must be in the form of "property=value" and be
on a separate line.
Any property that can be set with the -D Java option is valid. Domino already provides a way of adjusting the stack
sizes, etc.
If Domino specifies a property, and that property is also specified in the JavaUserOptionsFile, the JavaUserOptionsFile
value is used. For example, if Domino specifies the property "Foo=1", and the JavaUserOptionsFile specifies "Foo=2",
the JVM is created with "Foo=2".
Note There are currently 2 exceptions to this: java.class.path and java.library.path. Domino will link the values
specified in the JavaUserOptionsFile to what Domino is already setting for these two properties.
Multiple Domino servers can share the same options file.
One use of this feature is easier enablement of Java applications that have native methods. In order for the
System.load() or System.loadLibrary() to find the service program, that service program must be in the current path.
In this case, the administrator would have to know what directories the Domino for iSeries code uses. With this
change, the administrator can set the JavaUserOptionsFile in the NOTES.INI and in the referenced file specify
"java.library.path=/QSYS.LIB/PGMAPP.LIB" where PGMAPP.LIB is the library containing the service program loaded
by the java application.
For example:
In the server's NOTES.INI the following line is added:
JavaUserOptionsFile=/PGMApp/JvmOptions.properties The file "/PGMApp/JvmOptions.properties" could have the following:
java.library.path=/QSYS.LIB/PGMAPP.LIB java.class.path=/PGMApp/bin/PGMApp.jar PGMApp.debug=0 PGMApp.serverName=Server1
Notes Client
Notes' Sametime client identifier has been updated
When the Notes client logs into a Sametime server it sends an ID value that identifies the client type. As of the current
milestone build, the identifier that the Notes client sends has been updated from 0x1200 to 0x1210. This will allow
Sametime administrators to more accurately track client usage and to enable/disable various clients, if desired.
Domino Administrator Client, Domino Server
Previous Domino Domain Monitor database needs to be deleted
If you already have a Domino Domain Monitor database (DDM.NSF) from a previous Domino 7 beta release, before you
upgrade to Domino 7 (non-beta), delete the beta copy of DDM.NSF and allow the current release of Domino 7 to create
a new Domino Domain Monitor database on all of your servers. You should also delete all Probe configuration
documents before you upgrade from a beta release of Domino 7.
75
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Administrator Client, Domino Server
Rooms & Resource databases require Administrator configuration
With the new Rooms & Resources Manager (RnRMgr) and the Rooms & Resource system design for Domino 7, it is
now possible to have replicas of a Rooms & Resource (R&R) database on multiple servers. In order for R&R requests
to be properly processed in a clustered environment, the Administrator must update the R&R database to indicate to
the template the "Home Server" for that database. This is done by using the Administration Server setting for the
database.
After creation, or after upgrading a pre-existing R&R database to use the Domino 7 template, the Administrator must
set the Administration Server setting for the database to be the server where all administrative actions are to be
performed. This includes defining new Sites, new rooms or resources or renaming a room or resource. Without this
setting, the Administrator will be prohibited from performing R&R administration in the database that could cause
RnRMgr or the background Agents to have processing problems later on.
To set the Administration server, this the Administrator simply opens the database using the Notes client and selects File / Database / Access Control from the menus. Then select the Advanced tab on the dialog that appears. The first item on that tab is Administration server. Simply set that to the name of the server where the database exists and click OK.
Domino for i5/OS
Setup Wizard supports selection of server release to configure
The Domino Server Setup Wizard now detects if you have multiple versions of Domino installed on your system, and
will prompt you to select which release of the server to configure.
Domino Server, Domino for z/OS
z/OS Configuration Settings
Most install problems can be fixed by verifying that the recommended values in the Domino 7 for z/OS Install Guide are being used and that you have all of the required service applied. Run the latest version of the PTF Checker tool from the WEB. You should check the WEB page often for updates. The values specified in the Install Guide must be set before setting up the Domino server. Some changes may not become effective until an IPL is done. Read the appropriate z/OS publication to verify which parameters require an IPL. The following is a list of the most common install problem areas:
Problem areas
�
IEASYSxx. For optimal Domino performance it is extremely important that ESQA and ECSA settings be kept to a
minimum. Keeping ESQA and ECSA to a minimum will provide maximum virtual addresses in all Domino address
spaces. A good general starting point for Domino is to set both ECSA and ESQA to 65 MB and no larger than
100MB.
For each server with a different progrma directory, plan for an additional 10 megabytes of ESQA. Both Domino
memory mapped files and user shared library (SHRLIBMAXPAGES) consume ESQA storage.
We recommend you monitor the ECSA and ESQA size before and after you have installed the latest level of the
Domino code for any additional tuning. Based on your own configuration, you will probably have to tune this
value for your own environment. As with all other applications that run on z/OS, you should monitor your CSA,
ECSA, SQA, and ESQA usage on a regular basis. You can do this by reviewing your RMF reports.
See the z/OS MVS Initialization and Tuning Reference, SA22-7592, for additional information on the CSA and SQA
parameters in your SYS1.PARMLIB IEASYS member.
76
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
�
�
Chapter 2 - Installation, migration, upgrade, and configuration information
BPXPRMxx values. BPXPRMxx values must be set exactly as specified in the Domino 7 for z/OS Install Guideunless
a formula is given. These values must be set before setting up the Domino server.
If you use the SETOMVS command to set parameters, they only remain at that value until the next IPL. To set a
parameter permanently, update the
BPXPRMxx member used during IPL, or have the SET command run after
each IPL. This can be done by putting it in as a command in COMMNDxx PARMLIB member. Some changes may
not become effective until an IPL is done. Read the appropriate z/OS publication to verify which parameters
require an IPL.
To verify you have the correct settings, Issue the following UNIX System Services command to verify BPXPRMxx
values:
dom_verify_os
To display the current BPXPARM settings and high water mark usage issue the following commands:
D OMVS,O
D OMVS,LIMITS
�
�
COMMNDxx
Ensure you have the following command in your parmlib member and is set prior to running the Server
COM='SETPROG LPA,ADD,DSNAME=high-level-qualifier.SCEERUN2,MODNAME=CELHV003'
�
If you are unable to run the dom_verify_os or Domino Server Setup, verify the following:
Ensure high-level-qualifier.SCEERUN2 is cataloged and available on your driving System.
Ensure high-level-qualifier.SCEERUN2 is in your PROGxx or LNKLSTxx concatenation
Verify successful execution of the following command:
SETPROG LPA,ADD,DSN=high-level-qualifier.SCEERUN2,MOD=CELHV003'
�
�
The install process requires your Language to be set to C.
The install should be run with the system Language set to use the default C language. If it is not, unpredictable
results may occur.
To verify the Language, issue the following: echo $LANG
The response should be: C
If the value is not C, remember the value displayed and change the language by issuing the following: export
LANG=C.
Prior to starting the server, set the LANG variable back to its original value by issuing the following:
export LANG=<original value>
�
�
Auxilliary Storage and Shared Library Support
If running out of auxilliary storage or experiencing a negative performance change after installing a new libnotes
DLL or a new Domino server program directory, then you should check both the libnotes DLL extended
attributes and SYS1.PARMLIB(BPXPARMxx) SHRLIBRGNSIZE value.
Each additional server program directory requires that the SHRLIBRGNSIZE value be increased. See the
Domino 6.5.2 for z/OS Install Guide.
77
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
To verify the libnotes extended attribute for system shared library is set, issue the following command:
ls -E libnotes
You will see the following display:
-rwxr-xr-x
Note that
--sl
1 INSTALL NOTES
50556928 Sep
20 23:12 libnotes
l in --sl above indicates that the shared library extended attribute is on.
If the shared library extended attribute is not on for libnotes, you will need to turn it on with a userid authorized
to the BPX.FILEATTR.SHARELIB RACF Facility Class. Use the following command to turn on the system shared
library extended attribute (note that +l is lower case L):
extattr
+l
libnotes
Domino Server, Domino for z/OS
z/OS IEFUSI User Exit
If you are currently using an IEFUSI user exit, you must review APAR OW38477 and review the z/OS Unix System
Services Planning manual (GA22-7800) for IEFUSI considerations.
Security
Domino Administrator Client, Notes Client
Rename of user through User Security panel, via mail
Users who request a rename through the User Security panel via mail should make sure that the administrator uses
adminp to process the request. If the administrator does not, and the user is a roaming user, the roaming users' files
will not be able to replicate back to the server after accepting the name change. Thus any changes incurred locally
will not be pushed and pulled to other machines the user roams to/from.
If the administrator does not use the adminp process, then they should update the ACLs on the roaming users' files as
well as the users' mail file to avoid this situation.
Domino Administrator Client, Notes Client
Users should locally encrypt databases on multi-user machine
We advise users on a multi-user machine to locally encrypt databases for added security.
Domino Web Access
Domino Web Access
Domino Web Access in Portal Views
To reduce the space occupied at the top of the portal views, the branding has been removed. The date navigator has
been moved to the collapsible left panel area. The Trash can has also been removed from the left panel area to
conserve space.
Also in portal views, for the "About Domino Web Access" information, open the Preferences and click the About button.
Domino Web Access
Sametime Integration does not work with JRE 1.4.1_05
Sametime integration with Domino Web Access does not work with JRE 1.4.1_05.
78
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 2 - Installation, migration, upgrade, and configuration information
Domino Web Access
Using Lotus Instant Messaging and Web Conferencing with UNIX
After you have replicated stauths.nsf from your IBM Lotus Instant Messaging and Web Conferencing server to your
Domino server, open the Replication Settings dialog box for the database, click Other, and check the "Temporarily
disable replication for this replica" box. This will prevent another version of the database from a Windows system from
overwriting your name change for the UNIX server.
Uninstallation information
Domino Server
Uninstall 7.0 server before downgrading to pre-7.0 builds
After installing 7.0 server or later builds, if you plan to downgrade to a pre-7.0 build you must uninstall the server
before re-installing the older build to that same location.
79
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Chapter 3 - Known limitations, problems, and workarounds
Limitations
Applet issues
Domino Administrator Client, Domino Server
Java Debugger can't attach to JVM for "Preview . . ." applets
There is an issue using the Java Debugger that you cannot attach to the JVM for a Java applet that is running via
"Preview in Web Browser".
Calendar and scheduling issues
Notes Client
'Print calendar to a document' causes different line indenting
When using the "Print calendar to a document" option, due to differences in monitor and printer resolutions, the first
line indentation of a Subject will be offset from the rest of the calendar notice information.
When using the "weekly style" calendar option, the second and subsequent lines of data will be displayed to the left
side of the entry. A workaround for this situation is to print the calendar to a document, and use the "calendar list" calendar style to set the correct date range to receive the same weekly data as using the weekly style. The steps to
accomplish this are below:
1.
2.
3.
4.
5.
Select File -> Print
Under 'What to Print' select "Print calendar to a document"
Under Calendar style select "Calendar List"
Under Print Range select the correct from and to dates that correspond to your week.
Choose Preview button
This will give you the same data as choosing the Weekly list calendar option.
Notes Client
'Propose New Time' feature not working between Outlook and Notes
The "Propose New Time" feature does not function properly on iCalendar between Notes and non-Notes application
such as Microsoft Outlook (XP and 2003). When sending meeting invitations to non-Notes application Invitees, Notes
users are adviced to enable "Prevent Counter" or "Prevent Delegation" to avoid breaking workflow between the two
clients.
81
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client
Calendar cleanup will crash with some types of archive policies
If you are using archive policies in the current release, do not use the Tools -> Calendar Cleanup action before you've
read and understood this release note.
In mail files for which an archive policy is in place, if that policy includes enabled criteria, the client may crash on
attempt to perform a Tools -> Calendar Cleanup. Additionally, it is possible to crash the server on which the mailfile
is located.
Note that Calendar Cleanup will not crash in a mail file that uses local archive criteria -- the problem only occurs with
criteria that come from an archive policy. Archive policies that don't include enabled criteria -- e.g., an archive policy
that sets the new maximum retention limit -- will not interfere with calendar cleanup.
Notes Client
Filtered Private entries
Private entries do not appear in the Calendar View for Calendar Managers/Mail Delegation users if the View is Filtered
by any option, and the filtered results contain entries that have been marked private.
Notes Client
Icons for Recipient in the To/cc: field are on Delegated Meeting
There are several issues with Delegated Meetings in regards to the Icons for Recipients in the "To/cc:" field. It is
possible to receive a half-solid circle on the delegated meeting when it should display a solid circle. Also, the
delegatee's name does not appear in the "To" field by design, so this may be changed to not include delegated
meetings at all.
Notes Client
Icons for Recipient in the To/cc: field are on responses
When a response comes back to the meeting Chair from the Invitee on a Meeting/To Do, the Invitee is in the "To" field
so there should not be an icon; the Chair's name is in the Chair field.
Notes Client
IPv6: Meeting Threads not showing name by design
If the client is set to use the IPv6 protocol, the new Meeting Threads view does not show the name of the invitee on the
responded notice, by design.
Notes Client
Managed Client opens C&S entry in Workplace preview window
When using the IBM Workplace Managed Client, and you have Lotus Notes installed with the Calendaring and
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.
Notes Client
Repeating meetings not automatically accepted on Domino 6 router
If a user is on a Domino 6 server, but has a Notes 7 client and template, the new option "Automatically accept even if
time is not available" will not work correctly; it will, more than likely, decline the repeating meeting. This is a case of
forward incompatibility and is not recommended. Users must be on an Domino 7 router (server) in order for this
feature to work correctly.
82
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client
Using Go To options shows the Meetings tabs when it should not
When a User opens their mailfile and then their Inbox, the User can then select View/Go To . . . options. If the User
selects any of the new Meetings View or All Calendar Entries Views (i.e., Calendar Entries By Start Date, Accepted
Meetings, Calendar Entries By Category, Calendar Entries By Entry Type, Calendar Entries By Start Month, Calendar
Entries By Status), the tabs to the views do not display and should not display. The problem is that, when the user
closes this view and then reopens any other view (Inbox, Drafts, Sent, etc.), the tabs will display and should not.
Notes Client
Workplace not restored when opening C&S notice from Alarm dialog
When using IBM Workplace and the Notes client with Calendaring/Scheduling Alarms enabled, the IBM Workplace
application is not restored from the minimize state when you receive an Alarm dialog and attempt to open the
calendar entry from the dialog.
Client issues
Domino Administrator Client, Notes Client, Domino Designer
Client Reconfiguration Wizard and location document
As noted in the on-line documentation, it is important to switch to the correct location document before using the
Client Reconfiguration Wizard to configure a new connection, internet account, proxy server, or replication schedule.
The Wizard applies new settings/changes to the current location document only.
Notes Client
Database open fails if query view is set to default
When "Default when database is first opened" is set for query view, attempting to open the local copy of the database
fails.
Notes Client
Limitations using Sametime Server with IMLU
If your Sametime Server is running the IBM Lotus Instant Messaging Limited Use (IMLU) configuration, you are
restricted to Instant Messaging capabilities only. The Instant Messaging Web Conferencing options are invalid. You
will experience these limitations:
1. If you attempt to create any of the Instant Meetings options (audio, video, shared and or collaboration) within
Notes, the following error message displays :
83
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
2. Since Web Conferencing is not enabled on your Sametime server, when an invitation to a Sametime meeting is sent
to you*, you will not be able to join. Instead, you should choose the Respond button from the dialog box and notify
the Initiator that you don't have the Web Conferencing capabilities.
* A person connected to a fully enabled Web Conferencing Sametime Server has the ability to include you on their
Sametime meeting invitation.
Domino Administrator Client, Notes Client
Limitations with Mozilla
When using webadmin.nsf with Mozilla 1.7.3 (open as http://yourserver.com/webadmin.nsf), due to a third-party
software limitation with Mozilla, all "Close" buttons in many documents don't work at all.
Notes Client, Domino Web Access
New Autoprocess feature not in Webmail for current release
The new Autoprocess feature: "Automatically accept even if time is not available" is not included in Webmail for the
current release of Notes and Domino 7.
Notes Client, Domino Designer
QV fails to return expected error in pre-r7 or non-DB2 server
There is a case that the expected error message fails to be returned when query view is opened in older version of
Notes client or non-DB2 server.
1. Database is on DB2-enabled server
2. Query view shows only selected docs, e.g."Select * from db.dav where field='value'". Also view selection formula
shows a different set of docs - I used default "Select @All"
3. Using older version of client, a copy or replica of the database is created on a non-DB2 enabled N/D 7 server.
4. Query view is opened in older version of client
Instead of returning the error message, the query view is opened in older version of Notes. The query does not
execute, instead the view shows docs based on the view selection formula. Same problem occurs if the db is copied
locally and opened with older version of client.
Notes Client
Sametime Meetings require Internet Explorer or Netscape (< 6)
Sametime Instant Meetings that use the audio, video, screen sharing, or whiteboard functionality require the system
default browser to be Microsoft Internet Explorer or Netscape (a version less than 6).
84
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
DB2 issues
Notes Client
Archive and calendar cleanup can't be used on DB2-enabled mail
This issue is related to the "Compact -a and -A will not work on DB2 enabled servers" document in these release notes.
Please note that archiving and calendar cleanup use compact. Neither will work on DB2-enabled Domino servers, and
servers may crash when compact is called through an archiving or calendar cleanup function.
Domino Administrator Client, Domino Server
Domino and DB2: Compact -B delays Domino server shutdown
When Compact -B is used in a Domino and DB2 environment, DB2 begins reorganizing tables while attempting to
reduce tablespace size. This can prevent the Domino server from shutting down cleanly. The Domino server does not
shut down while a DB2 table reorganization is running.
Domino Administrator Client, Domino Server
LNDFR.NSF not supported as DB2-enabled Notes database
The Domino Administrator 7 documentation contains the topic "Databases not supported as DB2 enabled Notes
databases." The Fault Reports database, LNDFR.NSF, is not supported as a DB2 enabled Notes database and is
created as a Notes database (NSF) on DB2 enabled Domino servers. The Fault Reports database should be added to
the second table in the topic.
Database
Usage
Description
From template
LNDFR.NSF
Domino server and clients
The Lotus Notes/Domino
Fault Reports database
stores data that is
collected at the time of a
server crash. Data is
collected from both the
client and the server and
can then be used to
measure client reliability
and determine the areas
where problems exist.
Created by default at first
server setup in the
domain. Subsequent Fault
Report databases can be
created using the Open
Fault Reports Tool in the
Domino Administrator. The
template is LNDFR.NTF.
Domino Administrator Client, Domino Server
Query views cannot be used with Depositor-level access
Users with Depositor access to a DB2-enabled Notes database cannot see any records (including Notes records and
federated data records) in a query view, even though they can see the same Notes records in other Notes views. This is
because query views always perform full rebuilds when the view is opened, and Depositors do not have permission to
perform this action.
Domino Designer
Refreshing a query view in Designer doesn't show correct data
After customizing a query view in Designer, if you hit 'F9', or click on the Refresh icon, you will see incorrect or,
sometimes, no data.
85
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Designer issues
Domino Designer
@DB2Schema syntax not working
In the current release, the following DB2Schema sytnax does not work correctly:
@DB2Schema("";@ReplicaID)
@DB2Schema("":"nsfname")
You can, however, use the following syntax:
@DB2Schema("Server"; @Replica)
@DB2Schema(@DBName)
Directory issues
Domino Server
LDAP Domino Upgrade Service group migration limited to 500
Group entries in the LDAP Domino Upgrade Service are created when you select a group to migrate. Based on the
options that you choose in the Group object classes section of the Advanced LDAP Migration Options dialog box, the
members contained in those groups may also be migrated. Currently, the limit of group members that will be
migrated into a Domino Directory for each group is 500.
Refer to the "Migrating Group Entries" chapter in the 'Mail and Directory Migration' section of the Lotus Domino
Administrator 6 Help documentation for more information on how to create new group object classes, and to add
member attributes.
Domino Administrator Client, Domino Server
LDAP Domino Upgrade Service group migration limited to 500
Group entries in the LDAP Domino Upgrade Service are created when you select a group to migrate. Based on the
options that you choose in the Group object classes section of the Advanced LDAP Migration Options dialog box, the
members contained in those groups may also be migrated. Currently, the limit of group members that will be
migrated into a Domino Directory for each group is 500.
Refer to the "Migrating Group Entries" chapter in the 'Mail and Directory Migration' section of the Lotus Domino
Administrator 6 Help documentation for more information on how to create new group object classes, and to add
member attributes.
Domino Server
LDAP will not honor abandon operations over SSL connections
The LDAP server will ignore abandon requests sent over SSL connections. LDAP will detect and honor the loss of the
connection, which may be used as a workaround to terminate long-running search requests over SSL.
Domino Administrator Client, Domino Server
LDAP will not honor abandon operations over SSL connections
The LDAP server will ignore abandon requests sent over SSL connections. LDAP will detect and honor the loss of the
connection, which may be used as a workaround to terminate long-running search requests over SSL.
86
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server
IPv6 addresses in Directory Assistance
IPv6 addresses should not be configured in Directory Assistance unless all servers that are configured for DA are
Domino 7.0, with the required IPv6 network support.
For more information about using IPv6 addresses in Directory Assistance, see the topic "Creating a Directory
Assistance document for a remote LDAP directory" in the Domino 7 Administration Help.
DOLS issues
Notes Client, Domino Offline Services (DOLS)
Dircat not being deleted when shared subscription is deleted
When a subscription containing shared subscription data and a directory catalog is deleted, the catalog remains in
the user's Domino Web Access directory. This is true even if the shared data is not actually being shared by another
subscription.
The dircat will not delete if it has been accessed offline in the current Domino Web Access session, even if you close
the browser before deleting the subscription. Attempts to delete the dircat manually (in this state) from the user
directory in Windows Explorer, yield a "Sharing Violation."
There is currently no workaround.
Notes Client, Domino Offline Services (DOLS)
Win2K - Sync Details box opens behind Sync Manager
On Windows 2000 Professional operating systems the Sync Details dialog opens behind the Sync Manager.
Domino Web Access
DOLS does not support hyperthreading
DOLS does not support the BIOS setting of hyperthreading.
Domino Web Access, Domino Offline Services (DOLS)
DOLS does not support Simplified Chinese GB18030 Unicode
DOLS does not support Simplified Chinese GB18030 Unicode. Subscriptions using these characters will not install
properly.
87
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Access for MS Outlook issues
Domino Access for Outlook
Domino Access for Microsoft Outlook issues
The following is a list of differences between the Notes client and the Microsoft Outlook client, as well as known
limitations and problems.
Differences between Notes client and Microsoft Outlook client
�
Outlook's "Active Appointments" view does not accurately reflect the number of occurrences in a recurring
meeting; however, the calendar accurately reflects the meetings.
�
If a Notes invitee requests information in response to a meeting invitation, the Outlook chair will receive an
email with their comments.
�
Embedded messages can be read only by Outlook recipients. Use Forward or Reply to send existing message
content to all users.
�
Outlook does not support the creation of a new line in the Subject and Location fields on Calendar items.
New lines entered in Notes in the Subject or Location field are converted to a semicolon (;) followed by a
space in Outlook. Domino Access for Microsoft Outlook users can enter a semicolon and space so that a new
line is added in Notes.
�
Meeting updates to recurring meetings (not reschedules) are sent as individual items, if a change is made to
the series a number of updates will be sent. It is recommended that changes are made to single instances to
avoid multiple updates being sent.
�
Domino does not support recurring daily meetings every weekday. Instead, use the option to select the days
of the week.
�
In Outlook, there is no new mail notification on start up, even when there are unread messages in the Inbox.
New mail notification does not occur until a new message arrives.
Address Book
Distribution lists created in Notes that contain other distribution lists (nested distribution lists) cannot be resolved
within Outlook. Nested distribution lists created in Notes are resolved in the Domino server and can be used to send
messages. Nested distribution lists created in the Outlook Contact folders are resolved within Outlook and can be
used to deliver messages.
Group To Dos/Tasks
�
In Outlook, when forwarding a task that includes an attachment to another Outlook user, the attachment is
not forwarded.
Mail
Sending e-mail
�
To ensure full directory access, all directories you want to select must reside in your domain. This release
does not provide access to directories that require additional certificates to access, such as directories in
different domains. If you cannot access a directory, talk to your administrator.
�
It is recommended that complex documents be placed as attachments in e-mail. Microsoft Word is supported as the primary editor and is recommended where available.
�
The preferred format for e-mail should be set to Rich Text format in Outlook for best results.
�
Table formatting in some cases may be lost when sending from Outlook; use attachments for complex documents.
�
Messages removed from Domino Access for Microsoft Outlook using "shift-delete" are not removed from the
server replica. Users should simply delete messages and empty them from their "Deleted Items" folder to
ensure proper synchronization of deletes from Domino Access for Microsoft Outlook.
�
Mail notification of briefly changing the mouse cursor does not work in this release.
88
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Outlook features not supported
�
Most of Outlook's publishing and authoring components, such as footnotes, bookmarks, captions, cross
references, page column formatting, edit change, and revision marks and tracking.
�
In Outlook 2002, sending e-mail that has an assigned category is not supported by Domino;
�
Follow Up flags are not sent to e-mail recipients if mail is in html format.
�
Pictures other than clip art and images from files. Charts, diagrams, and embedded objects. Use attachments for these objects. �
In some cases, active URLs in Notes do not replicate as active links in Outlook.
�
Once a message has been sent, Domino does not support the ability to expire or retract the message.
�
The tracking option "Process receipts on arrival" is not supported in Domino.
�
Outlook Rules that are applied to new items currently work only with the "Run Now" option, not as items are
added to the Inbox.
Other
�
There is currently no way to represent LotusScript buttons with Outlook.
Calendar & Scheduling
Recurring meetings
�
Deleting recurring meetings, may result in some occurrences remaining on the Calendar.
�
In Notes, you can create a monthly meeting that happens on the first Tuesday and third Thursday of each
month. However Outlook does not support this as a repeat. These meetings will be distributed to multiple
dates when replicated to Outlook.
�
Recurring meetings that are subsequently changed to be "Private" cannot be accepted by the invitee. This can
be resolved by changing the end time by 1 minute and then setting the "Private" option.
�
If there is a mixture of acceptances and declines, the accept/decline status of invitees and rooms for specific
instances of recurring meetings may be incorrect. The original accept/decline notices for the users received
by the chair are correct.
�
In some cases, invitees added to recurring meetings, where a number of updates are applied, may receive a
"Request Out of Date" message when processing updates. It is recommended that the user verify that the
changes have been applied to the existing calendar entry, as in some cases they may not be.
Autoprocessing
�
When using "Autoprocess," the Chair does not receive an acceptance notice from the invitee, but the meeting
is added to the invitee's calendar.
�
On the Autoprocess tab, if you enable automatic responses to meeting invitations from specified users, you
have the option of choosing a name from the address book. however, you must remove the "@<domain>"
portion of the address for this feature to work.
Outlook features not supported
�
The fields "Show Time As" and "Categories" are not sent to invitees.
�
When you create a meeting invitation and save it as draft in Notes/Domino, the addresses are not available
when viewed in Outlook.
�
If you set an alarm for a specific meeting in Notes, the alarm is not set in Outlook for the same entry.
�
If a meeting invitation created in Notes is delegated to an Outlook user, the Outlook user cannot take action
on the meeting. However, the meeting may be added to the delegate's calendar.
�
The Outlook XP feature creating "Group Schedules" does not operate correctly. It will not save the members of
the group when initially created; subsequent edits will be saved and operate correctly.
�
The "cc" field is not supported when sending a response to meeting requests, add any additional recipients to
the "From" field.
�
The Notes/Domino invitee cannot delegate meetings created with an Outlook chair in this release.
�
Comments sent by a Notes/Domino Chair or Notes/Domino delegator are not supported when sent to Outlook Chair.
89
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Other
�
Chapter 3 - Known limitations, problems, and workarounds
Occasionally when accepting/declining multiple updates for a meeting, Outlook may report the error "The
messaging Interface has reported an unknown error. If problem persists restart Outlook." Close the entry, and
reopen it and accept/decline again. The error should not reappear.
�
Addresses selected from the personal contacts and LDAP directories will not show the tracking status of
attendees, when creating meeting invitations. They will correctly receive the meeting invitations, and updates
and responses will be received.
�
If a delegate tries to change the date in an appointment, reminder or all day event that was created by the
owner of the mail file, the delegate will get a message that the entry has been changed by another user. The
delegate will be prompted "Do you want to make a copy in the default folder for the item?" Workaround:
Delegate should click yes, and then close the calendar entry. Reopen the calendar and make the necessary
changes.
Rich Text Formatting
Some of the rich text formatting (RTF) available in Outlook is not supported in Domino and will be lost or replaced by
similar formatting supported in Domino.
General
The following general areas of Outlook formatting are not supported:
�
Publishing and authoring features -- This includes manuscript revision marks and edit change tracking and
annotations, footnotes, captions, page headers and footers, bookmarks, indexes and tables of contents, and
cross references. It also includes creating columns and sections, and using "drop cap" paragraph
formatting.
�
Drawing and artwork features -- This includes creating new a drawing in the document, autoshapes, word-art,
charts, and diagrams. Note: Clip art and images inserted from files are supported.
�
Special text fields and form fields --This includes inserting auto text, text fields, and form fields. Examples
are current date or time, author name, creation date, calculated fields (such as sales tax), text boxes,
checkboxes, and dropdown fields.
�
Frames and sections, document variables, master documents, and subdocuments.
Text and Paragraphs
The following text or paragraph formatting are not supported:
�
Multi-level bullet and numbered lists -- only single-level lists are supported. Note: Supported list types are
solid circle bullet, decimal numbering, lower- and uppercase alpha, and lower- and uppercase Roman
numbering.
�
Shading and borders for text, shading for paragraphs, positioned paragraphs, automatic hyphenation and
paragraph styles.
�
Combining shadow, emboss or engrave formatting with superscript or subscript -- if more than one is specified, superscript or subscript take precedence.
�
Underline styles -- only the solid underlining style is supported; all other styles will be converted to solid.
�
Special tab alignment -- only left aligned tabs with no leader are supported.
Tables
In the following cases, Domino will convert table formatting to a style that is supported:
�
Tables created using "AutoFit to contents" tables and the "Fit text" to cell feature.
�
Varying column widths between rows; varying the number of cells between rows.
�
Varying text alignment and inner margins between cells -- all cells will have the same values. In a cell, the top
and bottom margins will always be equal and the same is true for left and right margins.
�
Varying cell border style and color between cells -- all cells will have the same cell border style and color, and
the table's outer border will be of a single style and color.
�
Shading -- only solid style of cell and table fill (shading) is supported -- Other styles (such as hash marks) are
converted to solid.
�
Table and cell border styles -- Domino supports eight styles; all others will be converted to the closest match.
�
The merge cells feature.
�
Number of columns and levels of nested tables are limited to 63 and 7, respectively.
90
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Formatting not Supported in Outlook
If you use both Notes and Domino Access for Microsoft Outlook, some formatting created in Notes is not supported in
Outlook. This formatting will either be lost in the conversion or will be replaced by something similar.
General
�
Drop-shadow borders on tables and pictures
�
Tables
�
Some list styles, such as circle, square and checkmark
Fit to Window style tables.
�
Cell image and gradient fill (shading).
�
Mixture of fixed and variable cell widths in a table.
�
Tabbed, captioned, and animated tables. These will be converted to normal tables in Outlook.
For migration issues, see the release note "Exchange to Domino Migration Issues."
Domino Access for Outlook
Use Domino Access for Microsoft Outlook 6.5.4
Due to an intermittent problem with Domino Access for Microsoft Outlook 7, it is recommended that you deploy the
6.5.4 version that is available on the Web at www.lotus.com/ldd.
Domino Domain Monitoring issues
Domino for i5/OS
DDM memory probe on i5/OS reports 2x usage for Java agent
Due to platform differences, a Java agent on i5/OS will be reported as using about 2x the CPU as on other platforms.
Domino Administrator Client, Notes Client
General Domino Domain Monitoring (DDM) information
Following is general information regarding the new Domino Domain Monitoring (DDM) feature:
�
DDM is an IBM Lotus Notes and Domino 7 feature only. Prior releases of Notes/Domino do not support DDM
functionality. All DDM Probe, Filter, and Server Collection Hierarchy configuration should be performed using a
Notes 7 Client and use of the Domino Domain Monitor database is only supported using a Notes 7 Client.
�
The Domino Domain Monitor database (ddm.nsf) is not supported for use via browsers for the Notes/Domino 7
release. This database must be viewed & used via the Notes Client, Domino Administrator Client, or Domino
Designer Client.
�
If upgrading from an earlier beta release of Domino 7, here is the recommended procedure for updating DDM
Configuration in your domain:
�
before upgrading your domain, it is very important to delete all existing DDM Probe documents, DDM Filter
documents, and Server Collection Hierarchies in the Monitoring Configuration database. These documents
are highly likely to be stale and could result in DDM functionality problems in your domain. Allow time for
the deletion of these documents to replicate throughout your domain before proceeding.
�
when upgrading servers to Domino 7, be sure to delete the Domino Domain Monitor database (ddm.nsf) on
all servers. This database will be automatically re-created upon launching each Domino 7 server.
�
replace design of both the Monitoring Configuration (events4.nsf) and Domino Domain Monitor (ddm.nsf)
databases, so that they include the most current template code
�
create/configure new DDM Probe documents, DDM Filter documents, and Server Collection Hierarchies in
the Monitoring Configuration database
�
the Domino Domain Monitoring database will quickly populate with results, based on your newly created
configuration
91
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Server, Domino for z/OS
z/OS DDM Limitations
Following are the limitations using the DDM feature on Domino for z/OS:
�
The Network and Disk Utilization DDM probes are currently not supported on z/OS.
Domino Web Access issues
Domino Web Access
Attachment icon does not display with S/MIME encryption
If an S/MIME encrypted message includes an attachment, the attachment icon does not display in the user's Inbox.
Domino Web Access
Cannot change Internet password when authenticating via LDAP
Domino Web Access users who authenticate using an LDAP server cannot change their Internet password using Domino Web Access Security preferences.
Domino Web Access
Cannot clear browser history from the logout screen
In Microsoft Internet Explorer, the browser history is not deleted even though you check "Clear History" when logging out of Domino Web Access using the "Logout" or "Logout for Shared PCs or Kiosk Users" options on the logout screen.
Domino Web Access
Don't use Adobe Distiller to create PDF files
Do not use Adobe Distiller to generate a PDF file from a DWA document. If you do, the file includes garbage characters that are not visible in the paper output, which may cause the printed documents to be unusually large.
Domino Web Access
In clusters, replicator deletes message when it is sent to self
If you send a message from a replica of your mail database (not on your home mail server), and you have set a
preference to save a copy of sent messages in your Sent view, the Replicator deletes one copy of the message. It does
not save one copy in your Sent view and one in your Inbox. Instead, only one message is saved and it appears in both
your Inbox and your Sent folder. The one message has the characteristics of a saved copy (in your Sent view). For
example, the message does not have a delivered date and does not display a yellow envelope icon in the mail file
views.
Domino Web Access
In Mozilla browsers, spellcheck does not check Subject line
In Mozilla browsers only, the spellcheck program does not check the spelling of words entered in the Subject line.
Domino Web Access
Interoperability issue with delegates
If a meeting is scheduled by a Chair using an iNotes5 server, delegates who are using iNotes6 or DWA7 will receive a warning when responding to an invitation.
92
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Web Access
Mail rule that filters by high delivery priority may not work
If you have a mail rule that includes the condition of a high delivery priority, you should be aware of these issues:
�
In Domino Web Access, a mail rule that filters mail with a high delivery priority does not correctly filter
messages sent from a Notes client.
�
In Domino Web Access, when creating a mail rule that includes Delivery priority or Importance, use the IS
operator instead of CONTAINS.
Domino Web Access
Offline not available on Linux Mozilla
For the current release of Domino Web Access 7.0, users cannot go offline when using a Linux Mozilla client with a
non-Windows OS server, for example, UNIX, Linux Mozilla, AIX, Solaris.
Domino Web Access
Secure mail issue with offline subscriptions on same system
Two users who have offline subscriptions installed on the same system cannot send encrypted mail to each other while
offline. Also, signed mail sent between the two users while offline may contain an S/MIME signature, when it should
contain a Notes signature.
Domino Web Access
Update calendar notice not generated for repeat meetings
In the following instances, when you open an update notice to a repeat meeting that you have accepted, no reminder
displays informing you to update your calendar:
�
�
�
Meeting cancellation
Meeting reschedule
You are removed from an instance of the repeat meeting
Domino Web Access
Upload control does not load
On a Windows NT system running Internet Explorer 6.0, you cannot download the Domino Web Access 7 Control
(DWA7.CAB) file because the shell32.dll file needs to be updated.
Workaround
Users can obtain a newer version of shell32.dll from:
http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=6AE02498-07E9-48F1-A5D6-DBFA18D
37E0F
Installation issues
Domino Server
Blank service description issue on Windows 2003
If you install the Domino server on Windows 2003 as a service, the service description section in the Windows service
control is blank. This is not an issue on Windows 2000; it has a brief description of "Allows Domino to run as a
service".
93
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Notes Client, Domino Designer
Multiple User Client Installation information
Following are key points about Multiple User Client installations:
�
A Multiple User Install must be performed by someone with Administrative rights to the machine.
�
When installing a Multiple User Install, you will need to launch Notes Minder from the program directory. The
shortcut for Notes Minder that appears in the Start Menu currently isn't working.
�
You can now upgrade an existing 4.x and 5.x Single Client Notes install to a Multiple User install if you have
Administrative rights to the machine. Be aware that this just preserves and renames the Notes.INI, and leaves
behind your old data directory. You will need to run through setup again and manually move any old data you
wish to reuse. For an existing Lotus Notes 7 Client, you can also perform this procedure for Windows XP and
Windows 2000 platforms only.
�
The Multiple User Installation option applies only to the Notes Client and is therefore only found in the Notes kit.
The Designer and Administrator Clients aren't supported with a Multiple User Install (not even during upgrade
scenarios).
�
Installing a Shared install and selecting a Multiple User Installation through a transform isn't supported. This is
also documented in the Install documentation.
Domino Administrator Client, Notes Client, Domino Designer
Notes Single Logon and Windows Terminal Server/Client
The Notes Client Single Password Logon feature is not currently supported for use with the Windows Terminal Server/Client feature.
Domino Administrator Client, Notes Client, Domino Server
Notes Single logon restrictions
This release note explains the Notes Single Logon restrictions for the following:
�
�
�
Machine name cannot equal OS login name with Notes single logon
Operating system (OS) and Domino password policies
Location of the NOTES.INI file and Notes user ID file
Machine name cannot equal OS login name with Notes single logon
Domino/Notes Client Single Logon feature does not work when the OS login name is identical to the machine name,
and you are logging on using the OS name. If Client Single Logon is not working properly on your system, change your
OS login user name or your machine name.
For information on how to change either name, refer to your Microsoft Windows documentation, or see your Network Administrator.
Note This release note applies to all Domino/Notes releases that support Client Single Logon.
Operating system (OS) and Domino password policies
During OS password changes, the Notes Network Provider must be able to change the Notes ID to the new password provided by the OS. Notes is notified of the new OS password only after the OS password has been changed. If the new OS password does not meet the Notes password quality and history requirements, the Notes password change will fail.
During Notes password changes, the Notes Client must be able to change the OS password to the new Notes password. If the new Notes password does not meet the OS password quality and history requirements, the OS password change will fail.
OS and Domino password policies must be aligned as closely as possible to allow password synchronization to work.
94
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Location of the NOTES.INI file and Notes user ID file
For bidirectional password synchronization, the Notes Network Provider must be able to access a user's NOTES.INI file
and Notes ID file. The table below shows the required location for the NOTES.INI file:
Install Type
Location
Single User
The NOTES.INI file must exist in the Notes directory as specified in the
HKEY_LOCAL_MACHINE registry key.
The NOTES.INI file must be specified in the HKEY_USERS registry key:
("<sid>\SOFTWARE\Lotus\Notes\6.0\NotesIniPath")
Multi-user
Operating system (OS) password changes, that is, password changes that are initiated outside of IBM Lotus Notes,
occur in the system access control environment; therefore, the NOTES.INI file and the Notes ID file must reside on a
local drive.
Domino Administrator Client, Notes Client, Domino Designer
Time Range cannot span midnight for Client Setup
During Notes Client Setup, there is a dialog that allows users to configure a Replication schedule. There is a known
problem when a time range that spans midnight is entered on this dialog. Doing so will result in the time range being
reversed. For example, if the user enters 11:00 PM - 03:00 AM in the Replication schedule dialog during Client
Setup, the time range will be reversed to read 03:00 AM - 11:00 PM.
The user may not notice this time change in the dialog, but it can be easily corrected by opening the local Address
Book, going to the Advanced -> Locations view, and manually editing the time range in the relevant location
document(s).
Domino Administrator Client, Notes Client, Domino Designer
Uninstall Designer/Administrator via Modify leaves icons behind
When modifying an existing install to de-select (i.e., remove) the Designer or Administrator Client, the desktop and
Start Menu icons will remain for the Designer and Administrator Clients. Clicking on these desktop icons will reinstall
the specified Clients.
Simply delete the icons from the desktop and Start Menu if you wish to no longer be able to reinstall the Designer or
Administrator Clients.
Internet issues
Domino Administrator Client, Domino Server
Java Console will not accept IPv6 addresses
The Java console for the Domino 7 server does not support IPv6 addresses, because of the current JVM.
Domino Administrator Client, Notes Client, Domino Designer
Not all mapped network drives appear when browsing
There is an intermittent problem when browsing network drives on some Windows machines through the installer. Not
all mapped drives will appear in the drop down list. To install to a drive that isn't available in the "Look in" drop down
list, simply type the full path in the "folder name" field.
95
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server
On Linux, request log filenames do not link to HTTP thread IDs
If you enable HTTP thread logging on a Domino 7 server, the corresponding request log files are stored in the
\data\IBM_TECHNICAL_SUPPORT directory. On Linux, in the NSF log file of a crashing stack, the filenames of the
request logs do not appear to link correctly to the Thread IDs of the HTTP threads.
Workaround
To locate suspect URLs, manually open the request logs and search for incomplete requests, or use a tool such as
reqsorter.
Mail issues
Notes Client, Domino Server
New archive criteria type won't work if db is on earlier server
In Domino 7, when users create archive criteria, they can opt to select documents "older than" (i.e., by create date)
some number of days/months/years. This option is only available to Domino 7 clients; clients earlier than Domino 7
will allow selection only by modified/accessed date, expiration date, or selected by user.
However, criteria of this selection type also require that the database to be archived from is on a Domino 7 system
(locally on a Domino 7 client, or on a Domino 7 server). In cases where this is not true, any criteria based on "older
than" will not execute. Any/all other enabled criteria will continue to run.
Because of the large number of paths that archiving can take (e.g., processing done on client vs. server, on a client or
server schedule vs. manually initiated, out of current replica vs. out of named source, etc.), users will not receive any
errors if an "older than" criteria fails.
Therefore, "older than" should not be used as an archive selection type in an environment where users may have
database replicas on servers earlier than Domino 7.
Notes Client
Reply to All will not work on Collapsed Personal Groups
There is a new feature to allow the user to not expand personal groups. This option is available in the Delivery Options
for a new Memo. If the recipient does a Reply to All action, the personal group name will be placed in the memo but,
since the group was created locally by the sender, the recipient will not be able to use this group name and get a No
match dialog (a delivery failure in R4).
This is a software limitation. The user should remove the group name from the reply.
Policy issues
Domino Administrator Client, Notes Client, Domino Designer
Custom Welcome Page for Client Setup via modem
It's possible a custom Welcome Page deployed via Desktop Settings will not display on the Notes Client if the user has
performed a new Client Setup over a modem. This can be caused by slow connection speeds, network interruptions,
etc.. This problem is specific to dialup connections.
96
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Notes Client, Domino Designer
General Setup and Desktop Policies information
Below is some general information regarding Setup Settings & Desktop Settings that are deployed via Policies:
�
An R5.0x Notes Client does not support any Policy functionality, even if the mail server is running Domino 7.
�
When upgrading to the latest Domino 7 release, please replace the design of the Domino Directory so that it
includes the most current template code.
�
If the error: Document not signed displays, the likely cause is an unsigned Settings or Policy document. To
resolve this, open the Domino Directory and edit, then re-save each Settings and Policy document. Another
alternative is to delete all Settings and Policies documents and create new ones.
�
To add links (folder, database, document, URL, etc.) to the "Bookmarks to merge with users' bookmarks" outline
in a Desktop Settings document, simply drag and drop items from the title bar onto the bookmark outline. If you
are rolling out a more complex bookmark hierarchy, including the use of folders, you may find it easiest to create
the bookmark hierarchy in the Notes Client and then populate the Desktop Settings document using the
bookmarks created in the Notes Client.
Notes Client, Domino Server
Proxy Server settings not always being pushed down to the client
Information configured in the Proxies tab in a Desktop setting document intermittently get pushed down to the Notes'
client location document. If an Administrator locks the proxy information some of the fields will not lock down.
Domino Administrator Client, Notes Client, Domino Designer
Setup & Desktop Policies on a shared Notes Client
Because Setup & Desktop Settings are applied to the user's Personal Address Book, Bookmarks, and notes.ini file (user preference settings), several users who share one Notes Client (& data directory) will be unable to have policies applied correctly. This occurs because these local databases can only contain one set of Policies data. If users with different Policies assigned share the same Notes Client, they will have problems receiving the correct Policy settings when they switch id's to use the Client.
One workaround for this would be to consider using the new Notes Multiple User Client feature. This allows users to share the Notes program files, but have their own personal data directories - all on one machine. The feature is limited to the Notes-only Client license. But, it is a great way to allow for the sharing of one machine/one Notes Client, but also allow users to have their own personal Notes files.
Printing issues
Notes Client
Print previewing text in color shows up as black and white
Using metafiles, if the printer you are using to preview with does not support color printing, then font colors will not be
honored and will display as black and white. If you pick a printer that does support color, the font colors will be
displayed correctly.
97
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Programming issues
Domino Designer, Domino Server
Java applets need same JVM used to create Domino Objects
Standalone Java applets which use the Domino Objects (back-end classes) must be run under the same JVM version
as was used to create the back-end class library (lsxbe).
Domino 6 uses JVM 1.3.1. Any standalone Java applets using lsxbe.so from Domino version 6 must be run under JVM
1.3.1.
Domino 7 uses JVM 1.4.2. Any standalone Java applets using lsxbe.so from Domino version 7 must be run under JVM
1.4.2.
Using any other configuration is not supported.
Domino Server
NotesDatabase.GetModifiedDocuments
The NotesDatabase.GetModifiedDocuments method doesn't work in Java on UNIX. The Java CORBA version of this
method also doesn't work.
Domino Server, Domino for z/OS
z/OS LS:DO in codepage IBM-939 or 5039 not supported
On z/OS, Japanese DB2 using code page 943 or 5039 as the Mixed ASCII CCSID is not supported by LS:DO. Even if
the ASCII table is not used, DB2 with this CCSID causes a problem in LS:DO.
Roaming User issues
Domino Administrator Client, Notes Client, Domino Designer
Roaming User upgrade not supported via Passthru server
Roaming User upgrade is not supported on a Client that is configured to access the Roaming server via a passthru
server. If a user with this configuration has initiated a Roaming upgrade, they will receive a prompt to upgrade to
Roaming on that Notes Client. They should decline the upgrade on this machine to prevent configuration problems.
The user can successfully upgrade on other Notes Clients that access the Roaming server directly.
Search issues
Domino Administrator Client, Domino Server
Restricted field names in full-text indexing
Some field names are not supported in full-text indexing. Do not use these field names when creating forms in
databases because these fields are not searched in full-text indexing:
�
�
�
�
�
$Revisions
RouteTimes
$Hops
UserCertificate
Certificate
98
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Security issues
Domino Administrator Client, Domino Server
LDAP SSL SASL bind ignores Allow and Deny Server Access lists
When using Access Server or Not Access Server lists (Server Document, Security Tab) in conjunction with 'Enforce Server Access Settings' set in the servers document (Ports -> Internet Ports -> Directory), Secure (SSL) LDAP SASL binds from the Notes Client with Internet Client Certificates will ignore such lists.
Domino Administrator Client, Domino Server
LDAP using SASL authentication doesn't fail-over to Anonymous
Normally, Internet Client Certificate authentication from the Notes Client does fail over to Anonymous, over SSL, when
the authentication settings are set to "Client Certificate: Yes", "Name & Password: No", "Anonymous: Yes" in the server
document Ports -> Internet Ports -> Directory, or LDAP internet site document.
However, when the Notes Client uses SASL settings, the Notes Client tells the server that it would like to use Client Certificate authentication; when this is the case and no Internet Client Certificate is present in the notes.id file, the server is unable to authenticate the user, and will not allow them to search the directory anonymously either.
Domino Server
Misleading error message re: validating agent execution access
For Domino 7, server access as defined in the "Access server" lists on the Security tab of the Server document applies
to the signer of server-based agents. This is a change from R5.
Domino Administrator Client, Notes Client, Domino Server
Importing Certificates from Smartcards
Domino 7 has the ability to import preloaded X.509 certificates from smart cards or tokens without first
smartcard-enabling the ID file. This allows users to use keys that were pre-loaded onto read-only tokens and therefore
cannot currently be used to lock the Notes ID file. As long as the PKCS#11 library is correctly configured and a token
is present in the reader, then the "Import Internet Certificates from a Smartcard" menu option will be available as
described in the "Importing Certificates from Smartcards" release note.
However, there are limitations to this mode of operation in the current release.
�
Background processes, such as Just-In-Time encryption, are currently unable to prompt for the PIN, and so will
only be able to use keys on the token if the token supports a protected authentication path and will therefore be
able to prompt for the PIN itself.
�
If an ID file utilizing this feature is subsequently locked with a second smartcard, it may become impossible to
use any keys on the initial token on a single-slot system, since removing the smartcard that locks the ID file from
the reader to insert the initial token will log the user out of Notes.
�
Some older versions of Notes/Domino will be unable to use the key stored on the token.
Domino Administrator Client, Domino Server, Domino Web Access
Key rollover for DWA users not supported
Key rollover is a Domino 7 feature that allows Notes 7 users and Domino 7 servers to obtain the larger Notes
encryption and signing keys supported by this release. Key rollover is not supported for users of Domino Web Access
and Domino Access for Microsoft Outlook users.
For more information on key rollover, see the topic "User and server key rollover" in the Domino Administration Help.
99
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server
LDAP SSL SASL bind ignores Allow and Deny Server Access lists
When using Access Server or Not Access Server lists (Server Document, Security Tab) in conjunction with 'Enforce
Server Access Settings' set in the servers document (Ports -> Internet Ports -> Directory), Secure (SSL) LDAP SASL
binds from the Notes Client with Internet Client Certificates will ignore such lists.
Domino Administrator Client, Domino Server
LDAP using SASL authentication doesn't fail-over to Anonymous
Normally, Internet Client Certificate authentication from the Notes Client does fail over to Anonymous, over SSL, when
the authentication settings are set to "Client Certificate: Yes", "Name & Password: No", "Anonymous: Yes" in the server
document Ports -> Internet Ports -> Directory, or LDAP internet site document.
However, when the Notes Client uses SASL settings, the Notes Client tells the server that it would like to use Client
Certificate authentication; when this is the case and no Internet Client Certificate is present in the notes.id file, the
server is unable to authenticate the user, and will not allow them to search the directory anonymously either.
Domino Server
Running LDAP over SSL crashes MS Outlook Express
Due to a third-party software limitation, running LDAP over SSL may crash some old versions of Microsoft Outlook
Express.
Server issues
Domino Administrator Client, Notes Client, Domino Designer, Domino Server
Compact -a and -A will not work on DB2 enabled servers
Compact -a and -A are not working on DB2 enabled servers; archiving will not work. When attempting to run, you will
get this error:
Error compacting mail\jdb2.nsf: This feature not yet implemented for DB2 based .nsf(s)
Domino for i5/OS
Domino 7 for i5/OS Java Console Limitations
Following are the Java Console limitations for Domino 7 for i5/OS:
Ending a server from the Java Console
To End the Domino server from the Java console issue either of the following commands:
�
QUIT
�
RESTART SERVER
The following Java Console options are not supported to end i5/OS Domino server:
�
Menu: File->Stop Server
�
con kill domino
�
con restart domino
If you issue any of these commands, the WRKDOMSVR panel will show that the server is in an *ENDING state,
however the server does not end.
Multiple Java Server Console Instances
If you intend to use more than one instance of the Java Server Console on the system, the first Java Server
controller that starts will bind to port 2050. Subsequent requests to start the Java Server controller for another
Domino server will attempt to use that same port and will fail.
Workaround
To start more than one Java Server controller, manually create or edit the dcontroller.ini file in the Domino
server's data directory and specify the IP address of the Domino server and a port number other than 2050.
100
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Server, Domino for i5/OS
Domino for i5/OS Java Console limitations
To shut down the Domino server from the Java console, issue one of these commands:
QUIT
RESTART SERVER The following Java Console options are not supported to shut down the i5/OS Domino server:
�
The menu command: File - Stop Server
�
The server console command: kill domino
�
The server console command: restart domino
If you issue any of the above commands, the WRKDOMSVR panel indicates that the server is in an *ENDING state, but
the server does not shut down.
Domino Server
Domino for Linux on zSeries jconsole program limitation
The following is a list of Domino Console restrictions for Linux for zSeries:
1. The jconsole command may be run from a Linux for zSeries system by setting the DISPLAY environment variable
to point to a workstation running the XWindows server.
Domino Server
Domino Profile Setup can't get system databases from filesystem
The Domino Server Setup program has an option for setting up an Additional Server that allows the user to obtain the
server's system databases from the filesystem, including a CD, or a network drive, instead of replicating them from the
Domain Server. This option can be selected on the panel entitled "Provide the system databases for this Domino
Server", with a checkbox field called "Get system databases from CD or other media".
The Domino Server Setup program also has the ability to record a Server Setup Profile, which will record the
information for a server configuration is a file that can be applied either locally or remotely, as well as with a -silent
option. Applying this Server Setup Profile will configure the server specified using the configuration information that
was recorded.
Currently, a problem exists with the Server Setup Profile recording process that makes it unable to retain the option
"Get system databases from CD or other media" when it is selected. If a user selects this option while recording a
Profile, it will not be applied when a server is setup using that Profile.
The workaround to this problem is to either allow the Server Profile Setup to obtain the system databases from the
Domain Server (which requires that the Domain Server specified be running and reachable over the network), or to
perform the Server Setup (locally or remotely) without the use of the Profile.
Domino for i5/OS
Features not available in Domino 7 for i5/OS
The following features of Domino 7 are removed or not available with the i5/OS platform:
�
Cluster Enabled Domino has been removed.
�
xSP hosting has been removed. If the CFGDOMSVR or CHGDOMSVR commands specify XSP(*YES), the setting
is ignored.
�
NSFDB2 is not available.
�
IPV6 is not available.
101
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino for i5/OS
Limitations and Restrictions for i5/OS
XSL Transforms Disabled
XSL Transforms are disabled with Domino 7 for i5/OS to eliminate the potential for data corruption.
Workaround
You can explicitly re-enable transforms by setting the notes.ini variable Enable_iSeries_XSL=1. It is recommended
that transforms be offloaded to the client.
Java Server Console
If you intend to use more than one instance of the Java Server Console on the system, the first Java Server controller
that starts will bind to port 2050. Subsequent requests to start the Java Server controller for another Domino server
will attempt to use that same port and will fail.
Workaround
To start more than one Java Server controller, manually create or edit the dcontroller.ini file in the Domino
server's data directory and specify the IP address of the Domino server and a port number other than 2050.
Domino Server
Live Mode Memcheck requires AIX 5.3 or greater
Running NSD causes memcheck, the Domino memory checker, to be invoked. If you are using AIX version 5.2 or
earlier, and you invoke NSD while Domino is running, then memcheck will not be executed. This is due to a limitation
in earlier versions of AIX. You will see the following message in the NSD log file:
Live Mode Memcheck requires AIX 5.3 or greater, memcheck terminating
Domino Server
Message reporting on non-Windows machines
The message reporting feature of Domino creates bar charts in some of its reports. These bar charts are created
using the Java Abstract Windowing Toolkit (AWT). AWT is the interface between Java and the windowing system native
to the OS on which the server is running. On some platforms (i.e. Windows), the windowing system is always on and
active; on other platforms (i.e., UNIX), this is not necessarily the case.
On those other platforms, a native windowing system, like X11, must be installed and running in order for the
message reporting feature to work correctly.
Domino Administrator Client, Domino Server
NSD does not capture domdsmc stack
If NSD is enabled in the Domino Directory on Lotus Notes 7 or the Domino 7 server, if the server or client crashes,
NSF runs but it does not capture the domdsmc stack.
Domino Administrator Client, Domino Server
Problem with memory leak tracing code
If a memory leak is detected when the Domino 7 server is running, the tracing code cannot store all of the reported
handles. This is due to the 64K limit of AVL trees.
Domino Server
Relative directories issue with ISMP installation
Please use the absolute directory when running an ISMP installation; the relative directory is not supported for
Domino 7 Server installation with the ISMP installer.
102
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Server
Remote server Setup from UNIX to W32 cannot be silent
When attempting to perform a Remote Server Setup, using a UNIX system as the Remote Setup client, the program
will have problems setting up a Server on a W32 system (Windows 2000 or Windows NT4).
This only occurs when the user attempts to use the "Silent Setup" option. This would be invoked with the following
command-line:
remotesetup <serverhost> -silent <path to Setup Profile> =<path to notes.ini on serverhost
> -pb
The problems occurs this way because the Silent Setup option requires a path to the notes.ini file for the server being
setup remotely. However, when the Remote Setup client is on a UNIX system, it is unable to interpret a W32 path,
such as "C:\Lotus\Domino\Data\notes.ini". This causes the Setup program to write the following error message to the
errorlog.txt file (where Silent Setup log output is written):
Could not find 'notes.ini' as specified on command line
The workaround to this problem is to use the Remote Setup client on UNIX system in GUI mode only. If a Profile is to
be used, then the "-playback" option can be given to the remotesetup command as follows:
remotesetup <serverhost> -playback
or
remotesetup <serverhost> -pl
This will allow the user to manually select the serverhost to be setup, and then to proceed through the Profile in GUI
mode on the remote UNIX client system.
Domino Administrator Client, Domino Server
Spaces in directory names on UNIX causes nsd.sh to fail
When Domino 7 runs on Linux, spaces in directory names are not supported. If there are spaces in directory names,
the nsd.sh script fails to run.
Domino Administrator Client, Domino Server
STOP PORT console command may hang the server
The STOP PORT console command disables the specified port for Domino and all Internet services. It also signals all
active sessions to be terminated. The RESTART PORT command performs a STOP PORT command followed by a
START PORT command.
Problem for all Platforms:
If all sessions have not yet terminated and all listening services have not completely shut down and then the START
PORT command is issued it is possible to hang the server or put the server in a state such that it will hang on
shutdown.
As a result we discourage the use of the STOP PORT console command and RESTART PORT console command. If
STOP PORT must be used, please wait a few minutes after issuing STOP PORT before the START PORT command is
issued.
Problem for Windows Servers:
If Domino is running with any child processes (it almost always does), a known problem in Windows will cause the
Domino server to become unresponsive following a RESTART PORT command or a STOP PORT / START PORT
sequence. The problem is documented in Microsoft Article 177074. There is no known workaround at this time.
We recommend that STOP PORT and RESTART PORT not be used on Windows servers.
103
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Server, Domino for z/OS
z/OS Native Console Restriction
The following is a list of Domino Console restrictions for z/OS:
1. The jconsole command may be run from a z/OS system by setting the DISPLAY environment variable to point to
a workstation running the XWindows server.
2. If you are using zOS Console Support for Domino, be sure you use a unique user ID for each Domino server
partition (DPAR).
Domino Server, Domino for z/OS
z/OS: zFS filesystem limitation
On z/OS , we do not recommend using the z/FS aggregate dynamic GROW feature for Domino file systems. z/FS is
based on a UNIX file system software product that can take minutes (15 minutes in some cases) to grow a z/FS file
system in an aggregate. During the time the z/FS aggregate is grown, all file systems within an aggregate are
quiesced, in order to format the expanded part of the file system. We feel this quiesce would be detrimental to
Domino, as all disk I/O and client responses would cease during the aggregate GROW process.
We also recommend you continue to monitor the console log for the message "Warning: cannot merge full text index
a/notes/data/mtdata/mtstore.ft due to insufficient disk space" and manually grow z/FS files systems as needed
during off-peak hours.
Domino Administrator Client, Domino Server
"System" databases cannot be compacted
In the current release, the events4.nsf and names.nsf system databases cannot be compacted.
Web Services issues
Domino Server
Cannot deserialize multi-dimensional array in LotusScript
Multi-dimensional arrays as input to a LotusScript Web Service are not supported in this release.
Domino Designer
Earlier Web Service design elements do not open
LotusScript Web Service design elements created with early Domino 7 beta builds may not be able to be opened with
the gold build. In this case, the following error message will be displayed:
"Unexpected error initializing the Web Service design element: Unexpected: no err message"
Domino Designer
LotusScript runtime deserialization into empty dynamic arrays
User-defined classes may contain dynamic arrays. As input parameters to some operation in a LotusScript Web
service, these must be initialized in order to be dereferenced by service code without abending on an "uninitialized
dynamic array" error.
The LotusScript Web service runtime re-dimensions such arrays to a length of one empty element, as-needed i.e.,
during deserialization, when no array elements are present in the incoming SOAP request.
104
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Server
LS Web Services do not yet support SOAP multireference encoding
LotusScript Web Services do not yet support client requests that use SOAP multireference encoding (i.e., href/id
attributes for "reusing" common values)
Domino Designer
Multi-byte characters in WSDL documents
WSDL documents are Unicode-based XML documents, and as such, may contain characters which are multi-byte in
local operating system character sets. Because of file-system dependencies, WSDL import does not yet succeed with
WSDL documents containing such characters.
Domino Designer
XML schema mechanisms "include" and "import" are not supported
The XML schema mechanisms "include" and "import" are not supported. That is, any XML schema defined in an
imported WSDL document must not refer to any external XML schema documents.
Known problems and workarounds
Application Development issues
Notes Client
Java Debugger needs file copied into Notes binaries directory
In order to use the Java Debugger, the file dt_socket.dll must be in the Notes binaries directory; it is currently
installed in the jvm/bin directory in the Notes binaries directory.
If you try to use the Java Debugger without dt_socket.dll in the Notes binaries directory, Notes will crash.
Simply copy dt_socket.dll from jvm/bin to the Notes binaries directory to work around this problem.
Calendar and scheduling issues
Notes Client
2nd-level delegator in iCalendar receives unexpected reschedule
On an iCalendar repeating meeting with two levels of delegation, the 2nd-level Delegator receives a reschedule
unexpectedly.
Workaround
Since the user has already delegated the meeting, they cannot accept the reschedule. The user can delete it manually
out of their mail file.
105
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client
Calendar Managers always go to the Week View tab
When a Calendar Manager selects the All Calendar Entries tab (any option under it) and then try to return to the Day
or Month Calendar Views, it will always return them to the Week View. Once on the Week View, the Calendar Manager
can change to the Day or Month View.
Notes Client
Error responding delegated repeating invitation in meeting views
Users receive "You must select an instance document to perform these actions" while responding to a delegated
repeating invitation from the meeting views
Workaround
Open up the delegated invitation, and respond from it.
Notes Client
iCal: responses from Outlook Invitee comes as winmail.dat
When Outlook invitee responds (Accept/Decline/Tentatively) to a meeting sent by Notes Chair, the responded notice
comes over as a win.dat mail attachment.
Workaround
When the Outlook Invitee is replying, choose Respond with Comments. Before mailing, double click on the recipient's
(chair's) name and uncheck "Always Send To This Recipient In Microsoft Exchange Rich-Text Format". The Notes chair
will receive a Notes C&S workflow reply.
Notes Client
Invitations via SMTP can now transmit images
When you send a meeting invitation over SMTP and include an image file in the Description field, the recipient now
receives the image. You can also include images in the comment window when you respond to a meeting with
comments.
Notes Client
Online Meeting Password and Restricted Options
In Notes/Domino 7, meeting Chairs now have the option to send an Online Meeting with a password and/or to restrict
the Online Meeting to only the invitees of that meeting. Invitees of the meeting will only receive these options if they
are currently using a Domino 6.5.4 or higher template and server.
Workaround
For invitees who are not using Domino 6.5.4 or higher, have the invitee look in document properties at the "Meeting
Password" field, or send a request to the Chair to have them include the password in the body of the meeting.
Notes Client
Renamed users can not transfer direct-booked R&R reservations
If a user has direct-booked reservations in the Rooms and Resources database, and the user is renamed,
they will not be able to transfer these reservations.
In this case, the administrator has the option to transfer the reservation back to the user under their new
name; then, the renamed user will be able to transfer the reservation.
Notes Client
Reschedule to non-Notes should apply to "Just this instance"
Many non-Notes applications, like MS Outlook, do not support rescheduling to "This and all future instances" nor "This
and all previous instances". For this reason, when sending a reschedule of an iCalendar event to a non-Notes
application, Notes users should select "Just this instance".
106
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Client issues
Notes Client
Autosave - Enabling option in User Preferences doesn't roam
In User Preferences, on the Basic tab, the "x minutes for Autosave" option does roam; however, the checkbox does not
roam.
Notes Client
Autosave - Garbage characters may show up when server is down
Users may observe error messages that contain garbage characters while an Autosave document is being recovered,
or the user's Autosave database contains some documents waiting for recovery, while the server of that database is
down, or in the process of failing over to another server.
Notes Client, Domino Designer
Autosave - May cause errors to printing
Autosave may cause errors to printing for the following scenario:
1.
2.
3.
4.
There is at least one document in the Autosave database.
Open a mail file.
Click on an e-mail.
Choose "Ctrl+P" to print, click the OK button to print the document.
The user receives an error message which says "You cannot quit Notes because a dialog is active. Switch to Notes
first, close the dialog and then exit Notes", followed by a dialog asking them if they want to recover autosaved
documents. A new instance of Notes also appears in the taskbar. Printing works from the mail view, but the user may
get numerous dialog boxes and new instances of Notes.
Notes Client
Autosave - Recovered mail always get appended with a signature
If a user with the option to always include their signature on emails recovers an email message then their signature is
added to this recovered message. Deleting the appended signature is suggested for a workaround.
Notes Client
Autosave - Response created in 6.x or prior cannot be recovered
In the following scenario, a Response document cannot be recovered by Autosave:
1.
2.
3.
4.
5.
6.
7.
Using a 6.x client, create a test database on 6.x server.
Create a new Main Topic and Response documents using the 6.x client; save them.
Using a 7.0 client, enable Autosave for those forms (Main Topic and Response).
Using a 7.0 client, modify the Response document until Autosave kicks in.
After Autosave kicks in, crash Notes.
Restart Notes.
In the Recover AutoSaved Documents dialog box, select the Response document, then Recover.
The Response document opens automatically, but it contains original content only. The modified content has not
been saved.
107
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client
Black Toolbar icons
The small (18 pixels) toolbar icons sometimes appear black (just the mask). This occurs most often in low memory
situations.
There are several workarounds:
1. Switch the default toolbar icon size to large (24 pixels) by right clicking on the toolbar and selecting Toolbar
Preferences, then changing Button size from small to large.
2. View the Windows display settings by right-clicking on the Desktop and selecting Properties, then clicking the
Settings tab. If the Color Quality setting is set to True Color (32-bit), changing the display settings to 16-bit, or
256 Colors; it usually fixes the icons.
Domino Administrator Client, Notes Client, Domino Designer
Buddy list doesn't get populated with "Show online people only"
When "Show online people only" is enabled, sometimes the buddy list doesn't get populated automatically. It may
partially be populated. The workaround is to toggle the option in right-mouse-click menu or User Preferences >
Instant Messaging.
Notes Client
Compacting a desktop with private views
When you wish to compact the Desktop file, please be sure to close all private views first. Attempting to compact the
desktop while a private view is open will result in a Notes Client crash.
Notes Client, Domino Server
Delivered message has no Sender on Notes Client UI
Once a recipient has received a message, the "Who" field is left blank when viewing with a Notes client. When opening
with an Internet client, the field is correct.
Notes Client
Hovertext for embedded contact lists not working
The extended status text that pops up when 'hovering' the mouseover name displaying IBM Lotus Instant Messaging
and Web Conferencing awareness does not currently work for embedded contact lists.
Notes Client
iCalendar: All Day events are not converted properly
The iCal's "All Day events" are not converted properly into Notes' "All Day events".
Domino Administrator Client, Notes Client, Domino Designer
Invite at least two persons to Instant Chat Meetings
You can start an Instant Chat Meeting from the menu or from the Button bar.
�
From the menu, choose Create - Instant Meeting - Start Instant Chat Meeting or File - Instant Messaging Start Instant Chat Meeting.
�
From the Button bar, click the Instant Chat Meeting button:
Which ever method you use, you should invite at least two persons to the meeting. If you invite a single person,
Instant Chat Meeting will work on every other attempt. Try to use "Chat" instead of "Instant Chat Meeting" when you
want to talk to a single person.
108
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client
Known issues with IM Meetings if POP-UP blocker is turned on
Known issues attempting to connect to Instant Messaging Meetings within Notes if POP-UP blocker is turned on.
If you experience an issue with the Browser window failing to launch Instant Messaging Meetings when Running
Windows XP Service Pack 2 or if you receive a message "Dummy Window to open URL" and are unable to connect
when running Mozilla 1.7 as your browser, check to see that Pop-Up blocker is turned off.
Please see Tech Note 1176141 for other possible workarounds.
Notes Client
Notes crashes if Admin Client is opened from Tools menu twice
Notes crashes if you attempt to open the Administrator Client from the Tools menu more than once. The first time,
the Admin Client will open and work fine. If you close the Admin client and then reopen it, Notes will crash. Be sure
to save all your work before doing this.
Notes Client, Domino Designer
Opening Preferences of a Notes Mail Database Results in Error
Opening the Preferences of a mail database results in the following error: "Soft delete expire time must be less than
65535" followed by a second error: "Notes Error - field didn't pass validation formula."
This issue occurs when the Soft Delete expire time has been set to a value greater than 65535 using either LotusScript
(UndeleteExpireTime property of the NotesDatabase class), or manually on the Advanced tab of the Database
Properties.
Workaround
After the error occurs reset the expire time to a value below 65535.
Notes Client, Domino Designer
TweakUI and Notes
TweakUI is Microsoft PowerToys tool, and is not supported by Microsoft or Lotus. There are known problems:
1.
Notes client is auto-raised when the option is not selected.
2.
Notes client may crash or hang at various operations - starting up, opening db, etc.
Workaround
Completely uninstall TweakUI via the Control Panel. If the uninstall is unsuccessful, or if you still have problems
running Notes, the Windows OS needs to have the registries cleaned. Please consult Microsoft when uninstalling
TweakUI.
Note: It is strongly recommended that you do not install any unsupported tools on your system.
Notes Client
"Formula must evaluate to text" error on Welcome page
When opening the My Work Welcome page (formerly called "Workplace") you may receive a "Formula must evaluate to
text" error.
Workaround
�
Open your bookmark.nsf in Domino Designer
�
Go to 'Views'
�
Click on the view called "(Downloads)" and click 'Design - Preview In Notes'
You will most likely see two $branding documents there. If you do, see the "Multiple $branding documents" section
below.
109
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
If instead you see two documents with the exact title of "$branding4AA10721D4DE2AFF85256D4F003B84B4", see the
"Multiple $branding+UNID documents" section below.
Multiple $branding documents
�
Look at the far-right column for the UNID's of the $branding documents.
�
Select the $branding document that does NOT have a UNID that starts with "3493F249..."
�
Press DEL (ignore error message)
�
Press F9 key so that the $branding document is permanently deleted from the database
�
Close the view
�
Close Notes and reopen
The "Formula must evaluate to text" error should not appear.
Multiple $branding+UNID documents
If you see two documents with the exact title of "$branding4AA10721D4DE2AFF85256D4F003B84B4"
�
Look at the far-right column for the UNID's of these documents
�
Select the document that does not have a UNID of "3887F989A309670F85256F97004F"
�
Press DEL (ignore the error message)
�
Press the 'F9' key so that the $branding document is permanently deleted from the database
�
Close the view
�
Close Notes and reopen
The "Formula must evaluate to text" error should not appear.
Domino Server
"Searchresults No Documents Found" searching via browser
When searching a database such as the Domino Directory from a web browser (either directly browsing to names.nsf
or through webamin.nsf) the "Search" button (red below) may appear not to be working.
When you enter a value in the field for which you expect results to be returned, and you receive the following:
Seachresults No Documents Found
it may be an indication that the database is not full-text indexed.
The "Start with" button (the other button shown above) will work without the database being full-text indexed.
DB2 issues
Domino Designer
Actions run on federated data in query views may cause errors
When a user executes an action (an agent visible in the Actions menu) from within a query view containing federated
data, they may immediate receive an "invalid or nonexistent document" error. This occurs because the client attempts
to open the first note on which the cursor is positioned. If this note contains federated data, the client cannot open it,
and the action fails to execute.
Workaround
Execute the action from a different view.
110
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Designer, Domino Server
Date ranges are not being utilized with DAVs
In Notes, a Date/Time field can be both a multi-value field and a range field. So a field could have values like:
06/06/2004 (single value)
07/07/2004;07/09/2004 (multi-value)
08/08/2004 - 10/10/2004 (range)
07/07/2004; 07/09/2004; 08/08/2004-10/10/2004 (range and multi-value)
Currently, if you create a form with a multi-value date field with records that contain the above data, and then create a DAV with a multi-value date field (delimited, etc) and populate it, you will see all the above data displayed as simply multi-value. The former range values are changed to multi-value. The examples above would look like:
06/06/2004 (single value)
07/07/2004;07/09/2004 (multi-value)
08/08/2004;10/10/2004 (was a range, now multi-value)
07/07/2004;07/09/2004;08/08/2004;10/10/2004 (was range, is now multi-value and multi-value)
If you then try to insert from SQL, specifying a multi-value data set works fine but specifying a range does not. So the command:
insert into xx.md (multy_date) values('2008-06-06-00.00.00.000000-2009-06-08-00.00.00.000000')
would return '06/06/2008' in the Notes record. It actually drops the second value because it doesn't understand the
'-' indicating a range.
Domino Administrator Client
DB2 databases may appear as NSF in the Files list
If DB2 services are unavailable, NSFDB2s created using an earlier beta build will appear as NSFs in the Files list, not
as NSFDB2s (NSF icon).
Domino Designer
Document locking introduces problems with DAVs
If you are using DB2 Access Views (DAVs), you cannot use the Notes database document-locking option.
Domino Administrator Client, Domino Server
DOMCHANGE.NSF database should not be DB2-enabled
The database DOMCHANGE.NSF is used by the Activity Trends administration tool. Activity Trends is not
DB2-enabled; therefore, DOMCHANGE.NSF must not be created as a DB2-enabled Notes database. If you set up
Activity Trends on a DB2 enabled Domino server, complete this procedure.
Note If Activity Trends was set up before you enabled the Domino server to communicate with DB2, no changes are
necessary.
1.
2.
3.
Using the database template DOMCHANGE.NTF, create the database DOMCHANGE.NSF.
Open the Server document, and then locate the Administrators field and the Full Access Administrators fields.
Create an ACL entry for each item in those fields, using these settings:
�
Manager access
�
Change Admin, System Admin, Plan Reader, Plan Creator roles
4. Create an ACL entry for the server, using its canonical name, and then assign these settings:
�
Server user type
�
Manager access
�
Make the server the administration server of the database
111
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
5.
Sign all
1.
2.
3.
4.
5.
6.
7.
Chapter 3 - Known limitations, problems, and workarounds
documents in the database with the server's ID by completing these steps:
Move the DOMCHANGE.NSF database to the data directory of the Notes client.
Start the Domino Administrator.
Switch to the server's user ID using the File - Security - Switch ID menu items.
In the Domino Administrator, click Files, and then right-click on the database name DOMCHANGE.NSF.
Select sign, and then choose "Active User's ID" as the ID you want to use.
Choose "All data documents" in the field "What do you want to sign?"
Copy the database to the DB2-enabled Domino server's data directory.
Domino Designer, Domino Server
Inserts during DAV population
If a user attempts to insert a record, using the Notes client, into a DAV while the DAV is being populated, there is a likelihood that the new document will not be added to the DAV. Workaround
Avoid client-side inserts while the associated DAV (to which the user expects the inserted documents to be added) is being populated.
Domino Administrator Client, Domino Server
Moving a database to another DB2 group on AIX
The Move to Group command in the Domino Administrator client, accessed by clicking the File tab, and then choosing
Tools - DB2 Groups - Move to Group is not case-sensitive. The Move to Group command from the Tools menu does not
recognize database names composed of mixed-case characters, that is, both upper and lower case characters. If you
attempt to move a database that is composed of mixed-case characters, an error is generated.
If you are moving a database that has a name composed of mixed case characters, use the server console command,
DB2 group move. For example, at the server console command line, type
db2 group move MIXeD.nsf grp54
where:
�
�
�
db2 group move is the server console command
MIXeD.nsf is the database name composed of both upper and lower case characters
grp54 is the name of the DB2 group to which you are moving the database
Domino Administrator Client, Domino Server
Moving a DB2-enabled Notes database containing a DAV
Using the Domino Administrator client to move a DB2 enabled Notes database that contains a DAV, changes the
NSFSCHEMA property of the DB2 enabled Notes database. This effectively changes the view name used when running
queries against the DAV. For example, a DB2 enabled Notes database named myData.nsf may initially have an
NSFSCHEMA named MYDATA. DAVs created for myData.nsf would be queried by accessing the view
MYDATA.DAVNAME. Using the admin client to move myData.nsf to another DB2 group (for example., GRP1 to GRP8)
results in the NSFSCHEMA being changed to something else. In this example, assuming no other DB2 enabled Notes
databases were similarly named to myData.nsf, the NSFSCHEMA would most likely be changed from MYDATA to
MYDATA2. Queries written against the DB2 view MYDATA.DAVNAME will need to be modified so that they now query
MYDATA2.DAVNAME.
Note: Applications using the recommended @DB2Schema function will work without changes to the NSFSCHEMA. property.
112
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server
Moving a DB2 container to another physical location
The DB2 Move Container feature is not available in the Limited Availability release of Domino 7 and DB2. The DB2
Move Container feature physically moves a tablespace container to another physical location. Use one of the two
workarounds described below to move a DB2 container.
Workaround 1 -- For the DB2 administrator to perform
If it is necessary to physically move a tablespace container, that is, an x.DB2GRP file, to a new location, complete this
procedure from the DB2 command line processor (CLP). In this example, the original location of tablespace
container is C:\Lotus\Domino\Data\2.DB2GRP and the new location of tablespace container will be
D:\newdir\2.DB2GRP.
1. Connect to the database.
Note In Steps 2, 3, and 4, <group> refers to the tablespace name not the tablespace container (file system) name
and is case sensitive on IBM AIX systems. In the example, GRP2 is the tablespace name and would be entered in place
of <group>; 2.DB2GRP is the tablespace container name. On IBM AIX systems, be sure to set up the appropriate ACL
for the directory you are using.
2. Enter this query to determine the size of the original container:
db2 => SELECT TOTAL_PAGES FROM TABLE (sysproc.snapshot_tbs_cfg(' ', -1)) AS t1 WHERE TABLESPACE_NAME = '<group>'
These messages display: Total Pages 4032
1 record(s) selected.
3. Add a new container of the same size in the new location, by typing this command:
db2 => ALTER TABLESPACE <group> ADD (FILE 'D:\newdir\2.DB2GRP' 4032)
DB20000I The SQL command completed successfully.
4. Drop the original container by typing this command:
db2 => ALTER TABLESPACE <group> DROP (FILE 'C:\Lotus\Domino\Data\2.DB2GRP')
DB20000I The SQL command completed successfully.
Note For large tablespace containers, the command "ALTER TABLESPACE ... DROP" may fail with the error
"SQL0258N Container operations cannot be performed while a rebalance of the table space is pending or in progress.
SQLSTATE=55041". To resolve the error, when rebalancing is complete, re-enter the command
db2 => ALTER TABLESPACE <group> DROP (FILE 'C:\Lotus\Domino\Data\2.DB2GRP')
Workaround 2 -- For the Domino administrator to perform
Use this workaround to move a container indirectly by creating a new DB2 group on a different directory, and then
moving files from an existing DB2 group to the new DB2 group.
1. On the DB2 server, create the directory in which you want to add the new DB2 data.
2. From the Domino Administrator, attach to the desired server.
3. From the Domino Administrator, click Configuration.
4. Choose Server -- Current Server Document, and then click Edit Server.
5. Click DB2 to open the DB2 tab.
6. In the Directory field, remove the existing directory and type the name and path of the directory in which you will
store the DB2 data.
7. Save and close the Server document.
8. Wait for the server to process the change, or from the server console, type
Restart server
9. From the Domino server console, verify that the new directory information exists by typing
SHOW CONFIG DB2DIRECTORY
113
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
10. From the Domino Administrator, click the Files tab.
11. Select DB2 Groups from the tree, and then select the group that contains the DB2 enabled Notes database that
you want to move.
12. Right Click on the selected file, and then select Move to Group. (Optionally, you can use Tools - DB2 Groups
instead.)
13. Click the check box, Move to new group.
Note: If there are no groups to move to, the check box is selected by default.
14. Click Move.
15. The DB2 data is added to the new directory.
16. To move additional files to the new DB2 group,
�
From the Files panel and the group database list, select the DB2 database that you want to move.
�
Repeat Step 11.
�
Select the new DB2 group that you just created, and then click Move.
17. If you no longer need the old container, lock the old groups.
Domino Designer
New copy of DB with QV causes 'Invalid or nonexistent document'
On a DB2-enabled server, creating a query view in a database, and then copying that database, results in an error
message opening that query view in the copied database, as in the following scenario:
1.
In a database:
�
�
�
�
�
2.
3.
4.
5.
Create a form with a few fields that will be used to populate the database
Create a few documents using the form
Create and populate a DAV using the form & fields
Create a query view returning all fields from the DAV ("Select * from dbname.davname"), and columns to
show the fields
Open the query view in the client; verify the view opens correctly and documents can be opened from the
query view
Make a copy of the database
In the copied database, open the query view
Open any of the documents
You will see the error 'Invalid or nonexistent document'
Workaround
Open the newly-copied database in Designer. Check the 'DAV - update as necessary' option. Check the Query View's
SQL statement; modify it so that the database name and DAV name matches the newly-copied database names.
Domino Designer, Domino Server
Query view - updates return incorrect data
If a query view built using a join of Notes data and DB2 data is updated by opening a record and updating a field in a
Notes document, incorrect data is returned in the columns of the federated (non-Notes) data.
Workaround
Press SHIFT + F9 to correct the view.
114
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client, Domino Designer
Query view does not show docs with stored form
When "Store form in document" is enabled in form property, query view based on the form doesn't show documents in
view.
Workaround is to set "All" for DB2 Access View as below:
Domino Server
Query views cannot view federated data external to DB2 table
Because of a current DB2 bug, query views cannot view federated data outside of the DB2 databases in which they
reside.
Domino Designer, Domino Server
Refreshing Query View returns incorrect data
If you refresh a Query View in Designer, it returns all documents, not the data specified in the Query View SQL
statement.
Domino Administrator Client, Domino Server
Views w/ both categories and responses in DB2-enabled Notes dbs
When complex views containing both backslash-created category values and responses are opened in a DB2-enabled
Notes database, some documents may be missing from the view. Likewise, when the views are navigated by
application code, view entries may be missing.
Workaround
Keep these databases in NSF format.
115
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server
Web Admin database created as DB2-enabled Notes database
When the default database type for new Domino databases is set to DB2 on a DB2-enabled server, and the Web
Administrator database (webadmin.nsf) has not yet been created, running the http task on the server will result in the
Web Administrator database being created as a DB2-enabled Notes database. The Web Administrator database in
this form is unusable, so this should be avoided or the database deleted.
Workaround
Make the default database NSF and (re)create the Web Administrator database.
Designer issues
Domino Designer
Crash copying form actions to view
If you copy multiple Form actions to the clipboard (Ctrl + C) and attempt to paste to a View that has ZERO actions,
Notes crashes.
Workaround
Copy only one action and paste it into the view the first time. After there is one action in the view, multiple Form
actions can be pasted.
Domino Designer
Errors in agents imported by DXL not highlighted in Designer
If you use the DXL Importer to create a LotusScript agent that contains LotusScript syntax errors, and then open the
agent in Designer (having first signed the agent with the Administrator Client or programmatically), the Designer may
not bring the syntax errors to your attention, and may allow you to add more incorrect lines of LotusScript code
without receiving a warning. The Designer may also allow you to save the agent with the errors present, though note
that the agent will not execute.
You can correct this problem by re-importing the agent with the LotusScript syntax errors corrected in the DXL.
Notes Client, Domino Designer
Query view & View Selection formula with specific Form selected
When a Query View is created with a View Selection formula, make sure that any design elements specified in your
formula also have an associated DAV field.
For example, if you created a query view with SQL "SELECT * FROM NSF_NAME.DAV_NAME" and the view selection
formula "SELECT form="form_name" & @contains(field_name; "sample"); your DAV should include "FORM" under
source type "All".
In the above SQL example, a wildcard * is used, but if you specify each field, you should include FORM specifically to
get the correct result sets.
Domino Designer
Simple Actions cannot be used for new or changed view selections
When creating a new view selection, do not use simple actions, as they will have no effect. Similarly, do not use
simple actions when changing an existing view selection. Existing view selections employing simple actions should
still work properly.
Using a formula with the same intended effects as the corresponding simple action can still be used for new and
changing view selections. This can be used to work around the problem.
116
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Directory issues
Domino Administrator Client, Notes Client, Domino Server
LDAP service clients using Microsoft Windows XP and SSL
Using LDAP with SSL on Microsoft Windows XP requires that a root certificate be present in the Microsoft client's
certificate store. If the SSL server certificate for the LDAP server was not issued by one of the Certificate Authority
roots built in to Internet Explorer, you must install a new root certificate.
1. Determine the name of the certificate authority that issued the SSL server certificate. Connect to the server, using
SSL, with a Web browser. Do this by entering https:/ when you enter the URL.
2. In the security alert dialog, click "View certificate" and see the name in the "Issued By" field. This is the common
name of the issuing certificate authority.
Note: If you use https, and no security dialog is displayed, you may already have the required root or SSL server
certificate installed.
3. Click Tools - Internet Options - Content - Certificates. You can view the SSL server certificate on the "Other People"
tab, and see the "Issued By" name in this way. You can also check for installed roots on the "Trusted Root
Certification Authorities" tab. If the issuing root for the SSL server in question is already present, no further
action is required. If not, proceed to step 4.
4. Contact your administrator to locate the server running the Certificate Requests database for the issuing
certificate authority identified in the previous procedure. The Certificate Requests database is commonly named
"certreq.nsf". Open the database using the Internet Explorer Web browser (for example,
http://ca_server.com/certreq.nsf) and click "Accept this Authority in Your Browser." This installs the root
certificate.
Domino Administrator Client, Domino Server
Directory catalog sort ordering
When multiple documents from Domino directories are combined into single documents in a condensed directory
catalog (CDC), they are stored in a particular ordering. When this intra-document order does not match the
inter-document (that is, view sort) order, not all the expected lookup results may be returned. These ordering
inconsistencies may result from differences between the Dircat aggregation server's locale and the locales of Notes
clients using the CDC.
To create correct CDC(s), the administrator should perform the following three steps:
�
Create separate copies of CDC databases (not replicas) for each distinct locale desired. For example,
French and Danish users may each require a CDC sorted specifically to their respective language locale. It
may be useful to include the locale in the file names e.g., cdc-fr.nsf and cdc-dk.nsf. If your international
users don't mind using the same sort order, you then only need one CDC.
117
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
�
Set each CDC's "Default sort order" in File - Database - Properties - Design to the desired value. For
example, English users may want Latin1. Select "Unicode standard sorting" if a server is using the CDC,
otherwise you may de-select this option so that all documents are collated according to the default sort order
you just set:
�
Perform a full rebuild of your CDC(s) using the "load dircat" Domino console command combined with the "-r"
option.
Domino Administrator Client, Domino Server
Enabling SSO for foreign LDAP directory entries with @ signs
This release note describes a workaround for foreign LDAP directory entries that contain an "@" sign in the relative distinguished name (RDN). In order for these users to use single sign-on to access a Domino server, Domino administrators need to do the following:
�
Enter the LDAP DN in the "Shortname/User ID" of the Person document for each LDAP user that requires SSO
access. The LDAP DN should be formatted in the Notes style, using slashes instead of commas.
118
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
�
Chapter 3 - Known limitations, problems, and workarounds
On the Internet Access section of the Security tab of the Server document, enable "More name variations with
lower security."
For example, if the LDAP DN is:
[email protected],ou=acme,o=acme,c=us
Than you would enter the following in the "Shortname/UserID" field:
[email protected]/ou=acme/o=acme/c=us
Domino Administrator Client, Domino Server
Problem with enabling anonymous queries through LDAP
If you follow the procedure to allow anonymous queries through LDAP, as described in the help topic "Converting the default anonymous access settings to database ACL and extended ACL settings," a problem arises if there are any publicly available servers that run HTTP in the Domino domain.
The Domino Directory is now publicly available with Read access to all person documents. Since xACLs require consistent ACLs, there is no way to disable Anonymous access to the Domino Directory on servers that are running HTTP. This is not secure for customers with publicly available servers that provide Web site hosting for their applications. Workaround
Disable Anonymous access on the HTTP port.
DOLS issues
Notes Client, Domino Offline Services (DOLS)
Problems installing subscriptions with IE 5
If users attempt to install a subscription using Internet Explorer 5.01, they may receive the following error: "Error 500
attempting to request offline configuration data" dialog appears, followed by "Error requesting offline configuration
from the server."
Workaround
Users should install a later version of IE.
Note: If user attempts to install a subscription using Internet Explorer 5.0 with 128 bit encryption, they may receive the following error: "DOLS DSAPI error: user must be logged in in order to go offline." There is currently no workaround.
Domino Administrator Client, Domino Designer, Domino Server, Domino Offline Services (DOLS)
Limit subscription names to fewer than 30 characters/bytes
Some subscription titles with international characters (double-byte or multi-byte) are truncated when the subscription
is downloaded. The workaround is to use a title that contains fewer than 30 characters or bytes (if multi-byte).
119
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client, Domino Offline Services (DOLS)
Multiple directory catalogs may be confusing
Each Web Mail subscription installed on a Client can have its own directory catalog. This includes iNotes Web Access (R5), Domino Web Access (6) and Extended Mail (R6) databases, or any other customized DOLS enabled database that includes the directory catalog. If several subscriptions with directory catalogs are downloaded to the same machine, several issues may arise:
�
Any user with a subscription on that machine can read all of the installed directory catalogs, since they will all be
listed in the address selection dialog.
�
All the directory catalogs with the same name will appear in the address selection dialog of any Web Mail
subscription on that machine.
�
Despite having the same name, directory catalogs can contain different information, if they have different
replication schedules. If the user can't tell which one is most up to date, they may be using an outdated catalog.
Workaround
Make sure that all directory catalogs on the same Client have the same replication schedule.
Domino Administrator Client, Domino Designer, Domino Server, Domino Offline Services (DOLS)
Problem viewing "Out of Service" databases on a clustered server
When a user installs a subscription offline, then an Administrator or Designer marks the online version "Out of Service,"
the user can still synchronize with a replica on another server in the cluster.
But when the user then tries to use the Web Control or Domino Sync Manager to view the database online, they get an
error.
Domino Administrator Client, Notes Client, Domino Server, Domino Offline Services (DOLS)
Internet password not synchronizing
If a user downloads a subscription, then changes their Internet Password in the Person document on the server, they get an "Access denied" error if they try to use the new password to open the subscription offline. This is because the password does not synchronize from the server to the offline Domino Directory (DOLNAMES.NSF).
Workaround
After deleting the subscription, and reinstalling, the user will be prompted for the sync password which is now different
from the internet password. After synching, go offline, and you will now be able to enter the new internet password to
access the db.
Domino Administrator Client, Domino Designer, Domino Offline Services (DOLS)
Subscription desktop icons may not appear
A subscription icon may not appear on the desktop if the subscription:
�
Has Unicode in the title, or
�
Has a character in the title which the OS does not allow for a filename. For example, "/" is not allowed in a
Windows filename; subscriptions with "/" in the title (first tab of the Offline Config Doc) will not have an icon on the
desktop.
Workaround
To launch the subscription after the download you must launch it from the Lotus Domino Sync Manager.
Notes Client, Domino Offline Services (DOLS)
Sync gets stuck with multiple subscriptions set at 1 minute
If you have multiple subscriptions installed, and all are set to synchronize every minute, one of the subscriptions may
hang during synchronization at 100%. This shouldn't interfere with other subscriptions synchronizing. Close and
reopen the Sync manager.
120
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Designer, Domino Offline Services (DOLS)
Users must be Reader or higher to install DOLS database
Users must have at least Reader access in the Access Control List (ACL) of a DOLS-enabled database in order to
install the database offline. A user with Depositor access or No Access trying to install a subscription will get an error.
Workaround
Upgrade the user's access in the database ACL.
Notes Client, Domino Server, Domino Offline Services (DOLS)
When browser prompts to "Work Offline?" choose 'No'
If your browser prompts you to "Work Offline?" choose "No."
If you choose "Work Offline," there will be no live connection with a server, and you will not be able to synchronize.
Domino Administrator Client, Domino Designer, Domino Offline Services (DOLS)
Be consistent when encrypting subscriptions with shared files
Make all subscriptions either encrypted or not encrypted, if you know your users will share a file among them.
A shared file will be encrypted or not based on whether the subscription it was first installed with was encrypted or
not. Subscriptions which are installed after the first subscription may have a problem sharing that file if it was
installed encrypted.
Domino Administrator Client, Notes Client, Domino Designer, Domino Offline Services (DOLS)
DOLS on a Domino Configuration Directory server
When there are DOLS subscriptions on an additional Domino server configured as a "Configuration Directory" server,
make sure the Security Policy is either "Prompt for ID" or "Auto Generate."
If the user tries to install a DOLS subscription from an additional Domino Configuration Directory server with a
Security Policy of "Lookup in Domino Directory" they will get an Error 500, and the message "DOLS DSAPI error: No
person record found in names.nsf for user <username>."
Domino Administrator Client, Domino Server, Domino Offline Services (DOLS)
Moving extended mail files from one server to another
When you move an extended mail file from one DOLS-enabled Domino 5.0.5 or later server to another using AdminP,
the move will not be completed.
This happens because the last step in moving these mail files is for the user to access the original file using Notes.
When they do this, it updates the Notes Dialup Connection and Location documents in the Personal Address Book with
the new mail file and new mail server information. Then a "Push changes to new mail server" request is created and the
old mail file is deleted.
If a user accesses the original file with their browser using DOLS (or via replication) instead of Notes, this last step is
not initiated.
The Administrator must use LotusScript to create an agent in the Administrator Request Database that will create the
"push changes" request. The LotusScript can be downloaded from the Iris Sandbox on Notes.net. You can get the
download from the following URL:
http://www.notes.net/sandbox.nsf/ecc552f1ab6e46e4852568a90055c4cd/c425421e4e419540852568630079bb8c?
OpenDocument&ExpandSection=1&Highlight=0,admin4.nsf#_Section1
Notes Client, Domino Offline Services (DOLS)
Cancelling sync after wrong password causes security problem
If Sync begins and then fails, the password may become corrupt. Uninstall and then reinstall the subscription.
121
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client, Domino Offline Services (DOLS)
Desktop icon not changing when customized
When users install a subscription offline, then add their own icons to the Customize subform, the Sync Manager shows
the new icon, but the desktop icon does not change.
Workaround
Refresh the desktop or restart the operating system.
Notes Client, Domino Offline Services (DOLS)
Dircat path not removed from notes.ini when subscription removed
If you create a mail file using the extended mail template (mail6ex.ntf), and DOLS enable it with a directory catalog,
but do not select the option for shared files (on the Rules tab), when you download the subscription, the Names
parameter in the Notes.INI file in the iNotes directory should look like this:
NAMES=dolnames.nsf,dols\Web user1 Mattel US\9A55CDC7D0D12BA385256A7100720089\dircat.nsf,dols\Web User2 Mattel US\2EFE0803CB6E457285256A8C00746884\dircat.nsf
If you delete one of the subscriptions, the Notes.INI file Names parameter is not changed, and the subscription
directory still appears in the drop down but you cannot access the directory.
Notes Client, Domino Offline Services (DOLS)
Error during sync about public key not matching the Address Book
During synchronization, the user gets the error "Your public key does not match the one stored in the Address Book" in
the synchronization status, which is then set to idle.
Workaround
Open the security section of the server document and disable the option "Compare Notes public keys against those
stored in Directory."
Notes Client, Domino Designer, Domino Offline Services (DOLS)
If configuration document deleted, users must re-install
If, for some reason, it is necessary to delete a subscription's Offline Subscription Configuration profile document,
users who have the subscription installed must delete it and re-install the subscription with its new configuration
document.
Notes Client, Domino Offline Services (DOLS)
Multi-user subscriptions are deleted by Notes "clean up"
DOLS multi-user subscriptions are deleted when the user selects the Notes client "clean up" option in the following
scenario. You install Lotus Notes with the Multi-User Option, and you install a DOLS-enabled database that has "Use
Multi-User Data Directory" turned on in the subscription profile document. After you work in Notes, you are prompted
"Want to clean up your personal files?" Do not select OK. If you do, the next attempt to sync with the Domino Sync
Manager will fail because the DOLS multi-user data directory will be deleted when the Notes client shuts down.
Domino Administrator Client, Notes Client, Domino Offline Services (DOLS)
Users can't access encrypted subscription if ID overwritten
If the user has installed an encrypted subscription, then for any reason their ID changes, they will not be able to open
the encrypted subscription offline. This is because the offline subscription was encrypted using a key which matches
the ID. When the ID changes, the key no longer matches the ID and the subscription won't open. The user must delete
the encrypted subscription, re-install and re-encrypt it.
The "Overwrite existing user ID" setting should not be turned on in an enterprise that uses encrypted subscriptions.
Users whose IDs are overwritten will not be able to open an offline subscription encrypted with a key from the previous
ID. The only way to apply new IDs to encrypted subscriptions, is to delete the encrypted database and reinstall.
122
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client, Domino Offline Services (DOLS)
Disabled subscriptions synchronize during upgrade
If you disable all 5.0x subscriptions on a client system, then upgrade the server, when you upgrade one of the
subscriptions on the client, all of the subscriptions synchronize even though they are not enabled.
Notes Client, Domino Server, Domino Offline Services (DOLS)
Need proper format to use wildcard for Optional files
When using the * (wildcard) in the Optional files field of the Offline Subscription Configuration document (for example,
*.nsf), you must add a \ before it, or you can get an error synchronizing offline.
Workaround
Use \*nsf instead of just *.nsf
Domino Administrator Client, Domino Offline Services (DOLS)
Password lost when Offline Security doc is changed after upgrade
If your Offline Security Policy is set to autogen and you upgrade your server from 5.0x to 6.x, making a change to the
choices in the Offline Security Policy will result in a loss of the password for the certifier.
For example, this problem would likely occur if a particular domain contains encrypted subscriptions and you want to
turn on the new "Overwrite existing id" feature in the domain's security policy on the upgraded server.
Workaround
Go to the tab with the certifier id, reenter the password and save the security policy.
Notes Client, Domino Offline Services (DOLS)
Problems with DOLS SSO "Enter application Password" dialog
With SSO enabled, a user can inadvertently assign an offline subscription a different dolsuser.id/notes.id password
than the one that is used online for the same subscription. This will happen if the user enters and confirms a different
password in the Offline "Enter application Password" when downloading the subscription. The user can not easily
change this offline password.
Users may change the password in the Properties -> Security tab for the subscription to the online password. They
will then be able to open the subscription offline using the online internet password, however when they try to sync the
subscription, the incorrect synchronization password will be opened.
The user must enter the password that was entered in the "Enter application Password" dialog so that synchronization
of the subscription can occur. (This is the behavior when Notes and Internet password are different)
Domino Web Access
Can't use alternate organization unit to login offline
On Linux Mozilla, you cannot log in offline using the alternate organization unit as part of the login. For example, you
cannot use AlternateName/AlternateOrgUnit/AlternateLanguage.
If the user is created without an alternate organization unit, such as AlternateName/AlternateLanguage, you can login
offline using that ID.
Domino Administrator Client, Notes Client, Domino Offline Services (DOLS)
Cannot log into offline subscription with user short name
User cannot log into an offline subscription with their short name when the Internet Access/ Internet authentication
section of the subscription's security policy document is set to "Fewer name variations with higher security." This is
working as expected. Offline internet security needs to be at the highest level. As result, short name authentication is
not supported. All username aliases can be used instead.
123
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server, Domino Offline Services (DOLS)
Subscription doesn't failover when outside a company's DNS
DOLS does not support cluster failover during synchronization. However, you can set a backup server (or secondary
TCPIP address) in the Offline Subscription Configuration Profile document, in the Network settings.
Domino Web Access, Domino Offline Services (DOLS)
Upgrading the iNotes Sync Manager to the Domino Sync Manager
If you upgrade from the iNotes Sync Manger to the Domino Sync Manager, the desktop icons and menu items are not
automatically removed so you will have two sets of icons and menu items for the Sync Manager. You must remove the
iNotes Sync Manager icons and menu items manually.
Domino Administrator Client, Domino Server, Domino Offline Services (DOLS)
Using an alternate name to go offline
To go offline with an alternate name, the name must be in the database ACL. You cannot go offline if the alternate
name is in a group name, and only the group name is in the database ACL.
Domino Administrator Client, Domino Server, Domino Offline Services (DOLS)
With IIS, delay before install path dialog is displayed
In an environment with an IIS front end server and a Domino with DOLS backend server, when the user installs a
subscription there is a roughly 1.5 minute delay before the install dialog is displayed. This only occurs on first install,
not on reinstall.
Domino Access for MS Outlook issues
Domino Access for Outlook
Cannot edit MAPI profile
You cannot edit your MAPI profile via the Control Panel (Control Panel - Mail). If you need to connect to a different
server, you must create a new profile via the Start menu (Start - Programs - IBM Lotus Domino Access for Microsoft
Outlook - Create New MAPI Profile).
Domino Access for Outlook
Domino Access for Microsoft Outlook issues
The following is a list of differences between the Notes client and the Microsoft Outlook client, as well as known
limitations and problems.
Differences between Notes client and Microsoft Outlook client
�
Outlook's "Active Appointments" view does not accurately reflect the number of occurrences in a recurring
meeting; however, the calendar accurately reflects the meetings.
�
If a Notes invitee requests information in response to a meeting invitation, the Outlook chair will receive an
email with their comments.
�
Embedded messages can be read only by Outlook recipients. Use Forward or Reply to send existing message
content to all users.
�
Outlook does not support the creation of a new line in the Subject and Location fields on Calendar items.
New lines entered in Notes in the Subject or Location field are converted to a semicolon (;) followed by a
space in Outlook. Domino Access for Microsoft Outlook users can enter a semicolon and space so that a new
line is added in Notes.
124
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
�
Meeting updates to recurring meetings (not reschedules) are sent as individual items, if a change is made to
the series a number of updates will be sent. It is recommended that changes are made to single instances to
avoid multiple updates being sent.
�
Domino does not support recurring daily meetings every weekday. Instead, use the option to select the days
of the week.
�
In Outlook, there is no new mail notification on start up, even when there are unread messages in the Inbox.
New mail notification does not occur until a new message arrives.
Address Book
Distribution lists created in Notes that contain other distribution lists (nested distribution lists) cannot be resolved
within Outlook. Nested distribution lists created in Notes are resolved in the Domino server and can be used to send
messages. Nested distribution lists created in the Outlook Contact folders are resolved within Outlook and can be
used to deliver messages.
Group To Dos/Tasks
�
In Outlook, when forwarding a task that includes an attachment to another Outlook user, the attachment is
not forwarded.
Mail
Sending e-mail
�
To ensure full directory access, all directories you want to select must reside in your domain. This release
does not provide access to directories that require additional certificates to access, such as directories in
different domains. If you cannot access a directory, talk to your administrator.
�
It is recommended that complex documents be placed as attachments in e-mail. Microsoft Word is supported as the primary editor and is recommended where available.
�
The preferred format for e-mail should be set to Rich Text format in Outlook for best results.
�
Table formatting in some cases may be lost when sending from Outlook; use attachments for complex documents.
�
Messages removed from Domino Access for Microsoft Outlook using "shift-delete" are not removed from the
server replica. Users should simply delete messages and empty them from their "Deleted Items" folder to
ensure proper synchronization of deletes from Domino Access for Microsoft Outlook.
�
Mail notification of briefly changing the mouse cursor does not work in this release.
Outlook features not supported
�
Most of Outlook's publishing and authoring components, such as footnotes, bookmarks, captions, cross
references, page column formatting, edit change, and revision marks and tracking.
�
In Outlook 2002, sending e-mail that has an assigned category is not supported by Domino;
�
Follow Up flags are not sent to e-mail recipients if mail is in html format.
�
Pictures other than clip art and images from files. Charts, diagrams, and embedded objects. Use attachments for these objects. �
In some cases, active URLs in Notes do not replicate as active links in Outlook.
�
Once a message has been sent, Domino does not support the ability to expire or retract the message.
�
The tracking option "Process receipts on arrival" is not supported in Domino.
�
Outlook Rules that are applied to new items currently work only with the "Run Now" option, not as items are
added to the Inbox.
Other
�
There is currently no way to represent LotusScript buttons with Outlook.
125
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Calendar & Scheduling
Recurring meetings
�
Deleting recurring meetings, may result in some occurrences remaining on the Calendar.
�
In Notes, you can create a monthly meeting that happens on the first Tuesday and third Thursday of each
month. However Outlook does not support this as a repeat. These meetings will be distributed to multiple
dates when replicated to Outlook.
�
Recurring meetings that are subsequently changed to be "Private" cannot be accepted by the invitee. This can
be resolved by changing the end time by 1 minute and then setting the "Private" option.
�
If there is a mixture of acceptances and declines, the accept/decline status of invitees and rooms for specific
instances of recurring meetings may be incorrect. The original accept/decline notices for the users received
by the chair are correct.
�
In some cases, invitees added to recurring meetings, where a number of updates are applied, may receive a
"Request Out of Date" message when processing updates. It is recommended that the user verify that the
changes have been applied to the existing calendar entry, as in some cases they may not be.
Autoprocessing
�
When using "Autoprocess," the Chair does not receive an acceptance notice from the invitee, but the meeting
is added to the invitee's calendar.
�
On the Autoprocess tab, if you enable automatic responses to meeting invitations from specified users, you
have the option of choosing a name from the address book. however, you must remove the "@<domain>"
portion of the address for this feature to work.
Outlook features not supported
�
The fields "Show Time As" and "Categories" are not sent to invitees.
�
When you create a meeting invitation and save it as draft in Notes/Domino, the addresses are not available
when viewed in Outlook.
�
If you set an alarm for a specific meeting in Notes, the alarm is not set in Outlook for the same entry.
�
If a meeting invitation created in Notes is delegated to an Outlook user, the Outlook user cannot take action
on the meeting. However, the meeting may be added to the delegate's calendar.
�
The Outlook XP feature creating "Group Schedules" does not operate correctly. It will not save the members of
the group when initially created; subsequent edits will be saved and operate correctly.
�
The "cc" field is not supported when sending a response to meeting requests, add any additional recipients to
the "From" field.
�
The Notes/Domino invitee cannot delegate meetings created with an Outlook chair in this release.
�
Comments sent by a Notes/Domino Chair or Notes/Domino delegator are not supported when sent to Outlook Chair.
Other
�
Occasionally when accepting/declining multiple updates for a meeting, Outlook may report the error "The
messaging Interface has reported an unknown error. If problem persists restart Outlook." Close the entry, and
reopen it and accept/decline again. The error should not reappear.
�
Addresses selected from the personal contacts and LDAP directories will not show the tracking status of
attendees, when creating meeting invitations. They will correctly receive the meeting invitations, and updates
and responses will be received.
�
If a delegate tries to change the date in an appointment, reminder or all day event that was created by the
owner of the mail file, the delegate will get a message that the entry has been changed by another user. The
delegate will be prompted "Do you want to make a copy in the default folder for the item?" Workaround:
Delegate should click yes, and then close the calendar entry. Reopen the calendar and make the necessary
changes.
126
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Rich Text Formatting
Some of the rich text formatting (RTF) available in Outlook is not supported in Domino and will be lost or replaced by
similar formatting supported in Domino.
General
The following general areas of Outlook formatting are not supported:
�
Publishing and authoring features -- This includes manuscript revision marks and edit change tracking and
annotations, footnotes, captions, page headers and footers, bookmarks, indexes and tables of contents, and
cross references. It also includes creating columns and sections, and using "drop cap" paragraph
formatting.
�
Drawing and artwork features -- This includes creating new a drawing in the document, autoshapes, word-art,
charts, and diagrams. Note: Clip art and images inserted from files are supported.
�
Special text fields and form fields --This includes inserting auto text, text fields, and form fields. Examples
are current date or time, author name, creation date, calculated fields (such as sales tax), text boxes,
checkboxes, and dropdown fields.
�
Frames and sections, document variables, master documents, and subdocuments.
Text and Paragraphs
The following text or paragraph formatting are not supported:
�
Multi-level bullet and numbered lists -- only single-level lists are supported. Note: Supported list types are
solid circle bullet, decimal numbering, lower- and uppercase alpha, and lower- and uppercase Roman
numbering.
�
Shading and borders for text, shading for paragraphs, positioned paragraphs, automatic hyphenation and
paragraph styles.
�
Combining shadow, emboss or engrave formatting with superscript or subscript -- if more than one is specified, superscript or subscript take precedence.
�
Underline styles -- only the solid underlining style is supported; all other styles will be converted to solid.
�
Special tab alignment -- only left aligned tabs with no leader are supported.
Tables
In the following cases, Domino will convert table formatting to a style that is supported:
�
Tables created using "AutoFit to contents" tables and the "Fit text" to cell feature.
�
Varying column widths between rows; varying the number of cells between rows.
�
Varying text alignment and inner margins between cells -- all cells will have the same values. In a cell, the top
and bottom margins will always be equal and the same is true for left and right margins.
�
Varying cell border style and color between cells -- all cells will have the same cell border style and color, and
the table's outer border will be of a single style and color.
�
Shading -- only solid style of cell and table fill (shading) is supported -- Other styles (such as hash marks) are
converted to solid.
�
Table and cell border styles -- Domino supports eight styles; all others will be converted to the closest match.
�
The merge cells feature.
�
Number of columns and levels of nested tables are limited to 63 and 7, respectively.
Domino Formatting not Supported in Outlook
If you use both Notes and Domino Access for Microsoft Outlook, some formatting created in Notes is not supported in
Outlook. This formatting will either be lost in the conversion or will be replaced by something similar.
General
�
Drop-shadow borders on tables and pictures
�
Some list styles, such as circle, square and checkmark
127
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Tables
�
Chapter 3 - Known limitations, problems, and workarounds
Fit to Window style tables.
�
Cell image and gradient fill (shading).
�
Mixture of fixed and variable cell widths in a table.
�
Tabbed, captioned, and animated tables. These will be converted to normal tables in Outlook.
For migration issues, see the release note "Exchange to Domino Migration Issues."
Domino Access for Outlook
Exchange to Domino Migration issues
When data is migrated from an Exchange server to a Domino server, most of the data migrates successfully, however
there are some exceptions:
�
Recurring Meetings have data migration issues in the following instances:
�
If Outlook users decline a recurring meeting invitation from a user before the data is migrated, they will
not be able to accept partial updates to the recurring meeting after the meeting data has been migrated.
�
Outlook users should verify recurring meeting schedules and invitee status after migration, in cases
where some instances have been declined or rescheduled.
�
If successive instances of a recurring meeting are cancelled or rescheduled, the updates to the schedule
data may not migrate correctly.
�
Invitees should accept the initial invitation for recurring meetings before migration, otherwise subsequent
updates may not be correct. In the case of single meetings, migration can easily handle subsequent updates,
and only in very specific cases will there be a problem with updates to recurring meetings.
�
When a migrated task includes a .JPG attachment, there may be problems opening the file.
�
When a Notes user replies with history to a migrated memo that includes an attachment, it may appear that
there are two attachments: the original attachment and an image of a file document.
�
If migrated Exchange users have similar names (such as John Yankowski and John Yankowsky), the mail file
could be overwritten during Notes registration. When registering Notes users, the Domino Administrator
truncates long names to eight letters (the first initial of the first name and the first seven letters of the last
name).
Workaround: During registration, make sure you manually extend the name or you will be prompted to
overwrite the first instance of the truncated name.
See also the release note "Domino Access for Microsoft Outlook" for a full list of problems and limitations.
128
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Access for Outlook
Troubleshooting the Exchange to Domino migration
There are a few situations you may encounter during the migration process that require some simple troubleshooting. Here are a few tips to help you perform a successful migration.
Explanation and Workaround
Problem
Microsoft Exchange isn't
Microsoft Exchange must be configured as a Foreign Directory Source during the
available as a Foreign
installation of the Administrator Client.
Directory Source in the
Workaround: If Microsoft Exchange isn’t available as an option, you must reinstall the
People and Groups Migration
Domino Administrator Client and make sure Microsoft Exchange is configured as a
dialog
Foreign Directory Source during the installation process.
You need to migrate a user The Domino Migration Tool is designed as a "run once" utility, which registers users and
more than once
creates their associated mail files on the Domino server. You can migrate a user more
than once, but remember that if you migrate to the same Domino mail file, the existing
data is not replaced, it is just appended.
Workaround: If you need to "re-migrate" a user, delete the existing Domino mail file from
the Domino server, and then perform the migration for that user again. You will be
informed that the user is already registered on the Domino server, and prompted to
update the existing user. Do this, and complete the migration. A new mail file will be
created for the migrated user on the Domino server.
The address conversion for a While running the address conversion utility, you may see the message, "Address
user's mail file fails
conversion failed for this user."
Workaround: It is crucial that the server name and address book be up to date before
running the address conversion. Update the name and address book following the
instructions previously outlined, then perform the address conversion again.
After migration, a user’s mail If addresses are displaying in Exchange format, you may have forgotten to perform the
file displays addresses (such address conversion on this mail file.
as in the 'Chair' item or
Workaround: To be on the safe side, perform the address conversion (following the steps
'From' item) in Exchange
previously outlined) on all the migrated mail files on the Domino server. Also, it is
format
possible that you have not yet migrated the user whose address is displaying in
Exchange format. Once that user has been registered on the Domino server and the
associated mail file migrated, run the address conversion utility again.
The Domino Migration Tool If the migration process fails, which can happen if the server connection is lost, it is best
fails during the process of
to start the process again, beginning with the user in transit during migration.
migrating users
Workaround: If the migration process fails while migrating a user, that user and any
others in the Registration Queue will be saved in preparation for registration and
migration. Because the user in transit when the failure occurred may be partially
migrated, it is best to delete that user’s mail file from the server once the server
connection is restored. Then resume the migration process by selecting "Register All" in
the Register Person dialog.
Domino Domain Monitoring issues
Domino Administrator Client, Notes Client
'Open Monitoring...' opens new instance each time
When you click the Open Monitoring... outline entry in the Monitoring Configuration database (events4.nsf), the
Domino Domain Monitor database (ddm.nsf) will be opened on the corresponding server. If you click this outline entry
multiple times, a new instance of the Domino Domain Monitor database will be opened for each time the outline entry
is clicked.
If this occurs, close all instances of the Domino Domain Monitor database and the Monitoring Configuration database.
Re-open one instance of the database and the problem should no longer occur.
129
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Notes Client
'View Unread' button presents mixed results in Collapsed views
The Domino Domain Monitor database (ddm.nsf) has a View Unread button in all of the views and tabs.
The purpose of this button is to help manage large volumes of data that might be reported in this database. Using
this button will allow users to display only documents that are marked unread. This will allow Administrators to view
new documents that require attention and temporarily remove documents that have already been reviewed (read).
The button serves as a 'toggle' - when viewing the Unread documents, the button now reads 'View All'. Click the button
and it will now display all documents for this view.
There are some minor problems when using this button in a view that is set to 'Collapse All'. After clicking the 'View
Unread' button in a view that is fully collapsed, the category counts will continue to reflect the total docs in that
category, not the unread docs in that category. In addition, if you click the category, the category will disappear,
leaving only the unread documents for that category. This occurs for each category in the view. If you click each
category, eventually, you will have a view of unread, uncategorized documents.
To avoid this, simply make sure the view is not set to 'Collapse All' before using the 'View Unread' button. The view
should display correctly for this scenario.
Domino Administrator Client, Notes Client
DDM 'Restore Default Probes' action
The DDM 'Restore Default Probes' action in the Monitoring Configuration database fails with this error: The specified
agent does not exist. There is no workaround for this problem.
Domino Administrator Client, Notes Client
Domino Domain Monitor best viewed w/bookmarks unpinned
The Domino Domain Monitor database (ddm.nsf) is best viewed with bookmarks unpinned and/or a screen resolution
of 1024 by 768 pixels, or more. If bookmarks are pinned or the screen resolution is too large, the tabs in this
database may overlap each other, making it difficult to navigate. Simply unpin the bookmarks pane or adjust the
screen resolution and the database will have enough room to fully display.
Domino Administrator Client, Notes Client
IBM Lotus Instant Messaging in Domino Domain Monitor
Double clicking on an Administrator listed in the IBM Lotus Instant Messaging pane ('Show/Hide Administrators') will
not initiate an Instant Messaging dialog with the Administrator. Simply right-click on the desired Administrator's
name and choose "Chat with . . .".
Domino Administrator Client, Domino Server
Log Filter configuration documents
Introduced in Domino 6, Log Filters can be defined in events4.nsf; these filters specify which events get displayed on
the server console or added to the server log file. Events are filtered according to severity level and type. Please see
documents in the view named 'Filters / Log Filters' for more details. The severity and type of any event is defined in
the events4.nsf message documents. See documents in the view named 'Advanced / Event Messages by Task' for
more details.
In Domino 7, some of the message document Type values have been changed to more accurately describe events
defined by these documents. For example, some messages that had been defined with a type of 'Database' have been
changed to have a type of 'Security'. If you have defined Log Filters using Type, you may want to review their values.
Also in Domino 7, some of the message document Severity values have been changed to more accurately represent
events defined by these documents. If you have defined Log Filters using Severity, you may want to review their values
as well.
130
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Server
Orphaned documents left in DDM.nsf
In certain cases, documents have been found in a DDM.nsf that one wouldn't expect to be there based on the selective
replication formula. One example of this can occur after the formula is changed (due to a hierarchy change.) When
the last replication occurs with the former child server, any documents no longer contained on that server (let's say
they were deleted) won't be removed in the current server. This means that they are stuck there until removed by an
admin.
Workaround
Use Control-Shift View->Go To to go to the hidden the ($vwAllEvents). Look at the first column which is
OriginatingServer. Select all of the documents for those servers not in the selective replication formula and then
delete them.
Domino Server
Removing multiple copies of TCP and Mail probe documents
When the event process detects that there is no events4.nsf, it creates it. It then sets up certain default monitors by
creating documents in that database. One of those monitors is the probe documents for both TCP and Mail.
Normally, this is okay, however, this can lead to the following situation:
Server A is the admin (first) server in the domain. There is also a Server B. Server B's events4.nsf is deleted. So
it does the above steps. Events4.nsf then replicates with Server A and adds the new TCP and Mail probe
document to Server A's events4.nsf which eventually replicates the old probe docs back as well. So now there are
two copies of the TCP and Mail probe documents. Every time events4.nsf on Server B is blown away, this will
happen and over time will create more documents.
The code was changed to only create those default monitors on the first server. So deleting events4.nsf on any other
server won't result in new documents. However, since this problem may have occurred on your servers in the past
action should be taken to removing these unnecessary documents. To do this:
1. Open events4.nsf on your server.
2. Navigate to Event Generators -> TCP Server
3. In the view, find those documents that are categorized as All Servers. If you have multiple ones, remove all
but one of them.
4. Navigate to the view Event Generators -> Mail Routing and do the same.
Domino Server
Router "complains" about messages that contain no recipients
In the Beta releases, it was possible to create a DDM Mail probe configuration document without specifying a
recipient. The template has been fixed so that is no longer possible. However, if old configuration documents are still
present, the will cause the router to issue the following message:
Router: Message 00600F1C contains no recipients OF85256EAB:00600F1C
To correct the issue, simply delete the probe (since it is based on an old form), and recreate it.
Domino Administrator Client, Notes Client
Security Configuration probe cannot be enabled from view level
The Security Configuration probe document cannot be enabled from the view level, using the 'Enable Probes' view
action. When trying to do so, you may receive the error: 1 probe document could not be enabled due to one or more
missing field values. Please edit it individually. To work around this, simply open the Security Configuration probe
document, review all fields to verify all fields are populated with valid values, and click 'Enable Probe' from within the
document. This will enable the probe.
131
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Web Access issues
Domino Administrator Client, Domino Web Access
Add Sender to Contacts not working correctly
Users registered with a first, middle, and last name using the default Internet Address setting of "FirstName
LastName", and "None" as the separator, do not get added to Contacts correctly. Instead of displaying in the First
name, Middle, and Last name fields, the first and last names display in the "Last name" field of the Contacts entry,
and the middle name does not display.
Domino Web Access
Attachments larger than 10 MB require change to Server doc
Using file attachments larger than 10 MB will result in a "server not found" error.
Workaround
The following settings in the Server document default to 10000 KB. Increase these settings to accommodate the use
of file attachments larger than 10 MB:
�
�
On the Internet Protocols - HTTP tab : "Maximum Size of Request"
On the Internet Protocols - Domino Web Engine tab: "Maximum POST data"
Domino Web Access
Cannot insert multiple links in a table in a mail message
In the current release, if you are using Microsoft Internet Explorer as your browser, you cannot insert more than one
link in a table that you have created in a mail message.
You can insert the link only in the last cell of the table. For example, if a table has 6 cells, you can insert the link only
in the sixth cell.
Domino Web Access
Cannot install a subscription after cancelling
If you begin installing a subscription, and then cancel, you must manually remove the subscription from the Lotus
iNotes program directory. Then, right click and select "Go Offline" in order to re-install the subscription.
Domino Web Access
Cannot install Offline subscription from full DWA portlet
You cannot install an Offline subscription from the full Domino Web Access portlet unless the "Functional Area" of the
portlet is set to "All." Open the URL for the mail file directly (e.g., http://myserver/mymailfile.nsf) and then select "Go
Offline."
Domino Web Access
Cannot search in NamePicker hierarchy views in Domino Web Access
In the Select Addresses dialog box, you can search only in the List by name view.
Domino Web Access
Cannot send a meeting invitation to a group in CDC from offline
In Domino Web Access 7, when working offline, you cannot send a meeting invitation to a group in a CDC (condensed
directory catalog). You can, however, use the group to send mail. Also, this is not a problem if you are using the
inotes6.ntf mail template.
Workaround:
Don't put the Group into the Dircat. Enter the Group name in the "To" field and then click send. Choose "Use Name
Anyway" when prompted that the name is not found. Alternatively, you can create Groups locally in your contacts.
132
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Web Access
Cannot use Web Admin to set default Welcome Page
Web Administrators cannot use the Configuration Settings document (Domino Web Access) tab to set the default Welcome Page. Domino Administrators can set the default Welcome Page and, if allowed, Domino Web Access users can set the default using the Edit Layout button on the Welcome Page.
Domino Web Access
Changing your internet password in Domino Web Access
When you change your internet password, allow time for the server's AdminP process to run before the change takes
effect. You may have to wait anywhere from 5 minutes to several hours depending on how often the AdminP process is
set to run on the server.
When your Internet password is different from your Notes password:
�
You may be prompted for a Synchronization Password the first time DOLS attempts to synchronize the offline
mail file. When such a prompt occurs, you must set the Synchronization Password to your Notes password.
DOLS will automatically save this password in your subscription synchronization preferences. When logging into
the database offline in a browser, use the same internet password you would use to log into the browser online.
�
If your offline mail file is encrypted locally, then a HTTP 500 Server internal error may occur when the offline mail
file is opened, unless you have correctly set the Synchronization Password for the subscription to the Notes
password. In the DOLS Sync Manager, select the mail file subscription entry, then select the Properties - Security
dialog to set the Synchronization Password.
Domino Web Access, Domino Offline Services (DOLS)
Close the browser before uninstalling Domino Sync Manager
You must close the browser before uninstalling the Domino Sync Manager. If you do not close the browser, it does not
uninstall completely, and may cause errors the next time you try to install a subscription, or go offline.
Domino Web Access
Domino Web Access 7.0 limitations on Linux Mozilla
Following are the limitations using Domino Web Access 7.0 on Linux Mozilla:
General
�
The first time you access Domino Web Access, you will get the following prompt. Check "Remember this decision"
and click the OK button so that Domino Web Access can work properly.
A script from "International Business Machines Corporation" has requested enhanced privileges. You should
grant these privileges only if you are comfortable downloading and executing a program from this source. Do
you wish to allow these privileges?
Local Archiving
Local archiving is not supported.
Preferences
You cannot set your default mail client in the Other Preferences.
Alarm
Even if you snooze an alarm, the alarm window will no longer pop up after you switch to another view (e.g., from Mail to Calendar).
Proxy Support
Proxy support is not available in Linux Mozilla for this release.
133
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Chat and Instant Messaging Integration
Online meetings are not supported with Mozilla, therefore if a Domino Web Access user is engaged in a chat session
and clicks on "Add Tools" none of the selectable options, such as screen sharing, whiteboard, audio or video, will work.
Domino Web Access Server Setup
You must have Sametime 3.1 or later to enable Chat and Instant Messaging (Sametime) integration in Mozilla. In addition, you must enable Instant Messaging in Preferences in order to use Chat and Instant Messaging; previous versions of Chat are not supported in Mozilla.
If your Sametime server is not on the same machine as your Domino Web Access server, you must copy Sametime related files from the Sametime server to your Domino Web Access server. To do so, follow the steps below.
1. Copy the data\domino\html\sametime\stlinks directory from the Sametime server to the same location on your
Domino Web Access server. Create the Sametime directory if one does not exist.
2. Replace the data\domino\html\sametime\stlinks\stlinks.jar file on the Domino Wed Access server with a signed
version of stlinks.jar file. In Sametime 3.1, this file is in the Toolkit\stlinksignedapplet directory on the Sametime
3.1 installation CD 2; for Sametime 6.5.1, this file is in the <Sametime server
directory>\Data\domino\html\sametime\stlinks\signed.
Note: For more information on setting up Domino Web Access for Sametime, see the Domino Administration help.
Mozilla Browser Setup
You must install the Java Plug-in 1.4.1 before using Instant Messaging (Note: Do not use JRE 1.4.1_05). First install the Java Plug-in on the Linux client and then create a symbolic link under the [Mozilla Installation Directory]/plugins to point to the plug-in. Use the following procedure:
cd /
ln -s /usr/java/j2re[VERSION]/plugin/i386/ns610/libjavaplugin_oji.so [Mozilla Installation Directory]/plugins/libjavaplugin_oji.so
Restart Mozilla
Java Plug-in is a part of the Java Runtime Environment and you can download it from http://java.sun.com.
Note: To check if Java Plug-in is correctly installed, select [Help]-[About Plug-ins] to see "Java(TM) Plug-in 1.4.1_xx" in
the plug-in list (where xx is revision number of Java Plug-in).
Offline
�
Offline is supported on Mozilla 1.4.1 and 1.7 with SuSE 8.0/United Linux 1.0 SP3. Be sure to install the Red Hat
package named C/C++ Compiler and Tools.
�
Only one offline Domino Web Access subscription is supported per Linux client. If you want to install a new
subscription on a Linux client that already has a Domino Web Access subscription installed offline, you must
uninstall the existing subscription first.
�
Use the Go Online drop down menu to install, synchronize, schedule synchronization and reinstall your
subscription on the Linux client. The Domino Sync Manager is not available on Linux Mozilla. Instead, use DWA
Sync to synchronize your mail file on the Linux client.
�
There must be a Mozilla script file in the usr/bin directory to be able to launch Offline from the desktop Offline
icon. The Mozilla script file is usually a part of the Mozilla installation and is located where Mozilla is installed.
Users may have to copy their script file to the usr/bin directory then edit it so it points to the directory where
Mozilla is installed.
�
The Offline mail file is always installed to the user's $HOME directory.
�
If you have a problem installing, synchronizing, or going offline, and receive a message that one of these services
is already running, you may need to reboot your system. After you reboot your system, remove files named
httploaded, synching, or downloading in the /usr/tmp directory. Then, retry the operation that was failing.
Upgrading DOLS
You must remove your current version of DOLS before you upgrade. For information on uninstalling Domino Off-Line Services for Mozilla (on Linux clients), see the Domino Web Access help topic "Uninstall Domino Web Access from Linux Mozilla."
134
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Web Access
Domino Web Access 7.0 offline issues
Following are the issues using Domino Web Access 7 offline:
Installing on Novell SuSE Linux
In order to install a Domino Web Access mail file offline on Novell SuSE Linux, the software package for "C/C++
compiler and tools" must be installed before the user attempts to go offline.
Installing on Firefox on Linux
The Firefox browser does not support signed XPI files currently so the install package appears as unsigned (invalid).
However you will be able to download and install successfully.
Login using full name
When logging in offline, you must use your full name, such as John Smith, instead of your short name, such as jsmith.
Domino Administrator Client, Domino Web Access
Domino Web Access secure mail issues
Following are the issues using secure mail in Domino Web Access:
Signed Mail
When a signed message is sent from an account that has an Internet certificate included in the imported Notes ID to a
recipient that does not have an imported Notes ID, the signed icon appears broken to the recipient with the mouseover
message: "Could not open the ID file."
Notes Signed Mail Sent via SMTP
Notes signed mail sent via SMTP will have the signature removed before it is delivered to the recipient.
Notes Encrypted Mail Sent via SMTP
Notes encrypted mail sent via SMTP may have problems such as loss of attachments, or mail in which the body of the
message cannot be read by the recipient.
Notes Signed and S/MIME Encrypted mail
If you are offline, and have a Notes certificate (no Internet certificate) and you try to send an S/MIME signed and
encrypted message to a recipient with only an Internet Certificate, you will get a 'No Delivery' Report message.
Workaround: Both the sender and the recipient must have the same type of certificates to send signed and encrypted
messages.
Using name resolution when encrypting a message
or
If you want to send an encrypted message, you must check "encrypt" before you click the check name button
press F9 for name resolution. If you use F9 or the check name button before you enable encryption, you will get an
encryption failure.
Requiring SSL to use Secure Mail
When you receive the message box informing you that you are switching to SSL, do not click X to close the box. You
must click OK and allow the switch to SSL to occur.
Important: Within the scope of a directory search, all group names must be unique. Make sure that there are no like
named groups in different domains.
135
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Web Access
DOMWS Convert AddIn task loads by default
If the http task is enabled the DOMWS Convert AddIn task is also started automatically. When this task loads you will
see two messages on the console:
DOMWS Convert AddIn Initializing
DOMWS Convert AddIn Initialization Complete
This task is necessary only if using the Common PIM portlets that are part of WebSphere Portal 5.1X. To disable this
task, set the HTTPNoDomWSAppSpace=1 in the NOTES.INI file, and disable XML Services using the steps below:
1.
2.
3.
4.
From the Domino Administrator client, open the server document for the Domino application server in edit mode.
Click the Internet Protocols - Domino web Engine tab.
Uncheck the XML Services box.
Save and the changes.
The next time you restart the server, the DOMWS task will not start.
Domino Web Access
Firefox does not support awareness in DWA on Windows
Using Firefox on Windows, the browser hangs and crashes with Sametime awareness enabled in Domino Web Access.
Workaround
By default Sametime awareness will be turned off for Windows based Firefox clients.
Domino Administrator Client, Domino Web Access
Format preference for incoming mail
For Domino Web Access users, in the Person document in the Domino Directory, set the "Format preference for
incoming mail" field to "Keep in senders' format."
Domino Web Access
Lotus Instant Messaging Limited Use version requires variable
If you installed the Lotus Instant Messaging Limited Use version of Sametime, you need to add the variable
VPS_ALLOWED_LOGIN_TYPES=1003,100A to the Sametime.INI file on the Sametime server data directory for Domino
Web Access users.
Domino Web Access
Meeting update notices do not get sent
When you update both the subject matter and invitees for a scheduled meeting, the meeting update notice is not sent.
Workaround
Create separate updates for the meeting. For example, update the invitees and send that update. Then update the
meeting subject in a separate update.
Domino Web Access
New message may be discarded without prompting
In a new message, if you click 'To', select a name from your contacts, and then click the "X" in the corner of the window
instead of choosing 'Send' or 'Send and File', you will not be prompted that the message will be discarded.
Workaround
Type the full address of the person in the 'To' field, or type in the beginning letters and click the green check to choose
from the Name directory.
136
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Web Access
Problem opening attachments with Chinese file name
On Windows XP using Internet Explorer, if you open a message in Edit mode, you cannot open an attachment that has
a Chinese file name.
Workaround
To open attachments that have a Chinese file name, double-click the attachment in read mode.
Domino Web Access, Domino Offline Services (DOLS)
Problem opening offline on Linux Mozilla
If you are using Firefox or Mozilla browser on Linux, and going offline using the desktop icon, you must copy the
run-mozilla.sh script file from the directory in which Firefox or Mozilla is installed to /usr/bin, and then rename the
file to "mozilla." Edit this file to point to the Firefox or Mozilla directory path.
Domino Web Access
Rich Text Editor issues in Domino Web Access
Following are the known issues with Rich Text Editor using Domino Web Access:
Lists
When you create a list (unordered or number list) and use the heading format to increase the type size, the following
problems occur when you undo the heading size:
�
If you select a list in a single cell and then undo the heading, the list element disappears also.
�
If you have lists selected in more than one line, you cannot undo the heading element at all.
Graphics
If you insert a graphic into an entry, and then try to undo the insertion, undo does not work.
Tables
In IE 6.0, you cannot select the text in multiple cells and delete it using the Delete key. You must select the contents
of each cell and press Delete.
Domino Web Access
Server archiving in Portal UI requires Notes.INI variable
When using the Portal UI, you must set the iNotes_WA_PortalOffline=1 variable in order to use server archiving in
Domino Web Access. If this variable is not set, the Archives button does not display in a portal, even if the user has
chosen server archiving in User Preferences.
Domino Administrator Client, Domino Web Access
Setting quick links in Domino Web Access Welcome page
Currently, Domino Administrators cannot set quick links for the Domino Web Access Welcome page in the
Configuration Settings document (Domino Web Access tab).
Domino Web Access users can set quick links for the Welcome Page using the Edit Layout feature.
137
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Web Access
TAM WebSEAL 5.1 on Mozilla and Firefox displays error
When accessing IBM Tivoli Access Manager WebSEAL 5.1 on a Mozilla or Firefox based browser, the browser displays
a 404 error:
The Access Manager WebSEAL server can not find the resource you have requested.
This error means that the Access Manager WebSEAL cannot find any resource matching the requested URL:/favicon.ico
Workaround
Create an unauth ACL and attach it to favicon.ico using the pdadmin utility on the TAM server as follows:
pdadmin>
pdadmin>
pdadmin>
pdadmin>
pdadmin>
pdadmin>
pdadmin>
acl
acl
acl
acl
acl
acl
acl
create
modify
modify
modify
modify
modify
attach
unauth
unauth set group iv-admin TcmdbsvaBRrxl
unauth set group webseal-servers Tgmdbsrxl
unauth set user sec_master TcmdbsvaBRrxl
unauth set Any-other Trx
unauth set Unauthenticated Tr
/WebSEAL/TAMhostname-default/favicon.ico unauth
Domino Web Access
Unable to load Inbox in Domino Web Access
In Internet Explorer, users who are not using SSL connections to access their Domino Web Access mail database receive an "Error encountered retrieving data" message when trying to access their Inbox. An updated urlmon.dll fixes this problem. Customers can call Microsoft support free of charge to receive the fix (
http://support.microsoft.com/?kbid=837251) prior to it's inclusion within a cumulative update for IE. It will be queued up for inclusions within the next cumulative update for IE (anticipated to be May 2004).
Other workarounds include:
�
In Internet Explorer, go to Tools - Internet Options - Advanced - Security, make sure the option "Do not save
encrypted pages to disk" is unchecked.
�
Disable GZIP compression.
Domino Web Access
Use LDAP Mail attribute for Domino Web Access Instant Messaging
The Mail attribute is a required entry when using LDAP for Instant Messaging in Domino Web Access.
When using Instant Messaging in Domino Web Access to resolve names that exist in an LDAP directory server, the mail
attribute for the LDAP directory entry must include a valid e-mail address value. For example, the directory entry for
John Brown could look something like this:
dn: cn=John Brown, o=Yourorg
givenname: John
sn: Brown
mail: [email protected]
If an entry is found in the LDAP directory that does NOT contain a value for the mail attribute, the value entered will be
removed. This affects groups more than user entries, because the LDAP object classes "groupOfNames" and
"groupOfUniquenames" do not include the mail attribute. This could, however, affect entries of type "Person" and
"organizationalPerson" since these object classes do not support the mail attribute either. Most LDAP directories do
support the "inetOrgPerson" object class, and mail is an optional value of this object class. For those using Domino as
an LDAP directory server, the "dominoPerson" object class inherits from the "inetOrgPerson" object class, where mail is
supported.
For more information on creating and editing the Offline subscription Configuration Profile document, see the Domino
Administration help topic "Configuring the DOLS subscription."
138
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Installation issues
Notes Client
Continue past "File does not exist" error for Notes client
When installing the Notes Client, if you receive the error "File does not exist", click OK and continue. This may happen,
for example, with the "Create Cross Certificate" dialog during the installation.
Domino Server
Domino 7 cannot install Partition Server over Single Server
On Windows platforms, the Domino 7 installer program makes a distinction between a Single Server Installation and a
Partition Server Installation.
A Single Server installation will consist of a single Program directory, and a single Data directory. The Notes.INI file,
which contains configuration information for the server, will be stored in the Program directory. This has been
maintained in Domino 7 in order to support previous versions of the Notes/Domino server.
A Partition Server installation will consist of a single Program directory, and multiple Data directories. Because each
server has a different configuration, each server must have its own Notes.INI file. Because of this, the Notes.INI file
will be stored in the Data directory of each partition.
The Domino 7 installer does not support upgrading or reinstalling a Partition server over an existing Single server.
This is because the Notes.INI file cannot safely be relocated without making significant changes to its contents.
If a user has an existing Single server installation, and needs to replace this with a Partition server installation, then
the Single server should be Uninstalled, using the Add/Remove programs utility in Windows. Then the user must copy
the Notes.INI from the Program Directory to the Single servers Data directory. The Data files from the Single server
will be left behind in the original Data directory. Next, the user may install a new Partition server, using the same
location as the original Program Directory. The original Data directory can be selected as one of the new Partitions,
as well as other Data directories that will be created by the installer. After the Partition server installation is complete,
the original server will be one of the new Partitions installed, and should function normally.
Domino for i5/OS
Domino installation may fail when WRKDOMSVR cmd active on i5/OS
Installing Domino 7 for i5/OS may fail if a WRKDOMSVR command is being run in another session. If this occurs, an
error message in the job log indicates that the QGNNINDS object cannot be allocated. Make sure no other sessions
are running the WRKDOMSVR command, and retry the installation.
Domino for i5/OS
Domino installation may fail with signature violation on i5/OS
Domino and OS/400 signatures
When installing Domino 7 for iSeries, the installation may fail with the following error message (check the job log for
the job that issued the RSTLICPGM command):
Object has a signature that is no longer valid. This is likely the result of installing Domino to a system that has the more stringent levels of object signature
validation enabled for restore operations.
The OS/400 policy to be used for object signature verification during a restore operation (for example, product
installation) is controlled by the QVFYOBJRST system value, which has a default value of 3.
When installing Domino for iSeries, the system value QVFYOBJRST must be set to a value of 3 or lower prior to
installing Domino.
After installation of Domino for iSeries has completed, the system value may be changed back to a more restrictive
setting.
An example of changing the system value QVFYOBJRST is provided below:
CHGSYSVAL SYSVAL(QVFYOBJRST) VALUE('1')
139
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server
Installing Domino 7 on UNIX from a CD-ROM
When installing Domino 7 on any UNIX platform, be sure to follow this sequence of steps to begin the installation process:
1.
2.
3.
Create the CD-ROM directory, for example, /cdrom
Use the cd command to change to that directory.
Mount the CD-ROM drive, for example, mount /dev/dc0 /cdrom
Domino Administrator Client, Notes Client, Domino Designer
Instant Messaging Proxy Password doesn't flow through
If the user happens to select 'Use Proxy' as the Instant Messaging Protocol during a new Client Setup as well as upon
launching the Notes Client after upgrading to the latest release, and enters a Proxy Password in the dialog, the Proxy
Password will not flow through to the user's location documents. To correct this, simply edit the location documents;
go to the Instant Messaging tab, and click the 'Set Proxy Password' button. A dialog will display, allowing the user to
enter their IM Proxy password.
Domino Server
Invalid directory path value in script.dat issue
Whe using silent install on UNIX platforms, the installer cannot check the special characters (e.g., <>) in the
"Program_directory" parameter of the script.dat file. However, the installation will succeed without any error message,
even if special characters are used in the "Program_directory" parameter.
Notes Client, Domino Server
Notes/Domino 7 cannot be installed into a non-ASCII name folder
Notes/Domino 7 cannot be installed into a directory/folder with a non-ASCII name; please use an ASCII name for the
directory/folder name to install.
Domino Administrator Client, Notes Client, Domino Designer
Scriptable Client Setup and Instant Messaging configuration
Here are some known issues to be aware of when using the Scriptable Client Setup feature to configure Instant Messaging:
�
If the IM.Protocol variable is set to 3 ('Use proxy'), the IM.ProxyType variable is required. If this variable is left
out of the script, the IM Setup dialog is supposed to display during Client Setup so that the user can enter the
missing value. At this time, the dialog does not display. As a result, the user may experience connection
problems because the Proxy Type defaults to SOCKS4. To correct this, either be sure to include this variable in
the Script or ask the user to edit their location documents and update the Instant Messaging tab to reflect the
correct Proxy Type.
�
The IM.ServerNameResolve variable seems to be ignored by Scriptable Setup. The 'Resolve server name locally'
field is always enabled in the IM Setup - IM Proxy dialog whether the variable is included in the Script or not.
Despite the field being enabled in the dialog during Client Setup, it is always disabled in the location doc, except
as noted below.
�
The IM.ServerNameResolve variable acts as if it is required when the IM.ProxyType variable is set to 1
('SOCKS5'). Specifically, if a Script sets IM.ProxyType to 1 and leaves out the IM.ServerNameResolve variable
(this should be ok since the variable is optional), the IM Setup dialog will display during Client Setup so that the
user can enter the missing value. In addition, the user will find the checkbox for this field is enabled even though
the variable was not included in the script. This checkbox will remain enabled upon completion of the Client
Setup in the location document.
Domino Administrator Client, Notes Client, Domino Designer
Smart Upgrade doesn't support Full Kit install for multi-users
Smart Upgrade does not support the "Full Notes Client kit " install option for a multi-user install. The Domino Administrator must upgrade multi-user installs using the "Notes Client only kit" install option.
140
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Notes Client, Domino Designer
Threshold chgs in Replication Settings apply to current location
When setting up a Notes Client and choosing "Replication settings for sending and receiving mail" from the Additional
Services dialog, the threshold you originally enter for sending outgoing e-mail messages before you choose your
replication schedule will hold for all location documents. If you change the threshold value after you enter your
replication schedule, that new threshold value will only display in your current location document. If you'd like that
new threshold value to be in another location document, simply edit the location document and make the changes.
Domino Server
Total size in summary panel issue
When installing partitioned servers on Windows platforms, the total size in the Summary panel does not give the
correct, required disk sizes.
Domino Server
Upgrade warning message (dominoSelfRegistering) issue
When upgrading the server on Windows platforms, the warning message ". . . during the registeration of files
(dominoSelfRegistering). . ." is displayed in the final upgrade window. This warning is reproduced periodically, but the
server functions work successfully.
Domino Administrator Client, Domino Server
Upgrading to Domino 7 changes the services startup type
Upgrading from Domino 6.X or Domino 7.0 beta causes the services startup type to change if the startup type is set to
automatic. The services startup type reverts to manual after the upgrade. The services startup type is set in the
Windows service dialog box.
Domino Server
Windows server install displays security warning
On Windows machines, when you double-click 'setup.exe' to begin the install procedure for the Domino server, you will
receive the following Security warning:
Open File - Security Warning
The publisher could not be verified. Are you sure you want to run this software?
141
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notice that 'Publisher' is listed as "Unknown Publisher", and the bottom of the dialog indicates: "This file does not have
a valid digital signature. . .".
Workaround
Simply choose 'Run' to continue the installation.
Mail issues
Notes Client
'Preferences' menu option won't be available if using Notes 6
If you are using Notes 6.x to access a Notes 7 mail file on a Domino 7 server, the Tools -> Preferences menu option
will not be available.
Workaround
Upgrade your Notes Client to Notes 7, then the Tools\Preferences menu option will be available.
Notes Client
Ambiguous name dialog appears when adding followup to memo
When opening a mail item and putting it in Edit mode, then selecting Follow Up options, an ambiguous name dialog
or "group name not found" dialog may be displayed, if the person name or group name does not exist in the public or
private address book.
Notes Client
Automatic folder upgrade does not upgrade all folder styles
Automatic folder upgrade can only upgrade those folders that are supported for manual upgrade. These are:
�
Inbox
�
Trash
�
Rules
�
Alarms
�
Calendars
�
JunkMail
�
All Documents
in the Upgrade Folder dialog box.
Domino Server
Disclaimer text is dropped if angle brackets are included
When disclaimer text is enclosed in one pair of angle brackets, a few carriage returns (and no disclaimer text) are
added to email. When disclaimer text is enclosed in multiple pairs of angle brackets, all text and one pair of brackets
are dropped.
Domino Server
Linux - Internet client background color is "Black"
Sometimes, messages accessed with an IMAP internet client, such as Mozilla 1.6, Eudora 6, Outlook 2003, or OE6,
may display with the message background in black.
142
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client
Notes crash when open IMAP proxy db after disconnect RAS dialup
The Notes Client crashes when opening an IMAP proxy database, after disconnecting a RAS dialup connection.
Notes Client
Notes crashes when replicating IMAP proxy db with options
Notes crashes when IMAP users run replication with "Replication with Options" checked.
Workaround
Notes works properly when you run replication with "Replicate via background Replicator" checked, instead.
Notes Client
Preferences need to be resaved after name change
If a user turns on Message Marking to show when they are in the To and/or CC field of an email, and then has their
name changed, Tools/Preferences will need to be changed in order for the Message Marking to show again.
Notes Client
Rule folder action for QuickRule, moved rule, not refreshed
When creating a QuickRule, or when moving a rule in the Rule folder, the rules in the Rule folder may not get refreshed
properly, which may cause an issue trying to Disable/Enable, delete, or execute rules.
Workaround
Create a new rule to refresh the calendar profile, then delete it.
Domino Server
Server - IMAP "Other user's domain delimiter" Netscape setting
Attempting to use Namespace with the Netscape or Mozilla clients, you will experience a problem accessing these
folders. This is due to a problem on the clients that does not handle the Notes separators properly.
In the Server Configuration document under the 'IMAP - Public and Other User's Folders' tab you will find a field
named; the "Other user's domain delimiter" field. Please insert any character except "/"; we would suggest using the
"|" character.
Notes Client
Servers not in DST time give errors on iCal repeat meetings
When Server A has Daylight Savings Time (DST) enabled, and Server B does not have DST enabled, but both servers
are in the same timezone, and a repeating event is scheduled and countered, the message "Error trying to open
document: The repeating instance document corresponding to this notice cannot be located" is received.
This only happens when sending to an internet address (iCal). The fix is to have both servers observe DST when in the
same timezone.
Notes Client
Webmail: Preference setting in mail delegation not updated
If you use a web client to open, update, and save a mail delegation with 'Tools -> Preferences', upon reopening the
mail delegation preferences the setting will not have been updated. This is a third-party refresh issue.
Workaround
Reopen another web client and the new setting will be displayed.
143
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client
"Forward notices . . ." from a local replica doesn't work
Setting up the "Forward notices where you are the invitee of meeting" or "Forward notices where you are the chair of
meeting" preferences by using 'Tools -> Preferences -> Access & Delegation', and then selecting the "Change Access"
button, from a local replica of a mail file does not work.
Workaround
Refresh the profile caching from mail server:
1. Open Preferences on the mail server, turn off "Forward notices where you are the invitee of meeting" and "Forward
notices where you are the chair of meeting", then turn them both on again.
Policy issues
Domino Administrator Client
'Default Welcome Page' field becomes blank
The 'Default Welcome Page' field in the Desktop Settings form of the Domino Directory may sometimes become blank.
To correct this, put the Desktop Settings document in Edit mode, click the 'Corporate Welcome Pages database' link
in the field above, and cycle through each custom Welcome Page to refresh the list. Save & Close the Desktop
Settings document.
Now, open the Desktop Settings document in Edit mode again and the 'Default Welcome Page' field will display the list
of custom welcome pages available in the database.
Domino Administrator Client, Domino Server
Delete Policies and Settings from previous releases
If you created Policies or Settings in an earlier release of Domino 6, you must delete them from the Domino Directory
before updating the Domino Directory design with the Domino 6 template or later.
Domino Administrator Client, Notes Client, Domino Designer
Desktop Policies: customized My Work page on pre-6.5 Clients
The "My Work" Welcome page in Notes feature is for a Notes/Domino 6.5 later environment. When deploying a
customized My Work page via Desktop Policies, the My Work page will not display on pre-6.5 Notes Clients. Instead,
the default 'Basics' Welcome Page will display on these Clients.
Domino Administrator Client, Notes Client, Domino Designer
Desktop Settings and 'Accounts' tab
Some Desktop Settings may require authentication with the mail server multiple times, and several Notes Client
exit/relaunches before displaying on the Notes Client. This can occur if the Desktop Settings document contains no
values on the "Account" tab, or if the accounts being deployed do not generate an error message upon completion of a
new Client Setup.
For example, creating new accounts via Policies can sometimes result in an error message if the server is not
available, or if network login information is required to access the account (please reference the release note entitled
"'IMAP4 Server Error' when deploying Policies to Notes Client"). It has been found that if the user does not encounter
an error message on creation of a new account deployed via Policies, most other settings from the Policy will require
many authentications with the mail server before displaying on the Notes Client.
144
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server
Mail policy settings documents
When you create and save both a new Policy document and a new Mail policy settings document, the new Mail policy
settings document does not display as a selection choice in the Select Keywords dialog box.
Domino Administrator Client, Notes Client, Domino Designer
Setup fails if Policy doc was edited by Admin w/ removed access
Users cannot complete the Notes client setup if the Settings/Policy document was edited by a person whose access
has been subsequently removed. They will see the following error message:
The policy and/or settings document assigned to you has been edited by an unauthorized person. Please notify
your Administrator that you cannot proceed with the client setup.
Clicking "OK" at this point will exit the Notes client without completing the client setup.
You can fix this problem yourself by adding the following value to the Notes.INI file :
Setup=700005
The Notes client setup will no longer look for a policy document and will allow the setup to complete.
Domino Administrator Client, Notes Client, Domino Designer
Setup Policies not supported for Roaming Users
Setup Policies are not supported for Roaming Users. You'll find that if a Roaming User with an assigned Setup Policy
performs a new client setup, most of the Policy settings will not display on the Client. This occurs because the Policy
settings are copied down to the client upon completion of the new client setup and then replication of the roaming
databases occurs. Since the majority of Policy settings are stored in the roaming databases, replication of the
existing roaming databases overwrites the newly copied-down Policy settings.
To work around this issue for Roaming Users, simply use Desktop Policies, which contain all of the same fields as the
Setup Policies.
Domino Administrator Client, Notes Client, Domino Designer
Setup Profiles, Setup Settings & Bookmark creation
When using the R5 Setup Profiles feature or the Setup Settings feature, it is likely that bookmarks will not be created
on the Notes Client for database links in the Setup Profile or Setup Settings document if the server on which the
database is located is not running when the user performs their initial Client Setup. If the server is launched at a later time,
the bookmarks may still not be created on the user's Notes Client.
One workaround for this would be to include critical bookmark links in a Desktop Settings document, which will refresh
on the Client once the server comes back up.
Domino Administrator Client, Notes Client, Domino Designer
Setup/Desktop Policies: need to exit & re-launch Notes Client
There are some field values from the Setup & Desktop Settings documents that will not display on the Notes Client
until the next session in Notes. These include most User Preference settings and may include Bookmarks and/or a
Custom Welcome Page. If these settings don't display after an initial Client Setup or authentication with the mail
server, try exiting and then re-launching the Notes Client; the settings should now display.
This occurs because certain settings are stored in cache upon launching the Notes Client. Changes to the field values
are not reflected until the Notes Client is exited & then re-launched.
145
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Notes Client, Domino Designer
Setup/Desktop Policies: no Bookmarks, Welcome Page/Workplace
In some cases, it's possible that a user who is assigned both a Setup Policy & a Desktop Policy will not receive the
bookmarks from the Desktop Policy or a custom Welcome Page/Workplace when they perform a new client setup.
If a user reports this problem, simply make a small change to the Desktop Policy, then save & close the Policy
document. When the user next authenticates, the bookmarks & custom Welcome Page/Workplace should flow down
to the Notes Client and display correctly.
Printing issues
Domino Web Access
Multi-page mail doesn't print properly in Internet Explorer
When printing a multi-page mail message from Internet Explorer 5.5, only the first page prints. Microsoft patch
Q810847 fixes this problem.
Programming issues
Domino for i5/OS
DXL/XSL issues on i5/OS
There are two issues pending against the DXL/XSL functions of Domino 7, and these features are not available with the
current release of Domino 7 on the i5/OS platform. The two issues are:
�
An "XSL transform operation failed" error (#4604) was raised in the DXL test harness
�
Agents created by the R6 DXLImporter crash when run on Domino 7 for i5/OS
Notes Client, Domino Designer, Domino Server
Long formula language expression can cause stack overflow
If a long formula expression is executed, excessive recursion can occur, which will cause a stack overflow and crash
the Notes Client or Domino Server. To date, this has only been seen on the AIX platform, but applies to other
platforms as well. An example of a formula which will cause this kind of problems is:
MyListOfCodes := "code1" : "code2" : "code3" : "code4" : "code5" : "code6" : ... : "code892" : "code893";
which is a long list of strings. The number of elements that makes the expression "too long" is platform and system
dependent, but a good rule of thumb is to keep the number of operands below 500. A workaround is to use smaller
expressions, store intermediate results, and then use the intermediate results in a final expression:
MyList1 := "code1" : "code2" : "code3" : "code4" : "code5" : "code6" ... "code488" : "Code 489";
MyList2 := "Code490" : "code491" : "Code492" : "Code493" ... "Code892" : "code893":
MyListOfCode := MyList1 : MyList2;
If you have an application which is crashing due to this problem, then in your Notes.ini file set
FORMULA_STACKLOWCHK=1. This is currently only implemented for AIX, but will likely expand to other platforms as
needed. This will cause the formula runtime engine to check for an impending stack overflow, and will abort the
formula evaluation if an overflow is imminent. This will prevent Notes/Domino from crashing, but the formula will
return an error. You should use @IsError to check if your formula evaluted to completion.
146
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client, Domino Server
NotesDocument.CreateMIMEEntity() can result in error
NotesDocument.CreateMIMEEntity() (and the corresponding Java call) can result in a "Note item not found" error when
the document has no items. For example:
Set doc = db.CreateDocument
Set body = doc.CreateMIMEEntity
would trigger the error since the new document has no items.
The workaround is to introduce to the document an arbitrary item before the CreateMIMEEntity call. For example:
Set doc = db.CreateDocument
Call doc.ReplaceItemValue("xyz", "123")
Set body = doc.CreateMIMEEntity
The exact item name and value does not matter.
Notes Client, Domino Server
Recompiling Visual Basic programs that use backend COM APIs
Starting with Notes/Domino 6.0.3/6.5, some Microsoft Visual Basic language applications built using the
Notes 5.x COM interfaces for backend classes would not run properly without recompiling, using the
6.0.3/6.5 domobj type library. This was fixed for Notes/Domino versions 6.5.3 and 6.0.5, however, the fix
necessitates that applications still compiled with the 6.0.3/6.5 domobj type library (or later, if prior to
6.5.3 or 6.0.5) be recompiled for 6.5.3, 6.0.5 or later. Thereafter and with subsequent Notes/Domino
releases, recompilation should not be necessary.
Notes Client, Domino Designer, Domino Server
XML parsing and Transformation Engines for Java
In previous releases, Notes/Domino provided a version of the XML Parser called XML4j.jar, and a version of the XSL
Transformation Engine called LotusXSL.jar. These libraries no longer ship with Notes/Domino because newer versions
of these engines are now part of the Java 2 Platform, Standard Edition.
The Java 2 Platform, Standard Edition, as it ships with Notes/Domino, has built-in facilities for handling XML data.
For information on these facilities, see the javadocs provided with the installation kit; they are located in the
Notes/Domino program directory, in the zip-compressed file called javadocs.zip.
The starting page in the javadocs about handling XML data in the Java 2 Platform is the file guide\xml\index.html.
Alternatively, the starting point for the complete Java documentation is in the file index.html.
Additional Notes
Some customer applications written in Domino R5 or Domino 6 had been written to use more recent versions of the
XML Parser or XSLT Transformation engines than the ones that Notes/Domino provided. This was typically achieved
by downloading a more current version of xerces.jar from apache.org and including it with the Java Agent project or
Java Script Library. In many cases this will cause no problems in ND7, but it should be noted that including your own
copy of xerces.jar in your agent or script library is no longer necessary and removing this large jar file will improve
agent startup time.
In some applications, including xerces.jar in your agent/script library will cause the agent to fail with the error:
"Java.lang.VerifyError:Incompatible object argument for method call".
The reason for this problem is that the application was coded to create the parser class in a manner that is not
forward compatible. Here is an example of an application that is written to parse an XML stream in a non-forward
compatible manner. The problem is that the org.apache.xerces.parsers.SAXParser class is private to xerces.jar and is
likely to change with every version of xerces.jar.
147
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Sample Java code to create a SAX parser in a forward incompatible manner
import org.xml.sax.InputSource;
import java.io.InputStream;
public class test
{
void parse(InputStream stream)
throws Exception
{
org.apache.xerces.parsers.SAXParser parser = new org.apache.xerces.parsers.SAXParser();
parser.setContentHandler(engine);
parser.setErrorHandler(engine);
parser.setFeature("http://xml.org/sax/features/validation", false);
parser.setFeature("
http://apache.org/xml/features/continue-after-fatal-error", false);
parser.parse(new InputSource(stream));
// ....
}
}
The better way to create a parser that does not make your application dependant on a specific version of xerces.jar is
to use the org.xml.sax.XMLReader interface class. For example:
import org.xml.sax.InputSource;
import java.io.InputStream;
public class sample
{
void parse(InputStream stream)
throws Exception
{
org.xml.sax.XMLReader parser = new org.apache.xerces.parsers.SAXParser();
parser.setContentHandler(engine);
parser.setErrorHandler(engine);
parser.setFeature("http://xml.org/sax/features/validation", false);
parser.setFeature("
http://apache.org/xml/features/continue-after-fatal-error", false);
parser.parse(new InputSource(stream));
// ...
}
}
Another alternative that works without directly naming the name of the SAX parser class is to use the
XMLReaderFactory class to create the XMLReader. It works by reading the system property named "org.xml.sax.driver"
and will create an instance of the parser named. In ND7 the following statement creates the same parser class as the
one in the previous example, but it provides the option to change the parser without changing any code:
org.xml.sax.XMLReader parser = org.xml.sax.helpers.XMLReaderFactory.createXMLReader();
Notes Client, Domino Designer
@Contains does not work properly with DBCS containing nulls
If @Contains is used with DBCS, and either the source or search string contains an embedded null, and the source
and search string contain DBCS characters that are the same character but with different code points, then the results
will be incorrect. What happens is that when dealing with DBCS strings, the formula engine converts the strings to
Unicode before processing the @Contains. An embedded null (generated by @Char(0) in Formula Language) is
treated as a string terminator within the Unicode string. If either the source or search string argument to @Contains
has an embedded null in this situation, they will be treated as terminating just before the null byte is encountered.
However, @Contains uses a simple algorithm before it converts to Unicode. It does a simple byte-by-byte compare of
the search string within the source string argument. So even in the presence of DBCS, if all the equivalent multi-byte
characters in the search and source strings have the same code point (in LMBCS, the character set used internally by
Notes/Domino) then @Contains will function correctly.
148
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Replication issues
Notes Client
Cannot set replication schedule from Replicator page
Users are unable to set the replication schedule from the Replication page (Next Replication -> Set Replication
Schedule from the drop down menu).
Workaround
Users can edit the replication schedule by editing their location and choosing the Replication tab.
Roaming User issues
Domino Administrator Client, Notes Client, Domino Designer
Other databases replicated using 'Send data to servers' prompt
The Roaming user prompt "Send data to servers" replicates all databases in the replication page when shutting down
the Notes client, not just the roaming databases.
Domino Administrator Client, Notes Client, Domino Designer
Replication on launch/exit remains enabled on Roaming downgrade
When a user is downgraded from a Roaming User to non-Roaming, the replication on launch and exit of the Notes
Client feature remains enabled. This occurs even if there are no databases on the user's replicator page.
To correct this, simply edit the location document and disable the replication on launch and exit features. The user
will no longer be prompted to update the server when exiting the Notes Client.
Domino Administrator Client, Notes Client, Domino Designer
Roaming Downgrade fails to remove databases from Replicator Page
In some instances, a Roaming User Downgrade will fail to remove the Roaming databases from the user's Replicator
Page. As a result, replication for these databases will fail because the databases have been deleted from the server.
To work around this, simply delete the entries from the Replicator Page. Also, if the user has no other databases on
their Replicator Page, they may choose to edit their location document and disable the replication on launch and exit
features.
This seems to occur for users who set up their Notes Client as a Roaming User and are later downgraded from
Roaming. If the user upgraded to Roaming on the Notes Client, the Roaming databases are successfully removed
from the Replicator Page.
Domino Administrator Client, Notes Client, Domino Designer
Roaming Downgrade fails to remove databases from Replicator Page
In some instances, a Roaming User Downgrade will fail to remove the Roaming databases from the user's Replicator
Page. As a result, replication for these databases will fail because the databases have been deleted from the server.
To work around this, simply delete the entries from the Replicator Page. Also, if the user has no other databases on
their Replicator Page, they may choose to edit their location document and disable the replication on launch and exit
features.
This seems to occur for users who set up their Notes Client as a Roaming User and are later Downgraded from
Roaming. If the user upgraded to Roaming on the Notes Client, the Roaming databases are successfully removed
from the Replicator Page.
149
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Notes Client, Domino Designer
Roaming User Client setup - 'Connection denied' message
If a Roaming User performs a new Client Setup and their Domino Server requires additional information to connect
during Setup, they may receive this error: Connection denied. You requested server x.xx.xxx.xxx but connected to
<servername/domain>. In this scenario, the IP address in the message is correct for the named server, but an error
is being generated. Simply click 'OK' at the message and Notes Setup will complete without further errors.
Domino Administrator Client, Notes Client, Domino Designer
Roaming User Client Setup that requires server connection doc
If the Notes Client requires a connection document to access the Roaming server, the user may receive replication
error messages during a new Client Setup. Specifically, once the user has selected the default location, the following
errors may display:
�
�
Connection denied. You requested server x.xx.xxx.xxx but connected to <servername/domain>
�
�
The server is not responding. The server may be down or you may be experiencing network problems. Contact your
system administrator if this problem persists
Simply click 'OK' at both error messages and Setup will complete.
The user may also notice that replication on launch also fails with the same error. If this occurs, simply open the mail
file, go back to the Replicator Page, and click 'Start Now' to manually replicate the databases. Replication should be
successful from this point forward. This is a one time problem, on a new Client Setup.
To avoid this problem, the user can enter the server's IP address, instead of the Domino server name during Client
Setup. This will direct the Client more clearly to the user's server.
Domino Administrator Client, Notes Client, Domino Designer
Roaming User Client setup & Instant Messaging configuration
Notes 6.5 introduced the IM Setup dialog in Client Setup that allows users to configure Instant Messaging for use
within their Notes Client. A newly registered Roaming User will see the IM Setup dialog when they perform their first
Notes Client Install/Setup. In addition, when a Roaming User upgrades their existing Notes Client, they will also see
the IM Setup dialog.
However, for Notes7.0, if a Roaming User performs a new Client Install/Setup (subsequent client setup), they will
never see this dialog. This is working as designed because the user's IM configuration will roam via their personal
address book. Just as the Additional Options dialog does not display in this scenario, the IM Setup dialog will not
display.
Domino Administrator Client, Notes Client, Domino Designer
Roaming User Upgrade: User says 'No', remains In Progress
Once the Administrator initiates a Roaming User Upgrade, the user's Roaming status ('user can roam' field on
Roaming tab of person document) is changed to In Progress. This status will be automatically updated to 'Yes' once
the user has upgraded at least one Notes Client to Roaming. However, if the user never upgrades any of their Notes
Clients, their Roaming status will remain in the 'In Progress' status indefinitely. There are two courses of action to
change their Roaming status:
1. Ask the user to perform a new Notes Client install and run through the Client Setup process: if the user installs
a new Notes Client on their system and launches the Client into Setup, they will be prompted to upgrade to
Roaming at the end of Setup. The user should select 'Yes' at this time, which will move the Upgrade process
forward and update their Roaming status to 'Yes'. The down side to this solution is that the user must re-create
their bookmarks, re-populate their personal address book, and reset any user preferences they had in place on
their other Notes Client. But once these settings are restored, they will Roam to the user's other Notes Clients.
2. Administrator initiates a Roaming Downgrade and then re-initiates the Roaming Upgrade: if the Administrator
initiates a Roaming User Downgrade, the user's Roaming status will be changed to No. The Administrator can
then initiate a Roaming Upgrade for the user, which will set the user's Roaming status to In Progress. Once the
user accepts the request to upgrade, their Roaming status will be changed to Yes.
150
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Notes Client, Domino Designer
Roaming Users should replace design of Personal Address Book
Once a Roaming User has upgraded their Notes Client to the new release, they should replace design on their
Personal Address Book database. There are design changes to the database and these are not automatically updated.
In particular, as of Notes 6.5, there is a new IM Setup dialog in Client Setup that allows users to configure Instant
Messaging for use within their Notes Client. A newly registered Roaming User will see the IM Setup dialog when they
perform their 1st Notes Client Install/Setup. In addition, when a Roaming User upgrades their existing Notes Client,
they will also see the IM Setup dialog. The IM configuration settings from this dialog are stored on the Instant
Messaging tab in the location documents in the Personal Address Book. The user must replace design on their
Personal Address Book database in order to see this new tab.
Domino Administrator Client, Notes Client, Domino Designer
Roaming Users & IM Server connection: no simultaneous connection
Roaming Users and multiple machine users can only connect to a Sametime server from one machine at a time.
Logging on to a second machine will boot the user off of the other.
Search issues
Domino Administrator Client, Domino Server
'Using LDAP to search a Domain index' is not available
The Lotus Domino Administrator 7 on-line Help includes a topic titled "Using LDAP to search a Domain index". This
feature is not working at the time of this release.
Notes Client
Arabic character highlighting not supported in Notes client
In the current release, the Notes 7 client does not support Arabic character highlighting through Text Effects.
Notes Client, Domino Server
Avoid full-text indexing error caused by failed IO operation
IO retry facilities have been implemented, which help prevent errors experienced by GTR indexing and failed IO
routines, perhaps caused by third-party anti-virus facilities. When attempting to rename a file or subdirectory, or
attempting to delete a file or subdirectory, the IO operation re-attempts for up to 2 minutes. Once 2 minutes have
elapsed, and if the operation is still unsuccessful, then an error condition will be raised.
If 2 minutes (the default retry time) is not sufficient, use FTG_IO_RETRY=xx to change the IO retry delay, anywhere
from 0 seconds (the minimum value) to 600 seconds (or 10 minutes, the maximum value). It is not acceptable for the
IO retry mechanism to be unbounded.
A default limit of 2 minutes is adequate for both server and client implementations. Specifically, these facilities
resolve GTR\IO errors: errcode = 2304 and errcode = 1806.
151
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Notes Client, Domino Server
File system deletion error in catalog.nsf
If the Domino Server has several file systems on the same machine, when deleting one or more file systems from the
Domain Catalog, administrators will sometimes encounter the error:
The file system which should be deleted still exists in Domain Index view
and the corresponding IDX folder does not get deleted. Additionally, some folders which should remain in the Domain
Index will be incorrectly removed; when the domain indexer task runs, the index error messages will appear on the
console.
To correct the corrupted Domain Catalog and Index, the incorrect entries in the Domain Catalog must be removed and
the Domain Index rebuilt:
1. In the Domain Catalog, recreate the file system entries which should not be removed.
2. Go to the Domain Index view, and delete the file systems which should not exist in the catalog.
3. Rebuild the Domain Index by running the tell domidx quit, load domidx -d, and load domidx -s
commands.
4. Restart the server.
Domino Server
File types not supported by Verity Keyview Filters 7.4.21
File types listed below are not supported by Verity Keyview Filters Version 7.4.21:
�
Lotus Word Pro on UNIX/Linux
�
Amipro on UNIX/Linux
�
Computer Graphics Metafile (CGM) (Windows/UNIX/Linux)
�
MIME (Windows/UNIX/Linux)
�
BMP (Windows/UNIX/Linux)
Domino Administrator Client, Domino Server
First time creating the file system
When creating the file system for the first time from the "Files" panel of the Administrator Client, the error message
"Cannot process this command. One of the parameters is incorrect" will appear.
To solve this issue, the user needs to open the catalog.nsf database from the Notes Client, and add the correct entries
in the File System view.
Domino Administrator Client, Notes Client, Domino Designer
Help may need new full-text index after multiple upgrades
If you've clicked the Search button in any earlier version of the Help databases and you upgrade to Domino 7,
overwriting the previous Help databases, you may see the error message "The full text index needs to be rebuilt" the
next time you open Help and click Search.
To rebuild the index:
1. Click OK to close the error message dialog box.
2. While in the Search view in Help, click the small black triangle at the right edge of the search bar to show more
options.
3. Click the "Update Index" button (maximize the Help window if you can't see it), and click OK in the next dialog
box.
4. Before searching, wait until the status bar shows a message saying that indexing is finished, and the circle in the
search bar turns green with the word "Indexed" next to it.
152
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client, Domino Server
Improve full-text search performance and memory usage
You can improve performance when performing full-text searches on large databases, and possibly prevent "full text
memory allocation error = 3301", particularly on large databases with many unique, numeric fields.
To optimize full-text indexing and search settings, implement the following notes.ini entries in step-by-step order of
implementation\verification, followed by server restart:
1.
2.
3.
FTG_DISABLE_PAGING=1
FTG_SET_INITIAL_BUFLEN=7000 (or 6000, or 5000)
FTG_USE_SYS_MEMORY=1
Domino Server
Manually loading domain index need quit the scheduled task
If choosing to run "Domain indexer" manually, you must first run the "tell domidx quit" command, and then the "load
domidx -s" command, which prevents a "scheduled" domain-indexer from competing with a "forced or non-scheduled"
domain indexer.
If rebuilding the Domain Index is required, the scheduled "Domain indexer" also needs to be quit first, following the
steps below:
1. Stop the domain indexer using the command: tell domidx q
2. Delete the indexes using the command: load domidx -d
3. Use a Notes client to delete the documents under the view "Domain Indexer Status\by Indexing Server" from
catalog.nsf.
4. Reload the domain indexer to rebuild the index file using the command (to rebuild the Domain Search index
immediately): load domidx -s
5. Restart server.
Domino Web Access
Multiple words can not be highlighted from a web browser
Multiple word highlights are not supported by web browsers. Although combining the single word searches following
the search syntax can be an alternative, the number of returned documents will most likely increase. For example:
From a web browser, search the character string "highlight words" - the document which contains this string can be
found in results, but the "highlight words" string can not be highlighted.
If you want to receive a highlight result, using "highlight" and "words" as a combined search string; the string can be
highlighted in the results, but the number of result entries may be more than in the first instance.
Domino Administrator Client, Domino Server
Notes error with report when reports.nsf is full-text indexed
When the Reports database (reports.nsf) is full-text indexed, administrators might see one of two behaviors when
running a report once (Run this report = Once). An error such as "Notes error: No document found" or
blank/incomplete results will be observed.
To avoid this, delete the index of the database, or simply run the report through the Domino Web Administrator.
Scheduled reports should not be affected.
Notes Client, Domino Server
OLE attachment search doesn't support Asian languages well
Performing searches on Chinese characters in the MS Office library will fail if the document properties contain the
fields "$OLEObjField" and "$OLEObjRichTextField".
This a software limitation. The GTR engine does not support OLE, especially for Asian languages, well.
153
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client, Domino Server
Preventing a full-text indexing GTR crash during a GTR merge
There is a facility that identifies bad record data in GTR KeyFiles during merging operations from a supplemental index or during merging into a main index. This facility is off by default.
Use FTG_ENABLE_GTR_KEY_CHECK=1 to enable this facility. In notes.ini, bad key records are identified with errcode=2247, errcode=2248, errcode=2249, errcode=2250, and errcode=2251, and a crash is avoided.
Notes Client, Domino Server
Search CJK character strings in Text field
If an Asian language search string in the Text field of a document contains a carriage return or word wrapping, the
search will fail to find the correct document. In Notes Domino 7, the GTR engine can not find the first Asian character
after a carriage return in a Text field.
Notes Client
Search query troubleshooting and limitations
Following are the issues related to full-text searching in Notes/Domino 7:
�
NOT queries must be correctly formatted; in the example below, the NOT (!) operator is ignored:
Incorrect format: [body] ! director
The correct format for this query is: NOT ([body] contains (director))
�
You may experience problems searching in the Names and Address Book database. Performing a "fielded"
search, using the wildcard option with the singular letters A through F, may not return all valid search results.
This is a Search Engine software limitation.
Example: FIELD lastname CONTAINS A*
Workaround
Increase the number for letters, before the wildcard character (*), to 2 letters.
�
Error "Query is not understandable" may be given if the search query is created with a Query "condition" and any
string, but without space between the two. The Search Engine can process a query using the operator symbols
(!&,|) without spaces between query words and the operator symbols. However, when using a Query Condition
Token (instead of a text string), the query requires a space between the operator symbol and the second text
string.
Workaround
Insert a space between the query parts.
�
Documents are not found when the search query is formatted like: word1.<space>word2 (<space> means that
the 'space bar' was pressed).
Workaround
Surround the query with double quotation marks: "word1.<space>word2"
�
The ACCRUE operator fails when the query is complex. The ACCRUE operator doesn't return the correct relevance
order if the query includes additional search parts. This is a search engine limitation, it does not honor
precedence set by parenthesis.
Example of problem query: (word1) AND (word2 ACCRUE word3 ACCRUE word4 ACCRUE word5)
�
The Search Engine does not support the Macintosh 10000 Code page.
154
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Server
Setting a character set for full-text indexing plain-text files
The Domino server uses the Verity KeyView filter for retrieving content from binary attachments. The KeyView filter
takes care of character set information of each binary attachment file, so that Domino full-text indexes binary
attachment files, regardless of a locale configuration. This, however, is not the case for plain-text files, because a
plain-text file has no character set information. The Domino server handles plain-text files under the assumption that
they are written in the character set that is the same as the character set of the current locale of the server.
You can check the current locale of the Domino server by entering "show locale" at the console; the response would be
something like this:
Region:
en-US [English(United States)]
Collation: en [Latin1]
CSID:
52(Hex)
NOTE: Domino uses the CSID value to determine the character set of Text Attachments files
When the character set of a text file you want to full-text search is different from that of the server, full-text search does
not work. You can avoid this problem by explicitly setting FT_KVCS_UNKNOWN_CSID=CharacterSetVal in the Notes.INI
file. FT_KVCS_UNKNOWN_CSID overrides the character set value that Domino server uses for handling plain-text files.
For example, if you want to full-text search plain-text files written in Shift_JIS (a Japanese character set) on 'C' locale,
you set FT_KVCS_UNKNOWN_CSID=12 in the Domino server's Notes.INI file.
The following table shows the CSID values for some of the Windows code-pages:
Windows Code-Page ID
874
932
936
937
949
1250
1251
1252
1253
1254
1255
1256
1257
Language
Thai
Japanese
Chinese (People's Republic of China,
Singapore)
Chinese (Taiwan)
Korean
Eastern European
Cyrillic
Western European
Greek
Turkish
Hebrew
Arabic
Baltic
CSID
90
12
1B
1A
18
50
51
52
53
54
55
56
57
The document "Setting up Domino on Linux for non-'C' locales", located in the 'Things you need to know - Installation'
section lists other CSID values that you can use for the variable CharacterSetVal.
Notes Client, Domino Server
Syntax: [<fieldname>] IS PRESENT
The search for date/time and number type field names are not supported with the syntax: [<fieldname>] IS PRESENT.
If searching these two types of field name, you will get a message "Query is not understandable: ([Date/Time] IS
PRESENT)" or "Query is not understandable: ([Number] IS PRESENT)"
Notes Client, Domino Server
To eliminate highlight \ attachment re-filtering
To disable attachment filtering during highlight processing (i.e., when a document is opened), set the variable:
FT_LIMIT_HIGHLIGHT_FILTER=###
where ### represents the size of files to be excluded from attachments or highlight filtering
If set to FT_LIMIT_HIGHLIGHT_FILTER=1, then no file will be re-filtered upon search and highlight document open.
If set to FT_LIMIT_HIGHLIGHT_FILTER=1000000, then files 1000000 bytes or larger will skip highlight re-filtering.
155
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Notes Client, Domino Server
Uncleared Search results if document is left opened
Search results are not cleared if a document from a database is left open while the database is closed and
re-opened. This issue occurs when the sort option is set to "Keep Current Order" or "Show all documents".
This issue applies to full-text searching of Server databases only.
Domino Server
Verity Keyview Filter Support switches off/on for z/OS
Domino 7 for z/OS uses the Verity Keyview filter for retrieving text from binary attachments.
To enable this feature, a database has to be full-text indexed with the option to index binary attachments. Indexing
attachments as raw text will continue to operate as before, and does not use the Keyview filter. The Keyview filter can
be enabled or disabled for the entire server by specifying the Notes.INI setting of
FT_BINARY_FILTER_OFF
A value of FT_BINARY_FILTER_OFF=0, or no setting present in the Notes.INI file, indicates that Keyview filter will be
used, and is the default setting. A value of FT_BINARY_FILTER_OFF=1 indicates Keyview filter will not be used.
This Notes.INI setting allows administrators to shut off the filter without having to change the indexing options on all
databases that have the binary attachment option turned on.
Domino Server, Domino for z/OS
z/OS HFS expand option for full-text indexes
The Full Text Index function automatically extends the size of the file system being indexed rather than immediately
failing the request when the existing file system size is insufficient. This feature does not apply to z/FS file systems.
To enable this function, specify the following in notes.ini:
OS390_EXPANDHFS_ENABLE=1
When OS390_EXPANDHFS_ENABLE is enabled in notes.ini, an attempt is made to expand the file system in the same
volume. If this fails and the following notes.ini is also set, then there is a second attempt to expand the file system
into additional volumes. Expands into additional volumes are successful only if the file system was defined as a multi
volume HFS.
OS390_EXPAND_NEXT_VOL = 1
Each time a file system is successfully expanded, the following is an example of what the Domino server console
displays:
02/22/2002 08:21:46 PM OS390_EXPANDHFS_ENABLE=1 successfully expanded file-system-name fornn Megabytes
If running on z/FS, the following error message that will be displayed because BPX1PCT pfsctl() does not support the
extend file system command on z/FS.
Error Expand File System Failed errno = 134 errno2 = 11B300BA "EDC5134I
Function not implemented."
02/22/2002 08:14:54 PM OS390_EXPANDHFS_ENABLE=1 Failure to expand file system
file-system-name for nn Megabytes
If an attempt is made to expand a file system with no more space left on the device (volume or multiple volumes), the
following is an example of what the Domino server console displays:
Error Expand File System Failed errno = 133 errno2 = 5B27C005 "EDC5133I No space left on device."
02/22/2002 08:21:46 PM OS390_EXPANDHFS_ENABLE=1 Failure to expand file system file-system-name for nn Megabytes
156
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
If an attempt is made to expand a file system that does not exist, the following is an example of what the Domino
server console displays:
Error Expand File System Failed errno = 129 errno2 = 05F1006C "EDC5129I No
such file or directory."
02/22/2002 08:21:46 PM OS390_EXPANDHFS_ENABLE=1 Failure to expand file system
file-system-name for nn Megabytes
Notes Client, Domino Server
"Word variant" searches - i.e., "stemming"
The purpose of "word variance" or "stemming" is to determine the "root" word from a constructed word and its suffixes.
As an example, the root word of "settlement" is "settle". The suffixes of the word are first inspected, and then
truncated. These suffixes are:
"S", "ED", "ING", "ER", "OR", "ERS", "ORS", "ION", "IVE", "ABLE", "ABLED", and "MENT"
All joined suffixes will be eliminated, for example "inger" will be removed because both "ER" and "ING" are suffixes.
Once the suffixes have been eliminated, further letters will be eliminated, depending on vowel and consonant ordering.
Double consonants of the same letter will be eliminated; for example, "hammer" will eliminate the "er" suffix and
then the trailing "m".
Other characters\suffixes which may possibly be removed are "Y" preceded by a consonant, for example, "candy", which would also resolve to "candies" because first the "s" suffix is first removed and then the "ie" is removed because it
is preceded by a consonant.
The "Word variant" search only applies to English searches (i.e., all characters in the search MUST be
less than hex 0x7B). If any character (as entered in the search bar) does not meet this criterion, then a "word variant" search will not occur; the search will proceed with no stemming taking place.
Security issues
Domino Administrator Client, Domino Server
MIME - Body of message is blank on received encrypted message
The body of MIME-encrypted messages are occasionally blank upon receipt. This may occur because groups in the
Directory Catalog are not expanded, so the editor does not create a MIME body part.
Workaround
Copy the group from the Domino Directory to your Personal Name and Address Book, so that names associated with
the group are available.
Domino Administrator Client, Domino Server
Browser caching can interfere with revocation checking
When configuring a browser to check CRLs for server certificates, be aware that the browser's caching of web pages
can make it appear that a server whose certificate has been revoked can still be accessed securely. Flushing or
disabling the browser's cache will force the browser to contact the server and re-check its revocation status.
157
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server
Benign Internet Explorer error message
Error messages that look like this
handshake failure, IP address [9.99.99.999], Keyring [R6keyfile.kyr], [SSL Error: Network IO error], code [4165]
are produced in many benign circumstances, especially by Microsoft Internet Explorer. The most frequent
circumstance is when IE drops an SSL connection and then resumes it. The error is generated even though there is no
apparent interruption percieved by the client.
Notes Client, Domino Server
Calculation of password warning date
The Domino 7 Adminstrator Help topic 'Verifying user passwords during authentication' states that the calculation
used to determine when users should be prompted that their password is going to expire is two-thirds of the current
change interval, or a minimum of two days remaining. This is not correct. The following formula determines when
users receive a password expiration warning :
Expiration Date=(Last Change Date + Change Interval) and IF (Expiration Date - Todays Date) < (25% of change
Interval)
Domino Administrator Client, Domino Server
Creating a Certificate Authority db requires adding Role to ACL
When an Administrator user attempts to create a new Certificate Authority database using the cca50.ntf database,
they will receive the following error message:
"You are not authorized to perform that operation: <servername database name>"
This occurs because the template for the Certificate Authority database, cca50.ntf, does not contain sufficient Access
Control information to allow any user to create a Certificate Authority database. The templates ACL must first be
edited by a User with Administrator privileges in order to permit this. Follow these steps to enable the cca50.ntf
template for creating a Certificate Authority database:
1) Log into a client as a user with Administrator privileges on the server.
2) Select File-> Database-> Open to open a database.
3) In the Open database dialogue, select the cca50.ntf file on the server (you will have to type in the filename, since
template are not listed).
4) In the opened template, select File-> Database -> Access Control.
5) In the ACL dialogue, select the user that you want to be able to create a Certificate Authority database.
6) In the Roles section, check the checkbox for "CAPrivilegedUser".
7) Click OK and exit the dialogue. Then exit the template.
The user for which the Role was selected in the template will now be able to create a Certificate Authority database.
Notes Client
Import Internet cert status from Smartcard is not updating
After you import an Internet certificate from a Smartcard, the new Internet certificate does not show up in the "Your
Internet Certificates" list box in the User Security dialog box.
Workaround
If you close the User Security dialog box and re-open it, you will see the newly imported certificate.
158
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server
Internet Site documents require IP address only for SSL
When you create an Internet Site document on a Domino server for an Internet protocol, you specify a host or DNS name in the field "Host name or addresses mapped to this site." However, if you enter a host name (for example, testserver.acme.com) and enable SSL for that protocol, SSL does not work, and the server console returns the message:
HTTP Server: SSL handshake failure, no website found for IP address [9.95.79.250]
Workaround
Use the server IP address in the "Host name or address mapped to this site" field.
Domino Administrator Client, Domino Server
Known limitations with SSL and Notes/Domino 7
Successful Internet Client Certificate Authentication over SSL
�
Mozilla 1.4.1 on Windows and Linux over HTTP(S)
�
IE 6.0 Client over HTTP(S)
�
Notes Client over HTTP, LDAP
Client Condition Summary
�
Microsoft Internet Explorer 6.0 & Microsoft Outlook Express 6.0
HTTP - Works as expected
LDAP - Client Certificate Authentication Fails (Client Limitation)
POP3 - Client Certificate Authentication Fails (Client Limitation)
IMAP - Client Certificate Authentication Fails (Client Limitation)
SMTP - Works as expected
�
Lotus Notes
HTTP - Works as expected
LDAP - Works as expected
POP3 - Client Certificate Authentication Fails, Name & Password works as expected
IMAP - Client Certificate Authentication Fails , Name & Password works as expected
SMTP - Works as expected
159
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Authentication Methods
Settings below are found in the servers server document or Internet Site Document for each protocol respectively. Settings represent use of authentication methods to access an SSL secure session via each protocol.
Legend:
Pass
- Works Properly
Fail
- Bug/Crash/Not working as expected. Include a link to any SPRs
N/S
- Not Supported in Domino Configuration
5
IE 5.x -6.x uses client certs to encrypt email and not to authenticate a secure connection with IMAP, LDAP, POP3, or
NNTP
6
IMAP and POP3 can not have anonymous enabled at all.
8
Fails over to Name/Pass
9
Fails over to Anonymous
11
SMTP Inbound does not support Client Certificates
IE Domestic
Client Certs: Y Client Certs: N Client Certs: N Client Certs: N Client Certs: Y Client Certs: Y Client Certs: Y
6.0/ Outlook
Name/Pass: N Name/Pass: Y Name/Pass: N Name/Pass: Y Name/Pass: Y Name/Pass: N Name/Pass: Y
Express
Anonymous: N Anonymous: N Anonymous: Y Anonymous: Y Anonymous: N Anonymous: Y Anonymous: Y
LDAP
POP3
HTTP
IMAP
SMTP Outbound
SMTP Inbound
Client
Limitation
5
Client
Limitation
5
Pass
Client
Limitation
5
N/S
N/S
11
Client
Limitation
Pass
Client
Limitation
9
Pass
6
Pass
5, 8
Pass
5, 9
Pass
5, 8
Pass
N/S
6
Pass
5, 8
5, 6
5, 6, 8
Pass
Pass
Pass
N/S
6
Pass
Pass
Pass
Pass
5, 8
Pass
5, 6
Pass
5, 6
N/S
Pass
N/S
Pass
N/S
Pass
N/S
11
N/S
11
N/S
11
Legend:
Pass
- Works Properly
Fail
- Bug/Crash/Not working as expected.
N/S
- Not Supported in Domino Configuration
6
IMAP and POP3 can not have anonymous enabled at all.
8
Fails over to Name/Pass
11
SMTP Inbound does not support Client Certificates
Notes Client
Client Certs: Y Client Certs: N Client Certs: N Client Certs: N Client Certs: Y
Name/Pass: N Name/Pass: Y Name/Pass: N Name/Pass: Y Name/Pass: Y
Anonymous: N Anonymous: N Anonymous: Y Anonymous: Y Anonymous: N
LDAP
Pass
Pass
Pass
Pass
Pass
8
POP3
Fail
Pass
N/S
Pass
Pass
SPR#
6
8
DDUO5DQU52
Client Certs: Y Client Certs: Y
Name/Pass: N Name/Pass: Y
Anonymous: Y Anonymous: Y
Pass
Pass
8
Fail
Pass
SPR#
8
DDUO5DQU52
6
HTTP
IMAP
SMTP Outbound
SMTP Inbound
Pass
Pass
Fail
Fail
SPR#
SPR#
DDUO53URFB DDUO5DR2AU
N/S
N/S
11
N/S
Pass
Pass
N/S
6
Pass
Pass
Pass
Pass
Fail
Fail
Fail
Fail
SPR#
SPR#
SPR#
SPR#
DDUO5DR2AU DDUO5DR2AU DDUO53URFB DDUO5DR2AU
N/S
Pass
N/S
Pass
160
8
N/S
11
N/S
11
8
N/S
11
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server
Missing key file name generates errors in SSL-enabled lookup
The key file for outbound SSL for LDAP directory assistance and SMTP outbound is configured in the Server document
(Ports -> Internet ports). If the key file specified is missing, or cannot otherwise be opened, "SSL Error: Keyring File
access error" messages will appear on the server console upon server startup and when directory assistance is being
used.
If Internet Site documents are enabled for the server, the configuration for the key file value is hidden.
A 'silent' error situation can occur if there is no value, or a value not ending in ".kyr", in the key ring file field on the
Server document, and the server attempts to use Directory Assistance; SSL will run but the server cannot establish
trust with the Directory Assistance server. You can create trust either by configuring the key file field, as described
below, or by creating an Internet cross-certificate for the Directory Assistance server.
Workarounds
To configure the key ring file name if Internet Site documents are enabled, do the following:
1. Disable the server's use of Internet Site documents by disabling the option "Load Internet configurations from
Server\Internet Sites documents" on the Basics tab of the Server document.
2. On the Server document, click Ports -> Internet Ports and, in the SSL settings section, enter the SSL key file
name.
3. Re-enable the Internet Site documents option.
If the keyfile name does not end in ".kyr", rename the keyring and stash (.sth) file names correctly and make sure that
the correct file name appears in the SSL key file name field in the Server document.
Domino Administrator Client, Domino Server
Notes Password History cannot be disabled
The security policy setting "Notes password history" allows you to specify the number of expired passwords to store.
Once you have enabled this setting in a policy document, you cannot disable it.
Possible workarounds include disabling the security policy, or setting the number of expired passwords to store to 0.
Domino Administrator Client, Domino Server, Domino for z/OS
Problem when trying to create cross-cert by typing in key value
In Domino 7, the procedure documented in the Domino 7 Administrator Help topic "Adding a Notes cross-certificate
by phone" does not work. The following error message is generated:
Server Error:The subject's public key found in the cross certificate does not match the one found in the certificate table"
The value of the certified public key in cross certificate created in the procedure does not match the value of the
cross-certificates created using the Domino Administrator.
Notes Client
Smartcard configuration details fail to update for new user
There is a known issue that occurs when a Smartcard is configured to use two USB slots. If you switch to a new user,
the User Security dialog box shows only the slot used by the previous user. The new user can not select a USB slot.
Workarounds
Place both users' Smartcards in both configured slots when starting Notes
or
Place the Smartcard in the selected empty slot and restart Notes.
161
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Notes Client, Domino Server
Smartcards no longer need to be in the first occupied "slot"
Previous versions of Notes/Domino were only capable of using smartcards and other cryptographic tokens that were in
the first "slot", as presented by the smartcard vendor's PKCS#11 library.
The problem has been fixed in this release. A new dialog has been added that can be used to select the token or slot
used to smartcard-enable an ID file or search for certificates to import. To open this dialog, open the User Security
Panel (File/Security/User Security), select the Your Identity//Your Smartcard tab, press the "Configuration Details"
button, then press the "Select Slot" button.
Once an ID file has been smartcard-enabled or a certificate has been imported, the correct token will be found and
used as long as the token is connected to any of the slots presented by the PKCS#11 library.
This limitation still partially exists in the SECManipulateSC API function, which can only use the token in the first
occupied slot when smartcard-enabling an ID file.
Domino Server
SSL Session Resumption
SSL session resumption greatly improves performance when the Notes HTTP Client or server is using SSL, and may
have a minor (positive) effect on other "Internet" protocols as well.
The default number of resumable sessions that will be cached on the server is 50. To modify the number of sessions
cached, set the SSL_RESUMABLE_SESSIONS notes.ini variable to the desired number. Setting
SSL_RESUMABLE_SESSIONS=1 will disable SSL session resumption on the server.
Currently, the number of resumable sessions will not dynamically climb to match the server SSL load, and there is
currently no means of configuring sessions to time out and expire.
The default starting size of each cached session can be configured with the SSL_SESSION_SIZE notes.ini variable.
Increasing the size of this variable will result in a lower incidence of elements being reallocated on the fly in order to
hold large X.509 client certificates, but will also consume more memory.
Notes Client
Warning dialog box does not appear before certificate expires
No warning message appears in the Notes client for users when their Notes certificate is expiring. For example, if a
user's certificate is set to expire within a week, the user will get a warning about the certificate expiration in the User
Security Panel, but does not get a warning dialog box when they log in to the Notes client.
Domino Administrator Client, Domino Server
"No Trusted Root Certificate" error message
An error may occur when installing VeriSign certificates into a Notes/Domino keyring.
The only VeriSign certificates that are affected are ones issued by O=VeriSign Trust Network/OU=VeriSign
Inc/OU=VeriSign International Server CA - Class 3. Before installing these certificates, you must open the certificate
labeled "VeriSign Intermediate CA" and click the button "Trust This Certificate". Enter your password when prompted
then proceed with "Install Certificate Into Key Ring" as usual.
162
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server
"The requested item does not exist" error
You may see this error on your server console after using the CA process to add an Alternate Name to a user:
"Error processing certificate request: The requested item does not exist."
This error only occurs if you try to recertify or register a user immediately after you add an Alternate Name to your CA
Process-enabled certifier, and before the certifier has automatically refreshed its context.
Workaround
�
At the server console, type
tell adminp process all
then
tell ca refresh
�
If your CA Process-enabled Notes certifier has been locked with a user ID, you will need to unlock it using the
following command:
te ca unlock <X:\user.id> <password>
Be sure to type the full path and file name of the ID file used to lock your CA and the ID's password when using
the unlock command. Type the following to verify that it is active again:
te ca status
�
Next, open the Administration Requests database and go to the Certification Authority Requests/Certificate
Requests view. Locate and open the rejected request. The request will have been rejected with the following
rejection reason:
5935: unknown
�
Click Edit Request -> Approve Request. The certificate should be successfully issued.
Server issues
Domino Server
Server - IMAP "Other user's domain delimiter" Netscape setting
Attempting to use Namespace with the Netscape client, you will experience a problem accessing these folders. This is
due to a problem on the client that does not handle the Notes separators properly.
In the Server Configuration document under the 'IMAP - Public and Other User's Folders' tab you will find a new field; the "Other user's domain delimiter" field. Please insert any character except "/"; we would suggest using the "|" character.
Domino Administrator Client, Domino Server
Adding Domino 6 server to 7.0 domain replaces events4.nsf design
If you add a Domino 6 server to a Domino 7 domain, you need to ensure that the Domino 6 design of EVENTS4.NSF
does not replace the design of the Domino 7 version of EVENTS4.NSF. To ensure that the Domino 7 design is not
overwritten, delete EVENTS4.NTF from the Domino 6 server's data directory prior to launching the new Domino 6
server. During the launch of the Domino 6 server, the server console will indicate that the design is being updated but
it won't replace anything. The Domino 7 server replication will ensure that the design remains a Domino 7 design.
Deleting EVENTS4.NTF also ensures that the design task that runs at night will not replace or refresh the design.
163
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
If you do not delete EVENTS4.NTF from the Domino 6 server's data directory, the process described here occurs.
If you install a Domino 6 server and then register the new server using the Domino Administrator client on the Domino
7 hub server, during server setup of the Domino 6 server, several Domino 7 databases are replicated to the Domino 6
server including NAMES.NSF (Domino Directory), ADMIN4.NSF, and EVENTS4.NSF. When you launch the new Domino
6 server, the design task runs and begins replacing the design of the Domino 7 database EVENTS4.NSF with the
Domino 6 design of EVENTS4.NSF. The design of the Domino 7 versions of NAMES.NSF and ADMIN4.NSF are not
replaced.
The Domino 6 server then contains a Domino 6 version of EVENTS4.NSF, and a Domino 7 version of ADMIN4.NSF and
NAMES.NSF. If you create a server Connection document from the Domino 7 hub server to the Domino 6 server, the
database design of the Domino 7 version of EVENTS4.NSF is replaced with the Domino 6 version of EVENTS4.NSF on
the Domino 7 hub server. The Domino 6 design is then replicated throughout the domain.
Domino 7 features, such as DDM, that use the Domino 7 version of EVENTS4.NSF do not work on servers with a
Domino 6 version of EVENTS4.NSF.
Domino Administrator Client
Combinations of statistics/metrics can make Server.load quit.
There is an issue with selecting certain combinations of server statistics in the Server.load Metrics list. If Server.load
quits while running and you have selected multiple stats, try selecting only one stat from the list. You can also collect
the same stats on the server using Statrep.nsf statistics collection.
Domino Administrator Client, Domino Server
Domino Java Console - Make LocalDomainAdmins group Multi-purpose
Set the LocalDomainAdmins group to a Multi-purpose group when using the Domino Java Console and connecting to
the Domino server. If you set the LocalDomainAdmins group to a group type other than Multi-purpose, this error
appears:
"<user name> is not an administrator for server <server name>."
Open the file ADMINDATA.XML file that is created in the Domino/data directory. No administrators are listed between
the XML tags <admins></admins>. Change the Group Type for the group LocalDomainAdmins as follows:
Changing the Group Type
1. From the Domino Administrator, click People & Groups.
2. Click Groups and select the group you are setting as Multi-purpose.
3. Click Edit Group.
4. On the Basics tab, choose Multi-purpose as the Group Type.
5. Click Save and Close.
6. Restart the Domino server and the Java controller.
7. In the Domino/data directory, open the file ADMINDATA.XML. The administrators names now appear between the
XML tags <admins></admins>.
Domino Server
Domino Server Controller - Don't run in the background on AIX
For the Domino Java Console, running the Server Controller in the background on AIX may cause the Controller
process not to run (in wait mode).
164
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Administrator Client, Domino Server
Invoking Domino with Server Controller causes exception
Invoking the Domino Server with the Lotus Domino Server Controller gives the following exception message:
java.lang.NullPointerException
at lotus.domino.console.DominoController.setHostName(DominoController.java:144)
at lotus.domino.console.AdminDataParser.ReadAdminInfo(AdminDataParser.java:275)
at lotus.domino.console.AdminDataParser.readAdmins(AdminDataParser.java:339)
at lotus.domino.console.ControllerCmdParser.updateAdmins(ControllerCmdParser.java:257)
at lotus.domino.console.ControllerCmdParser.run(ControllerCmdParser.java:723)
These exception messages are displayed only the first time a server is invoked, after installing/registering a first server
or an additional server; the server will still run normally despite the errors.
Subsequent invocation of the Server will no longer display the errors.
Domino Server
Java agents on UNIX using 4.6 Domino Java package will fail
Java agents on UNIX platforms using "import lotus.notes.*" to load the 4.6 version of the Domino Java package will fail
to run with the following error:
04/07/2004 13:25:13
HTTP JVM: java.lang.UnsatisfiedLinkError: NregisterJavaThread
04/07/2004 13:25:13 HTTP JVM:
at lotus.notes.Session.registerJavaThread(Session.java:121)
04/07/2004 13:25:13 HTTP JVM:
at lotus.notes.NotesThread.initThread(NotesThread.java:104)
04/07/2004 13:25:13 HTTP JVM:
at lotus.notes.NotesThread.run(NotesThread.java:138)
Java agents using "import lotus.domino.*" to load 5.0 and later versions of the Domino Java package work fine on
all platforms.
To work around this problem, switch the import statement to the newer "import lotus.domino.*" package. This
package is backwards-compatible.
Domino Designer
Java controller does not start - IbmX509 not available
After starting a Domino server with the option to start the Java Server Controller:
STRDOMSVR SERVER(<server-name>) JSC(*YES)
the server does not start and no error messages are logged. If you remove the option to start the Java Server
Controller, the server will start.
The following error messages are in the CONTROLLER joblog:
java.lang.UnsatisfiedLinkError at java.lang.Error.<init>(Error.java:37) at java.lang.LinkageError.<init>(LinkageError.java:26) at java.lang.UnsatisfiedLinkError.<init>(UnsatisfiedLinkError.java:25) at lotus.domino.console.DominoController.access$000(DominoController.java:1
at lotus.domino.console.DominoController$1.run(DominoController.java:207) at java.lang.Thread.run(Thread.java:534) java.security.NoSuchAlgorithmException: Algorithm IbmX509 not available at java.lang.Throwable.<init>(Throwable.java:195) at java.lang.Exception.<init>(Exception.java:41) at java.security.NoSuchAlgorithmException.<init>(NoSuchAlgorithmException.java:38) at javax.net.ssl.SSLSecurity.a(Unknown Source) at javax.net.ssl.KeyManagerFactory.getInstance(Unknown Source) 165
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
at lotus.domino.console.SSL.initSSLContext(SSL.java:79) at lotus.domino.console.ClientAcceptor.Init(ClientAcceptor.java:38) at lotus.domino.console.ClientAcceptor.run(ClientAcceptor.java:71) Workaround:
Check that you have installed all of the software pre-requisites for Domino 7 and i5/OS V5R3, including:
5722AC3
5722AC3
*BASE
*BASE
5050
2924
Crypto Access Provider 128-bit Crypto Access Provider 128-bit Notes Client, Domino Server
Preventing non-KeyView filtering when using "conversion filters"
The variable FT_KV_DISABLE_BRUTE_FORCE=1 disables brute force filtering when a database has been designated to
use "conversion filters". This is helpful in order to prevent the indexing (and storage) of unrecognizable data and
file-types.
Using this variable can help improve indexing performance, and reduce the size of the on-disk index.
Domino Administrator Client, Domino Server
RMEval cannot restart when another runjava application is loaded
RMEval, like ISpy and ChangeMan, is a runjava server task. RMEval is automatically loaded if any DDM OS probes are
enabled for the current server. If this task is explicitly unloaded, it can not be successfully loaded again until all other
runjava tasks are also unloaded. It is then safe to reload any of the runjava tasks.
The workaround for this problem is to quit all runjava applications before restarting RMEval.
Follow these steps:
1. Enable OS probes.
2. Enable ISpy probes.
3. Start the Domino server.
4. Allow RMEval and ISpy to initialize.
5. Stop RMEval and ISpy by entering this command from the server console:
tell RMEval quit
tell ISpy quit
6. Restart RMEval and ISpy by entering this command from the server console:
load runjava RMEval
load runjava ISpy
Domino Server
Running NSD manually can cause Domino to crash
On UNIX systems, under certain conditions, running NSD manually can cause Domino to crash. This can happen
when a process such as the Agent Manager (AMGR) or Web Server (HTTP) is executing Java code. To prevent this
crash add the variable AMQ_NO_SIGWAIT_SIGTRAP=1 to your system environment (see the instructions for your UNIX
shell - csh, ksh, bash, etc.).
166
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Server
Server - Domino Console
The Domino Console is a new feature for Domino, consisting of two modules: Domino Controller and Domino Console,
both Java-based applications. The Controller runs on the server end, while the Console can be run independently on
any machine. On UNIX, to run Domino Console that system must be running X windows. However, Domino Controller
can be started without running X windows.
Normally, starting the Domino Controller also starts the Domino Server and Domino Console on the same machine. However, once started, an administrator can then exit the Domino Console without exiting the Domino Server and/or Domino Controller. This allows administrators to reconnect with the Controller and Server by starting the Domino Console either on the same machine, or remotely on any other machine.
For Domino 6 or later, please be aware that the Domino Console is installed with the Domino server, Administrator
Client and Notes Client. However, if you want to run the Domino Console separately on any machine, please follow the
instructions under Console, below.
Note: Please be aware that you can not run Domino Controller [(n)server -jc -s ] and Domino server separately and expect them to communicate to each other. So one must start the domino server under the control of the Domino Controller.
Startup Instructions for Domino Controller and Domino Console:
Controller
�
Starting with the current release of Domino 6, the server generates a file called "admindata.xml" in the data
directory. Please do not modify this file manually. To set or modify admin roles, you must change the server
document in the NAB.
�
For the console to connect to any server, that server should be running with Domino Controller. To run server
under controller issue the following command.
On NT: Make sure no other server is running. Run the server as: nserver -jc. You will see a window. DO NOT
KILL OR CLOSE THIS WINDOW, but iconify it.
On UNIX: Make sure no other server is running. Change the directory to Data Directory. Run the server as:
<IDIR>/lotus/bin/server -jc.
<IDIR> in this document refers to the directory where the domino server is installed.
For example: /opt or /local.
When you start Domino as described above, the Controller gets started and it, in turn, starts Domino Console and
Domino Server. Since all three processes are running on the same machine, they will take up some system
resources. If your machine is slow or memory-starved, it is suggested that you run server in the following manner
(server means nserver on NT/W2K or server on UNIX):
server -jc -c
Should not bring up the Console and should start Domino and the Controller. If the Domino server
needs a password, it will only bring up the server process. You must connect from another Console and enter a
password from there. If the server doesn't have a password, it will bring up all of the Domino processes.
NOTE: For the first time only after setup, connecting from a remote system using the Domino Console, you
will not be able to connect if the server is waiting for a password. You can connect to Controller locally by
using local server icon on the Console and enter password. However, If the server doesn't require a password,
you will be able to connect.
server -jc -s
Should bring up the Console and the Controller but not start Domino
server -jc -c -s Should only bring up the Controller
Console
�
To run Console only, please follow the instructions below:
On NT: run "jconsole.exe" from the command prompt. This executable is located where server or administrator is
installed.
On UNIX: run "jconsole" from the command prompt. This executable is located where server is installed.
<IDIR>/lotus/bin/jconsole
167
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
�
Chapter 3 - Known limitations, problems, and workarounds
In the current release, to run Domino Console separately on a machine where Domino is not installed, you need to
have the following files in a directory on the machine you want to run. Copy the following from the Domino
executable directory on a machine where Domino is installed, to a new directory on the desired machine.
-
dconsole.jar
jconsole.exe (on NT/W2K) or jconsole (on UNIX)
jvm directory including all subdirectories
Follow the steps under Console, On NT or On UNIX above, as appropriate.
Things you need to know:
�
For any help on how to use Domino Console, refer to the on-line help menu option on the Domino Console menu.
�
To Connect to any controller, the administrator needs to know his/her user name or any shortname and password
(internet password field) that is in the administrators person document in the NAB.
�
In the NAB, in the server document, the internet host name field must have the proper host name.
�
To be able to connect to the controller, administrators need to have their names put in the appropriate fields in
the server document in NAB under the Security tab. The fields are:
�
Full Access Administrators can issue all Domino, Shell and Controller commands (including quit, exit,
enable/disable user).
�
Full Remote Console Administrators can issue Controller commands (including quit, exit, enable/disable
user) and all Domino commands, but not Shell commands.
�
View Only Administrators can issue View Only Domino commands and Controller commands (except quit,
exit, enable/disable user), but not Shell Commands.
�
System Administrators can issue Controller commands (except quit, exit, enable/disable user) and Shell
commands, but not Domino commands.
�
Restricted System Administrators can issue only those Shell commands listed in the restricted system
commands field and Controller commands (except quit, exit, enable/disable user).
�
Restricted System Commands should contain a list commands that can be issued by the Restricted System
Administrator(s).
�
The port 2050 or whatever port you are running the Domino Controller on, must be a publicly available port for
the Domino Console to be able to connect from a remote machine.
�
To connect to the controller for the first time, you must type in hostname of the controller/server to which you
want to connect in the server name field of the Open server dialog. Once you connect to the controller/server,
from the Domino Console use "File->refresh server list" menu option to get the list of available servers and server
groups from the connected server. When the administrator exits the console, the server and group list are
persisted in dconsole.ini file. Next time you start the Domino Console, there is no need to do refresh servers list
unless you want to get the latest changes.
�
To run Domino Controller/Domino Console on a partitioned server environment, make sure the Notes.INI file has
the TCPIP_TcpIpAddress line with the specified IP Address for the server.
�
You can copy text from the console text area to the system clipboard by selecting the text using the left mouse
button, and clicking the right mouse button, or by using CRTL-C, or by using "Edit -> Copy" menu option to copy.
�
Clicking the right mouse button on either available or connected server list view will display a pop up menu, where
you could connect, disconnect, and server information.
�
For shell commands, it is recommended NOT to use Editors, Debuggers, or any other program which is
interactive and uses the same shell to run.
�
If you don't want to get the Controller status window displayed, please set the Notes.ini parameter:
"ShowControllerStatusWindow=0". By default, the window will be displayed.
�
On UNIX machines, please do NOT tee the output to a file. If you do, only controller messages will be written in to
that file.
�
On UNIX servers, "File->Kill Server" followed by "File->Start Server" is not asking for password if the server has a
password because Kill server is not cleaning the message queues where password is remembered and used.
168
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
�
The only way you can remove a domain or server from displaying on the Domino Console is by deleting the server
record(s) from the "dconsole.ini".
�
Administrators who issue "tell ca" commands can use "View -> Show Secure Password" or click "secure password"
on the Popup menu by clicking the little arrow next to the Send button. The Password field allows user to enter
passwords encrypted.
�
Controller command "#restart domino" is not working as specified in the documentation. It only brings down the
domino processes but does not restart domino. Please use menu commands "File->Kill Domino" followed by
"File->Start Domino" instead.
�
If the console is stuck in Wait Cursor mode for any reason too long, use CTRL-SHIFT-B to come to normal cursor
mode.
Known Issues
�
When you start the console, a blank screen will intermittently display where the console text is shown. Resizing
the main window will eliminate the painting problem.
�
When the Look And Feel is changed, the cursor is lost from the command prompt area. If you click Send Button,
open any menu or some other action, focus comes back to normal.
�
If you do any local logging, for each server you do, do once "Edit -> Local Logging" even if you don't change
anything before enabling by "File -> Local Logging". Otherwise, logging is written to default file "dconsole.log"
instead of what is shown in "Edit -> Local Logging" dialog. Also, If you change the file path for local logging file,
next time when you come into dialig "Edit->Local Logging" is defaulting to data directory.
�
When Domino Console is connected to any Controller, controller immediately gives last 120 messages. If any of
those messages is prompt, Domino Console may display that prompt. Ignore and cancel that dialog unless that is
the last message you see on the console.
�
If a prompt message is displayed while you are in a dialog, the only way you can close the prompt is by clicking
on the window closing icon of the prompt. Focus is getting confused between two modal windows.
Internationalization Issues
�
On Linux, Domino Console that is started by the Controller has a problem when using Hebrew characters; the
console freezes after it writes Hebrew characters. Instead of Controller starting the Console, start the Console
separately and attach to the Controller. That is, start Controller as "server -jc -c" and Console as "jconsole" and
attach to the Controller. Or, start Controller "server -jc", and as soon as you give the Domino password, exit just
the Console only. Then start Console separately and attach.
�
How to enter Indic language characters in Domino Console - On AIX, Linux, and NT/W2K machines, click on the
icon on the top left corner of the window/dialog. Selecting the "Select Input Method" menu option pops up a
menu from which you can select the Input Method Editor of choice.
�
On Linux, expanding the Chinese character selection in Linux's IME results in recycling server commands being
displayed because of a Linux IME problem.
�
On Linux, Korean characters are not displayed while typing in the Command Input field of Domino Console.
�
Domino Console does not currently support Thai locale.
�
Domino Console does not support inputting text in a different language than the language of the Operating
System it is running on.
�
Domino Console does not switch input modes in Japanese IME using ALT+ ~ when a dialog box with text field is
invoked. If you tab out to another field and come back, everything works fine.
�
Domino Console does not currently support GB18030.
169
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Starting Controller as NT/W2K service:
You can also run the Server Controller as a Windows NT service. To run as an NT service, you need to add "-jc" to the startup parameters. You can do in any one of the following 3 ways:
�
To add the "-jc" from the command line to a stand-alone server installed as a service, use the SC tool (Sc.exe)
included in the resource kit. For example:
Sc config "Lotus Domino Server (LotusDominoData)" binPath= "=c:\lotus\domino\notes.ini -jc"
This is of the form: sc <server> [command] [service name] <option1> <option2> ...
For more information see Microsoft Knowledge Base article - Q251192 at
http://support.microsoft.com/default.aspx?scid=kb;en-us;Q251192
�
To add "-jc" at the end of the ImagePath value in regedit by looking for Domino service entry:
MyComputer -> HKEY_LOCAL_MACHINE -> System -> CurrentControlSet -> Services -> LotusDominoServer(datadirectory)
�
Specify in the "Startup Parameters" along with other parameters. For example:
"=c:\lotus\domino\notes.ini -jc"
Note: On NT path has to be given as c:\\lotus\\domino\\notes.ini because of NT bug.
Message logging by Domino Controller and Domino Console:
Starting with the current release of Domino, logging of the controller messages has changed as explained below:
Logging on Controller End
Controller logs messages from Domino which can be controlled by the user. By default, it saves the messages in
normal text format (i.e., plain messages) in Domino's data directory. However, the user can set a different
directory and different name by specifying the path for ControllerLogFileName as explained in the Controller
Specifics below. Every midnight, the controller starts another log file with the same path, but appending a
different datetime so that the logfile won't be too big. However, if the user changes the ControllerLogFileType on
the fly from the Console, then a new file also gets created, with that datetime. In essence, if a user changes
ControllerLogFileName and/or ControllerLogExpiration these are taken into consideration when Domino is
started, or at midnight when the new file is created, or when the user changes ControllerLogType.
Controller Specifics
Users can change these from the console, as below, by editing dcontroller.ini or by using the controller set
command from console (e.g., con set ControllerLogType=2).
There are three parameters that effect the logging on the controller end. These are set in "dcontroller.ini" file in
server's data directory:
ControllerLogType
ControllerLogExpiration
ControllerLogFileName
ControllerLogType
This can have 0, 1, 2, or 3 as its value.
0 -- means no logging. Do not log at all on the controller end. This is the same as not setting the
DEBUG_OUTFILE option.
1 -- means log in normal text messages. This is the default, and gives more information than the
DEBUG_OUTFILE setting. It is similar to the 'pipe' command on UNIX.
2 -- means log the messages in meta format with all info (severity, color, procid etc.,) that comes from
server.
3 -- means log both types of files simultaneously.
170
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
ControllerLogExpiration
This will keep files for the number of days set, and purge the remaining. Default value is 7 days. That means, on any day, you will have that many days-old files in the data directory, or whatever directory is set.
ControllerLogFileName
This will keep track of the pathname for the log file. When the user sets this, he should not give any
extension. Program appends .meta or .log to the file name, and appends the datetime to the given name.
Default name given is "dcntrlr". Default directory is domino data directory. Default log file are as follows:
dcntrlr06170900.log or dcntrlr06170900.meta based on the ControllerLogType.
If the user sets ControllerLogFileName=d:\logs\mylog, the files will be as follows in d:\mylog directory:
mylog06170900.log or mylog06170900.meta
However, if the user sets ControllerLogFileName=d:\logs\mylog.log, the files will be as follows in d:\mylog
directory:
mylog.log06170900.log or mylog.log06170900.meta
Console General Information and Specifics (Local Logging)
You can log the messages that come from a particular controller/server on the local disk, when you connect from
a remote Java Console. You can even log for multiple servers at the same time. Users can, on the fly, stop and
start local logging. To enable or disable local logging, use the "Controller -> Local logging" checkbox.
When you enable local logging, a dialog box will pop up where the user can select the directory and file name,
data type (meta or normal text) and file type (sequential or circular; if the latter is selected, the user needs to give
the logfile size).
Each field has automatic tooltip text that tells what that field is. Here, the default directory is where the Java
console is started.
Note: Both controller logging and local logging are writing native bytes instead of UTF8. If you have multibyte
characters, they won't show correctly.
Domino Administrator Client
Server Health Monitoring - false 'Server not responding' status
Server Monitoring will sometimes report that a server is not responding or 'The remote server is not a TCP/IP host'
when the server is running and responsive. This is usually caused by connectivity issues and timing. If this occurs in
your domain, try increasing the monitoring time interval.
In Domino Administrator, go to the Server - Monitoring tab and set the view to 'By Timeline'. The column scale
indicates the current polling interval. Simply drag the marker to increase the interval. Another way to increase the
polling interval is to go to File - Preferences - Administration Preferences - Monitoring tab and change the value in the
'Poll servers every xx minutes' field.
Domino Administrator Client
Server Health Monitoring - missing components for Linux
The Health Monitoring database (dommon.nsf) is missing default threshold documents for the Linux Intel platform
(also found on the Domino Administrator Client - Configuration/Health Monitoring/Index Thresholds view).
Specifically, the following threshold documents are missing for Linux:
�
�
�
�
CPU Utilization
Disk Utilization
Memory Utilization
Network Utilization
As a result, the Current Reports and Historical Reports views in the Health Monitoring database will reflect "critically
poor performance" for the above components on any Linux servers in the domain.
171
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Workaround
Simply disable monitoring for these components. This can be done by going to the Domino Administrator Client Configuration/Health Monitoring/Server Components view. Choose 'Edit Server Document' for any Linux servers listed
in the view, disable the above components, save & close the document. A pencil icon will display next to the
document to show that the automatic selections have been revised. Health reports for Linux servers will now reflect
true status because the above components are being ignored.
Domino Server
Server setup error: Special database object cannot be located
When setting up a 7.x Domino server, specifying a server as an "existing server", the step which uses
NSFDbCreateAndCopyReplica may report a problem with the special object missing.
Workaround
Do the following to the names.nsf file on the "existing" server:
�
Run fixup
�
Run copy mode compact (compact -c) This makes a new, temporary copy of the db, copies over all info, and
when complete deletes the existing database and renames the temporary db.
�
Touch the ACL (add foo/bar with No Access, then remove this entry.) This rewrites the ACL object.
�
Clear replication history. This clears the Replication History Cache object. After this, the next replication
with each other server may do a Full Search.
Domino Administrator Client, Notes Client, Domino Designer, Domino Server
SMTP servers and Symantec AntiVirus Corporate Edition
If you configure Symantec AntiVirus Corporate Edition 9.x or 10.x as a client on any SMTP server, be sure not to
install "Internet E-Mail Auto-Protect"; this feature monitors the standard mail ports, and can cause performance
degradation or failure if installed on mail servers.
For additional information, refer to the Symantec Web site: http://www.symantec.com/index.htm.
Domino Server
UNIX - Running background Server Controller may cause error
For the Domino Java Console, running the Server Controller in the background, on UNIX systems only, may cause the
Controller process not to run (in wait mode). There is currently no programmatic fix available.
Workaround
The workaround for this issue is to make sure that the user terminal where the server controller is running in the
background does not have the "tostop" bit terminal setting enabled. To check, issue the command "stty -a" in a
terminal, and see if the output has "tostop" or "-tostop". If "tostop" is there, disable this bit by issuing the command
"stty -tostop".
Domino Server
UNIX - "Could not lock System prefs" error in the Java console
This release note details an issue with Java errors within Domino on UNIX, of the following type:
"java.util.prefs.FileSystemPreferences checkLockFile0ErrorCode
WARNING: Could not lock System prefs. Unix error code 1101753807"
This error occurs because the JRE looks for security settings in /etc/.java and $HOME/.java by default.
However, Domino installs its own JRE within the Notes Executable directory (
/opt/lotus/notes/latest/PLAT/jvm), and installs System Preferences files there.
On some UNIX platforms if a JDK/JRE is installed locally for the Operating System, then this install may create a
/etc/.java directory which is owned/writeable by root. Since Domino does not run as root, it is unable to lock the
preferences file in this directory hierarchy, resulting in the above error message.
172
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Additionally, the deinstallation of a JDK/JRE on a UNIX platform may leave behind this directory structure, but with
incomplete/missing files/hierarchy, causing the same or similar error. For example, it may leave behind
/etc/.java/.systemPrefs without containing the files .system.lock and .systemRootModFile.
Currently, there is no clear way to deal with this issue programmatically in Domino, due to the many ways Domino
accesses Java functionality. It is recommended that you either:
1. Remove /etc/.java and use local user preferences only, either in $HOME or just with what comes
packaged with Domino (preferred)
2. Recursively make /etc/.java globally readable/writeable/executable, but you will still be susceptible to
the incomplete/missing files/hierarchy issue described above.
Web Services issues
Domino for i5/OS
DWA with Sametime chat/awareness only work with port 80
Sametime chat and awareness do not work with Domino Web Access when the HTTP server is configured to use a port
other than 80.
Workaround
Configure the HTTP server to listen on port 80.
Domino Server
Enumerations are not supported in LotusScript
Enumerations are not supported in LotusScript at runtime in this release for either input or output parameters to Web
service methods.
Domino Server
Failure serializing strings with embedded nulls in Java
Strings to be serialized for inclusion in a SOAP response for a Java Web service should not contain embedded nulls.
Such a case will cause formation of the response to be terminated prematurely, resulting in a truncated (and thus
invalid) XML document being sent as the SOAP response.
Such a string could be created in Java by the literal "1\02\03" for example. Additionally, the Item.getValueString()
meth will yield such a string if the item text contains newlines.
Domino Designer
Importing WSDL containing xml:lang types
Element "type" attributes with a value of "xml:lang" in WSDL schema definitions are rejected during WSDL import for
lack of a mapping to an implementation type. This may be addressed in a future release.
173
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Designer
Importing WSDL containing xsd:date-based simpleTypes
When importing a WSDL document that defines a schema simpleType based on XSD "date", the generated
deserializer/serializer code is wrong, but may be corrected manually without triggering WSDL document regeneration.
This problem is specific to Java Web services, only. For example, importing WSDL with the following simpleType
(derived by restriction based on type "xsd:date"):
<xsd:simpleType name="simpleDate">
<xsd:restriction base="xsd:date" />
</xsd:simpleType>
will generate the following methods in the resulting "SimpleDate" Java class:
// Simple Types must have a String constructor
public SimpleDate(java.lang.String value) {
try {
this.value = (java.text.DateFormat.getDateTimeInstance()).parse(value);
}
catch (java.text.ParseException e){
throw new java.lang.RuntimeException(e.toString());
}
}
// Simple Types must have a toString for serializing the value
public java.lang.String toString() {
return value == null ? null : value.toString();
}
However, neither of the above methods will produce the desired results at runtime. A possible workaround is to
recode each method as follows:
// Simple Types must have a String constructor
public SimpleDate(java.lang.String value) {
java.util.StringTokenizer tok = new java.util.StringTokenizer(value, "-/.");
java.lang.Integer year = new java.lang.Integer(tok.nextToken());
java.lang.Integer mon = new java.lang.Integer(tok.nextToken());
java.lang.Integer day = new java.lang.Integer(tok.nextToken());
java.util.Calendar cal = java.util.Calendar.getInstance(); // defaults to local/e
cal.set(year.intValue(), mon.intValue()-1, day.intValue(), 0, 0, 0 );
this.value = cal.getTime();
}
// Simple Types must have a toString for serializing the value
public java.lang.String toString() {
if (value == null)
return null;
else {
java.util.Calendar cal = java.util.Calendar.getInstance(); // defaults to local/e
cal.setTime(this.value);
int year = cal.get(java.util.Calendar.YEAR);
int month = cal.get(java.util.Calendar.MONTH);
month += 1;
int day = cal.get(java.util.Calendar.DATE);
StringBuffer val = new StringBuffer();
val.append(year);
val.append('-');
if (month < 10)
val.append('0');;
val.append(month);
val.append('-');
if (day < 10)
val.append('0');
val.append(day);
return val.toString();
}
}
174
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Server
Improperly serialized derived simple type in LotusScript
A derived simple type, defined in a WSDL document and imported into an RPC/Encoded LotusScript Web service, will
not be serialized properly when used as an output parameter.
For example, this type defined in a WSDL document
<xsd:simpleType name="MYTYPE">
<xsd:restriction base="xsd:string"/>
</xsd:simpleType>
would yield this LotusScript code
Class MYTYPE
Public value As String
Sub NEW
End Sub
End Class
When used as an output parameter, the SOAP response would contain something like
<MYMETHReturn xsi:type="ns1:MYTYPE">
<value xsi:type="xsd:string">myvalue</value>
</MYMETHReturn>
which is not correct, and would not be interpreted correctly by a client.
The correct serialization would be
<MYMETHReturn xsi:type="ns1:MYTYPE">myvalue</MYMETHReturn>
If, however, the WSDL document were to be regenerated, the type associated with the above LotusScript code would
be
<complexType name="MYTYPE">
<sequence>
<element name="VALUE" type="xsd:string"/>
</sequence>
</complexType>
which would function correctly.
This issue is not limited to string-based types.
Domino Server
Init all values to be returned by a LotusScript Web Service
If your LotusScript Web Service returns Faults with the message:
"Web service is unable to create LotusScript object" or "Web service is unable to create LotusScript Array"
it is usually caused by uninitialized objects or arrays in the response object. A future release will recognize this, and
emit empty values. In the meantime, make sure that all return values are properly initialized and/or Redim-ed.
175
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Server
LotusScript Constructors called by Web Services sometimes fail
You may have a Web Service that appears to work most of the time, but occassionally fails with the following error:
"Web service is unable to create LotusScript object"
This can happen when a SOAP request passes object arguments whose CLASS definitions include a no-argument
constructor (i.e., NEW method). The LotusScript provider attempts to call these constructors when marshalling the
argument objects, and occassionally LotusScript yields during these operations.
The provider currently treats these yields as errors and returns a Fault where, instead, it should resume execution
until the constructor has successfully completed. A possible workaround is to explicitly init the objects with code that
runs in the Web Service, rather than relying on constructors.
Domino Server
LotusScript Doc/literal services fail
LotusScript services which have the "Doc/literal" "SOAP message format" selected on the Advanced tab of the Web
Service Infobox will fail when invoked. The SOAP response will contain a fault such as:
<soapenv:Fault>
<faultcode>soapenv:Server.generalException</faultcode>
<faultstring>No such operation &apos;&apos;</faultstring>
<detail/>
</soapenv:Fault>
Domino Designer
LotusScript Web services and fixed-size arrays
Although fixed-size arrays may appear in LotusScript classes as members of a class, they are not supported by the
LotusScript Web service runtime, and are known to cause instability in the Domino http server if passed to a
LotusScript Web service at runtime. Only dynamic arrays should be specified for array members of classes passed
to/from a LotusScript Web service.
Domino Server
LS Web Service definitions should all be in Declarations section
LotusScript Class and Type definitions in Script Libraries cannot always be found at runtime when responding to a
Web Service SOAP request. As a workaround, define everything needed by the Web Service, including the service class
itself, in the Declarations section of the Web Service.
Domino Server
Recompile LotusScript Web Services that include lsxsd.lss
If you used the lsxsd.lss include file in LotusScript Web Services written against earlier beta releases of Domino 7, you
should recompile them for this release.
Domino Server
User defined data in WS_Fault subclass are not serialized
For LotusScript, application-specific properties of a subclass are not serialized into the <details> element of a fault
returned in the SOAP response.
That is, in LotusScript, it is presently not possible to include additional service-specific data in a fault as described in
the documentation.
176
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 3 - Known limitations, problems, and workarounds
Domino Designer
Web services and Agents should have unique names
Web services and Agents should have unique names, otherwise it is possible that the agent would be invoked via the
?OpenWebService URL, instead of the intended Web service.
Domino Designer
Web services and SOAPENC arrays
The WSDL representation generated by Designer for arrays in a LotusScript Web service implementation are always of
the SOAP-encoded ("SOAPENC") form:
<complexType name="ArrayOfxxx">
<complexContent>
<restriction base="soapenc:Array">
<attribute ref="soapenc:arrayType" wsdl:arrayType="[array element type]"/>
</restriction>
</complexContent>
</complexType>
SOAPENC arrays are not always accepted by 3rd-party tools, especially when the Web service is of some "literal" SOAP
message format (see the Web service advanced properties panel in Designer). Alternative array representations may
be achieved by exporting the WSDL document, applying revisions with a text editor, and then re-importing into a new
Web service design element. An alternative format to the above example might be:
<complexType name="xxxArray">
<sequence>
<element name="elem" minOccurs="0" maxOccurs="unbounded" type="[array element type]"/>
</sequence>
</complexType>
However, this alternative array representation is not yet completely supported by the LotusScript Web service runtime.
Another option is to elect the "rpc/encoded" SOAP message format (see the Web service advanced properties panel in
Designer).
The SOAP-encoded WSDL array format is also generated from a Java Web service, in most cases. However, the
alternative array representation shown above is also generated from Java for what are commonly known as "indexed"
properties in a Java Bean. The alternative array representation is also supported by the Java Web service runtime.
177
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Chapter 4 - Documentation updates
Notes Client Help
Notes Client
Changes in local database encryption depend on compact
Changes in local database encryption appears to require a compact to activate.
When encryption is first enabled, the compact seems to be automatically scheduled and requires no manual steps. However, if the database is open, it is not immediately compacted and therefore not encrypted. You must close the database and then reopen it to have database compaction happen automatically. The database is then encrypted.
To disable encryption, you must manually enable a database compact by in database properties, which disables encryption.
Notes Client
Client - Client configuration (setup) changes in Notes 7
A new client configuration wizard, which runs after install for a first time setup, or the first time a user roams to a machine, is available in Lotus Notes 7.
Differences from the pre-R5 configuration wizard include:
�
The ordering of things is different, for instance if the id file is found on the server, it doesn't ask you to provide
one. Also if the server can be accessed via the LAN, you are not asked to set up a phone connection.
�
The configuration process has been broken into modules with each piece being completed before the next one
starts. This improves error detection before the input stage is completed, allowing users to correct errors. It also
means that after you have connected to the server, and your local address book has been created, you can no
longer "cancel" the configuration, you can only "cancel" the yet-to-be-completed components.
�
For roaming users, after connecting to the server and replicating the roaming databases, no further questions are
asked. These configurations are assumed to have been completed on the initial client configuration.
Notes Client
Location must point to server address if LAN connection needed
If you have trouble upgrading to roaming from a location that requires a Local Area Network connection document to connect to the roaming server, make sure the current location document contains the complete host name in the Home/mail server field on the Servers tab of the Location document.
For example if your LAN connection document contains serverx.ibm.com in the Destination server address field, your current location document should contain serverx.ibm.com in the Home/mail server field.
Notes Client
Rollover certificates dialog box
The rollover certificates dialog box is accessible from the Key Rollover Information dialog box in the Notes Client Help.
Its primary purpose is to show the key rollover history in a given user's ID file. The dialog box lists the rollover
certificates issued to and by each key. Administrators can use this information for troubleshooting purposes.
For more information, see the topic "Key rollover" in the Domino Administration Help.
179
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Domino Administrator Client, Notes Client, Domino Server
Using keys stored on Smartcards
Domino 6.0.2 introduced the ability to import pre-loaded X.509 certificates from smartcards or other cryptographic tokens and use the corresponding private key on the token for cryptographic operations.
With Domino 7, it is now possible to perform this import without first smartcard-enabling the ID file. This allows users
to use keys that were pre-loaded onto read-only tokens and therefore cannot currently be used to lock the Notes ID
file. As long as the PKCS#11 library is correctly configured and a token is present in the reader, then the "Import
Internet Certificates from a Smartcard" menu option will be available off the User Security Dialog.
However, there are limitations to this mode of operation in the current release.
�
Background processes, such as Just-In-Time encryption and server tasks, are currently unable to prompt for the
PIN, and so will only be able to use keys on the token if the ID file is locked with a smartcard, or if the token
supports a protected authentication path and will therefore be able to prompt for the PIN itself.
�
If an ID file utilizing this feature is subsequently locked with a second smartcard, it may become impossible to
use any keys on the initial token on a single-slot system, since removing the smartcard that locks the ID file from
the reader to insert the initial token will log the user out of Notes.
�
Some older versions of Notes/Domino will be unable to use the key stored on the token.
�
In the current release, the SC_manip_ImportInetCert opcode for the SECManipulateSC C API function can
only be used to import certificates from the smartcard that is locking that ID file. This prevents
SECManipulateSC from being used to import certificates into ID files that are not smartcard-enabled.
Domino Administrator Client, Notes Client
Workplace Welcome page renamed
The Workplace Welcome page in Notes has been renamed the "My Work" Welcome page.
Notes Client
"Local free time info" Replicator page entry shown with old icon
In pictures in several topics in Lotus 7 Client Help, the "Local free time info" entry on the Replicator page is
shown with a book icon.
The actual icon looks like this:
The topics that show pictures of this icon are:
�
�
�
Under "Getting Started" in the Contents: "Replicator page: staying current with servers"
Under "Getting Connected" in the Contents: "Managing replication using the Replicator page"
Under "Getting Connected" in the Contents: "Refining the sequence of replication on the Replicator page"
180
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Domino Administration Help
Domino Administrator Client, Domino Server
'Linear Growth Correlation' field in Activity Trends
The Server Trends document, on the Database Summary tab, contains the field "Linear Growth Correlation". The value
in this field is used to indicate the usefulness of the Growth Rate calculation. The Linear Growth Correlation field
displays a value between zero and one. A high value indicates that the future growth rate tomorrow will be similar to
today's growth rate. A low value indicates that the future growth rate is not predictable.
Domino Administrator Client, Notes Client, Domino Server
Corrected spelling for Notes.INI variable DDETIMEOUT
In the Domino 7.0 Administrator Help, there is a topic for a Notes.ini variable DDE_TIMEOUT. The spelling for this
Notes.ini variable is incorrect. It should be DDETIMEOUT.
Domino Administrator Client, Domino Server
Creating a response file using a template
Use this procedure to create a response file that is based on the template "sample_response.txt". Response files
contain installation configuration information. The template file "sample_response.txt" is located on the CD with the
other installation files.
1. To create the response file, do one of these:
Open the template file, modify the file as necessary, and then save the file to a new name.
Save the file to a new file name, modify the file, and then save the file again.
�
�
2. Run the silent install referencing the response file.
Domino Administrator Client, Domino Server
Creating mail database replicas in a cluster
The Domino administrator documentation contains the topic "Creating mail database replicas in a cluster during user
registration." Step 7 of the procedure "From Web Administrator" in that topic is changed to indicate the correct mail
template, Mail (7). The correct procedure is shown here:
From the Web Administrator
1.
Click the People & Groups tab.
2.
In the Tools pane, expand People, and then click Register.
3.
Choose a CA certifier and, optionally, an explicit policy. Then click OK.
4.
In the Register Person dialog box, select Advanced, and then click the Mail tab.
5.
In the Mail system field, choose Lotus Notes.
6.
In the Mail server field, choose a cluster server as the Mail server.
7.
In the Mail template field, choose Mail (7).
8.
Complete any other fields you want on the Mail tab, and then click the Replica tab.
9.
Select "Create replica(s) of." A list is displayed of servers in the same cluster as the Mail server.
10.
11.
Do one of the following:
�
To create a replica of the mail database on all of the cluster servers, skip this step.
�
To change the list of servers to receive a replica, use the Add button and the Remove button.
Complete the rest of the user registration the way you normally would.
181
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Domino Administrator Client
Custom Welcome page deployment requires ACL change to database
To deploy a Custom Welcome page via Policies, please follow the updated instructions below when creating a welcome
page database:
Creating the welcome page database
1.
From the Domino Administrator, choose File - Database - New.
2.
In the Server field, select Local.
3.
In the Title field, enter the name of the new database. The file name is entered by default, but you can
modify it. The file name can be anything except BOOKMARK.NSF.
4. In the Template Server field select Local.
5. Click Show advanced templates.
6. Click the Bookmarks (7) template.
7. Click OK.
8. Go to File - Database - Access Control and change the -Default- access to Reader
Domino Server
DB2 purge interval setting
Deleting an NSFDB2 database causes all DB2 data and DB2 tables associated with the NSFDB2 database to be
deleted. However, the DB2 schema and table space are not purged, to allow for recovery of an NSFDB2 database that
is accidentally deleted. The Domino server's daily poll task physically removes the schema and table space container
of a deleted NSFDB2 database once the DB2 Purge interval has expired.
The DB2 purge interval can be set on the DB2 tab of the Server document.
Domino Administrator Client, Notes Client, Domino Designer
Desktop Policies: deploying a customized My Work Welcome page
There are several things to be aware of when deploying a customized My Work Welcome page via Desktop Policies:
�
�
Launcher: Deploying items via the Launcher on the My Work page is not supported. If you drag/drop items to
the Launcher and deploy a Desktop Policy with the customized My Work page, the Launcher will remain empty on
users' desktops.
�
�
Group Calendar: The Group Calendar button found on 'Team' tabs is not supported in Desktop Policies. The
Group Calendar feature is specific to each individual user's mail file. As a result, it is not possible to deploy a
Group Calendar to multiple users via Policies.
�
�
'Use System Colors' User Preference in combination with Workplace: If the "Use System Colors" User Preference
is enabled, the My Work page banner in a customized My Work page will display using system colors, not the
chosen banner color/pattern. This is consistent with this User Preference setting and how other aspects of the
Notes Client display when it is enabled.
Domino Administrator Client, Domino Server
Documentation update: Console_Log_Enabled
There is new information about the Notes.ini variable Console_Log_Enabled that supercedes the topic information in the Notes.ini appendix of the Domino 7 Administrator Help. �
The default for console logging is that it is now enabled, with a minimal 1K log file size.
�
If the user later specifies CONSOLE_LOG_ENABLED or enables logging via the server console command, then the
default console log size is changed to unlimited (unless CONSOLE_LOG_MAX_KBYTES is set).
182
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Domino Administrator Client, Domino Server
Inheriting policy settings requires a parent policy
For both organizational and explicit policies, you cannot inherit policy settings unless there is a parent policy from which to inherit settings. For example, policy settings at the Organization level cannot be inherited, because this policy is at the top level of the hierarchy; there is no parent policy above it.
To inherit policy settings in policies at the OU level, the policy setting in the parent policy must have a value. Some, but not all, policy settings have default values. If you are unsure whether a policy setting value exists in a parent policy, use the Policy Viewer.
It's generally a good practice to set a default value in the settings document.
Domino Administrator Client, Domino Server
Installing Domino Server - documentation correction
The information in the setup portion of the Lotus Domino 7 Administering the Domino System, Installing Domino Servers,
and the corresponding online documentation, requires correction. The documentation that states that server names
cannot contain spaces nor underscore characters (_) is incorrect. The server name cannot contain parentheses,
@,/,\,=,+, but can contain blank spaces and underscore (_) characters.
Domino Server
International issues in Java-based Domino Console
Following are the International issues with the Java-based Domino Console:
�
On Linux, the Domino console that is started by the Controller does not work correctly using Hebrew characters;
the console freezes after it writes Hebrew characters. Instead of allowing the Controller to start the Console, start
the Console separately and attach to the Controller. That is, start the Controller using the command, "server -jc
-c", and start the console using the command, "jconsole", and then attach to the Controller. Or, start the
Controller "server -jc", and as soon as you enter the Domino password, exit just the Console. Start the Console
separately and attach.
�
Entering Indic language characters in Domino Console - On AIX, Linux, and NT/W2K machines, click the icon in
the top left corner of the window/dialog. Select the "Select Input Method" menu option to display a menu from
which you can select the Input Method Editor of choice.
�
On Linux, expanding the Chinese character selection in Linux's IME results in recycling server commands being
displayed. This is due to a Linux IME problem.
�
On Linux, Korean characters are not displayed while typing in the Command Input field of the Domino Console.
�
The Domino Console does not currently support Thai locale.
�
The Domino Console does not support inputting text in a language other than the language of the Operating
System.
�
The Domino Console does not switch input modes in Japanese IME using ALT+ ~ when a dialog box with text field
is invoked. If you tab to another field and then return to the original field, it works.
�
The Domino Console does not currently support GB18030.
Domino Administrator Client, Domino Server
Pushing updated policies to the local cache
You can force updated policies to be pushed to the local cache. After you have updated the policy or associated settings documents, wait about five minutes for the indexes, views, etc. to update. Then do one of the following:
�
Press F5 to clear the local settings, and then press F9 to reset the settings with the server.
�
Enter the server command DROP ALL to force authentication and update the cache with any changes to policies.
183
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Domino Administrator Client, Notes Client, Domino Server
Removing password policy restores password quality defaults
The password quality/length setting in a custom password policy reverts to the default password quality setting if the
custom password policy is removed from the user's Person's document.
Domino Administrator Client, Domino Server
Run missed probes at next interval setting
When creating the schedule for a scheduled probe, the option 'Run missed probes at next interval' for the field "How
should missed probes be handled?" is sometimes misunderstood. The definition of 'Run missed probes at next
interval' means that the probe will run at the next time interval the server is up for the scheduled time. For example, if
your probe is set to run weekly on Wednesdays at 12am and the server is down at this time, the server will try to run
this probe at the next scheduled time which would be Thursday at 12am.
Domino Administrator Client, Domino Server
Scriptable Setup for client install - Sample file
The Domino Administrator documentation is being updated to include this example of a scriptable setup file used for
client installation.
Sample
This is a sample scriptable setup file for a LAN connection. All options are used in this sample file.
Username = Joe Employee
KeyFileName=G:\shareddrive\userid\jemployee.id
Domino.Server=1
Domino.Name=servername/domain (For example, server1/sales/enterprise)
Domino.Port=TCP/IP
IM.Server=servername.misc.domain.com
IM.Port=12345
IM.ConnectWhen=2
IM.Protocol=3
IM.ProxyType=2
IM.ProxyServer=sametimeproxy.domain.com
IM.ProxyPort=789
IM.ServerNameResolve=0
IM.ProxyUsername=joeemployee
AdditionalServices=0
Mail.Incoming.Protocol=2
Mail.Incoming.Name=INCOMING INET MAIL
Mail.Incoming.Server=servername.misc.domain.com
Mail.Incoming.Username=jemployee
Mail.Incoming.Password=xyz123
Mail.Incoming.SSL=0
Mail.Outgoing.Name=OUTGOING INET MAIL
Mail.Outgoing.Server=servername.misc.domain.com
[email protected]
Mail.InternetDomain=misc.domain.com
184
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
AdditionalServices.NetworkDial=1
NetworkDial.EntryName=TEST 1 Dial-up Connection
NetworkDial.Username=jemployee
NetworkDial.Password=xyz123
NetworkDial.Phonenumber=area code-phone-number (For example, 508-123-4567)
NetworkDial.Domain=domainname
News.Name=NEWS SERVER ACCOUNT
News.Server=server.domain.com
Directory.Name=LDAP DIRECTORY SERVER ACCOUNT
Directory.Server=name.misc.domain.com
Proxy.UseHTTP=0
Proxy.HTTP=proxy.domain.com:8080
Proxy.FTP=proxy.fake.com:8080
Proxy.Gopher=proxy.fake.com:8080
Proxy.SSL=proxy.fake.com:8080
Proxy.SOCKS=proxy.domain.com:1080
Proxy.HTTPTunnel=proxy.domain.com:8080
Proxy.None=domain.com
Replication.Threshold=3
Replication.Schedule=1
Domino Administrator Client, Domino Server
Seamless mail upgrade requires Multi-user install
To use the seamless mail upgrade for multiple users who share a single workstation, you must install the Notes clients
using the multi-user install option.
Domino Administrator Client, Domino Server
Server - Setup and Desktop Policies
In Domino 7, the R5 Setup Profiles have been migrated to Setup and Desktop Policies. This release note describes
the changes from R5 Setup Profiles to the new Policies.
Migration
Organizations using Setup Profiles should consider migrating to policies. Although Setup Profiles will continue to be
supported in Domino 6, no new features will be incorporated. Administrators will no longer be able to specify a Setup
Profile at user registration time. A migration tool to convert Setup Profiles to Policies is not available at this time.
Co-existence of Setup Profiles and Policies
If a setup profile is specified in a person record, it has precedence over any setup or desktop policy which would apply
to this user.
Execution of Setup Policies
Setup policies are executed once per Client configuration, as part of the initial Client configuration. Changes made to
a setup policy will not affect existing clients to which this policy applies (this is the setup functionality which existed in
R4, with setup profiles). Initial settings which serve as a starting point for users should be included in setup policies.
The administrator is not concerned with keeping these settings up to date on the user's clients.
185
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Execution of Desktop Policies
Desktop policies are applied to a user's Client configuration whenever a change to the policy occurs. Administrators
should include settings which must be kept up to date in desktop policies; for example, if a server phone number is
changed in a desktop policy, it is applied to all clients to which this policy applies. Desktop policies are applied in the
same manner that setup profiles were applied via dynamic Client configuration in R5.
New features of Setup and Desktop Policies
Settings can be pushed to NOTES.INI (W32) or Notes Preferences (Mac) files via Setup or Desktop policies. There is a
new tab in both of these policies called Preferences which contains a group of settings which can be applied to Clients,
based on the execution of the particular type of policy. The group of preferences which can be set is extensible in the
same manner as location settings in R4 and R5. See the Domino Administration Help guide for details.
New features of Desktop Polices
Desktop policies also include a section to apply welcome page customizations to users. The steps to add welcome
pages to a user's desktop are detailed in these release notes under "Welcome page deployment".
A set of any type of bookmarks in any configuration can be pushed to a user. Bookmarks can be added to the
bookmark bar, specific folders or subfolders (including the startup folder) or hierarchies of bookmarks can be added
to the user's desktop. An administrator configures the layout of bookmarks desired, then drags it into the grey outline
at the bottom of the database tab in the desktop policy. This hierarchy of bookmarks is merged with the user's copy.
The administrator can later make changes by moving or removing bookmarks from this outline and those changes will
also be reflected for the user.
"Do not allow private location docs" field in the Desktop Settings doc is new for Domino 7 and it means that if a
company used the obscure location action to make location documents private they will not be slammed by upgrading
to Domino 7. This field forces the admin to make a conscious decision to ignore that old flag. This flag(NoPrivateLocs)
is used by the NAMEDPIsFieldLocked routine to determine if the fields should be locked or not.
Domino Administrator Client, Domino Server
Server statistics generated by the Update task
The Update task generates the following server statistics in Domino 7:
Update.DeferredList
Number of unprocessed update requests in the deferred queue
Update.DeferredList.Duplicates
Number of requests that have been discarded from the deferred queue
because they were duplicates of a request already in the queue
Update.DeferredList.Max
The maximum length that the deferred queue has been since we started
Update.DeferredList.NextDueTime
The date and time at which the next deferred request will be processed
Update.NAB.Updates
The number of times views in the NAB have been updated
Update.PendingList
Number of unprocessed update requests in the immediate queue
Update.PendingList.Duplicates
Number of requests that have been discarded from the immediate queue
because they were duplicates of a request already in the queue
Update.PendingList.Max
The maximum length that the immediate queue has been since we started
Update.PendingList.NextDueTime
The date and time at which the next immediate request will be processed
Update.PendingList.Processed.AllViews (or Compactions, or SingleView)
The total number of all view update requests performed
186
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
If Full-Text Indexing is performed on another thread, the following server statistics are generated in Domino 7:
Update.FullTextList
Number of unprocessed FT requests in the FT queue
Update.FullTextList.Duplicates
Number of requests that have been discarded from the FT queue
because they were duplicates of a request already in the queue
Update.FullTextList.Max
The maximum length that the FT queue has been since we started
Update.FullTextList.Processed
The total number of all FT update requests performed
Domino Web Access
Setting up Domino Web Access with Sametime error
The Domino Administration help topic "Setting up Domino Web Access with Sametime" incorrectly identifies the
Sametime Applet directory as the location from which to copy Sametime server related files. Use the information here
instead.
Part 8 - Copy the Sametime server related files between Sametime servers and Domino servers
In Domino 6.5 for a mixed environment using Forms5.nsf and Forms6.nsf, use the following steps for Forms5.nsf (not
supported on Mozilla):
1.
Copy the contents from the Sametime applets folder on the Domino Web Access server to the Sametime server.
On the Domino Web Access server, the applets are located in the "Sametime" directory:
<data directory>\domino\html\Sametime
Domino Administrator Client
Some Domino Admin tools available only with Service Provider
The Domino service provider software contains a Hosted Organization - Create tool and a Hosted Organization Delete tool on the tools pane in the Configuration tab of the Domino administrator. Refer to the Service Provider
portion of the Domino Administrator online help for instructions on how to use each tool.
The Configuration tab on the Domino Administrator does not contain tools to register an organization, nor does it
contain the tool to register an organization unit. Organizations and organization units are not supported in a Domino
hosted environment.
Domino Server
Starting the Domino server controller as a Windows service
To start the Domino server controller as a Windows service, in the Services Dialog box for the Lotus Domino Server
Service, in the "Start Parameters" field, type:
-jc
187
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
For example, see the entry in the Start Parameters field in the following dialog box:
Domino Administrator Client, Domino Server
Synchronizing Notes client and Domino HTTP passwords
If you have enabled password synchronization for Notes client users, your Notes client users can synchronize their
Notes User ID password with their Domino Web/Internet password, allowing them to use the same password for both
Notes and Internet access.
Domino Administrator Client, Domino Server
System and application templates
The Domino Domain Monitor database template (DDM.NTF) should be included in the topic "System and application
templates" in the Domino Administrator 7 documentation.
Template title and
file name
Purpose
Template name
DDM.NTF
Records and reports statistics that portray
the activity of users (clients) against the
databases on the Domino server where this
database resides.
188
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Domino Designer Help
Domino Designer
Adding actions to right mouse button menus for views
You can add actions to the menus that pop up when a Notes user clicks the right mouse button in a view. To include an action in the right mouse button menu for a view, choose "Include in right mouse button menu" on the Action Info tab of the properties box for the action. When you add an action to the right mouse button menu, keep the following in mind:
�
If you add a shared action to a right mouse button menu, the action appears on the right mouse button menu for
all views that use that action.
�
If an action you add to the right mouse button menu is part of a submenu, the parent menu item also appears on
the menu.
Domino Designer
Agent and Web services profiling
Calls to Domino Objects in agents or Web services written in LotusScript or Java can be monitored and their elapsed times reported.
To enable profiling in an agent or Web service, select the Security tab of the properties box and check "Profile this agent" or "Profile this web service." Profiling occurs each time an enabled agent or Web service runs. Agent profiling occurs on both the Notes client and Domino server.
To view the profiling results for the latest run, select the agent and choose Agent - View Profile Results, or select the Web service and choose Design - View Profile Results.
The results are presented in a document based on the hidden form $BEProfile. The result document contains a heading listing the name of the agent or Web service and the creation time. The Body item of the result document contains a table with a row for each Domino Objects method called and 5 columns:
�
Class -- The name of a Domino Objects class using normalized names such as Session, Database, and Document.
�
Method -- The name of a Domino Objects method or property using normalized names such as CurrentDatabase,
AppendItemValue, and Save.
�
Operation -- For properties, the type of operation: Get or Set.
�
Calls -- The number of times the method or property was called.
�
Time -- The amount of time the calls consumed in milliseconds. The symbol "<" means not enough time to
calculate.
The LotusScript NotesAgent class contains a new method GetPerformanceDocument which returns the profiling results
for the agent as a NotesDocument object. Use of this NotesDocument object is restricted to the second parameter of
EditDocument in NotesUIWorkspace, allowing the profiling results to be opened as a UI document. The
NotesDocument object returned by GetPerformanceDocument is considered read-only; results are undefined if you
write to this object. This method is in the LotusScript interface only.
The following code opens the profiling results for an agent as a UI document.
Sub Initialize
Dim session As New NotesSession
Dim db As NotesDatabase
Dim agent As NotesAgent
Dim doc As NotesDocument
Dim ws As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Dim agentNames() As String
Dim i As Integer
Set db = session.CurrentDatabase
189
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
' Build list of agent names and have user select one
i = 0
Forall a In db.Agents
Redim Preserve agentNames(0 To i)
agentNames(i) = a.Name
i = i + 1
End Forall
title = ws.Prompt(PROMPT_OKCANCELLIST, "Agent name", _
"Select the agent to be viewed", agentNames(0), agentNames)
If Isempty(title) Then Exit Sub
' Get the selected agent then its performance document
Set agent = db.GetAgent(title)
Set doc = agent.GetPerformanceDocument
If doc Is Nothing Then
Messagebox "No profiling results",, title
Exit Sub
End If
' Open the performance document for viewing
Set uidoc = ws.EditDocument(False, doc)
End Sub
The above code will fail to find the $BEProfile form when it runs in the Notes client if no profile results were previously
viewed for any agent in the database. This is because the Notes cache does not contain the newly-created form and
cannot be refreshed. The user must close and reopen the database, and if this fails, close and reopen Notes.
Alternatively, you can first view profiling results for an agent in the database from the Designer UI.
Notes Client, Domino Designer
Autosave for Notes documents
Autosave is a Notes Client feature by which Notes documents are automatically saved to a local database at regularly
scheduled times determined by the user. If Notes crashes, or if the user loses power, the user can recover the work
that was done prior to the crash or power loss.
If the user enables the AutoSave feature, the most current version of the document is saved to an Autosave database
(...\data\autosave.nsf). The Autosave database is created automatically when the Notes client is first installed. The
user then recovers the documents from this database.
Note: Users can override the default location for autosave.nsf by setting the Notes.ini variable
the file location of their choice.
auto_save_db to
Note that the original Notes document is still stored in its database or Notes application; the version with the newest
changes that has not yet been saved is the one copied to the Autosave database.
Enabling AutoSave in forms
In order for a document to be autosaved, the form from which the document is created must be enabled for Autosave.
1.
2.
Open the form's Properties infobox
On the Information tab, under Options, select "Allow Autosave."
Note: Application developers should be sure to test the forms in their applications with Autosave to ensure that
Autosave works properly with the application.
Enabling AutoSave in the Notes client
You enable AutoSave in the Notes Client User Preferences.
190
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Note: The form on which your document is based must be enabled for AutoSave by the application developer. If you
enable Autosave in the Client, the client status bar will indicate when a document is being autosaved. If Autosave is
not enabled for a particular form, speak with the application developer for that application about enabling Autosave.
1. Click File > Preferences > User Preferences.
2. On the Basics pane, under Startup Options, enable "AutoSave Every 15 Minutes."
Note: the default Autosave time is 15 minutes.
3. (Optional) Increase or decrease the autosave interval.
4. Click OK.
Recovering documents saved with the AutoSave feature
Users can recover autosaved documents immediately upon startup, or at a time of their choosing.
At startup after a crash or power loss, and after the user authenticates, the user is prompted to recover unsaved work:
If the user presses Yes , the Recover Unsaved Documents dialog box appears that lists the documents that can be
recovered.
191
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Users have the following options:
�
�
�
�
Recover
Recover
Remove
Remove
- recover the selected document
All - recovers all documents without prompting for each one
- removes the selected document from the Autosave database
All - removes all documents from the local database
Alternatively, the user can select No and recover the autosaved documents later by selecting File - Autosave - Recover
Autosaved Documents. The Recover Unsaved Documents dialog box appears and users can recover or delete
documents as described above.
Once a document has been recovered from the AutoSave database, it is automatically removed from that database. This helps keep the Autosave database from becoming too big. Other Autosave options
(Note: These options only work if the form has been enabled for AutoSave.)
�
Occasionally users may be in the middle of editing a document and need to save the document immediately.
They have the option of saving the current document to the AutoSave database by selecting File - AutoSave Autosave Now.
�
Users have the option of keeping a copy of the working document in the Autosave database until they choose to
delete it by selecting File - AutoSave - Save a copy to the Autosave database.
Domino Designer, Domino Server
Changes to accessibility for Web applications
There are some changes to the way alternate text (ALT text) is handled for accessibility in Web applications. The
following features are implemented for ALT text for pictures and image resources.
�
If you do not add ALT text to a picture or image resource in a rich text field, the Web server no longer generates a
null ALT text attribute automatically.
Note The null ALT text attribute (Alternate Text ="") causes screen readers to skip the image when reading the
Web page. If there is no ALT text attribute at all, screen readers read the source URL for the image. You can add
the ALT text attribute by entering text in the Alternate Text field in the properties box for the picture or image
resource. To use the null ALT text attribute, enter "" in the Alternate Text field.
�
The Web server now automatically generates ALT text for additional images on the Web pages the Web server
generates. The Web server automatically generates ALT text for the images associated with the following:
calendar view navigation, view column sorting, MIME attachment markers, and free time schedules.
Domino Designer
Correction to Web Services topic
The following amends the first paragraph of the Web services topic in the Domino Designer Help.
Domino supports Web services as defined in the W3C documents Simple Object Access Protocol (SOAP) 1.1 (
http://www.w3.org/TR/2000/NOTE-SOAP-20000508) and Web Services Description Language (WSDL) 1.1 (
http://www.w3.org/TR/2001/NOTE-wsdl-20010315). See also Web Services Architecture (
http://www.w3.org/TR/ws-arch) and Web Services Activity (http://www.w3.org/2002/ws/).
192
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Domino Designer
Design list usability improvements
The following changes have been made to Design lists to make them more compact and easier to use.
�
The Comment column now appears on the same line as the other columns for each design element. This lets
Designer display the information for each design element on one line instead of two.
�
To further compact the width of the Design list, some of the column titles are now icons instead of text. Among
the column titles that use icons are No Refresh, Notes, Web, and Mobile.
�
The Inherits From column has been moved to the right of the No Refresh column.
�
The Trigger column in the Agents Design list displays icons for triggers instead of text descriptions of triggers. In
addition, the column title for Private Agent is now an icon instead of text.
�
Similar changes have been made to the Shared Actions Design list in order to conserve space and make the list
easier to use.
�
The Comment column is now sortable.
Note Some icons include descriptions you can access. If you are unsure what an icon represents, hold the mouse pointer over the icon. Designer displays the meaning of the icon. (The icons that are used as column titles do not include these descriptions yet.)
Domino Designer
Editing fields in a design element without opening the element
You can now edit the Name, Alias, and Comment fields of a design element directly in the Design list in the Work pane. You no longer need to open the design element. To edit the Name, Alias, or Comment field of a design element, do the following:
1.
In the Design pane, click the type of design element that you want to edit. For example, click Forms.
2.
In the Work pane, select the design element that you want to edit. For example, click the form you want to edit.
3.
Click the field in that design element that you want to edit. For example, click the Name field.
4.
Edit the field and then press ENTER.
Domino Designer
NotesDXLExporter SchemaLocation and ValidationStyle
Below is documentation for two new properties.
SchemaLocation property
Read-write. The URI of the schema for the DXL being exported.
Note
Note
This property is new with Release 7.
This property is not supported in COM.
Defined in
NotesDXLExporter
Data type
String
Syntax
To get: uri$ = notesDXLExporter.SchemaLocation
To set: notesDXLExporter.SchemaLocation = uri$
193
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Usage
This property applies when ValidationStyle is VALIDATIONSTYLE_SCHEMA.
Defaults to the location of an XSD file in the xmlschemas subdirectory of the ND program directory, for example:
http://www.lotus.com/dxl xmlschemas/domino_7_0.xsd
Example: SchemaLocation property
This agent generates DXL from the current database using a specified schema for validation.
Sub Initialize
Dim session As New NotesSession
Dim db As NotesDatabase
Set db = session.CurrentDatabase
REM Open xml file named after current database
Dim stream As NotesStream
Set stream = session.CreateStream
filename$ = "c:\dxl\" & Left(db.FileName, Len(db.FileName) - 3) & "dxl"
If Not stream.Open(filename$) Then
Messagebox "Cannot open " & filename$,, "Error"
Exit Sub
End If
Call stream.Truncate
REM Export current database as DXL
Dim exporter As NotesDXLExporter
Set exporter = session.CreateDXLExporter
exporter.ValidationStyle = VALIDATIONSTYLE_SCHEMA
exporter.SchemaLocation = _
"http://www.lotus.com/dxl xmlschemas/domino_7_0.xsd"
Call exporter.SetInput(db)
Call exporter.SetOutput(stream)
Call exporter.Process
End Sub
ValidationStyle property
Read-write. The method for validating the DXL being exported.
Note
Note
This property is new with Release 7.
This property is not supported in COM.
Defined in
NotesDXLExporter
Data type
Constant of type Integer
194
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Syntax
To get: style% = notesDXLExporter.ValidationStyle
To set: notesDXLExporter.ValidationStyle = style%
Legal values
�
VALIDATIONSTYLE_NONE (0)
�
VALIDATIONSTYLE_DTD (1) (default)
�
VALIDATIONSTYLE_SCHEMA (2)
Usage
Setting this property to VALIDATIONSTYLE_DTD sets OutputDOCTYPE to True. Setting this property to any other value
sets OutputDOCTYPE to False.
Setting OutputDOCTYPE to True sets this property to VALIDATIONSTYLE_DTD. Setting OutputDOCTYPE to False sets this property to VALIDATIONSTYLE_NONE if it is currently set to VALIDATIONSTYLE_DTD; otherwise, this property remains unchanged.
Example: ValidationStyle property
This agent generates DXL from the current database using the default schema for validation.
Sub Initialize
Dim session As New NotesSession
Dim db As NotesDatabase
Set db = session.CurrentDatabase
REM Open xml file named after current database
Dim stream As NotesStream
Set stream = session.CreateStream
filename$ = "c:\dxl\" & Left(db.FileName, Len(db.FileName) - 3) & "dxl"
If Not stream.Open(filename$) Then
Messagebox "Cannot open " & filename$,, "Error"
Exit Sub
End If
Call stream.Truncate
REM Export current database as DXL
Dim exporter As NotesDXLExporter
Set exporter = session.CreateDXLExporter
exporter.ValidationStyle = VALIDATIONSTYLE_SCHEMA
Call exporter.SetInput(db)
Call exporter.SetOutput(stream)
Call exporter.Process
End Sub
195
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Domino Designer
Script Libraries for Web Services
Notes Domino Designer 7.0 supports the use of script libraries for web services.
The Port type class (sometimes called the implementation class) is specified in the Basics tab of the web services
properties box. This class may be defined in the web service "declarations" object, or it may be defined in an included
script library.
The following must be defined in the same location as the Port type class:
�
all namespace constants
�
all enumeration classes and their associated "List" object and constants
Class types that are used to define other classes may be inherited across script libraries. They must be included, but
need not be in a single library.
Example:
This web service defines the PortType1 class, which has a single function, Foo, that takes two string inputs, and returns a value of type Twostrings. The class Twostrings is defined in the library2 script library. %INCLUDE "lsxsd.lss"
%INCLUDE "library2.lss"
Class PortType1
Sub NEW
End Sub
Function Foo(input1 As String, input2 As String) As Twostrings
End Function
End Class
library2:
Class Twostrings
Public stringone As String
Public stringtwo As String
Sub NEW
End Sub
Public Property Get String1Prop As String
Let String1Prop = stringone
End Property
Public Property Set String1Prop As String
Let stringone = String1Prop
End Property
Public Property Get String2Prop As String
Let String2Prop = stringtwo
End Property
Public Property Set String2Prop As String
Let stringtwo = String2Prop
End Property
End Class
196
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Domino Designer
Server requirements for running a Java program
In the server Notes.ini file, the JavaMaxHeapsize should not be decreased below a value of 64M, or a runtime error will
occur when attempting to execute nhttp.exe. If a value for JavaMaxHeapsize is not set in the server Notes.ini file, a
value of 64M will be used.
Domino Designer
Shared columns
Shared columns allow the creation of a common column for insertion in multiple views in the same database,
eliminating the need to create the same column multiple times and creating a single point for propagating changes to
all views using the same column. A shared column has its own design element but once inserted into a view is part of
the view. A view containing a shared column is backwards compatible for access from Notes and the Web.
To create a new shared column, select Columns under Shared Code. Click New Shared Column or choose Create Design - Shared Column. You can also copy and paste an existing Shared Column design element.
To create a new shared column based on the design of an existing column in a view, open the view, select the column,
and choose Create - Copy As Shared Column. This action creates a new shared column and leaves the existing view
column as is.
The Shared Column design element has the same appearance and column properties as an unshared column in a
view.
In addition, the Shared Column design element has properties specific to shared columns. The Shared Column
properties box specifies the name of the shared column (required), an alias (optional), and a comment (optional).
To use a shared column in a view, open the view and choose Create - Insert Shared Column or Create - Append Shared
Column. Select the shared column from the displayed list. Check the Use Formula Only box if you want to override the
shared column display properties, such as font and column alignment, in the view. Leave the box unchecked to lock
the display properties. The column programmatic name can always be modified even if the Use Formula Only box is
not checked, but you should change this name only if it duplicates the programmatic name of another column in the
view. You cannot modify the column value (formula).
To see the names of the views using a shared column, select the shared column in Columns under Shared Code and
click Who is using this Shared Column.
To edit a shared column, double-click the Shared Column design element in Columns under Shared Code. You can
also edit a shared column by selecting it in a view and choosing Design - Edit Shared Column.
When an existing shared column is edited and saved, all views containing the column are updated. These views are
resaved with the current user ID. Where Use Formula Only is checked, only the formula is updated.
To delete a shared column, select the Shared Column design element. Press Delete or choose Edit - Delete. When a
shared column is deleted, the shared column is changed to an unshared column in all views containing the column.
Shared columns may be used in DB2 Query views.
Shared columns, like shared fields, are not multilingual elements.
197
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Domino Web Access Help
Domino Web Access
Certificate information stored in Contact document
Certificate information for each contact is stored on the Certificates tab, and can include their Notes certified public
key, Notes flat name key, and their Internet certificate. You use certificates to encrypt messages that you send. For
example, when you send an encrypted message, you encrypt the message with the recipient's public key. If you want
to send someone encrypted mail, but you don't have that person's Notes public key, have them send you a message
that is signed using their Notes Private key. Then, when you receive the message, add the name to your Contacts.
When you add a sender to Contacts, the e-mail address and either the Notes Certificate or the Internet Certificate used
to sign the message is automatically included when the Contact document is created.
For more information about how Domino Web Access uses certificates, see the help topics:
�
�
How Domino Web Access Uses Public and Private Keys
Add Sender to Contacts
Domino Web Access
Errata: Changing Calendar Display Preferences
In the topic "Changing Calendar Display Preferences" the Calendar Display Options include duplicate text. Use these options instead:
Calendar Display Options
You can set the following Calendar display options:
�
�
�
�
�
When displaying days of the week in Calendar views -- select the starting day of the week for each of the
Calendar views.
When displaying times in Calendar view -- select the time to start displaying times in your Calendar, and
select the time to stop displaying times in your Calendar.
Display 24 hours -- Check this (default) to see 24 hours displayed in your Calendar.
Each Calendar time slot lasts -- Set time slots to 15, 30, or 60 minutes (the default is 60).
Disable drag and drop and in-place editing -- If you check this option you will not be able to drag a Calendar
entry to a time slot, or edit a Calendar entry in the Calendar view. On lower end machines, disabling this
feature may improve performance.
Domino Web Access
Filter mail using blacklists and whitelists
The following information was inadvertantly omitted from the Domino Web Access help.
To help filter out unwanted e-mail, the Domino server can be configured to use blacklists to specify hosts or domains responsible for sending unwanted e-mail to you. When blacklist filters are enabled, any e-mail from a host on the blacklist is tagged. Although you cannot see the tag, your Notes mail system recognizes it and you can create a mail rule to act on messages that have a blacklist tag. For example, you may want to create a rule that sends all blacklist tagged e-mails to a folder called SPAM:
WHEN Blacklist contains SpamCop THEN move to folder SPAM
In addition to blacklists, Domino also tags e-mails with whitelist tags. A whitelist is a list of exceptions to hosts or
domains on a blacklist. To take advantage of the Domino server's whitelist, you can set a mail rule to act on messages
that have a whitelist tag.
If blacklist and whitelist filters are enabled on the Domino server, your Domino Administrator can supply you with the
list of names on the lists. You can also find this information in the Domino Directory. To view the lists, open the
Domino Directory (NAMES.NSF) and expand Configurations. Open the server Configurations document - Router/SMTP
- Restrictions and controls - SMTP Inbound Controls. The lists display under the DNS Blacklist Filters and DNS
Whitelist Filters.
198
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 4 - Documentation updates
Domino Web Access
Valid internet certificate cannot be located
If you get a "Valid internet certificate cannot be located" error message, it may be that an Internet certificate does not
exist, or an Internet certificate exists but the cross certificate does not exist.
199
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
Chapter 5 - Notices and Trademarks
Licensing information
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
License agreement
Any information or reference related to license terms in this document is provided to you for your information.
However, your use of Notes and Domino, and any other IBM program referenced in this document, is solely subject to
the terms and conditions of the IBM International Program License Agreement (IPLA) and related License Information
(LI) document accompanying each such program. You may not rely on this document should there be any questions
concerning your right to use Notes and Domino. Please refer to the IPLA and LI document for Notes and Domino that
is located in the license.txt file.
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
Domino includes DB2 UDB components
Your copy of Domino includes some components of the IBM DB2 Universal Database (DB2 UDB); it's usage is defined
in the IBM Lotus Domino program license agreement.
If your requirements for using DB2 UDB exceed the rights specified in the program license agreement, please contact
your DB2 Reseller to obtain a full DB2 UDB program.
Licensing information - Excluded Components
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
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.
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
Apache Axis 1.1 information
The Apache Software is used in support of the Open Source code called Apache Axis 1.1.
The Apache Software License, Version 1.1
Copyright (c) 2001-2003 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.
201
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided with the distribution.
3. The end-user documentation included with the redistribution, if any, must include the following acknowledgment:
"This product includes software developed by the Apache Software Foundation (http://www.apache.org/)."
Alternately, this acknowledgment may appear in the software itself, if and wherever such third-party acknowledgments
normally appear.
4. The names "Axis" and "Apache Software Foundation" must not be used to endorse or promote products derived from
this software without prior written permission. For written permission, please contact [email protected]
5. Products derived from this software may not be called "Apache", nor may "Apache" appear in their name, without
prior written permission of the Apache Software Foundation.
THIS SOFTWARE IS PROVIDED ``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 Apache Software
Foundation. For more information on the Apache Software Foundation, please see <http://www.apache.org/>.
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
DNS Resolver software information
DNS Resolver
Copyright (c) 1980, 1983, 1988, 1993
The Regents of the University of California. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following
disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software must display the following acknowledgement:
This product includes software developed by the University of California, Berkeley and its contributors.
4. Neither the name of the University nor the names of its contributors may be used to endorse or promote products
derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS 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 REGENTS OR 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.
Portions Copyright (c) 1993 by Digital Equipment Corporation.
202
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted,
provided that the above copyright notice and this permission notice appear in all copies, and that the name of Digital
Equipment Corporation not be used in advertising or publicity pertaining to distribution of the document or software
without specific, written prior permission.
THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL WARRANTIES WITH REGARD
TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT
SHALL DIGITAL EQUIPMENT CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, 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.
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
Independent JPEG Group software information
The Independent JPEG Group's JPEG software
=============================
README for release 6 of 2-Aug-95
=============================
This distribution contains the sixth public release of the Independent JPEG Group's free JPEG software. You are
welcome to redistribute this software and to use it for any purpose, subject to the conditions under LEGAL ISSUES,
below.
Serious users of this software (particularly those incorporating it into larger programs) should contact IJG at
[email protected] to be added to our electronic mailing list. Mailing list members are notified of updates and
have a chance to participate in technical discussions, etc.
This software is the work of Tom Lane, Philip Gladstone, Luis Ortiz, Jim Boucher, Lee Crocker, Julian Minguillon,
George Phillips, Davide Rossi, Ge' Weijers, and other members of the Independent JPEG Group.
IJG is not affiliated with the official ISO JPEG standards committee.
DOCUMENTATION ROADMAP
==========================
This file contains the following sections:
OVERVIEW
LEGAL ISSUES
REFERENCES
ARCHIVE LOCATIONS
RELATED SOFTWARE
FILE FORMAT WARS
TO DO
General description of JPEG and the IJG software.
Copyright, lack of warranty, terms of distribution.
Where to learn more about JPEG.
Where to find newer versions of this software.
Other stuff you should get.
Software *not* to get.
Plans for future IJG releases.
Other documentation files in the distribution are:
User documentation:
install.doc
How to configure and install the IJG software.
usage.doc
Usage instructions for cjpeg, djpeg, jpegtran, rdjpgcom, and wrjpgcom.
*.1
UNIX-style man pages for programs (same info as usage.doc).
wizard.doc
Advanced usage instructions for JPEG wizards only.
change.log
Version-to-version change highlights.
Programmer and
libjpeg.doc
example.c
structure.doc
filelist.doc
coderules.doc
internal documentation:
How to use the JPEG library in your own programs.
Sample code for calling the JPEG library.
Overview of the JPEG library's internal structure.
Road map of IJG files.
Coding style rules --- please read if you contribute code.
203
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
Please read at least the files install.doc and usage.doc. Useful information can also be found in the JPEG FAQ
(Frequently Asked Questions) article. See ARCHIVE LOCATIONS below to find out where to obtain the FAQ article.
If you want to understand how the JPEG code works, we suggest reading one or more of the REFERENCES, then
looking at the documentation files (in roughly the order listed) before diving into the code.
OVERVIEW
==========
This package contains C software to implement JPEG image compression and decompression. JPEG (pronounced
"jay-peg") is a standardized compression method for full-color and gray-scale images. JPEG is intended for
compressing "real-world" scenes; line drawings, cartoons and other non-realistic images are not its strong suit. JPEG
is lossy, meaning that the output image is not exactly identical to the input image. Hence you must not use JPEG if
you
have to have identical output bits. However, on typical photographic images, very good compression levels can be
obtained with no visible change, and remarkably high compression levels are possible if you can tolerate a low-quality
image. For more details, see the references, or just experiment with various compression settings.
This software implements JPEG baseline, extended-sequential, and progressive compression processes. Provision is
made for supporting all variants of these processes, although some uncommon parameter settings aren't
implemented yet. For legal reasons, we are not distributing code for the arithmetic-coding variants of JPEG; see
LEGAL ISSUES. We have made no provision for supporting the hierarchical or lossless processes defined in the
standard.
We provide a set of library routines for reading and writing JPEG image files, plus two sample applications "cjpeg" and
"djpeg", which use the library to perform conversion between JPEG and some other popular image file formats. The
library is intended to be reused in other applications.
In order to support file conversion and viewing software, we have included considerable functionality beyond the bare
JPEG coding/decoding capability; for example, the color quantization modules are not strictly part of JPEG decoding,
but they are essential for output to colormapped file formats or colormapped displays. These extra functions can be
compiled out of the library if not required for a particular application. We have also included "jpegtran", a utility for
lossless transcoding between different JPEG processes, and "rdjpgcom" and "wrjpgcom", two simple applications for
inserting and extracting textual comments in JFIF files.
The emphasis in designing this software has been on achieving portability and flexibility, while also making it fast
enough to be useful. In particular, the software is not intended to be read as a tutorial on JPEG. (See the
REFERENCES section for introductory material.) Rather, it is intended to be reliable, portable, industrial-strength
code. We do not claim to have achieved that goal in every aspect of the software, but we strive for it.
We welcome the use of this software as a component of commercial products. No royalty is required, but we do ask
for an acknowledgement in product documentation, as described under LEGAL ISSUES.
LEGAL ISSUES
=============
In plain English:
1. We don't promise that this software works. (But if you find any bugs, please let us know!)
2. You can use this software for whatever you want. You don't have to pay us.
3. You may not pretend that you wrote this software. If you use it in a program, you must acknowledge somewhere in
your documentation that you've used the IJG code.
In legalese:
The authors make NO WARRANTY or representation, either express or implied, with respect to this software, its
quality, accuracy, merchantability, or fitness for a particular purpose. This software is provided "AS IS", and you,
its user, assume the entire risk as to its quality and accuracy.
204
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
This software is copyright (C) 1991, 1992, 1993, 1994, 1995, Thomas G. Lane.
All Rights Reserved except as specified below.
Permission is hereby granted to use, copy, modify, and distribute this software (or portions thereof) for any purpose,
without fee, subject to these conditions:
(1) If any part of the source code for this software is distributed, then this README file must be included, with this
copyright and no-warranty notice unaltered; and any additions, deletions, or changes to the original files must be
clearly indicated in accompanying documentation.
(2) If only executable code is distributed, then the accompanying documentation must state that "this software is
based in part on the work of the Independent JPEG Group".
(3) Permission for use of this software is granted only if the user accepts full responsibility for any undesirable
consequences; the authors accept NO LIABILITY for damages of any kind.
These conditions apply to any software derived from or based on the IJG code, not just to the unmodified library. If
you use our work, you ought to acknowledge us.
Permission is NOT granted for the use of any IJG author's name or company name in advertising or publicity relating
to this software or products derived from it. This software may be referred to only as "the Independent JPEG Group's
software".
We specifically permit and encourage the use of this software as the basis of commercial products, provided that all
warranty or liability claims are assumed by the product vendor.
ansi2knr.c is included in this distribution by permission of L. Peter Deutsch, sole proprietor of its copyright holder,
Aladdin Enterprises of Menlo Park, CA. ansi2knr.c is NOT covered by the above copyright and conditions, but instead
by the usual distribution terms of the Free Software Foundation; principally, that you must include source code if you
redistribute it. (See the file ansi2knr.c for full details.) However, since ansi2knr.c is not needed as part of any
program generated from the IJG code, this does not limit you more than the foregoing paragraphs do.
The configuration script "configure" was produced with GNU Autoconf. It is copyright by the Free Software Foundation
but is freely distributable.
It appears that the arithmetic coding option of the JPEG spec is covered by patents owned by IBM, AT&T, and
Mitsubishi. Hence arithmetic coding cannot legally be used without obtaining one or more licenses. For this reason,
support for arithmetic coding has been removed from the free JPEG software. (Since arithmetic coding provides only a
marginal gain over the unpatented Huffman mode, it is unlikely that very many implementations will support it.) So
far as we are aware, there are no patent restrictions on the remaining code.
WARNING: Unisys has begun to enforce their patent on LZW compression against GIF encoders and decoders. You
will need a license from Unisys to use the included rdgif.c or wrgif.c files in a commercial or shareware application. At
this time, Unisys is not enforcing their patent against freeware, so distribution of this package remains legal.
However, we intend to remove GIF support from the IJG package as soon as a suitable replacement format becomes
reasonably popular.
We are required to state that:
"The Graphics Interchange Format(c) is the Copyright property of CompuServe Incorporated.
GIF(sm) is a Service Mark property of CompuServe Incorporated."
REFERENCES
=============
We highly recommend reading one or more of these references before trying to understand the innards of the JPEG
software.
The best short technical introduction to the JPEG compression algorithm is
Wallace, Gregory K. "The JPEG Still Picture Compression Standard",
Communications of the ACM, April 1991 (vol. 34 no. 4), pp. 30-44.
(Adjacent articles in that issue discuss MPEG motion picture compression, applications of JPEG, and related topics.)
If you don't have the CACM issue handy, a PostScript file containing a revised version of Wallace's article is available
at ftp.uu.net, graphics/jpeg/wallace.ps.gz. The file (actually a preprint for an article that appeared in IEEE Trans.
Consumer Electronics) omits the sample images that appeared in CACM, but it includes corrections and some added
material. Note: the Wallace article is copyright ACM and IEEE, and it may not be used for commercial purposes.
205
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
A somewhat less technical, more leisurely introduction to JPEG can be found in "The Data Compression Book" by Mark
Nelson, published by M&T Books (Redwood City, CA), 1991, ISBN 1-55851-216-0. This book provides good
explanations and example C code for a multitude of compression methods including JPEG. It is an excellent source if
you are comfortable reading C code but don't know much about data compression in general. The book's JPEG
sample code is far from industrial-strength, but when you are ready to look at a full implementation, you've got one
here...
The best full description of JPEG is the textbook "JPEG Still Image Data Compression Standard" by William B.
Pennebaker and Joan L. Mitchell, published by Van Nostrand Reinhold, 1993, ISBN 0-442-01272-1. Price US$59.95,
638 pp. The book includes the complete text of the ISO JPEG standards (DIS 10918-1 and draft DIS 10918-2). This
is by far the most complete exposition of JPEG in existence, and we highly recommend it.
The JPEG standard itself is not available electronically; you must order a paper copy through ISO. (Unless you feel a
need to own a certified official copy, we recommend buying the Pennebaker and Mitchell book instead; it's much
cheaper and includes a great deal of useful explanatory material.) In the US, copies of the standard may be ordered
from ANSI Sales at (212) 642-4900, or from Global Engineering Documents at (800) 854-7179. (ANSI doesn't take
credit card orders, but Global does.) It's not cheap: as of 1992, ANSI was charging $95 for Part 1 and $47 for Part 2,
plus 7% shipping/handling. The standard is divided into two parts, Part 1 being the actual specification, while Part 2
covers compliance testing methods. Part 1 is titled "Digital Compression and Coding of Continuous-tone Still Images,
Part 1: Requirements and guidelines" and has document number ISO/IEC IS 10918-1. Part 2 is titled "Digital
Compression and Coding of Continuous-tone Still Images, Part 2: Compliance testing" and has document number
ISO/IEC IS 10918-2.
Extensions to the original JPEG standard are defined in Part 3, a new ISO document. Part 3 is undergoing ISO
balloting and is expected to be approved by the end of 1995. IJG currently does not support any Part 3 extensions.
The JPEG standard does not specify all details of an interchangeable file format. For the omitted details we follow the
"JFIF" conventions, revision 1.02. A copy of the JFIF spec is available from:
Literature Department
C-Cube Microsystems, Inc.
1778 McCarthy Blvd.
Milpitas, CA 95035
phone (408) 944-6300, fax (408) 944-6314
A PostScript version of this document is available at ftp.uu.net, file graphics/jpeg/jfif.ps.gz. It can also be obtained by
e-mail from the C-Cube mail server, [email protected] Send the message "send jfif_ps from jpeg" to the server to
obtain the JFIF document; send the message "help" if you have trouble.
The TIFF 6.0 file format specification can be obtained by FTP from sgi.com (192.48.153.1), file
graphics/tiff/TIFF6.ps.Z; or you can order a printed copy from Aldus Corp. at (206) 628-6593. The JPEG
incorporation scheme found in the TIFF 6.0 spec of 3-June-92 has a number of serious problems. IJG does not
recommend use of the TIFF 6.0 design (TIFF Compression tag 6). Instead, we recommend the JPEG design proposed
by TIFF Technical Note #2 (Compression tag 7). Copies of this Note can be obtained from sgi.com or from
ftp.uu.net:/graphics/jpeg/. It is expected that the next revision of the TIFF spec will replace the 6.0 JPEG design with
the Note's design. Although IJG's own code does not support TIFF/JPEG, the free libtiff library uses our library to
implement TIFF/JPEG per the Note. libtiff is available
from sgi.com:/graphics/tiff/.
ARCHIVE LOCATIONS
====================
The "official" archive site for this software is ftp.uu.net (Internet address 192.48.96.9). The most recent released
version can always be found there in directory graphics/jpeg. This particular version will be archived as
graphics/jpeg/jpegsrc.v6.tar.gz. If you are on the Internet, you can retrieve files from ftp.uu.net by standard
anonymous FTP. If you don't have FTP access, UUNET's archives are also available via UUCP; contact
[email protected] for information on retrieving files that way.
Numerous Internet sites maintain copies of the UUNET files; in particular, you can probably find a copy at any site
that archives comp.sources.misc submissions. However, only ftp.uu.net is guaranteed to have the latest official
version.
206
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
You can also obtain this software in DOS-compatible "zip" archive format from the SimTel archives
(ftp.coast.net:/SimTel/msdos/graphics/), or on CompuServe in the GRAPHSUPPORT forum (GO GRAPHSUP), library
12 "JPEG Tools". Again, these versions may sometimes lag behind the ftp.uu.net release.
The JPEG FAQ (Frequently Asked Questions) article is a useful source of general information about JPEG. It is
updated constantly and therefore is not included in this distribution. The FAQ is posted every two weeks to Usenet
newsgroups comp.graphics, news.answers, and other groups. You can always obtain the latest version from the
news.answers archive at rtfm.mit.edu. By FTP, fetch /pub/usenet/news.answers/jpeg-faq/part1 and .../part2. If you
don't have FTP, send e-mail to [email protected] with body
send usenet/news.answers/jpeg-faq/part1
send usenet/news.answers/jpeg-faq/part2
RELATED SOFTWARE
====================
Numerous viewing and image manipulation programs now support JPEG. (Quite a few of them use this library to do
so.) The JPEG FAQ described above lists some of the more popular free and shareware viewers, and tells where to
obtain them on Internet.
If you are on a UNIX machine, we highly recommend Jef Poskanzer's free PBMPLUS image software, which provides
many useful operations on PPM-format image files. In particular, it can convert PPM images to and from a wide
range of other formats. You can obtain this package by FTP from ftp.x.org (contrib/pbmplus*.tar.Z) or ftp.ee.lbl.gov
(pbmplus*.tar.Z). There is also a newer update of this package called NETPBM, available from wuarchive.wustl.edu
under directory /graphics/graphics/packages/NetPBM/. Unfortunately PBMPLUS/NETPBM is not nearly as portable
as the IJG software is; you are likely to have difficulty making it work on any non-Unix machine.
A different free JPEG implementation, written by the PVRG group at Stanford, is available from havefun.stanford.edu in
directory pub/jpeg. This program is designed for research and experimentation rather than production use; it is
slower, harder to use, and less portable than the IJG code, but it is easier to read and modify. Also, the PVRG code
supports lossless JPEG, which we do not.
FILE FORMAT WARS
===================
Some JPEG programs produce files that are not compatible with our library. The root of the problem is that the ISO
JPEG committee failed to specify a concrete file format. Some vendors "filled in the blanks" on their own, creating
proprietary formats that no one else could read. (For example, none of the early commercial JPEG implementations
for the Macintosh were able to exchange compressed files.)
The file format we have adopted is called JFIF (see REFERENCES). This format has been agreed to by a number of
major commercial JPEG vendors, and it has become the de facto standard. JFIF is a minimal or "low end"
representation.
We recommend the use of TIFF/JPEG (TIFF revision 6.0 as modified by TIFF Technical Note #2) for "high end"
applications that need to record a lot of additional data about an image. TIFF/JPEG is fairly new and not yet widely
supported, unfortunately.
The upcoming JPEG Part 3 standard defines a file format called SPIFF. SPIFF is interoperable with JFIF, in the sense
that most JFIF decoders should be able to read the most common variant of SPIFF. SPIFF has some technical
advantages over JFIF, but its major claim to fame is simply that it is an official standard rather than an informal one.
At this point it is unclear whether SPIFF will supersede JFIF or whether JFIF will remain the de-facto standard. IJG
intends to support SPIFF once the standard is frozen, but we have not decided whether it should become our default
output format or not. (In any case, our decoder will remain capable of reading JFIF indefinitely.)
Various proprietary file formats incorporating JPEG compression also exist. We have little or no sympathy for the
existence of these formats. Indeed, one of the original reasons for developing this free software was to help
force convergence on common, open format standards for JPEG files. Don't use a proprietary file format!
207
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
TO DO
======
In future versions, we are considering supporting some of the upcoming JPEG Part 3 extensions --- principally,
variable quantization and the SPIFF file format.
Tuning the software for better behavior at low quality/high compression settings is also of interest. The current
method for scaling the quantization tables is known not to be very good at low Q values.
As always, speeding things up is high on our priority list.
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
InstallShield information
The InstallShield Program includes "UnZipSFX stub" software from the Info-Zip group which is Copyright (c) 1999-2002, Info-ZIP. All rights reserved. IBM did not modify the UnZipSFX software. There are no extra charges or costs due to the use of this code, and the original compression sources are freely available from http://www.info-zip.org/ on the Internet.
================
UnZipSFX Stub file
Copyright (c) 1990-2002 Info-ZIP. All rights reserved.
For the purposes of this copyright and license, "Info-ZIP" is defined as the following set of individuals: Mark Adler, John Bush, Karl Davis, Harald Denker, Jean-Michel Dubois, Jean-loup Gailly, Hunter Goatley, Ian Gorman, Chris Herborth, Dirk Haase, Greg Hartwig, Robert Heath, Jonathan Hudson, Paul Kienitz, David Kirschbaum, Johnny Lee, Onno van der Linden, Igor Mandrichenko, Steve P. Miller, Sergio Monesi, Keith Owens, George Petrov, Greg Roelofs, Kai Uwe Rommel, Steve Salisbury, Dave Smith, Christian Spieler, Antoine Verheijen, Paul von Behren, Rich Wales, Mike White This software is provided "as is," without warranty of any kind, express or implied. In no event shall Info-ZIP or its contributors be held liable for any direct, indirect, incidental, special or consequential damages arising out of the use of or inability to use this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: 1. Redistributions of source code must retain the above copyright notice, definition, disclaimer, and this list of
conditions.
2. Redistributions in binary form (compiled executables) must reproduce the above copyright notice, definition,
disclaimer, and this list of conditions in documentation and/or other materials provided with the distribution.
The sole exception to this condition is redistribution of a standard UnZipSFX binary as part of a self-extracting
archive; that is permitted without inclusion of this license, as long as the normal UnZipSFX banner has not
been removed from the binary or disabled.
3. Altered versions--including, but not limited to, ports to new operating systems, existing ports with new
graphical interfaces, and dynamic, shared, or static library versions--must be plainly marked as such and must
not be misrepresented as being the original source. Such altered versions also must not be misrepresented as
being Info-ZIP releases--including, but not limited to, labeling of the altered versions with the names "Info-ZIP"
(or any variation thereof, including, but not limited to, different capitalizations), "Pocket UnZip," "WiZ" or
"MacZip" without the explicit permission of Info-ZIP. Such altered versions are further prohibited from
misrepresentative use of the Zip-Bugs or Info-ZIP e-mail addresses or of the Info-ZIP URL(s).
4. Info-ZIP retains the right to use the names "Info-ZIP," "Zip," "UnZip," "UnZipSFX," "WiZ," "Pocket UnZip," "Pocket
Zip," and "MacZip" for its own source and binary releases.
208
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline Services (DOLS), Domino for z/OS, Domino for i5/OS
Net-SNMP software information
Various copyrights apply to this package, listed in 3 separate parts below. Please make sure that you read all the parts. Up until 2001, the project was based at UC Davis, and the first part covers all code written during this time. From 2001 onwards, the project has been based at SourceForge, and Networks Associates Technology, Inc. hold the copyright on behalf of the wider Net-SNMP community, covering all derivative work done since then. An additional copyright section has been added as Part 3 below also under a BSD license for the work contributed by Cambridge Broadband Ltd. to the project since 2001.
Code has been contributed to this project by many people over the years it has been in development, and a full list of contributors can be found in the README file under the THANKS section.
---- Part 1: CMU/UCD copyright notice: (BSD like) ----­
Copyright 1989, 1991, 1992 by Carnegie Mellon University
Derivative Work - 1996, 1998-2000
Copyright 1996, 1998-2000 The Regents of the University of California
All Rights Reserved
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 that copyright notice and
this permission notice appear in supporting documentation, and that the name of CMU and The Regents of the
University of California not be used in advertising or publicity pertaining to distribution of the software without specific
written permission.
CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL CMU
OR THE REGENTS OF THE UNIVERSITY OF CALIFORNIA BE LIABLE FOR ANY SPECIAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM THE 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.
---- Part 2: Networks Associates Technology, Inc copyright notice (BSD) ----­
Copyright (c) 2001-2003, Networks Associates Technology, Inc
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
�
Redistributions of source code must retain the above copyright notice, this list of conditions and the following
disclaimer.
�
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.
�
Neither the name of the Networks Associates Technology, Inc nor the names of its contributors may be used to
endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS 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 COPYRIGHT HOLDERS OR
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.
209
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
---- Part 3: Cambridge Broadband Ltd. copyright notice (BSD) ----­
Portions of this code are copyright (c) 2001-2003, Cambridge Broadband Ltd.
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
�
Redistributions of source code must retain the above copyright notice, this list of conditions and the following
disclaimer.
�
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.
�
The name of Cambridge Broadband Ltd. may not be used to endorse or promote products derived from this
software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER ``AS IS'' AND ANY EXPRESS 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 COPYRIGHT HOLDER 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
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline Services (DOLS), Domino for z/OS, Domino for i5/OS
Reg Exp Parser information
Reg Exp Parser
The Apache Software License, Version 1.1
Copyright (c) 1999-2001 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following
disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided with the distribution.
3. The end-user documentation included with the redistribution, if any, must include the following acknowlegement:
"This product includes software developed by the Apache Software Foundation (http://www.apache.org/)."
Alternately, this acknowlegement may appear in the software itself, if and wherever such third-party acknowlegements
normally appear.
4. The names "The Jakarta Project", "Struts", and "Apache Software Foundation" must not be used to endorse or
promote products derived from this software without prior written permission. For written permission, please contact
[email protected]
5. Products derived from this software may not be called "Apache" nor may "Apache" appear in their names without
prior written permission of the Apache Group.
210
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
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 Apache Software
Foundation. For more information on the Apache Software Foundation, please see <http://www.apache.org/>.
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
SNIA/CIMOM information
The Program contains code which is derived from the Storage Network Industry Association's CIMOM code ("the
Modified CIMOM Code"). The Modified CIMOM Code is available in source code form and may be obtained upon
written request to the following address:
Autonomic Management Engine Development
IBM Corp
510/8PIA
PO Box 12195
RTP, NC 27709
The source code version of the Modified CIMOM Code is available under the terms of the SNIA Public License version
1.1 (http://www.opengroup.org/snia-cimom/license.tpl?CALLER=index.tpl). The executable version of the Modified
CIMOM Code is provided under the terms of the Program's license, which are offered by IBM alone, and not by the
Storage Network Industry Association or any other contributor to the CIMOM code.
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
S/MIME license information
The Domino S/MIME implementation uses the S/MIME Freeware Library. The Public License is listed below.
S/MIME FREEWARE LIBRARY (SFL) PUBLIC LICENSE
29 March 2002
The United States Government/Department of Defense/National Security Agency/Office of Network Security
(collectively "the U.S. Government") hereby grants permission to any person obtaining a copy of the SFL source and
object files (the "SFL Software") and associated documentation files (the "SFL Documentation"), or any portions thereof,
to do the following, subject to the following license conditions:
1. You may, free of charge and without additional permission from the U.S. Government, use, copy, modify, sublicense
and otherwise distribute the SFL Software or components of the SFL Software, with or without modifications developed
by you and/or by others.
2. You may, free of charge and without additional permission from the U.S. Government, distribute copies of the SFL
Documentation, with or without modifications developed by you and/or by others, at no charge or at a charge that
covers the cost of reproducing such copies, provided that this SFL Public License is retained.
3. Furthermore, if you distribute the SFL Software or parts of the SFL Software, with or without modifications
developed by you and/or others, then you must either make available the source code to all portions of the SFL
Software (exclusive of any modifications made by you and/or by others) upon request, or instead you may notify
anyone requesting the SFL Software source code that it is freely available from the U.S. Government.
211
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
4. Transmission of this SFL Public License must accompany whatever portions of the SFL Software you redistribute.
5. The SFL Software is provided without warranty or guarantee of any nature, express or implied, including without
limitation the warranties of merchantability and fitness for a particular purpose.
6. The U.S. Government cannot be held liable for any damages either directly or indirectly caused by the use of the
SFL Software.
7. It is not permitted to copy, sublicense, distribute or transfer any of the SFL Software except as expressly indicated
herein. Any attempts to do otherwise will be considered a violation of this License and your rights to the SFL Software
will be voided.
The SFL uses the Enhanced SNACC (eSNACC) Abstract Syntax Notation One(ASN.1) C++ Library to ASN.1 encode and decode security-related data objects. The eSNACC ASN.1 C++ Library is covered by the ENHANCED SNACC SOFTWARE PUBLIC LICENSE. None of the GNU public licenses apply to theeSNACC ASN.1 C++ Library. The eSNACC Compiler is not distributed as part of the SFL. For further information, contact:
[email protected], Getronics Government Solutions
David Dalkowski, [email protected], Department of Defense/V32
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
zlib software information
zlib.h -- interface of the 'zlib' general purpose compression library
version 1.1.4, March 11th, 2002
Copyright (C) 1995-2002 Jean-loup Gailly and Mark Adler
This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable
for any damages arising from the use of 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. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If
you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not
required.
2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original
software.
3. This notice may not be removed or altered from any source distribution.
Jean-loup Gailly [email protected]
Mark Adler [email protected]
212
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
Notices
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
Notices
This information was developed for products and services offered in the USA. IBM may not offer the products, services,
or features discussed in this document in all countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM product, program, or service is not
intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent
product, program, or service that does not infringe any IBM intellectual property right may be used instead. However,
it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The
furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing,
to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in
your country/region or send inquiries, in writing, to:
IBM World Trade Asia Corporation Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
The following paragraph does not apply to the United Kingdom or any other country/region where such provisions are
inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
Some states do not allow disclaimer of express or implied warranties in certain transactions; therefore, this statement
may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the
information herein; these changes will be incorporated in new editions of the publication. IBM may make
improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time
without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner
serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this
IBM product, and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any
obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of
information between independently created programs and other programs (including this one) and (ii) the mutual use
of the information that has been exchanged, should contact:
Lotus Software
IBM Software Group
One Rogers Street
Cambridge, MA 02142
USA
Such information may be available, subject to appropriate terms and conditions, including in some cases payment of
a fee.
213
IBM Lotus Notes, Domino, Domino Designer 7 Release Notes
Chapter 5 - Notices and Trademarks
The licensed program described in this document and all licensed material available for it are provided by IBM under
terms of the IBM Customer Agreement, IBM International Program License Agreement, or by any equivalent
agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in
other operating environments may vary significantly. Some measurements may have been made on development-level
systems, and there is no guarantee that these measurements will be the same on generally available systems.
Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of
this document should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their published
announcements, or other publicly available sources. IBM has not tested those products and cannot confirm the
accuracy of performance, compatibility, or any other claims related to non-IBM products. Questions on the
capabilities of non-IBM products should be addressed to the suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and
represent goals and objectives only.
This information contains examples of data and reports used in daily business operations. To illustrate them as
completely as possible, the examples include the names of individuals, companies, brands, and products. All of these
names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely
coincidental.
Trademarks
Domino Administrator Client, Notes Client, Domino Designer, Domino Server, Domino Web Access, Domino Access for Outlook, Domino Offline
Services (DOLS), Domino for z/OS, Domino for i5/OS
Trademarks
IBM, the IBM logo, AIX, DB2, Domino, Freelance, Freelance Graphics, iSeries, i5/OS, Lotus, Lotus Notes, LotusScript,
Notes, 1-2-3, OS/400, Quickplace, S/390, Sametime, SmartSuite, WebSphere, Workplace, Workplace Managed Client,
z/OS, and zSeries are trademarks or registered trademarks of IBM Corporation in the United States, other countries,
or both.
Additional IBM copyright information can be found at: http://www.ibm.com/legal/copytrade.shtml
Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other
countries, or both.
Microsoft, Windows, and the Windows logo are trademarks of Microsoft 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.
The Graphics Interchange Format(c) is the Copyright property of CompuServe Incorporated. GIF(sm) is a Service
Mark property of CompuServe Incorporated.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Other company, product and service names may be trademarks or service marks of others.
214
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement