From efba97d1d2568d4a71c39ec049cb1a5015855f75 Mon Sep 17 00:00:00 2001
From: James Moger <james.moger@gitblit.com>
Date: Wed, 30 Nov 2011 17:21:30 -0500
Subject: [PATCH] Clarified Tomcat forward-slash encoding in documentation (issue 29)

---
 docs/03_faq.mkd |   10 ++++++++++
 1 files changed, 10 insertions(+), 0 deletions(-)

diff --git a/docs/03_faq.mkd b/docs/03_faq.mkd
index fdc2020..478e199 100644
--- a/docs/03_faq.mkd
+++ b/docs/03_faq.mkd
@@ -61,6 +61,16 @@
 
 If you are using Apache mod_proxy, specify [AllowEncodedSlashes NoDecode](http://httpd.apache.org/docs/2.2/mod/core.html#allowencodedslashes).
 
+### Running Gitblit on Tomcat
+
+Tomcat takes the extra precaution of [disallowing embedded slashes by default](http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10).  This breaks Gitblit urls.  
+You have a few options on how to handle this scenario:
+
+1. [Tweak Tomcat](http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10)  
+Add *org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true* to *CATALINA_OPTS*
+2. *web.mountParameters = false* and use non-pretty, parameterized urls
+3. *web.forwardSlashCharacter = !* which tells Gitblit to use **!** instead of **/**
+
 ## General Interest Questions
 
 ### Gitblit?  What kind of name is that?

--
Gitblit v1.9.1