Linux Manual Pages

Free Software * Books

Source Code

Free Media

Linux

oz-generate-icicle(1)

NAME

   oz-generate-icicle - tool to generate an ICICLE (package manifest) of a
   disk image

SYNOPSIS

   oz-generate-icicle [OPTIONS] <tdl-file> <libvirt-xml-file>

DESCRIPTION

   This is a tool to generate a package manifest (also called ICICLE) from
   a disk image.  This program can be used as a counterpart to oz-install,
   though it does not have to be used in conjunction.

   Note that oz-generate-icicle does the actual work using  a  combination
   of  KVM  and  libvirt, so both of these must be available (and working)
   for oz-generate-icicle to have a chance to succeed.

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.

   -d <loglevel>
          Turn on debugging output to level loglevel.  The log levels are:

          0 - errors only (this is the default)

          1 - errors and warnings

          2 - errors, warnings, and information

          3 - all messages

          4 - all messages, prepended with the level and classname

   -h     Print a short help message.

   -i <icicle>
          oz-generate-icicle will normally write the ICICLE XML to stdout.
          To  have  oz-generate-icicle write the ICICLE to a file instead,
          use this option.

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 = .
       sshprivkey = /etc/oz/id_rsa-icicle-gen

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

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

       [icicle]
       safe_generation = 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
   sshprivkey  key  describes  where  the  ssh  keys are stored, which are
   required by Oz to do customization of the image.

   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 (in
   megabytes) should be used inside the virtual machine.   The  image_type
   key  defines  which  output  disk  type should be used; this can be any
   value that libvirt supports.

   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.

   The  icicle section allows some manipulation of how Oz generates ICICLE
   output.  ICICLE is a package manifest that can optionally be  generated
   at  the  end  of installs.  The safe_generation key controls whether Oz
   uses a throwaway overlay file while generating the ICICLE.   If  it  is
   set to "no" (the default), then Oz will boot up the guest at the end of
   the install and run the appropriate commands to  generate  the  ICICLE.
   If  it is set to "yes", then Oz will use a throwaway overlay file while
   generating the ICICLE.  After the ICICLE is generated, Oz  will  delete
   the backing file, leaving the original disk image pristine.

AUTHOR

   Chris Lalancette <[email protected]>

Opportunity

Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.

Education

Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.