8. cobbler package

8.1. Subpackages

8.2. Submodules

8.3. cobbler.api module

This module represents the Cobbler Python API. It is used by the XML-RPC API and can be used by external consumers.

class cobbler.api.CobblerAPI(is_cobblerd: bool = False, settingsfile_location: str = '/etc/cobbler/settings.yaml', execute_settings_automigration: bool = False)[source]

Bases: object

Python API module for Cobbler. See source for cobbler.py, or pydoc, for example usage. Cli apps and daemons should import api.py, and no other Cobbler code.

acl_config(adduser: Optional[str] = None, addgroup: Optional[str] = None, removeuser: Optional[str] = None, removegroup: Optional[str] = None)[source]

Configures users/groups to run the Cobbler CLI as non-root. Pass in only one option at a time. Powers cobbler aclconfig.

Parameters
  • adduser

  • addgroup

  • removeuser

  • removegroup

add_distro(ref, check_for_duplicate_names: bool = False, save: bool = True)[source]

Add a distribution to Cobbler.

Parameters
  • ref – The identifier for the object to add to a collection.

  • check_for_duplicate_names – If the name should be unique or can be present multiple times.

  • save – If the item should be persisted.

add_file(ref, check_for_duplicate_names: bool = False, save: bool = True)[source]

Add a file to Cobbler.

Parameters
  • ref – The identifier for the object to add to a collection.

  • check_for_duplicate_names – If the name should be unique or can be present multiple times.

  • save – If the item should be persisted.

add_image(ref, check_for_duplicate_names: bool = False, save: bool = True)[source]

Add an image to Cobbler.

Parameters
  • ref – The identifier for the object to add to a collection.

  • check_for_duplicate_names – If the name should be unique or can be present multiple times.

  • save – If the item should be persisted.

add_item(what: str, ref, check_for_duplicate_names: bool = False, save: bool = True)[source]

Add an abstract item to a collection of its specific items. This is not meant for external use. Please reefer to one of the specific methods add_<type>.

Parameters
  • what – The item type.

  • ref – The identifier for the object to add to a collection.

  • check_for_duplicate_names – If the name should be unique or can be present multiple times.

  • save – If the item should be persisted.

add_menu(ref, check_for_duplicate_names=False, save=True)[source]

Add a submenu to Cobbler.

Parameters
  • ref – The identifier for the object to add to a collection.

  • check_for_duplicate_names – If the name should be unique or can be present multiple times.

  • save – If the item should be persisted.

add_mgmtclass(ref, check_for_duplicate_names: bool = False, save: bool = True)[source]

Add a management class to Cobbler.

Parameters
  • ref – The identifier for the object to add to a collection.

  • check_for_duplicate_names – If the name should be unique or can be present multiple times.

  • save – If the item should be persisted.

add_package(ref, check_for_duplicate_names: bool = False, save: bool = True)[source]

Add a package to Cobbler.

Parameters
  • ref – The identifier for the object to add to a collection.

  • check_for_duplicate_names – If the name should be unique or can be present multiple times.

  • save – If the item should be persisted.

add_profile(ref, check_for_duplicate_names: bool = False, save: bool = True)[source]

Add a profile to Cobbler.

Parameters
  • ref – The identifier for the object to add to a collection.

  • check_for_duplicate_names – If the name should be unique or can be present multiple times.

  • save – If the item should be persisted.

add_repo(ref, check_for_duplicate_names: bool = False, save: bool = True)[source]

Add a repository to Cobbler.

Parameters
  • ref – The identifier for the object to add to a collection.

  • check_for_duplicate_names – If the name should be unique or can be present multiple times.

  • save – If the item should be persisted.

add_system(ref, check_for_duplicate_names: bool = False, save: bool = True)[source]

Add a system to Cobbler.

Parameters
  • ref – The identifier for the object to add to a collection.

  • check_for_duplicate_names – If the name should be unique or can be present multiple times.

  • save – If the item should be persisted.

authenticate(user: str, password: str) bool[source]

(Remote) access control. This depends on the chosen authentication module. Cobbler internal use only.

Parameters
  • user – The username to check for authentication.

  • password – The password to check for authentication.

Returns

Whether the action succeeded or not.

authorize(user: str, resource: str, arg1=None, arg2=None) int[source]

(Remote) access control. This depends on the chosen authorization module. Cobbler internal use only.

Parameters
  • user – The username to check for authorization.

  • resource – The type of resource which should be checked for access from the supplied user.

  • arg1 – The actual resource to check for authorization.

  • arg2 – Not known what this parameter does exactly.

Returns

The return code of the action.

auto_add_repos()[source]

Import any repos this server knows about and mirror them. Run cobbler reposync to apply the changes. Credit: Seth Vidal.

:raises ImportError

build_iso(iso: str = 'autoinst.iso', profiles=None, systems=None, buildisodir: str = '', distro_name: str = '', standalone: bool = False, airgapped: bool = False, source: str = '', exclude_dns: bool = False, xorrisofs_opts: str = '')[source]

Build an iso image which may be network bootable or not.

Parameters
  • iso – The name of the ISO. Defaults to autoinst.iso.

  • profiles – Use these profiles only

  • systems – Use these systems only

  • buildisodir – This overwrites the directory from the settings in which the iso is built in.

  • distro_name – Used with --standalone and --airgapped to create a distro-based ISO including all associated.

  • standalone – This means that no network connection is needed to install the generated iso.

  • airgapped – This option implies standalone=True.

  • source – If the iso should be offline available this is the path to the sources of the image.

  • exclude_dns – Whether the repositories have to be locally available or the internet is reachable.

  • xorrisofs_optsxorrisofs options to include additionally.

check() Union[None, list][source]

See if all preqs for network booting are valid. This returns a list of strings containing instructions on things to correct. An empty list means there is nothing to correct, but that still doesn’t mean there are configuration errors. This is mainly useful for human admins, who may, for instance, forget to properly set up their TFTP servers for PXE, etc.

Returns

None or a list of things to address.

clear_logs(system)[source]

Clears console and anamon logs for system

Parameters

system – The system to clear logs of.

copy_distro(ref, newname: str)[source]

This method copies a distro which is just different in the name of the object.

Parameters
  • ref – The object itself which gets copied.

  • newname – The new name of the newly created object.

copy_file(ref, newname: str)[source]

This method copies a file which is just different in the name of the object.

Parameters
  • ref – The object itself which gets copied.

  • newname – The new name of the newly created object.

copy_image(ref, newname: str)[source]

This method copies an image which is just different in the name of the object.

Parameters
  • ref – The object itself which gets copied.

  • newname – The new name of the newly created object.

copy_item(what: str, ref, newname: str)[source]

General copy method which is called by the specific methods.

Parameters
  • what – The collection type which gets copied.

  • ref – The object itself which gets copied.

  • newname – The new name of the newly created object.

copy_menu(ref, newname: str)[source]

This method copies a file which is just different in the name of the object.

Parameters
  • ref – The object itself which gets copied.

  • newname – The new name of the newly created object.

copy_mgmtclass(ref, newname: str)[source]

This method copies a management class which is just different in the name of the object.

Parameters
  • ref – The object itself which gets copied.

  • newname – The new name of the newly created object.

copy_package(ref, newname: str)[source]

This method copies a package which is just different in the name of the object.

Parameters
  • ref – The object itself which gets copied.

  • newname – The new name of the newly created object.

copy_profile(ref, newname: str)[source]

This method copies a profile which is just different in the name of the object.

Parameters
  • ref – The object itself which gets copied.

  • newname – The new name of the newly created object.

copy_repo(ref, newname: str)[source]

This method copies a repository which is just different in the name of the object.

Parameters
  • ref – The object itself which gets copied.

  • newname – The new name of the newly created object.

copy_system(ref, newname: str)[source]

This method copies a system which is just different in the name of the object.

Parameters
  • ref – The object itself which gets copied.

  • newname – The new name of the newly created object.

deserialize()[source]

Load cobbler_collections from disk. Cobbler internal use only.

distros()[source]

Return the current list of distributions

dump_vars(obj, formatted_output: bool = False, remove_dicts: bool = False)[source]

Dump all known variables related to that object.

Parameters
  • obj – The object for which the variables should be dumped.

  • formatted_output – If True the values will align in one column and be pretty printed for cli example.

  • remove_dicts – If True the dictionaries will be put into str form.

Returns

A dictionary with all the information which could be collected.

files()[source]

Return the current list of files

find_distro(name: str = '', return_list=False, no_errors=False, **kargs)[source]

Find a distribution via a name or keys specified in the **kargs.

Parameters
  • name – The name to search for.

  • return_list – If only the first result or all results should be returned.

  • no_errors – Silence some errors which would raise if this turned to False.

  • kargs – Additional key-value pairs which may help in finding the desired objects.

Returns

A single object or a list of all search results.

find_file(name: str = '', return_list=False, no_errors=False, **kargs)[source]

Find a file via a name or keys specified in the **kargs.

Parameters
  • name – The name to search for.

  • return_list – If only the first result or all results should be returned.

  • no_errors – Silence some errors which would raise if this turned to False.

  • kargs – Additional key-value pairs which may help in finding the desired objects.

Returns

A single object or a list of all search results.

find_image(name: str = '', return_list=False, no_errors=False, **kargs)[source]

Find an image via a name or keys specified in the **kargs.

Parameters
  • name – The name to search for.

  • return_list – If only the first result or all results should be returned.

  • no_errors – Silence some errors which would raise if this turned to False.

  • kargs – Additional key-value pairs which may help in finding the desired objects.

Returns

A single object or a list of all search results.

find_items(what: str = '', criteria: Optional[dict] = None, name: str = '', return_list: bool = True, no_errors: bool = False)[source]

This is the abstract base method for finding object int the api. It should not be used by external resources. Please reefer to the specific implementations of this method called find_<object type>.

Parameters
  • what – The object type of the item to search for.

  • criteria – The dictionary with the key-value pairs to find objects with.

  • name – The name of the object.

  • return_list – If only the first result or all results should be returned.

  • no_errors – Silence some errors which would raise if this turned to False.

Returns

The list of items witch match the search criteria.

find_menu(name: str = '', return_list=False, no_errors=False, **kargs)[source]

Find a menu via a name or keys specified in the **kargs.

Parameters
  • name – The name to search for.

  • return_list – If only the first result or all results should be returned.

  • no_errors – Silence some errors which would raise if this turned to False.

  • kargs – Additional key-value pairs which may help in finding the desired objects.

Returns

A single object or a list of all search results.

find_mgmtclass(name: str = '', return_list=False, no_errors=False, **kargs)[source]

Find a management class via a name or keys specified in the **kargs.

Parameters
  • name – The name to search for.

  • return_list – If only the first result or all results should be returned.

  • no_errors – Silence some errors which would raise if this turned to False.

  • kargs – Additional key-value pairs which may help in finding the desired objects.

Returns

A single object or a list of all search results.

find_package(name: str = '', return_list=False, no_errors=False, **kargs)[source]

Find a package via a name or keys specified in the **kargs.

Parameters
  • name – The name to search for.

  • return_list – If only the first result or all results should be returned.

  • no_errors – Silence some errors which would raise if this turned to False.

  • kargs – Additional key-value pairs which may help in finding the desired objects.

Returns

A single object or a list of all search results.

find_profile(name: str = '', return_list=False, no_errors=False, **kargs)[source]

Find a profile via a name or keys specified in the **kargs.

Parameters
  • name – The name to search for.

  • return_list – If only the first result or all results should be returned.

  • no_errors – Silence some errors which would raise if this turned to False.

  • kargs – Additional key-value pairs which may help in finding the desired objects.

Returns

A single object or a list of all search results.

find_repo(name: str = '', return_list=False, no_errors=False, **kargs)[source]

Find a repository via a name or keys specified in the **kargs.

Parameters
  • name – The name to search for.

  • return_list – If only the first result or all results should be returned.

  • no_errors – Silence some errors which would raise if this turned to False.

  • kargs – Additional key-value pairs which may help in finding the desired objects.

Returns

A single object or a list of all search results.

find_system(name: str = '', return_list=False, no_errors=False, **kargs)[source]

Find a system via a name or keys specified in the **kargs.

Parameters
  • name – The name to search for.

  • return_list – If only the first result or all results should be returned.

  • no_errors – Silence some errors which would raise if this turned to False.

  • kargs – Additional key-value pairs which may help in finding the desired objects.

Returns

A single object or a list of all search results.

