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.

Last modified by Oana Florea on 2020/01/28 20:11

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 = Prerequisites =
6
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.
8
9 == Java ==
10
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:
13
14 {{code language="none"}}
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
21 == Mysql ==
22
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:
25
26 {{code language="none"}}
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
33 {{code language="none"}}
34 sudo /etc/init.d/mysql restart
35 {{/code}}
36
37 == Download XEM packages ==
38
39 From the [[download page>>xwiki:Main.Download]], get:
40
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##).
47
48 = Mysql configuration =
49
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:
51
52 {{code language="sql"}}
53 mysql -u root -e "grant all privileges on *.* to [email protected] identified by 'xwiki'"
54 {{/code}}
55
56 The above command will automatically create the xwiki user in the MySQL database.
57
58 = XEM web application installation =
59
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.
61
62 In the created directoy containing the unpacked zip file you will find :
63
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:
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
69
70 = XEM application xar importation =
71
72 We are now installing XEM application on XWiki Platform.
73 Run XEM using start_xwiki.sh (start_xwiki.bat for Windows system) and import:
74
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
78 See [[platform:AdminGuide.ImportExport]] to see how you may import a xar package in the XWiki Platform.
79
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.
81
82 = Configure the main wiki descriptor =
83
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.
85
86 There are two ways to access the main wiki and configure the main wiki descriptor if needed:
87
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
90
91 {{warning}}
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.
93 {{/warning}}
94
95 = [OPTIONAL] Create default XE wiki template =
96
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.
98
99 [[image:installscreenshot.png||style="border:1px black solid; width:650px;"]]

Get Connected