Versions Compared

Key

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

This guide shows you how execute a full migration between serversfrom Server to Data Center. If you only want to transfer Refined settings and configurations from test to production, click here. read these best practices.

Migration guide

Data from Refined for Confluence/Jira is stored in the same database as Confluence/Jira. In addition to this we are also storing some also store a number of files in a folder inside the Confluence/Jira home folder.

When you are migrating data between environments, for example from a production instance to a test instance, you'll need to manually copy the Refined data folder. The Refined data folder contains data for themes and layouts, including images.

Migrating from Server to Data Center

...

Rw step

...

  1. Follow Atlassian’s recommendations on how to move to Data Center.

Rw step
  1. Copy Refined’s data folder from

...

  1. the Local home folder into the

...

  1. Shared home folder.

...

Location of Refined data folder

...

Confluence: Confluence home → originaltheme

...

  1. You can find Refined’s data folders here:

Missing images or themes

...

If you are facing an issue that images or themes are not displayed when you have migrated to Data Center, it is likely caused by Refined’s data folder. You need to manually copy this folder from the original server to the destination server (see path above)don’t manually copy Refined’s data folder after migration (see step 2 in the migration guide), you will not see images or themes. If you have done completed this step but the images are still not displayed, please check the permissions of the Refined data folder. The folder should be owned by the same user who owns the Confluence or Jira home folder.

Sometimes you'll need to do a hard refresh of the page to get the images to show up. :

  • On Windows/Linux

...

  • , hit CTRL + F5

  • On Mac, hit CMD + Shift + R

Please note:

  1. Changing context path might result into images not displaying. This applies to images in undisplayed images in themes and layouts.

  2. Links with absolute URLs will still point to the old instance. This is why we recommend using relative links. Read about relative links in the Refined for Confluence Server/DC documentation and the Refined for Jira Server/DC documentation.