X-Git-Url: https://code.grnet.gr/git/snf-image-creator/blobdiff_plain/eb5123b752433283261c4678f520102d1880c414..fab154f00c00474d8baf495cf432dc6054f1bc7e:/docs/install.rst diff --git a/docs/install.rst b/docs/install.rst index 9cf0e6b..dfd0dd4 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -25,15 +25,18 @@ snf-image-creator depends on the following programs: 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>`_ #. `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: @@ -42,12 +45,20 @@ Add the synnefo PPA in your system: $ sudo apt-add-repository ppa:grnet/synnefo $ sudo apt-get update -If *apt-add-repository* is missing, install *software-properties-common* first: +If *apt-add-repository* is missing, first install: + +*software-properties-common* (Ubuntu 12.10): .. code-block:: console $ sudo apt-get install software-properties-common +Or *python-software-properties* (Ubuntu 12.04): + +.. code-block:: console + + $ sudo apt-get install python-software-properties + After the synnefo repository is set up, you should be able to list snf-image-creator by calling: @@ -61,15 +72,93 @@ Install the package by issuing: $ sudo apt-get install snf-image-creator -If you are using Ubuntu 12.10, also install libguestfs-tools: +.. note:: + 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 `_. + 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* + +Fedora +------ + +For *Fedora 17* you can use our official packages hosted at the *synnefo* +repository of the openSUSE Build Service. + +Add the *synnefo* repository for *Fedora 17* to *yum*: .. code-block:: console - $ sudo apt-get install libguestfs-tools + $ cd /etc/yum.repos.d + $ wget http://download.opensuse.org/repositories/home:/GRNET:/synnefo/Fedora_17/home:GRNET:synnefo.repo + +To list the *snf-image-creator* package use the following command: + +.. code-block:: console + + $ yum info snf-image-creator + +Install the package by issuing: + +.. code-block:: console + + $ yum install snf-image-creator + +CentOS +------ + +For *CentOS 6* you can use our official packages hosted at the *synnefo* +repository of the openSUSE Build Service. + +Add the *synnefo* repository for *CentOS 6* to the yum repositories list: + +.. code-block:: console + + $ cd /etc/yum.repos.d + $ wget http://download.opensuse.org/repositories/home:/GRNET:/synnefo/CentOS_CentOS-6/home:GRNET:synnefo.repo + +Check the `Fedora <#fedora>`_ instructions on how to install the software. + +Arch Linux +---------- + +For *Arch Linux* there are **unofficial** packages in AUR: +https://aur.archlinux.org/packages/snf-image-creator/ kindly provided by +Axilleas Pipinellis . .. note:: - If you are asked during the installation to create/update a - "supermin appliance", choose "Yes". + Those packages are not maintained by the Synnefo development team. + + Please direct package-specific questions to Axilleas Pipinellis , + Cc: the Synnefo development team + +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--.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--.pkg.tar.xz + +Install *snf-image-creator* using yaourt: + +.. code-block:: console + + $ yaourt -Sa snf-image-creator Install snf-image-creator from source =====================================