From version < 73.1 >
edited by Vincent Massol
on 2012/05/03
To version < 74.1 >
edited by Sergiu Dumitriu
on 2012/06/08
< >
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.VincentMassol
1 +XWiki.Sergiu
Content
... ... @@ -67,3 +67,17 @@
67 67  = Troubleshooting =
68 68  
69 69  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.
70 +
71 +== Running multiple instances of XWiki in the same container ==
72 +
73 +If you get this error:
74 +
75 +{{code}}
76 +com.xpn.xwiki.XWikiException: Error number 3 in 0: Could not initialize main XWiki context
77 +Wrapped Exception: Failed to get cache factory component
78 +...
79 +Caused by:
80 +org.infinispan.jmx.JmxDomainConflictException: Domain already registered org.xwiki.infinispan
81 +{{/code}}
82 +
83 +You need to edit ##WEB-INF/cache/infinispan/config.xml## for each instance of XWiki, and change the ##jmxDomain## value (found under the ##globalJmxStatistics## tag) to have a unique name.

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.

There are 2 solutions when installing XWiki:

  • Use the Standalone distribution 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.
  • Use the WAR distribution and configure both your container and your database to work with it.
  • Use the .deb package to install last version of XWiki and the dependencies.

If you're instead upgrading an existing XWiki install check the Upgrade instructions page.

Pick one of the trails in the outline on the right to get started.

Once you've finished the installation check the other topics in the Admin Guide for configuring and securing your wiki.

If you want to make manual installation or need to migrate an existing XWiki installation, check the Release Notes.

Tutorials

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.

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.

Prerequisites

  • Java 6 or greater installed.
  • A Servlet Container supporting Servlet 2.4.
  • 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)

    Note that storing attachments with the default (in database) storage mechanism is very memory intensive. See the administrators guide to attachments for more information about memory cost and the alternative filesystem based attachment store.

  • Check the Release Notes for the version you're installing to see what Browsers and Databases are supported for it. You can also check our general Support Strategy.

Installation Methods

Using a standalone distribution 

It provides a built-in XWiki, with a portable database and a lightweight Java container.
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

Using .war package (usable for production)

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.

Using .deb package (usable for production)

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.

Troubleshooting

You can verify some basic settings of your XWiki install (on Tomcat, MySQL) using the Admin Tools application. Keep in mind that some of these tools only work in a Linux environment.

Running multiple instances of XWiki in the same container

If you get this error:

com.xpn.xwiki.XWikiException: Error number 3 in 0: Could not initialize main XWiki context
Wrapped Exception: Failed to get cache factory component
...
Caused by:
org.infinispan.jmx.JmxDomainConflictException: Domain already registered org.xwiki.infinispan

You need to edit WEB-INF/cache/infinispan/config.xml for each instance of XWiki, and change the jmxDomain value (found under the globalJmxStatistics tag) to have a unique name.

Get Connected