Start Free
Latest | Server upgrade and maintenance | Maintenance | Migrating database

Migrating your SonarQube Server database to another vendor

On this page

Customers can download the SonarQube DB Copy Tool.

We provide SonarQube DB Copy Tool to help you migrate your SonarQube Server database from one database vendor to another. For example, if you've been using your SonarQube Server instance with Oracle and want to migrate to PostgreSQL, the SonarQube DB Copy Tool will help. DB Copy is preferred for database migration because it does SonarQube-specific checks, ensures data consistency, and outputs meaningful logs.

On this page, source refers to your current database and target refers to the database you are moving to.

1. DB Copy - preparation phase

DB Copy only copies data, not the schema. This is why the purpose of this step is to populate target with an empty SonarQube schema. For this, you have to install a temporary SonarQube Server instance.

  1. Make sure you can connect to your target database.
  2. Download a SonarQube Server that matches the version and edition of your source instance.
  3. Unzip SonarQube Server and put it in a relevant place on the machine.
  4. Configure SonarQube Server to connect to your target database (ie. provide JDBC parameters in the <sonarqubeHome>/conf/sonar.properties file).
  5. Start SonarQube Server using the script matching your operating system:
    • On Linux: <sonarqubeHome>/bin/linux-x86-64/sonar.sh start
    • On macOS: <sonarqubeHome>/bin/macosx-universal-64/sonar.sh start
    • On Windows: <sonarqubeHome>\bin\windows-x86-64\StartSonar.bat
  6. Verify that the SonarQube schema was correctly created. To do this, look at the logs/web.log file to see the line "Executed DB migrations: success". Once this is done, it means that your target database had been populated with the SonarQube schema.
  7. Stop SonarQube Server:
    • On Linux: <sonarqubeHome>/bin/linux-x86-64/sonar.sh stop
    • On macOS: <sonarqubeHome>/bin/macosx-universal-64/sonar.sh stop
    • On Windows: terminate the StartSonar.bat script
  8. You can now delete this temporary SonarQube Server instance.

2. DB Copy - execution phase

Because this step is about copying data from source to target, the overall performance makes a difference. Make sure you execute this on a powerful machine that has fast network access to both database servers.

  1. Unzip the DB Copy package provided by SonarSource Support on the machine where it will be executed. Java is required.
  2. Stop the SonarQube Server instance connected to your source database. This is to ensure that we don't have records being inserted/updated while copying.
  3. Execute the base command with the correct parameters. See below how to do it.
  4. If you see something else other than the success message **THE COPY HAS FINISHED SUCCESSFULLY** please open a SonarSource Support ticket and provide the complete DB Copy logs for investigation (logs are just the standard output of the tool).

Base command and parameters

Migrating with an Oracle database

If you wish to migrate with an Oracle database, you need to include the Oracle driver in the classpath so it is available to the sonar-db-copy tool. In this case, the syntax is:

java -cp ojdbc11-21.8.0.0.jar:sonar-db-copy-1.6.0.2092.jar com.sonar.dbcopy.StartApp

Migrating with all other databases

If you are not migrating from or to an Oracle database, then the syntax is:

java -jar sonar-db-copy-1.6.0.2092-jar-with-dependencies.jar
ParameterDescriptionRequired
-helpPrint this help informationno
-urlSrc JDBC_URLJDBC URL of the source databaseyes
-userSrc USERNAMEUsername of the source databaseyes
-pwdSrc PASSWORDPassword of the source databaseyes
-urlDest JDBC_URLJDBC URL of the target databaseyes
-userDest USERNAMEUsername of the target databaseyes
-pwdDest PASSWORDPassword of the target databaseyes

Here is an example of a copy from an Oracle to a Postgres database. Note that each parameter is on one line and there are \ (backslash) characters to continue the command. While this works on most shell command-line interpreters, it is not necessarily the case. Use only one line and remove backslashes in that case.

java \
-cp ojdbc11-21.8.0.0.jar:sonar-db-copy-1.6.0.2092.jar com.sonar.dbcopy.StartApp \
-urlSrc jdbc:oracle:thin:@10.18.51.1:1521/XEPDB1 \
-userSrc sonar \
-pwdSrc 05xlAz1EhgQb9Pl8 \
-urlDest jdbc:postgresql://10.10.1.138/sonarqube \
-userDest sonar \
-pwdDest Ck23L1OpqF4BdwJv

Was this page helpful?

© 2008-2024 SonarSource SA. All rights reserved. SONAR, SONARSOURCE, SONARQUBE, and CLEAN AS YOU CODE are trademarks of SonarSource SA.

Creative Commons License