← Back to branch summary

~ubuntu-branches/ubuntu/saucy/drizzle/saucy

« back to all changes in this revision

Viewing changes to docs/configuration.rst

  • Committer: Package Import Robot
  • Author(s): Clint Byrum
  • Date: 2012-06-19 10:46:49 UTC
  • mfrom: (1.2.11) (2.1.16 sid)
  • Revision ID: package-import@ubuntu.com-20120619104649-9ij634mxm4x8pp4l
Tags: 1:7.1.36-stable-1ubuntu1
https://launchpad.net/bugs/987575
* Merge from Debian unstable. (LP: #987575)
  Remaining changes:
  - Added upstart script.
* debian/drizzle.upstart: dropped logger since upstart logs job
  output now.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/configuration.rst
1
 
=============
2
 
Configuration
3
 
=============
4
 
 
5
 
--------
6
 
Overview
7
 
--------
8
 
 
9
 
Drizzle can draw its configuration from a number of sources, including the
10
 
command line, from configuration files, and from environment variables.
11
 
 
12
 
Support is planned for pluggable configuration sources.
13
 
 
14
 
----------------
15
 
Loading Sequence
16
 
----------------
17
 
 
18
 
Drizzle first reads the command line options dealing with config file
19
 
location. These options may only be given as command line options.
20
 
Then, the config files are parsed, for all options. After that,
21
 
environment variables are processed, and any value given in them will
22
 
override values input from the config files. Finally, values on the command
23
 
line will be processed and any options given here take final precedence.
24
 
 
25
 
----------------
26
 
Format and Rules
27
 
----------------
28
 
 
29
 
Command line options are of the form `--option-name=value`. There are some
30
 
boolean flags, such as `--help` which do not require (nor can accept) an
31
 
option value.  See :ref:`options` for all options that :program:`drizzled`
32
 
supports.
33
 
 
34
 
Environment variables are the same as the command line options, except that
35
 
the variable name is prefixed with *DRIZZLED_*, in all caps and all `.` and
36
 
`-` are turned into underscores. So the option
37
 
`--innodb.buffer_pool_size=10` could be given in the environment variable
38
 
*DRIZZLED_INNODB_BUFFER_POOL_SIZE*
39
 
 
40
 
The config files contain a set of lines of the form `option-name=value`, one
41
 
per line. Due to a bug in Boost.Program_options Boolean values require an argument,
42
 
e.g. `console.enable=true`.
43
 
 
44
 
Config files support section headers such as `[innodb]` with all options
45
 
occuring subsequently being prefixed by the section header. For instance, if
46
 
one were do give:
47
 
 
48
 
.. code-block:: ini
49
 
 
50
 
  [innodb]
51
 
  buffer_pool_size=10M
52
 
  log_file_size=5M
53
 
 
54
 
It would be the same as:
55
 
 
56
 
.. code-block:: ini
57
 
 
58
 
  innodb.buffer_pool_size=10M
59
 
  innodb.log_file_size
60