generate_bootcfg(profile: str, system: str) str[source]

Generate a boot configuration. The system wins over the profile.

Parameters
  • profile – The profile to return the configuration for.

  • system – The system to return the configuration for.

Returns

The generated configuration file.

generate_ipxe(profile: str, image: str, system: str) str[source]

Generate the ipxe configuration files. The system wins over the profile. Profile and System win over Image.

Parameters
  • profile – The profile to return the configuration for.

  • image – The image to return the configuration for.

  • system – The system to return the configuration for.

Returns

The generated configuration file.

generate_script(profile: Optional[str], system: Optional[str], name: str)[source]

Generate an autoinstall script for the specified profile or system. The system wins over the profile.

Parameters
  • profile – The profile name to generate the script for.

  • system – The system name to generate the script for.

  • name – The name of the script which should be generated. Must only contain alphanumeric characters, dots and underscores.

Returns

The generated script or an error message.

get_distros_since(mtime: float, collapse: bool = False)[source]

Returns distros modified since a certain time (in seconds since Epoch)

Parameters
  • mtime – The timestamp which marks the gate if an object is included or not.

  • collapse – collapse=True specifies returning a dict instead of objects.

Returns

The list of distros which are newer then the given timestamp.

get_files_since(mtime: float, collapse: bool = False) list[source]

Return files modified since a certain time (in seconds since Epoch)

Parameters
  • mtime – The timestamp which marks the gate if an object is included or not.

  • collapse – If True then this specifies that a list of dicts should be returned instead of a list of objects.

Returns

The list of files which are newer then the given timestamp.

get_images_since(mtime: float, collapse: bool = False) list[source]

Return images modified since a certain time (in seconds since Epoch)

Parameters
  • mtime – The timestamp which marks the gate if an object is included or not.

  • collapse – If True then this specifies that a list of dicts should be returned instead of a list of objects.

Returns

The list of images which are newer then the given timestamp.

get_item(what: str, name: str)[source]

Get a general item.

Parameters
  • what – The item type to retrieve from the internal database.

  • name – The name of the item to retrieve.

Returns

An item of the desired type.

get_item_resolved_value(item_uuid: str, attribute: str)[source]

This method helps non Python API consumers to retrieve the final data of a field with inheritance.

This does not help with network interfaces because they don’t have a UUID at the moment and thus can’t be queried via their UUID.

Parameters
  • item_uuid – The UUID of the item that should be retrieved.

  • attribute – The attribute that should be retrieved.

Raises
  • ValueError – In case a value given was either malformed or the desired item did not exist.

  • TypeError – In case the type of the method arguments do have the wrong type.

  • AttributeError – In case the attribute specified is not available on the given item (type).

Returns

The attribute value. Since this might be of type NetworkInterface we cannot yet set this explicitly.

get_items(what: str)[source]

Get all items of a collection.

Parameters

what – The collection to query.

Returns

The items which were queried. May return no items.

get_menus_since(mtime: float, collapse=False) list[source]

Return files modified since a certain time (in seconds since Epoch)

Parameters
  • mtime – The timestamp which marks the gate if an object is included or not.

  • collapse – If True then this specifies that a list of dicts should be returned instead of a list of objects.

Returns

The list of files which are newer then the given timestamp.

get_mgmtclasses_since(mtime: float, collapse: bool = False) list[source]

Return management classes modified since a certain time (in seconds since Epoch)

Parameters
  • mtime – The timestamp which marks the gate if an object is included or not.

  • collapse – If True then this specifies that a list of dicts should be returned instead of a list of objects.

Returns

The list of management classes which are newer then the given timestamp.

get_module_by_name(module_name: str)[source]

Returns a loaded Cobbler module named ‘name’, if one exists, else None. Cobbler internal use only.

Parameters

module_name

Returns

get_module_from_file(section: str, name: str, fallback: Optional[str] = None)[source]

Looks in /etc/cobbler/settings.yaml for a section called ‘section’ and a key called ‘name’, and then returns the module that corresponds to the value of that key. Cobbler internal use only.

Parameters
  • section – The section to look at.

  • name – The name of the module to retrieve

  • fallback – The default module in case the requested one is not found.

Returns

The requested Python Module.

get_module_name_from_file(section: str, name: str, fallback: Optional[str] = None)[source]

Looks up a module the same as get_module_from_file but returns the module name rather than the module itself.

Parameters
  • section

  • name

  • fallback

Returns

get_modules_in_category(category: str)[source]

Returns all modules in a given category, for instance “serializer”, or “cli”. Cobbler internal use only.

Parameters

category – The category to check.

Returns

The list of modules.

get_packages_since(mtime: float, collapse: bool = False) list[source]

Return packages modified since a certain time (in seconds since Epoch)

Parameters
  • mtime – The timestamp which marks the gate if an object is included or not.

  • collapse – If True then this specifies that a list of dicts should be returned instead of a list of objects.

Returns

The list of packages which are newer then the given timestamp.

get_profiles_since(mtime: float, collapse: bool = False) list[source]

Returns profiles modified since a certain time (in seconds since Epoch)

Parameters
  • mtime – The timestamp which marks the gate if an object is included or not.

  • collapse – If True then this specifies that a list of dicts should be returned instead of a list of objects.

Returns

The list of profiles which are newer then the given timestamp.

get_repo_config_for_profile(obj) str[source]

Get the repository configuration for the specified profile

Parameters

obj – The profile to return the configuration for.

Returns

The repository configuration as a string.

get_repo_config_for_system(obj) str[source]

Get the repository configuration for the specified system.

Parameters

obj – The system to return the configuration for.

Returns

The repository configuration as a string.

get_repos_since(mtime: float, collapse: bool = False) list[source]

Return repositories modified since a certain time (in seconds since Epoch)

Parameters
  • mtime – The timestamp which marks the gate if an object is included or not.

  • collapse – If True then this specifies that a list of dicts should be returned instead of a list of objects.

Returns

The list of repositories which are newer then the given timestamp.

get_signatures() dict[source]

This returns the local signature cache.

Returns

The dict containing all signatures.

get_sync(verbose: bool = False)[source]

Get a Cobbler Sync object which may be executed through the call of obj.run().

Parameters

verbose – If the action should be just logged as needed or (if True) as much verbose as possible.

Returns

An instance of the CobblerSync class to execute the sync with.

get_systems_since(mtime: float, collapse: bool = False) list[source]

Return systems modified since a certain time (in seconds since Epoch)

Parameters
  • mtime – The timestamp which marks the gate if an object is included or not.

  • collapse – If True then this specifies that a list of dicts should be returned instead of a list of objects.

Returns

The list of systems which are newer then the given timestamp.

get_template_file_for_profile(obj, path) str[source]

Get the template for the specified profile.

Parameters
  • obj – The object which is related to that template.

  • path – The path to the template.

Returns

The template as in its string representation.

get_template_file_for_system(obj, path)[source]

Get the template for the specified system.

Parameters
  • obj – The object which is related to that template.

  • path – The path to the template.

Returns

The template as in its string representation.

get_valid_obj_boot_loaders(obj) List[str][source]

Return the list of valid boot loaders for the object

Parameters

obj – The object for which the boot loaders should be looked up.

Returns

Get a list of all valid boot loaders.

Hardlink all files where this is possible to improve performance.

Returns

The return code of the subprocess call which actually hardlinks the files.

images()[source]

Return the current list of images

import_tree(mirror_url: str, mirror_name: str, network_root=None, autoinstall_file=None, rsync_flags=None, arch=None, breed=None, os_version=None) bool[source]

Automatically import a directory tree full of distribution files.

Parameters
  • mirror_url – Can be a string that represents a path, a user@host syntax for SSH, or an rsync:// address. If mirror_url is a filesystem path and mirroring is not desired, set network_root to something like “nfs://path/to/mirror_url/root”

  • mirror_name – The name of the mirror.

  • network_root

  • autoinstall_file

  • rsync_flags

  • arch

  • breed

  • os_version

input_boolean(value: Union[str, bool, int]) bool[source]

See also

input_boolean()

input_int(value: Union[str, int, float]) int[source]

See also

input_int()

input_string_or_dict(options: Union[str, list, dict], allow_multiples=True) Union[str, dict][source]
input_string_or_dict_no_inherit(options: Union[str, list, dict], allow_multiples=True) dict[source]
input_string_or_list(options: Optional[Union[str, list]]) Union[list, str][source]
input_string_or_list_no_inherit(options: Optional[Union[str, list]]) list[source]
is_selinux_enabled() bool[source]

Returns whether selinux is enabled on the Cobbler server. We check this just once at Cobbler API init time, because a restart is required to change this; this does /not/ check enforce/permissive, nor does it need to.

is_selinux_supported() bool[source]

Returns whether or not the OS is sufficient enough to run with SELinux enabled (currently EL 5 or later).

Returns

False per default. If Distro is Redhat and Version >= 5 then it returns true.

last_modified_time() float[source]

Returns the time of the last modification to Cobbler, made by any API instance, regardless of the serializer type.

Returns

0 if there is no file where the information required for this method is saved.

log(msg: str, args=None, debug: bool = False)[source]

Logs a message with the already initiated logger of this object.

Parameters
  • msg – The message to log.

  • args – Optional message which gets appended to the main msg with a ‘;’.

  • debug – Weather the logged message is a debug message (true) or info (false).

Deprecated since version 3.3.0: We should use the standard logger.

menus()[source]

Return the current list of menus

mgmtclasses()[source]

Return the current list of mgmtclasses

mkloaders()[source]

Create the GRUB installer images via this API call. It utilizes grub2-mkimage behind the curtain.

new_distro(is_subobject: bool = False)[source]

Returns a new empty distro object. This distro is not automatically persisted. Persistance is achieved via save().

Parameters

is_subobject – If the object created is a subobject or not.

Returns

An empty Distro object.

new_file(is_subobject: bool = False)[source]

Returns a new empty file object. This file is not automatically persisted. Persistence is achieved via save().

Parameters

is_subobject – If the object created is a subobject or not.

Returns

An empty File object.

new_image(is_subobject: bool = False)[source]

Returns a new empty image object. This image is not automatically persisted. Persistence is achieved via save().

Parameters

is_subobject – If the object created is a subobject or not.

Returns

An empty image object.

new_item(what: str = '', is_subobject: bool = False)[source]

Creates a new (unconfigured) object. The object is not persisted.

Parameters
  • what – Specifies the type of object. Valid item types can be seen at ItemTypes().

  • is_subobject – If the object is a subobject of an already existing object or not.

Returns

The newly created object.

new_menu(is_subobject: bool = False)[source]

Returns a new empty menu object. This file is not automatically persisted. Persistence is achieved via save().

Parameters

is_subobject – If the object created is a subobject or not.

Returns

An empty File object.

new_mgmtclass(is_subobject: bool = False)[source]

Returns a new empty mgmtclass object. This mgmtclass is not automatically persisted. Persistence is achieved via save().

Parameters

is_subobject – If the object created is a subobject or not.

Returns

An empty mgmtclass object.

new_package(is_subobject: bool = False)[source]

Returns a new empty package object. This package is not automatically persisted. Persistence is achieved via save().

Parameters

is_subobject – If the object created is a subobject or not.

Returns

An empty Package object.

new_profile(is_subobject: bool = False)[source]

Returns a new empty profile object. This profile is not automatically persisted. Persistence is achieved via save().

Parameters

is_subobject – If the object created is a subobject or not.

Returns

An empty Profile object.

new_repo(is_subobject: bool = False)[source]

Returns a new empty repo object. This repository is not automatically persisted. Persistence is achieved via save().

Parameters

is_subobject – If the object created is a subobject or not.

Returns

An empty repo object.

new_system(is_subobject: bool = False)[source]

Returns a new empty system object. This system is not automatically persisted. Persistence is achieved via save().

Parameters

is_subobject – If the object created is a subobject or not.

Returns

An empty System object.

packages()[source]

Return the current list of packages

power_system(system: str, power_operation: str, user: Optional[str] = None, password: Optional[str] = None)[source]

Power on / power off / get power status /reboot a system.

Parameters
  • system – Cobbler system

  • power_operation – power operation. Valid values: on, off, reboot, status

  • user – power management user

  • password – power management password

Returns

bool if operation was successful

profiles()[source]

Return the current list of profiles

remove_distro(ref, recursive: bool = False, delete: bool = True, with_triggers: bool = True)[source]

Remove a distribution from Cobbler.

