Thursday, April 30, 2009

SNTT - iNotes Mail Redirection in 8.5

Edited 9/2/2010: Login page edits can be found at this post.

Edited 12/21/2009: If you need more information for internet site documents and configuration see this post.

It's a NEW template and so full of help and documentation one doesn't even need to post about it.


To be fair this is one of those things you love to use and set up once go away and then something breaks it and you have to do it all....over....again.....from.....memory.

Not totally true anymore. Webmail redirect has come a long way so to speak since the old Sandbox. Needless to say, if your environment looks like one of our clients, well, then this is for you.

Here is a link to the Domino Administrator help file which is online at IBM where it provides THE ONLY documentation for this utility(outside of the database itself, read on for more on this). Appropriately called "Using iNotes Redirect to access mail in Lotus iNotes".

If you read it, there seems to be nothing to it really.
1. Create an application using the "IBM Lotus iNotes Redirector"(IWAREDIR.NTF) template.
2. In the IBM® Lotus® Notes® client, open the application that you created.
3. Click Setup and follow the prompts(I didn't get any prompts) to set up iNotes Redirect.
I'll add a step 4, at the server console, tell HTTP Restart.

Hold on, not so fast, what about all these settings and options you say?
Let's do it one step at a time.
I will presume you know how to create a database by now.

1) You will see one button on the page, Click on Setup.
2) Now you will see 4 buttons like this:
4 choices but still no prompts
3) Select server settings
4) Here the help offered is helpful, so use it if you need it. Select the Redirection type, I use dynamic and not a forced path in this case.
5) Choose SSL or not and debug or not.
6) Click on the UI setup button.
7) Enter the time to redirect in seconds. Why you ask...
8) What text do you want displayed while being redirected? So you can do a Public service announcement or have some fun with it like I do and tell them to relax and the server will be with you in a few seconds, please deposit 25 cents to continue.
9) You can also add a custom logo or color and enable the personal, login and cookie options as you so desire.
10) Click on ultralite/mobile settings and enable the ultralite button, it should already be populated with ipod(had no idea I could use it as a client)and iphone.
11) Now go to the application setup button and make the ACL changes as described.

And it.....didn't work for my client.

So what's wrong?

I get the Lotus Notes Traveler code home page. I love Traveler, but this shouldn't be coming up after I login.

OK, let's check the WEB settings in the Names.nsf.

Go to Configuration-Web-Internet Sites

I found a website for traveler on that server. Not unusual to have Traveler on the same server as one's mail, but Traveler appears to have taken over the default URL.

Open up the site, go to the Configuration tab and edit it.
The Home URL was populated with traveler/index.html.

Sorry, that will break iNotes redirection.

Copy this, or whatever you find there, over to the comments tab, as backup.

