Versions Compared

Version Old Version 4 New Version 5
Changes made by

Piotr Koszela

Magdalena Żaczek

Saved on

Key

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

...

Contents:

Table of Contents

...

minLevel2
maxLevel3
outlinefalse
stylenone
typelist
printabletrue
Note

Before you generate a dump file,   upgrade the app App (to version 8.2.2 or higher).

Info

Follow the steps below if the staging environment is the same as the production environment.

  • Server → Server

  • Data Center → Data Center

  • Cloud → Cloud 

  • Server → Data Center

Steps overview 

Before proceeding, please read the instructions carefully and copy all steps to the clipboard to keep it on hand.

  1. Create application backup (production environment).

  2. Create Jira backup (production environment) .

  3. Restore Jira backup on a staging environment.

  4. Install the application on a staging environment.

  5. Restore application backup on a staging environment.

Step 1 - Create a BigPicture backup and download it

In this part, you need to create a BigPicture backup and download it:

  1. Go to BigPicture/BigGantt App Configuration configuration > Advanced > > Database dumps.

    image2021-12-31_13-39-57.pngImage RemovedScreenshot of the App configuration page.Image Added

  2. Press Click the New dump button, add dump button.

  3. Add a description, and confirm (Create dump button)

    Image RemovedImage Removed

    .

  4. To confirm, click the Create dump button. 

    Screenshot of the new database dump creation.Image Added

  5. You can track the progress:

    Screenshot of the database dump creation process.Image Added

  6. The new database dump should appear at the top of the list of backups (page refresh may be needed).

  7. Press the Download button to save the backup file to the disk (if you don't see the item on the list, refresh the page).

Step 2 - Create a Jira backup and download it

Cloud:

  1. Go to System > Backup Manager

...

  1. > Create backup for

...

  1. cloud.

...

  1. Screenshot of the Backup Manager section in the Jira System settings.Image Added

Server:

  1. Go to System > Backup system

...

  1. > Backup.

    Screenshot of the Backup Jira data section in the Jira System settings.Image Added

Step 3 -

...

Restore Jira backup on a staging environment

Cloud:

  1. Go to System > Restore System

...

  1. > Import data (import the Jira backup file).

...

  1. Screenshot of the Restore System section in the Jira System settings.Image Added

Server:

  1. Go to System > Restore system

...

  1. .

  2. Restore using the Jira backup file

...

  1. .

  2. Click Restore

...

  1. .

...

  1. Screenshot of the Restore system section in the Jira System settings.Image Added

Step 4 -

...

Install BigPicture on a staging environment

Cloud:

  1. Go to Jira Apps > Find

...

  1. new apps.

  2. Search for the BigPicture plugin.

Server:

  1. Go to System > Manage apps

...

  1. .

  2. Install BigPicture.

Step 5 -

...

Restore BigPicture backup on a staging environment

  1. Go to BigPicture App Configuration configuration > Advanced > > Database dumps.

  2. Click Import.

  3. Upload the app database dump (Import button)

    Image RemovedImage Removed

    .

    Screenshot of the App configuration page.Image Added

  4. Press the Restore button in the line with the backup name. 

    Image RemovedScreenshot of the restoring the App database on the App configuration page.Image Added

  5. Confirm the next step by selecting Migrating between instances, e.g., production to staging, and press the Next button.

    Image RemovedScreenshot of Database dump restore info panel.Image Added

  6. Check the confirmation box and press the Next button.

    Image RemovedScreenshot of Dump restore info panel.Image Added

  7. Confirm the operation by entering the word RESTORE and clicking the Restore button.

    (info) Info: If the BigPicture instance is not new and some work has already been done, this work will be overwritten! BigPicture will automatically dump its current state before restoring it (so the process can be reversed).

    Image RemovedScreenshot of confirming the database dump restore.Image Added

  8. The database recovery process will start.

    Image Removed


    After the recovery process, the migration from one instance to another is over. You can then go to the BigPicture application and verify the data's correctness of the data.

    Screenshot of the database recovery process.Image Added

Additional information 

Instance status after restore

Any integration instances after the restore operation will be in a “not operational” ‘not operational’ state.
This mechanism prevents a situation where two applications make changes in the same integration instance simultaneously.

To activate selected integrations, move :

  1. Go to App Configuration > Integrations > Connections.

  2. Move the switch in the Active column

...

  1. .

    Screenshot of Connections panel in the BigPicture Advanced configuration.Image Added

Data center vs server

If the restore process is performed on the DC machine, but the dump file was done on the server machine, a reinstall process of the application will be required:

...

Application version mismatch 

Info

Dump The dump and restore should be done in the same application version of the application(e.g., a backup dump was created in BigPicture 8.2.3 → 3, → restore should be done in BigPicture 8.2.3).


App versions 

Fix 

Case 1

A dump created  is created in a higher App version , then than the restore.

Example:

  • 'Dump' A dump was created in BigPicture 8.2.3.

  •  You are trying to run a ' restore ' in BigPicture 8.2.2.

Upgrade the application - upgrade the

Upgrade BigPicture that you are trying to run a 'the restore ' action on to be the same on which the 'a dump ' file was created. 


Case 2

A dump is created in a lower App version than the restore.

Example:

  • 'Dump' A dump was created in BigPicture 8.2.0.

  •  You are trying to run a ' restore ' in BigPicture 8.2.3.

Not possible.

BigPicture doesn't support rollbacks.

...