SCI-CD

h1. INSTALL

{{toc}}

[[OVERVIEW]] | [[BUILD-ISO]] | [[INSTALL]] | [[SETUP]] | [[OPERATIONS]] | [[GITMAGIC]] | [[LICENSE]] | [[STATUS]]
[[ОБЗОР]] | [[СБОРКА-ISO]] | [[УСТАНОВКА]] | [[НАСТРОЙКА]] | [[ОПЕРАЦИИ]] | [[МАГИЯ GIT]] | [[ЛИЦЕНЗИЯ]] | [[СОСТОЯНИЕ]]

h2. Get the ISO image

You can get the latest built ISO image here: http://sci-dev.skycover.ru/dist/SCI-CD-latest.iso
The older versions also are in the http://sci-dev.skycover.ru/dist/
Otherwise you can build your own ISO-image (for experienced users): [[BUILD-ISO]]

h2. Burn the ISO image

You burn it with your favorite tool (for ex. - k3b).

h2. Create bootable USB flash

At present this option is only available when you build the ISO image yourself.
Consult [[BUILD-ISO]].

h2. Minimal System Requirements

In real case you must choose hardware in according to real objectives.
For testing purposes minimal system requierements is:
* 1.2 GB RAM
* 50GB HDD
* 1Gbit ethernet for DRBD link (if you setup 2 or more nodes)
* Hardware Virtualization support: Intel VT or AMD CPU (if you want to run the Windows instances)

h2. Install the system

Install the system on two nodes (you may use only one node, but high
availability capabilities will be unavailable).

The installer will ask you:

You must to know following data at this time:
* The node's IP-address on number and the interlink. mask of the interlink network. For ex.: 192.168.2.1(2) 192.168.2.0/255.255.255.0
* The IP addresses of two installed nodes in the interlink network mask. For ex.: 255.255.255.0
* The node's name. For ex.: gnt1(2) internet router's address in the interlink network (typically no router will be needed here)
* The domain. For ex.: gnt.yourcompany.com cluster's domain name
* The default router's address (DO NOT specify if you use the separate network
card hostnames for the interlink!) new nodes
* The (new) address of the future DNS server's address serverin the interlink network (*NOT an already existent host!*),
which will be installed on the interlink. For ex.: 192.168.1.254 cluster service instance.
* The root root's password
* Chose one of predefined disk layouts or layout it manually.
* Specify the disks The idea on which yo want how to place grub loader. Chose "md0" if you create storage system - to use
the software or hardware RAID for the system partition.
* Specify the additional kernel parameters (but usually you don't). or no RAID at all (not recommended) - on your own choice.

h3. Partitioning

During the installation you will be prompted to chose the one of predefined disk layouts
useful for 1-8 disk nodes with or without the hardware RAID.

If you chose the "manual layout" option then you should preserve following partitions on your nodes:
|_.Name|_.Size|_.Purpose|
|/|10G|Root partition for all node's data|
|swap|1G|Swap space for Dom0 in calculation of 512Mb RAM|
|xenvg|the rest or the another device|The LVM Volume, named 'xenvg', without any partitions|

The VG "xenvg" will be used as the default place for the instance's volumes.
Also the "system-stuff" volume will be automatically created on xenvg (and mounted as /stuff).
It serves for various big stuff like cdrom images, instance backups etc.

At our own choice you may defer the creation of xenvg during the installation stage and to create it later.
In this case any option with "no LVM" will be useful.

NOTE: If you want to place your own partitions on xenvg, you should
then exclude them from ganeti-managed volumes. (SEE [[SETUP]]).
Simplest way is to name your partitions "sytem-*" because this
pattern is excluded in SCI-CD by default.

You may create more partitions or volume groups at your choice.

h3. DNS server's address

The cluster has it's own DNS server, which is also the 'approx' and
'puppet' server. At the [[SETUP]] stage, cluster DNS server can be linked
to other DNS servers in the forwarding mode.

The DNS server's address +must not+ be the address of the existing service.

The cluster's domain name +must not+ be the name of the existing domain if
local domain already exists (use subdomain, or completely different name).

h2. Automatic post-installation changes

During the installation phase, the postinst.sh script from the distro
made the following system tuning: [[POST-INSTALL]]

h2. The cluster is ready to setup

The CD installation takes about 15 minutes per node.

h2. The cluster is ready installer will ask you:

* The node's IP-address on the interlink. For ex.: 192.168.2.1(2)
* The network mask. For ex.: 255.255.255.0
* The node's name. For ex.: gnt1(2)
* The domain. For ex.: gnt.yourcompany.com
* The default router's address (DO NOT specify if you use the separate network card for the interlink!)
* The (new) DNS server's address on the interlink. For ex.: 192.168.1.254
* Chose one of predefined disk layouts or layout it manually.
* Specify the disks on which yo want to setup

place grub loader. Chose "md0 RAID" if you use software RAID for the system partition.
* Specify the additional kernel parameters (but usually you don't).

Read [[SETUP]] next.