SCI-CD

h1. INSTALL

{{toc}}

[[OVERVIEW]] | [[INSTALL]] | [[OPERATIONS]] | [[LICENSE]]
[[ОБЗОР]] | [[УСТАНОВКА]] | [[ОПЕРАЦИИ]] | [[ЛИЦЕНЗИЯ]]

h2. Get the ISO image

Download the distribution disk, ready to install: *"Download ISO-image":https://sci.skycover.ru/projects/sci-cd/documents*
To access it you should "register":https://sci.skycover.ru/account/register

h2. Burn the ISO-image on the disk or prepare a bootable flash-drive

h3. Windows

You can burn the ISO-image using writeable CD-ROM and any available program for burning disks.

You can also prepare a bootable flash using program Rufus:
In rufus interface choose in "Device" your flash drive.
Create a bootable disk using : DD-image and tap on CD-ROM icon and choose ISO file.

h3. Linux

You can burn the ISO-image using writeable CD-ROM and any available program for burning disks.

You can prepare a bootable flash-drive. For this use any available tool, for example, unetbootin.
When it will ask for "type of a system", you should set Debian of version ... and set the path to the ISO-image file.

You can also th write ISO-image directly to flash-drive:

<pre>
dd if=/path/to/iso of=/dev/sdX bs=4k
</pre>
Where /dev/sdX - path to the block device file. which is pointing to a flash.
(To find which block device you need, insert the flash-drive and run "dmesg" in terminal - at the tail of the output you will see the information about the flash-drive plugged in).
.

h2. Minimal System Requirements

In real case you must choose hardware in according to real objectives.
For testing purposes minimal system requierements is:
* 4 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)

For enterprise use both nodes mush have the same configuration (CPU power, RAM, volume and speed of disk system).

h1. System install

h2. First node setup

Before setting up, link nodes to LAN with a cable. *Detach all other network cables during setup.*
Next boot the first node from installation image.
In welcome scrin choose Install.

{{thumbnail(install.png, size=600)}}

Specify a static IP address for the LAN connection (you can use any free ip from your LAN. In our case it is 192.168.13.11. Tap <Continue>

{{thumbnail(ip_1node.png, size=600)}}

Next specify the network mask and tap <Continue>.

{{thumbnail(netmask.png, size=600)}}

Input your gateway address and tap <Continue>

{{thumbnail(gateway.png, size=600)}}

Input your name server address and tap <Continue>

After address setting go to node naming.
In SCI nodes names are gnt# (e.g. gnt1, gnt2, etc.)
*NOTICE: Nodes names MUST ending with number on the end, starting from 1.*

In the Hostname field specify the node's name, gnt1 or gnt-1
"1" means this will be the first node of a cluster.

{{thumbnail(hostname_1.png, size=600)}}

Specify domain name in the Domain field. If you have domain in LAN, specify it, if not, we recommend to set it to "sci"

{{thumbnail(domain.png, size=600)}}

!domain.JPG!

Next specify root password twice
Do not use too weak password!

{{thumbnail(root_pass.png, size=600)}}

After setting root password we go to hard disks partitioning.
The installer will present several types of automatic partitioning.

If you want to use Software RAID, choose
*2(4,6,8) disk with lvm* - in relation to number of hard disks.
For two disks RAID1 will be used, for more disks RAID10 will be used.
RAID10 - the recommended RAID level to use along with virtualization.

If you use hardware RAID, choose
*1 disk with lvm*

If you have a server with two types of disks, for example, 2 SATA drives and 8 SAS drives (bare or under hardware RAID), we suggesting to do a initial setup at whole on the SATA drives with "*2 disk with lvm*" template, and after initialization of a cluster, add SAS disks manually as additional LVM VG.
This procedure is described in [[OPERATIONS]].

{{thumbnail(diskpart.png, size=600)}}

If you encounter the questions about deleting the old partitions and abщut software RAID creation, then confirm this.

{{thumbnail(diskpart_yes.png, size=600)}}

After some packages install, you must choose disks to install GRUB bootloader

Check all underlying physical drives (not partitions and not Software RAID volumes!), where the system was installed.

{{thumbnail(boot_hdd.png, size=600)}}

After bootloader install system will install rest of packages and finishes the install.

{{thumbnail(install_coplete.png, size=600)}}

Eject install media and tap <Continue>. The system will be reboot in installed OS.

h2. Second node setup

Specify the node's name, for example, gnt2 or gnt-2 (like the first node).
Spesify the same root password as on the first node.

h2. Setup the time

Check that both nodes shows the same time.

<pre>
# date
Thu Mar 12 12:23:10 MSK 2015
</pre>

If not so, the set it with te following command:

<pre>
# date -s "12 MAR 2015 12:23:00"
</pre>

h2. Configure a backbone (the internal link between nodes)

Do not plug off the nodes from the LAN.
Link the nodes with a second cable via their free Gigabit network adapters, check that these adapters "link" LEDs are lit (if the LEDs are present).
This interlink will be used for disk data sychronization and internal cluster communications.
If some oter ethernet cables, other than backbone and LAN) are connected to the nodet at this moment, then you should plug them off for the time of backbone setup.
After the links arise, run the following comand on the each node (you can do it in parallel or sequental):
<pre>
sci-setup backbone
</pre>

