Skip to content

server_config.md

Latest commit

 

History

History
154 lines (120 loc) · 5.51 KB

server_config.md

File metadata and controls

154 lines (120 loc) · 5.51 KB

CodeChecker server configuration

The server's configuration is stored in the server's workspace folder, in server_config.json. This file is created, at the first start of the server, using the package's installed config/server_config.json as a template.

NOTICE! session_config.json file has been deprecated.

Table of Contents

Number of API worker processes

The worker_processes section of the config file controls how many processes will be started on the server to process API requests.

Default value:

The server needs to be restarted if the value is changed in the config file.

Number of task worker processes

The background_worker_processes section of the config file controls how many processes will be started on the server to process background jobs.

Default value: Fallback to same amount as worker_processes.

The server needs to be restarted if the value is changed in the config file.

Run limitation

The max_run_count section of the config file controls how many runs can be stored on the server for a product.

If this field is not present in the config file or the value of this field is a negative value, run storage becomes unlimited.

This option can be changed and reloaded without server restart by using the --reload option of CodeChecker server command.

Storage

The store section of the config file controls storage specific options for the server and command line.

All sub-values of this option can be changed and reloaded without server restart by using the --reload option of CodeChecker server command.

Directory of analysis statistics

The analysis_statistics_dir option specifies a directory where analysis statistics should be stored. If this option is specified in the config file the client will send analysis related information to the server and the server will store these information in this directory. If this directory is not specified the server will not store any analysis statistic information.

Limits

The limit section controls limitation of analysis statistics.

Maximum size of failure zips

The failure_zip_size section of the limit controls the maximum size of uploadable failure zips in bytes.

Default value: 52428800 bytes = 50 MB

Size of the compilation database

The compilation_database_size section of the limit controls the maximum size of uploadable compilation database file in bytes.

Default value: 104857600 bytes = 100 MB

Keepalive

Linux has built-in support for keepalive. When using a CodeChecker server with Docker Swarm it is recommended to use the following settings:

{
  "keepalive": {
    "enabled": true,
    "idle": 600,
    "interval": 30,
    "max_probe": 10
  }
}

Otherwise you may get a [Errno 104] Connection reset by peer exception on the server side and the client may hang forever.

For more detailed information about these configuration option see: https://tldp.org/HOWTO/TCP-Keepalive-HOWTO/usingkeepalive.html

For more information about this problem can be found here: moby/moby#31208 (comment)

Idle time

The interval between the last data packet sent (simple ACKs are not considered data) and the first keepalive probe.

By default the server will use the value from your host configured by the net.ipv4.tcp_keepalive_time parameter. This value can be overriden by the idle key in the server configuration file.

Interval time

The interval between subsequential keepalive probes, regardless of what the connection has exchanged in the meantime.

By default the server will use the value from your host configured by the net.ipv4.tcp_keepalive_intvl parameter. This value can be overriden by the interval key in the server configuration file.

Probes

The number of unacknowledged probes to send before considering the connection dead and notifying the application layer.

By default the server will use the value from your host configured by the net.ipv4.tcp_keepalive_probes parameter. This value can be overriden by the max_probe key in the server configuration file.

Authentication

For authentication configuration options and which options can be reloaded see the Authentication documentation.

Secrets

server_secrets.json

Optionally, one can store sensitive data (e.g., passwords, secret tokens) outside of server_config.json. To do this, create a separate server_secrets.json file in the server's workspace folder. In server_config.json, replace sensitive data with $SECRET:NAME_OF_SECRET$. Then, secrets can be defined in server_secrets.json, as an example:

{
  "NAME_OF_SECRET": "MySecurePassword123"
}

Alternatively, one can also define entire sections as a secret, for instance:

{
  "NAME_OF_SECRET": {
    "enabled" : true,
    "client_id" : "<ExampleClientID>",
    "client_secret": "<ExampleClientSecret>"
  }
}

Environmental variables

Alternatively, CodeChecker can also read sensitive data from environmental variables. To do this, replace sensitive data in server_config.json with $ENV:VARIABLE_NAME$. In this case, value will be read from environmental variable VARIABLE_NAME.