This XWiki Enterprise Manager product has been abandoned in version 5.2 and is not supported anymore. Its main feature was to allow the creation of sub wikis. This multi-wiki feature has been incorporated back into XWiki Standard.

For the moment we're keeping this wiki available for our legacy users.


Hide last authors
Sorin Burjan 41.4 1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
Thomas Mortagne 38.1 4
Thomas Mortagne 34.1 5 = Prerequisites =
Thomas Mortagne 32.1 6
Silvia Macovei 41.1 7 This tutorial is meant to help you install XWiki XEM on a Linux machine. However, if you want to install XWiki XEM on a Windows environment, the same steps will apply.
Sorin Burjan 38.6 8
Thomas Mortagne 34.1 9 == Java ==
Thomas Mortagne 32.1 10
Silvia Macovei 41.1 11 * Download and install Java 1.5 or more from the Java website : http://www.java.com
12 * After installing Java use the following command provided your JVM was successfully installed. You should get something similar to:
Thomas Mortagne 32.1 13
Sorin Burjan 40.3 14 {{code language="none"}}
Sorin Burjan 38.4 15 [email protected]:~$ java -version
16 java version "1.6.0_24"
17 Java(TM) SE Runtime Environment (build 1.6.0_24-b07)
18 Java HotSpot(TM) 64-Bit Server VM (build 19.1-b02, mixed mode)
19 {{/code}}
20
Thomas Mortagne 34.1 21 == Mysql ==
Thomas Mortagne 32.1 22
Silvia Macovei 41.1 23 * Download and install Mysql from the Mysql website: http://dev.mysql.com/downloads/
24 * After installing MySQL use the following command to check if the MySQL server is properly started and listening for connections. You should get something similar to:
Thomas Mortagne 1.1 25
Sorin Burjan 40.3 26 {{code language="none"}}
Sorin Burjan 38.5 27 [email protected]:~$ sudo netstat -tap | grep mysql
28 tcp 0 0 localhost:mysql *:* LISTEN 2798/mysqld
29 {{/code}}
30
31 * If the server is not running correctly, you can type the following command to start it:
32
Sorin Burjan 40.3 33 {{code language="none"}}
Sorin Burjan 38.5 34 sudo /etc/init.d/mysql restart
35 {{/code}}
36
Thomas Mortagne 34.1 37 == Download XEM packages ==
Thomas Mortagne 11.1 38
Thomas Mortagne 32.1 39 From the [[download page>>xwiki:Main.Download]], get:
Sergiu Dumitriu 21.2 40
Sorin Burjan 41.4 41 * Starting XEM 3.3:
42 ** the last XEM distribution package preconfigured (##xwiki-manager-jetty-mysql-<version>.zip##).
43 ** the last XEM application xar package (##xwiki-manager-ui-all-<version>.xar##).
44 * Before XEM 3.3:
45 ** the last XEM distribution package preconfigured (##xwiki-enterprise-manager-mysql-<version>.zip##).
46 ** the last XEM application xar package (##xwiki-enterprise-manager-wiki-administrator-<version>.xar##).
Thomas Mortagne 17.1 47
Thomas Mortagne 34.1 48 = Mysql configuration =
Thomas Mortagne 18.1 49
Silvia Macovei 41.1 50 Follow the XWiki Platform mysql installation ([[platform:AdminGuide.InstallationMySQL]]) except for privileges settings. To be able to create new wikis the MySQL user will need to have all rights on database. You can use any username you want, but make sure you update your hibernate configuration accordingly. The following example uses the username called xwiki:
Thomas Mortagne 25.1 51
Thomas Mortagne 35.1 52 {{code language="sql"}}
53 mysql -u root -e "grant all privileges on *.* to [email protected] identified by 'xwiki'"
54 {{/code}}
Thomas Mortagne 3.1 55
Sorin Burjan 38.8 56 The above command will automatically create the xwiki user in the MySQL database.
57
Thomas Mortagne 34.1 58 = XEM web application installation =
Thomas Mortagne 32.1 59
Silvia Macovei 41.1 60 The XEM web application contains the XWiki Enterprise web application and the XEM plugins which are [[Application Manager>>extensions:Extension.Application Manager Plugin]] and [[Wiki Manager>>extensions:Extension.Wiki Manager Plugin]]. To install it you just need to unpack ##xwiki-enterprise-manager-mysql-<version>.zip## anywhere you want.
Thomas Mortagne 33.1 61
Silvia Macovei 41.1 62 In the created directoy containing the unpacked zip file you will find :
Thomas Mortagne 32.1 63
Silvia Macovei 41.1 64 * start_xwiki.sh (start_xwiki.bat for Windows system) which starts the Jetty server containing the XWiki Platform
65 * stop_xwiki.sh (stop_xwiki.bat for Windows system) which stops the Jetty server containing the XWiki Platform
66 * ##webapps/xwiki## directory which contains the XEM web application. You will mostly access:
Thomas Mortagne 33.1 67 ** ##webapps/xwiki/WEB-INF/hibernate.cfg.xml## which contains database communication hibernate parameters
68 ** ##webapps/xwiki/WEB-INF/xwiki.cfg## which contains xwiki configuration parameters
Thomas Mortagne 12.1 69
Thomas Mortagne 34.1 70 = XEM application xar importation =
Thomas Mortagne 32.1 71
Silvia Macovei 41.1 72 We are now installing XEM application on XWiki Platform.
Oana Florea 42.1 73 Run XEM using start_xwiki.sh (start_xwiki.bat for Windows system) and import:
Thomas Mortagne 33.1 74
Oana Florea 42.1 75 * Before 3.3 ##xwiki-enterprise-manager-wiki-administrator-<version>.xar## (see the complete list of version on the [[maven releases for xwiki-enterprise-manager-wiki-administrator>>http://maven.xwiki.org/releases/org/xwiki/manager/xwiki-enterprise-manager-wiki-administrator/]])
76 * After 3.4 ##xwiki-manager-ui-all-<version>.xar## (see the complete list of version on the [[maven releases for xwiki-manager-ui-all>>http://maven.xwiki.org/releases/org/xwiki/manager/xwiki-manager-ui-all/]])
77
Silvia Macovei 41.1 78 See [[platform:AdminGuide.ImportExport]] to see how you may import a xar package in the XWiki Platform.
Thomas Mortagne 33.1 79
Silvia Macovei 41.1 80 The imported package contains the default users rights configuration, so to edit your wiki or to access the administration interface you will need to log in with the "Admin" user and the "admin" password.
Thomas Mortagne 4.1 81
Thomas Mortagne 34.1 82 = Configure the main wiki descriptor =
Thomas Mortagne 30.1 83
Silvia Macovei 41.1 84 By default a subwiki is accessed based on XEM's host. See [["The domain name based wiki access">>AdminGuide.AccessWiki#HThedomainnamebasedwikiaccess]] for more details.
Thomas Mortagne 33.1 85
Silvia Macovei 41.1 86 There are two ways to access the main wiki and configure the main wiki descriptor if needed:
Thomas Mortagne 31.1 87
Silvia Macovei 41.1 88 * the cleaner way: access the main wiki with the ip if you can or with a host starting with "www" (like www.xwiki.org) or "xwiki" and add the right hosts to the main wiki's descriptor
89 * set xwiki.virtual=false in xwiki.cfg and reput it to true when you have correctly configured the main wiki descriptor
Thomas Mortagne 15.1 90
Thomas Mortagne 36.1 91 {{warning}}
Silvia Macovei 41.1 92 The default first alias in the descriptor is ##localhost##. The first alias is what is used to generated the external URL, so you should carefully choose the proper setting. ##localhost## is generally not what you want in production.
Thomas Mortagne 36.1 93 {{/warning}}
94
Thomas Mortagne 34.1 95 = [OPTIONAL] Create default XE wiki template =
Thomas Mortagne 26.1 96
Oana Florea 42.1 97 Go to ##http:~/~/localhost:8080/xwiki/bin/view/XemManager/Install## and confirm. This will create a wiki called "templatexe" containing an XWiki Enterprise wiki and list this wiki as a template from which it's possible to create another wiki.
Thomas Mortagne 33.1 98
Sorin Burjan 41.4 99 [[image:installscreenshot.png||style="border:1px black solid; width:650px;"]]

Get Connected