| Info |
|---|
This guide shows you how to transfer Refined settings and configurations. If you’re looking for a guide for full migration from Server to Data Center, click here. |
When transferring Refined settings and configurations from one Confluence server to another, some parts need to be manually synced between the two environments, and some can be exported and imported.
...
Because of the way that Confluence is built and how databases index its content
...
, you’ll need to complete some manual steps to transfer Refined’s settings and configurations. We advise using two browser windows side by side
...
: one
...
with the test/staging environment and one
...
with the
...
production environment.
...
...
Refined Administration settings
...
For each tab in the Refined Administration
...
, manually copy the settings from your test or staging environment to your production environment.
...
Themes
...
Go to your test or staging environment and
...
Active themes are marked in the Theme Gallery with a label, hovering or clicking the label will show you where the theme is applied in the Site Builder. The theme will be downloaded.
...
export all active themes. Import the themes in your production environment
...
Select the file you downloaded in the previous step and upload it.
3. Site Builder
Depending on the size of your site, this may be where you will spend most time. Due to technical reasons, it is currently not possible to export and import any site builder which means you will have to manually recreate what you have.
3.1 Site settings
...
Start by entering the sites you have, it may be that you only have the one marked
| Status | ||||
|---|---|---|---|---|
|
...
Edit each site by going to the settings cog and clicking edit. ⚠️ Note that there are several expandable areas in the settings.
...
. How to export/import themes.
Site Builder
In both the test/staging environment and the production environment, head to the Refined Administration > the Site Builder tab.
Create new sites in the production environment to match the test/staging environment.
Manually recreate all settings of each site: click each site’s Cogwheel > Edit site to see the settings. You might need to expand certain items to see all settings. Note that the additional sites to the global one will inherit the settings of the global one, unless changes have been specifically made to the site. The global site gets
...
Site building
When your sites are added, add your items to each site whether this is a category or a link.
For each item in your site, edit the item by hovering over it > clicking the settings cog > edit. ⚠️ Note that there are several expandable areas in the settings.
Also add in any category users you may have set up for a category.
When your site building is done, you can start with your layouts.
4. Layouts
Every layout that you have edited in your site can be exported from the layout. As you have your site building done, each item exists in your site. Go through and export your layouts.
Go to the first layout you wish to edit and use the pen in the top right corner to edit it.
...
In the layout, click the Import/Export button. A file will be downloaded. Please note that the last published version is downloaded: drafts will be discarded.
In your production environment, use the same path to edit the layout, click Import/Export and upload your file. Publish the layout and it is now transferred from one environment to the other.
...
Repeat the steps for each layout in your site builder.
5. Footer
The footer needs to be manually copied. Please note that there is one global footer and then each site can have an edited footer too.
Global site footer
...
Additional site footer
Go via Site Builder > Use the settings cog on each site to edit > Scroll down:
...
its settings from the main configuration in Refined.
...
Add and set up the categories and links for each site in the production environment.
Connect users to categories in the production environment, if you have done this in the test/staging environment.
...
Site home and category home layouts
Go to your test or staging sites and export all layouts. Import the layouts in your production environment. How to export/import layouts.
Footer
Manually recreate the footer in the production environment.