cobbler_settings 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470
  1. ---
  2. # cobbler settings file
  3. # restart cobblerd and run "cobbler sync" after making changes
  4. # This config file is in YAML 1.0 format
  5. # see http://yaml.org
  6. # ==========================================================
  7. # if 1, cobbler will allow insertions of system records that duplicate
  8. # the --dns-name information of other system records. In general,
  9. # this is undesirable and should be left 0.
  10. allow_duplicate_hostnames: 0
  11. # if 1, cobbler will allow insertions of system records that duplicate
  12. # the ip address information of other system records. In general,
  13. # this is undesirable and should be left 0.
  14. allow_duplicate_ips: 0
  15. # if 1, cobbler will allow insertions of system records that duplicate
  16. # the mac address information of other system records. In general,
  17. # this is undesirable.
  18. allow_duplicate_macs: 0
  19. # if 1, cobbler will allow settings to be changed dynamically without
  20. # a restart of the cobblerd daemon. You can only change this variable
  21. # by manually editing the settings file, and you MUST restart cobblerd
  22. # after changing it.
  23. allow_dynamic_settings: 0
  24. # by default, installs are *not* set to send installation logs to the cobbler
  25. # # # server. With 'anamon_enabled', kickstart templates may use the pre_anamon
  26. # # # snippet to allow remote live monitoring of their installations from the
  27. # # # cobbler server. Installation logs will be stored under
  28. # # # /var/log/cobbler/anamon/. NOTE: This does allow an xmlrpc call to send logs
  29. # # # to this directory, without authentication, so enable only if you are
  30. # # # ok with this limitation.
  31. anamon_enabled: 0
  32. # If using authn_pam in the modules.conf, this can be configured
  33. # to change the PAM service authentication will be tested against.
  34. # The default value is "login".
  35. authn_pam_service: "login"
  36. # How long the authentication token is valid for, in seconds
  37. auth_token_expiration: 3600
  38. # Email out a report when cobbler finishes installing a system.
  39. # enabled: set to 1 to turn this feature on
  40. # sender: optional
  41. # email: which addresses to email
  42. # smtp_server: used to specify another server for an MTA
  43. # subject: use the default subject unless overridden
  44. build_reporting_enabled: 0
  45. build_reporting_sender: ""
  46. build_reporting_email: [ 'root@localhost' ]
  47. build_reporting_smtp_server: "localhost"
  48. build_reporting_subject: ""
  49. build_reporting_ignorelist: [ "" ]
  50. # Cheetah-language kickstart templates can import Python modules.
  51. # while this is a useful feature, it is not safe to allow them to
  52. # import anything they want. This whitelists which modules can be
  53. # imported through Cheetah. Users can expand this as needed but
  54. # should never allow modules such as subprocess or those that
  55. # allow access to the filesystem as Cheetah templates are evaluated
  56. # by cobblerd as code.
  57. cheetah_import_whitelist:
  58. - "random"
  59. - "re"
  60. - "time"
  61. # Default createrepo_flags to use for new repositories. If you have
  62. # createrepo >= 0.4.10, consider "-c cache --update -C", which can
  63. # dramatically improve your "cobbler reposync" time. "-s sha"
  64. # enables working with Fedora repos from F11/F12 from EL-4 or
  65. # EL-5 without python-hashlib installed (which is not available
  66. # on EL-4)
  67. createrepo_flags: "-c cache -s sha"
  68. # if no kickstart is specified to profile add, use this template
  69. default_kickstart: /var/lib/cobbler/kickstarts/default.ks
  70. # configure all installed systems to use these nameservers by default
  71. # unless defined differently in the profile. For DHCP configurations
  72. # you probably do /not/ want to supply this.
  73. default_name_servers: []
  74. # if using the authz_ownership module (see the Wiki), objects
  75. # created without specifying an owner are assigned to this
  76. # owner and/or group. Can be a comma seperated list.
  77. default_ownership:
  78. - "admin"
  79. # cobbler has various sample kickstart templates stored
  80. # in /var/lib/cobbler/kickstarts/. This controls
  81. # what install (root) password is set up for those
  82. # systems that reference this variable. The factory
  83. # default is "cobbler" and cobbler check will warn if
  84. # this is not changed.
  85. # The simplest way to change the password is to run
  86. # openssl passwd -1
  87. # and put the output between the "" below.
  88. default_password_crypted: "password"
  89. # the default template type to use in the absence of any
  90. # other detected template. If you do not specify the template
  91. # with '#template=<template_type>' on the first line of your
  92. # templates/snippets, cobbler will assume try to use the
  93. # following template engine to parse the templates.
  94. #
  95. # Current valid values are: cheetah, jinja2
  96. default_template_type: "cheetah"
  97. # for libvirt based installs in koan, if no virt bridge
  98. # is specified, which bridge do we try? For EL 4/5 hosts
  99. # this should be xenbr0, for all versions of Fedora, try
  100. # "virbr0". This can be overriden on a per-profile
  101. # basis or at the koan command line though this saves
  102. # typing to just set it here to the most common option.
  103. default_virt_bridge: xenbr0
  104. # use this as the default disk size for virt guests (GB)
  105. default_virt_file_size: 5
  106. # use this as the default memory size for virt guests (MB)
  107. default_virt_ram: 512
  108. # if koan is invoked without --virt-type and no virt-type
  109. # is set on the profile/system, what virtualization type
  110. # should be assumed? Values: xenpv, xenfv, qemu, vmware
  111. # (NOTE: this does not change what virt_type is chosen by import)
  112. default_virt_type: xenpv
  113. # enable gPXE booting? Enabling this option will cause cobbler
  114. # to copy the undionly.kpxe file to the tftp root directory,
  115. # and if a profile/system is configured to boot via gpxe it will
  116. # chain load off pxelinux.0.
  117. # Default: 0
  118. enable_gpxe: 0
  119. # controls whether cobbler will add each new profile entry to the default
  120. # PXE boot menu. This can be over-ridden on a per-profile
  121. # basis when adding/editing profiles with --enable-menu=0/1. Users
  122. # should ordinarily leave this setting enabled unless they are concerned
  123. # with accidental reinstalls from users who select an entry at the PXE
  124. # boot menu. Adding a password to the boot menus templates
  125. # may also be a good solution to prevent unwanted reinstallations
  126. enable_menu: 1
  127. # enable Func-integration? This makes sure each installed machine is set up
  128. # to use func out of the box, which is a powerful way to script and control
  129. # remote machines.
  130. # Func lives at http://fedorahosted.org/func
  131. # read more at https://github.com/cobbler/cobbler/wiki/Func-integration
  132. # you will need to mirror Fedora/EPEL packages for this feature, so see
  133. # https://github.com/cobbler/cobbler/wiki/Manage-yum-repos if you want cobbler
  134. # to help you with this
  135. func_auto_setup: 0
  136. func_master: overlord.example.org
  137. # change this port if Apache is not running plaintext on port
  138. # 80. Most people can leave this alone.
  139. http_port: 80
  140. # kernel options that should be present in every cobbler installation.
  141. # kernel options can also be applied at the distro/profile/system
  142. # level.
  143. kernel_options:
  144. ksdevice: link
  145. lang: 'en_US '
  146. text: ~
  147. # s390 systems require additional kernel options in addition to the
  148. # above defaults
  149. kernel_options_s390x:
  150. RUNKS: 1
  151. ramdisk_size: 40000
  152. root: /dev/ram0
  153. ro: ~
  154. ip: off
  155. vnc: ~
  156. # configuration options if using the authn_ldap module. See the
  157. # the Wiki for details. This can be ignored if you are not using
  158. # LDAP for WebUI/XMLRPC authentication.
  159. ldap_server: "ldap.example.com"
  160. ldap_base_dn: "DC=example,DC=com"
  161. ldap_port: 389
  162. ldap_tls: 1
  163. ldap_anonymous_bind: 1
  164. ldap_search_bind_dn: ''
  165. ldap_search_passwd: ''
  166. ldap_search_prefix: 'uid='
  167. ldap_tls_cacertfile: ''
  168. ldap_tls_keyfile: ''
  169. ldap_tls_certfile: ''
  170. # cobbler has a feature that allows for integration with config management
  171. # systems such as Puppet. The following parameters work in conjunction with
  172. # --mgmt-classes and are described in furhter detail at:
  173. # https://github.com/cobbler/cobbler/wiki/Using-cobbler-with-a-configuration-management-system
  174. mgmt_classes: []
  175. mgmt_parameters:
  176. from_cobbler: 1
  177. # if enabled, this setting ensures that puppet is installed during
  178. # machine provision, a client certificate is generated and a
  179. # certificate signing request is made with the puppet master server
  180. puppet_auto_setup: 0
  181. # when puppet starts on a system after installation it needs to have
  182. # its certificate signed by the puppet master server. Enabling the
  183. # following feature will ensure that the puppet server signs the
  184. # certificate after installation if the puppet master server is
  185. # running on the same machine as cobbler. This requires
  186. # puppet_auto_setup above to be enabled
  187. sign_puppet_certs_automatically: 0
  188. # location of the puppet executable, used for revoking certificates
  189. puppetca_path: "/usr/bin/puppet"
  190. # when a puppet managed machine is reinstalled it is necessary to
  191. # remove the puppet certificate from the puppet master server before a
  192. # new certificate is signed (see above). Enabling the following
  193. # feature will ensure that the certificate for the machine to be
  194. # installed is removed from the puppet master server if the puppet
  195. # master server is running on the same machine as cobbler. This
  196. # requires puppet_auto_setup above to be enabled
  197. remove_old_puppet_certs_automatically: 0
  198. # choose a --server argument when running puppetd/puppet agent during kickstart
  199. #puppet_server: 'puppet'
  200. # let cobbler know that you're using a newer version of puppet
  201. # choose version 3 to use: 'puppet agent'; version 2 uses status quo: 'puppetd'
  202. #puppet_version: 2
  203. # choose whether to enable puppet parameterized classes or not.
  204. # puppet versions prior to 2.6.5 do not support parameters
  205. #puppet_parameterized_classes: 1
  206. # set to 1 to enable Cobbler's DHCP management features.
  207. # the choice of DHCP management engine is in /etc/cobbler/modules.conf
  208. manage_dhcp: 1
  209. # set to 1 to enable Cobbler's DNS management features.
  210. # the choice of DNS mangement engine is in /etc/cobbler/modules.conf
  211. manage_dns: 0
  212. # set to path of bind chroot to create bind-chroot compatible bind
  213. # configuration files. This should be automatically detected.
  214. bind_chroot_path: ""
  215. # set to the ip address of the master bind DNS server for creating secondary
  216. # bind configuration files
  217. bind_master: 127.0.0.1
  218. # manage_genders - Bool to enable/disable managing an /etc/genders file for use with pdsh and others.
  219. manage_genders: 0
  220. # bind_manage_ipmi - used to let bind manage IPMI addresses if the power management address is an IP and if manage_bind is set.
  221. bind_manage_ipmi: 0
  222. # set to 1 to enable Cobbler's TFTP management features.
  223. # the choice of TFTP mangement engine is in /etc/cobbler/modules.conf
  224. manage_tftpd: 1
  225. # set to 1 to enable Cobbler's RSYNC management features.
  226. manage_rsync: 0
  227. # if using BIND (named) for DNS management in /etc/cobbler/modules.conf
  228. # and manage_dns is enabled (above), this lists which zones are managed
  229. # See the Wiki (https://github.com/cobbler/cobbler/wiki/Dns-management) for more info
  230. manage_forward_zones: []
  231. manage_reverse_zones: ['172.17']
  232. # if using cobbler with manage_dhcp, put the IP address
  233. # of the cobbler server here so that PXE booting guests can find it
  234. # if you do not set this correctly, this will be manifested in TFTP open timeouts.
  235. next_server: ip
  236. # settings for power management features. optional.
  237. # see https://github.com/cobbler/cobbler/wiki/Power-management to learn more
  238. # choices (refer to codes.py):
  239. # apc_snmp bladecenter bullpap drac ether_wake ilo integrity
  240. # ipmilan ipmitool lpar rsa virsh wti
  241. power_management_default_type: 'ipmitool'
  242. # the commands used by the power management module are sourced
  243. # from what directory?
  244. power_template_dir: "/etc/cobbler/power"
  245. # if this setting is set to 1, cobbler systems that pxe boot
  246. # will request at the end of their installation to toggle the
  247. # --netboot-enabled record in the cobbler system record. This eliminates
  248. # the potential for a PXE boot loop if the system is set to PXE
  249. # first in it's BIOS order. Enable this if PXE is first in your BIOS
  250. # boot order, otherwise leave this disabled. See the manpage
  251. # for --netboot-enabled.
  252. pxe_just_once: 1
  253. # the templates used for PXE config generation are sourced
  254. # from what directory?
  255. pxe_template_dir: "/etc/cobbler/pxe"
  256. # Path to where system consoles are
  257. consoles: "/var/consoles"
  258. # Are you using a Red Hat management platform in addition to Cobbler?
  259. # Cobbler can help you register to it. Choose one of the following:
  260. # "off" : I'm not using Red Hat Network, Satellite, or Spacewalk
  261. # "hosted" : I'm using Red Hat Network
  262. # "site" : I'm using Red Hat Satellite Server or Spacewalk
  263. # You will also want to read: https://github.com/cobbler/cobbler/wiki/Tips-for-RHN
  264. redhat_management_type: "off"
  265. # if redhat_management_type is enabled, choose your server
  266. # "management.example.org" : For Satellite or Spacewalk
  267. # "xmlrpc.rhn.redhat.com" : For Red Hat Network
  268. # This setting is also used by the code that supports using Spacewalk/Satellite users/passwords
  269. # within Cobbler Web and Cobbler XMLRPC. Using RHN Hosted for this is not supported.
  270. # This feature can be used even if redhat_management_type is off, you just have
  271. # to have authn_spacewalk selected in modules.conf
  272. redhat_management_server: "xmlrpc.rhn.redhat.com"
  273. # specify the default Red Hat authorization key to use to register
  274. # system. If left blank, no registration will be attempted. Similarly
  275. # you can set the --redhat-management-key to blank on any system to
  276. # keep it from trying to register.
  277. redhat_management_key: ""
  278. # if using authn_spacewalk in modules.conf to let cobbler authenticate
  279. # against Satellite/Spacewalk's auth system, by default it will not allow per user
  280. # access into Cobbler Web and Cobbler XMLRPC.
  281. # in order to permit this, the following setting must be enabled HOWEVER
  282. # doing so will permit all Spacewalk/Satellite users of certain types to edit all
  283. # of cobbler's configuration.
  284. # these roles are: config_admin and org_admin
  285. # users should turn this on only if they want this behavior and
  286. # do not have a cross-multi-org seperation concern. If you have
  287. # a single org in your satellite, it's probably safe to turn this
  288. # on and then you can use CobblerWeb alongside a Satellite install.
  289. redhat_management_permissive: 0
  290. # if set to 1, allows /usr/bin/cobbler-register (part of the koan package)
  291. # to be used to remotely add new cobbler system records to cobbler.
  292. # this effectively allows for registration of new hardware from system
  293. # records.
  294. register_new_installs: 0
  295. # Flags to use for yum's reposync. If your version of yum reposync
  296. # does not support -l, you may need to remove that option.
  297. reposync_flags: "-l -n -d"
  298. # when DHCP and DNS management are enabled, cobbler sync can automatically
  299. # restart those services to apply changes. The exception for this is
  300. # if using ISC for DHCP, then omapi eliminates the need for a restart.
  301. # omapi, however, is experimental and not recommended for most configurations.
  302. # If DHCP and DNS are going to be managed, but hosted on a box that
  303. # is not on this server, disable restarts here and write some other
  304. # script to ensure that the config files get copied/rsynced to the destination
  305. # box. This can be done by modifying the restart services trigger.
  306. # Note that if manage_dhcp and manage_dns are disabled, the respective
  307. # parameter will have no effect. Most users should not need to change
  308. # this.
  309. restart_dns: 1
  310. restart_dhcp: 1
  311. # install triggers are scripts in /var/lib/cobbler/triggers/install
  312. # that are triggered in kickstart pre and post sections. Any
  313. # executable script in those directories is run. They can be used
  314. # to send email or perform other actions. They are currently
  315. # run as root so if you do not need this functionality you can
  316. # disable it, though this will also disable "cobbler status" which
  317. # uses a logging trigger to audit install progress.
  318. run_install_triggers: 1
  319. # enables a trigger which version controls all changes to /var/lib/cobbler
  320. # when add, edit, or sync events are performed. This can be used
  321. # to revert to previous database versions, generate RSS feeds, or for
  322. # other auditing or backup purposes. "git" and "hg" are currently suported,
  323. # but git is the recommend SCM for use with this feature.
  324. scm_track_enabled: 0
  325. scm_track_mode: "git"
  326. # this is the address of the cobbler server -- as it is used
  327. # by systems during the install process, it must be the address
  328. # or hostname of the system as those systems can see the server.
  329. # if you have a server that appears differently to different subnets
  330. # (dual homed, etc), you need to read the --server-override section
  331. # of the manpage for how that works.
  332. server: ip
  333. # If set to 1, all commands will be forced to use the localhost address
  334. # instead of using the above value which can force commands like
  335. # cobbler sync to open a connection to a remote address if one is in the
  336. # configuration and would traceback.
  337. client_use_localhost: 0
  338. # If set to 1, all commands to the API (not directly to the XMLRPC
  339. # server) will go over HTTPS instead of plaintext. Be sure to change
  340. # the http_port setting to the correct value for the web server
  341. client_use_https: 0
  342. # this is a directory of files that cobbler uses to make
  343. # templating easier. See the Wiki for more information. Changing
  344. # this directory should not be required.
  345. snippetsdir: /var/lib/cobbler/snippets
  346. # Normally if a kickstart is specified at a remote location, this
  347. # URL will be passed directly to the kickstarting system, thus bypassing
  348. # the usual snippet templating Cobbler does for local kickstart files. If
  349. # this option is enabled, Cobbler will fetch the file contents internally
  350. # and serve a templated version of the file to the client.
  351. template_remote_kickstarts: 0
  352. # should new profiles for virtual machines default to auto booting with the physical host when the physical host reboots?
  353. # this can be overridden on each profile or system object.
  354. virt_auto_boot: 1
  355. # cobbler's web directory. Don't change this setting -- see the
  356. # Wiki on "relocating your cobbler install" if your /var partition
  357. # is not large enough.
  358. webdir: /var/www/cobbler
  359. # cobbler's public XMLRPC listens on this port. Change this only
  360. # if absolutely needed, as you'll have to start supplying a new
  361. # port option to koan if it is not the default.
  362. xmlrpc_port: 25151
  363. # "cobbler repo add" commands set cobbler up with repository
  364. # information that can be used during kickstart and is automatically
  365. # set up in the cobbler kickstart templates. By default, these
  366. # are only available at install time. To make these repositories
  367. # usable on installed systems (since cobbler makes a very convient)
  368. # mirror, set this to 1. Most users can safely set this to 1. Users
  369. # who have a dual homed cobbler server, or are installing laptops that
  370. # will not always have access to the cobbler server may wish to leave
  371. # this as 0. In that case, the cobbler mirrored yum repos are still
  372. # accessable at http://cobbler.example.org/cblr/repo_mirror and yum
  373. # configuration can still be done manually. This is just a shortcut.
  374. yum_post_install_mirror: 1
  375. # the default yum priority for all the distros. This is only used
  376. # if yum-priorities plugin is used. 1=maximum. Tweak with caution.
  377. yum_distro_priority: 1
  378. # Flags to use for yumdownloader. Not all versions may support
  379. # --resolve.
  380. yumdownloader_flags: "--resolve"
  381. # sort and indent JSON output to make it more human-readable
  382. serializer_pretty_json: 0
  383. # replication rsync options for distros, kickstarts, snippets set to override default value of "-avzH"
  384. replicate_rsync_options: "-avzH"
  385. # replication rsync options for repos set to override default value of "-avzH"
  386. replicate_repo_rsync_options: "-avzH"
  387. # always write DHCP entries, regardless if netboot is enabled
  388. always_write_dhcp_entries: 0
  389. # external proxy - used by: get-loaders, reposync, signature update
  390. # eg: proxy_url_ext: "http://192.168.1.1:8080"
  391. proxy_url_ext: ""
  392. # internal proxy - used by systems to reach cobbler for kickstarts
  393. # eg: proxy_url_int: "http://10.0.0.1:8080"
  394. proxy_url_int: ""