Wiki source code of Install the wiki UI
Version 9.1 by Thomas Mortagne on 2017/12/01
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | At this point your wiki is empty, i.e it doesn't contain any wiki page. Since applications in XWiki are done in wiki pages you also don't any application available (e.g. Blog, User Directory, User Profiles, etc). In addition, you wiki doesn't contain any user. | ||
2 | |||
3 | Thus the final step is to fill your Wiki with some initial content (i.e. wiki pages). | ||
4 | |||
5 | This is the job of the [[Distribution Wizard>>platform:Features.DistributionWizard]] which automatically starts when you are browsing your new XWiki instance for the first time. | ||
6 | |||
7 | {{info}} | ||
8 | Before XWiki 8.0, the Distribution Wizard was automatically creating an "Admin" user (with a password of ##admin## - in lowercase), which you can then use to log in your wiki. Starting with XWiki 8.0, the Distribution Wizard has a wizard step to let you create an admin user of your choice. | ||
9 | {{/info}} | ||
10 | |||
11 | The default distribution is a fully configured wiki that you can use as a starting point for creating your own wiki content. It provides the following: | ||
12 | |||
13 | * A [[Dashboard>>extensions:Extension.Dashboard Application]] | ||
14 | * A [[Panels Application>>extensions:Extension.Panels Application]] | ||
15 | * [[Search>>extensions:Extension.Search Application]] | ||
16 | * [[Administration features>>extensions:Extension.Administration Application]] (Access rights, Group and users management, etc) | ||
17 | * ... and much more | ||
18 | |||
19 | == Installing without internet connection == | ||
20 | |||
21 | === XIP package === | ||
22 | |||
23 | {{info}}Since 9.5{{/info}} a XIP package is provided for the Standard flavor. | ||
24 | |||
25 | This is actually a zip file containing the required XWiki extensions in the same format than the local extensions repository. | ||
26 | |||
27 | * [[download>>xwiki:Main.Download]] it | ||
28 | * unzip it (rename it to ##.zip## if your zip tool does not recognize it) in the folder ##<permanentdirectory>/extension/repository## (if you have complain about already existing file don't overwrite) | ||
29 | * restart XWiki if it was running | ||
30 | * resume standard installation, this time it will find the flavor locally | ||
31 | |||
32 | === Other methods === | ||
33 | |||
34 | Several options: | ||
35 | |||
36 | * Set up a local Extension Repository, either as a Maven Repository or using the [[Extension Repository Application>>extensions:Extension.Repository Application]]. Of course you'll need to [[prefill it with all the extensions you'll wish to install when offline>>Documentation.AdminGuide.FillLocalMavenRepository]], which isn't something easy to do. | ||
37 | * [[Install the Standalone Distribution>>Documentation.AdminGuide.InstallationStandalone]] which contains a default set of wiki pages. | ||
38 | * Use the [[Offline Packager Maven plugin>>https://github.com/xwiki-contrib/maven-plugin-offline-xwiki-repository-packager]]. | ||
39 | |||
40 | === Deprecated methods === | ||
41 | |||
42 | ==== Manually Import Wiki Pages ==== | ||
43 | |||
44 | {{warning}} | ||
45 | This is not supported anymore since 9.5 | ||
46 | {{/warning}} | ||
47 | |||
48 | You can also skip the Distribution Wizard import the default Wiki that we are providing as a [[XAR file>>http://forge.ow2.org/project/showfiles.php?group_id=170]] by using the [[Import feature>>platform:AdminGuide.ImportExport]]. Since there's no Admin user created at this point, you'll need to [[log in as ##superadmin##>>platform:AdminGuide.Configuration||anchor="HEnablesuperadminaccount"]] to be able to perform this import. | ||
49 | |||
50 | {{warning}} | ||
51 | If you're upgrading an existing wiki using the manual Import feature, 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. | ||
52 | |||
53 | On the other hand, if you use the Distribution Wizard, it'll automatically perform a merge and prompt you for action in case there's a conflict it cannot resolve automatically. Thus using the Distribution Wizard is what we recommend. | ||
54 | {{/warning}} |