Last modified by Simon Urli on 2023/10/10

From version 8.1
edited by Vincent Massol
on 2014/06/07
Change comment: There is no comment for this version
To version 7.6
edited by Vincent Massol
on 2013/11/05
Change comment: typo



Page properties
... ... @@ -64,8 +64,7 @@
64 64  * Create a user with all privileges on that database
65 65  * Copy your RDBMS Java drivers to the XWiki webapp's ##WEB-INF/lib## directory
66 66  * Configure XWiki to use the created database. This involves modifying the ##WEB-INF/hibernate.cfg.xml## file as is described in the tutorials for each database below.
67 -
68 -Note that a more scalable and J2EE-conformant tactic is to use the Servlet container to manage your data source. You modify the web app as little as possible... hopefully one day XWiki will allow you to override ##hibernate.cfg.xml## without needing to change the app itself.
67 +* (A more scalable and J2EE-conformant tactic is to use the servlet container to manage your data source. You modify the web app as little as possible... hopefully one day Xwiki will allow you to override hibernate.cfg.xml without needing to change the app itself.
69 69  ** Do not add your JDBC library to the web app. Install it to the container classpath instead, like to ##$CATALINA_HOME/common/lib##.
70 70  ** Do not set user, url, etc., nor connection.provider_class in ##hibernate.cfg.xml##. The critical settings are ##connection.datasource## (with JNDI name like ##java:/comp/env/jdbc/XWikiDS##) and the dialect class for your DB vendor. Do not comment out <mapping resource="..."/> elements, hibernate needs them. (You should leave the provider_class unset, since Xwiki's implementation doesn't handle container-managed data sources).
71 71  ** Manage all database access settings using your container facilities, for example Tomcat admin webapp or server.xml + APPNAME.xml. Uncommenting the <resource-ref> element inside ##WEB-INF/web.xml## that matches the above JNDI name and looks like <res-ref-name>jdbc/XWikiDS</res-ref-name> could be a good idea.
... ... @@ -85,7 +85,25 @@
85 85  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.
86 86  {{/info}}
87 87  
88 -== Concluding Step ==
87 += Concluding Step =
89 89  
90 -{{include reference="AdminGuide.InstallationConcludingSteps"/}}
89 +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]].
91 91  
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>>extensions:Extension.Blog Application]]
96 +* A [[Dashboard>>extensions:Extension.Dashboard Application]]
97 +* A [[Panels Application>>extensions:Extension.Panels Application]]
98 +* [[Search>>extensions:Extension.Search Application]]
99 +* [[Administration features>>extensions:Extension.Administration Application]] (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