cobbler_settings 20 KB

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