iNotes Web Access - Release Notes for Domino/Notes 5.0.8 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. You can do all this offline, too. Supported Servers AIX 4.3.3 AS/400 S/390 Solaris Sparc 7, 8 Windows 2000 Professional, Server, Advanced Server Windows NT Server 4.0 Service Pack 4 and above Client System Requirements Win32 Internet Explorer 5.01 Service Pack 1 or later Adobe Acrobat Reader Version 4.0 or above This release does not support Netscape Navigator browsers. Upgrading from Domino 5.0.7a to 5.0.8 - iNotes Web Access installation instructions The following installation instructions are for the incremental installation of iNotes Web Access. If you decide to install iNotes Web Access at a later date, it will not be necessary for you to reinstall the 5.0.8 server code. Download instructions 1. Download and upgrade from Notes/Domino 5.0.7a to 5.0.8. 2. Launch dictions.exe (available in the \apps directory) and install the spelling dictionaries to your Notes\Data directory, as prompted. Deployment Issues iNotes Web Access works only with the latest build of the Domino Server. You need to install a fresh copy of this Domino Server to support new or existing Notes users. Server Configuration Document Settings Server Configuration Option Settings Archiving on server Allows users to create archive databases on the server Full-text indexing Allows users to create a full-text, searchable index of their mail, to do items, notebook, and contacts list. Modification of Internet password Allows users to change their Internet password. Calendar printing Allows users to print calendar entries. When disabled, there is no print button on the Web page. Alarms When disabled, no alarm will pop up. Alarm polling time Alarm monitor will check for alarms every XX minutes Minimum allowed mail polling time Check for new mail should occur no less than every XX minutes Welcome page URL* Any valid URL will override the existing welcome page Welcome page title If URL is valid, this title will be shown in the title area of the welcome page * If you set the default URL and users are running Internet Explorer 5.01, the default page pane hides some of the sub menus in iNotes Web Access. This is caused by a limitation in Internet Explorer 5.01, You can see all submenus if you are using Internet Explorer 5.5. Sametime Configuration iNotes Web Access users can get instant messages or chat with others with iNotes Web Access. Users can launch the Sametime UI by clicking on a link called "Chat" on the iNotes Web Access Welcome page. After the Sametime UI is launched, users can create their own buddy list, bring user names either through Name Picker or simply typed in, based on the Domino\Sametime server Name Address Book (names.nsf). Double clicking on your name will open the chat dialog box. Sametime applets exist on each Sametime server in the following directory: \data\domino\html\SametimeApplet These applets are the APIs between iNotes Web Access and Sametime. Using forms in Domino Notes, iNotes Web Access links the Sametime applets and bring the instant message to iNotes Web Access users. A user's mail database will keep the user list created from Sametime chat UI by the user and bring them up when the user logs on to Chat next time. Sametime Server Installation and System Configuration Install Domino (iNotes Web Access) Domain server first. Install Sametime servers version 2.0, either dedicated systems or over the Domino Domain server (see tech notes for different Sametime server setups). Configure the servers, Domino Domain and Sametime servers, to be able to communicate with each other and run agent/JavaScript (see details in tech notes). Copy Sametime Applets to Sametime server (\data\domino\html\SametimeApplet). Change your system page file size to 267MB Your system memory should be at least 256MB Sametime Chat Features Add user groups. Remove user groups. Add user names by either from Name Picker or type in. Remove users from a group. Save the groups and users. Bring up previous saved groups and users to the Sametime Chat UI when opening a web browser. Setting up a Dedicated Sametime Server with a Domino Server When setting up a dedicated Sametime server to work with iNotes Web Access, you need a Domino Server, version 5.04 and up, that should be ready for a Sametime Server to register to. You'll also need a Sametime server, version 2.0, on a dedicated machine. Refer to the Sametime 2.0 Installation Guide and the chapter "Installing Sametime in a Domino domain on a dedicated server" for complete details. A. Configure your Domino Domain server Double check the Sametime server registration in the Domino Domain (iNotes Web Access) server. Configure Names.nsf on Domino Domain machine. Assign a Sametime Domino Name to the field called Sametime Server on each registered user record. Start the Notes Administrator and click File -- Open server, then select the Domino Domain server name and open it. Double-click on the Domino Domain server name, then select People&Group tab, then click on People. Double-click on a user name, then click Edit on person, then select Administration tab. In the Sametime server field, enter: CN=[Sametime server Domino Name]/O=[Domino Certifier Name] Click Save & Close. For example: CN=Sophia/O=iNotes Web Access Notes: If the Domino certifier name and its Domain name are identical, those two are the same. Usually, Domino Server Name/Certifier patten exists in the server document, you can copy this patten directly to Sametime server field, then Notes editor will automatically change the patten to CN=Domino Server Name/O=Certifiler. B. Assign a Sametime Host Name (IP name) to the field called Full Internet Host Name on the server record. Look at "Use Directory on" and in the text box, select the sametime server name, then select Configuration tab. Click on Server, then select Current Server Document, then select Basics tab, on Fully Qualified Internet Host Name field, type in: [Sametime Server Host Name]. Click Save & Close. For example: iNotes Web Access3.iris.com C. Replicate stauths.nsf from a Sametime server to the Domino Domain server under \domino\data\ directory D. Add a subdirectory called \SametimeApplet in the Sametime server machine Create a new subdirectory called SametimeApplet, on the Sametimeserver under \sametime server directory\data\domino\html Copy all the files from ...\data\domino\html\SametimeApplet (the file directory should be on your Domino/iNotes Web Access server machine) to ...\data\domino\html\SametimeApplet directory on your Sametime server machine. Setting up a Sametime server to Work with iNotes Web Access (Domino) server on the Same Machine The install procedures should be the same as above (a dedicated Sametime server installation), except refer to the Sametime 2.0 Installation Guide and the chapter "Installing Sametime on a Domino server" for complete details. Notes: No Sametime server registration is needed since both servers will be on the same machine. No STAuths.nsf replication is needed because the database will be installed on iNotes Web Access (Domino) server when you install a Sametime server. The following questions and answers would be helpful for better understanding how it works while installing Domino and Sametime server on same machine. Q: Create a new subdirectory call SametimeApplet under \lotus\domino\data\domino\html too? A: The new subdirectory should be created on the dedicated Sametime server machine ( \lotus\domino\data\domino\html - is your dedicated Sametime server directory? ). The reason to do so is that Sametime server does not have iNotes5 (iNotes Web Access files) subdirectory. If you run both servers, Sametime and Domino, on same machine, you should create the same subdirectory on Domino Domain too (this part should be handled by iNotes Web Access installation kit after all the test done) Q: Open a user's personal document , on Sametime server field , add domino server name? A: Should be Sametime server Domino name (if you have a different Sametime server Host name), which might be the same as the Domino Domain name if you run both Sametime server and Domino server on the same machine. Q: Without applying the steps above, we can't successfully chart in iNotes Web Access. We know these are key steps to config dedicate sametime server. Are these steps also necessary for scenario which sametime and domino server are installed on same machine? A: Yes. Here is the scenario: Sametime and Domino servers are running on a same machine is a special case of dedicated Sametime server installations. No mater where does a Sametime server sit on, a Domino Domain server always look up Names.nsf, Sametime server field, (shared among Domino Domain server and Sametime servers) to find the Sametime server signed to this particular user, then requires the Sametime server Host name from the field called Fully Qualified Internet Host Name. The sametime applet will be started based on the sametime internet host name and other parameters, such as security tokens (from STAuths.nsf), logon User names and Domino names. So, the settings should be the same for either cases. AIX and Solaris Servers Working with Dedicated Sametime Servers Set up for both AIX and Solaris systems working with dedicated Sametime servers should be same as Windows system's set up, The only extra step is changing the database name from stauths.nsf to STAuthS.nsf after replicating the database from a dedicate Sametime server (Windows system) to a Domino (iNotes Web Access) server (Unix system). Setting up iNotes Web Access and Offline Services Be sure to enable DOLS (Domino Off-Line Services) during initial server setup for users to download and subscribe to mail files on the server. This is done via a checkbox on the last page of the configuration wizard that runs automatically the first time the server is started after installation. Configure DOLS as documented in the Administrator's documentation by creating an Offline Security document. When installing a subscription to a mail file for offline access, the fully qualified internet host name (including domain name) must be used to access the site from which the mail file is to be downloaded. For example, use http://server25.acme.com/mail/mailfile.nsf Do not use: http://server25/mail/mailfile.nsf. To enable users to take the server's directory catalog offline with their mail files, the parameter $DOLSDirectoryCatalog in the server's NOTES.INI should be set to the name (relative the the data directory) of the directory catalog file for offline use . If this NOTES.INI parameter does not exist, users will not have the option to take a server directory catalog offline with their mail files. Note that iNotes Web Access Offline does not work with IBM's Policy Director program. 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: To enable UTF-8 encoding on a server: Open the "Server" document for your server (look in view Server\Servers view in the server's names.nsf) Click the "Internet Protocols" tab Click the "Web Engine" sub-tab Select "Yes" for the option: "Use UTF-8 for output:" Usernames and Passwords You need to set up the Internet username and password in the person record for each iNotes Web Access user. New users will need a new mail file (the mail file template name is "iNotes Mail and C&S" by default). Use the Administration client included in the AllClients Kit also provided on the iNotes Web Access download Website. Use this kit to create mail files for new users. Upgrading Existing Users Refer to the Domino documentation: Moving_to_Notes_and_Domino_Release_5 and the section titled "Upgrading user's mail files" on page 90. Use the NT prompt and the mail convert utility to convert mail files to the new iNotes Web Access design. Syntax nconvert [-r ] filename OldDesignName NewTemplateName the -r switch indicates the change should be done recursively in subdirectories Example syntax from the NTprompt: nconvert -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. Another example: nconvert mail\*.nsf * inotes5.ntf This example replaces the design of all files in the data\mail directory, with the design in inote5.nsf. It does this no matter what the name of the previous design was. When you are done converting mail, send users an upgrade notification message (see "Upgrading user's mail files"). Special Notes for Beta Customers A. Upgrading Existing Beta Users to iNotes Web Access We recommend that everyone perform a clean installation of the latest Domino server. However, for beta customers who need to upgrade existing mail files from the beta to the latest release, you must run nconvert again. Run nconvert with the following parameters: nconvert maifileldir\*.nsf iNotes506 iNotes5.ntf You need to run nconvert again because the name of the design has changed from iNotes506 to iNotes5. The design task will not be able to update these automatically without an explicit conversion of the design. B. Getting the new ActiveX Controls Users who were in the beta program will need to obtain the new iNotes ActiveX control for supporting file attachments and the new LotusDRSControl ActiveX control for working offline with iNotes Web Access. Here are the instructions for users who need to replace the controls: Uninstall "Lotus iNotes", also known as Domino Off-Line Services (DOLS) from the client PC using the "Add/Remove Programs" control panel applet. Remove all temporary internet files as well as the "iNotes Class" and "LotusDRSControl Class" classes from the client browser (Tools->Internet Options, General Tab, look for the Temporary Internet files section in this tab. Click on Settings, then click on View Objects), Right click on "iNotes Class" and "LotusDRSControl Class" and select remove for each. Re-install an offline subscription to your mail file. 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. If you change that to "No access" then you will not be able to authenticate over the Web to that database. 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.5 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)." Excerpt from the Domino 5.0.5 Release Notes topic "DOLS installation issues:" Upgrading from a Domino build without DOLS to Domino 5.0.5/DOLS 1.0.1 If you are upgrading to Domino 5.0.5 from a Domino build that does not already have DOLS installed, DOLS may not be properly installed with Domino 5.0.5. The DOLADMIN.NSF file will be created, but the DSAPI filter name may not be added to the server document. When you start the Domino 5.0.5 server, DOLS will not be loaded. To work around this problem: Open the server record from the Administrator client. Go to Internet Protocols. At the HTTP tab, add ndolextn to the DSAPI filter names field (Windows NT platform). Shut down the server and restart it. Administrator Commands on the Server Console Command Description load compact -a mail\* Compact and archive databases in the mail directory load convert mail\* * iNotes5 Convert all databases in the mail directory to the iNotes5 template load updall Rebuild views in all the databases on this server Tuning AIX Servers Administrators tuning an AIX server for iNotes Web Access should follow these steps: In HTTPD.CNF (UNIX only), define "maxactivethreads n", where n is [40 / number of processors] Launch the server Verify the correct value by inspecting the "MaxActiveThreads" value displayed by the Domino "sho stat" command. (It will show maxactivethreads * nprocessors). Run your Domino web server under load. 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. Disabling Print Preview Internet Explorer 5 Does Not Properly Support Print Preview We have previously discovered that some installations of IE (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: The Domino Build information should indicate the Server Version. Domino has no concept of Template Version, but there is a client build number which is emitted after the $HaikuForm -. The server name is part of the URL the user is using and can also be gotten by looking for "var SERVER_NAME" within the page source: var SERVER_NAME = 'wax.iris.com'; The client OS and Browser Version may be determined by searching for "var HTTP_USER_AGENT" within the page source: var HTTP_USER_AGENT = 'Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)'; Client Considerations If you are an existing beta user, you will need the new iNotes ActiveX control for supporting file attachments and the new LotusDRSControl ActiveX control for working offline with iNotes Web Access. See the special notes for beta customers who are upgrading in the previous section. iNotes Web Access is best viewed in a screen resolution of either 800x600 pixels or 1024x768 pixels. Do not replace the design of your mail file using a version of the Notes client. It's recommended that you use the convert utility as described in these release notes and run that on a server running the iNotes Web Access server support. Calendar and Scheduling (C&S) The following functions are not available in iNotes Web Access: Delegate a meeting to someone. View participant status action. Group To Do ( Assign a To Do document to the other person) Create a custom repeating meeting 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, this may be done by: Click Preferences Click the Mail tab. Make sure the name of the mail owner is specified. Click Save and Close. Editing of Repeating Calendar and Todo Entries with attachments using both Notes and iNotes Web Access iNotes Web Access does not allow the updating of attachments in repeating todos 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. 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. 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 Availabilty 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 won't 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 will synchronize with the iNotes Web Access Contact List by means of a utility. Look for a menu item called "iNotes Web Access- Synchronize Contacts", run from the Notes client. Notebook Notebook entries can be synchronized with a journal database by means of an agent called "iNotes Web Access - Synchronize Journal", run from the Notes client. 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's 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. E-mail Font Sizes Changing Font sizes may change with email chains, that is, the forwarding and replying with history to the same message. You can prevent this by editing the server configuration record changing the following. Enable international MIME settings in the "basics" tab, Click the "settings by character set groups" tab, select the Western character set group, and set the HTML size field to 10. Font sizes may change with email chains, that is, the forwarding and replying with history to the same message. Increasing font sizes in messages exchanged between Notes and iNotes Web Access It is possible that you will see an increase in font size when you doing "reply with history" or "forwarding" of messages between iNotes Web Access and the Notes client. To correct this situation you can override the default font mapping table by setting the following parameters in the servers NOTES.INI file. DOMINO_FONTSIZE_CUTOFF_0=8 DOMINO_FONTSIZE_CUTOFF_1=10 DOMINO_FONTSIZE_CUTOFF_2=12 DOMINO_FONTSIZE_CUTOFF_3=14 DOMINO_FONTSIZE_CUTOFF_4=18 DOMINO_FONTSIZE_CUTOFF_5=24 Note: this font mapping will apply to all web applications on your Domino server, so we suggest inspecting the behavior of your other web applications. Busy Cursor A busy cursor (combination mouse pointer and hourglass) remains after some window closings and Notebook searches. Refreshing the window or changing the view resolves the problem. 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. Changing Your Internet Password You need to be the owner of the mail file and have Designer or Manager Access to change your Internet password. When you change your password and restart your browser, sometimes both passwords are still valid. The old password will work until the Domino server starts a new task. After several minutes the old one will be invalid.