1hirte-agent.conf(5) File Formats Manual hirte-agent.conf(5)
2
3
4
6 agent.conf - Configuration file to bootstrap hirte-agent
7
8
10 The basic file definition used to bootstrap hirte-agent.
11
12
14 The hirte-agent configuration file is using the systemd configuration
15 file format ⟨https://www.freedesktop.org/software/systemd/man/sys‐
16 temd.syntax.html⟩.
17
18
19 hirte-agent section
20 All fields to bootstrap the hirte-agent are contained in the hirte-
21 agent section. The following keys are understood by hirte-agent.
22
23
24 NodeName (string)
25 The unique name of this agent. The option defaults to the system's
26 hostname.
27
28
29 ManagerAddress (string)
30 SD Bus address used by hirte-agent to connect to hirte. See man
31 sd_bus_set_address for its format. Overrides any setting of Manager‐
32 Host or ManagerPort defined in the configuration file as well as the
33 respective CLI options. The option doesn't have a default value.
34
35
36 ManagerHost (string)
37 The host used by hirte-agent to connect to hirte. Must be a valid IPv4
38 or IPv6. ManagerHost defaults to localhost 127.0.0.1. It's mandatory to
39 set this field if the hirte agent is on a remote system.
40
41
42 ManagerPort (uint16_t)
43 The port on which hirte is listening for connection request and the
44 hirte-agent is connecting to. By default port 842 is used.
45
46
47 HeartbeatInterval (long)
48 The interval between two heartbeat signals sent to hirte in millisec‐
49 onds. This option will overwrite the heartbeat interval defined in the
50 configuration file.
51
52
53 LogLevel (string)
54 The level used for logging. Supported values are:
55
56
57 • DEBUG
58
59 • INFO
60
61 • WARN
62
63 • ERROR
64
65
66
67 By default INFO level is used for logging.
68
69
70 LogTarget (string)
71 The target where logs are written to. Supported values are:
72
73
74 • stderr
75
76 • stderr-full
77
78 • journald
79
80
81
82 By default journald is used as the target.
83
84
85 LogIsQuiet (string)
86 If this flag is set to true, no logs are written by hirte. By default
87 the flag is set to false.
88
89
91 Using ManagerHost and ManagerPort options:
92
93
94 [hirte-agent]
95 NodeName=agent-007
96 ManagerHost=127.0.0.1
97 ManagerPort=842
98 LogLevel=DEBUG
99 LogTarget=journald
100 LogIsQuiet=false
101
102
103
104 Using ManagerAddress option:
105
106
107 [hirte-agent]
108 NodeName=agent-007
109 ManagerAddress=tcp:host=127.0.0.1,port=842
110 LogLevel=DEBUG
111 LogTarget=journald
112 LogIsQuiet=false
113
114
115
117 Distributions provide the /usr/share/hirte/config/agent.conf file which
118 defines hirte-agent configuration defaults. Administrators can copy
119 this file to /etc/hirte/agent.conf and specify their own configuration.
120
121
122 Administrators can also use a "drop-in" directory
123 /etc/hirte/agent.conf.d to drop their configuration changes.
124
125
127 hirte-agent(1) ⟨https://github.com/contain‐
128 ers/hirte/blob/main/doc/man/hirte-agent.1.md⟩
129
130
131
132 hirte-agent.conf(5)