Parameters
  • ref – The internal unique handle for the item.

  • recursive – If the item should recursively should delete dependencies on itself.

  • delete – Not known what this parameter does exactly.

  • with_triggers – Whether you would like to have the removal triggers executed or not.

remove_file(ref, recursive: bool = False, delete: bool = True, with_triggers: bool = True)[source]

Remove a file from Cobbler.

Parameters
  • ref – The internal unique handle for the item.

  • recursive – If the item should recursively should delete dependencies on itself.

  • delete – Not known what this parameter does exactly.

  • with_triggers – Whether you would like to have the removal triggers executed or not.

remove_image(ref, recursive: bool = False, delete: bool = True, with_triggers: bool = True)[source]

Remove a image from Cobbler.

Parameters
  • ref – The internal unique handle for the item.

  • recursive – If the item should recursively should delete dependencies on itself.

  • delete – Not known what this parameter does exactly.

  • with_triggers – Whether you would like to have the removal triggers executed or not.

remove_item(what: str, ref, recursive: bool = False, delete: bool = True, with_triggers: bool = True)[source]

Remove a general item. This method should not be used by an external api. Please use the specific remove_<itemtype> methods.

Parameters
  • what – The type of the item.

  • ref – The internal unique handle for the item.

  • recursive – If the item should recursively should delete dependencies on itself.

  • delete – Not known what this parameter does exactly.

  • with_triggers – Whether you would like to have the removal triggers executed or not.

remove_menu(ref, recursive=False, delete=True, with_triggers=True)[source]

Remove a menu from Cobbler.

Parameters
  • ref – The internal unique handle for the item.

  • recursive – If the item should recursively should delete dependencies on itself.

  • delete – Not known what this parameter does exactly.

  • with_triggers – Whether you would like to have the removal triggers executed or not.

remove_mgmtclass(ref, recursive: bool = False, delete: bool = True, with_triggers: bool = True)[source]

Remove a management class from Cobbler.

Parameters
  • ref – The internal unique handle for the item.

  • recursive – If the item should recursively should delete dependencies on itself.

  • delete – Not known what this parameter does exactly.

  • with_triggers – Whether you would like to have the removal triggers executed or not.

remove_package(ref, recursive: bool = False, delete: bool = True, with_triggers: bool = True)[source]

Remove a package from Cobbler.

Parameters
  • ref – The internal unique handle for the item.

  • recursive – If the item should recursively should delete dependencies on itself.

  • delete – Not known what this parameter does exactly.

  • with_triggers – Whether you would like to have the removal triggers executed or not.

remove_profile(ref, recursive: bool = False, delete: bool = True, with_triggers: bool = True)[source]

Remove a profile from Cobbler.

Parameters
  • ref – The internal unique handle for the item.

  • recursive – If the item should recursively should delete dependencies on itself.

  • delete – Not known what this parameter does exactly.

  • with_triggers – Whether you would like to have the removal triggers executed or not.

remove_repo(ref, recursive: bool = False, delete: bool = True, with_triggers: bool = True)[source]

Remove a repository from Cobbler.

Parameters
  • ref – The internal unique handle for the item.

  • recursive – If the item should recursively should delete dependencies on itself.

  • delete – Not known what this parameter does exactly.

  • with_triggers – Whether you would like to have the removal triggers executed or not.

remove_system(ref, recursive: bool = False, delete: bool = True, with_triggers: bool = True)[source]

Remove a system from Cobbler.

Parameters
  • ref – The internal unique handle for the item.

  • recursive – If the item should recursively should delete dependencies on itself.

  • delete – Not known what this parameter does exactly.

  • with_triggers – Whether you would like to have the removal triggers executed or not.

rename_distro(ref, newname: str)[source]

Rename a distro to a new name.

Parameters
  • ref – The internal unique handle for the item.

  • newname – The new name for the item.

rename_file(ref, newname: str)[source]

Rename a file to a new name.

Parameters
  • ref – The internal unique handle for the item.

  • newname – The new name for the item.

rename_image(ref, newname: str)[source]

Rename an image to a new name.

Parameters
  • ref – The internal unique handle for the item.

  • newname – The new name for the item.

rename_item(what: str, ref, newname: str)[source]

Remove a general item. This method should not be used by an external api. Please use the specific rename_<itemtype> methods.

Parameters
  • what – The type of object which should be renamed.

  • ref – The internal unique handle for the item.

  • newname – The new name for the item.

rename_menu(ref, newname: str)[source]

Rename a menu to a new name.

Parameters
  • ref – The internal unique handle for the item.

  • newname – The new name for the item.

rename_mgmtclass(ref, newname: str)[source]

Rename a management class to a new name.

Parameters
  • ref – The internal unique handle for the item.

  • newname – The new name for the item.

rename_package(ref, newname: str)[source]

Rename a package to a new name.

Parameters
  • ref – The internal unique handle for the item.

  • newname – The new name for the item.

rename_profile(ref, newname: str)[source]

Rename a profile to a new name.

Parameters
  • ref – The internal unique handle for the item.

  • newname – The new name for the item.

rename_repo(ref, newname: str)[source]

Rename a repository to a new name.

Parameters
  • ref – The internal unique handle for the item.

  • newname – The new name for the item.

rename_system(ref, newname: str)[source]

Rename a system to a new name.

Parameters
  • ref – The internal unique handle for the item.

  • newname – The new name for the item.

replicate(cobbler_master: Optional[str] = None, port: str = '80', distro_patterns: str = '', profile_patterns: str = '', system_patterns: str = '', repo_patterns: str = '', image_patterns: str = '', mgmtclass_patterns=None, package_patterns=None, file_patterns: bool = False, prune: bool = False, omit_data: bool = False, sync_all: bool = False, use_ssl: bool = False)[source]

Pull down data/configs from a remote Cobbler server that is a master to this server.

Parameters
  • cobbler_master – The hostname/URL of the other Cobbler server

  • port – The port to use for the replication task.

  • distro_patterns – The pattern of distros which should be synced.

  • profile_patterns – The pattern of profiles which should be synced.

  • system_patterns – The pattern of systems which should be synced.

  • repo_patterns – The pattern of repositories which should be synced.

  • image_patterns – The pattern of images which should be synced.

  • mgmtclass_patterns – The pattern of management classes which should be synced.

  • package_patterns – The pattern of packages which should be synced.

  • file_patterns – The pattern of files which should be synced.

  • prune – Whether the object not on the master should be removed or not.

  • omit_data – If the data downloaded by the current Cobbler server should be rsynced to the destination server.

  • sync_all – This parameter behaves similarly to a dry run argument. If True then everything will executed, if False then only some things are synced.

  • use_ssl – Whether SSL should be used (True) or not (False).

report(report_what: Optional[str] = None, report_name: Optional[str] = None, report_type: Optional[str] = None, report_fields: Optional[str] = None, report_noheaders: Optional[bool] = None)[source]

Report functionality for Cobbler.

Parameters
  • report_what – The object type that should be reported.

  • report_name – The name of the object which should be possibly reported.

  • report_type – May be either “text”, “csv”, “mediawiki”, “trac” or “doku”.

  • report_fields – Specify “all” or the fields you want to be reported.

  • report_noheaders – If the column headers should be included in the output or not.

repos()[source]

Return the current list of repos

reposync(name: Optional[str] = None, tries: int = 1, nofail: bool = False)[source]

Take the contents of /var/lib/cobbler/repos and update them – or create the initial copy if no contents exist yet.

Parameters
  • name – The name of the repository to run reposync for.

  • tries – How many tries should be executed before the action fails.

  • nofail – If True then the action will fail, otherwise the action will just be skipped. This respects the tries parameter.

serialize()[source]

Save the cobbler_collections to disk. Cobbler internal use only.

set_item_resolved_value(item_uuid: str, attribute: str, value)[source]

This method helps non Python API consumers to use the Python property setters without having access to the raw data of the object. In case you pass a dictionary the method tries to deduplicate it.

This does not help with network interfaces because they don’t have a UUID at the moment and thus can’t be queried via their UUID.

Warning

This function may throw any exception that is thrown by a setter of a Python property defined in Cobbler.

Parameters
  • item_uuid – The UUID of the item that should be retrieved.

  • attribute – The attribute that should be retrieved.

  • value – The new value to set.

Raises
  • ValueError – In case a value given was either malformed or the desired item did not exist.

  • TypeError – In case the type of the method arguments do have the wrong type.

  • AttributeError – In case the attribute specified is not available on the given item (type).

settings()[source]

Return the application configuration

signature_update()[source]

Update all signatures from the URL specified in the settings.

status(mode: str)[source]

Get the status of the current Cobbler instance.

Parameters

mode – “text” or anything else. Meaning whether the output is thought for the terminal or not.

Returns

The current status of Cobbler.

sync(verbose: bool = False, what: Optional[list] = None)[source]

Take the values currently written to the configuration files in /etc, and /var, and build out the information tree found in /tftpboot. Any operations done in the API that have not been saved with serialize() will NOT be synchronized with this command.

Parameters
  • verbose – If the action should be just logged as needed or (if True) as much verbose as possible.

  • what – List of strings what services to sync (e.g. dhcp and/or dns). Empty list for full sync.

sync_dhcp()[source]

Only build out the DHCP configuration.

sync_dns()[source]

Only build out the DNS configuration.

sync_systems(systems: List[str], verbose: bool = False)[source]

Take the values currently written to the configuration files in /etc, and /var, and build out the information tree found in /tftpboot. Any operations done in the API that have not been saved with serialize() will NOT be synchronized with this command.

Parameters
  • systems – List of specified systems that needs to be synced

  • verbose – If the action should be just logged as needed or (if True) as much verbose as possible.

systems()[source]

Return the current list of systems

validate_autoinstall_files()[source]

Validate if any of the autoinstallation files are invalid and if yes report this.

version(extended: bool = False) Union[float, Dict[str, Union[str, list]]][source]

What version is Cobbler?

If extended == False, returns a float for backwards compatibility If extended == True, returns a dict:

gitstamp – the last git commit hash gitdate – the last git commit date on the builder machine builddate – the time of the build version – something like “1.3.2” version_tuple – something like [ 1, 3, 2 ]

Parameters

extended – False returns a float, True a Dictionary.

8.4. cobbler.autoinstall_manager module

This module contains code in order to create the automatic installation files. For example kickstarts, autoyast files or preseed files.

class cobbler.autoinstall_manager.AutoInstallationManager(api)[source]

Bases: object

Manage automatic installation templates, snippets and final files

generate_autoinstall(profile=None, system=None) str[source]

Generates the autoinstallation for a system or a profile. You may only specifify one parameter. If you specify both, the system is generated and the profile argument is ignored.

Parameters
  • profile – The Cobbler profile you want an autoinstallation generated for.

  • system – The Cobbler system you want an autoinstallation generated for.

Returns

The rendered template for the system or profile.

get_autoinstall_snippets() list[source]

Get a list of all autoinstallation snippets.

Returns

The list of snippets

get_autoinstall_templates() list[source]

Get automatic OS installation templates

Returns

A list of automatic installation templates

is_autoinstall_in_use(name: str) bool[source]

Reports the status if a given system is currently being provisioned.

Parameters

name – The name of the system.

Returns

Whether the system is in install mode or not.

log_autoinstall_validation_errors(errors_type: int, errors: list)[source]

Log automatic installation file errors

Parameters
  • errors_type – validation errors type

  • errors – A list with all the errors which occurred.

read_autoinstall_snippet(file_path: str) str[source]

Reads a autoinstall snippet from underneath the configured snippet base dir.

Parameters

file_path – The relative file path under the configured snippets base dir.

Returns

The read snippet.

read_autoinstall_template(file_path: str) str[source]

Read an automatic OS installation template

Parameters

file_path – automatic installation template relative file path

Returns

automatic installation template content

remove_autoinstall_snippet(file_path: str) bool[source]

Remove the autoinstall snippet with the given path.

Parameters

file_path – The path relative to the configured snippet root.

Returns

A boolean indicating the success of the task.

remove_autoinstall_template(file_path: str)[source]

Remove an automatic OS installation template

Parameters

file_path – automatic installation template relative file path

validate_autoinstall_file(obj, is_profile: bool) list[source]

Validate automatic installation file used by a system/profile.

Parameters
  • obj – system/profile

  • is_profile – if obj is a profile

Returns

[bool, int, list] list with validation result, errors type and list of errors

validate_autoinstall_files() bool[source]

