Last modified by Simon Urli on 2023/10/10

From version 2.1
edited by Guillaume Fenollar
on 2012/01/25
Change comment: There is no comment for this version
To version 6.2
edited by Vincent Massol
on 2012/08/23
Change comment: Added check for system req

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.GuillaumeFenollar
1 +XWiki.VincentMassol
Content
... ... @@ -1,10 +1,16 @@
1 +{{box cssClass="floatinginfobox" title="**Contents**"}}
2 +{{toc/}}
3 +{{/box}}
4 +
1 1  You'll need to perform 2 mandatory steps:
2 2  
3 3  * Install and configure a Servlet Container
4 4  * Install and configure a relational database
5 5  
6 -== Install and configure a Servlet Container ==
10 +But first, you'll need to [[download>>enterprise:Main.Download]] the .war version of XWiki and check the [[System Requirements>>AdminGuide.Installation#HPrerequisites]].
7 7  
12 += Install and configure a Servlet Container =
13 +
8 8  XWiki will work with any Servlet Container (provided it's properly configured obviously). We're only listing instructions for a few containers but you can adapt these instructions for your favorite container.
9 9  
10 10  * [[Tomcat installation>>AdminGuide.InstallationTomcat]]
... ... @@ -33,12 +33,21 @@
33 33   permission java.net.SocketPermission "127.0.0.1:3306", "connect,resolve";
34 34  // Needed by the scheduler plugin -> quartz, but works without (maybe except scheduling? should be checked)
35 35  // permission java.util.PropertyPermission "org.quartz.properties", "read";
42 +
43 +//Allow file storage directory reading - for directory and everything underneath
44 +//This is dependent on the setting of environment.permanentDirectory in xwiki.properties
45 +permission java.io.FilePermission "${catalina.home}${file.separator}xwikidata${file.separator}", "read,write,delete";
46 +permission java.io.FilePermission "${catalina.home}${file.separator}xwikidata${file.separator}-", "read,write,delete";
47 +//Allow file storage directory reading - temporary directory and everything underneath
48 +//This is dependent on the setting of environment.temporaryDirectory in xwiki.properties.
49 +permission java.io.FilePermission "${catalina.home}${file.separator}temp${file.separator}", "read,write,delete";
50 +permission java.io.FilePermission "${catalina.home}${file.separator}temp${file.separator}-", "read,write,delete";
36 36  };
37 37  {{/code}}
38 38  
39 39  You're now ready to install and configure your relational database.
40 40  
41 -== Install and configure a Relational Database ==
56 += Install and configure a Relational Database =
42 42  
43 43  XWiki can work with a lot of relational databases. We're only listed those that we have tested it on.
44 44  
... ... @@ -69,6 +69,25 @@
69 69  If your database is empty this will result in a minimal empty wiki installation. You may want to use the [[Import/Export tool>>AdminGuide.ImportExport]] to import some pages in your wiki. We recommend that you import the [[provided default XAR>>xwiki:Main.Download]]. If you're upgrading from an existing installation your database should already contain the pages you had before.
70 70  {{/info}}
71 71  
72 -== Concluding Step ==
87 += Concluding Step =
73 73  
74 74  At this stage you have finished configuration XWiki. If you start your database and container and point your browser to http:~//localhost:8080/xwiki/ you'll have a working, albeit minimal, wiki (without any page loaded). The next step is either to create new pages by hand or import the default Wiki that we are providing as a [[XAR file>>xwiki:Main.Download]], by using the [[Import feature>>AdminGuide.ImportExport]].
90 +
91 += Installing the Default Wiki XAR =
92 +
93 +The default wiki is a fully configured wiki that you can use as a starting point for creating your own wiki content. It provides the following:
94 +
95 +* A Blog
96 +* A Recent Changes page
97 +* The [[Panels Application>>extensions:Extension.Panels Application]]
98 +* Search
99 +* Administration page (Access rights, Group and users management, etc)
100 +* ... and much more
101 +
102 +**It comes configured with an "Admin" user (password is "admin" in lowercase). You'll need that username/password to log in once you've imported the default wiki.**
103 +
104 +To install the XAR, use the [[Import/Export tool>>AdminGuide.ImportExport]].
105 +
106 +{{warning}}
107 +If you're upgrading an existing wiki be careful that the XAR import operation will replace the content of the existing pages of your wiki with the content of the XAR (New pages that you have created will not be modified). As a consequence it's critical that you [[perform a backup>>platform:AdminGuide.Backup]] first and read the upgrade nodes bellow carefully.
108 +{{/warning}}

Get Connected