Wiki source code of Installation
Version 72.2 by Vincent Massol on 2012/04/13
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
48.1 | 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} |
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| |
28.1 | 4 | |
 |
31.5 | 5 | XWiki is a Java-based wiki and runs on a Servlet Container such as Tomcat, Jetty, JBoss, WebLogic, WebSphere, etc. It also uses a relational database to store its content. It can run on almost any database (HSQL, MySQL, etc) but XWiki and the database need to be setup correctly. |
| |
13.1 | 6 | |
| |
1.96 | 7 | There are 2 solutions when installing XWiki: |
| |
36.1 | 8 | |
 |
72.1 | 9 | * Use the [[Standalone distribution>>AdminGuide.InstallationStandalone]] which already packages a Servlet Container (Jetty) and a database (HSQL). This is the recommended option for first time XWiki users and for users who wish to quickly try out XWiki. |
| 10 | * Use the [[WAR distribution>>AdminGuide.InstallationWAR]] and configure both your container and your database to work with it. | ||
| 11 | * Use the [[.deb package>>AdminGuide.InstallationViaAPT]] to install last version of XWiki and the dependencies. | ||
| |
31.5 | 12 | |
| |
72.1 | 13 | If you're instead upgrading an existing XWiki install check the [[Upgrade instructions page>>AdminGuide.Upgrade]]. |
| |
31.5 | 14 | |
| |
14.3 | 15 | Pick one of the trails in the outline on the right to get started. |
| |
31.5 | 16 | |
| |
28.1 | 17 | Once you've finished the installation check the other topics in the [[Admin Guide>>AdminGuide.WebHome]] for configuring and [[securing>>Security]] your wiki. |
| |
31.5 | 18 | |
| |
48.1 | 19 | {{info}} |
| |
52.4 | 20 | If you want to make manual installation or need to migrate an existing XWiki installation, check the [[Release Notes>>xwiki:ReleaseNotes.WebHome]]. |
| |
48.1 | 21 | {{/info}} |
| |
1.112 | 22 | |
| |
31.5 | 23 | = Tutorials = |
| |
1.95 | 24 | |
| |
14.3 | 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. |
| |
36.1 | 26 | |
| |
48.1 | 27 | {{warning}} |
| 28 | Tutorials external to the xwiki.org site have not been validated for correctness by the XWiki dev team and it's also possible that they are out of date. | ||
| 29 | {{/warning}} | ||
| |
14.3 | 30 | |
| |
28.1 | 31 | * [[XWiki On Windows (French)>>http://agoncalves.developpez.com/tutoriels/xwiki/creer-un-site-associatif/]] |
| 32 | * [[XWiki On Debian 4 (Etch) - Tomcat - PostgreSQL (or MySQL) (English)>>http://www.howtoforge.com/xwiki-tomcat-mysql-debian-etch]] | ||
| 33 | * [[XWiki On Debian 4 (Etch) - Tomcat - PostgreSQL (or MySQL) (German)>>http://www.howtoforge.de/howto/xwiki-on-debian-4-etch-tomcat-mysql]] | ||
| |
54.1 | 34 | * [[XWiki On Windows - GlassFish - Oracle (Russian)>>http://etvc.myxwiki.org/xwiki/bin/view/UNA/XWikiInstalation]] |
| |
57.2 | 35 | * [[XWiki on OpenSUSE - Tomcat - MySQL (English)>>http://geistreicher-papierkorb.blogspot.com/2011/03/setting-up-xwiki-on-opensuse-with-mysql.html]] |
| |
14.3 | 36 | |
| |
31.5 | 37 | = Prerequisites = |
| |
14.3 | 38 | |
 |
63.3 | 39 | * Java 6 or greater installed. |
| |
65.1 | 40 | * 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##)((( |
| 41 | {{warning}} | ||
| 42 | 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. | ||
| 43 | {{/warning}} | ||
| 44 | ))) | ||
| |
72.2 | 45 | * 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]]. |
 |
64.5 | 46 | |
| |
1.96 | 47 | |
| |
69.1 | 48 | = Installation Methods = |
| 49 | |||
| 50 | |||
| 51 | ==[[Using a standalone distribution >>AdminGuide.InstallationStandalone]]== | ||
| |
28.1 | 52 | |
| |
71.1 | 53 | It provides a built-in XWiki, with a portable database and a lightweight Java container. |
| 54 | 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 | ||
| |
31.5 | 55 | |
| 56 | |||
| |
71.1 | 57 | == [[Using .war package (usable for production)>>AdminGuide.InstallationWAR]] == |
| |
31.5 | 58 | |
| |
71.1 | 59 | 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. |
| |
69.1 | 60 | |
| |
71.1 | 61 | |
| |
69.1 | 62 | == [[Using .deb package (usable for production)>>AdminGuide.InstallationViaAPT]] == |
| 63 | |||
| |
71.1 | 64 | 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. |
| |
69.1 | 65 | |
| |
31.5 | 66 | = Troubleshooting = |
| |
1.125 | 67 | |
| |
70.1 | 68 | You can verify some basic settings of your XWiki install (on Tomcat, MySQL) using the [[Admin Tools application>>extensions:Extension.AdminTools]]. Keep in mind that some of these tools only work in a Linux environment. |
