Changes for page Installation

Last modified by Thomas Mortagne on 2023/12/19

From version 74.2
edited by Roman Muntyanu
on 2012/07/16
Change comment: There is no comment for this version
To version 75.2
edited by Vincent Massol
on 2012/08/23
Change comment: Put prereq before tutorials since prereqs are always valid

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.coldserenity
1 +XWiki.VincentMassol
Content
... ... @@ -20,6 +20,17 @@
20 20  If you want to make manual installation or need to migrate an existing XWiki installation, check the [[Release Notes>>xwiki:ReleaseNotes.WebHome]].
21 21  {{/info}}
22 22  
23 += Prerequisites =
24 +
25 +* Java 6 or greater installed.
26 +* A Servlet Container supporting Servlet 2.4.
27 +* A minimum of 300MB of heap memory and 96MB of permGen. Recommended value are above 512MB for the heap and 128MB for the permGen (##-Xmx512m -XX:MaxPermSize=128m##)(((
28 +{{warning}}
29 +Note that storing attachments with the default (in database) storage mechanism is very memory intensive. See the [[administrators guide to attachments>>platform:AdminGuide.Attachments]] for more information about memory cost and the alternative filesystem based attachment store.
30 +{{/warning}}
31 +)))
32 +* Check the [[Release Notes>>xwiki:ReleaseNotes.WebHome]] for the version you're installing to see what Browsers and Databases are supported for it. You can also check our [[general Support Strategy>>dev:Community.SupportStrategy]].
33 +
23 23  = Tutorials =
24 24  
25 25  Tutorials are step by step procedures to install XWiki for a specific configuration. You can choose to follow one of them or follow the instructions in the sections below.
... ... @@ -34,32 +34,17 @@
34 34  * [[XWiki On Windows - GlassFish - Oracle (Russian)>>http://etvc.myxwiki.org/xwiki/bin/view/UNA/XWikiInstalation]]
35 35  * [[XWiki on OpenSUSE - Tomcat - MySQL (English)>>http://geistreicher-papierkorb.blogspot.com/2011/03/setting-up-xwiki-on-opensuse-with-mysql.html]]
36 36  
37 -= Prerequisites =
38 -
39 -* Java 6 or greater installed.
40 -* A Servlet Container supporting Servlet 2.4.
41 -* A minimum of 300MB of heap memory and 96MB of permGen. Recommended value are above 512MB for the heap and 128MB for the permGen (##-Xmx512m -XX:MaxPermSize=128m##)(((
42 -{{warning}}
43 -Note that storing attachments with the default (in database) storage mechanism is very memory intensive. See the [[administrators guide to attachments>>platform:AdminGuide.Attachments]] for more information about memory cost and the alternative filesystem based attachment store.
44 -{{/warning}}
45 -)))
46 -* Check the [[Release Notes>>xwiki:ReleaseNotes.WebHome]] for the version you're installing to see what Browsers and Databases are supported for it. You can also check our [[general Support Strategy>>dev:Community.SupportStrategy]].
47 -
48 -
49 49  = Installation Methods =
50 50  
50 +== [[Using a standalone distribution >>AdminGuide.InstallationStandalone]] ==
51 51  
52 -==[[Using a standalone distribution >>AdminGuide.InstallationStandalone]]==
53 -
54 54  It provides a built-in XWiki, with a portable database and a lightweight Java container.
55 55  Standalone distribution is not recommended in a production environment. If you need to use it in a production basis, you may look at the two other options
56 56  
57 -
58 58  == [[Using .war package (usable for production)>>AdminGuide.InstallationWAR]] ==
59 59  
60 60  It provides a java application package that have to be installed in a Java container (such as Tomcat). This can be used on almost every operating systems.
61 61  
62 -
63 63  == [[Using .deb package (usable for production)>>AdminGuide.InstallationViaAPT]] ==
64 64  
65 65  It provides a .deb package that can be used on a Debian-based operating system. It can be installed with dpkg or apt, installation is thus automated.
... ... @@ -84,6 +84,7 @@
84 84  
85 85  
86 86  == Running XWiki behind proxy-server ==
83 +
87 87  Extension manager relies on remote repositories for searching and fetching available extensions, so if your XWiki is installed in a network accessing the internet through proxy-server, most likely extensions search will return you nothing and log files will contain ##connection refused## exceptions.
88 88  
89 89  In such cases you should configure XWkik to know your proxy-server.
... ... @@ -93,5 +93,4 @@
93 93  
94 94  E.g. for Tomcat 6 it could be done in the following way. modify ##/<tomcat-home>/bin/catalina.sh## and added proxies to ##JAVA_OPTS## variable definition:
95 95  
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 -Dftp.proxyHost=proxy.mycompany.com -Dftp.proxyPort=7777** -Xmx1738m -Xms1738m -XX:MaxPermSize=256m $XWIKI_OPTS"##
97 -
93 +##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** -Xmx1738m -Xms1738m -XX:MaxPermSize=256m $XWIKI_OPTS"##

Get Connected