| Info |
|---|
Apache Tomcat is the recommended servlet container to use with uPortal 4. While uPortal 4 requires a Servlet 3.0-compatible servlet container and another servlet container may be used, most uPortal implementers deploy to Apache Tomcat. Choosing Tomcat 78.x will likely allow uPortal adopters to get the best advice from the community. |
...
Linux/Unix Installation
1. Download Apache Tomcat 78.x
2. Untar the package as follows:
| No Format |
|---|
tar -zxvf apache-tomcat-78.0.4233.tar.gz |
3.Optionally rename your install to something more meaningful:
| No Format |
|---|
mv apache-tomcat-78.0.4233 uportal-tomcat |
4.Set your environment variables:
...
Windows Installation
1. Download Apache Tomcat 78.x for Windows
2. Unzip the download into a suitable directory. For example, you may unzip the file into the C:\ directory. This will create a directory like C:\apache-tomcat-78.x containing your Tomcat files.
...
| No Format |
|---|
CATALINA_HOME : C:\apache-tomcat-78.x JAVA_HOME : C:\Program Files\Java\jdk1.x |
...
4. Start Tomcat. Try starting up Tomcat by running the C:\apache-tomcat-68.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-68.x\bin\shutdown.bat batch file.
...
uPortal places libraries in CATALINA_BASE/shared/lib The default Tomcat 7 or 8 download does not enable libraries to be loaded from this directory.
...
To enable this feature for Tomcat 7 .0or 8, add the sessionCookiePath="/" to CATALINA_BASE/conf/context.xml.
...
uPortal requires a larger than standard PermGen space (Java 7 only) and more heap than may be allocated by default. A good conservative set of heap settings are -XX:MaxPermSize=384m (Java 7 only) -Xmx1024mXmx2048m. To add these, create a file called either setenv.sh (Linux/Mac) or setenv.bat (Windows) in your CATALINA_HOME/bin directory and add the configuration as follows:. Note for production settings you would typically want more heap space, at least 4GB. See Additional Tomcat Configuration below.
| Code Block | ||
|---|---|---|
| ||
JAVA_OPTS="$JAVA_OPTS -XX:+PrintCommandLineFlags -XX:MaxPermSize=384m -Xms1024m -Xmx1024mXmx2048m -Djsse.enableSNIExtension=false" |
...
If you are fronting Tomcat wtih Apache or other hardware systems, you may want to do the compression in Apache or those systems instead.
Tomcat 7/8 parallel startup (optional)
Tomcat 7.0.23+ can be configured to have multiple webapps start up in parallel, reducing server startup time. Set the startStopThreads attribute of a Host to a value greater than one. See http://wiki.apache.org/tomcat/HowTo/FasterStartUp for more details and other suggestions.
...
| Info | ||
|---|---|---|
| ||
Additional References |
| Warning | ||||
|---|---|---|---|---|
| ||||
Please send us feedback at uportal-user@lists.jasig.org |