Now replace that with inotesredirector.nsf?open (please use whatever name you made the NSF when you created the database, BUT don't forget the ?open).

Try to log back in, it should work now. If not, run the tell http restart at the server console and try again. If that doesn't work, get a hold of me so we can fix it together.

As an extra benefit, don't forget you can redirect when people leave their email as well.

Using this notes.ini setting, iNotes_WA_LogoutRedirect= you can send the person anyplace you want, I sent you to my blog if you cut and paste this.

As the help file says on this topic:
Use the NOTES.INI variable, iNotes_WA_LogoutRedirect, to specify a URL to redirect users to a Web page after logging out from server. The setting provides normal cache clearing with the IBM® Lotus® iNotes™ control, and clearing of browser credentials. This variable allows sites which have additional actions that need to happen on a logout (such as logging out of 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. The format for this settings is iNotes_WA_LogoutRedirect=URL. For example:


  1. Thank you for posting this. I can't imagine how many hours I have lost trying to research this.
    Perhaps someone could do this as a wiki article on configuring multiple products on a single server.

  2. See the post after this one, I realized I forgot to help everyone with it.
    Ping me to discuss what else to include and I will update/post new ones.

  3. hello,
    Whats in a case of ICM server. The users are not failing over to their cluster partners in case their home mail server is down.
    What happens is, the user gets authenticated on ICM server and then try to locate its home mail server ONLY (through dwar.nsf) and fails if the home server is not available.
    Please help.

  4. Have you loaded the newest redirector which has the dynamic routing enabled?
    In general the redirector is not cluster aware but under some changes to the latest version I thought it was now a little better off.
    of course if you have planned maintenance, then you can manually change the redirector.
    And if you have unplanned outages, maybe I can help you fix that as well.

  5. Man, you are the best!
    Thank you for your post.

  6. Andrei,
    Happy to help. This is one of those things that we all do, but never document. So I am happy it helped you. I probably need to update this post a bit for 8.5.1 and some other items, when I get a chance.

  7. Sorry to revive this post... but thanks!

  8. @Anon this post is hit on every day, in fact these 2 are the most popular posts over time.

  9. thanks for the post.

    Can you make it more descriptive. I'm new to Lotus Domino and can't find everything you mention

  10. anon, email me for my presentations and more specific questions connect from the front page of the blog. but i did some other posts on it too most recently from may for the view conference.
    there is some documentation finally in the infocenter ifr you search for it.

  11. I wanted to change the login page for lotus inotes the one with white background yellow square and a header "Server Login". I want to change the background to our company's image. The only problem I encountered is that I cannot find the code where I can edit this page. I already spent tons of hours figuring this out. What is the name of the file and where is this located?

  12. Anon, see this post which i think is what you are after, I need to edit my inotes posts so they are all together.

  13. Hi,
    I recently set this up on three 8.5.2 servers (one was completely vanilla - just to check).
    It would not work, I was tearing my hair out until someone on the forum suf=geested I try an 8.5.1 version of the template. Works just as expected !!!!
    I have tried to find a way to communicate this to IBM but as I am a consultant unless I regiuster this against one of my customers I can't ........ DUH!
    Have you seen this issue at all, I think everyone who has upgraded the server to 8.5.2 has not bothered to upgrade the design of this databse as it already works.


    Rupert Kiero-Watson
    Time Technology Ltd

  14. Rupert,
    This is quite true, IBM broke some pieces of it and are working to restore it back to the 8.5.1 way.
    But prior to that there were reverse proxy issues from 8.5.
    It's a small app that gets updated but not tested perhaps for all circumstances of usage.
    At least you have it resolved but the only updates I knew for Domino 8.5.2 delivers Ultra-Light support for Android and iPad in it.

  15. Hello, I set this and it works fine for internal users.. but when I try to use the external URL, the redirection doesn't work. I tried with Dynamic and Mailserver option... but still can't make this work.
    Any clue to make this work from a external access?

  16. Ricardo, A couple of things. Are the mail server and redirector on the same server? Also you may need 2 things. 1- an internal DNS entry for the external name to match to the server. 2- web domain docs should include the external name of the server in addition to the internal name. That way the server sees itself as both names. You may find your fqdn does not match the external name in the http setings of the server doc. These should match and the server port name too. The problem is your server needs to know it is called server/org and you can email me for more, see link on top right of the blog.

  17. i implemented redirection type mail server and its redirecting to internal mail server(not exposed to public) but not resolving.can you help me regarding this.

  18. Jithin,
    My guess is you are using a DNS entry or server name that can not be resolved. You can contact me through one of the links on the top left of the page, skype, email, etc.. and we can troubleshoot it better.

  19. I can check my email via lotus notes clients fine.
    But when I try to check via webmail with same id, it redirects me to page showing following error

    Error 404
    HTTP Web Server: Lotus Notes Exception - File does not exist

    What could be the problem ?
    I tried above step, then to not working could u help how to open from browser

  20. Hello Karthik,
    I need a little more information to help you.
    If you set up the redirector, is it replacing a server name or is it pointing to the correct server or name/ip?
    Is it a dns issue on one end?
    Logging in and connecting to your mail file are 2 different issues.
    Can you manually enter the servername and direct to your mail file open it?
    example is would go direct to my file.
    If this works, then your redirector is not working properly and you should check the settings.
    Contact me via email, skype or IM for more.

  21. Hi Keith,

    In inotes redirection getting error" subform DWA redirection is not loaded.

  22. Karthik,
    Did you do anything to the loginform itself? Did you check the ACL is set properly?
    Login form info was here

  23. Im using LD852 FP4, with inotes, but everytime i access inotes web redirect, which i create from iwaredir.ntf

    The IBM logi didn't display.
    Is there anything i can get the latest iwaredir.ntf templates. ?

    Thanks a lot

  24. Budiman,
    If you have followed the guidelines properly, including setting up the redirector database, set its ACL, edit the form requested, added the redir named file to the server doc for web home page and tested if you can access the file from the web. Then you should be ok.
    It sounds like either you have not setup the db properly or did not add the name properly to the homepage reference for the server.
    Or if you are trying to access the file from outside your firewall, make sure the server and connections have proper access.
    Email me for more help.

  25. Hi all.
    I have such problem. May be you can help me to resolve it.
    My redirection works, but I see strange symptom.
    I print my address, Authorize, and see redirection process, but after I see new authorization window. But address is https://server/mail/mailbase.nsf. Where have FQDN? I do not understand that this.
    Please help me.

  26. Hi, I resolved my problem. Thanks for lot.