XWiki Enterprise Manager Installation

Install XEM from a distribution

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'"

Tutorials

• Step by step minimum install of XEM based on MySQL

Convert an existing XWiki Enterprise instance

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).
  If you already have a XWiki.XWikiServerClass class document. Make sure to not overwrite it unless it contains exactly the same properties. Otherwise you could get conflict with already existing wikis descriptors.
• 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 (and add all needed 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'"