The result:
<pre>
root@gnt-1:~# sci-setup backbone
Node number: 1
LAN interface: eth0
Waiting 30 seconds for links to be up
Backbone interface: eth3
Up and test backbone

Waiting for backbone to get ready (MAXWAIT is 2 seconds).
inet addr:10.101.200.11 Bcast:10.101.200.255 Mask:255.255.255.0
ok.
</pre>

After setting up it on both nodes, check the link. Run the following command on the first node:
<pre>
ping 10.100.200.12
</pre>

<pre>
root@gnt-1:~# ping 10.101.200.12
PING 10.101.200.12 (10.101.200.12) 56(84) bytes of data.
64 bytes from 10.101.200.12: icmp_req=1 ttl=64 time=0.263 ms
64 bytes from 10.101.200.12: icmp_req=2 ttl=64 time=0.112 ms
^C
--- 10.101.200.12 ping statistics ---
2 packets transmitted, 2 received, 0% packet loss, time 999ms
rtt min/avg/max/mdev = 0.112/0.187/0.263/0.076 ms
</pre>

h2. Intialize the cluster

On the first node run
<pre>
sci-setup cluster
</pre>

The configuration wizard will ask for the address of a cluster in the LAN:
<pre>
root@gnt-1:~# sci-setup cluster
Cluster domain name will be gnt.
Cluster IP will be 10.101.200.10 on the interlink.
We recommend to set it to some unbound LAN IP address,
but it is safe to simply press ENTER.
Set cluster IP [10.101.200.10]:
</pre>

If at this moment you will specify any free static IP-address in the LAN, then in the future you will be able to connect the cluster controlling module via this IP.
It is useful, but not obligate and not influent on your ability to control the cluuster. You can simply press ENTER and the controlling module will take the address from the backbone.

Configuration wizard will check ping to the second node and will ask you to accept it's ssh key and to enter the root password to it to retrieve and check it's configuration parameters.
<pre>
Connecting to Node2 via 10.101.200.12
You will be prompted for a root password...

The authenticity of host '10.101.200.12 (10.101.200.12)' can't be established.
ECDSA key fingerprint is 6a:5a:78:fa:af:c1:23:97:87:9f:66:46:94:7e:f2:f5.
Are you sure you want to continue connecting (yes/no)?
</pre>

Enter "yes"
<pre>
root@10.101.200.12's password:
</pre>

The password to the second node.

After all checks will succeed, the wizard will print the cluster's configuration parameters:
<pre>
########################################
Parameters detected:
Domain name: example.sci

Master network interface: backbone

Cluster name: gnt
Cluster IP: 10.101.200.10

Node 1 name: gnt-1
Node 1 IP: 10.101.200.11
Node 1 LAN IP: 192.168.11.28

Node 2 name: gnt-2
Node 2 IP: 10.101.200.12
Node 2 LAN IP: 192.168.11.29
Proceed with cluster creation [y/n]?
</pre>

If all is right, enter "y" and press ENTER to create a cluster.

<pre>
Refilling sci.conf
Creating empty /root/.ssh
Fullfilling /etc/hosts
Fulfilling default /etc/ganeti/networks
Set random vnc password for cluster: miotaigh
add sci repo in apt sources
Initializing cluster
Tuning cluster
Adding the second node
-- WARNING --
Performing this operation is going to replace the ssh daemon keypair
on the target machine (gnt-2.example.sci) with the ones of the current one
and grant full intra-cluster ssh root access to/from it

