Sun Java Enterprise System 2005Q1 Technical Note |
Sun Java Enterprise System Technical Note: Configuring Web Server Reverse Proxy Plugin for Communications Express
2005Q1
Part Number 819-4194-11
The Sun Java Enterprise System 2005Q1 Technical Note: Configuring Web Server Reverse Proxy Plugin for Communications Express describes how to obtain and configure the Sun Java System Web Server 6.1 Reverse Proxy Plugin for use with Sun Java System Communications Express 2005Q1 and Sun Java System Messenger Express 2005Q1.
The component products affected by this technical note are:
This technical note contain the following sections:
Technical Note Revision History
Table 1 Revision History
Date
Description of Changes
December 21, 2006
Fixed Step 2 and Step 3 in “To Configure the Reverse Proxy Plugin.”
September 8, 2005
Initial release of this technical note.
Overview of the ProblemCurrently, in order for users of Mozilla and Firefox browsers to be able to compose HTML messages in Communications Express, Messenger Express (Webmail) must appear to be running on port 80. The current deployment requirements for Communications Express and Messenger Express state that they must be installed on the same host. However, if you choose to run Messenger Express on a port other than 80—which is often the case—you will run into this problem.
Using the Web Server 6.1 Reverse Proxy Plugin solves this problem, as it proxies the Communications Express connection from port 80 to the actual Webmail host:port pair, thus enabling you to run your Messenger Express on a different port.
Configuring the Reverse Proxy PluginThis section describes how to download and configure the Web Server Reverse Proxy Plugin. See http://docs.sun.com/source/819-0902/rpp61.html#wp012 for more information.
To Download and Install the Reverse Proxy Plugin
- Download the Web Server 6.1 Reverse Proxy Plugin to a temporary directory from this site:
http://www.sun.com/download/products.xml?id=3f567f91
- Extract the tar file.
- Install the package on the machine running mshttpd and Communications Express.
To Configure the Reverse Proxy Plugin
- Edit the Web Server’s magnus.conf file to enable the reverse proxy plugin by pointing to the directory where the libpassthrough.so file is installed.
For example, for a Web Server installation in the /opt/SUNWwbsvr directory, add the following line:
Init fn="load-modules" shlib="/opt/SUNWwbsvr/plugins/passthrough/libpassthrough.so" funcs="init-passthrough,auth-passthrough,check-passthrough,service-passthrough" NativeThread="no"
Make sure the libpassthrough.so file is under the same ownership as the Web Server owner and group names.
- Modify the Web Server’s obj.conf file. Assign uwc and messengerXpress names, and add objects to be checked for reverse proxy.
Add the following lines to the top of the default Object section:
Note
The servers parameter is a quoted, space-delimited list of the servers that receive the forwarded requests. In the example above, the server is webmail.red.example.com, and it is communicating on port 8080.
- Update the webmail.port parameter in the comms_express_deployed_dir/WEB-INF/config/uwcconfig.properties file to set the Webmail port to 80.
webmail.port=80
- Update the messagingsso.ipsecurity parameter in the comms_express_deployed_dir/WEB-INF/config/uwcauth.properties file so that Communications Express does not perform IP address check to restrict the access to the session.
messagingsso.ipsecurity=false
- Restart Web Server, for example:
cd /opt/SUNWwbsvr/https-webmail.red.example.com
./start
The reverse proxy startup will be noted in startup messages.
To Verify the Configuration
Known Issues and LimitationsSee the Java Enterprise System Release Notes Collection at the following URL to find out about known problems:
How to Report Problems and Provide FeedbackIf you have problems with Communications Express, contact Sun customer support using one of the following mechanisms:
- Sun Software Support services online at
http://www.sun.com/service/sunone/softwareSo that we can best assist you in resolving problems, please have the following information available when you contact support:
- Description of the problem, including the situation where the problem occurs and its impact on your operation
- Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
- Detailed steps on the methods you have used to reproduce the problem
- Any error logs or core dumps
Sun Welcomes Your CommentsSun is interested in improving its documentation and welcomes your comments and suggestions.
To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the title of this book is Communications Express 2005Q1 Technical Note: Configuring Web Server Reverse Proxy Plugin for Communications Express, and the part number is 819-4194-11.
Additional Sun ResourcesUseful Sun Java System information can be found at the following Internet locations:
- Sun Java System Documentation
http://docs.sun.com/prod/java.sys- Sun Java System Professional Services
http://www.sun.com/service/sunps/sunone- Sun Java System Software Products and Service
http://www.sun.com/software- Sun Java System Software Support Services
http://www.sun.com/service/sunone/software- Sun Java System Support and Knowledge Base
http://www.sun.com/service/support/software- Sun Support and Training Services
http://training.sun.com- Sun Java System Consulting and Professional Services
http://www.sun.com/service/sunps/sunone- Sun Java System Developer Information
http://developers.sun.com- Sun Developer Support Services
http://www.sun.com/developers/support- Sun Java System Software Training
http://www.sun.com/software/training- Sun Software Data Sheets
http://wwws.sun.com/software
Copyright � 2005 Sun Microsystems, Inc. All rights reserved.
Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and in other countries.
SUN PROPRIETARY/CONFIDENTIAL.
U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.
Use is subject to license terms.
This distribution may include materials developed by third parties.
Portions may be derived from Berkeley BSD systems, licensed from U. of CA.
Sun, Sun Microsystems, the Sun logo, Java and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries.
Copyright � 2005 Sun Microsystems, Inc. Tous droits r�serv�s.
Sun Microsystems, Inc. d�tient les droits de propri�t� intellectuels relatifs � la technologie incorpor�e dans le produit qui est d�crit dans ce document. En particulier, et ce sans limitation, ces droits de propri�t� intellectuelle peuvent inclure un ou plusieurs des brevets am�ricains list�s � l'adresse http://www.sun.com/patents et un ou des brevets suppl�mentaires ou des applications de brevet en attente aux Etats - Unis et dans les autres pays.
Propri�t� de SUN/CONFIDENTIEL.
L'utilisation est soumise aux termes du contrat de licence.
Cette distribution peut comprendre des composants d�velopp�s par des tierces parties.
Des parties de ce produit pourront �tre d�riv�es des syst�mes Berkeley BSD licenci�s par l'Universit� de Californie.
Sun, Sun Microsystems, le logo Sun, Java et Solaris sont des marques de fabrique ou des marques d�pos�es de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.