| 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 Jira server to another, some parts need to be manually synced between the two environments, and some can be exported and imported.
Not everything can be exported, downloaded, uploaded and imported, because of how Jira is technically Because of the way that Jira is built and how databases index its content. For the manual steps we advise to use , 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 as the master with the test/staging environment and one as with the copyproduction environment.
Guide
...
Refined Administration settings
...
For each tab in the Refined Administration that does not concern the Site Builder and Themes.
...
For each tab, manually copy the settings from your test or staging environment to your production environment.
...
Themes
Next, go Go to your test or staging environment and download any theme that is active. To do this, go to Refined Administration > Themes & Styles > hover any active theme > choose Export from the settings cog.
...
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.
Import the theme export all active themes. Import the themes in your production environment by going to the same tab > scroll down > click the Import button.
...
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.
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.
Site building
When your sites are added, add your items to each site whether this is a JSD portal, a Jira project 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.
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
If you have made changes to the footer, this too can be exported and imported as a layout.
...
The global site gets its settings from the main configuration in Refined.
Add and set up the categories and links for each site in the production environment.
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.