The main changelog for the library versions can be found at https://github.com/cobbler/cobblerclient. This file is aiming to provide a logical overview about compatibility with the Cobbler server.
v0.5.0 of this client introduced support for Cobbler v3.3.0, which was a refactor from runtime-created Python attributes to Python Properties. For further details see release notes. Breaking changes:
- This client's support for earlier Cobbler versions was dropped.
- next_server attribute is now either next_server_v4 or next_server_v6
- boot_loader string attribute is now boot_loaders list
- The following string attributes are now lists: FetchableFiles, KernelOptions, KernelOptionsPost, TemplateFiles, AutoinstallMeta, Repos
Retaining the below notes for the time-being, which only apply to v0.4.2 and earlier clients:
Cobbler (up to version 2.8.x) was written in Python2.
However, Python2 is EOL since January 2020.
Cobbler 3 has been adapted to use Python3 and so lots of code changed. Sadly this also broke
backward compatability with the original cobblerclient.
Function read_or_write_kickstart_template was replaced with:
read_autoinstall_templatewrite_autoinstall_templateremove_autoinstall_template
Function read_or_write_snippet was replaced with:
read_autoinstall_snippetwrite_autoinstall_snippetremove_autoinstall_snippet
Template names used are now short names without a path.
So foo.ks instead of /var/lib/cobbler/kickstarts/foo.ks.
These attributes are renamed in Cobbler 3:
kickstarttoautoinstallks_metatoautoinstall_meta, but it is still used as a "legacy field"
These directories have been renamed:
/var/www/cobbler/ks_mirrorto/var/www/cobbler/distro_mirror/var/lib/cobbler/kickstartsto/var/lib/cobbler/templates
The storage locations for the json files changed from /var/lib/cobbler/config/{distros,profiles,systems,etc...}.d to /var/lib/cobbler/collections/{distros,profiles,systems,etc...}.
There is being worked on a script to migrate these: scripts/migrate-data-v2-to-v3.py.
These fields have been added:
boot_loader- must be eithergrub,pxe, oripxe
Support for these attributes was dropped in Cobbler 3:
ldap_enabledldap_typemonit_enabledredhat_management_server