Database migration

The eazyBI database migration is available starting from the Private eazyBI version 4.0.0.

eazyBI stores all data in a separate database. You can use the eazyBI database migration to migrate either all eazyBI data from one server to another or you can use it to migrate just couple eazyBI accounts from, for example, a production server to a test server.

You can migrate data from a Private eazyBI database or also from a eazyBI Jira add-on database.

If you would like to migrate existing eazyBI database to a new server then, at first, set up a new eazyBI database and start Private eazyBI using this new database.

If you would like to use Atlassian Connect integration with Jira Server and would like to migrate existing eazyBI Jira add-on data to Private eazyBI then at first configure Atlassian Connect integration with your Jira Server. In the following step you will need to specify the source eazyBI Jira add-on database connection parameters. In the Select data for migration page, you will need to select your Jira server site where you have installed eazyBI Atlassian Connect add-on.

After the initial setup, go to System Administration / Settings and in the top navigation click System Administration and then from System administration tasks select Database migrator.

Source eazyBI database

In the first step specify the database connection parameters to the existing eazyBI database from which you would like to migrate data.

Click Continue and if there will be any problems with the database connection then the errors will be displayed. If the database connection will be successful then the next page will be shown.

Select data for migration

The list of eazyBI accounts will be displayed which are available for import. If some of these accounts are disabled then it means that either they are already imported or there are existing accounts with the same name in the current eazyBI database.

Starting from the version 4.2.3 you can select the option Preserve original IDs. This option is recommended (and selected by default) when migrating an existing eazyBI database to a new empty database as then all existing account, report and dashboard ID values will be the same as in the original database. When you publish eazyBI reports or dashboards using iframes or as gadgets then these IDs are used as a reference.

Select all or some accounts that you would like to migrate and click the Migrate button.

The migration will copy the following data from the source database to the current database:

  • Accounts
  • Account users
  • Source application definitions (without imported data)
  • Source file definitions (without uploaded files)
  • Cube definitions (with no data)
  • Cube report definitions
  • Calculated member formulas
  • Dashboard definitions

After successful import, you will be redirected to the home tab.

Re-import source data

Only source application (like Jira, REST API or SQL) definitions will be migrated but no source data are migrated. After the migration, you need to go to the Source Data tab in each account and start the data import from all source applications. After the data import, you can go to the Analyze tab and open your existing reports.

If you had any uploaded source files then please re-upload them in the Source Data tab and re-import data from all source files.