Wiki source code of XWiki Enterprise Manager Installation
Last modified by Milton Ferreira on 2020/01/28 20:11
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
39.1 | 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} |
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
 |
32.1 | 4 | |
 |
36.1 | 5 | = Install XEM from a distribution = |
| |
18.1 | 6 | |
| |
11.1 | 7 | This is the easiest way to install XEM. |
| |
1.1 | 8 | |
 |
34.1 | 9 | XEM is directly based on XE and can be installed exactly like it in most part ([[platform:AdminGuide.Installation]]). |
| |
2.1 | 10 | |
| |
12.1 | 11 | The main differences/restrictions are : |
| |
5.1 | 12 | |
 |
47.1 | 13 | * Uses the XEM WAR and XAR distributions which you can find on the [[download>>Main.Download]] page (instead of XE ones). |
| 14 | * Currently, XEM only fully supports MySQL and Oracle RDBMS. | ||
| |
39.1 | 15 | * 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:((( |
| 16 | {{code language="sql"}} | ||
| 17 | mysql -u root -e "grant all privileges on *.* to [email protected] identified by 'xwiki'" | ||
| 18 | {{/code}} | ||
| |
36.2 | 19 | ))) |
| |
9.1 | 20 | |
| |
36.1 | 21 | == Tutorials == |
| |
9.1 | 22 | |
| |
34.1 | 23 | * [[Step by step minimum install of XEM based on MySQL>>AdminGuide.InstallationMySQL]] |
| |
6.1 | 24 | |
 |
