Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide

Apache Geronimo Application Server 2.1.1

OpenSSO Enterprise server supports Geronimo Application Server 2.1.1 with Tomcat on Solaris systems only.

OpenSSO Enterprise Pre-Deployment Tasks

  1. Modify the /geronimo-tomcat6-jee5-2.0.2/bin/ file by adding -X:MaxPermSize=512M, as shown in the following start block:

    elif [ "$1" = "start" ] ; then 
    touch "$GERONIMO_OUT" 
    -Dorg.apache.geronimo.base.dir="$GERONIMO_BASE" \ 
    -Djava.endorsed.dirs="$ENDORSED_DIRS" \"$GERONIMO_TMPDIR" \ 
    -XX:MaxPermSize=512M \ 
    -jar "$GERONIMO_HOME"/bin/server.jar $LONG_OPT "$@" \
    >> $GERONIMO_OUT 2>&1 & 
    echo "" echo "Geronimo started in background. PID: $!" 
    if [ ! -z "$GERONIMO_PID" ]; then echo $! > $GERONIMO_PID 
  2. Provide a deployment plan file either inside or outside of the opensso.war file. If placed inside the opensso.war file, name the plan geronimo-web.xml and place the file in WEB-INF directory. If placed outside of the WAR file, the plan file can be named otherwise. Here is a sample plan file:

    <?xml version="1.0" encoding="UTF-8"?>
    <web-app xmlns="">

    In the above example, the WAR file is deployed at:


    The web application is deployed at protocol://server:port/opensso1. You can change the deployment plan depending on your deployment scenario.

Related Information: