Authors :
Xavier Defossez : Software IT Specialist xd@fr.ibm.com
Vincent Perrin : Software IT Specialist vincent.perrin@fr.ibm.com
Abstract :
The purpose of this document is to outline the steps required to configure IBM HTTP Server as a reverse proxy in front of Lotus Quickr 8.2 for Domino Services.
Architecture :
- IBM HTTP Server 6.1
- Lotus Quickr 8.2 for Domino Services
Modifications of httpd.conf in the ihs server :
1. Load Proxy Modules
Uncomment these two lines to enable proxy modules in the HTTP Server.
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
2. Activate the Reverse Proxy
Add this line at the end of the httpd.conf :
ProxyRequests Off
This directive prevents Apache from functioning as a forward proxy server
3. Proxypass directives
The ProxyPass directive allows remote servers to be mapped into the space of the local server.
- This directive provides access to Quickr Main Page.
ProxyPass /LotusQuickr http://local.server.com/LotusQuickr
ProxyPassReverse /LotusQuickr http://local.server.com /LotusQuickr
- This directive provides access to Quickr Ressources.
ProxyPass /qphtml http://local.server.com /qphtml
ProxyPassReverse /qphtml http://local.server.com /qphtml
- This directive provides access to Quickr Servlet, otherwise you will have a white page.
ProxyPass /servlet http://local.server.com /servlet
ProxyPassReverse /servlet http://local.server.com /servlet
- This directive provides access to Quickr Content Services for RSS feeds or Quickr Connectors.
ProxyPass /dm http://local.server.com /dm
ProxyPassReverse /dm http://local.server.com/dm
4. Quickr Connectors Support
You have to add this directive to support Qhickr connectors.
AllowEncodedSlashes On
The AllowEncodedSlashes directive allows URLs which contain encoded path separators (%2F for / and additionally %5C for \ on according systems) to be used. Otherwise Quickr Connectors will returned a 404 (Not found) error.
5. (Optional) Multiple Server behind the reverse proxy
If you plan to use the Reverse Proxy to secure other server, you have to do two additional steps :
a. Add this directive because Place URL are, in standard,
http://Quickr.server.com/placename
ProxyPass /quickr
http://local.server.com .com
ProxyPassReverse /quickr
http://local.server.com .com
B. Modify the place catalog in the Quickr Server
The Place Catalog contains data on IBM® Lotus Quickr servers, and the places, rooms, and members on those servers.
Add your prefix, in this example
quickr in the field PlaceServerAccessURLPrefix
Screenshot of the PlaceServer document in the PlaceCatalog.nsf :
Image:IHS as a Reverse Proxy and Lotus Quickr-Domino 8.2
Link : How the Place Catalog Works
http://publib.boulder.ibm.com/infocenter/lqkrhelp/v8r0/index.jsp?topic=/com.ibm.lotus.quickr.admin.dom.doc/admin/qp_adm_pc_config_t.html