Create documentation for installing geoserver on Ubuntu
-------------------------------------------------------
Key: GEOS-1567
URL: http://jira.codehaus.org/browse/GEOS-1567
Project: GeoServer
Issue Type: Task
Components: Documentation
Affects Versions: 1.6.0-RC1
Reporter: Andrea Aime
Assignee: Andrea Aime
Fix For: 1.6.0
Installing GeoServer on Ubuntu is... hard... mostly due to the very locked down security model of tomcat there.
Short list of things to be expanded:
* install java6, tomcat 5.5, eventually tomcat-admin (libapr to get some speed up serving data, at least according to the tomcat devs...)
* change /etc/default/tomcat55 to look like:
{code}
# Run Tomcat as this user ID. Not setting this or leaving it blank will use the
# default of tomcat55.
#TOMCAT5_USER=tomcat55
# The home directory of the Java development kit (JDK). You need at least
# JDK version 1.4. If JAVA_HOME is not set, some common directories for
# the Sun JDK, various J2SE 1.4 versions, and the free runtimes
# java-gcj-compat-dev and kaffe are tried.
JAVA_HOME=/usr/lib/jvm/java-6-sun
# Directory for per-instance configuration files and webapps. It contain the
# directories conf, logs, webapps, work and temp. See RUNNING.txt for details.
# Default: /var/lib/tomcat5.5
#CATALINA_BASE=/var/lib/tomcat5.5
# Arguments to pass to the Java virtual machine (JVM).
JAVA_OPTS="-jvm server -Djava.awt.headless=true -Xmx256M"
# Java compiler to use for translating JavaServer Pages (JSPs). You can use all
# compilers that are accepted by Ant's build.compiler property.
#JSP_COMPILER=jikes
# Use the Java security manager? (yes/no, default: yes)
# WARNING: Do not disable the security manager unless you understand
# the consequences!
# NOTE: java-gcj-compat-dev currently doesn't support a security
# manager.
TOMCAT5_SECURITY=no
{code}
(hint, we disable the security manager because GeoServer is more like a desktop app, it changes
env variables, it writes to the file system, uses reflections, messes with java logging configuration and so on...
long story short, there is no way to make it work under a security manager).
- change line 148 of /etc/init.d/tomcat55 to look like:
{code}
find "$CATALINA_BASE"/temp/ -mindepth 1 -exec rm -rf {} +
{code}
(hint, we changed {{rm -f}} to {{rm -rf }, thanks Fabio for suggesting this}
- drop geoserver.war in /var/lib/tomcat55/webapps
- start up tomcat
If that does not work, have a look at /var/log/syslog since the default tomcat
output is redirected there.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira