The import process involves running your existing Klocwork installation (and projects_root) and your new Klocwork installation (with clean projects_root) concurrently. Once you've installed the new server, you must import any projects from the existing projects_root into the clean projects_root.

Remember that you cannot run two Klocwork servers on the same machine without specifying unique port numbers. If you plan on installing the new Klocwork installation on the same machine, it's a good idea to stop and restart your existing server using a different port number. This will allow you to maintain the existing port number for your new installation.

If you are moving to a new major release of the software, ensure that you have a compatible license, as each major release requires a new Klocwork license. See Licensing for more information.

Also, FlexNet Publisher prevents more than one instance of the vendor daemon from running on each machine, which means that you cannot run two License Servers on one host. In this scenario, you need to run one License Server and point both Klocwork installations to that License Server. See Licensing with multiple projects_root directories for more information.

Both the Klocwork and Database servers require fully qualified domain names or IP addresses assigned in order to be accessible from the target server host during the import process. Don't use localhost.

Supported upgrade paths to versions of Klocwork that support project import

Find your current version in the chart below and follow the appropriate upgrade path. Once you've upgraded to the correct version of Klocwork, you can import your existing projects from there. The chart below is accurate for the latest current release.

Interoperability between releases

To take advantage of the latest improvements in Klocwork, we always recommend you upgrade your Server, Build, and Desktop Analysis plug-ins to the latest version of the product. Klocwork Server, Build and Desktop Analysis plug-ins are compatible within each major release, so you can use 2018 plug-ins with a version 2018.1 Klocwork Server. You can also use older build server tools with newer versions of the Klocwork Server, up to three minor releases back. For more information, see Cross-version support for builds.

If your current Klocwork server version does not meet the version requirements for importing projects, upgrade your existing version of Klocwork to a supported service release or version. Next, install the latest version of Klocwork. After you've installed the latest version of Klocwork, you can use it to connect to your existing Klocwork server and import your projects. Follow the steps described below to import your projects.

Install the Klocwork 2018.1 Server package. For instructions, see Installing Klocwork.

Be sure to copy your license file to <projects_root>/licenses.

Once you've installed the new version of Klocwork, start the servers. Each installation of Klocwork requires you to specify a unique hostname and port number combination.

You can specify the unique hostname and port number combination either at startup, or during the installation process. See, Managing the Klocwork Servers for more information.

dbvalidate is a tool that checks the consistency of data in your database. Running this tool is mandatory, so that any errors in your database can be corrected before you migrate or import. Use the version of the dbvalidate tool that matches your installed version of software.

java -jar <2018.1_server_install>/class/dbvalidate.jar --projects-root <projects_root>

where

• <2018.1_server_install> is your installation directory
• <projects_root> specifies the location of the old projects root you want to validate

Example

java -jar /local/tools/klocwork/server/class/dbvalidate.jar --projects-root /local/tools/klocwork/server/projects_root 

The dbvalidate tool will report any errors between the "validation started" and "validation finished" lines:

Wed Jun 01 07:53:58 CDT 2018 kw_central database (version: 95) validation started
<detected errors appear here>
Wed Jun 01 07:54:28 CDT 2018 Database validation finished.

• If Errors are displayed, please open a support ticket so that we can correct the error prior to import or migration.
• If no errors are displayed, your database was successfully validated.

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

You can import your existing code reviews into your new projects root.

To import your existing Klocwork Inspect code reviews:

1. In the Klocwork Product Portal, click Code Review.
2. Click Settings, then in the left pane, click Import.
3. Click Import code reviews, then specify the URL of the source Klocwork server, the user ID of the Klocwork administrator for the source projects root, and the password (if required).
4. Select the projects that you want to import, then click Import .

To import your existing Klocwork Code Review or Cahoots code reviews:

1. In the Klocwork Product Portal, click Code Review.
2. Click Settings, then in the left pane, click Import.
3. Click Import code reviews, then specify the URL of the source Klocwork Code Review server, the user ID of the Klocwork administrator for the source projects root, and the password (if required).
4. Select the local project into which you want to import the code reviews.
5. In the left pane, select the tags that you want to import.
6. Click Assign to assign the tags to the selected project.
7. Click Import to import the code reviews.

Ensure that you can see your projects and builds in Klocwork Static Code Analysis.

If you installed a new license file, ensure that it was installed correctly by checking that the number of licenses is correct.

Once you're satisfied that your new installation is valid, and that your existing projects were imported correctly, it's time to go live with your new installation.

If you've chosen a new and unique port number for your new installation, then you can go ahead and communicate that information to your users.

If you'd like to reuse your existing port number (so that users don't have to update their local settings) then you'll need to stop and restart all of your Klocwork servers, taking care to specify the existing server port number for your new installation.

Ensure that all Klocwork plug-ins are upgraded to Klocwork 2018.1.

New releases of Klocwork normally have changes to the checker configuration to keep up with current events and respond to customer requests. These changes may mean that your checker configuration from the previous release isn't the same in the new release.

Make sure that you have the right checkers enabled to match your old configuration. See What's New for a list of updated checkers, then make any changes to your checker configuration. After you're satisfied with your configuration, perform your first Klocwork 2018.1 integration build analysis on unmodified source code.

We recommend running your final pre-upgrade integration build analysis and your first Klocwork 2018.1 analysis on identical source code, and then comparing the two builds. This allows you to assess changes in the analysis engine. For details on improved, added, and removed checkers in this version, see What's New.