Wiki source code of XAR Export as a Backup Method
Last modified by Eleni Cojocariu-testing account on 2026/08/21 15:47
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Most of what a wiki contains is stored in Pages, so [[exporting them all as a XAR file>>doc:documentation.xs.admin.exports.export-content-xar-format.WebHome]] looks like a way to back up an instance. It is not one: a XAR file holds Pages, and an instance is more than its Pages. | ||
| 2 | |||
| 3 | |=What a backup has to hold|=In a XAR export | ||
| 4 | |Pages, their history, users, rights, and the settings entered through the Administration|Yes, and the history only when the export asks for it | ||
| 5 | |Attachments|Yes | ||
| 6 | |Event stream, statistics, the recycle bins of deleted Pages and attachments, mail statuses and the mails still queued, the notifications users received and their notification filter preferences, ratings and Page likes, mentions still to be processed, Feed plugin data|No, each is a database table of its own | ||
| 7 | |Configuration files, installed extensions, search indexes, log files|No, they are files of the web application and of the [[permanent directory>>doc:documentation.xs.admin.configuration.directories.permanent-directory.WebHome]] | ||
| 8 | |The [[instance id>>doc:documentation.xs.dev.instance.get-instance-id.WebHome]], and the identifier the instance uses in a cluster|No, and a clone deliberately keeps its own | ||
| 9 | |||
| 10 | Even for the Pages it does hold, an export is the weaker tool. A database dump is taken by a program written to back databases up, so it can run incrementally and check that what it wrote can be read back, neither of which a wiki can do about itself. | ||
| 11 | |||
| 12 | What a XAR export is for is moving content rather than protecting it: carrying Pages and applications from one instance to another, moving them to another wiki of a farm, and converting an instance from one database to another by exporting from the old instance and [[importing>>doc:documentation.xs.admin.imports.import-xwiki-pages.WebHome]] into a new one configured on the new database. |