The authenticity of host 'gnt-2.example.sci (10.101.200.12)' can't be established.
ECDSA key fingerprint is 6a:5a:78:fa:af:c1:23:97:87:9f:66:46:94:7e:f2:f5.
Are you sure you want to continue connecting (yes/no)?
</pre>

During the process of adding the second node into a cluster, you will be asked again to accept it's ssh key and to enter the root password.
Enter "yes" and then the password to the second node.

At the end you will see the output of a cluster disgnostic command:
<pre>
VTue Jun 28 18:37:06 2016 * Verifying cluster config
Tue Jun 28 18:37:06 2016 * Verifying cluster certificate files
Tue Jun 28 18:37:06 2016 * Verifying hypervisor parameters
Tue Jun 28 18:37:07 2016 * Verifying all nodes belong to an existing group
Waiting for job 10 ...
Tue Jun 28 18:37:07 2016 * Verifying group 'default'
Tue Jun 28 18:37:08 2016 * Gathering data (2 nodes)
Tue Jun 28 18:37:09 2016 * Gathering disk information (2 nodes)
Tue Jun 28 18:37:09 2016 * Verifying configuration file consistency
Tue Jun 28 18:37:09 2016 * Verifying node status
Tue Jun 28 18:37:09 2016 * Verifying instance status
Tue Jun 28 18:37:10 2016 * Verifying orphan volumes
Tue Jun 28 18:37:10 2016 * Verifying N+1 Memory redundancy
Tue Jun 28 18:37:10 2016 * Other Notes
Tue Jun 28 18:37:10 2016 * Hooks Results
Node DTotal DFree MTotal MNode MFree Pinst Sinst
gnt-1.example.sci 101.2G 82.2G 3.9G 1.5G 2.4G 0 0
gnt-2.example.sci 101.3G 81.3G 3.9G 1.5G 2.4G 0 0
If all is ok, proceed with sci-setup sci
</pre>

h2. Create the controlling virtual machine

On the first node run
<pre>
sci-setup sci
</pre>

If you wish that the internal cluster's DNS will use your company's DNS as the forwarders (i.e. ask them to resolve external Intternet addresses), then run ttis command in the following way:
<pre>
sci-setup sci -d
</pre>

Without @-d@ the internal cluster's DNS will resolve the internet addresses directly via root Internet servers.

The configuration wizard will ask you to specify the address of controlling virtual machime in the LAN:
<pre>
root@gnt-1:~# sci-setup sci
Set sci LAN IP or enter "none" and press ENTER:
</pre>

Specify any free static IP in the LAN (192.168.11.2 in the example above).

After all checks will succeed, the wizard will print the controlling VM configuration parameters:
<pre>
Creating service machine sci
IP: 10.101.200.2 on backbone
Second network device: lan
Second network IP: 192.168.11.2
Proceed with sci VM creation [y/n]?
</pre>

If all is right, enter "y" and press ENTER to create VM.
<pre>
Adding sci to /etc/hosts
Tue Jun 28 18:44:02 2016 * creating instance disks...
Tue Jun 28 18:44:09 2016 adding instance sci to cluster config
Tue Jun 28 18:44:13 2016 - INFO: Waiting for instance sci to sync disks
Tue Jun 28 18:44:13 2016 - INFO: - device disk/0: 2.10% done, 2m 27s remaining (estimated)
Tue Jun 28 18:45:13 2016 - INFO: - device disk/0: 39.90% done, 1m 31s remaining (estimated)
Tue Jun 28 18:46:14 2016 - INFO: - device disk/0: 78.20% done, 34s remaining (estimated)
Tue Jun 28 18:46:48 2016 - INFO: - device disk/0: 100.00% done, 0s remaining (estimated)
Tue Jun 28 18:46:48 2016 - INFO: Instance sci's disks are in sync
Tue Jun 28 18:46:48 2016 * running the instance OS create scripts...
Tue Jun 28 18:49:42 2016 * starting instance...
</pre>

h2. Congratulations! You have just create the first virtual machine in your cluster!

After statting, sci VM automatically issue the finetuning procedures of a cluster nodes and becomes the DNS server for them. This operation takes about 5-10 minutes.

Try following commands:
<pre>
gnt-instance list
gnt-instance info sci
gnt-cluster verify
ssh sci
</pre>

h2. Operation

How to control the cluster and how to create the new virtual machines read [[OPERATIONS]]

----

[[SETUP for versions 2.3 and earlier]]