Determine if Cobbler automatic OS installation files will be accepted by corresponding Linux distribution installers. The presence of an error does not imply that the automatic installation file is bad, only that the possibility exists. Automatic installation file validators are not available for all automatic installation file types and on all operating systems in which Cobbler may be installed.

Returns

True if all automatic installation files are valid, otherwise false.

validate_autoinstall_snippet_file_path(snippet: str, new_snippet: bool = False) str[source]

Validate the snippet’s relative file path.

Parameters
  • snippet – automatic installation snippet relative file path

  • new_snippet – when set to true new filenames are allowed

Returns

Snippet if successful otherwise raises an exception.

Raises
  • TypeError – Raised in case snippet is not a string.

  • ValueError – Raised in case snippet file is invalid.

  • OSError – Raised in case snippet file location is not found.

validate_autoinstall_template_file_path(autoinstall: str, for_item: bool = True, new_autoinstall: bool = False) str[source]

Validate the automatic installation template’s relative file path.

Parameters
  • autoinstall – automatic installation template relative file path

  • for_item – enable/disable special handling for Item objects

  • new_autoinstall – when set to true new filenames are allowed

Returns

automatic installation template relative file path

Raises
  • TypeError – Raised in case autoinstall is not a string.

  • OSError – Raised in case template file not found.

  • ValueError – Raised in case template file is invalid.

write_autoinstall_snippet(file_path: str, data: str)[source]

Writes a snippet with the given content to the relative path under the snippet root directory.

Parameters
  • file_path – The relative path under the configured snippet base dir.

  • data – The snippet code.

write_autoinstall_template(file_path: str, data: str) bool[source]

Write an automatic OS installation template

Parameters
  • file_path – automatic installation template relative file path

  • data – automatic installation template content

8.5. cobbler.autoinstallgen module

Builds out filesystem trees/data based on the object tree. This is the code behind ‘cobbler sync’.

class cobbler.autoinstallgen.AutoInstallationGen(api)[source]

Bases: object

Handles conversion of internal state to the tftpboot tree layout

addAutoYaSTScript(document, type, source)[source]

Add scripts to an existing AutoYaST XML.

Parameters
  • document – The existing AutoYaST XML object.

  • type – The type of the script which should be added.

  • source – The source of the script. This should be ideally a string.

createAutoYaSTScript(document, script, name)[source]

This method attaches a script with a given name to an existing AutoYaST XML file.

Parameters
  • document – The existing AutoYaST XML file.

  • script – The script to attach.

  • name – The name of the script.

Returns

The AutoYaST file with the attached script.

generate_autoinstall(profile=None, system=None) str[source]

This is an internal method for generating an autoinstall config/script. Please use the generate_autoinstall_for_* methods. If you insist on using this mehtod please only supply a profile or a system, not both.

Parameters
  • profile – The profile to use for generating the autoinstall config/script.

  • system – The system to use for generating the autoinstall config/script. If both arguments are given, this wins.

Returns

The autoinstall script or configuration file as a string.

generate_autoinstall_for_profile(g) str[source]

Generate an autoinstall config or script for a profile.

Parameters

g – The Profile to generate the script/config for.

Returns

The generated output or an error message with a human readable description.

Raises

CX – Raised in case the profile references a missing distro.

generate_autoinstall_for_system(sys_name) str[source]

Generate an autoinstall config or script for a system.

Parameters

sys_name – The system name to generate an autoinstall script for.

Returns

The generated output or an error message with a human readable description.

Raises

CX – Raised in case the system references a missing profile.

generate_autoyast(profile=None, system=None, raw_data=None) str[source]

Generate auto installation information for SUSE distribution (AutoYaST XML file) for a specific system or general profile. Only a system OR profile can be supplied, NOT both.

Parameters
  • profile – The profile to generate the AutoYaST file for.

  • system – The system to generate the AutoYaST file for.

  • raw_data – The raw data which should be included in the profile.

Returns

The generated AutoYaST XML file.

generate_config_stanza(obj, is_profile: bool = True)[source]

Add in automatic to configure /etc/yum.repos.d on the remote system if the automatic installation file (template file) contains the magic $yum_config_stanza.

Parameters
  • obj – The profile or system to generate a generate a config stanza for.

  • is_profile – If the object is a profile. If False it is assumed that the object is a system.

Returns

The curl command to execute to get the configuration for a system or profile.

generate_repo_stanza(obj, is_profile: bool = True) str[source]

Automatically attaches yum repos to profiles/systems in automatic installation files (template files) that contain the magic $yum_repo_stanza variable. This includes repo objects as well as the yum repos that are part of split tree installs, whose data is stored with the distro (example: RHEL5 imports)

Parameters
  • obj – The profile or system to generate the repo stanza for.

  • is_profile – If True then obj is a profile, otherwise obj has to be a system. Otherwise this method will silently fail.

Returns

The string with the attached yum repos.

get_last_errors() list[source]

Returns the list of errors generated by the last template render action.

Returns

The list of error messages which are available. This may not only contain error messages related to generating autoinstallation configuration and scripts.

8.6. cobbler.cexceptions module

Custom exceptions for Cobbler

exception cobbler.cexceptions.CX(value, *args)[source]

Bases: CobblerException

This is a general exception which gets thrown often inside Cobbler.

exception cobbler.cexceptions.CobblerException(value, *args)[source]

Bases: Exception

This is the default Cobbler exception where all other exceptions are inheriting from.

8.7. cobbler.cli module

Command line interface for Cobbler.

class cobbler.cli.CobblerCLI(cliargs)[source]

Bases: object

Main CLI Class which contains the logic to communicate with the Cobbler Server.

check_setup() int[source]

Detect permissions and service accessibility problems and provide nicer error messages for them.

cleanup_fault_string(fault_str: str) str[source]

Make a remote exception nicely readable by humans so it’s not evident that is a remote fault. Users should not have to understand tracebacks.

Parameters

fault_str – The stacktrace to niceify.

Returns

A nicer error messsage.

direct_command(action_name: str)[source]

Process non-object based commands like “sync” and “hardlink”.

Parameters

action_name – The action to execute.

Returns

Depending on the action.

follow_task(task_id)[source]

Parse out this task’s specific messages from the global log

Parameters

task_id – The id of the task to follow.

get_direct_action(object_type, args) Optional[str][source]

If this is a general command, e.g. “cobbler hardlink”, return the action, like “hardlink”

Parameters
  • object_type – Must be None or None is returned.

  • args – The arg from the CLI.

Returns

The action key, “version” or None.

get_fields(object_type: str) list[source]

For a given name of an object type, return the FIELDS data structure.

Parameters

object_type – The object to return the fields of.

Returns

The fields or None

get_object_action(object_type, args) Optional[str][source]

If this is a CLI command about an object type, e.g. “cobbler distro add”, return the action, like “add”

Parameters
  • object_type – The object type.

  • args – The args from the CLI.

Returns

The action or None.

get_object_type(args) Optional[str][source]

If this is a CLI command about an object type, e.g. “cobbler distro add”, return the type, like “distro”

Parameters

args – The args from the CLI.

Returns

The object type or None

object_command(object_type: str, object_action: str) int[source]

Process object-based commands such as “distro add” or “profile rename”

Parameters
  • object_type – The object type to execute an action for.

  • object_action – The action to execute.

Returns

Depending on the object and action.

Raises
print_help() int[source]

Prints general-top level help, e.g. “cobbler –help” or “cobbler” or “cobbler command-does-not-exist”

print_object_help(object_type) int[source]

Prints the subcommands for a given object, e.g. “cobbler distro –help”

Parameters

object_type – The object type to print the help for.

print_task(task_id)[source]

Pretty print a task executed on the server. This prints to stdout.

Parameters

task_id – The id of the task to be pretty printed.

run(args) int[source]

Process the command line and do what the user asks.

Parameters

args – The args of the CLI

start_task(name: str, options: dict) str[source]

Start an asynchronous task in the background.

Parameters
  • name – “background_” % name function must exist in remote.py. This function will be called in a subthread.

  • options – Dictionary of options passed to the newly started thread

Returns

Id of the newly started task

cobbler.cli.add_options_from_fields(object_type, parser, fields, network_interface_fields, settings, object_action)[source]

Add options to the command line from the fields queried from the Cobbler server.

Parameters
  • object_type – The object type to add options for.

  • parser – The optparse instance to add options to.

  • fields – The list of fields to add options for.

  • network_interface_fields – The list of network interface fields if the object type is a system.

  • settings – Global cobbler settings as returned from CollectionManager.settings()

  • object_action – The object action to add options for. May be “add”, “edit”, “find”, “copy”, “rename”, “remove”. If none of these options is given then this method does nothing.

cobbler.cli.get_comma_separated_args(option: Option, opt_str, value: str, parser: OptionParser)[source]

Simple callback function to achieve option split with comma.

Reference for the method signature can be found at:

https://docs.python.org/3/library/optparse.html#defining-a-callback-option

Parameters
  • option – The option the callback is executed for

  • opt_str – Unused for this callback function. Would be the extended option if the user used the short version.

  • value – The value which should be split by comma.

  • parser – The optparse instance which the callback should be added to.

cobbler.cli.list_items(remote, otype)[source]

List all items of a given object type and print it to stdout.

Parameters
  • remote – The remote to use as the query-source.

  • otype – The object type to query.

cobbler.cli.main() int[source]

CLI entry point

cobbler.cli.n2s(data)[source]

Return spaces for None

Parameters

data – The data to check for.

Returns

The data itself or an empty string.

cobbler.cli.opt(options, k, defval='')[source]

Returns an option from an Optparse values instance

Parameters
  • options – The options object to search in.

  • k – The key which is in the optparse values instance.

  • defval – The default value to return.

Returns

The value for the specified key.

cobbler.cli.report_item(remote, otype: str, item=None, name=None)[source]

Return a single item in a given collection. Either this is an item object or this method searches for a name.

Parameters
  • remote – The remote to use as the query-source.

  • otype – The object type to query.

  • item – The item to display

  • name – The name to search for and display.

cobbler.cli.report_items(remote, otype: str)[source]

Return all items for a given collection.

Parameters
  • remote – The remote to use as the query-source. The remote to use as the query-source.

  • otype – The object type to query.

cobbler.cli.report_single_breed(name: str, items: dict) int[source]

Helper function which prints a single signature breed list to the terminal.

cobbler.cli.to_string_from_fields(item_dict, fields, interface_fields=None) str[source]

item_dict is a dictionary, fields is something like item_distro.FIELDS :param item_dict: The dictionary representation of a Cobbler item. :param fields: This is the list of fields a Cobbler item has. :param interface_fields: This is the list of fields from a network interface of a system. This is optional. :return: The string representation of a Cobbler item with all its values.

8.8. cobbler.cobblerd module

Cobbler daemon for logging remote syslog traffic during automatic installation

cobbler.cobblerd.core(cobbler_api: CobblerAPI)[source]

Starts Cobbler.

Parameters

cobbler_api – The cobbler_api instance which is used for this method.

cobbler.cobblerd.do_xmlrpc_rw(cobbler_api: CobblerAPI, port)[source]

This trys to bring up the Cobbler xmlrpc_api and restart it if it fails.

Parameters
  • cobbler_api – The cobbler_api instance which is used for this method.

  • port – The port where the xmlrpc api should run on.

cobbler.cobblerd.regen_ss_file()[source]

This is only used for Kerberos auth at the moment. It identifies XMLRPC requests from Apache that have already been cleared by Kerberos.

8.9. cobbler.configgen module

configgen.py: Generate configuration data.

module for generating configuration manifest using autoinstall_meta data, mgmtclasses, resources, and templates for a given system (hostname)

class cobbler.configgen.ConfigGen(cobbler_api, hostname: str)[source]

Bases: object

Generate configuration data for Cobbler’s management resources: repos, files and packages. Mainly used by Koan to configure systems.

gen_config_data() dict[source]

Generate configuration data for repos, files and packages.

Returns

A dict which has all config data in it.

Raises

CX – In case the package or file resource is not defined.

gen_config_data_for_koan() str[source]

Encode configuration data. Return json object for Koan.

Returns

A json string for koan.

get_cobbler_resource(resource_key: str) Union[list, str, dict][source]

Wrapper around Cobbler blender method

Parameters

resource_key – Not known what this actually is doing.

Returns

The blendered data. In some cases this is a str, in others it is a list or it might be a dict. In case the key is not found it will return an empty string.

