Changes for page Installation

Last modified by Thomas Mortagne on 2023/12/19

<
From version < 118.1 >
edited by Adam Shand
on 2018/02/14
To version < 119.1 >
edited by Adam Shand
on 2018/02/15
>
Change comment: added reference to store.xwiki.com and maven.xwiki.org for proxy servers with whitelist and example for HSQLDB installation.

Summary

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 should configure XWiki to know use 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.

Get Connected