Integration project and build properties reference

This section describes how the integration project and build properties are used to configure and control analysis behavior.

Project properties displayed by kwadmin

The following table shows the project properties displayed by kwadmin get-project-properties.

Editable properties can be set using kwadmin set-project-property.

Property Description Editable Allowed values Example
auto_delete_threshold Specifies the number of builds to save when the auto delete feature is enabled. yes Numerical value; pass a null value to turn off the retention policy 10
bug_tracker_schema Used to replace {0} with id, and convert id to a hyperlink. N/A URL pattern that passes the information to the bug tracker URL https://bugs.example.com/project/id={0}
ci_quality_gate Specifies a Quality Gate in the Validate CI Builds for a project based on existing search properties for issues. This can take the form of a free-text search box as per the Issues list page. yes Lucene search queries supported at Issues list page taxonomy:'MISRA C 2023 (C99)' reference:mand status:+Analyze,Fix
copy_tables Specifies whether tables will be copied to projects_root by kwadmin load. yes true or false true
creator User ID under which the project was created no N/A joebloggs
database.host Database Server host name no N/A myserver.acme.com
database.port Database Server port no N/A 3306
database.started_by User ID that started the Database Server no N/A adminuser
database.type Database type no Name of database type mysql
database.user User who started the Database Server no N/S kw
description Project description yes (editable in Validate) N/A This project contains toolbus source code.
disable_stream_ci_defects

Specifies whether CI builds will load stream defects to the server.

 yes true or false true
enable_exact_file_match Disable auto-matching to give you more control over your project. Use in conjunction with an EMP file that can be loaded (and edited) onto a project. yes true or false true
enable_group_calculations

Changes the way the system displays server issues. By default, desktop and server issues are shown with grouping off.

If you want a project to persistently show issues with grouping on, set to true.

This option enables grouping calculations during the build/load stage and is required in order for 'grouping_on_default' and 'grouping:on' to work correctly. If you disable 'enable_group_calculations', the build will not calculate groups, kwadmin load will not load groups, and 'grouping:on' will not work (empty results).

 yes true or false false
grouping_on_default

Changes the way the system displays server issues. By default, desktop issues are shown with grouping off and server issues are shown with grouping on.

If you want a project to persistently show server issues with grouping off, set to false.

This option causes searches which don't include 'grouping:off' to return empty. You must pair it with 'enable_group_calculations=true'(and a build loaded after that) to return useful results.

 yes true or false true
incompatible_server_versions Server versions that are incompatible with the current projects_root directory. no N/A 6.1,7.0
klocwork.host or web.host Klocwork Server host name no N/A myserver.acme.com
klocwork.port or web.port Klocwork Server port number no N/A 8080
klocwork.started_by or web.started_by User ID that started the Klocwork server no N/A adminuser
language Programming language of the source files in the project yes Comma-separated list; acceptable values are c, cxx, java, csharp c,cxx
license.host License Server host name no N/A myserver.acme.com
license.port License Server port no N/A 27000
locale Overrides the locale for the project that was set during project creation. Should be set before running an integration build analysis with Kwbuildproject so that the language of issue messages and traceback will be consistent in all builds yes en, ja ja
project_creation_time_stamp Project creation timestamp; localized by Validate no N/A 1136234753965
project_creation_version For internal use no N/A 21.0
project_version For internal use no   21.0
projects_root_creation_version For internal use no N/A 21.0
same_kind_defect_per_file_threshold

When configured, this setting prevents an integration or CI build from being loaded into the project if any file contains defects of the same type (for example, ABV.*) that exceed the specified threshold. This is particularly useful for large projects with slow builds.

If not configured, the default threshold is 0, meaning the limit on the number of same defects is infinite.

If you have a build that fails due to exceeding the configured defect threshold, consider the following actions:
  • Use a SCONF file to suppress the noisy defects for specific files
  • Disable noisy checkers in your project
  • Change your configured threshold limit to allow these builds to pass
  • Ignore the configured defect threshold check with the ignore-defect-threshold mechanism for kwadmin load/validate admin load or kwciagent load (for CI builds)

To learn more about the same_kind_defect_per_file_threshold property, see Propagation issue: Too many same defects in a file.

 yes Numerical value; pass 0 to turn off the threshold limit 5000 (recommended)
source.tables Location of prebuilt tables used for the project. no N/A C:\<install-path>\projects_root\projects\MyProject\builds\build_4\tables
source_encoding Language encoding of project source files. See kwadmin create-project. yes Language encodings; use the kwconv --list option to list acceptable values utf-8