| Info |
|---|
Apache Tomcat is the recommended servlet container to use with uPortal 3.2. While uPortal 3.2 requires a Servlet 2.5-compatible servlet container and another servlet container may be used, most uPortal implementers deploy to Apache Tomcat. Choosing Tomcat 6.x will likely allow uPortal adopters to get the best advice from the community. |
Installing Apache Tomcat
Linux/Unix Installation
1. Download Apache Tomcat 6.x
...
| No Format |
|---|
TOMCAT_HOME/bin/shutdown.sh |
Windows Installation
1. Download Apache Tomcat 6.x for Windows
...
4. Start Tomcat. Try starting up Tomcat by running the C:\apache-tomcat-6.x\bin\startup.bat batch file. Point your browser to http://localhost:8080 and you should see the default Tomcat home page (see above image). To shutdown the server run C:\apache-tomcat-6.x\bin\shutdown.bat batch file.
Further Tomcat Configurations
JVM settings
- Examples of JVM settings
- uPortal Heap Tuning
uPortal Specific Notes
Shared Libraries
uPortal places libraries in CATALINA_BASE/shared/lib The default Tomcat 6.0 download does not enable libraries to be loaded from this directory. To resolve this you must edit CATALINA_BASE/conf/catalina.properties and change the line that begins "shared.loader=" to the following:
| No Format | ||||||
|---|---|---|---|---|---|---|
| ||||||
shared.loader=${catalina.base}/shared/classes,${catalina.base}/shared/lib/*.jar
|
Shared Sessions
Jasig portlets, as well as many other popular JSR-168 portlets, rely on the ability to share user session data between the portal web application and portlet applications. To enable this feature in Tomcat, you must add the emptySessionPath="true" parameter to the in-use connector (configured in Tomcat 6 in CATALINA_BASE/conf/server.xml ).
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000" redirectPort="8443" emptySessionPath="true"/>
|
GZipping HTML
Browser-side performance may be improved somewhat by GZip-ping downloaded content where appropriate. uPortal 3.2 already GZips CSS and JavaScript. uPortal does not, however, GZip the uPortal page itself.
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000" redirectPort="8443" emptySessionPath="true"
compression="on" compressableMimeType="text/html,text/xml,text/plain"/>
|
Example Installations
- Servlet Container Installation/Configuration instructions for Windows OS (Chris Doyle - John Hopkins University)
- CalPoly Tomcat Configurations
...