XWiki - AdminGuide - Installation

Contents

XWiki Enterprise Manager Installation

This is the easiest way to install XEM.

XEM is directly based on XE and can be installed exactly like it in most part (Installation).

The main differences/restrictions are :

Use the XEM WAR and XAR distributions which you can find on the download page (in place of XE ones).
Currently XEM only fully supports MySQL and Oracle RDBMS.
In order for XEM to be able to create new wikis on demand, you will need to give all rights to your database user. For example for MySQL, execute:
```
mysql -u root -e "grant all privileges on *.* to xwiki@127.0.0.1 identified by 'xwiki'"
```

In order to transform an existing wiki into XEM you will need to :

Install Application Manager plugin (Download) and application (Download).
- This means downloading the plugins and putting them in WEB-INF/lib
- For the applications use the Import Tool to import the XARs you have downloaded
Install Wiki Manager plugin (Download) and application (Download).

Edit your xwiki.cfg file and add the following entries to activate the plugins:

xwiki.plugins=\
  [...]
  com.xpn.xwiki.plugin.wikimanager.WikiManagerPlugin,\
  com.xpn.xwiki.plugin.applicationmanager.ApplicationManagerPlugin

[optional] Import XEM application xar. This just add some links, modify home page and add a main wiki default descriptor (since XEM 1.0M3).
[optional] If your main wiki domain name does not start with "www" (or will not be accessed by IP or "localhost")
- if you imported XEM application, just go to the descriptor (http://host/xwiki/bin/view/XWiki/XWikiServerXwiki) and modify the domain name (add add all deeded aliases)
- if you did not imported XEM application, you will have to create a wiki server descriptor for it: create XWiki.XWikiServerXwiki page and add a XWiki.XWikiServerClass object in it with the proper domain name.
Set your wiki as "virtual" to allow multiple wikis. For this edit your xwiki.cfg file and set the xwiki.virtual property to 1:
```
xwiki.virtual=1
```
In order for XEM to be able to create new wikis on demand, you will need to give all rights to your database user. For example for MySQL, execute:
```
mysql -u root -e "grant all privileges on *.* to xwiki@127.0.0.1 identified by 'xwiki'"
```