48.1 | 25 | = Install XEM using Debian (.DEB) Packages and Extension Manager = |
| 26 | |||
| 27 | {{info}} | ||
| 28 | Supported since Version 4.2 | ||
| 29 | {{/info}} | ||
| 30 | |||
| 31 | * Do a standard[[ XWiki Enterprise Installation using the Debian Package>>platform:AdminGuide.InstallationViaAPT]] | ||
| 32 | ** do not forget to give Tomcat enough memory (described in installation page) | ||
| 33 | ** do not import default XE pages as XAR manually | ||
| 34 | ** use the new Distribution Manager to gather the default Wiki pages | ||
| |
52.1 | 35 | * Follow instructions on [[Convert an existing XWiki Enterprise instance with Extension Manager>>||anchor="HUsingExtensionManager"]] |
| |
48.1 | 36 | |
| |
36.1 | 37 | = Convert an existing XWiki Enterprise instance = |
| |
34.1 | 38 | |
| |
49.1 | 39 | * 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:((( |
| 40 | {{code language="sql"}} | ||
| 41 | mysql -u root -e "grant all privileges on *.* to [email protected] identified by 'xwiki'" | ||
| 42 | {{/code}} | ||
| 43 | ))) | ||
| 44 | |||
| |
51.1 | 45 | == Using Extension Manager == |
| |
49.1 | 46 | |
| |
51.1 | 47 | {{info}} |
| 48 | Supported since Version 4.1 | ||
| 49 | {{/info}} | ||
| 50 | |||
| 51 | * Go to the Administration page and browse to the Extension Manager | ||
| 52 | * Choose 'Add Extension' and do an advanced search for the id ##org.xwiki.manager:xwiki-manager-ui## in the preferred version (generally the current XE version) | ||
| 53 | * Install it | ||
| 54 | * Go to the main wiki descriptor (http://host/xwiki/bin/view/XWiki/XWikiServerXwiki) and set the right domain name (and add aliases if needed) | ||
| 55 | * Set your wiki as "virtual" to allow multiple wikis. For this, edit your ##xwiki.cfg## file and set the ##xwiki.virtual## property to ##1##:((( | ||
| |
49.1 | 56 | {{code language="sql"}} |
| 57 | xwiki.virtual=1 | ||
| 58 | {{/code}} | ||
| 59 | ))) | ||
| |
51.1 | 60 | * Restart XWiki |
| |
55.1 | 61 | * Go to //XemManager.Install// page (http://host/xwiki/bin/view/XemManager/Install) and follow instructions |
| |
49.1 | 62 | |
| |
54.1 | 63 | == Using Distribution Wizard == |
| |
49.1 | 64 | |
| |
51.1 | 65 | {{info}} |
| 66 | Supported since Version 4.2 | ||
| 67 | {{/info}} | ||
| 68 | |||
| |
49.1 | 69 | * stop XWiki |
| 70 | * replace the war you are using with the XEM one (take care of properly merging any files you might have modified like xwiki.cfg and xwiki.properties) | ||
| 71 | * when you restart XWiki you will get the Distribution Wizard telling you that you changed the distribution from XE to XEM and asking you to install XEM UI | ||
| |
55.1 | 72 | * Go to //XemManager.Install// page (http://host/xwiki/bin/view/XemManager/Install) and follow instructions |
| |
49.1 | 73 | |
| 74 | == Manually == | ||
| 75 | |||
| |
36.1 | 76 | In order to transform an existing wiki into XEM you will need to: |
| |
6.1 | 77 | |
| |
47.1 | 78 | * Install the Application Manager [[plugin>>extensions:Extension.Application Manager Plugin]] ([[Download>>http://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-application-manager-api/||rel="__blank"]]) and [[application>>extensions:Extension.Application Manager Application]] ([[Download>>http://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-application-manager-ui/||rel="__blank"]]). |
| 79 | ** This means downloading the plugin and putting it in ##WEB-INF/lib## | ||
| 80 | ** For the application, use the [[Import Tool>>platform:AdminGuide.ImportExport]] to import the XAR you have downloaded | ||
| 81 | * Install the Wiki Manager [[plugin>>extensions:Extension.Wiki Manager Plugin]] ([[Download>>http://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-wiki-manager-api/||rel="__blank"]]) and [[application>>extensions:Extension.Wiki Manager Application]] ([[Download>>http://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-wiki-manager-ui/||rel="__blank"]]). | ||
| 82 | ** Same thing as before: download the plugin and put it in ##WEB-INF/lib## then download the application and import the XAR.((( | ||
| |
39.1 | 83 | {{warning}} |
| |
47.1 | 84 | If you already have an ##XWiki.XWikiServerClass## class document make sure not to overwrite it at import time unless it contains exactly the same properties. Otherwise you could get a conflict in the descriptors of already existing wikis. |
| |
39.1 | 85 | {{/warning}} |
| |
36.3 | 86 | ))) |
| |
47.1 | 87 | * Install the Workspace [[module>>extensions:Extension.Workspace Module]] ([[Download>>http://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-workspace-ui/]]) and [[application>>extensions:Extension.Workspace Application]] ([[Download>>http://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-workspace-api/]]). |
| 88 | ** Again, same thing as before: download the component and put it in ##WEB-INF/lib## then download the application and import the XAR. | ||
| 89 | * [**Applicable only for versions older than 3.3**] Edit your ##xwiki.cfg## file and add the following entries to activate the plugins:((( | ||
| |
35.1 | 90 | {{code}} |
| |
17.1 | 91 | xwiki.plugins=\ |
| 92 | [...] | ||
| 93 | com.xpn.xwiki.plugin.wikimanager.WikiManagerPlugin,\ | ||
| 94 | com.xpn.xwiki.plugin.applicationmanager.ApplicationManagerPlugin | ||
| |
34.1 | 95 | {{/code}} |
| |
36.1 | 96 | ))) |
| |
47.1 | 97 | * [optional] Import the [[XEM application xar>>Main.Download]]. This just adds some links, modifies the home page and adds a main wiki default descriptor (since XEM 1.0M3). |
| 98 | * [optional] If your main wiki's domain name does not start with "www" (or will not be accessed by IP or "localhost") | ||
| 99 | ** if you`ve imported the XEM application, just go to the descriptor (http://host/xwiki/bin/view/XWiki/XWikiServerXwiki) and modify the domain name (and add all needed aliases) | ||
| 100 | ** if you did not import the XEM application, you will have to create a wiki server descriptor for it: create the XWiki.XWikiServerXwiki page and add an XWiki.XWikiServerClass object in it with the proper domain name. | ||
| |
49.1 | 101 | * set your wiki as "virtual" to allow multiple wikis. For this, edit your ##xwiki.cfg## file and set the ##xwiki.virtual## property to ##1##:((( |
| |
39.1 | 102 | {{code language="sql"}} |
| 103 | xwiki.virtual=1 | ||
| 104 | {{/code}} | ||
| |
36.2 | 105 | ))) |
