docs/handbook/handbook-configtuning-core-configuration.mdwn

   1
   2
   3
   4 ## 6.3 Core Configuration
   5
   6
   7
   8 The principal location for system configuration information is within `/etc/rc.conf`. This file contains a wide range of configuration information, principally used at system startup to configure the system. Its name directly implies this; it is configuration information for the `rc*` files.
   9
  10
  11
  12 An administrator should make entries in the `rc.conf` file to override the default settings from `/etc/defaults/rc.conf`. The defaults file should not be copied verbatim to `/etc` - it contains default values, not examples. All system-specific changes should be made in the `rc.conf` file itself.
  13
  14
  15
  16 A number of strategies may be applied in clustered applications to separate site-wide configuration from system-specific configuration in order to keep administration overhead down. The recommended approach is to place site-wide configuration into another file, such as `/etc/rc.conf.site`, and then include this file into `/etc/rc.conf`, which will contain only system-specific information.
  17
  18
  19
  20 As `rc.conf` is read by [sh(1)](http://leaf.dragonflybsd.org/cgi/web-man?command=sh&section=1) it is trivial to achieve this. For example:
  21
  22
  23
  24
  25 * rc.conf:
  26
  27
  28
  29         hostname="node15.example.com"
  30
  31         network_interfaces="fxp0 lo0"
  32
  33         ifconfig_fxp0="inet 10.1.1.1"
  34
  35
  36
  37
  38 * rc.conf.site:
  39
  40
  41
  42         defaultrouter="10.1.1.254"
  43
  44         saver="daemon"
  45
  46         blanktime="100"
  47
  48
  49
  50
  51
  52 The `rc.conf.site` file can then be distributed to every system using `rsync` or a similar program, while the `rc.conf` file remains unique.
  53
  54
  55
  56 Upgrading the system using `make world` will not overwrite the `rc.conf` file, so system configuration information will not be lost.
  57
  58
  59
  60
  61
  62
  63
  64 CategoryHandbook
  65
  66 CategoryHandbook-configuration
  67