Import your projects and server settings

With the new Klocwork server installed and the portal up and running, you can import server settings and projects from your existing Klocwork installation.

When you import server settings from the existing source server, all global permission settings are imported along with the permission settings for only those projects that exist on the destination server. In other words, if you import Server A's settings to Server B, then you import a project from Server A to Server B, any permission settings that are specific to project A will not be carried over to Server B. To carry forward project A's project-specific permission settings, you must re-import the server settings after performing the import operation.

Note also that when importing a projects_root that contains a large number of issues and builds, your new projects_root may increase in size.

To import your existing projects:

1. In the Klocwork portal, click Klocwork Static Code Analysis and log in to the product as the Projects root admin user.
2. Click the Projects tab.

   If this is your first time using the installation, click the Import settings or projects button.

   If you've already created a project or imported a project, click the Import button.

3. In the Klocwork server connection dialog, specify the log in and connection information for your existing Klocwork installation (the installation from which you want to import). Specify:
   • the URL of the existing server, for example: http://server21:8082
   • your user name. Note: you must have Projects root admin rights in order connect to the server and import your projects.
   • your password (if required)
4. Click Import server configuration to import the existing server's configuration settings. This includes authentication configuration settings, permissions, custom metrics, reports definitions, and e-mail subscription settings.

   Note: If you import authentication settings, the system may log you out as your credentials may no longer be valid. If this happens, log in using the Admin credentials you just imported.

5. Click List Projects to see a list of projects in your existing projects_root.
6. In the Choose projects to import dialog, select the project(s) that you want to import to your new projects_root.
7. Click Import. The Import status dialog will display the status of the project import, while an import status message will appear at the top of the Projects tab.
   Any project that imported successfully will appear in your projects list.

   Note: During the import process, while projects are actively being imported, issue information in the Projects view may not accurately reflect the data in the source project. Information in the Projects view will be updated as soon as the import operation has completed. Check the import status indicator for progress information.
8. Click Import server configuration again to import any project-specific configuration settings. This is a mandatory step, since any project-specific configuration settings will be lost if you do not re-import the server settings.
9. For each imported project, click Permissions and check that the permissions are correct for each project.

It is important to verify the permissions for each project since at import time, permissions are merged between source server and destination server. You should repeat this process after each import operation, and you must be careful to re-import the server settings for each source server that you import from.

curl --data "action=import_project&user=myself&project=my_project&sourceURL=
http://oldserver:8080&sourceAdmin=user&sourcePassword=pwd" http://localhost.mycompany.com:8080/review/api

curl --data "action=projects&user=myself&" http://localhost.mycompany.com:8080/review/api

curl --data "action=import_server_configuration&user=myself&sourceURL=
http://oldserver:8080&sourceAdmin=user&sourcePassword=pwd" http://localhost.mycompany.com:8080/review/api