Common URLs supported by the Notes Browser Plug-in
Notes Browser Plug-in does not start when entering a URL in the browser address bar
First, try the notes:home
URL to see if the home page launches.
Next, see if Notes can be launched outside the browser. If you have installed the Notes Browser Plug-in along with the Notes Standard client install, 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: "This application is not supported"
, since only the Notes Browser Plug-in can be run with this installation.
If neither of these options works, then your installation is not correct. Re-install and also ensure that your Notes.INI settings are correct. You can also refer to the following article, which describes how to collect installation-related verbose logs for troubleshooting: Notes install and verbose log file
If your installation is correct, the next thing you should check is whether the plug-in has been enabled in the browser:
- Firefox: Select Tools -> Add-ons, and select the Extensions tab. Ensure the plug-in has been enabled. You may also look for any plug-in which may be interfering with the notes: protocol; within IBM, for example, there is an IBM CCK plug-in that intercepts the notes: URL and launches the Standard client. If you have a similar plug-in, disable it and restart Firefox, then retry the notes:home URL.
- Internet Explorer: Select Tools -> Manage Add-ons, and ensure the plug-in has been enabled.
Notes Browser Plug-in support for NSD
For serviceability, the IBM Notes Browser Plug-in supports NSD similar to the Notes client. When you install the plug-in via its own installer, you will get the same Start
-> IBM Applications
-> Collect IBM Notes Diagnostics data
menu shortcuts created as in the full Notes client. You can use these options to collect NSD (Notes System Diagnostic) data.
IBM has modified NSD to collect browser-specific information, such as the version of the Notes Browser Plug-in, its location, list of files in the plug-in directory, and related processes. This will help to troubleshoot the root cause of any issue you might encounter.
The IBM Notes Browser Plug-in also creates a npntapi.log
file in your TEMP directory (%TEMP %
) , during the 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, that is you do not see the 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 in your Notes.INI file.
Running NSD from the command prompt collects more information (and the above log file) than simply using the Start
-> IBM Applications
-> Collect IBM Notes Diagnostics data
Notes Browser Plug-in starts, but tabs do not open 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.
The "Launch iNotes" icon is not appearing at the top of the Notes Browser Plug-in menu bar
Check that your Notes.INI file contains the entry BrowserAllowiNotesMail=0
. If it does, remove this entry and restart the 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 icon.
How does the Notes Browser Plug-in determine the iNotes server HTTP URL?
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://[server address]
- https://[server address]
So the first thing is to determine the server's HTTP address. The Notes Browser Plug-in reads the current location document to find the user's home mail server, and comes 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 Name & Address Book. If you see this is not working properly, or if your server document is not setup properly, you can always add the following attributes to your Notes.INI file:
- INOTES_SERVER_PATH=[server's HTTP address]
If you are using a redirector, specify the redirector path:
- INOTES_REDIRECTOR_PATH=[server's redirector URL]
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 add the following to your Notes.INI file:
iNotes does not launch when clicking the "Launch iNotes" icon
In most cases, you can look at the URL that is showing 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 cited.
With roaming user and data cleanup options selected, the Data directory does not get cleaned up
Check 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.
Notes Browser Plug-in installation fails when installing after earlier version
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, attempt the installation again.
Cannot find the Advanced menus option under the View menu
In order to get Advanced menus, you must add MenusAdvanced=1
to your Notes.INI file.