Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Important notice on migrating Avono’s macro

Avono plugin contains set of Confluence macros. Most of users use only “plantuml” macro but here are 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.

...

Here you will find the relevant information about on-prem to on-prem and on-prem to cloud migration paths.

Expand
titleConversion on the Cloud instance

If you have been using Stratus-addon’s PlantUML on-prem solution, no action is required on your part.

If you have been using Avono’s PlantUML on-prem solution you need to perform the macro conversion.

Conversion page is available at <your_instance_url>/wiki/plugins/servlet/ac/com.mxgraph.confluence.plugins.plantuml/plantUmlConfig

Image Added

Converter requires page and attachment write permissions for the user running it.

It is recommended to first run the conversion on a copy of production space. Converter is not guaranteed to provide 100% fidelity immediately as it is subject of continuous development.

Feedback is welcome and you may direct it at our help desk.

Expand
titleConversion on the on-prem instances (server and DC)

If you have been using Stratus-addon’s PlantUML on-prem solution, no action is required on your part.

If you have been using Avono’s PlantUML on-prem solution you need to perform the diagram conversion.

Conversion page is available at <your_instance_url>/plugins/servlet/plantumlcloud/admin

Image Added
  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

...

  1. .

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

...

Migrate to Confluence cloud using Atlassian’s guidelines.

...

Install the PlantUML Diagrams for Confluence cloud.

...

Important note:

...

Important notice on conversion of Avono’s macros

Avono’s add-on contains set of Confluence macros. Most users use only plantuml macro but there are several others like flowchart or plantumlrender which use non-standard PlantUML syntax. This conversion procedure will only convert plantuml and linkgraph macros, other macros are currently not supported.

Empty Avono diagrams will not be converted to Stratus Addons’ format and users will need to remove them manually.

Important notice on linkgraph macro

linkgraph macro is currently unable to fetch most recent page relation data due to a regression in Confluence API as reported in CONFCLOUD-76030.

Please vote on the issue to help speed up the resolution.