From 90ebb1ed84cf22b11f30aff2dd81124ced1ae457 Mon Sep 17 00:00:00 2001
From: Shane <shane@axiomdatascience.com>
Date: Wed, 09 Mar 2016 18:23:34 +0800
Subject: [PATCH] Use WAR/Tomcat, support plugins, document setting memory

---
 README.md |   22 +++++++++++++++++++++-
 1 files changed, 21 insertions(+), 1 deletions(-)

diff --git a/README.md b/README.md
index c340570..102d19a 100644
--- a/README.md
+++ b/README.md
@@ -40,6 +40,13 @@
 docker build -t kartoza/postgis .
 ```
 
+### Building with plugins
+
+To build a GeoServer image with plugins (e.g. SQL Server plugin, Excel output plugin),
+download the plugin zip files from the GeoServer download page and put them in
+`resources/plugins` before building. You should also download the matching version
+GeoServer WAR zip file to `resources/geoserver.zip`.
+
 ## Run
 
 You probably want to also have postgis running too. To create a running 
@@ -76,10 +83,23 @@
 docker run -d -v $HOME/geoserver_data:/opt/geoserver/data_dir kartoza/geserver
 ```
 
-You need to ensure the ``geoserver_data`` directory has sufficinet permissions
+You need to ensure the ``geoserver_data`` directory has sufficient permissions
 for the docker process to read / write it.
 
+## Setting Tomcat properties
 
+To set Tomcat properties such as maximum heap memory size, create a `setenv.sh` file such as:
+
+```shell
+JAVA_OPTS="$JAVA_OPTS -Xmx1536M -XX:MaxPermSize=756M"
+JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled"
+```
+
+Then pass the `setenv.sh` file as a volume at `/usr/local/tomcat/bin/setenv.sh` when running:
+
+```shell
+docker run -d -v $HOME/setenv.sh:/usr/local/tomcat/bin/setenv.sh kartoza/geserver
+```
 
 ## Credits
 

--
Gitblit v0.0.0-SNAPSHOT