Versions Compared

Key

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


Info

Before generating a dump file, upgrade the 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 you proceed, please read. the following instruction 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 BigPicture backup and download it

  1. Go to BigPicture App Configuration > Advanced > Database dumps
    Image Modified
  2. Press the New dump button, add a description and confirm (Create dump button)
    Image Modified
    Image Modified
  3. The new database dump should appear at the top of the list of backups (page refresh may be needed).
  4. Press the Download button to save the backup file to disk.

Step 2 - create a Jira backup and download it

Cloud

Go to System > Backup Manager > Create backup for cloud 
Image Modified

Server

Go to System > Backup system > Backup 
Image Modified

Step 3 - restore Jira backup on a staging environment

Cloud

Go to System > Restore System > Import data (import the Jira backup file)
Image Modified

Server

Go to System > Restore system > restore using the Jira backup file (Restore)
Image Modified

Step 4 - install BigPicture on a staging environment

Cloud

Go to Jira Apps > Find New Apps and search for the BigPicture plugin.

Server

Go to System > Manage apps and install BigPicture.

Step 5 - restore BigPicture backup on a staging environment

  1. Go to BigPicture App Configuration > Advanced > Database dumps
  2. Upload the app database dump (Import button)
    Image Modified

    Image Modified
  3. Press the Restore button in the line with the backup name 
    Image Modified
  4. Confirm the next step by selecting Migrating between instances, e.g., production to staging, and press the Next button
    Image Modified
  5. Check the confirmation box and press the Next button
    Image Modified
  6. Confirm the operation by entering the word RESTORE and press the Restore button

    Info

    If the BigPicture instance is not new and some work has already been done on it, this work will be overwritten! BigPicture will automatically dump its current state before performing the restore operation (so that the process can be reversed).

    Image Modified

  7. The database recovery process will start
    Image Modified

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


Additional information 

Instance status after restore

Any integration instances after restore operation will be in a “not operational” state.
This mechanism is to prevent a situation where two applications make changes in the same integration instance at the same time.

To activate selected integrations, move the switch in the Active column in the App Configuration > Integrations > Connections panel:

Image Modified

Data center vs server

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

Image Modified

Application version mismatch 

Info

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



App versions Fix 
Case 1

dump created in a higher App version then restore

Example:

  • '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 BigPicture that you are trying to run a 'restore' on to be the same on which the 'dump' file was created. 


Case 2

dump created in a lower App version than restore

Example:

  • '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.



Table of contents

Table of Contents