Wiki source code of Upgrade the Standard Flavor of the Wiki using the Distribution Wizard
Last modified by Eleni Cojocariu on 2026/03/10 10:33
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{warning}} | ||
| 2 | WIP | ||
| 3 | {{/warning}} | ||
| 4 | |||
| 5 | To upgrade the (pre-installed) standard flavor of the wiki using the [[Distribution Wizard>>Documentation.UserGuide.Features.DistributionWizard]] (DW), after [[upgrading the distribution>>documentation.xs.admin.upgrade.distribution.upgrade-zip-package.WebHome]]: | ||
| 6 | |||
| 7 | 1. Start the XWiki instance. | ||
| 8 | 1. Log in with a user that has [[programming rights>>Documentation.AdminGuide.Access Rights.Permission types.WebHome||anchor="HProgrammingRights"]]. | ||
| 9 | 1. Choose what to do next from the Welcome step that appears in the Distribution Wizard:((( | ||
| 10 | {{image reference="distribution-wizard-steps.png" size="large" alt="The Distribution Wizard modal presenting the steps and the options to continue/later/never"/}} | ||
| 11 | |||
| 12 | * "Continue": Selecting this option will move you to the next step of the Distribution Wizard. | ||
| 13 | * "Later": DW will prompt you again after XWiki is restarted. The "Later" button has a sub-option, "Replay recorded actions", which triggers the same behavior as the Distribution Wizard. However, instead of redirecting you to the initially requested Page, it will direct you to the [[Extension History>>extensions:Extension.Extension Manager Application||anchor="HExtensionHistory"]], where you can upload and replay a history file (e.g., replay an install or upgrade from a different wiki). If the database is empty, you will need to log in as the superadmin. | ||
| 14 | * "Never": Discards the Distribution Wizard, and you will need to manually [[import the XAR>>documentation.xs.admin.imports.import-xwiki-pages.WebHome]]. | ||
| 15 | ))) | ||
| 16 | 1. Upgrade the extensions installed on your wikis. The first steps of the Distribution Wizard are skipped when upgrading the Standard Flavor.((( | ||
| 17 | * If you are on a subwiki, you can only check for updates for extensions installed on that specific subwiki. | ||
| 18 | * On the main wiki, global administrators can choose one of the following options:((( | ||
| 19 | * "Check for updates": Compute the upgrade plan for the main wiki and the global namespace only. | ||
| 20 | * "Check for updates on farm": Compute the upgrade plan for the entire farm (all wikis + global namespace):((( | ||
| 21 | {{gallery}} | ||
| 22 | [[image:check-for-extension-updates.png||alt="The Distribution wizard step 4 of checking for upgrades"]] | ||
| 23 | [[image:check-for-updates-farm.png||alt="The Distribution wizard step 4 of checking for upgrades on farm"]] | ||
| 24 | [[image:check-for-updates-finish.png||alt="The Distrivution Wizard showing that all extensions have been successfully updated"]] | ||
| 25 | {{/gallery}} | ||
| 26 | ))) | ||
| 27 | ))) | ||
| 28 | ))) | ||
| 29 | 1. Check the report after the installation has finished and click on "Continue". The report displays the updated Pages.((( | ||
| 30 | {{image reference="pages-distribution-wizard.png" size="large" alt="The Distribution Wizard showing step 5 the report of the installation"/}} | ||
| 31 | ))) | ||
| 32 | 1. Do the [[upgrade of the flavor for all the wikis>>||anchor="HAreallthewikisupgradedautomatically3F"]]. |
