Import your existing projects into a new projects root

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 Reprise License Manager 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.

You must have Projects root admin access in order to perform the import operation.

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. Perforce is also here to help! If you need to move from an older release, you can contact Static Code Analysis Professional Services to discuss assistance via a services engagement.

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 and Build Tools are compatible with the Desktop Analysis plug-ins within each major release.

Klocwork also provides the ability to load builds from the previous major version of Klocwork into the current version of Klocwork. For example, this means you can load Klocwork builds from any version of Klocwork 2022 into Klocwork 2023.4 without having to import or migrate data. 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 Server package. For instructions, see Installing Klocwork.

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

See Licensing for information about options.

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 (that is, the version that matches your projects_root directory).

The Database Server from your old installation must be running to validate the database. The Database Server is listed as a separate service from the Klocwork Server, so ensure that it is running.

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

where

• <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 2020 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.

You can also run dbvalidate with the --rebuildIndex=true option; This enables you to re-create the lucene index for the specified project, which often allows you to decrease the size of the index.

Important: Make sure you back up your lucene index folder before running dbvalidate with the --rebuildIndex=true option.

For example, you can run the following:

java -cp dbvalidate.jar com.klocwork.dbvalidate.Cleanup231 --projects-root <projects_root_folder> --project <project_name> --rebuildIndex=true

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.

Important: In cases where a project contains custom settings, you must re-import your server settings after performing a project import.

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

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:

Before importing code review data, you must have the equivalent project in your local projects root. Importing code review data will overwrite any existing code review data in the current projects_root folder.

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:

Klocwork Code Review does not organize code reviews by project. When you import existing code reviews from your Code Review server, you must specify the code reviews by tag.

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.

To take advantage of the latest improvements in Klocwork, we always recommend you upgrade your Desktop Analysis plug-ins to the latest version of the product.

Your users can reinstall their Klocwork Desktop Analysis plug-ins themselves by downloading the appropriate plug-ins from the Klocwork portal once it is up and running. See Downloading and deploying the desktop analysis plug-ins for instructions on how to download and deploy the plug-ins to the server.

When upgrading to the Klocwork extension for Visual Studio, any analysis results data generated from the previous version of the plug-in will be removed. Therefore, any local defect citation information not already synchronized with the server will be lost. You can re-analyze your solution(s) to get the analysis results with the new plug-in.

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, re-generate your build specification to capture the latest changes and perform your integration build analysis on unmodified source code.

If you've already run your first Klocwork analysis and you're missing some issues or status changes, delete that build, reconfigure your checkers, and run a new analysis.

We recommend running your final pre-upgrade integration build analysis and your first Klocwork 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.