resolve_resource_var(string_data: str) str[source]

Substitute variables in strings with data from the autoinstall_meta dictionary of the system.

Parameters

string_data – The template which will then be substituted by the variables in this class.

Returns

A str with the substituted data. If the host_vars are not of type dict then this will return an empty str.

Raises

KeyError – When the autoinstall_meta variable does not contain the required Keys in the dict.

8.10. cobbler.decorator module

This module provides decorators that are required for Cobbler to work as expected.

class cobbler.decorator.InheritableDictProperty(fget=None, fset=None, fdel=None, doc=None)[source]

Bases: InheritableProperty

This property is supposed to provide a way to identify properties in code that can be set to inherit.

class cobbler.decorator.InheritableProperty(fget=None, fset=None, fdel=None, doc=None)[source]

Bases: property

This property is supposed to provide a way to identify properties in code that can be set to inherit.

inheritable = True

8.11. cobbler.download_manager module

Cobbler DownloadManager

class cobbler.download_manager.DownloadManager[source]

Bases: object

download_file(url, dst, proxies=None, cert=None)[source]

Donwload a file from a URL and save it to any disc location.

Parameters
  • url – The URL the request.

  • dst – The destination file path.

  • proxies – Override the default Cobbler proxies.

  • cert – Override the default Cobbler certs.

urlread(url, proxies=None, cert=None)[source]

Read the content of a given URL and pass the requests. Response object to the caller.

Parameters
  • url – The URL the request.

  • proxies – Override the default Cobbler proxies.

  • cert – Override the default Cobbler certs.

Returns

The Python requests.Response object.

8.12. cobbler.enums module

This module is responsible for containing all enums we use in Cobbler. It should not be dependent upon any other module except the Python standard library.

class cobbler.enums.Archs(value)[source]

Bases: ConvertableEnum

This enum describes all system architectures which Cobbler is able to provision.

AARCH64 = 'aarch64'
ARM = 'arm'
I386 = 'i386'
IA64 = 'ia64'
PPC = 'ppc'
PPC64 = 'ppc64'
PPC64EL = 'ppc64el'
PPC64LE = 'ppc64le'
S390 = 's390'
S390X = 's390x'
X86_64 = 'x86_64'
class cobbler.enums.BaudRates(value)[source]

Bases: Enum

This enum describes all baud rates which are commonly used.

B0 = 0
B110 = 110
B115200 = 115200
B1200 = 1200
B128000 = 128000
B14400 = 14400
B19200 = 19200
B2400 = 2400
B256000 = 256000
B300 = 300
B38400 = 38400
B4800 = 4800
B57600 = 57600
B600 = 600
B9600 = 9600
DISABLED = -1
class cobbler.enums.ConvertableEnum(value)[source]

Bases: Enum

Abstract class to convert the enum via our convert method.

classmethod to_enum(value: Union[str, ConvertableEnum]) ConvertableEnum[source]

This method converts the chosen str to the corresponding enum type.

Parameters

value – str which contains the to be converted value.

Returns

The enum value.

Raises
  • TypeError – In case value was not of type str.

  • ValueError – In case value was not in the range of valid values.

class cobbler.enums.DHCP(value)[source]

Bases: Enum

An enumeration.

V4 = 4
V6 = 6
class cobbler.enums.EventStatus(value)[source]

Bases: ConvertableEnum

This enums describes the status an event can have. The cycle is the following:

“Running” –> “Complete” or “Failed”

COMPLETE = 'complete'

Shows that an event did complete as desired

FAILED = 'failed'

Shows that an event did not complete as expected

INFO = 'notification'

Default Event status

RUNNING = 'running'

Shows that an event is currently being processed by the server

class cobbler.enums.ImageTypes(value)[source]

Bases: ConvertableEnum

This enum represents all image types which Cobbler can manage.

DIRECT = 'direct'
ISO = 'iso'
MEMDISK = 'memdisk'
VIRT_CLONE = 'virt-clone'
class cobbler.enums.ItemTypes(value)[source]

Bases: ConvertableEnum

This enum represents all valid item types in Cobbler. If a new item type is created it must be added into this enum. Abstract base item types don’t have to be added here.

DISTRO = 'distro'

See Distro()

FILE = 'file'

See File()

IMAGE = 'image'

See Image()

MENU = 'menu'

See Menu()

MGMTCLASS = 'mgmtclass'

See Mgmtclass()

PACKAGE = 'package'

See Package()

PROFILE = 'profile'

See Profile()

REPO = 'repo'

See Repo()

SYSTEM = 'system'

See System()

class cobbler.enums.MirrorType(value)[source]

Bases: ConvertableEnum

This enum represents all mirror types which Cobbler can manage.

BASEURL = 'baseurl'
MIRRORLIST = 'mirrorlist'
class cobbler.enums.NetworkInterfaceType(value)[source]

Bases: Enum

This enum represents all interface types Cobbler is able to set up on a target host.

BMC = 6
BOND = 1
BONDED_BRIDGE_SLAVE = 5
BOND_SLAVE = 2
BRIDGE = 3
BRIDGE_SLAVE = 4
INFINIBAND = 7
NA = 0
class cobbler.enums.RepoArchs(value)[source]

Bases: ConvertableEnum

This enum describes all repository architectures Cobbler is able to serve in case the content of the repository is serving the same architecture.

AARCH64 = 'aarch64'
ARM = 'arm'
I386 = 'i386'
IA64 = 'ia64'
NOARCH = 'noarch'
NONE = 'none'
PPC = 'ppc'
PPC64 = 'ppc64'
PPC64EL = 'ppc64el'
PPC64LE = 'ppc64le'
S390 = 's390'
SRC = 'src'
X86_64 = 'x86_64'
class cobbler.enums.RepoBreeds(value)[source]

Bases: ConvertableEnum

This enum describes all repository breeds Cobbler is able to manage.

APT = 'apt'
NONE = 'none'
RHN = 'rhn'
RSYNC = 'rsync'
WGET = 'wget'
YUM = 'yum'
class cobbler.enums.ResourceAction(value)[source]

Bases: ConvertableEnum

This enum represents all actions a resource may execute.

CREATE = 'create'
REMOVE = 'remove'
class cobbler.enums.TlsRequireCert(value)[source]

Bases: ConvertableEnum

This enum represents all TLS validation server cert types which Cobbler can manage.

ALLOW = 'allow'
DEMAND = 'demand'
HARD = 'hard'
NEVER = 'never'
class cobbler.enums.VirtDiskDrivers(value)[source]

Bases: ConvertableEnum

This enum represents all virtual disk driver Cobbler can handle.

INHERITED = '<<inherit>>'
QCOW2 = 'qcow2'
QED = 'qed'
RAW = 'raw'
VDI = 'vdi'
VDMK = 'vdmk'
class cobbler.enums.VirtType(value)[source]

Bases: ConvertableEnum

This enum represents all known types of virtualization Cobbler is able to handle via Koan.

AUTO = 'auto'
INHERITED = '<<inherit>>'
KVM = 'kvm'
OPENVZ = 'openvz'
QEMU = 'qemu'
VMWARE = 'vmware'
VMWAREW = 'vmwarew'
XENFV = 'xenfv'
XENPV = 'xenpv'

8.13. cobbler.grub module

Module that contains GRUB related helper functionality.

cobbler.grub.parse_grub_remote_file(file_location: str) Optional[str][source]

Parses a URI which grub would try to load from the network.

Parameters

file_location – The location which grub would try to load from the network.

Returns

In case the URL could be parsed it is returned in the converted format. Otherwise None is returned.

Raises
  • TypeError – In case file_location is not of type str.

  • ValueError – In case the file location does not contain a valid IPv4 or IPv6 address

8.14. cobbler.manager module

Base class for modules.managers.* classes

class cobbler.manager.ManagerModule(api)[source]

Bases: object

