1. Support Center
  2. Documentation
  3. Enterprise Edition
  4. Getting started
  5. Database migration

Migrating to an external database

During initial installation of Burp Suite Enterprise Edition, you can choose whether to use the bundled database or an external database.

If you choose to use the bundled database, then you can later migrate to an external database using the database migration tool.

The migration process involves the following phases:

Preparing for migration

Set up your new external database. Keep a note of the credentials that you create for the external database.

Stop all scans.

On agent machines, stop the burpsuiteenterpriseedition_agent services.

Perform a backup of the bundled database. This can be done in the web interface in the database backup settings.

On the Enterprise server machine, stop the burpsuiteenterpriseedition_enterpriseserver and burpsuiteenterpriseedition_webserver services.

Create a copy of the enterprise-server.config file, in case it is necessary to revert to using the original database.

Migrating your data

On the Enterprise server machine, open a command prompt.

From the installation directory, run database_transfer as either the burpsuite user or root.

Provide the JDBC URL and credentials for the new external database.

Data will be transferred table by table and progress is reported in the console.

Once the migration has completed, a summary of the rows transferred per table is reported and the enterprise-server.config file will have been updated with the new database connection details.

Restarting services

On the Enterprise server machine, restart the burpsuiteenterpriseedition_enterpriseserver and burpsuiteenterpriseedition_webserver services.

On agent machines, restart the burpsuiteenterpriseedition_agent services.