The following tips can help you troubleshoot the Notes Browser Plug-in:
Common URLs supported by the Notes Browser Plug-in
Issue: Notes Browser Plug-in doesn't start when you enter the URL in the browser's address bar
First, try the notes:home URL to see if the homepage itself launches, or has issues.
Next, see if Notes outside of the browser can be launched. If you have installed the Notes Browser Plug-in along with the Notes Standard client installation, ensure that the client can be run. If you have only the Notes Browser Plug-in installed, try to run the "nlnotes" executable file, which will then give you a message about "this application is not supported' (since only the Notes Browser Plug-in can be run with this installation). If none of this works, then your installation is not correct. Re-install and also ensure that your Notes.INI settings are correct. You can also refer to this article for collecting installation verbose logs for troubleshooting:http://www-10.lotus.com/ldd/dominowiki.nsf/dx/notes-install-and-verbose-log-file
If your installation is correct, the next thing you should check is whether the plugin is being enabled in the browser.
: Select "Tools -> Add-ons" and select the "extensions" tab, as shown below:
Next, ensure the plugin is "enabled" (disable is the only option available). If it's disabled, you will see the "enable" option - please enable and restart the browser
If the above does not help, please look at any plugins which might be interfering with the notes: protocol. Within IBM, for example, there's an IBM CCK plugin which intercepts the "notes:" URL and launches the Notes Standard client. If you have a similar plugin, try disabling it and restarting Firefox, then re-try the "notes:home" URL.
Internet Explorer (IE)
: Select "Tools -> Manage Add-ons" and check if the Notes Browser Plug-in add-on is enabled or not:
Issue: Does the IBM Notes Browser Plug-in support NSD? Are there any differences? How can I debug launch issues?
For serviceability, the IBM Notes Browser Plug-in supports NSD similar to the Notes Client. When you install the plug-in via it's own installer, you will get the same "Start->IBM Applications->Support->Collect IBM Notes Diagnostics data" shortcuts created. You can use these options to collect NSD (diagnostic data).
IBM has modified NSD to also collect browser specific information, such as the version of the Notes Browser Plug-in, its location, list of files in the browser plug-in directory, and the processes. This will help get to the root cause of any issue you might encounter.
The IBM Notes Browser Plug-in also creates a 'npntapi.log' file in the user's TEMP directory (%TEMP%) , during startup of the Notes Browser Plug-in. If you do not see Notes starting up when you are trying to launch the Notes Browser Plug-in (no nlnotes.exe process), then you can refer to this log for the sequence that the plug-in is going through. Once Notes starts up, this log is merged into console.log or any other debug output that's been setup via the notes.ini file.
Also, running NSD from the command prompt collects more information (and the above log file) instead of using the "Start -> IBM Applications -> xxxx" menu option.
Issue: Notes Browser Plug-in starts, but the tabs are not opening properly
For both Firefox and Internet Explorer browsers, the plug-in requires specific settings. You need to ensure the following settings are correct in the browser you are using:
Browser settings for Firefox
- The options "Open new windows in a new tab instead", and "When I open a link in new tab, switch to it immediately" should be selected.
Browser settings for Internet Explorer
- The options "Always switch to new tabs when they are created", "Always open pop-ups in a new tab", and "A new tab in the current window" should be selected.
Issue: Not seeing the "Launch iNotes" icon at the top of the IBM Notes Browser Plug-in's menu bar
Check that your notes.ini file contains an entry:
If yes, remove this entry and restart the Notes Browser Plug-in. By default, iNotes access from the Notes Browser Plug-in is enabled. The only time you should manually add this entry is if your organization does not have iNotes supported, and you do not want users to see the "Launch iNotes" icon.
Issue: How does the Notes Browser Plug-in determine the iNotes server HTTP URL? What happens when I click on the "Launch iNotes" icon or try to "Forward" a document from my application using "Actions -> Forward"?
The Notes Browser Plug-in has multiple ways to come up with the address of the iNotes HTTP URL. A typical iNotes HTTP URL is:
http:// or https://
So the first thing is to come up with is the server's HTTP address.
Computing the HTTP URL from a user's location document:
The Notes Browser Plug-in reads the current location document to find the user's home mail server, and come up with the address. Please ensure that you have the right server name in the second tab of your location document.
IBM looks for the HTTP name of the server by looking up the server document on your server's NAB (Name & Address Book). Iif you see this is not working properly, or if your server document is not setup properly, you can always add the following to your Notes.INI file:
If you are using a redirector, you can specify a redirector path using:
By default, the IBM Notes Browser Plug-in pre-pends the server's address with "https://". If your iNotes server is not using SSL (only http://), then please add the following to your Notes.INI file:
Issue: When I click the "Launch iNotes" icon, it's not launching iNotes
In most cases, you can look at the URL that is showing up in the address bar of the new tab to see what Notes is doing, and then decide from the previous note if you need to use any of the INI variables.
Issue: I have configured IBM Notes Browser Plug-in with roaming user and cleanup option selected, exited from the browser, but the Data directory is not cleaned up
Check for the username.cln
file (where username
is the user logged into the machine). If the file exists, the cleanup has been queued up and has not happened yet. Once the cleanup is completed, this file will be deleted. So wait until this file gets removed, which will indicate completion of the cleanup.
Issue: Notes Browser Plug-in installation is failing, I have installed the previous version and am trying to install a different version
Windows XP: C:\Document and Settings\All Users\Documents
Windows 7: C:\Users\Public\Documents
In most cases, check for running processes from your previous installation of Notes, which need to be terminated. If you see the Notes Multi-user cleanup service running, please terminate that as well. Once complete, try with installation again.
Issue: Cannot find "Advanced menus" option under the 'View' menu
In order to get Advanced menus, you must add “MenusAdvanced=1” to your notes.ini file. IBM wanted to keep the menu options to the mininum that an end-user would typically need.