25 Dec
2011
25 Dec
'11
9:04 p.m.
Hi, All
Recently I had to deploy XWiki under Centos. As a brand new task for me it required tonns
of documentation to dig in.
Finally I managed to set up: Centos + MySQL + Tomcat 7 + nginx.
Everything is fine besides some Tomcat's behaviour.
- localhost:8080 or localhost:8080/ shows ROOT application
- localhost:8080/xwiki shows XWiki application as desired. Fine.
- if nginx redirects required requests from 80 port to localhost:8080/xwiki we obtain
wrong links, because /xwiki automatically is added to requested string. Works fine only
first request to e.g. "mydomain.com".
So, next step is to set XWiki application as DAFAULT application in Tomcat, so
localhost:8080 will call XWiki by default.
Googling gave me several complicated solutions with redirect and two almost clear
solutions with Tomcat configuration:
- Deploy XWiki in $CATALINA_HOME/webapps/ROOT
After this nginx can easily proxy all requests like "mydomain.com" on 80 port to
localhost:8080
- Deploy XWiki in $CATALINA_HOME/webapps/xwiki
Then add Following string in Host section in $CATALINA_HOME/conf/server.xml :
<Context path="" docBase="${catalina.home}/webapps/xwiki"/>
I tried second way, it works fine, nginx redirects all "mydomain.com" requests
to localhost:8080 correctly, BUT all URLs from required, e.g,
localhost:8080/xwiki/bin/view/Main
become
localhost:8080/bin/view/Main
So, we miss /xwiki in URL.
As for me, "xwikiless" URLs solution looks fine, BUT as far as I remember,
somebody from developers' team pointed out in mailing lists some time ago, that /xwiki
in URL could be necessary in some cases. (??)
The questions are:
1. Is it crucial for XWiki and/or some XWiki applications to eat shorten URL on
Tomcat's level?
Will it affect, for example, on virtual wiki mapping for URLs based addresses like
http://myfarm.net/xwiki/wiki/wikiname/?
2. Should we change anything in XWiki configuration files to force it working with such
URLs?
OR, the best way to put ${catalina.home}/webapps/ROOT/Web-inf/web.xml with redirect
information as it is done e.g. in standalone XWiki for Windows?
From other side, I also found an opinions on forums, that redirect method is not the best
solution for search engines robots. So, I got lost a bit :-)
Kindly ask you to clarify this tricky subject in order to avoid unnecessary errors in the
future.
On finding right, community approved solution(s), I will amend documentation accordingly.
Thanks in advance,
Dmitry Bakbardin