Change comment:
added reference to store.xwiki.com and maven.xwiki.org for proxy servers with whitelist and example for HSQLDB installation.
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -81,21 +81,29 @@ 81 81 1. For Infinispan version 7, add ##<jmx duplicate-domains="true"/>## element in ##<cache-container...## element. 82 82 83 83 84 -== Running XWiki behind proxy -server ==84 +== Running XWiki behind a proxy server == 85 85 86 - Extension manager relies on remote repositories for finding and fetching available extensions. If your XWiki is installed in a network which requires accessing the internet through a proxy-server, most likely searching for extensions will fail and log files will contain ##connection refused## exceptions.86 +The extension manager relies on remote repositories for finding and fetching available extensions. If your XWiki is installed in a network which requires accessing the internet through a proxy server, most likely searching for extensions will fail and log files will contain ##connection refused## exceptions. 87 87 88 -In such cases you shouldconfigure XWiki toknowuse proxy-server.88 +In such cases, you can configure XWiki to use the proxy server. 89 89 90 90 XWiki uses default Java proxy configuration through Apache httpclient. See the [[Java Networking and Proxies documentation>>http://docs.oracle.com/javase/6/docs/technotes/guides/net/proxies.html]] for more details. 91 -The main idea is to add a set of proxy-related properties to system scope. 91 +The main idea is to add a set of proxy-related properties to the system scope. 92 92 93 - E.g. for Tomcat 6 it could be done in the following way: modify ##/<tomcat-home>/bin/catalina.sh## and added proxies to the ##JAVA_OPTS## variable definition:93 +For an installation using Tomcat 6 it could be done in the following way: modify ##/<tomcat-home>/bin/catalina.sh## and added proxies to the ##JAVA_OPTS## variable definition: 94 94 95 95 {{code}} 96 -JAVA_OPTS="$JAVA_OPTS -Dappserver.home=$CATALINA_HOME -Dappserver.base=$CATALINA_HOME **-Dhttp.proxyHost=proxy.mycompany.com -Dhttp.proxyPort=7777 -Dhttps.proxyHost=proxy.mycompany.com -Dhttps.proxyPort=7777**-Xmx512m -XX:MaxPermSize=196m $XWIKI_OPTS"96 +JAVA_OPTS="$JAVA_OPTS -Dappserver.home=$CATALINA_HOME -Dappserver.base=$CATALINA_HOME -Dhttp.proxyHost=proxy.mycompany.com -Dhttp.proxyPort=7777 -Dhttps.proxyHost=proxy.mycompany.com -Dhttps.proxyPort=7777 -Xmx512m -XX:MaxPermSize=196m $XWIKI_OPTS" 97 97 {{/code}} 98 98 99 +For an installation of the HSQLDB demo package you could do it by adding something like this to ##/xwiki-platform-distribution-flavor-jetty-hsqldb-9.8/start_xwiki.sh##: 100 + 101 +{{code}} 102 +XWIKI_OPTS="$XWIKI_OPTS -Dhttp.proxyHost=proxy.mycompany.com -Dhttp.proxyPort=7777 -Dhttps.proxyHost=proxy.mycompany.com -Dhttps.proxyPort=7777" 103 +{{/code}} 104 + 105 +Note: If your proxy server only allows partial access to the internet you need to make sure that the sites ##store.xwiki.com## and ##maven.xwiki.org## (note that one is .##com## and one is ##.org##) can be accessed. 106 + 99 99 == Unsupported major.minor version 51.0 == 100 100 101 101 This is because starting with version 6.0, XWiki requires Java 7 and you're using Java 6. You need to upgrade your Java version.