summaryrefslogtreecommitdiffstats
path: root/man/bcfg2.conf.5
blob: 385cd9595213b2797a5ddcdb00b436b43de1d2ce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
.TH bcfg2.conf 5

.SH NAME
bcfg2.conf - configuration parameters for bcfg2

.SH DESCRIPTION
.TP
bcfg2.conf includes configuration parameters for the bcfg2 server and client.

.SH FILE FORMAT
The file is INI-style and consists of sections and options. A section
begins with the name of the sections in square brackets and continues
until the next section begins.

Options are specified in the form 'name = value'.

The file is line-based each newline-terminated line represents either a
comment, a section name or an option.

Any line beginning with a hash (#) is ignored, as are lines containing
only whitespace.


.SH SERVER OPTIONS
These options are only necessary on the Bcfg2 server. They are specified
in the [server] section of the configuration file.

.TP
.B repository
Specifies the path to the Bcfg2 repository containing all of the
configuration specifications. The repository should be created using the
bcfg2-init command.

.TP
.B plugins
A comma-delimited list of enabled server plugins. Currently available
plugins are Actions, Base, Bundler, Cfg, DBStats, Deps, Git, Hostbase,
Packages, Pkgmgr, Rules, SGenshi, Snapshots, SSHbase, Svn, TCheetah, and
TGenshi.

.TP
.B bundles
A list of enabled bundles

.TP
.B filemonitor
The file monitor used to watch for changes in the repository.
Values of 'gamin', 'fam', or 'pseudo' are valid.


.SH CLIENT OPTIONS
These options only affect client functionality, specified in the
[client] section.

.TP
.B drivers
Specify tool driver set to use. This option can be used to explicitly
specify the client tool drivers you want to use when the client is run.


.SH STATISTICS OPTIONS
Server-only, specified in the [statistics] section. These options
control the statistics collection functionality of the server.

.TP
.B database_engine
The database engine used by the statistics module. One of
either 'postgresql', 'mysql', 'sqlite3', or 'ado_mssql'.

.TP
.B database_name
The name of the database to use for statistics data. If 'database_engine'
is set to 'sqlite3' this is a file path to sqlite file and defaults to
$REPOSITORY_DIR/etc/brpt.sqlite

.TP
.B database_user
User for database connections. Not used for sqlite3.

.TP
.B database_password
Password for database connections. Not used for sqlite3.

.TP
.B database_host
Host for database connections. Not used for sqlite3.

.TP
.B database_port
Port for database connections. Not used for sqlite3.


.SH COMMUNICATION OPTIONS
Specified in the [communication] section. These options define settings
used for client-server communication.

.TP
.B password
Required on both the server and clients. On the server, sets the
password clients need to use to communicate. On a client, sets the
password to use to connect to the server.

.TP
.B key
A server-only option. The file system path to the server's SSL key.
Required if using xmlrpc/ssl for communication.

.TP
.B protocol
Communication protocol to use. Defaults to xmlrpc/ssl.

.TP
.B retries
A client-only option. Number of times to retry network communication.

.TP
.B agent-port
The TCP port on which to bind for agent mode.

.TP
.B user
A client-only option. The UUID of the client.

.TP
.B fingerprint
A client-only option. The fingerprint of the server's SSL certificate.
Obtainable by running 'bcfg2-admin fingerprint'.


.SH COMPONENT OPTIONS
Specified in the [components] section.

.TP
.B bcfg2
URL of the server. On the server this specifies which interface and
port the server listens on. On the client, this specifies where the
client will attempt to contact the server. eg:
bcfg2 = https://10.3.1.6:6789

.TP
.B encoding
Text encoding of configuration files. Defaults to the system default
encoding.


.SH LOGGING OPTIONS
Specified in the [logging] section. These options control the server
logging functionality.

.B path
Server log file path.


.SH SNAPSHOTS OPTIONS
Specified in the [snapshots] section. These options control the server
snapshots functionality.

.B driver
sqlite

.B database
The name of the database to use for statistics data. eg:
$REPOSITORY_DIR/etc/bcfg2.sqlite

.SH SEE ALSO
.BR bcfg2(1),
.BR bcfg2-server(8)