How do I enable migration logs?

Purpose

How do I enable migration logs?

Answer

We have implemented a logging feature which can be useful to track start, progress and completion of migration event.

The migration logs can also help with debugging should there is any issue with the migration process.

Follow these steps

  • go to the Cog Icon  > General Configuration

In the sidebar, under Administration

  • choose Logging and Profiling

On the Logging and Profiling screen, you need to Add a New Entry.

  • add net.customware.confluence.plugin.scaffolding.migration  as a new entry in Class/Package Name

  • set the New Level to

    • INFO to see start, progress and completion of the migration process

    • DEBUG to see page mappings and form data being sent and to further debug the migration process should there is any issue with the migration process

Any sensitive data in the forms will be logged when this is enabled.

  • choose Add entry

  • scroll down and choose Save

Perform the migration as per specified in Step 2 - Proceed with Cloud migration

  • save the log

You can find the log file here: <confluence-installation>/home/logs/atlassian-confluence.log.

Contact support and provide this log file together with

  • the wiki markup

  • the metadata of the affected page

Removing the Debug Entry

After saving the log file, you may, for any reason, want to disable the logging. Here's how you do it:

  • return to the Logging and Profiling screen

  • locate the entry that you have added

  • choose Remove

The Debug Entry will also be removed automatically if the Confluence instance is restarted.