Tutorial

To upgrade the (pre-installed) standard flavor of the wiki using the Distribution Wizard (DW), after upgrading the distribution:

1. Start the XWiki instance.
2. Log in with a user that has programming rights.
3. Choose what to do next from the Welcome step that appears in the Distribution Wizard:

   

   • "Continue": Selecting this option will move you to the next step of the Distribution Wizard.
   • "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, 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.
   • "Never": Discards the Distribution Wizard, and you will need to manually import the XAR.
4. Upgrade the extensions installed on your wikis. The first steps of the Distribution Wizard are skipped when upgrading the Standard Flavor.
   • If you are on a subwiki, you can only check for updates for extensions installed on that specific subwiki.
   • On the main wiki, global administrators can choose one of the following options:
     • "Check for updates": Compute the upgrade plan for the main wiki and the global namespace only.
     • "Check for updates on farm": Compute the upgrade plan for the entire farm (all wikis + global namespace):

       
       
       

5. Check the report after the installation has finished and click on "Continue". The report displays the updated Pages.

   

6. Do the upgrade of the flavor for all the wikis.

FAQ

Why do I need programming rights to run the Distribution Wizard when upgrading?

Extension Pages may need to be modified during the upgrade process. If the upgrade is performed with a user that does not have Programming Rights, these pages might not be updated correctly. 

Are all the wikis upgraded automatically?

You need to upgrade every wiki: If you have multiple wikis (subwikis), you need to navigate to the wiki index and run the Distribution Wizard on every wiki.

More

To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.

Related

• Install a Standalone (Demo) Distribution.