Revision 3913eaa7

b/INSTALL
2 2
===============================
3 3

  
4 4
Please note that a more detailed installation procedure is described in
5
the :doc:`install`. A glossary of terms can be found in the
6
:doc:`glossary`.
5
the :doc:`install`. Refer to it if you are setting up Ganeti the first time.
6
This quick installation guide is mainly meant as reference for experienced
7
users. A glossary of terms can be found in the :doc:`glossary`.
7 8

  
8 9

  
9 10
Software Requirements
b/doc/install.rst
171 171

  
172 172
For optimum performance when running both CPU and I/O intensive
173 173
instances, it's also recommended that the dom0 is restricted to one CPU
174
only, for example by booting with the kernel parameter ``maxcpus=1``.
174
only. For example you can add ``dom0_max_vcpus=1,dom0_vcpus_pin`` to your
175
kernels boot command line and set ``dom0-cpus`` in
176
``/etc/xen/xend-config.sxp`` like this::
177

  
178
  (dom0-cpus 1)
175 179

  
176 180
It is recommended that you disable xen's automatic save of virtual
177 181
machines at system shutdown and subsequent restore of them at reboot.
......
312 316
     $ depmod -a
313 317
     $ modprobe drbd minor_count=128 usermode_helper=/bin/true
314 318

  
315
   It is also recommended that you comment out the default resources in
316
   the ``/etc/drbd.conf`` file, so that the init script doesn't try to
319
   It is also recommended that you comment out the default resources (if any)
320
   in the ``/etc/drbd.conf`` file, so that the init script doesn't try to
317 321
   configure any drbd devices. You can do this by prefixing all
318 322
   *resource* lines in the file with the keyword *skip*, like this:
319 323

  
......
418 422
Other required software
419 423
+++++++++++++++++++++++
420 424

  
421
See :doc:`install-quick`.
425
Please install all software requirements mentioned in :doc:`install-quick`.
426
If you want to build Ganeti from source, don't forget to follow the steps
427
required for that as well.
422 428

  
423 429
Setting up the environment for Ganeti
424 430
-------------------------------------
......
620 626
installation script. An example OS that works under Debian and can
621 627
install Debian and Ubuntu instace OSes is provided on the project web
622 628
site.  Download it from the project page and follow the instructions in
623
the ``README`` file.  Here is the installation procedure (replace 0.9
629
the ``README`` file.  Here is the installation procedure (replace 0.12
624 630
with the latest version that is compatible with your ganeti version)::
625 631

  
626 632
  $ cd /usr/local/src/
627
  $ wget http://ganeti.googlecode.com/files/ganeti-instance-debootstrap-%0.9%.tar.gz
628
  $ tar xzf ganeti-instance-debootstrap-%0.9%.tar.gz
629
  $ cd ganeti-instance-debootstrap-%0.9%
630
  $ ./configure
633
  $ wget http://ganeti.googlecode.com/files/ganeti-instance-debootstrap-%0.12%.tar.gz
634
  $ tar xzf ganeti-instance-debootstrap-%0.12%.tar.gz
635
  $ cd ganeti-instance-debootstrap-%0.12%
636
  $ ./configure --with-os-dir=/srv/ganeti/os
631 637
  $ make
632 638
  $ make install
633 639

  
......
662 668
   ``kbd`` can be used instead of ``console-tools``, and more packages
663 669
   can be added, of course, if needed.
664 670

  
671
Please refer to the ``README`` file of ``ganeti-instance-debootstrap`` for
672
further documentation.
673

  
665 674
Alternatively, you can create your own OS definitions. See the manpage
666 675
:manpage:`ganeti-os-interface(7)`.
667 676

  
......
671 680
**Mandatory** once per cluster, on the first node.
672 681

  
673 682
The last step is to initialize the cluster. After you have repeated the
674
above process on all of your nodes, choose one as the master, and
675
execute::
683
above process on all of your nodes and choose one as the master. Make sure
684
there is a SSH key pair on the master node (optionally generating one using
685
``ssh-keygen``). Finally execute::
676 686

  
677 687
  $ gnt-cluster init %CLUSTERNAME%
678 688

  

Also available in: Unified diff