/ - Diff - snf-image-creator - Greek Research and Technology Network's projects

        install
        usage
     Contact
     =======
     Indices and tables
     ==================
     For questions or bug reports you can contact the Synnefo team at the following
     mailing lists:
     * :ref:`genindex`
     * :ref:`modindex`
     * :ref:`search`
      * Users list: synnefo@googlegroups.com
      * Developers list: synnefo-devel@googlegroups.com
     ..
      Indices and tables
      ==================
      * :ref:`genindex`
      * :ref:`modindex`
      * :ref:`search`

     The above dependencies are resolved differently, depending on the installation
     method you choose. There are two installation methods available:
     #. `Installation using official packages <#install-snf-image-creator-using-official-packages>`_ (currently only for Ubuntu 12.04 LTS and 12.10).
     #. `Installation using packages <#install-snf-image-creator-using-packages>`_ (currently only for Ubuntu and Arch Linux).
     #. `Installation from source <#install-snf-image-creator-from-source>`_
     Install snf-image-creator using official packages
     =================================================
     Install snf-image-creator using packages
     ========================================
     For Ubuntu systems, you can use our official packages found in *grnet/synnefo*
     Lauchpad PPA.
     Ubuntu
     ------
     For *Ubuntu 12.04 LTS* and *12.10* systems, you can use our official packages
     found in *grnet/synnefo* Lauchpad PPA.
     Add the synnefo PPA in your system:
-...
        If you are asked during the installation to create/update a
        "supermin appliance", choose "Yes".
     .. warning::
        In *Ubuntu 12.10* the current package of libguestfs (1.18-2) is broken. Take
        a look at the open `bug report <https://bugs.launchpad.net/ubuntu/quantal/+source/libguestfs/+bug/1086974>`_.
        Until version 1.18-2ubunut1 is out, you may workaround this problem by
        creating a symlink like this:
        *sudo ln -s /usr/lib/guestfs /usr/lib/x86_64-linux-gnu/guestfs*
     Arch Linux
     ----------
     For *Arch Linux* there are **unofficial** packages in AUR:
     https://aur.archlinux.org/packages/snf-image-creator/ kindly provided by
     Axilleas Pipinellis <axilleas@archlinux.info>.
     .. note::
         Those packages are not maintained by the Synnefo development team.
         Please direct package-specific questions to Axilleas Pipinellis <axilleas@archlinux.info>,
         Cc: the Synnefo development team <synnefo-devel@googlegroups.com>
     To install the package you may use *yaourt*. Create and install
     the *yaourt* package:
     .. code-block:: console
        $ wget https://aur.archlinux.org/packages/pa/package-query/package-query.tar.gz
        $ tar -xvf package-query.tar.gz
        $ cd package-query
        $ makepkg -s
        $ pacman -U package-query-<VERSION>-<ARCH>.pkg.tar.xz
        $ cd ..
        $ wget https://aur.archlinux.org/packages/ya/yaourt/yaourt.tar.gz
        $ tar -xvf yaourt.tar.gz
        $ cd yaourt
        $ makepkg -s
        $ pacman -U yaourt-<VERSION>-<ARCH>.pkg.tar.xz
     Install *snf-image-creator* using yaourt:
     .. code-block:: console
        $ yaourt -Sa snf-image-creator
     Install snf-image-creator from source
     =====================================

     media or by using the *Bundle Host* button in the media selection dialog of
     snf-mkimage. During this operation, the files of the disk are copied into a
     temporary image file, which means that the file system that will host the
     temporary image needs to have a lot of free space (see `the tmpdir option`_
     temporary image needs to have a lot of free space (see `large temporary files`_
     for more information).
     Creating a new image
-...
     Choosing *YES* will create and upload the image to your *~okeanos* account.
     Some caveats on image creation
     ==============================
     Limitations
     ===========
     Supported operating systems
     ---------------------------
     *snf-image-creator* can only fully function on input media hosting *Linux*
     systems. The program will detect the needed metadata and you may use it to
     upload and register other *Unix* or *Windows* images, but you cannot use it to
     shrink them or perform system preparation operations.
     Logical Volumes
     ---------------
     The program cannot work on LVM partitions [#f1]_. The input media may only
     contain primary or logical partitions.
     Para-virtualized drivers
     ------------------------
-...
     Many popular Linux distributions, like Ubuntu and Debian, will automatically
     create a generic initial ramdisk file that contains many different modules,
     including the VirtIO drivers. Others that target more experienced users, like
     Slackware, won't do that [#f1]_. *snf-image-creator* cannot resolve this kind
     Slackware, won't do that [#f2]_. *snf-image-creator* cannot resolve this kind
     of problems and it's left to the user to do so. Please refer to your
     distribution's documentation for more information on this. You can always check
     if a system can boot with para-virtualized disk controller by launching it with
     kvm using the *if=virtio* option (see the kvm command in the
     `Creating a new image`_ section).
     Some caveats on image creation
     ==============================
     Image partition schemes and shrinking
     -------------------------------------
-...
     partition placed as the last partition on the disk and have your largest
     partition (*/* or */home*) just before that.
     The tmpdir option
     -----------------
     Large temporary files
     ---------------------
     *snf-image-creator* may create large temporary files when running:
-...
     .. rubric:: Footnotes
     .. [#f1] http://mirrors.slackware.com/slackware/slackware-14.0/README.initrd
     .. [#f1] http://sourceware.org/lvm2/
     .. [#f2] http://mirrors.slackware.com/slackware/slackware-14.0/README.initrd

Synnefo » snf-image-creator

Revision 5aa25240