5. Cobbler Configuration

• 5.1. Configuration Migrations
  • 5.1.1. Starting with 3.4.0
  • 5.1.2. Starting with 3.3.3
  • 5.1.3. Starting with 3.3.2
  • 5.1.4. Starting with 3.3.1
  • 5.1.5. Starting with 3.3.0
  • 5.1.6. Starting with 3.2.1
• 5.2. Configuration File Reference
  • 5.2.1. auto_migrate_settings
  • 5.2.2. allow_duplicate_hostnames
  • 5.2.3. allow_duplicate_ips
  • 5.2.4. allow_duplicate_macs
  • 5.2.5. allow_dynamic_settings
  • 5.2.6. always_write_dhcp_entries
  • 5.2.7. anamon_enabled
  • 5.2.8. auth_token_expiration
  • 5.2.9. authn_pam_service
  • 5.2.10. autoinstall
  • 5.2.11. autoinstall_scheme
  • 5.2.12. autoinstall_snippets_dir
  • 5.2.13. autoinstall_templates_dir
  • 5.2.14. bind_chroot_path
  • 5.2.15. bind_master
  • 5.2.16. bind_zonefile_path
  • 5.2.17. boot_loader_conf_template_dir
  • 5.2.18. bootloaders_dir
  • 5.2.19. bootloaders_shim_folder
  • 5.2.20. bootloaders_shim_file
  • 5.2.21. grub2_mod_dir
  • 5.2.22. syslinux_dir
  • 5.2.23. bootloaders_modules
  • 5.2.24. bootloaders_formats
  • 5.2.25. grubconfig_dir
  • 5.2.26. build_reporting_*
  • 5.2.27. buildisodir
  • 5.2.28. cheetah_import_whitelist
  • 5.2.29. client_use_https
  • 5.2.30. client_use_localhost
  • 5.2.31. cobbler_master
  • 5.2.32. convert_server_to_ip
  • 5.2.33. createrepo_flags
  • 5.2.34. default_name_*
  • 5.2.35. default_ownership
  • 5.2.36. default_password_crypted
  • 5.2.37. default_template_type
  • 5.2.38. default_virt_bridge
  • 5.2.39. default_virt_disk_driver
  • 5.2.40. default_virt_file_size
  • 5.2.41. default_virt_ram
  • 5.2.42. default_virt_type
  • 5.2.43. enable_ipxe
  • 5.2.44. enable_menu
  • 5.2.45. http_port
  • 5.2.46. iso_template_dir
  • 5.2.47. jinja2_includedir
  • 5.2.48. kernel_options
  • 5.2.49. ldap_*
  • 5.2.50. bind_manage_ipmi
  • 5.2.51. manage_dhcp
  • 5.2.52. manage_dhcp_v4
  • 5.2.53. manage_dhcp_v6
  • 5.2.54. manage_dns
  • 5.2.55. manage_*_zones
  • 5.2.56. manage_genders
  • 5.2.57. manage_rsync
  • 5.2.58. manage_tftpd
  • 5.2.59. mgmt_*
  • 5.2.60. next_server_v4
  • 5.2.61. next_server_v6
  • 5.2.62. nsupdate_enabled
  • 5.2.63. nsupdate_log
  • 5.2.64. nsupdate_tsig_algorithm
  • 5.2.65. nsupdate_tsig_key
  • 5.2.66. power_management_default_type
  • 5.2.67. proxies
  • 5.2.68. proxy_url_ext
  • 5.2.69. proxy_url_int
  • 5.2.70. puppet_auto_setup
  • 5.2.71. puppet_parameterized_classes
  • 5.2.72. puppet_server
  • 5.2.73. puppet_version
  • 5.2.74. puppetca_path
  • 5.2.75. pxe_just_once
  • 5.2.76. nopxe_with_triggers
  • 5.2.77. redhat_management_permissive
  • 5.2.78. redhat_management_server
  • 5.2.79. redhat_management_key
  • 5.2.80. register_new_installs
  • 5.2.81. remove_old_puppet_certs_automatically
  • 5.2.82. replicate_repo_rsync_options
  • 5.2.83. replicate_rsync_options
  • 5.2.84. reposync_flags
  • 5.2.85. reposync_rsync_flags
  • 5.2.86. restart_*
  • 5.2.87. run_install_triggers
  • 5.2.88. scm_track_*
  • 5.2.89. serializer_pretty_json
  • 5.2.90. server
  • 5.2.91. sign_puppet_certs_automatically
  • 5.2.92. signature_path
  • 5.2.93. signature_url
  • 5.2.94. tftpboot_location
  • 5.2.95. virt_auto_boot
  • 5.2.96. webdir
  • 5.2.97. webdir_whitelist
  • 5.2.98. windows_enabled
  • 5.2.99. windows_template_dir
  • 5.2.100. samba_distro_share
  • 5.2.101. xmlrpc_port
  • 5.2.102. yum_distro_priority
  • 5.2.103. yum_post_install_mirror
  • 5.2.104. yumdownloader_flags
  • 5.2.105. modules
  • 5.2.106. cache_enabled
  • 5.2.107. lazy_start

The main configuration file is settings.yaml. It is located per default at /etc/cobbler/. The file is following the YAML specification.

Warning

If you are using allow_dynamic_settings or auto_migrate_settings, then the comments in the YAML file will vanish after the first change due to the fact that PyYAML doesn’t support comments (Source)

5.3. Migration matrix

To/From	<2.8.5	2.8.5	3.0.0	3.0.1	3.1.0	3.1.1	3.1.2	3.2.0	3.2.1	3.3.0	3.3.1	3.3.2	3.3.3	3.4.0
2.8.5	x	o	–	–	–	–	–	–	–	–	–	–	–	–
3.0.0	x	x	o	–	–	–	–	–	–	–	–	–	–	–
3.0.1	x	x	x	o	–	–	–	–	–	–	–	–	–	–
3.1.0	x	x	x	x	o	–	–	–	–	–	–	–	–	–
3.1.1	x	x	x	x	x	o	–	–	–	–	–	–	–	–
3.1.2	x	x	x	x	x	x	o	–	–	–	–	–	–	–
3.2.0	x	x	x	x	x	x	x	o	–	–	–	–	–	–
3.2.1	x	x	x	x	x	x	x	x	o	–	–	–	–	–
3.3.0	x	x	x	x	x	x	x	x	x	o	–	–	–	–
3.3.1	x	x	x	x	x	x	x	x	x	x	o	–	–	–
3.3.2	x	x	x	x	x	x	x	x	x	x	x	o	–	–
3.3.3	x	x	x	x	x	x	x	x	x	x	x	x	o	–
3.4.0	x	x	x	x	x	x	x	x	x	x	x	x	x	o
main	–	–	–	–	–	–	–	–	–	–	–	–	–	–

Legend: x: supported, o: same version, -: not supported

Note

Downgrades are not supported!