Base class for Manager modules located in modules/manager/*.py

These are typically but not necessarily used to manage systemd services. Enabling can be done via settings manage_* (e.g. manage_dhcp) and restart_* (e.g. restart_dhcp). Different modules could manage the same functionality as dhcp can be managed via isc.py or dnsmasq.py (compare with /etc/cobbler/modules.py).

regen_ethers()[source]

ISC/BIND doesn’t use this. It is there for compatibility reasons with other managers.

restart_service() int[source]

Write module specific config files. E.g. dhcp manager would write /etc/dhcpd.conf here

sync() int[source]

This syncs the manager’s server (systemd service) with it’s new config files. Basically this restarts the service to apply the changes.

Returns

Integer return value of restart_service - 0 on success

static what()[source]

Static method to identify the manager module. Must be overwritten by the inheriting class

write_configs()[source]

Write module specific config files. E.g. dhcp manager would write /etc/dhcpd.conf here

8.15. cobbler.module_loader module

Module loader, adapted for Cobbler usage

class cobbler.module_loader.ModuleLoader(api, module_path: str = '')[source]

Bases: object

Class for dynamically loading Cobbler Plugins on startup

get_module_by_name(name: str)[source]

Get a module by its name. The category of the module is not needed.

Parameters

name – The name of the module.

Returns

The module asked by the function parameter.

get_module_from_file(category: str, field: str, fallback_module_name: Optional[str] = None)[source]

Get Python module, based on name defined in configuration file

Parameters
  • category – field category in configuration file

  • field – field in configuration file

  • fallback_module_name – default value used if category/field is not found in configuration file

Raises

CX – If unable to load Python module

Returns

A Python module.

get_module_name(category: str, field: str, fallback_module_name: Optional[str] = None) str[source]

Get module name from the settings.

Parameters
  • category – Field category in configuration file.

  • field – Field in configuration file

  • fallback_module_name – Default value used if category/field is not found in configuration file

Raises
  • FileNotFoundError – If unable to find configuration file.

  • ValueError – If the category does not exist or the field is empty.

  • CX – If the field could not be read and no fallback_module_name was given.

Returns

The name of the module.

get_modules_in_category(category: str) list[source]

Return all modules of a module category.

Parameters

category – The module category.

Returns

A list of all modules of that category. Returns an empty list if the Category does not exist.

load_modules()[source]

Load the modules from the path handed to the function into Cobbler.

Returns

Two dictionary’s with the dynamically loaded modules.

8.16. cobbler.power_manager module

Power management library. Encapsulate the logic to run power management commands so that the Cobbler user does not have to remember different power management tools syntaxes. This makes rebooting a system for OS installation much easier.

class cobbler.power_manager.PowerManager(api)[source]

Bases: object

Handles power management in systems

get_power_status(system, user: Optional[str] = None, password: Optional[str] = None) Optional[bool][source]

Get power status for a system that has power management configured.

Parameters
  • system (System) – Cobbler system

  • user – power management user

  • password – power management password

Returns

if system is powered on

power_off(system, user: Optional[str] = None, password: Optional[str] = None)[source]

Powers down a system that has power management configured.

Parameters
  • system (System) – Cobbler system

  • user – power management user

  • password – power management password

power_on(system, user: Optional[str] = None, password: Optional[str] = None)[source]

Powers up a system that has power management configured.

Parameters
  • system (System) – Cobbler system

  • user – power management user

  • password – power management password

reboot(system, user: Optional[str] = None, password: Optional[str] = None)[source]

Reboot a system that has power management configured.

Parameters
  • system (System) – Cobbler system

  • user – power management user

  • password – power management password

cobbler.power_manager.get_power_command(power_type: str) Optional[str][source]

Get power management command path

Parameters

power_type – power management type

Returns

power management command path

cobbler.power_manager.get_power_types() list[source]

Get possible power management types.

Returns

Possible power management types

cobbler.power_manager.validate_power_type(power_type: str)[source]

Check if a power management type is valid.

Parameters

power_type – Power management type.

Raises

CX – if power management type is invalid

8.17. cobbler.remote module

This module contains all code related to the Cobbler XML-RPC API.

class cobbler.remote.CobblerXMLRPCInterface(api)[source]

Bases: object

This is the interface used for all XMLRPC methods, for instance, as used by koan or CobblerWeb.

Most read-write operations require a token returned from “login”. Read operations do not.

auto_add_repos(token: str)[source]
Parameters

token – The API-token obtained via the login() method.

background_aclsetup(options: dict, token: str) str[source]

Get the acl configuration from the config and set the acls in the backgroud.

Parameters
  • options – Not known what this parameter does.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

The id of the task which was started.

background_buildiso(options: dict, token: str) str[source]

Generates an ISO in /var/www/cobbler/pub that can be used to install profiles without using PXE.

Parameters
  • options – This parameter does contain the options passed from the CLI or remote API who called this.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

The id of the task which was started.

Hardlink all files as a background task.

Parameters
  • options – Not known what this parameter does.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

The id of the task which was started.

background_import(options: dict, token: str) str[source]

Import an ISO image in the background.

Parameters
  • options – Not known what this parameter does.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

The id of the task which was started.

background_mkloaders(options: dict, token: str) str[source]
background_power_system(options: dict, token: str) str[source]

Power a system asynchronously in the background.

Parameters
  • options – Not known what this parameter does.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

The id of the task which was started.

background_replicate(options: dict, token: str) str[source]

Replicate Cobbler in the background to another Cobbler instance.

Parameters
  • options – Not known what this parameter does.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

The id of the task which was started.

background_reposync(options: dict, token: str) str[source]

Run a reposync in the background.

Parameters
  • options – Not known what this parameter does.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

The id of the task which was started.

background_signature_update(options: dict, token: str) str[source]

Run a signature update in the background.

Parameters
  • options – Not known what this parameter does.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

The id of the task which was started.

background_sync(options: dict, token: str) str[source]

Run a full Cobbler sync in the background.

Parameters
  • options – Possible options: verbose, dhcp, dns

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

The id of the task which was started.

background_syncsystems(options: dict, token: str) str[source]

Run a lite Cobbler sync in the background with only systems specified.

Parameters
  • options – Unknown what this parameter does.

  • token – The API-token obtained via the login() method.

Returns

The id of the task that was started.

background_validate_autoinstall_files(options: dict, token: str) str[source]

Validate all autoinstall files in the background.

Parameters
  • options – Not known what this parameter does.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

The id of the task which was started.

check(token: str) Union[None, list][source]

Returns a list of all the messages/warnings that are things that admin may want to correct about the configuration of the Cobbler server. This has nothing to do with “check_access” which is an auth/authz function in the XMLRPC API.

Parameters

token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

None or a list of things to address.

check_access(token: str, resource: str, arg1=None, arg2=None) int[source]

Check if the token which was provided has access.

Parameters
  • token – The token to check access for.

  • resource – The resource for which access shall be checked.

  • arg1 – Arguments to hand to the authorization provider.

  • arg2 – Arguments to hand to the authorization provider.

Returns

If the operation was successful return 1. If unsuccessful then return 0. Other codes may be returned if specified by the currently configured authorization module.

check_access_no_fail(token, resource, arg1=None, arg2=None) int[source]

This is called by the WUI to decide whether an element is editable or not. It differs form check_access in that it is supposed to /not/ log the access checks (TBA) and does not raise exceptions.

Parameters
  • token – The token to check access for.

  • resource – The resource for which access shall be checked.

  • arg1 – Arguments to hand to the authorization provider.

  • arg2 – Arguments to hand to the authorization provider.

Returns

1 if the object is editable or 0 otherwise.

clear_system_logs(object_id: str, token: str)[source]

clears console logs of a system

Parameters
  • object_id – The object id of the system to clear the logs of.

  • token – The API-token obtained via the login() method.

Returns

True if the operation succeeds.

copy_distro(object_id: str, newname: str, token=None)[source]

Copies a distribution and renames it afterwards.

Parameters
  • object_id – The object id of the item in question.

  • newname – The new name for the copied object.

  • token – The API-token obtained via the login() method.

Returns

True if the action succeeded.

copy_file(object_id, newname, token=None)[source]

Copies a file and rename it afterwards.

Parameters
  • object_id – The object id of the item in question.

  • newname – The new name for the copied object.

  • token – The API-token obtained via the login() method.

Returns

True if the action succeeded.

copy_image(object_id, newname, token=None)[source]

Copies an image and renames it afterwards.

Parameters
  • object_id – The object id of the item in question.

  • newname – The new name for the copied object.

  • token – The API-token obtained via the login() method.

Returns

True if the action succeeded.

copy_item(what: str, object_id: str, newname: str, token: str)[source]

Creates a new object that matches an existing object, as specified by an id.

Parameters
  • what – The item type which should be copied.

  • object_id – The object id of the item in question.

  • newname – The new name for the copied object.

  • token – The API-token obtained via the login() method.

Returns

True if the action succeeded.

copy_menu(object_id, newname, token=None)[source]

Copies a menu and rename it afterwards.

Parameters
  • object_id – The object id of the item in question.

  • newname – The new name for the copied object.

  • token – The API-token obtained via the login() method.

Returns

True if the action succeeded.

copy_mgmtclass(object_id, newname, token=None)[source]

Copies a management class and rename it afterwards.

Parameters
  • object_id – The object id of the item in question.

  • newname – The new name for the copied object.

  • token – The API-token obtained via the login() method.

Returns

True if the action succeeded.

copy_package(object_id, newname, token=None)[source]

Copies a package and rename it afterwards.

Parameters
  • object_id – The object id of the item in question.

  • newname – The new name for the copied object.

  • token – The API-token obtained via the login() method.

Returns

True if the action succeeded.

copy_profile(object_id, newname, token=None)[source]

Copies a profile and renames it afterwards.

Parameters
  • object_id – The object id of the item in question.

  • newname – The new name for the copied object.

  • token – The API-token obtained via the login() method.

Returns

True if the action succeeded.

copy_repo(object_id, newname, token=None)[source]

Copies a repository and renames it afterwards.

Parameters
  • object_id – The object id of the item in question.

  • newname – The new name for the copied object.

  • token – The API-token obtained via the login() method.

Returns

True if the action succeeded.

copy_system(object_id, newname, token=None)[source]

Copies a system and renames it afterwards.

Parameters
  • object_id – The object id of the item in question.

  • newname – The new name for the copied object.

  • token – The API-token obtained via the login() method.

Returns

True if the action succeeded.

disable_netboot(name, token=None, **rest) bool[source]

This is a feature used by the pxe_just_once support, see manpage. Sets system named “name” to no-longer PXE. Disabled by default as this requires public API access and is technically a read-write operation.

Parameters
  • name – The name of the system to disable netboot for.

  • token – The API-token obtained via the login() method.

  • rest – This parameter is unused.

Returns

A boolean indicated the success of the action.

dump_vars(item_uuid: str, formatted_output: bool = False, remove_dicts: bool = True)[source]

This function dumps all variables related to an object. The difference to the above mentioned function is that it accepts the item uid instead of the Python object itself.

See also

Logically identical to dump_vars()

extended_version(token=None, **rest)[source]

Returns the full dictionary of version information. See api.py for documentation.

Parameters
  • token – The API-token obtained via the login() method.

  • rest – This is dropped in this method since it is not needed here.

Returns

The extended version of Cobbler

find_distro(criteria: Optional[dict] = None, expand=False, resolved: bool = False, token=None, **rest)[source]

Find a distro matching certain criteria.

Parameters
  • criteria – The criteria a distribution needs to match.

  • expand – Not only get the names but also the complete object in form of a dict.

  • resolved – This only has an effect when expand = True. It returns the resolved representation of the object instead of the raw data.

  • token – The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

All distributions which have matched the criteria.

find_file(criteria: Optional[dict] = None, expand=False, resolved: bool = False, token=None, **rest)[source]

Find a file matching certain criteria.

Parameters
  • criteria – The criteria a distribution needs to match.

  • expand – Not only get the names but also the complete object in form of a dict.

  • resolved – This only has an effect when expand = True. It returns the resolved representation of the object instead of the raw data.

  • token – The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

All files which have matched the criteria.

find_image(criteria: Optional[dict] = None, expand=False, resolved: bool = False, token=None, **rest)[source]

Find an image matching certain criteria.

Parameters
  • criteria – The criteria a distribution needs to match.

  • expand – Not only get the names but also the complete object in form of a dict.

  • resolved – This only has an effect when expand = True. It returns the resolved representation of the object instead of the raw data.

  • token – The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

All images which have matched the criteria.

find_items(what: str, criteria: Optional[dict] = None, sort_field=None, expand: bool = True, resolved: bool = False) list[source]

Works like get_items but also accepts criteria as a dict to search on.

Example: { "name" : "*.example.org" }

Wildcards work as described by ‘pydoc fnmatch’.

Parameters
  • what – The object type to find.

  • criteria – The criteria an item needs to match.

  • sort_field – The field to sort the results after.

  • expand – Not only get the names but also the complete object in form of a dict.

  • resolved – This only has an effect when expand = True. It returns the resolved representation of the object instead of the raw data.

Returns

A list of dicts.

find_items_paged(what: str, criteria: Optional[dict] = None, sort_field: Optional[str] = None, page=1, items_per_page=25, resolved: bool = False, token: Optional[str] = None)[source]

Returns a list of dicts as with find_items but additionally supports returning just a portion of the total list, for instance in supporting a web app that wants to show a limited amount of items per page.

Parameters
  • what – The object type to find.

  • criteria – The criteria a distribution needs to match.

  • sort_field – The field to sort the results after.

  • page – The page to return

  • items_per_page – The number of items per page.

  • resolved – This only has an effect when expand = True. It returns the resolved representation of the object instead of the raw data.

  • token – The API-token obtained via the login() method.

Returns

The found items.

find_menu(criteria: Optional[dict] = None, expand=False, resolved: bool = False, token=None, **rest)[source]

Find a menu matching certain criteria.

Parameters
  • criteria – The criteria a distribution needs to match.

  • expand – Not only get the names but also the complete object in form of a dict.

  • resolved – This only has an effect when expand = True. It returns the resolved representation of the object instead of the raw data.

  • token – The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

All files which have matched the criteria.

find_mgmtclass(criteria: Optional[dict] = None, expand=False, resolved: bool = False, token=None, **rest)[source]

Find a management class matching certain criteria.

Parameters
  • criteria – The criteria a distribution needs to match.

  • expand – Not only get the names but also the complete object in form of a dict.

  • resolved – This only has an effect when expand = True. It returns the resolved representation of the object instead of the raw data.

  • token – The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

All management classes which have matched the criteria.

find_package(criteria: Optional[dict] = None, expand=False, resolved: bool = False, token=None, **rest)[source]

Find a package matching certain criteria.

Parameters
  • criteria – The criteria a distribution needs to match.

  • expand – Not only get the names but also the complete object in form of a dict.

  • resolved – This only has an effect when expand = True. It returns the resolved representation of the object instead of the raw data.

  • token – The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

All packages which have matched the criteria.

find_profile(criteria: Optional[dict] = None, expand=False, resolved: bool = False, token=None, **rest)[source]

Find a profile matching certain criteria.

Parameters
  • criteria – The criteria a distribution needs to match.

  • expand – Not only get the names but also the complete object in form of a dict.

  • resolved – This only has an effect when expand = True. It returns the resolved representation of the object instead of the raw data.

  • token – The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

All profiles which have matched the criteria.

find_repo(criteria: Optional[dict] = None, expand=False, resolved: bool = False, token=None, **rest)[source]

Find a repository matching certain criteria.

Parameters
  • criteria – The criteria a distribution needs to match.

  • expand – Not only get the names but also the complete object in form of a dict.

  • resolved – This only has an effect when expand = True. It returns the resolved representation of the object instead of the raw data.

  • token – The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

All repositories which have matched the criteria.

find_system(criteria: Optional[dict] = None, expand=False, resolved: bool = False, token=None, **rest)[source]

Find a system matching certain criteria.

Parameters
  • criteria – The criteria a distribution needs to match.

  • expand – Not only get the names but also the complete object in form of a dict.

  • resolved – This only has an effect when expand = True. It returns the resolved representation of the object instead of the raw data.

  • token – The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

All systems which have matched the criteria.

find_system_by_dns_name(dns_name)[source]

This is used by the puppet external nodes feature.

Parameters

dns_name – The dns name of the system. This should be the fqdn and not only the hostname.

Returns

All system information or an empty dict.

generate_autoinstall(profile=None, system=None, REMOTE_ADDR=None, REMOTE_MAC=None, **rest)[source]

Generate the autoinstallation file and return it.

Parameters
  • profile – The profile to generate the file for.

  • system – The system to generate the file for.

  • REMOTE_ADDR – This is dropped in this method since it is not needed here.

  • REMOTE_MAC – This is dropped in this method since it is not needed here.

  • rest – This is dropped in this method since it is not needed here.

Returns

The str representation of the file.

generate_bootcfg(profile: Optional[str] = None, system: Optional[str] = None, **rest) str[source]

This generates the bootcfg for a system which is related to a certain profile.

Parameters
  • profile – The profile which is associated to the system.

  • system – The system which the bootcfg should be generated for.

  • rest – This is dropped in this method since it is not needed here.

Returns

The generated bootcfg.

generate_ipxe(profile=None, image=None, system=None, **rest) str[source]

Generate the ipxe configuration.

Parameters
  • profile – The profile to generate iPXE config for.

  • image – The image to generate iPXE config for.

  • system – The system to generate iPXE config for.

  • rest – This is dropped in this method since it is not needed here.

Returns

The configuration as a str representation.

generate_profile_autoinstall(profile)[source]

Generate a profile autoinstallation.

Parameters

profile – The profile to generate the file for.

Returns

The str representation of the file.

generate_script(profile: Optional[str] = None, system: Optional[str] = None, name: str = '') str[source]

This generates the autoinstall script for a system or profile. Profile and System cannot be both given, if they are, Profile wins.

Parameters
  • profile – The profile name to generate the script for.

  • system – The system name to generate the script for.

  • name – Name of the generated script. Must only contain alphanumeric characters, dots and underscores.

Returns

Some generated script.

generate_system_autoinstall(system)[source]

Generate a system autoinstallation.

Parameters

system – The system to generate the file for.

Returns

The str representation of the file.

get_authn_module_name(token: str)[source]

Get the name of the currently used authentication module.

Parameters

token – The API-token obtained via the login() method. Cobbler token, obtained form login()

Returns

The name of the module.

get_autoinstall_snippets(token=None, **rest)[source]

Returns all the automatic OS installation templates’ snippets.

Parameters
  • token – The API-token obtained via the login() method.

  • rest – This is dropped in this method since it is not needed here.

Returns

A list with all snippets.

get_autoinstall_templates(token=None, **rest)[source]

Returns all of the automatic OS installation templates that are in use by the system.

Parameters
  • token – The API-token obtained via the login() method.

  • rest – This is dropped in this method since it is not needed here.

Returns

A list with all templates.

get_blended_data(profile=None, system=None)[source]

Combine all data which is available from a profile and system together and return it.

Deprecated since version 3.4.0: Please make use of the dump_vars endpoint.

Parameters
  • profile – The profile of the system.

  • system – The system for which the data should be rendered.

Returns

All values which could be blended together through the inheritance chain.

get_config_data(hostname: str) str[source]

Generate configuration data for the system specified by hostname.

Parameters

hostname – The hostname for what to get the config data of.

Returns

The config data as a json for Koan.

get_distro(name: str, flatten=False, resolved: bool = False, token=None, **rest)[source]

Get a distribution.

Parameters
  • name – The name of the distribution to get.

  • flatten – If the item should be flattened.

  • resolved – If this is True, Cobbler will resolve the values to its final form, rather than give you the objects raw value.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – Not used with this method currently.

Returns

The item or None.

get_distro_as_rendered(name: str, token: Optional[str] = None, **rest)[source]

Get distribution after passing through Cobbler’s inheritance engine.

Parameters
  • name – distro name

  • token – authentication token

  • rest – This is dropped in this method since it is not needed here.

Returns

Get a template rendered as a distribution.

get_distro_handle(name: str)[source]

Get a handle for a distribution which allows you to use the functions modify_* or save_* to manipulate it.

Parameters

name – The name of the item.

Returns

The handle of the desired object.

get_distros(page=None, results_per_page=None, token=None, **rest)[source]

This returns all distributions.

Parameters
  • page – This parameter is not used currently.

  • results_per_page – This parameter is not used currently.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

The list with all distros.

get_distros_since(mtime: float)[source]

Return all of the distro objects that have been modified after mtime.

Parameters

mtime – The time after which all items should be included. Everything before this will be excluded.

Returns

The list of items which were modified after mtime.

get_event_log(event_id: str) str[source]

Returns the contents of a task log. Events that are not task-based do not have logs.

Parameters

event_id – The event-id generated by Cobbler.

Returns

The event log or a ?.

get_events(for_user: str = '') dict[source]

Returns a dict(key=event id) = [ statetime, name, state, [read_by_who] ]

Parameters

for_user – (Optional) Filter events the user has not seen yet. If left unset, it will return all events.

Returns

A dictionary with all the events (or all filtered events).

get_file(name: str, flatten=False, resolved: bool = False, token=None, **rest)[source]

Get a file.

Parameters
  • name – The name of the file to get.

  • flatten – If the item should be flattened.

  • resolved – If this is True, Cobbler will resolve the values to its final form, rather than give you the objects raw value.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – Not used with this method currently.

Returns

The item or None.

get_file_as_rendered(name: str, token: Optional[str] = None, **rest)[source]

Get file after passing through Cobbler’s inheritance engine

Parameters
  • name – file name

  • token – authentication token

  • rest – This is dropped in this method since it is not needed here.

Returns

Get a template rendered as a file.

get_file_handle(name: str)[source]

Get a handle for a file which allows you to use the functions modify_* or save_* to manipulate it.

Parameters

name – The name of the item.

Returns

The handle of the desired object.

get_files(page=None, results_per_page=None, token=None, **rest)[source]

This returns all files.

Parameters
  • page – This parameter is not used currently.

  • results_per_page – This parameter is not used currently.

  • token – The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

The list of all files.

get_files_since(mtime: float)[source]

See documentation for get_distros_since

Parameters

mtime – The time after which all items should be included. Everything before this will be excluded.

Returns

The list of items which were modified after mtime.

get_image(name: str, flatten=False, resolved: bool = False, token=None, **rest)[source]

Get an image.

Parameters
  • name – The name of the image to get.

  • flatten – If the item should be flattened.

  • resolved – If this is True, Cobbler will resolve the values to its final form, rather than give you the objects raw value.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – Not used with this method currently.

Returns

The item or None.

get_image_as_rendered(name: str, token: Optional[str] = None, **rest)[source]

Get repository after passing through Cobbler’s inheritance engine.

Parameters
  • name – image name

  • token – authentication token

  • rest – This is dropped in this method since it is not needed here.

Returns

Get a template rendered as an image.

get_image_handle(name: str)[source]

Get a handle for an image which allows you to use the functions modify_* or save_* to manipulate it.

Parameters

name – The name of the item.

Returns

The handle of the desired object.

get_images(page=None, results_per_page=None, token=None, **rest)[source]

This returns all images.

Parameters
  • page – This parameter is not used currently.

  • results_per_page – This parameter is not used currently.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

The list of all images.

get_images_since(mtime: float)[source]

See documentation for get_distros_since

Parameters

mtime – The time after which all items should be included. Everything before this will be excluded.

Returns

The list of items which were modified after mtime.

get_item(what: str, name: str, flatten=False, resolved: bool = False)[source]

Returns a dict describing a given object.

Parameters
  • what – “distro”, “profile”, “system”, “image”, “repo”, etc

  • name – the object name to retrieve

  • flatten – reduce dicts to string representations (True/False)

  • resolved – If this is True, Cobbler will resolve the values to its final form, rather than give you the objects raw value.

Returns

The item or None.

get_item_handle(what: str, name: str)[source]

Given the name of an object (or other search parameters), return a reference (object id) that can be used with modify_* functions or save_* functions to manipulate that object.

Parameters
  • what – The collection where the item is living in.

  • name – The name of the item.

Returns

The handle of the desired object.

get_item_names(what: str)[source]

This is just like get_items, but transmits less data.

Parameters

what – is the name of a Cobbler object type, as described for get_item.

Returns

Returns a list of object names (keys) for the given object type.

get_item_resolved_value(item_uuid: str, attribute: str)[source]

See also

Logically identical to get_item_resolved_value()

get_items(what: str)[source]

Individual list elements are the same for get_item.

Parameters

what – is the name of a Cobbler object type, as described for get_item.

Returns

This returns a list of dicts.

get_menu(name: str, flatten: bool = False, resolved: bool = False, token=None, **rest)[source]

Get a menu.

Parameters
  • name – The name of the file to get.

  • flatten – If the item should be flattened.

  • resolved – If this is True, Cobbler will resolve the values to its final form, rather than give you the objects raw value.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – Not used with this method currently.

Returns

The item or None.

get_menu_as_rendered(name: str, token: Optional[str] = None, **rest)[source]

Get menu after passing through Cobbler’s inheritance engine

Parameters
  • name – Menu name

  • token – Authentication token

  • rest – This is dropped in this method since it is not needed here.

Returns

Get a template rendered as a file.

get_menu_handle(name: str)[source]

Get a handle for a menu which allows you to use the functions modify_* or save_* to manipulate it.

Parameters

name – The name of the item.

Returns

The handle of the desired object.

get_menus(page=None, results_per_page=None, token=None, **rest)[source]

This returns all menus.

Parameters
  • page – This parameter is not used currently.

  • results_per_page – This parameter is not used currently.

  • token – The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

The list of all files.

get_menus_since(mtime: float)[source]

See documentation for get_distros_since

Parameters

mtime – The time after which all items should be included. Everything before this will be excluded.

Returns

The list of items which were modified after mtime.

get_mgmtclass(name: str, flatten=False, resolved: bool = False, token=None, **rest)[source]

Get a management class.

Parameters
  • name – The name of the management class to get.

  • flatten – If the item should be flattened.

  • resolved – If this is True, Cobbler will resolve the values to its final form, rather than give you the objects raw value.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – Not used with this method currently.

Returns

The item or None.

get_mgmtclass_as_rendered(name: str, token: Optional[str] = None, **rest)[source]

Get management class after passing through Cobbler’s inheritance engine

Parameters
  • name – management class name

  • token – authentication token

  • rest – This is dropped in this method since it is not needed here.

Returns

Get a template rendered as a management class.

get_mgmtclass_handle(name: str)[source]

Get a handle for a management class which allows you to use the functions modify_* or save_* to manipulate it.

Parameters

name – The name of the item.

Returns

The handle of the desired object.

get_mgmtclasses(page=None, results_per_page=None, token=None, **rest)[source]

This returns all managementclasses.

Parameters
  • page – This parameter is not used currently.

  • results_per_page – This parameter is not used currently.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

The list of all managementclasses.

get_mgmtclasses_since(mtime: float)[source]

See documentation for get_distros_since

Parameters

mtime – The time after which all items should be included. Everything before this will be excluded.

Returns

The list of items which were modified after mtime.

get_package(name: str, flatten=False, resolved: bool = False, token=None, **rest)[source]

Get a package.

Parameters
  • name – The name of the package to get.

  • flatten – If the item should be flattened.

  • resolved – If this is True, Cobbler will resolve the values to its final form, rather than give you the objects raw value.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – Not used with this method currently.

Returns

The item or None.

get_package_as_rendered(name: str, token: Optional[str] = None, **rest)[source]

Get package after passing through Cobbler’s inheritance engine

Parameters
  • name – package name

  • token – authentication token

  • rest – This is dropped in this method since it is not needed here.

Returns

Get a template rendered as a package.

get_package_handle(name: str)[source]

Get a handle for a package which allows you to use the functions modify_* or save_* to manipulate it.

Parameters

name – The name of the item.

Returns

The handle of the desired object.

get_packages(page=None, results_per_page=None, token=None, **rest)[source]

This returns all packages.

Parameters
  • page – This parameter is not used currently.

  • results_per_page – This parameter is not used currently.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

The list of all packages tracked in Cobbler.

get_packages_since(mtime: float)[source]

See documentation for get_distros_since

Parameters

mtime – The time after which all items should be included. Everything before this will be excluded.

Returns

The list of items which were modified after mtime.

get_profile(name: str, flatten=False, resolved: bool = False, token=None, **rest)[source]

Get a profile.

Parameters
  • name – The name of the profile to get.

  • flatten – If the item should be flattened.

  • resolved – If this is True, Cobbler will resolve the values to its final form, rather than give you the objects raw value.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – Not used with this method currently.

Returns

The item or None.

get_profile_as_rendered(name: str, token: Optional[str] = None, **rest)[source]

Get profile after passing through Cobbler’s inheritance engine.

Parameters
  • name – profile name

  • token – authentication token

  • rest – This is dropped in this method since it is not needed here.

Returns

Get a template rendered as a profile.

get_profile_handle(name: str)[source]

Get a handle for a profile which allows you to use the functions modify_* or save_* to manipulate it.

Parameters

name – The name of the item.

Returns

The handle of the desired object.

get_profiles(page=None, results_per_page=None, token=None, **rest)[source]

This returns all profiles.

Parameters
  • page – This parameter is not used currently.

  • results_per_page – This parameter is not used currently.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

The list with all profiles.

get_profiles_since(mtime: float)[source]

See documentation for get_distros_since

Parameters

mtime – The time after which all items should be included. Everything before this will be excluded.

Returns

The list of items which were modified after mtime.

get_random_mac(virt_type='xenpv', token=None, **rest)[source]

Wrapper for utils.get_random_mac(). Used in the webui.

Parameters
  • virt_type – The type of the virtual machine.

  • token – The API-token obtained via the login() method. Auth token to authenticate against the api.

  • rest – This is dropped in this method since it is not needed here.

Returns

The random mac address which shall be used somewhere else.

get_repo(name: str, flatten=False, resolved: bool = False, token=None, **rest)[source]

Get a repository.

Parameters
  • name – The name of the repository to get.

  • flatten – If the item should be flattened.

  • resolved – If this is True, Cobbler will resolve the values to its final form, rather than give you the objects raw value.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – Not used with this method currently.

Returns

The item or None.

get_repo_as_rendered(name: str, token: Optional[str] = None, **rest)[source]

Get repository after passing through Cobbler’s inheritance engine.

Parameters
  • name – repository name

  • token – authentication token

  • rest – This is dropped in this method since it is not needed here.

Returns

Get a template rendered as a repository.

get_repo_config_for_profile(profile_name, **rest)[source]

Return the yum configuration a given profile should use to obtain all of it’s Cobbler associated repos.

Parameters
  • profile_name – The name of the profile for which the repository config should be looked up.

  • rest – This is dropped in this method since it is not needed here.

Returns

The repository configuration for the profile.

get_repo_config_for_system(system_name, **rest)[source]

Return the yum configuration a given profile should use to obtain all of it’s Cobbler associated repos.

Parameters
  • system_name – The name of the system for which the repository config should be looked up.

  • rest – This is dropped in this method since it is not needed here.

Returns

The repository configuration for the system.

get_repo_handle(name: str)[source]

Get a handle for a repository which allows you to use the functions modify_* or save_* to manipulate it.

Parameters

name – The name of the item.

Returns

The handle of the desired object.

get_repos(page=None, results_per_page=None, token=None, **rest)[source]

This returns all repositories.

Parameters
  • page – This parameter is not used currently.

  • results_per_page – This parameter is not used currently.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

The list of all repositories.

get_repos_compatible_with_profile(profile=None, token=None, **rest) list[source]

Get repos that can be used with a given profile name.

Parameters
  • profile – The profile to check for compatibility.

  • token – The API-token obtained via the login() method.

  • rest – This is dropped in this method since it is not needed here.

Returns

The list of compatible repositories.

get_repos_since(mtime: float)[source]

See documentation for get_distros_since

Parameters

mtime – The time after which all items should be included. Everything before this will be excluded.

Returns

The list of items which were modified after mtime.

get_settings(token=None, **rest) dict[source]

Return the contents of our settings file, which is a dict.

Parameters
  • token – The API-token obtained via the login() method.

  • rest – Unused parameter.

Returns

Get the settings which are currently in Cobbler present.

get_signatures(token=None, **rest) dict[source]

Return the contents of the API signatures

Parameters
  • token – The API-token obtained via the login() method.

  • rest – This is dropped in this method since it is not needed here.

Returns

Get the content of the currently loaded signatures file.

get_status(mode='normal', token=None, **rest)[source]

Returns the same information as cobbler status While a read-only operation, this requires a token because it’s potentially a fair amount of I/O

Parameters
  • mode – How the status should be presented.

  • token – The API-token obtained via the login() method. Auth token to authenticate against the api.

  • rest – This parameter is currently unused for this method.

Returns

The human or machine readable status of the status of Cobbler.

get_system(name: str, flatten=False, resolved: bool = False, token=None, **rest)[source]

Get a system.

Parameters
  • name – The name of the system to get.

  • flatten – If the item should be flattened.

  • resolved – If this is True, Cobbler will resolve the values to its final form, rather than give you the objects raw value.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – Not used with this method currently.

Returns

The item or None.

get_system_as_rendered(name: str, token: Optional[str] = None, **rest)[source]

Get profile after passing through Cobbler’s inheritance engine.

Parameters
  • name – system name

  • token – authentication token

  • rest – This is dropped in this method since it is not needed here.

Returns

Get a template rendered as a system.

get_system_handle(name: str)[source]

Get a handle for a system which allows you to use the functions modify_* or save_* to manipulate it.

Parameters

name – The name of the item.

Returns

The handle of the desired object.

get_systems(page=None, results_per_page=None, token=None, **rest)[source]

This returns all Systems.

Parameters
  • page – This parameter is not used currently.

  • results_per_page – This parameter is not used currently.

  • token – The API-token obtained via the login() method. The API-token obtained via the login() method.

  • rest – This parameter is not used currently.

Returns

The list of all systems.

get_systems_since(mtime: float)[source]

See documentation for get_distros_since

Parameters

mtime – The time after which all items should be included. Everything before this will be excluded.

Returns

The list of items which were modified after mtime.

get_task_status(event_id: str)[source]

Get the current status of the task.

Parameters

event_id – The unique id of the task.

Returns

The event status.

get_template_file_for_profile(profile_name, path, **rest)[source]

Return the templated file requested for this profile

Parameters
  • profile_name – The name of the profile to get the template file for.

  • path – The path to the template which is requested.

  • rest – This is dropped in this method since it is not needed here.

Returns

The template file as a str representation.

get_template_file_for_system(system_name, path, **rest)[source]

Return the templated file requested for this system

Parameters
  • system_name – The name of the system to get the template file for.

  • path – The path to the template which is requested.

  • rest – This is dropped in this method since it is not needed here.

Returns

The template file as a str representation.

get_user_from_token(token: str)[source]

Given a token returned from login, return the username that logged in with it.

Parameters

token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

The username if the token was valid.

Raises
  • CX – If the token supplied to the function is invalid.

  • ValueError – In case “token” did not fulfil the requirements to be a token.

get_valid_archs(token=None) list[source]

Return the list of valid architectures as read in from the distro signatures data

Parameters

token – The API-token obtained via the login() method.

Returns

Get a list of all valid architectures.

get_valid_breeds(token=None, **rest) list[source]

Return the list of valid breeds as read in from the distro signatures data

Parameters
  • token – The API-token obtained via the login() method.

  • rest – This is dropped in this method since it is not needed here.

Returns

All valid OS-Breeds which are present in Cobbler.

get_valid_distro_boot_loaders(distro_name: str, token=None)[source]

Return the list of valid boot loaders for the distro

Parameters
  • token – The API-token obtained via the login() method.

  • distro_name – The name of the distro for which the boot loaders should be looked up.

Returns

Get a list of all valid boot loaders.

get_valid_image_boot_loaders(image_name: str, token=None)[source]

Return the list of valid boot loaders for the image

Parameters
  • token – The API-token obtained via the login() method.

  • distro_name – The name of the image for which the boot loaders should be looked up.

Returns

Get a list of all valid boot loaders.

get_valid_os_versions(token=None, **rest) list[source]

Return the list of valid os_versions as read in from the distro signatures data

Parameters
  • token – The API-token obtained via the login() method.

  • rest – This is dropped in this method since it is not needed here.

Returns

Get all valid OS-Versions

get_valid_os_versions_for_breed(breed, token=None, **rest) list[source]

Return the list of valid os_versions for the given breed

Parameters
  • breed – The OS-Breed which is requested.

  • token – The API-token obtained via the login() method.

  • rest – This is dropped in this method since it is not needed here.

Returns

All valid OS-versions for a certain breed.

get_valid_profile_boot_loaders(profile_name, token=None)[source]

Return the list of valid boot loaders for the profile

Parameters
  • token – The API-token obtained via the login() method.

  • profile_name – The name of the profile for which the boot loaders should be looked up.

Returns

Get a list of all valid boot loaders.

get_valid_system_boot_loaders(system_name: str, token=None) List[str][source]

Return the list of valid boot loaders for the system

Parameters
  • token – The API-token obtained via the login() method.

  • system_name – The name of the system for which the boot loaders should be looked up.

Returns

Get a list of all valid boot loaders.get_valid_archs

has_item(what: str, name: str, token: Optional[str] = None)[source]

Returns True if a given collection has an item with a given name, otherwise returns False.

Parameters
  • what – The collection to search through.

  • name – The name of the item.

  • token – The API-token obtained via the login() method.

Returns

True if item was found, otherwise False.

input_boolean(value: Union[str, bool, int]) bool[source]

See also

input_boolean()

input_int(value: Union[str, int, float]) int[source]

See also

input_int()

input_string_or_dict(options: Union[str, list, dict], allow_multiples=True) Union[str, dict][source]
input_string_or_dict_no_inherit(options: Union[str, list, dict], allow_multiples=True) dict[source]
input_string_or_list(options: Optional[Union[str, list]]) Union[list, str][source]
input_string_or_list_no_inherit(options: Optional[Union[str, list]]) list[source]
is_autoinstall_in_use(ai, token=None, **rest)[source]

Check if the autoinstall for a system is in use.

Parameters
  • ai – The name of the system which could potentially be in autoinstall mode.

  • token – The API-token obtained via the login() method.

  • rest – This is dropped in this method since it is not needed here.

Returns

True if this is the case, otherwise False.

last_modified_time(token=None) float[source]

Return the time of the last modification to any object. Used to verify from a calling application that no Cobbler objects have changed since last check. This method is implemented in the module api under the same name.

Parameters

token – The API-token obtained via the login() method. The API-token obtained via the login() method.

Returns

0 if there is no file where the information required for this method is saved.

login(login_user: str, login_password: str) str[source]

Takes a username and password, validates it, and if successful returns a random login token which must be used on subsequent method calls. The token will time out after a set interval if not used. Re-logging in permitted.

Parameters
  • login_user – The username which is used to authenticate at Cobbler.

  • login_password – The password which is used to authenticate at Cobbler.

Returns

The token which can be used further on.

logout(token: str) bool[source]

Retires a token ahead of the timeout.

Parameters

token – The API-token obtained via the login() method. Cobbler token, obtained form login()

Returns

if operation was successful or not

modify_distro(object_id, attribute, arg, token: str)[source]

Modify a single attribute of a distribution.

Parameters
  • object_id – The id of the object which shall be modified.

  • attribute – The attribute name which shall be edited.

  • arg – The new value for the argument.

  • token – The API-token obtained via the login() method.

Returns

True if the action was successful. Otherwise False.

modify_file(object_id, attribute, arg, token: str)[source]

Modify a single attribute of a file.

Parameters
  • object_id – The id of the object which shall be modified.

  • attribute – The attribute name which shall be edited.

  • arg – The new value for the argument.

  • token – The API-token obtained via the login() method.

Returns

True if the action was successful. Otherwise False.

modify_image(object_id, attribute, arg, token: str)[source]

Modify a single attribute of an image.

Parameters
  • object_id – The id of the object which shall be modified.

  • attribute – The attribute name which shall be edited.

  • arg – The new value for the argument.

  • token – The API-token obtained via the login() method.

Returns

True if the action was successful. Otherwise False.

modify_item(what: str, object_id, attribute, arg, token: str) bool[source]

Adjusts the value of a given field, specified by ‘what’ on a given object id. Allows modification of certain attributes on newly created or existing distro object handle.

Parameters
  • what – The type of object to modify.1

  • object_id – The id of the object which shall be modified.

  • attribute – The attribute name which shall be edited.

  • arg – The new value for the argument.

  • token – The API-token obtained via the login() method.

Returns

True if the action was successful. Otherwise False.

modify_menu(object_id, attribute, arg, token: str)[source]

Modify a single attribute of a menu.

Parameters
  • object_id – The id of the object which shall be modified.

  • attribute – The attribute name which shall be edited.

  • arg – The new value for the argument.

  • token – The API-token obtained via the login() method.

Returns

True if the action was successful. Otherwise False.

modify_mgmtclass(object_id, attribute, arg, token: str)[source]

Modify a single attribute of a managementclass.

Parameters
  • object_id – The id of the object which shall be modified.

  • attribute – The attribute name which shall be edited.

  • arg – The new value for the argument.

  • token – The API-token obtained via the login() method.

Returns

True if the action was successful. Otherwise False.

modify