]> source.dussan.org Git - sonarqube.git/commitdiff
SONAR-15571 Update the Project Move page to add export starting with Community Edition
authormichaelbirnstiehl <michael.birnstiehl@sonarsource.com>
Wed, 27 Oct 2021 16:43:31 +0000 (11:43 -0500)
committersonartech <sonartech@sonarsource.com>
Thu, 4 Nov 2021 20:03:24 +0000 (20:03 +0000)
server/sonar-docs/src/pages/instance-administration/project-move.md

index d968c95c38e0b9bbe9736c5199a6fc0007a2b871..5295f27c75377a6dc0a8b047b46d789796c5c1cf 100644 (file)
@@ -3,34 +3,46 @@ title: Project Move
 url: /instance-administration/project-move/
 ---
 
-_Project Move is available as part of [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html) and [above](https://www.sonarsource.com/plans-and-pricing/)._
+Project Move allows you to export a project from one SonarQube instance and import it into another SonarQube instance. To use Project Move, you must have the Administer permission on the project in the source instance, and access to the file systems of both instances.
 
-Project Move allows you to export a project from one SonarQube instance and import it into another, identically configured SonarQube instance. To use Project Move, you must have the Administer permission on the project in the source instance, and access to the file systems of both instances.
+## When to use Project Move
+Project Move can help you with the following situations:
 
-## When to Use "Project Move"
-In the following cases:
-
-* you want to create a central SonarQube instance at enterprise level and you want to keep the history created on N instances used previously at the team level
-* your company is acquiring another company that already has a central SonarQube instance
-* an application is transferred from one team to another in a large company and that company has several SonarQube instances
+* You want to create a central SonarQube instance at enterprise level and you want to keep the history created on instances used previously at the team level.
+* You want to consolidate your editions and move projects from a Community Edition instance to an [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html) instance or [above](https://www.sonarsource.com/plans-and-pricing/).
+* Your company is acquiring another company that already has a central SonarQube instance.
+* You are at a large company with several SonarQube instances and an application is transferred from one team to another.
 
 ## Prerequisites
-In order to be able to export and then load your Project's data, the two SonarQube instances must have:
+To export your project's data from the source instance and then load it on the target instance, make sure the following are true.
+
+The _target_ instance must:
+
+* Be [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html) or [above](https://www.sonarsource.com/plans-and-pricing/).
+* Contain all of the plugins with the same versions as the source instance.  
+
+[[info]]
+|The target instance can have additional plugins and languages that aren't in the source instance, but not the other way around. If your source instance has plugins that aren't in your target instance, either remove them and reanalyze your project or add them to your target instance.
 
-* the exact same version
-* the same plugins with the same versions
-* the same custom metrics
-* the same custom rules
+Both instances must have:
+
+* The exact same SonarQube version
+* The same custom metrics
+* The same custom rules
+
+## How to export
+_Your source instance can be Community Edition or above, but cannot have plugins or languages that are not in the target instance._
 
-## How To Export
 On the source instance:
 * reanalyze the project one last time to make sure it is populated with data corresponding to your current SonarQube installation
 * navigate to the project and at the project level, choose **Project Settings > Import / Export**
 * click on the **Export** button to generate a zip file containing the settings and history of your Project (but not the source code). Note that if you need to change the Project's key, you must to do it before performing the export.
 
-A zip file containing all project data ex is generated in _$SONAR_SOURCE_HOME/data/governance/project_dumps/export/_ named _<project_key>.zip_
+A zip file containing all project data is generated in _$SONAR_SOURCE_HOME/data/governance/project_dumps/export/_ named _<project_key>.zip_
+
+## How to import
+_Your target instance must be [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html) or [above](https://www.sonarsource.com/plans-and-pricing/)._
 
-## How To Import
 On the target instance:
 
 * With a user having the "Administer System" and "Create Projects" permissions, go to [**Administration > Projects > Management**](/#sonarqube-admin#/admin/projects_management/) and [provision the project](/project-administration/project-existence/) using the same key the project had in the source instance.
@@ -43,5 +55,5 @@ On the target instance:
 Notes:
 
 * If the import is successful, the zip file will automatically be deleted.
-* It is not possible to import a Project that has been already analyzed on the target instance.
-* Security reports in an imported project will be empty until analysis has run.
+* It is not possible to import a project that has been already analyzed on the target instance.
+* Security reports in an imported project will be empty until an analysis has run.