1OZ-CUSTOMIZE(1) General Commands Manual OZ-CUSTOMIZE(1)
2
3
4
6 oz-customize - tool to automatically modify installed operating system
7 files
8
9
11 oz-customize [OPTIONS] <tdl-file> <libvirt-xml-file>
12
13
15 This is a tool to modify already installed operating systems. Modifi‐
16 cations typically involve installing additional packages. This program
17 can be used as a counterpart to oz-install, though it does not have to
18 be used in conjunction.
19
20 Note that oz-customize does the actual customization using a combina‐
21 tion of KVM and libvirt, so both of these must be available (and work‐
22 ing) for oz-customize to have a chance to succeed.
23
24
26 -c <config>
27 Get the configuration from config file config, instead of the
28 default /etc/oz/oz.cfg. If neither one exists, Oz will use sen‐
29 sible defaults. The config file is in standard ini format; for
30 an explanation of the sections and keys, see the CONFIGURATION
31 FILE section.
32
33 -d <loglevel>
34 Turn on debugging output to level loglevel. The log levels are:
35
36 0 - errors only (this is the default)
37
38 1 - errors and warnings
39
40 2 - errors, warnings, and information
41
42 3 - all messages
43
44 4 - all messages, prepended with the level and classname
45
46 -h Print a short help message.
47
48
50 The Oz configuration file is in standard INI format with several sec‐
51 tions. If any section or configuration key is missing, Oz will use a
52 sensible default. For true/false configuration keys, the values of
53 "true", "True", "yes", or "Yes" can be used to turn the option on, and
54 "false", "False", "no", or "No" can be used to turn the behavior off.
55 The configuration file should have the following form:
56
57
58 [paths]
59 output_dir = /var/lib/libvirt/images
60 data_dir = /var/lib/oz
61 screenshot_dir = .
62
63 [libvirt]
64 uri = qemu:///system
65 type = kvm
66 bridge_name = virbr0
67
68 [cache]
69 original_media = yes
70 modified_media = no
71 jeos = no
72
73 The paths section defines the paths that Oz will use for storing data.
74 The output_dir key describes where to store the images after they are
75 built, and the data_dir key describes where to cache install media and
76 use temporary storage. Both locations must have a decent amount of
77 free disk space in order for Oz to work properly. The screenshot_dir
78 key describes where to store screenshots of failed installs.
79
80 The libvirt section allows some manipulation of how Oz uses libvirt.
81 The uri key describes the libvirt URI to use to do the guest installa‐
82 tion. The type key defines what type of virtualization to use. The
83 bridge_name key defines which bridge Oz should place the guests that it
84 launches on.
85
86 The cache section allows some manipulation of how Oz caches data. The
87 caching of data in Oz is a tradeoff between installation time and stor‐
88 age space. The original_media key tells Oz to cache the original
89 installation media so that it does not have to download it the next
90 time an install for the same operating system is requested. The modi‐
91 fied_media key tells Oz to cache the oz-modified installation media so
92 that it does not have to download and modify it the next time an
93 install for the same operating system is requested. The jeos key tells
94 Oz to cache the installed operating system after installation. This
95 can significantly speed up subsequent installation of the same operat‐
96 ing system, with the additional downside of the operating system get‐
97 ting out-of-date with respect to security updates. Use with care.
98
99
101 oz-generate-icicle(1), oz-install(1), oz-cleanup-cache(1)
102
103
105 Chris Lalancette <clalance@redhat.com>
106
107
108
109oz-customize Dec 2010 OZ-CUSTOMIZE(1)