Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

446 lines (376 sloc) 17.554 kb
Base class for any serializable list of things...
Copyright 2006-2009, Red Hat, Inc and Others
Michael DeHaan <michael.dehaan AT gmail>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 USA
import exceptions
from cexceptions import *
import utils
import glob
import time
import random
import os
import action_litesync
import item_system
import item_profile
import item_distro
import item_repo
import item_image
import item_mgmtclass
import item_package
import item_file
from utils import _
class Collection:
def __init__(self,config):
self.config = config
self.api = self.config.api
self.lite_sync = None
def factory_produce(self,config,seed_data):
Must override in subclass. Factory_produce returns an Item object
from datastructure seed_data
raise exceptions.NotImplementedError
def clear(self):
Forget about objects in the collection.
self.listing = {}
def get(self, name):
Return object with name in the collection
return self.listing.get(name.lower(), None)
def find(self, name=None, return_list=False, no_errors=False, **kargs):
Return first object in the collection that maches all item='value'
pairs passed, else return None if no objects can be found.
When return_list is set, can also return a list. Empty list
would be returned instead of None in that case.
matches = []
# support the old style innovation without kwargs
if name is not None:
kargs["name"] = name
kargs = self.__rekey(kargs)
# no arguments is an error, so we don't return a false match
if len(kargs) == 0:
raise CX(_("calling find with no arguments"))
# performance: if the only key is name we can skip the whole loop
if len(kargs) == 1 and kargs.has_key("name") and not return_list:
return self.listing.get(kargs["name"].lower(), None)
for (name, obj) in self.listing.iteritems():
if obj.find_match(kargs, no_errors=no_errors):
if not return_list:
if len(matches) == 0:
return None
return matches[0]
return matches
'kopts' : 'kernel_options',
'kopts_post' : 'kernel_options_post',
'ksmeta' : 'ks_meta',
'inherit' : 'parent',
'ip' : 'ip_address',
'mac' : 'mac_address',
'virt-auto-boot' : 'virt_auto_boot',
'virt-file-size' : 'virt_file_size',
'virt-disk-driver': 'virt_disk_driver',
'virt-ram' : 'virt_ram',
'virt-path' : 'virt_path',
'virt-type' : 'virt_type',
'virt-bridge' : 'virt_bridge',
'virt-cpus' : 'virt_cpus',
'virt-host' : 'virt_host',
'virt-group' : 'virt_group',
'dhcp-tag' : 'dhcp_tag',
'netboot-enabled' : 'netboot_enabled',
'ldap-enabled' : 'ldap_enabled',
'monit-enabled' : 'monit_enabled'
def __rekey(self,hash):
Find calls from the command line ("cobbler system find")
don't always match with the keys from the datastructs and this
makes them both line up without breaking compatibility with either.
Thankfully we don't have a LOT to remap.
newhash = {}
for x in hash.keys():
if self.SEARCH_REKEY.has_key(x):
newkey = self.SEARCH_REKEY[x]
newhash[newkey] = hash[x]
newhash[x] = hash[x]
return newhash
def to_datastruct(self):
Serialize the collection
datastruct = [x.to_datastruct() for x in self.listing.values()]
return datastruct
def from_datastruct(self,datastruct):
if datastruct is None:
for seed_data in datastruct:
item = self.factory_produce(self.config,seed_data)
def copy(self,ref,newname,logger=None):
ref = ref.make_clone() = newname
ref.uid = self.config.generate_uid()
ref.ctime = 0
if ref.COLLECTION_TYPE == "system":
# this should only happen for systems
for iname in ref.interfaces.keys():
# clear all these out to avoid DHCP/DNS conflicts
return self.add(ref,save=True,with_copy=True,with_triggers=True,with_sync=True,check_for_duplicate_names=True,check_for_duplicate_netinfo=False)
def rename(self,ref,newname,with_sync=True,with_triggers=True,logger=None):
Allows an object "ref" to be given a newname without affecting the rest
of the object tree.
# Nothing to do when it is the same name
if newname ==
return True
# make a copy of the object, but give it a new name.
oldname =
newref = ref.make_clone()
self.add(newref, with_triggers=with_triggers,save=True)
# for a repo, rename the mirror directory
if ref.COLLECTION_TYPE == "repo":
path = "/var/www/cobbler/repo_mirror/%s" %
if os.path.exists(path):
newpath = "/var/www/cobbler/repo_mirror/%s" %
os.renames(path, newpath)
# for a distro, rename the mirror and references to it
if ref.COLLECTION_TYPE == 'distro':
path = "/var/www/cobbler/ks_mirror/%s" %
if os.path.exists(path):
newpath = "/var/www/cobbler/ks_mirror/%s" %
os.renames(path, newpath)
# update any reference to this path ...
distros = self.api.distros()
for d in distros:
if d.kernel.find(path) == 0:
d.set_kernel(d.kernel.replace(path, newpath))
d.set_initrd(d.initrd.replace(path, newpath))
self.config.serialize_item(self, d)
# now descend to any direct ancestors and point them at the new object allowing
# the original object to be removed without orphanage. Direct ancestors
# will either be profiles or systems. Note that we do have to care as
# set_parent is only really meaningful for subprofiles. We ideally want a more
# generic set_parent.
kids = ref.get_children()
for k in kids:
if k.COLLECTION_TYPE == "distro":
raise CX(_("internal error, not expected to have distro child objects"))
elif k.COLLECTION_TYPE == "profile":
if k.parent != "":
self.api.profiles().add(k, save=True, with_sync=with_sync, with_triggers=with_triggers)
elif k.COLLECTION_TYPE == "system":
k.set_profile(newname), save=True, with_sync=with_sync, with_triggers=with_triggers)
elif k.COLLECTION_TYPE == "repo":
raise CX(_("internal error, not expected to have repo child objects"))
raise CX(_("internal error, unknown child type (%s), cannot finish rename" % k.COLLECTION_TYPE))
# now delete the old version
self.remove(oldname, with_delete=True, with_triggers=with_triggers)
return True
def add(self,ref,save=False,with_copy=False,with_triggers=True,with_sync=True,quick_pxe_update=False,check_for_duplicate_names=False,check_for_duplicate_netinfo=False,logger=None):
Add an object to the collection, if it's valid. Returns True
if the object was added to the collection. Returns False if the
object specified by ref deems itself invalid (and therefore
won't be added to the collection).
with_copy is a bit of a misnomer, but lots of internal add operations
can run with "with_copy" as False. True means a real final commit, as if
entered from the command line (or basically, by a user).
With with_copy as False, the particular add call might just be being run
during deserialization, in which case extra semantics around the add don't really apply.
So, in that case, don't run any triggers and don't deal with any actual files.
if ref is None or is None:
return False
except CX, error:
return False
if ref.uid == '':
ref.uid = self.config.generate_uid()
if save is True:
now = time.time()
if ref.ctime == 0:
ref.ctime = now
ref.mtime = now
if self.lite_sync is None:
self.lite_sync = action_litesync.BootLiteSync(self.config, logger=logger)
# migration path for old API parameter that I've renamed.
if with_copy and not save:
save = with_copy
if not save:
# for people that aren't quite aware of the API
# if not saving the object, you can't run these features
with_triggers = False
with_sync = False
# Avoid adding objects to the collection
# if an object of the same/ip/mac already exists.
if ref.COLLECTION_TYPE != self.collection_type():
raise CX(_("API error: storing wrong data type in collection"))
if not save:
# don't need to run triggers, so add it already ...
self.listing[] = ref
# perform filesystem operations
if save:
# failure of a pre trigger will prevent the object from being added
if with_triggers:
utils.run_triggers(self.api, ref,"/var/lib/cobbler/triggers/add/%s/pre/*" % self.collection_type(), [], logger)
self.listing[] = ref
# save just this item if possible, if not, save
# the whole collection
self.config.serialize_item(self, ref)
if with_sync:
if isinstance(ref, item_system.System):
elif isinstance(ref, item_profile.Profile):
elif isinstance(ref, item_distro.Distro):
elif isinstance(ref, item_image.Image):
elif isinstance(ref, item_repo.Repo):
elif isinstance(ref, item_mgmtclass.Mgmtclass):
elif isinstance(ref, item_package.Package):
elif isinstance(ref, item_file.File):
print _("Internal error. Object type not recognized: %s") % type(ref)
if not with_sync and quick_pxe_update:
if isinstance(ref, item_system.System):
# save the tree, so if neccessary, scripts can examine it.
if with_triggers:
utils.run_triggers(self.api, ref, "/var/lib/cobbler/triggers/change/*", [], logger)
utils.run_triggers(self.api, ref,"/var/lib/cobbler/triggers/add/%s/post/*" % self.collection_type(), [], logger)
# update children cache in parent object
parent = ref.get_parent()
if parent != None:
parent.children[] = ref
return True
def __duplication_checks(self,ref,check_for_duplicate_names,check_for_duplicate_netinfo):
Prevents adding objects with the same name.
Prevents adding or editing to provide the same IP, or MAC.
Enforcement is based on whether the API caller requests it.
# always protect against duplicate names
if check_for_duplicate_names:
match = None
if isinstance(ref, item_system.System):
match = self.api.find_system(
elif isinstance(ref, item_profile.Profile):
match = self.api.find_profile(
elif isinstance(ref, item_distro.Distro):
match = self.api.find_distro(
elif isinstance(ref, item_repo.Repo):
match = self.api.find_repo(
elif isinstance(ref, item_image.Image):
match = self.api.find_image(
elif isinstance(ref, item_mgmtclass.Mgmtclass):
match = self.api.find_mgmtclass(
elif isinstance(ref, item_package.Package):
match = self.api.find_package(
elif isinstance(ref, item_file.File):
match = self.api.find_file(
raise CX("internal error, unknown object type")
if match:
raise CX(_("An object already exists with that name. Try 'edit'?"))
# the duplicate mac/ip checks can be disabled.
if not check_for_duplicate_netinfo:
if isinstance(ref, item_system.System):
for (name, intf) in ref.interfaces.iteritems():
match_ip = []
match_mac = []
match_hosts = []
input_mac = intf["mac_address"]
input_ip = intf["ip_address"]
input_dns = intf["dns_name"]
if not self.api.settings().allow_duplicate_macs and input_mac is not None and input_mac != "":
match_mac = self.api.find_system(mac_address=input_mac,return_list=True)
if not self.api.settings().allow_duplicate_ips and input_ip is not None and input_ip != "":
match_ip = self.api.find_system(ip_address=input_ip,return_list=True)
# it's ok to conflict with your own net info.
if not self.api.settings().allow_duplicate_hostnames and input_dns is not None and input_dns != "":
match_hosts = self.api.find_system(dns_name=input_dns,return_list=True)
for x in match_mac:
if !=
raise CX(_("Can't save system %s. The MAC address (%s) is already used by system %s (%s)") % (, intf["mac_address"],, name))
for x in match_ip:
if !=
raise CX(_("Can't save system %s. The IP address (%s) is already used by system %s (%s)") % (, intf["ip_address"],, name))
for x in match_hosts:
if !=
raise CX(_("Can't save system %s. The dns name (%s) is already used by system %s (%s)") % (, intf["dns_name"],, name))
def printable(self):
Creates a printable representation of the collection suitable
for reading by humans or parsing from scripts. Actually scripts
would be better off reading the YAML in the config files directly.
values = self.listing.values()[:] # copy the values
values.sort() # sort the copy (2.3 fix)
results = []
for i,v in enumerate(values):
if len(values) > 0:
return "\n\n".join(results)
return _("No objects found")
def __iter__(self):
Iterator for the collection. Allows list comprehensions, etc
for a in self.listing.values():
yield a
def __len__(self):
Returns size of the collection
return len(self.listing.values())
def collection_type(self):
Returns the string key for the name of the collection (for use in messages for humans)
return exceptions.NotImplementedError
Jump to Line
Something went wrong with that request. Please try again.