Skip to content
clalancette edited this page Nov 24, 2012 · 2 revisions

Table of Contents

NAME

oz-cleanup-cache - tool to remove cached oz data

SYNOPSIS

oz-cleanup-cache [OPTIONS]

DESCRIPTION

This is a tool to remove all of the data that Oz has cached. Because the data that Oz caches can grow fairly large, it may be worthwhile to periodically clean it up. This is a simple script to do so. Note that if you do cleanup the Oz cache, subsequent operating system installs will be slower since Oz will have to re-download the installation media.

OPTIONS

-c <config> Get the configuration from config file config, instead of the default /etc/oz/oz.cfg. If neither one exists, Oz will use sensible defaults. The config file is in standard ini format; for an explanation of the sections and keys, see the CONFIGURATION FILE section.

-h Print a short help message.

CONFIGURATION FILE

The Oz configuration file is in standard INI format with several sections. If any section or configuration key is missing, Oz will use a sensible default. For true/false configuration keys, the values of true, True, Yes, or Yes can be used to turn the option on, and false, False, no, or No can be used to turn the behavior off. The configuration file should have the following form:

[paths]
output_dir = /var/lib/libvirt/images
data_dir = /var/lib/oz
screenshot_dir = .

[libvirt]
uri = qemu:///system
type = kvm
bridge_name = virbr0
cpus = 1
memory = 1024

[cache]
original_media = yes
modified_media = no
jeos = no

The paths section defines the paths that Oz will use for storing data. The output_dir key describes where to store the images after they are built, and the data_dir key describes where to cache install media and use temporary storage. Both locations must have a decent amount of free disk space in order for Oz to work properly. The screenshot_dir key describes where to store screenshots of failed installs.

The libvirt section allows some manipulation of how Oz uses libvirt. The uri key describes the libvirt URI to use to do the guest installation. The type key defines what type of virtualization to use. The bridge_name key defines which bridge Oz should place the guests that it launches on. The cpus key defines how many CPUs should be used inside the virtual machine. The memory key defines how much memory should be used inside the virtual machine.

The cache section allows some manipulation of how Oz caches data. The caching of data in Oz is a tradeoff between installation time and storage space. The original_media key tells Oz to cache the original installation media so that it does not have to download it the next time an install for the same operating system is requested. The modified_media key tells Oz to cache the oz-modified installation media so that it does not have to download and modify it the next time an install for the same operating system is requested. The jeos key tells Oz to cache the installed operating system after installation. This can significantly speed up subsequent installation of the same operating system, with the additional downside of the operating system getting out-of-date with respect to security updates. Use with care.

SEE ALSO

oz-generate-icicle, oz-customize, oz-cleanup-cache

AUTHOR

Chris Lalancette <clalancette@gmail.com>