Migrations

Important notice on migrating Avono’s macro

Avono plugin contains set of Confluence macros. Most of users use only “plantuml” macro but they have several others like flowchart or plantumlrender. Our plugin is pure PlantUML plugin that offers exactly that - ability to create and edit PlantUML diagrams. Additional features from Avono are not supported and we do not aim to do so in the future. This means that currently we only offer migration of “plantuml“ macro.

Also, if you have empty Avono diagrams they will not be migrated into our format and users will need to remove them manually.

Migrating from Avono’s PlantUML add-on to PlantUML Diagrams for Confluence

  1. Create a test environment by importing or cloning the production Confluence server instance. This step is optional but we always recommend running the import on a test instance first.

  2. Install the PlantUML Diagrams for Confluence server add-on.

  3. Rebuild the search index.

  4. Navigate to <confluence_url>/plugins/servlet/plantumlcloud/admin and open the Avono import tab like on the example screenshot below.

  5. To perform the import, click on 'Import' button and wait for the process to finish.

  6. Download the import report and make sure there are no errors.

  7. Perform visual inspection of imported pages to make sure the import process has completed with satisfactory results.

  8. Migrate to Confluence cloud using Atlassian’s guidelines.

  9. Install the PlantUML Diagrams for Confluence cloud.

Important note:

This procedure takes place on your server/DC environment. It needs to be performed before moving to cloud.