Topics

iNotes Web Access - Release Notes for Domino/Notes 5.0.13
iNotes Web Access is a Web client for access to Domino-based mail, calendar, scheduling, and collaboration services. The client uses the latest Domino Server and DOLS (Domino Off-Line Services). It's based on the latest browser technologies to ensure a highly functional and robust product. It offers a subset of the functionality found in the current Notes client with the convenience of the Web. With iNotes Web Access, you can walk up to a Web browser anywhere to send and receive mail, view your calendar, invite people to a meeting, create a task for your To Do list, or access your contact list or journal. You can do all this offline, too.

Getting Help

Before rolling out iNotes Web Access, be sure to read:

• White Paper: iNotes Web Access Deployment Guide (http://www.lotus.com/ldd/notesua.nsf/0b345eb9d127270b8525665d006bc355/dcea56a48a39f14885256b8a0054dafe?OpenDocument&Highlight=0,iNotes) - updated more frequently than the Redbook and may contain last minute information.
• IBM Redbook, iNotes Web Access Deployment and Administration Guide (http://www.redbooks.ibm.com/pubs/pdfs/redbooks/sg246518.pdf) - the complete reference for deploying and administering iNotes Web Access.

Hardware and Software Requirements
Server requirements

• IBM zSeries (S/390) with OS/390
• IBM pSeries (RS/6000) with AIX 4.3.3
• IBM iSeries (AS/400) with OS/400
• Sun Solaris Sparc 7 or 8
• Win32 with Windows 2000, Server or Advanced Server
• Win32 with Windows NT Server 4.0 and Service Pack 4 or higher

• Win32 Internet Explorer 5.01 and Service Pack 1 or later
  

Installing and Configuring the Domino Server

Note: The Spell Checker for iNotes Web Access is not Installed by default. You need to explicitly select the Spell Checker when you install the 5.0.13 Domino server. Spell checker may produce incorrect results for non-Latin-1 languages.
1. Run the Domino/Notes 5.0.13 Server installation.
2. Choose Enterprise installation.
3. Click Customize.
4. Select "iNotes Web Spell Checker" and continue with the installation.

Installing and Configuring the Domino Server
1. Install the Domino 5.0.13 server first, then start the server.
2. When the setup wizard starts, choose First or Additional Domino Server.
3. Choose Advanced Configuration.
4. (Optional) Select Internet mail protocols (IMAP, POP3, SMTP).
5. Enable HTTP and choose an HTTP performance setting.
6. Enable DOLS to support users who will work off-line.
7. Finish the installation following the guidelines in Setting up a Domino Server.

Once you install the Server, you'll need to configure DOLS. Configure DOLS as documented in the Administrator's documentation by creating an Offline Security document.

Configuring and Administering iNotes Web Access

Customizing iNotes Web Access for users
iNotes Web Access allows you to control user settings so you can manage disk space and improve performance on the server. For example, disabling archiving or full-text indexing on the server can save disk space. Specifying a long alarm polling time may improve performance. You can also set the minimum interval that must lapse before users can poll for new mail. To control the opening view, you can specify a Welcome Page URL for all users.

Allow Users to Take the Domino Directory Offline
You can use a NOTES.INI setting to set the name of a Domino directory that the user may take offline.

$DOLSDirectoryCatalog=nameofcatalog.nsf

This setting makes a part of the preference user interface visible, giving users the option of taking the Domino directory or Directory catalog offline.
For example, if NOTES.INI contains $DolsDirectoryCatalog=dc.nsf, the user sees a new preference setting, "Include server's Name and Address Book". If the user enables this setting, the server's dc.nsf will be included among the files when the user goes offline.

For disk space and performance reasons, it's recommended that users take offline the directory catalog rather than the Domino directory.

Disabling the Rich Text Editor
You can edit the NOTES.INI file to turn off the rich text editor when composing mail messages.

iNotes_WA_MessageFormat=1

This setting in the server's NOTES.INI forces users to use only the plain text editor. However, the rich text editor is still available for calendar, notebook, and to do use.

Problems Accessing iNotes Web Access Files Through a Reverse Proxy Server
If users receive "Page Not Found" errors when entering the proper URL to a mail file redirected through a proxy server, try appending "/iNotes/Welcome/?OpenDocument" to the end of the URL. Some older proxy servers do not properly fix HTTP 302 redirect responses, therefore the URL returned to a browser may actually be the non-fixed version of the URL. Entering this more explicit URL will avoid the 302 redirect.

Keep in mind that any iNotes Web Access view page may be easily bookmarked to avoid always typing the full URL.

Check for Newer Versions of Stored Pages Setting
The recommended setting for Internet Explorer browsers is automatically check for newer versions of stored pages. From the browser, choose Tools - Internet Options. On the General tab under Temporary Internet Files, click Settings. Select " Automatically" under Check for newer versions of stored pages"

Changing Settings on the iNotes Web Access Tab
To customize iNotes Web Access for users, edit the Configuration Settings document for the iNotes Web Access server.

1. From the Domino Administrator, click the Configuration tab and expand the Messaging section.

2. Click Configurations.

3. Select the Configuration Settings document for the iNotes Web Access mail server(s) and click Edit Configuration. If there is no Configuration Settings document, see the Domino Administration help documentation for creating a Configuration Settings document.

4. Select the iNotes Web Access tab.

5. Change any of these settings and then save the document:

Setting	Action
Archiving on server	Enable (default) to allow users to create archives of their mail files on the server Disable to prevent creation of mail archives to save disk space on the server.
Full-text indexing	Enable (default) to allow users to create a full-text index of their mail, calendar, and task entries on the server Disable to prevent creation of full-text indexes to save disk space on the server and improve performance.
Modification of Internet password	Enable (default) to allow users to change their Internet password Disable to prevent users from changing their Internet password.
Calendar printing	Enable (default) to allow users to print various calendar formats, including DayRunner, Franklin Planner, and Trifold. Calendar printing uses the PDF format from Adobe Acrobat. Disable to prevent users from printing Calendar formats using PDF. Note PDF printing is not supported in iNotes Web Access for Korean, Japanese, and simplified and traditional Chinese.
Custom ActiveX file attachment utility	Enable (default) to allow users to use the custom file upload utility to drag-and-drop file attachments, select files easily, and have multiple file views. Disable to allow users to use the standard browser file upload utility.
Alarms	Enable (default) to allow users to set alarms for appointments, meetings, events, and task deadlines. Disable to prevent users from setting alarms that may slow server performance.
Alarm polling time	Enter a number to specify how often, in minutes, the iNotes Web Access client checks the server for alarms. Default is 5 minutes. Increase this number to improve server performance.
Minimum allowed mail polling time	Enter a number to specify how often, in minutes, the iNotes Web Access client checks the server for new mail. Default is 5 minutes. To improve server performance, increase the minimum time.
Welcome page URL1	Enter the URL that all iNotes Web Access clients will use as the Welcome Page. Default is no URL.
Welcome page title	Enter the Web page title for the Welcome page that all iNotes Web Access clients will use. Default is no page title.
Alternate name display2	Enable (default) to allow iNotes Web Access users to display alternate names in a native language. Disable to prevent iNotes Web Access from displaying alternate user names in a native language. When disabled, users see alternate names in English only.
Allow user to configure alternate name display setting	Enable to allow alternate name lookups, similar to "type-ahead" in Notes. Lets user resolve ambiguous names and use alternate names by checking names against a contact list or Domino directory. This setting also lets users choose the preferred language for an alternate name. Disable (default) to prevent users from controlling alternate name support.
Allow user to choose the preferred language	This setting enables or disables alternate name support in user Preferences. Enable to allow users to choose the preferred language in which to view alternate names. Disable (default) to prevent users from choosing the preferred language in which to view alternate names.
Alternate name language	This setting overrides the preferred language for an alternate name in user Preferences. Pick from a list to select the default alternate name language . Default is English.
Encrypt offline mail files	Enable to allow users to encrypt their offline mail files. Disable (default) to prevent users from encrypting offline mail files.
Allow user to override offline encryption setting	Enable (default) to allow users to change the offline encryption strength. Disable to prevent users from changing the offline encryption setting.
Disclaimer text	Administrators can choose to attach a disclaimer to email messages when sent from iNotes Web Access users. For example, an administrator may want to add a couple of sentences to cover liability and security for the company. The disclaimer is appended to the email as it is sent, so the originator of the message doesn't see the disclaimer text as they are composing the message. Enter the text that you would like to appear in email messages in HTML format in this field. For example, if you want line breaks to occur in specific places, you need to use the <BR> tag, or if you want to bold text you need to use the <B> tag. If you want to include references to external files within any of the HTML entered in the field, the external files are not packaged up and sent with the message, so if you did include a link reference tag like "<img src="http://www.company.com/logo.gif">," you need to make sure all recipients of any mail originating from iNotes Web Access will be able to reach the URL specified in your disclaimer.

iNotes Web Access NOTES.INI Variables

Variable name	First released	Default	Description
iNotes_WA_DisableActCntSecurity	5.0.8	0	Enables/disables the iNotes Web Access Active Content Filter. A setting of 1 disables the filter. Setting this variable to 0 (or omitting it from the server's NOTES.INI file) enables the filter.
iNotes_WA_NameLookupMaxNumMatch	5.0.9	200	Specifies the maximum number of names to return on a name validation.
iNotes_WA_LogoutRedirect	5.0.10	none	Specifies the URL to redirect users to after logging out from server, doing normal cache clearing with the iNotes control, and clearing browser credentials. This variable allows sites which have additional actions that need to happen on a logout (such as logging out a reverse proxy server) to specify a URL to do this additional activity. Or you can use this variable to return people to an initial login page.
iNotes_WA_MessageFormat	5.0.11	0	Determines whether to use the plain text editor when composing mail messages. Setting this to 1 forces users to use the plain text editor.
iNotes_wa_MaxAttachmentSize	5.0.13	50,000K	Set the maximum attachment size. Note The Maximum POST Data in the Server document must be set to a value higher than this field.

Existing iNotes Web Access related variables
In addition to the above, there are two existing NOTES.INI variables important to the successful operation of iNotes Web Access. These are listed in the following table.

Variable name	First released	Default	Description
$DolsDirectoryCatalog	5.0.10	none	Specifies the name of the Domino directory the user can take off-line. When this variable is set, an option appears on the user preference interface. For example, if NOTES.INI contains $DolsDirectoryCatalog=names.nsf, the user sees a new preference setting, "Include server's Name and Address Book." If the user enables this setting, the server's names.nsf will be included among the files when the user goes off-line. This variable is actually part of Domino Off-Line Services (DOLS). iNotes Web Access uses DOLS to allow users to work off-line.
Log_DirCat	5.0	none	Logs information about the Directory Cataloger task to the Miscellaneous Events view of the log file (LOG.NSF). This lets you monitor the Directory Catalog build process. This is a standard Domino NOTES.INI setting, described in the Domino Administrator's Guide. Set this to 1 for iNotes Web Access.

Known Timezone Problems For Repeating Calendar Entries

The table that follows identifies known problems when a client or server is observing Daylight Savings Time (DST). In summary, repeating calendar entries may be off by one hour in an environment where servers and clients follow different DST rules.

	Client: No DST Observed	Client: DST Rule same as Server*	Client : DST Rule different from server
Server: No DST Observed	Repeating calendar entries work correctly.	Not Applicable	Repeating calendar entries do not work correctly.
Server: Some DST Observed	Repeating calendar entries work correctly.	Repeating calendar entries work correctly.	Repeating calendar entries work do not work correctly.

* DST Rule same as server means that the rule that specifies the Month, the week within the month, and the day of the week when a location starts observing daylight savings time and when it stops observing daylight savings time is the same on both the client and the server.

Setting the Server to UTF-8 so Users can Save Documents in Multiple Languages
There is a default setting in the HTTP server that limits the server's ability to save documents created by a web client in languages other than English. You need to switch the HTTP server to speak in UTF-8 language instead of ASCII. Here's how:

1. From the Domino Administrator, click the Configuration Tab.

2. Click Server, then All Server Documents.

3. Open the Web Server Document (for the server on which you are running the HTTP task) and click Edit Server.

4. Select the Internet Protocols tab, then the Web Engine tab.

5. Select "Yes" for the option: "Use UTF-8 for output:"

Installing and Configuring the Sametime Server

iNotes Web Access integrates Sametime 2.0 or 2.5 so that users can send and receive instant messages. Sametime is called "Chat" in iNotes Web Access.

Do not install Sametime and iNotes Web Access on the same Domino server. Sametime must be installed on a dedicated server. For complete information on installing Sametime, see the Sametime Installation Guide.

Part 1 - Setup a Domino Server
1. Install and configure a Domino 5.0.13 server.

2. Register users with the iNotes Web Access (R5) mail template.

Part 2 - Create a Connection document on the iNotes Web Access server
1. From the Domino Administrator, click the Configuration tab.

2. Select the iNotes Web Access server's Domino Directory in the "Use Directory on" field.

3. Click Server, and then click Connections.

4. Click Add Connection.

5. Select Local Area Network in the "Connection type" field.

6. Enter the Sametime server's name in the "Destination server" field. For example: Sametime/Acme.

7. Enter the source domain of the iNotes Web Access server and the destination domain of the Sametime server. The domain must be the same in both fields.

8. Click Save & Close.

Part 3 - Edit each user's Person document and specify the Sametime server in the "Sametime server" field.
1. From the Domino Administrator, click the People & Groups tab.

2. Select the iNotes Web Access Domino directory, then click People.

3. Double-click a name to open the user's Person document.

4. Click Edit.

5. Enter the name of the Sametime server in canonical format in the "Sametime server" field. For example, the canonical format for the server Sametime/Sales/Acme/UK is:

CN=Sametime/OU=Sales/O=Acme/C=US

where: CN is the common name, OU is the organizational unit, O is the organization, and C is the country code

6. Click Save & Close.

7. Repeat Steps 3 though 6 for each person.

Part 4 - Set up the Sametime server
Follow the instructions in the Sametime Installation Guide for installing Sametime in a Domino domain on a dedicated server. Make sure that the installation uses the same Domino domain in which the iNotes Web Access server resides.

Part 5 - Create a Connection Document on the Sametime server
1. From the Domino Administrator, click the Configuration tab.

2. Select the Sametime server's Domino Directory in the "Use Directory on" field.

3. Click Server, and then click Connections.

4. Click Add Connection.

5. Select Local Area Network in the "Connection type" field.

6. Enter the iNotes Web Access server's name in the "Destination server" field.

7. Enter the source domain of the Sametime server and the destination domain of the iNotes Web Access server.

8. Click Save & Close.

Part 6 - Create a one-time replica of the Tokens database on the iNotes Web Access server
The Sametime server implements a security policy to ensure Sametime clients that establish connections to the Sametime services are authenticated. This security policy involves the Secrets (stauths.nsf) database on the Sametime server.

1. Using a Notes client, choose File - Database - Open.

2. Enter the name of the Sametime server (for example, Sametime/Acme).

3. Enter the Secrets database filename: stauths.nsf

4. Click Open.

5. Choose File -Replication - New Replica.

6. Enter the name of the iNotes Web Access server (for example, iNotes/Acme)

7. Ensure that the database is replicated to the data directory: ...\domino\data\stauths.nsf.

8. Click OK to create the replica.

Part 7 - Push replication changes from the iNotes Web Access server to the Sametime server
1. From the Domino Administrator, click the Server tab.

2. Click the Server Console.

3. Enter a push command to replicate the Domino directory to the Sametime server.

For example: push Sametime/Acme names.nsf

4. Click Send.

Enter a push command to replicate the Tokens database to the Sametime server.

For example: push Sametime/Acme stauths.nsf

5. Click Send.

Part 8 - Copy the Sametime applets to the Sametime server
1. Copy the contents from the Sametime applets folder on the iNotes Web Access server to the Sametime server. On the iNotes Web Access server, the applets are located in the "SametimeApplet" directory:

<data directory>\domino\html\SametimeApplet

2. Create a folder on the Sametime server in which to copy the iNotes Web Access Sametime applet files. At a DOS prompt on the Sametime server, create the folder:

3. >mkdir <data directory>\domino\html\SametimeApplet

Note The folder name is case-sensitive and must be named "SametimeApplet".

Part 9 - Verify that Sametime works with iNotes Web Access
1. Make sure that replication is complete and the Person documents exist on the Sametime server.

2. Following the instructions in the Sametime Installation Guide for logging into the Sametime server using the Sametime Connect Client. Sametime must be functioning properly before you can test whether it is working with iNotes Web Access clients.

3. Launch iNotes Web Access in a browser and click "Chat" to test the Sametime connection.

Note If the chat link does not appear in iNotes Web Access, check the user's Person document in the Domino directory. Verify that the name of the Sametime server in the Sametime server field is correct.

Setting up iNotes Web Access and Domino Off-Line Services

With DOLS, users can take iNotes Web Access offline, perform changes to mail, calendar, and so on, and synchronize the changes with an online replica. Users are not required to have Notes to use DOLS. DOLS supports full data replication, retains application logic, and supports the full Notes security model. Before deploying iNotes Web Access for offline use, you must review the DOLS topics in Domino Administration Help. It is also recommended that you read the "DOLS Issues" section of the Domino Release Notes.

If DOLS was not selected when you installed the server, you can still enable DOLS on the server:

1. Open the Server document, click the Internet Protocol tab, then the HTTP tab.
2. In the "DSAPI filter file names" field, enter the appropriate file name (see table below) for the operating system running on your iNotes Web Access server.


Operating System	DSAPI Filter File Name
WIN32	ndolextn
OS/400	libdolextn
AIX	libdolextn
OS/390	libdolextn
Solaris Sparc 7 or 8	libdolextn

3. Create a DOLADMIN.NSF database from the DOLADMIN template and name the database "Offline Services".
4. Restart the Domino Administrator Client.
5. Click the Configuration tab, and select "Offline Services."
6. Create an Offline Security Policy document and save.

Providing a log-on URL for iNotes users

After you upgrade existing users or register new users, they will need three things to access their mail files: a user name, an Internet password, and a URL. See the Domino Administration Help, "Setting up session-based name-and-password authentication." for more information on user names and passwords.

Before Applying the New Mail Template

Losing Custom Folders that are not marked "Prohibit design replace or refresh to modify"

When upgrading a mail template to iNotes Web Access, there is a potential to lose folders if the folders that do not have the property: "Prohibit design replace or refresh to modify" selected. By default, folders created in R5 have this property enabled to maintain the integrity of a custom folder when upgrading Notes. However, some pre-R5 folder may not have this property set.

You can make sure all folders have this property set properly. Open the mail database in Designer, select the Folder view, and select any custom folder. Right-click the folder, choose Design Properties, then select the third tab. If not enabled, check the box for "Prohibit design replace or refresh to modify".

Registering New Users

You need to set up the Internet username and password in the person record for each iNotes Web Access user. Register new users with the new mail template, iNotes5.ntf. This template contains complete functionality for Lotus Notes and iNotes Web Access. For complete details about registering new users, follow the instructions in "Using Advanced user registration" in the Administrator' client help. Register a new user using the Administrator client, but follow these key points:

• Be sure to click Advanced on the Register Person dialog.
• On the Basics tab, enable "Set Internet password" and assign a minimum 8-character password. This password will be for both the Notes ID and iNotes Web Access authentication.
• On the Mail tab, select Lotus Notes as the Mail system (this is the default).
• Select the template called "iNotes Mail and C&S" (iNotes5.ntf).

The iNotes Web Access mail template is named "iNotes Mail and C&S". Its file name is iNotes5.ntf. This template is superset containing mail template support for Notes and iNotes Web Access clients.

Use the mail convert utility to convert Lotus Notes R5 mail files to the new iNotes Web Access design. When you upgrade users' mail files to the iNotes5.ntf template, you can do so one file at a time or use the mail conversion utility to automate upgrading the design. Be sure that you have already upgraded the Domino server hosting the mail files. Upgrade mail files at a time when users won't be accessing them -- for example, early mornings or over a weekend. Notify users that their mail files will be unavailable while they are being upgraded.

1. If users have customized their mail files, instruct them to back up these customizations. For example, users can make a new copy of their mail file that includes only the database design. This allows users to reapply changes they made to their Notes R5 mail file to the new iNotes Web Access mail template.

2. Launch the Domino server on which you want to customize mail files.

3. Shut down the router. Type: tell router quit

This prevents Domino from routing mail to the mail files while they are being upgraded. Mail is stored in MAIL.BOX while you upgrade the mail files. Once you have upgraded the mail files and load the router task again, the router processes and delivers the mail in MAIL.BOX.

4. Load the mail conversion utility. Type:  load convert [arguments]

See below for the arguments you can use with the mail conversion utility.

5. Once you have finished upgrading mail files to the iNotes Web Access template on this server, load the router.

Type: load router

6. Notify users that you upgraded their mail files to the design.

load convert [-r] mailfilepath existingtemplatename newtemplatefilename

where -r converts mail files in subdirectories of the specified directory.

Example:

load convert -r mail\*.nsf StdR50Mail iNotes5.ntf

where 'StdR50Mail' is the design name. This example replaces all mail files in the data\mail directory that have the design called STDR50Mail, with the design that's contained in iNotes5.ntf. The -r switch does this recursively for all files in subdirectories of data\mail.

Refer to the Domino documentation: Moving to Notes and Domino Release 5 and the section titled "Upgrading user's mail files" for more information.

Configuring Archiving on the Server

When configuring archiving for users, you need to specify an organization in the "Create new databases" field in the server form.
Domino/Notes interprets the creation of a new database differently for Notes and iNotes Web Access users.

• For Notes users, the "user" is trying to create a new archive database on the server
• For iNotes users, the "server" is trying to create a new archive database on the server

• Leave the "Create new databases" field blank, or
• Enter */<your organization> in the field

How Users Can Upgrade Their Own Mail Files

Users must be using a Lotus Notes client that is version 5.0.7 or later, and a mail server must be running Domino 5.0.8 or later. As an administrator, you can provide this procedure to users:

1. Start Lotus Notes.
2. Ensure that you have Manager access to your own mail file: click File - Database - Access Control. Select your name, and make sure you have Manager access (most people already have this).
3. To ensure you have Internet access to your mail, click File - Database - Access Control, then click Advanced.
4. Set the "Maximum Internet name & password" field to Manager. This will let you enter your busy time, change your Internet password, and archive mail on the server with iNotes Web Access.
5. Click File - Database - Replace Design to replace your mail template.
6. Set the "Template Server..." to your mail server.
7. Select "Show advanced templates"
8. Scroll down and select "iNotes Mail and C&S" (iNotes5.ntf), and click Replace. This template contains the complete Lotus Notes and iNotes Web Access features).
9. To log-on to iNotes Web Access, you need a User Name and Password To determine your username and password, open the Domino Directory on your mail server. Choose File - Database - Open, select your home mail server, then scroll down until you see NAMES.NSF.
10. Find your name in the directory and click "Edit Person".
11. On the Basics tab, take note of your "User names" according to your Person record. Any one of the user name variations will work, including the "Short name/User ID" as well as your Internet address on the Mail tab.
12. Select the Other tab, and enter a password (you'll probably need to enter 10 characters). Validate your password by clicking "Check Password Strength".
13. Give the server time to run the Adminp process and replicate your new password to other servers. This may take anywhere from 5 minutes to an hour.
14. To log in to iNotes, enter a URL in your Internet Explorer 5.01 (or later) browser using the following format:
http://mailservername.com/maildirectory/mailfilename.nsf

For example: http://acmemail4.acme.com/mail/jsmith.nsf

15. When prompted, enter your username (Internet address) and Domino Internet password.

Troubleshooting the Domino Server

Problem: Can't Authenticate to iNotes Web Access
Solution: If you can't authenticate to iNotes Web Access, make sure your ACL is properly set for Maximum Internet Name & Password Access. Open the Access Control List for the database. Note that the Maximum Internet name and Password access is normally set to Editor by default. Change that to "Manager" to give yourself access to all iNotes Web Access features.

Problem: User's can't see the server's Name and Address Book from their Contact List name picker.
Solution: This problem happens on newly installed servers because the view has not been refreshed soon after initial user registration during server installation and setup. Users will be able to see the Name and Address Book from their Contact List name picker after the views are rebuilt overnight. However, you can rebuild the views immediately by running the UPDALL task on the server manually.

Problem: DOLS Not Automatically Configured When Upgrading from Domino Server Without DOLS. You install Domino 5.0.13 over a previous Domino version, one which did not have Domino Off-Line Services (DOLS) configured. The install program copies the files, but Setup does not run so DOLS is never configured on the server.
Solution: You must manually configure DOLS by adding the DSAPI filter to the Server document, creating the Offline Security document, then restarting the Server. Refer to the Domino 5.0.5 Release Notes, excerpted below, for information on editing the Server document. To create the Offline Security document, refer to the DOLS topics in the Domino 5 Administration Help. You should also verify that the DOLS Administration database (DOLADMIN.NSF) was created during the install. If not, create the database using the Advanced template called "DOLS Administration Template (1.0)."

Problem: Users can't send or save mail. They receive the error: "iNotes Warning. Sorry, we were unable to process your request at this time. If you are unable to continue working in your mail file, please dismiss this warning and then select View, Refresh from your browsers menu."
Solution: Make sure the Web Server Document points to the directory used by iNotes Web Access. If this directory (domino\html) is not specified correctly in the Web Server document, iNotes Web Access and Domino Off-line Services (DOLS) using the HTTP task will not be able to successfully access the necessary files required to execute mail and To Do tasks.

To check the HTML directory in the Web Server Document:

1. From the Domino Administrator, click the Configuration Tab.

2. Click Server, then All Server Documents.

3. Open the Web Server Document (for the server on which you are running the HTTP task) and click Edit Server.

4. Select the Internet Protocols tab, then the HTTP tab.

5. In the field "HTML directory", enter the following text: "domino\html"

6. Click "Save and Close".

Tuning AIX Servers

Administrators tuning an AIX server for iNotes Web Access should follow these steps:
1. In HTTPD.CNF (UNIX only), define "maxactivethreads n", where n is [40 / number of processors]
2. Launch the server
3. Verify the correct value by inspecting the "MaxActiveThreads" value displayed by the Domino "sho stat" command. (It will show maxactivethreads * nprocessors).
4. Run your Domino web server under load.
5. As your server runs, monitor the CPU run length. The CPU run length is the value of the first column of the vmstat command. A run length of 4 is optimal. If the value is too high, lower the "maxactivethreads" value by 1, and re-test. If your run lengths are lower than 4, you can try increasing maxactivethreads.
See more performance and tuning information in the latest iNotes Web Access Deployment Guide at:
http://www.lotus.com/ldd/notesua.nsf/0b345eb9d127270b8525665d006bc355/dcea56a48a39f14885256b8a0054dafe?OpenDocument&Highlight=0,iNotes

Disabling Print Preview
Internet Explorer 5 Does Not Properly Support Print Preview We have previously discovered that some installations of Internet Explorer (all of them 5.00) would not properly display Print Preview's PDF window. The MSDN KB article http://support.microsoft.com/support/kb/articles/Q262/2/13.ASP) describes this problem, and a resolution.

How to Determine Versions

When you are troubleshooting problems, it may be helpful to obtain the iNotes Web Access version number, server information, client operating system, and browser version.
Presently, when you view source and look at the top lines of the file, you will see this type of information:

<!-- $HaikuForm - 429 -->
<html>     <head>

var SERVER_NAME = 'wax.iris.com';

var HTTP_USER_AGENT = 'Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)';

Note to Administrators: Please distribute the following section to your users. It contains valuable information for clients and will reduce the number of calls made to the help desk.

New Preference Dialog When Logging on the First Time
For Calendar and Scheduling operations to work properly in Notes/Domino, a user must first specify the owner of the mail file. If you are an existing Notes user, this should already have been specified. For new iNotes Web Access user mail files, the Preferences dialog showing the Mail tab will pop up automatically the first time a new user accesses iNotes Web Access.

1. Make sure the name of the mail owner is specified.
2. Click Save and Close.
3. Restart iNotes Web Access.

• Delegate a meeting to someone.
• View participant status action.
• Resource Reservation Request form doesn't provide a way to accept or decline the reservation.
• Group To Do ( Assign a To Do document to the other person)
• Create a custom repeating meeting
• Domino/Notes 4.6 repeating meetings are not supported. Repeat meetings cannot be converted to iNotes Web Access, and the Notes client may lose the repeating meetings in a calendar after the mail database is converted. You need to update your calendar in Notes after applying the iNotes Web Access mail design.

Help Limitations

Help may not work correctly on some AS/400 legacy servers because filenames over 30 characters are not supported.

How You Can Switch from Using iNotes Web Access to WebMail
There is a user interface parameter setting (&ui=argument) is available to easily switch between WebMail and the iNotes Web Access. The first example shows how to open a user's mail with the IWA user interface; the second example shows how to switch to a WebMail user interface:

http://www.acme.com/mail/jsmith.nsf?OpenDatabase&ui=inotes

http://www.acme.com/mail/jsmith.nsf?OpenDatabase&ui=webmail

When a user switches to a either iNotes Web Access (ui=inotes) or WebMail (ui=webmail), that state is remembered on the server. If server is set up for basic authentication it affects all future URLs to this database from the same client machine or any client machine.

Resetting the Welcome Page Layout to the Default
You can open your mail file using the "default" URL argument to reset your Welcome Page to the default layout, even if you have a custom layout. You can use this argument if the layout data becomes corrupted. For example:

http://hostname/mail/filename.nsf/iNotes/Welcome/?OpenDocument&ui=inotes&default

Categorized Views are not supported
Categorized views are not supported by Forms5.nsf, which is the basis for both iNotes5 and iNotes60 mail templates. If a user's mail database is based on either of these mail templates, categorized views will not display correctly.

Compacting Databases
Domino Off-line Services will not attempt to compact encrypted databases just as Domino servers cannot compact encrypted databases. Compacting databases only works on unencrypted databases.

Editing of Entries with Attachments using both Notes and iNotes Web Access
iNotes Web Access does not allow the updating of attachments in repeating to-dos and repeating calendar entries. We recommend that users do not update the attachments with the Notes client if you will also be using the iNotes Web Access client to interact with these entries. If you do so, you may encounter iNotes warning messages when you subsequently interact with these entries with your iNotes Web Access client.

Going Offline
When opening an offline subscription from the Lotus iNotes Sync Manager on a Windows 2000 client that is disconnected from the network, a dialog box appears with a message stating that no connection to the Internet is currently available, together with options to "Work Offline" or "Try Again". You MUST choose "Try Again" in order to access your offline data.

Offline Encryption of Mail
By default, offline mail files are not encrypted.

Offline Mail Will Not Open when Encrypted and Password Has Changed
You will not be able to open your offline mail if you have selected to encrypt offline mail and your password has changed. This is because your Notes and Internet passwords must be the same when the offline mail file is encrypted locally. A Notes password is required to access the Notes ID to decrypt the mail file. However, only the internet password is available in the (offline) HTTP server. Make sure that you turn off encryption of your local mail file if you plan to change your Internet password.

Changing Your Internet Password
When you change your Internet password, allow time for the server's Adminp process to run before the change will take 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 will be prompted for a "Synchronization password" whenever DOLS attempts to sync the offline mail file. This includes the initial sync that occurs when the mail file is first installed offline.
• You will not be able to open an encrypted offline mail file.
• You must set the "synchronization password" for the subscription to your Notes password. Note that DOLS initializes the Sync password to be the Internet password. In the DOLS Sync Manager select the mail file subscription entry, then select the Properties - Security dialog to set the sync password.
• If your offline mail file is encrypted locally, then a HTTP 500 Server internal error will occur when the offline mail file is opened, unless you have correctly set the sync password for the subscription to the Notes password.

Out of Office Mail
To enable Out-of-Office mail, you need to modify your mail file's ACL setting. Change the "Maximum Internet name & password' setting to Designer. The online help states that Manager access is required, but this is wrong. The help also states that out-of-office messages are sent only to iNotes Web Access users. This is incorrect, the Out-of-Office agent notifies all users who send you mail that you are out of the office. The agent also notifies Internet users, unless you check "Do not automatically reply to mail from Internet addresses."

Blank messages
iNotes Web Access displays the contents of encrypted messages as blank and provides instructions on how to see the message unencrypted.

Searching Work Hour Availability
Work Hour search does not support users whose mail server Timezone is different from the client's mail server Timezone. Further, when repeat appointments/meetings cross Timezone boundaries, the time information will not be correct.

Group Calendar
If the server's local time is ahead of the client's local time, Group Calendar does not show correctly in the Month view.

Contacts
For existing Notes client users, your Personal Name and Address book can be synchronized with the iNotes Web Access Contact List by means of a utility. In Lotus Notes, use Actions - iNotes Web Access - Synchronize Contacts.

Notebook
Your iNotes Web Access Notebook entries can be synchronized with an existing journal database that you may have in Lotus Notes. In Notes, use Actions - iNotes Web Access - Synchronize Journal to bring your iNotes Web Access Notebook up to date with your Notes journal entries.

To Do Items

• Milestones are available in the iNotes Web Access client. Checking the milestone box when you are either creating or editing a To Do will convert the To Do to a one-day milestone. A milestone is meant to be either completed or not completed (rather than something that can be partially completed).
• The To Do Chart is only available when the user is "On Line". Refreshing the To Do chart refreshes its data and sends it back to its default view of that data. So if the default view is days and the user refreshes from within the month's view, the refreshed view of the data will be the days view.
• If all To Do items are clustered in the last week of a single month, then the name of the month may not be displayed in the chart, due to space and font style constraints.
• In the process of creating a To Do you decide to mark it complete, The To Do icon in the To Do List view will be correct, but it may not be correct in the All Documents view.
• If a user opens a repeating To Do's parent document using the All Documents view, the changes to the parent document may not be retained after the user selects "Save & Close" or "Save."
• PDF formatting is not available when printing To Do tasks.

Working with Folders Offline
When working with folders offline, you need to refresh your browser when returning online to see the newly added, changed, or deleted folder.

Group and Nested Group Expansion
When entering a personal group in a memo or calendar entry, the group will expand right away. If the group resides in a Domino directory, it will not expand when addressing a memo, but it will expand right away on a calendar entry. Nested personal groups, that is, groups containing another group inside your Contact List, do not expand when creating a memo or calendar entry.

Name Resolution Limitations
The Directory Catalog cannot be the target directory for name resolution in iNotes Web Access. The maximum number of candidates per name being resolved is set to 200.

Alternate Name Limitations
If "Validate name and set alternate name items" in the Server Configuration Document is disabled (the default setting is enabled), there might be a chance that non-ASCII characters will be entered directly into primary name items. We highly recommend that you do not disable this setting.
Alternate names are not supported in the following places:

• Alternate names used in a group To Do created with the Notes client
• Alternate names entered in a Delegation tab in Preferences. What's typed in the fields will be processed literally.
• Alternate names used in "Reply To" fields.