psss / rpms / libguestfs

Forked from rpms/libguestfs 5 years ago
Clone

Blame 0010-builder-Add-a-section-on-performance-to-the-manual.patch

c6b1734
From 230def3aec1e56c09fef3f75ce9545322f4268ae Mon Sep 17 00:00:00 2001
384b531
From: "Richard W.M. Jones" <rjones@redhat.com>
384b531
Date: Sun, 27 Oct 2013 14:59:39 +0000
384b531
Subject: [PATCH] builder: Add a section on performance to the manual.
384b531
384b531
(cherry picked from commit 2937c035958f84986e84c47df49f79d19c4b5b59)
384b531
---
384b531
 builder/virt-builder.pod | 45 ++++++++++++++++++++++++++++++++++++++++++++-
384b531
 1 file changed, 44 insertions(+), 1 deletion(-)
384b531
384b531
diff --git a/builder/virt-builder.pod b/builder/virt-builder.pod
c6b1734
index 7768366..a603fcf 100644
384b531
--- a/builder/virt-builder.pod
384b531
+++ b/builder/virt-builder.pod
c6b1734
@@ -1288,7 +1288,50 @@ etc are truly random when the guest boots.
384b531
 
384b531
 You should check digital signatures and not ignore any signing errors.
384b531
 
384b531
-=head2 USER MODE LINUX
384b531
+=head2 PERFORMANCE
384b531
+
384b531
+The most important aspect of getting good performance is caching.
384b531
+Templates gets downloaded into the cache the first time they are used,
384b531
+or if you use the I<--cache-all-templates> option.  See L</CACHING>
384b531
+above for further information.
384b531
+
384b531
+Packages required for the I<--install> option are downloaded using the
384b531
+host network connection.  Setting the C<http_proxy>, C<https_proxy>
384b531
+and C<ftp_proxy> environment variables to point to a local web cache
384b531
+may ensure they only need to be downloaded once.  You can also try
384b531
+using a local package repository, although this can be complex to set
384b531
+up and varies according to which Linux distro you are trying to
384b531
+install.
384b531
+
384b531
+=head3 Skipping virt-resize
384b531
+
384b531
+Virt-builder can skip the virt-resize step under certain conditions.
384b531
+This makes virt-builder much faster.  The conditions are:
384b531
+
384b531
+=over 4
384b531
+
384b531
+=item *
384b531
+
384b531
+the output must be a regular file (not a block device), B<and>
384b531
+
384b531
+=item *
384b531
+
384b531
+the user did B<not> use the I<--size> option, B<and>
384b531
+
384b531
+=item *
384b531
+
384b531
+the output format is the same as the template format (usually raw).
384b531
+
384b531
+=back
384b531
+
384b531
+=head3 pxzcat
384b531
+
384b531
+Virt-builder can use C<pxzcat> (parallel xzcat) if available to
384b531
+uncompress the templates.  The default is to use regular C<xzcat>
384b531
+which is single-threaded.  Currently this has to be compiled in,
384b531
+ie. virt-builder will probably need to be recompiled to use pxzcat.
384b531
+
384b531
+=head3 User-Mode Linux
384b531
 
384b531
 You can use virt-builder with the User-Mode Linux (UML) backend.  This
384b531
 may be faster when running virt-builder inside a virtual machine
384b531
-- 
384b531
1.8.3.1
384b531