Agent
The agent configuration file (dcvix-agent.conf) uses INI format with the following sections.
[agent]
| Field |
Type |
Default |
Description |
director_host |
string |
127.0.0.1 |
Required. Director hostname or IP |
director_port |
string |
8445 |
Director HTTPS port |
agent_port |
int |
8446 |
Agent HTTPS listener port |
bind_address |
string |
0.0.0.0 |
IP address to bind the agent server |
tags |
string |
"" |
Free-form identifier (e.g. "gpu, linux") |
dcv_path |
string |
(auto) |
Override dcv binary path. Linux: /usr/bin/dcv; Windows: C:\Program Files\NICE\DCV\Server\bin\dcv.exe or Amazon variant |
update_interval |
int |
30 |
Seconds between stats reports to director. 0 disables |
reap_interval |
int |
60 |
Seconds between idle session checks. 0 disables |
data_dir |
string |
(platform) |
Persistent state directory. Linux: /var/lib/dcvix-agent; Windows: %ProgramData%\dcvix\Agent |
[log]
| Field |
Type |
Default |
Description |
level |
string |
info |
Log verbosity: debug, info, warning, error, critical |
directory |
string |
(platform) |
Log directory. Linux: /var/log/dcvix-agent; Windows: %ProgramData%\dcvix\Agent\log |
rotation |
int |
2 |
Number of 100 MB log files to keep |
Agent Data Directory
The agent stores four files in data_dir:
| File |
Purpose |
Generated by |
Permissions |
agent.key |
Ed25519 private key |
Agent, first startup |
0600 |
agent.crt |
Signed certificate |
Director, on register/renew |
0644 |
ca.pem |
CA certificate |
Director (returned during registration) or pre-deployed |
0644 |
agent.guid |
UUIDv4 identity |
Agent, first startup |
0644 |
Example Minimal Config
[agent]
director_host = "10.0.0.1"
director_port = 8445
agent_port = 8446
tags = "gpu, linux"