Projects_root directory

The projects_root directory stores data for the Klocwork servers and applications, including the following:

With the exception of the Klocwork license file and external documents in the custom_reports subdirectory, the projects_root and its subdirectories should contain only files created automatically by Klocwork. Manually adding other files can cause errors.
  • Information about integration projects and build analysis runs
  • Klocwork license file
  • Klocwork server settings
  • Project database tables stored in MariaDB and Lucene databases

Klocwork Servers use the projects_root directory as their access point for project data, as well as server configuration and logging information. The directory data is split between Lucene and MariaDB database storage:

  • Lucene: Defect data from Klocwork analysis
  • MariaDB: Build information such as metrics, entities, and relationships

The License Server uses only the projects_root/licenses directory, and the Database Server uses only the projects_root/data directory. No other Klocwork servers require access to these two directories.

Projects_root directory location

You choose the projects_root directory location during installation:

  • Choose a location that will continue to have adequate space.
  • To avoid issues with file locking, do not locate the projects_root directory on NFS.
  • The default location is <server_install>/projects_root.
  • The location must be accessible to all Klocwork server hosts.

The maximum length of the path to the projects_root directory is 68-72 characters, depending on the length of the Database Server port number (1-5 digits).