1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
|
"""
A cobbler distribution. A distribution is a kernel, and initrd, and potentially
some kernel options.
Copyright 2006-2008, Red Hat, Inc
Michael DeHaan <mdehaan@redhat.com>
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
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
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 utils
import item
import weakref
import os
import codes
from cexceptions import *
from utils import _
class Distro(item.Item):
TYPE_NAME = _("distro")
COLLECTION_TYPE = "distro"
def clear(self,is_subobject=False):
"""
Reset this object.
"""
self.name = None
self.owners = self.settings.default_ownership
self.kernel = (None, '<<inherit>>')[is_subobject]
self.initrd = (None, '<<inherit>>')[is_subobject]
self.kernel_options = ({}, '<<inherit>>')[is_subobject]
self.kernel_options_post = ({}, '<<inherit>>')[is_subobject]
self.ks_meta = ({}, '<<inherit>>')[is_subobject]
self.arch = ('i386', '<<inherit>>')[is_subobject]
self.breed = ('redhat', '<<inherit>>')[is_subobject]
self.os_version = ('', '<<inherit>>')[is_subobject]
self.source_repos = ([], '<<inherit>>')[is_subobject]
self.depth = 0
def make_clone(self):
ds = self.to_datastruct()
cloned = Distro(self.config)
cloned.from_datastruct(ds)
return cloned
def get_parent(self):
"""
Return object next highest up the tree.
NOTE: conceptually there is no need for subdistros
"""
return None
def from_datastruct(self,seed_data):
"""
Modify this object to take on values in seed_data
"""
self.parent = self.load_item(seed_data,'parent')
self.name = self.load_item(seed_data,'name')
self.owners = self.load_item(seed_data,'owners',self.settings.default_ownership)
self.kernel = self.load_item(seed_data,'kernel')
self.initrd = self.load_item(seed_data,'initrd')
self.kernel_options = self.load_item(seed_data,'kernel_options')
self.kernel_options_post = self.load_item(seed_data,'kernel_options_post')
self.ks_meta = self.load_item(seed_data,'ks_meta')
self.arch = self.load_item(seed_data,'arch','i386')
self.breed = self.load_item(seed_data,'breed','redhat')
self.os_version = self.load_item(seed_data,'os_version','')
self.source_repos = self.load_item(seed_data,'source_repos',[])
self.depth = self.load_item(seed_data,'depth',0)
# backwards compatibility enforcement
self.set_arch(self.arch)
if self.kernel_options != "<<inherit>>" and type(self.kernel_options) != dict:
self.set_kernel_options(self.kernel_options)
if self.kernel_options_post != "<<inherit>>" and type(self.kernel_options_post) != dict:
self.set_kernel_options_post(self.kernel_options_post)
if self.ks_meta != "<<inherit>>" and type(self.ks_meta) != dict:
self.set_ksmeta(self.ks_meta)
self.set_owners(self.owners)
return self
def set_kernel(self,kernel):
"""
Specifies a kernel. The kernel parameter is a full path, a filename
in the configured kernel directory (set in /etc/cobbler.conf) or a
directory path that would contain a selectable kernel. Kernel
naming conventions are checked, see docs in the utils module
for find_kernel.
"""
if utils.find_kernel(kernel):
self.kernel = kernel
return True
raise CX(_("kernel not found"))
def set_breed(self, breed):
return utils.set_breed(breed)
def set_os_version(self, os_version):
return utils.set_os_version(os_version)
def set_initrd(self,initrd):
"""
Specifies an initrd image. Path search works as in set_kernel.
File must be named appropriately.
"""
if utils.find_initrd(initrd):
self.initrd = initrd
return True
raise CX(_("initrd not found"))
def set_source_repos(self, repos):
"""
A list of http:// URLs on the cobbler server that point to
yum configuration files that can be used to
install core packages. Use by cobbler import only.
"""
self.source_repos = repos
def set_arch(self,arch):
"""
The field is mainly relevant to PXE provisioning.
Should someone have Itanium machines on a network, having
syslinux (pxelinux.0) be the only option in the config file causes
problems.
Using an alternative distro type allows for dhcpd.conf templating
to "do the right thing" with those systems -- this also relates to
bootloader configuration files which have different syntax for different
distro types (because of the bootloaders).
This field is named "arch" because mainly on Linux, we only care about
the architecture, though if (in the future) new provisioning types
are added, an arch value might be something like "bsd_x86".
Update: (7/2008) this is now used to build fake PXE trees for s390x also
"""
return utils.set_arch(self,arch)
def is_valid(self):
"""
A distro requires that the kernel and initrd be set. All
other variables are optional.
"""
# NOTE: this code does not support inheritable distros at this time.
# this is by design because inheritable distros do not make sense.
if self.name is None:
raise CX(_("name is required"))
if self.kernel is None:
raise CX(_("kernel is required"))
if self.initrd is None:
raise CX(_("initrd is required"))
return True
def to_datastruct(self):
"""
Return a serializable datastructure representation of this object.
"""
return {
'name' : self.name,
'kernel' : self.kernel,
'initrd' : self.initrd,
'kernel_options' : self.kernel_options,
'kernel_options_post' : self.kernel_options_post,
'ks_meta' : self.ks_meta,
'arch' : self.arch,
'breed' : self.breed,
'os_version' : self.os_version,
'source_repos' : self.source_repos,
'parent' : self.parent,
'depth' : self.depth,
'owners' : self.owners
}
def printable(self):
"""
Human-readable representation.
"""
kstr = utils.find_kernel(self.kernel)
istr = utils.find_initrd(self.initrd)
buf = _("distro : %s\n") % self.name
buf = buf + _("breed : %s\n") % self.breed
buf = buf + _("os version : %s\n") % self.os_version
buf = buf + _("architecture : %s\n") % self.arch
buf = buf + _("initrd : %s\n") % istr
buf = buf + _("kernel : %s\n") % kstr
buf = buf + _("kernel options : %s\n") % self.kernel_options
buf = buf + _("post kernel options : %s\n") % self.kernel_options_post
buf = buf + _("ks metadata : %s\n") % self.ks_meta
buf = buf + _("owners : %s\n") % self.owners
return buf
def remote_methods(self):
return {
'name' : self.set_name,
'kernel' : self.set_kernel,
'initrd' : self.set_initrd,
'kopts' : self.set_kernel_options,
'kopts-post' : self.set_kernel_options_post,
'arch' : self.set_arch,
'ksmeta' : self.set_ksmeta,
'breed' : self.set_breed,
'os-version' : self.set_os_version,
'owners' : self.set_owners
}
|
