X-Git-Url: https://code.grnet.gr/git/snf-image-creator/blobdiff_plain/058f5b86fc25bb6b63bc10285a95d6f26fdd1831..145093705543fbddd051f0107fc426e224d1e485:/docs/usage.rst diff --git a/docs/usage.rst b/docs/usage.rst index 70cafb6..d789268 100644 --- a/docs/usage.rst +++ b/docs/usage.rst @@ -58,7 +58,7 @@ found, before extracting the image. Both can be disabled by specifying *--no-sysprep* and *--no-shrink* respectively. If *--print-sysprep* is defined, the program will exit after outputing a -list of enabled and disabled system preparation operation appliable to this +list of enabled and disabled system preparation operation applicable to this media source. The user can enable or disable specific *syspreps* when creating an image, using *-{enable,disable}-sysprep* options. You can specify those options multiple times to enable or disable multiple *syspreps*. @@ -66,6 +66,8 @@ options multiple times to enable or disable multiple *syspreps*. Running *snf-image-creator* with *--print-sysprep* on a raw file that hosts a debian system, we get the following output: +.. _sysprep: + .. code-block:: console $ snf-image-creator --print-sysprep debian_desktop.img @@ -78,50 +80,50 @@ debian system, we get the following output: Launching helper VM... done Inspecting Operating System... found a(n) debian system Mounting the media read-only... done - + Enabled system preparation operations: cleanup-cache: Remove all regular files under /var/cache - + cleanup-log: Empty all files under /var/log - + cleanup-passwords: Remove all passwords and lock all user accounts - + cleanup-tmp: Remove all files under /tmp and /var/tmp - + cleanup-userdata: Delete sensitive userdata - + fix-acpid: Replace acpid powerdown action scripts to immediately shutdown the system without checking if a GUI is running. - + remove-persistent-net-rules: Remove udev rules that will keep network interface names persistent after hardware changes and reboots. Those rules will be created again the next time the image runs. - + remove-swap-entry: Remove swap entry from /etc/fstab. If swap is the last partition then the partition will be removed when shrinking is performed. If the swap partition is not the last partition in the disk or if you are not going to shrink the image you should probably disable this. - + use-persistent-block-device-names: Scan fstab & grub configuration files and replace all non-persistent device references with UUIDs. - + Disabled system preparation operations: cleanup-mail: Remove all files under /var/mail and /var/spool/mail - + remove-user-accounts: Remove all user accounts with id greater than 1000 - - + + cleaning up... If we want the image to have all normal user accounts and all mail files @@ -157,7 +159,7 @@ Wizard mode When *snf-mkimage* runs in *wizard* mode, the user is just asked to provide the following basic information: - * Name: A short name for image (ex. "Slackware") + * Name: A short name for the image (ex. "Slackware") * Description: An one-line description for the image (ex. "Slackware Linux 14.0 with KDE") * Account: An *~okeanos* account email * Token: A token corresponding to the account defined previously @@ -202,7 +204,14 @@ disk from the Internet: $ wget http://ubuntureleases.tsl.gr/12.04.1/ubuntu-12.04.1-server-amd64.iso -Create a 2G sparce file to host the new system: +Verify that it has been downloaded correctly: + +.. code-block:: console + + $ echo 'a8c667e871f48f3a662f3fbf1c3ddb17 ubuntu-12.04.1-server-amd64.iso' > check.md5 + $ md5sum -c check.md5 + +Create a 2G sparse file to host the new system: .. code-block:: console @@ -213,11 +222,23 @@ And install the Ubuntu system on this file: .. code-block:: console $ sudo kvm -boot d -drive file=ubuntu_hd.raw,format=raw,cache=none,if=virtio \ - -cdrom ubuntu-12.04.1-server-amd64.iso + -m 1000 -cdrom ubuntu-12.04.1-server-amd64.iso + +.. note:: + + During the installation, you will be asked about the partition scheme. Since + snf-image-creator does not support LVM partitions, you are advised to create + regular partitions. + +When the installation is complete, you can close the QEMU window. You +will be able to boot your installed OS and make any changes you want to it +(e.g. install openssh-server) using the following command:: + + $ sudo kvm -boot d -drive file=ubuntu_hd.raw,format=raw,cache=none,if=virtio -After the installation finishes, become root, activate the virtual environment -you have installed snf-image-creator in, and use *snf-mkimage* to create and -upload the image: +After you're done, become root, activate the virtual environment you have +installed snf-image-creator in, and use *snf-mkimage* to create and upload the +image: .. code-block:: console @@ -266,7 +287,7 @@ to the user to do it. Swap partitions --------------- -If you want your image to have a swap partitions, make sure this is the last +If you want your image to have a swap partition, make sure this is the last partition on the disk. If snf-image-creator detects a swap partition in the end of the input media, it will remove the partition when shrinking and will save enough information to be able to recreate it during image deployment. This will