4. Cobbler Configuration

• 4.1. Configuration Migrations
  • 4.1.1. Starting with 3.4.0
  • 4.1.2. Starting with 3.3.3
  • 4.1.3. Starting with 3.3.2
  • 4.1.4. Starting with 3.3.1
  • 4.1.5. Starting with 3.3.0
  • 4.1.6. Starting with 3.2.1
• 4.2. Configuration File Reference
  • 4.2.1. auto_migrate_settings
  • 4.2.2. allow_duplicate_hostnames
  • 4.2.3. allow_duplicate_ips
  • 4.2.4. allow_duplicate_macs
  • 4.2.5. allow_dynamic_settings
  • 4.2.6. always_write_dhcp_entries
  • 4.2.7. anamon_enabled
  • 4.2.8. auth_token_expiration
  • 4.2.9. authn_pam_service
  • 4.2.10. autoinstall
  • 4.2.11. autoinstall_scheme
  • 4.2.12. autoinstall_templates_dir
  • 4.2.13. bind_chroot_path
  • 4.2.14. bind_master
  • 4.2.15. bind_zonefile_path
  • 4.2.16. bootloaders_dir
  • 4.2.17. bootloaders_shim_folder
  • 4.2.18. bootloaders_shim_file
  • 4.2.19. grub2_mod_dir
  • 4.2.20. syslinux_dir
  • 4.2.21. bootloaders_modules
  • 4.2.22. bootloaders_formats
  • 4.2.23. grubconfig_dir
  • 4.2.24. build_reporting_*
  • 4.2.25. buildisodir
  • 4.2.26. cheetah_import_whitelist
  • 4.2.27. client_use_https
  • 4.2.28. client_use_localhost
  • 4.2.29. cobbler_master
  • 4.2.30. convert_server_to_ip
  • 4.2.31. createrepo_flags
  • 4.2.32. default_name_*
  • 4.2.33. default_ownership
  • 4.2.34. default_password_crypted
  • 4.2.35. default_template_type
  • 4.2.36. default_virt_bridge
  • 4.2.37. default_virt_disk_driver
  • 4.2.38. dnsmasq_ethers_file
  • 4.2.39. dnsmasq_hosts_file
  • 4.2.40. default_virt_file_size
  • 4.2.41. default_virt_ram
  • 4.2.42. default_virt_type
  • 4.2.43. enable_ipxe
  • 4.2.44. enable_menu
  • 4.2.45. http_port
  • 4.2.46. kernel_options
  • 4.2.47. ldap_*
  • 4.2.48. bind_manage_ipmi
  • 4.2.49. manage_dhcp
  • 4.2.50. manage_dhcp_v4
  • 4.2.51. manage_dhcp_v6
  • 4.2.52. manage_dns
  • 4.2.53. manage_*_zones
  • 4.2.54. manage_genders
  • 4.2.55. manage_rsync
  • 4.2.56. manage_tftpd
  • 4.2.57. mgmt_*
  • 4.2.58. next_server_v4
  • 4.2.59. next_server_v6
  • 4.2.60. nsupdate_enabled
  • 4.2.61. nsupdate_log
  • 4.2.62. nsupdate_tsig_algorithm
  • 4.2.63. nsupdate_tsig_key
  • 4.2.64. power_management_default_type
  • 4.2.65. proxies
  • 4.2.66. proxy_url_ext
  • 4.2.67. proxy_url_int
  • 4.2.68. puppet_auto_setup
  • 4.2.69. puppet_parameterized_classes
  • 4.2.70. puppet_server
  • 4.2.71. puppet_version
  • 4.2.72. puppetca_path
  • 4.2.73. pxe_just_once
  • 4.2.74. nopxe_with_triggers
  • 4.2.75. redhat_management_permissive
  • 4.2.76. redhat_management_server
  • 4.2.77. uyuni_authentication_endpoint
  • 4.2.78. redhat_management_key
  • 4.2.79. redhat_management_org
  • 4.2.80. redhat_management_user
  • 4.2.81. redhat_management_password
  • 4.2.82. register_new_installs
  • 4.2.83. remove_old_puppet_certs_automatically
  • 4.2.84. replicate_repo_rsync_options
  • 4.2.85. replicate_rsync_options
  • 4.2.86. reposync_flags
  • 4.2.87. reposync_rsync_flags
  • 4.2.88. restart_*
  • 4.2.89. run_install_triggers
  • 4.2.90. scm_track_*
  • 4.2.91. serializer_pretty_json
  • 4.2.92. server
  • 4.2.93. sign_puppet_certs_automatically
  • 4.2.94. signature_path
  • 4.2.95. signature_url
  • 4.2.96. tftpboot_location
  • 4.2.97. virt_auto_boot
  • 4.2.98. webdir
  • 4.2.99. webdir_whitelist
  • 4.2.100. windows_enabled
  • 4.2.101. samba_distro_share
  • 4.2.102. xmlrpc_port
  • 4.2.103. yum_distro_priority
  • 4.2.104. yum_post_install_mirror
  • 4.2.105. yumdownloader_flags
  • 4.2.106. modules
  • 4.2.107. cache_enabled
  • 4.2.108. 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)

4.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!