1OZ-CLEANUP-CACHE(1) General Commands Manual OZ-CLEANUP-CACHE(1)
2
3
4
6 oz-cleanup-cache - tool to remove cached oz data
7
8
10 oz-cleanup-cache [OPTIONS]
11
12
14 This is a tool to remove all of the data that Oz has cached. Because
15 the data that Oz caches can grow fairly large, it may be worthwhile to
16 periodically clean it up. This is a simple script to do so. Note that
17 if you do cleanup the Oz cache, subsequent operating system installs
18 will be slower since Oz will have to re-download the installation
19 media.
20
21
23 -c <config>
24 Get the configuration from config file config, instead of the
25 default /etc/oz/oz.cfg. If neither one exists, Oz will use sen‐
26 sible defaults. The config file is in standard ini format; for
27 an explanation of the sections and keys, see the CONFIGURATION
28 FILE section.
29
30 -d <loglevel>
31 Turn on debugging output to level loglevel. The log levels are:
32
33 0 - errors only (this is the default)
34
35 1 - errors and warnings
36
37 2 - errors, warnings, and information
38
39 3 - all messages
40
41 4 - all messages, prepended with the level and classname
42
43 -h Print a short help message.
44
45
47 The Oz configuration file is in standard INI format with several sec‐
48 tions. If any section or configuration key is missing, Oz will use a
49 sensible default. For true/false configuration keys, the values of
50 "true", "True", "yes", or "Yes" can be used to turn the option on, and
51 "false", "False", "no", or "No" can be used to turn the behavior off.
52 The configuration file should have the following form:
53
54
55 [paths]
56 output_dir = /var/lib/libvirt/images
57 data_dir = /var/lib/oz
58 screenshot_dir = .
59 sshprivkey = /etc/oz/id_rsa-icicle-gen
60
61 [libvirt]
62 uri = qemu:///system
63 type = kvm
64 bridge_name = virbr0
65 cpus = 1
66 memory = 1024
67 image_type = raw
68
69 [cache]
70 original_media = yes
71 modified_media = no
72 jeos = no
73
74 [icicle]
75 safe_generation = no
76
77 The paths section defines the paths that Oz will use for storing data.
78 The output_dir key describes where to store the images after they are
79 built, and the data_dir key describes where to cache install media and
80 use temporary storage. Both locations must have a decent amount of
81 free disk space in order for Oz to work properly. The screenshot_dir
82 key describes where to store screenshots of failed installs. The ssh‐
83 privkey key describes where the ssh keys are stored, which are required
84 by Oz to do customization of the image.
85
86 The libvirt section allows some manipulation of how Oz uses libvirt.
87 The uri key describes the libvirt URI to use to do the guest installa‐
88 tion. The type key defines what type of virtualization to use. The
89 bridge_name key defines which bridge Oz should place the guests that it
90 launches on. The cpus key defines how many cpus should be used inside
91 the virtual machine. The memory key defines how much memory (in
92 megabytes) should be used inside the virtual machine. The image_type
93 key defines which output disk type should be used; this can be any
94 value that libvirt supports.
95
96 The cache section allows some manipulation of how Oz caches data. The
97 caching of data in Oz is a tradeoff between installation time and stor‐
98 age space. The original_media key tells Oz to cache the original
99 installation media so that it does not have to download it the next
100 time an install for the same operating system is requested. The modi‐
101 fied_media key tells Oz to cache the oz-modified installation media so
102 that it does not have to download and modify it the next time an
103 install for the same operating system is requested. The jeos key tells
104 Oz to cache the installed operating system after installation. This
105 can significantly speed up subsequent installation of the same operat‐
106 ing system, with the additional downside of the operating system get‐
107 ting out-of-date with respect to security updates. Use with care.
108
109 The icicle section allows some manipulation of how Oz generates ICICLE
110 output. ICICLE is a package manifest that can optionally be generated
111 at the end of installs. The safe_generation key controls whether Oz
112 uses a throwaway overlay file while generating the ICICLE. If it is
113 set to "no" (the default), then Oz will boot up the guest at the end of
114 the install and run the appropriate commands to generate the ICICLE.
115 If it is set to "yes", then Oz will use a throwaway overlay file while
116 generating the ICICLE. After the ICICLE is generated, Oz will delete
117 the backing file, leaving the original disk image pristine.
118
119
121 oz-generate-icicle(1), oz-install(1), oz-customize(1), oz-examples(1)
122
123
125 Chris Lalancette <clalancette@gmail.com>
126
127
128
129oz-cleanup-cache Feb 2011 OZ-CLEANUP-CACHE(1)