diff --git a/sysprep/virt-sysprep.pod b/sysprep/virt-sysprep.pod index 71900ca8c..5ec39352d 100755 --- a/sysprep/virt-sysprep.pod +++ b/sysprep/virt-sysprep.pod @@ -2,7 +2,7 @@ =head1 NAME -virt-sysprep - Reset or unconfigure a virtual machine so clones can be made +virt-sysprep - Reset, unconfigure or customize a virtual machine so clones can be made =head1 SYNOPSIS @@ -12,16 +12,17 @@ virt-sysprep - Reset or unconfigure a virtual machine so clones can be made =head1 DESCRIPTION -Virt-sysprep "resets" or "unconfigures" a virtual machine so that +Virt-sysprep can resets or unconfigure a virtual machine so that clones can be made from it. Steps in this process include removing SSH host keys, removing persistent network MAC configuration, and -removing user accounts. Each step can be enabled or disabled as -required. +removing user accounts. Virt-sysprep can also customize a virtual +machine, for instance by adding SSH keys, users or logos. Each step +can be enabled or disabled as required. Virt-sysprep modifies the guest or disk image I. The guest must be shut down. If you want to preserve the existing contents of -the guest, you I. -See L below. +the guest, I. See +L below. You do I need to run virt-sysprep as root. In fact we'd generally recommend that you don't. The time you might want to run it @@ -310,6 +311,17 @@ There are some smarter (and faster) ways too: \-----> guests \----> +You may want to run virt-sysprep twice, once to reset the guest (to +make a template) and a second time to customize the guest for a +specific user: + + virt-sysprep virt-sysprep + (reset) (add user, keys, logos) + | | + dd v dd v + original guest ----> template ---------> copied ------> custom + template guest + =over 4 =item *