1hirte-agent.conf(5)           File Formats Manual          hirte-agent.conf(5)
2
3
4

NAME

6       agent.conf - Configuration file to bootstrap hirte-agent
7
8

DESCRIPTION

10       The basic file definition used to bootstrap hirte-agent.
11
12

Format

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

Example

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

FILES

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

SEE ALSO

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)
Impressum