virt-scenario.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- This file originates from the project https://github.com/openSUSE/doc-kit -->
<!-- This file can be edited downstream. -->
<?xml-stylesheet href="urn:x-suse:xslt:profiling:docbook51-profile.xsl"
  type="text/xml"
  title="Profiling step"?>
<!DOCTYPE article
[
  <!ENTITY % entities SYSTEM "../common/generic-entities.ent">
    %entities;
]>
<topic xml:id="concept-virt-scenario" xml:lang="en"
  role="concept"
  xmlns="http://docbook.org/ns/docbook" version="5.1"
  xmlns:its="http://www.w3.org/2005/11/its"
  xmlns:xi="http://www.w3.org/2001/XInclude"
  xmlns:xlink="http://www.w3.org/1999/xlink">
  <info>
    <meta name="maintainer" content="tbazant@suse.com" its:translate="no"/>
    <title>Creating customized VMs using &virt-scenario;</title>
  </info>
  <para>
    &virt-scenario; is a tool that helps you create virtual machines (VM)
    suitable for a specific scenario. It provides predefined
    <emphasis>profiles</emphasis> that include optimal settings for each
    scenario. You can override settings that are common to all profiles.
  </para>
  <important>
    <para>
      Although &virt-scenario; generally provides the best possible
      configuration for a specific scenario, this cannot be guaranteed because
      each environment may have specific requirements.
    </para>
  </important>
  <section xml:id="how-it-works-virt-scenario">
    <title>How does &virt-scenario; work?</title>
    <para>
      An interactive &virt-scenario; script creates a &libvirt; XML configuration
      file for a VM based on the following:
    </para>
    <itemizedlist>
      <listitem>
        <para>
          selected basic profile
        </para>
      </listitem>
      <listitem>
        <para>
          overridden values for common parameters
        </para>
      </listitem>
      <listitem>
        <para>
          parameters that you specify interactively
        </para>
      </listitem>
    </itemizedlist>
    <para>
      After the configuration is validated, &virt-scenario; adjusts the
      &vmhost; system and creates the image file for the &vmguest;. You can
      then operate the VM using standard &libvirt; commands.
    </para>
  </section>
  <section xml:id="benefits-virt-scenario">
    <title>Benefits of using &virt-scenario;</title>
    <itemizedlist>
      <listitem>
        <para>
          Creating virtual machines is fast and simple. &virt-scenario; leaves
          all the virtualization complexity aside. You can focus on basic
          features only.
        </para>
      </listitem>
      <listitem>
        <para>
          Fine-tuned profiles already offer optimal settings for specified
          scenarios. You do not have to search and copy them to each virtual
          machine of the same type, just use the same profile.
        </para>
      </listitem>
      <listitem>
        <para>
          The override mechanism lets you specify other values than the
          profile's default for selected options. This way, you can customize
          virtual machines to your needs.
        </para>
      </listitem>
    </itemizedlist>
  </section>
</topic>