bluechi.conf(5)

1bluechi.conf(5)               File Formats Manual              bluechi.conf(5)
2
3
4

NAME

6       bluechi.conf - Configuration file to bootstrap bluechi
7
8

DESCRIPTION

10       The basic file definition used to bootstrap bluechi.
11
12

Format

14       The  bluechi configuration file is using the systemd configuration file
15       format   ⟨https://www.freedesktop.org/software/systemd/man/systemd.syn‐
16       tax.html⟩.  Contrary  to this, there is no need for the \ symbol at the
17       end of a line to continue a value on the next line. A  value  continued
18       on  multiple  lines  will  just be concatenated by bluechi. The maximum
19       line length supported is 500 characters. If the value exceeds this lim‐
20       itation, use multiple, indented lines.
21
22
23   bluechi section
24       All  fields  to  bootstrap  the  bluechi  manager  are contained in the
25       bluechi section. The following keys are understood by bluechi.
26
27
28   ManagerPort (uint16_t)
29       The port the manager listens  on  to  establish  connections  with  the
30       bluechi-agent. By default port 842 is used.
31
32
33   AllowedNodeNames (string)
34       A comma separated list of unique bluechi-agent names. It's mandatory to
35       set the option, only nodes with names mentioned in the list can connect
36       to  bluechi  manager. These names are defined in the agent's configura‐
37       tion file under NodeName option (see bluechi-agent.conf(5)).
38
39
40   LogLevel (string)
41       The level used for logging. Supported values are:
42
43
44              • DEBUG
45
46              • INFO
47
48              • WARN
49
50              • ERROR
51
52
53
54       By default INFO level is used for logging.
55
56
57   LogTarget (string)
58       The target where logs are written to. Supported values are:
59
60
61              • stderr
62
63              • stderr-full
64
65              • journald
66
67
68
69       By default journald is used as the target.
70
71
72   LogIsQuiet (string)
73       If this flag is set to true, no logs are written by bluechi. By default
74       the flag is set to false.
75
76

Example

78       A basic example of a configuration file for bluechi:
79
80
81              [bluechi]
82              ManagerPort=842
83              AllowedNodeNames=agent-007,agent-123
84              LogLevel=DEBUG
85              LogTarget=journald
86              LogIsQuiet=false
87
88
89
90       Using a value that is continued on multiple lines:
91
92
93              [bluechi]
94              ManagerPort=842
95              AllowedNodeNames=agent-007,
96                 agent-123,
97                 agent-456,
98                 agent-789
99              LogLevel=DEBUG
100              LogTarget=journald
101              LogIsQuiet=false
102
103
104

FILES

106       Distributions  provide  the /usr/share/bluechi/config/bluechi.conf file
107       which defines bluechi configuration defaults. Administrators  can  copy
108       this file to /etc/bluechi/bluechi.conf and specify their own configura‐
109       tion.
110
111
112       Administrators    can    also     use     a     "drop-in"     directory
113       /etc/bluechi/bluechi.conf.d to drop their configuration changes.
114
115

NAME

DESCRIPTION

Format

Example

FILES

SEE ALSO