Wiki source code of Migrate XWiki using Distribution Wizard
Last modified by Ilie Andriuta on 2024/04/03 12:34
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | 1. Create/access an older version of XWiki | ||
| 2 | 1. Create a subwiki | ||
| 3 | 1. Create a Nested Page and a Terminal Page with some content in both Main Wiki (e.g. PageN.WebHome and PageN.PageT) and subwiki (e.g. PageNS.WebHome and PageNS.PageTS) | ||
| 4 | 1. Add some attachments on both Nested Pages and Terminal Pages | ||
| 5 | 1. Add a large sized attachment (min 200 MB) | ||
| 6 | 1. Add an attachment having spaces in its name | ||
| 7 | 1. Add an Office files attachment | ||
| 8 | 1. Delete some attachments from both Nested Page and Terminal Page | ||
| 9 | 1. Create a Nested Page and a Terminal Page, add an attachment on each of them and then delete the pages | ||
| 10 | 1. Add some comments on some pages | ||
| 11 | 1. To test migration of Untyped links, edit a page and insert the following in Wiki/Source mode: | ||
| 12 | - for the page located on Main Wiki: | ||
| 13 | {{code}}[[subwiki:PageNS.WebHome]] | ||
| 14 | [[subwiki:PageNS.PageTS]]{{/code}} | ||
| 15 | - for the page located on subwiki: | ||
| 16 | {{code}}[[xwiki:PageN.WebHome]] | ||
| 17 | [[xwiki:PageN.PageT]]{{/code}} | ||
| 18 | 1. Create some users in Main Wiki and subwiki | ||
| 19 | 1. Add an user from Main Wiki to be a member of the subwiki | ||
| 20 | 1. Install an extension (can be different) on both Main Wiki and subwiki (with some entries, if applicable) | ||
| 21 | 1. Enable Notifications for an user (e.g. on Main Wiki) or more | ||
| 22 | 1. Perform some events (e.g. create, edit, comment) to generate some notifications for this user(s) | ||
| 23 | 1. Mark some events as read from Notifications List | ||
| 24 | 1. Stop XWiki | ||
| 25 | 1. Unzip/install the newer version of XWiki (to which the migration will be made) | ||
| 26 | 1. Go to the newer instance and copy/cut the {{code}}[...]webapps\xwiki{{/code}} folder and replace it (first delete the old one) in the same location on the older version | ||
| 27 | (on Jetty - XWiki Standalone packaging a better practice is to copy old {{code}}data{{/code}} folder and replace it in the new Jetty setup) | ||
| 28 | 1. Start XWiki | ||
| 29 | 1. Login as Admin | ||
| 30 | 1. Use the Distribution Wizard to complete the upgrade process | ||
| 31 | 1. After upgrade, open Notifications List of the regular user(s) as well as for the Admin | ||
| 32 | 1. Observe the events listed | ||
| 33 | 1. Observe the Notification filters for both Admin and regular user(s) | ||
| 34 | 1. Go to the previously created Nested and Terminal pages on both Main Wiki and subwiki | ||
| 35 | 1. Click on the attachments (also on LiveData for attachments, click on Next Page - Previous Page to test pagination) | ||
| 36 | 1. On Applications Panel, click on the installed application and check the entries on both Main Wiki and subwiki | ||
| 37 | 1. Go to page Index > Deleted Pages and observe the table entries on both Main Wiki and subwiki | ||
| 38 | 1. Click on the deleted page(s) | ||
| 39 | 1. Go to Page Index > Deleted Attachments and observe the table entries on both Main Wiki and subwiki | ||
| 40 | 1. Click on the deleted attachment(s) | ||
| 41 | 1. Go to User Index on both Main Wiki and subwiki and observe the entries (on subwiki see the global users as well as the local users) | ||
| 42 | |||
| 43 | |||
| 44 | {{info}}**NOTE:** If upgrading to XWiki 11.4 and higher (from instances older than 11.4), the **'solr'** folder must be deleted from the configured permanent directory of the XWiki instance in order for the Solr search to work. The Solr index will be deleted as a result but it will be recreated automatically and the entire wiki will be re-indexed after a server restart (see [[Release Notes for XWiki 11.4>>https://www.xwiki.org/xwiki/bin/view/ReleaseNotes/Data/XWiki/11.4/#HIssuesspecifictoXWiki11.4]]) | ||
| 45 | Starting XWiki 11.8 deleting of **'solr'** folder manually is not necessary, since the migration is automated{{/info}} | ||
| 46 | |||
| 47 | {{warning}}**NOTE:** Starting 14.1 RC1, the underlying implementation of the Mentions Application, H2 MVStore is now replaced by the newly introduced Asynchronous document static analysis module. When upgrading to 14.1RC1+ the H2 MVStore files are not used anymore. | ||
| 48 | Consequently, any updated document queued for upgrade when the server is stopped will be discarded, and some users will not be notified of their mentions. | ||
| 49 | **Please make sure that the queue size is at zero before upgrading** (see JMX).{{/warning}} | ||
| 50 | |||
| 51 | {{warning}}**NOTE:** If upgrading to **XWiki 14.6 and up** from a version of XWiki **older than 12.4** you will need to migrate events (notifications) if you don't want them to appear lost. There used to be a step proposing it in the Distribution Wizard and this step was removed but you can still ask for a migration from the wiki administration **(Administer Wiki -> Social -> Notifications -> Events migration)**, see [[Release Notes for XWiki 14.6>>https://www.xwiki.org/xwiki/bin/view/ReleaseNotes/Data/XWiki/14.6/#HNomorelegacyeventsmigrationstepintheDistributionWizard]]{{/warning}} |
