Wiki source code of Import/Export
Version 20.1 by Danilo Oliveira on 2013/06/11
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | This feature allows you to export one or several pages from your wiki into a **XAR** file (**X**Wiki **AR**chive) or to import one or several pages from an existing XAR file. This is useful for moving wiki pages from one instance to another or to perform lightweight backup of your wiki pages. | ||
| 6 | |||
| 7 | {{warning}} | ||
| 8 | This feature doesn't replace a [[proper backup>>Backup]]. | ||
| 9 | {{/warning}} | ||
| 10 | |||
| 11 | = Importing XWiki pages = | ||
| 12 | |||
| 13 | Prerequisites: | ||
| 14 | {{warning}} | ||
| 15 | If it is a firs import and you have installed the war package, you will need use the superadmin user to do the first import. | ||
| 16 | {{/warning}} | ||
| 17 | |||
| 18 | * A configured database and Servlet Container. If you don't have them, see the [[Installation guide>>AdminGuide.Installation]]. | ||
| 19 | |||
| 20 | Follow these steps: | ||
| 21 | |||
| 22 | * Ensure your database and container are started | ||
| 23 | * Point your browser to ##http:~/~/localhost:8080/xwiki/bin/admin/XWiki/XWikiPreferences## or hover over "Wiki" and click on "Administer Wiki" | ||
| 24 | * Click on "Import" | ||
| 25 | * Attach the XAR file you wish to import and then **select it from the list** under "Available packages". After a few seconds you should see the list of all the pages in your XAR listed and selected by default (unselect the pages/folders you don't wish to import):((( | ||
| 26 | {{image reference="ImportPackageColibri.png"/}} | ||
| 27 | ))) | ||
| 28 | * Select the second radio button if you want to replace the document history with the history from the imported package. If you don't select it the newly imported pages will have the revision "1.1" | ||
| 29 | * Click "Import". This will import all the selected pages | ||
| 30 | * At this stage your rights might have been changed as the import may have imported different rights. You may need to log out and log in again. | ||
| 31 | |||
| 32 | {{info}} | ||
| 33 | If you own the sub-wiki (virtual wiki, wiki-farm), you need to be sure that you either: | ||
| 34 | * install with a global user having Programming Rights (PR) and UNCHECK the backup pack option | ||
| 35 | * install with a global user having PR and keep the backup pack option but in this case MAKE SURE that the user defined in the XAR exists and has PR. | ||
| 36 | Otherwise all imported pages would be saved without PR and scripts won't work until you resave them under the user with Programming Rights . | ||
| 37 | |||
| 38 | Note, that pages requiring PR are supposed to also contain a XWiki.RequiredRightClass xobject so it should be easy to query them. If you find some that don't have this XObject please let us know. This XObject is just indicative and doesn't change permissions. | ||
| 39 | {{/info}} | ||
| 40 | |||
| 41 | {{warning}} | ||
| 42 | If you get a 'Java heap space Out Of Memory exception' you'll need to increase the memory allocated to the JVM running XWiki. How you do this depends on the container you use: | ||
| 43 | * For Jetty you must change a line in ##start_xwiki.bat## (or ##start_xwiki.sh##) from //JAVA_OPTS=-Xmx300m// to something like //JAVA_OPTS=-Xmx1024m// | ||
| 44 | * For Tomcat you must set //CATALINA_OPTS// to something like //-Xmx1024m// | ||
| 45 | {{/warning}} | ||
| 46 | |||
| 47 | = Exporting XWiki pages = | ||
| 48 | |||
| 49 | Prerequisites: | ||
| 50 | |||
| 51 | * A configured database and Servlet Container. If you don't have them, see the [[Installation guide>>AdminGuide.Installation]]. | ||
| 52 | |||
| 53 | Follow these steps: | ||
| 54 | |||
| 55 | * Ensure your database and container are started | ||
| 56 | * Point your browser to ##http:~/~/localhost:8080/xwiki/bin/admin/XWiki/XWikiPreferences## | ||
| 57 | * Click "Export" and fill the form | ||
| 58 | * Click "Export"((( | ||
| 59 | {{image reference="ExportPackageColibri.png"/}} | ||
| 60 | ))) | ||
| 61 | |||
| 62 | == Customizing a XAR == | ||
| 63 | |||
| 64 | When doing an export, XWiki pages are saved using the XAR format. This is in fact a renamed ZIP format with a //package.xml// file containing metadata about the export. A typical XAR created when doing an export will include all the pages on your XWiki instance. | ||
| 65 | |||
| 66 | It is possible however to create a XAR that will include only the pages you want. This is useful when you want to export only the pages of a specific application. Here are the steps: | ||
| 67 | |||
| 68 | * Unzip the file | ||
| 69 | * Keep the pages you want to put in your archive | ||
| 70 | * Edit ##package.xml## to delete the pages you do not want to be in the archive | ||
| 71 | * Zip together the modified ##package.xml## file and the pages you want to put together in your archive, naming the file "MyArchive".xar where "MyArchive" is the actual name you want to give it | ||
| 72 | * You're done! You can now import this specific set of pages to any XWiki instance | ||
| 73 | |||
| 74 | {{info}} | ||
| 75 | In the future XWiki will offer the ability to do selective exports natively. For the moment you'll need to install the [[Multipage Export Extension>>extensions:Extension.Multipage Export Application]]. | ||
| 76 | {{/info}} |
