ModularIT

h1. XenU deployment and configuration guide

Download the image [[Download|here]] [[Download|here]]. This documentation will be updated to version 1.1.

Create a virtual machine from a machine service image image.

h2. Creating the virtual machine

The virtual machine images and the _createvm_ utility should reside in _/opt/xen_. If not, it can be downloaded from:

* ftp://yumrepo.canarytek.com/Xen

* The _createvm_ script is run along with the required parameters. For example:
** Name: test
** Volume size: 3G
** Virtual machine image: ''zero51.tgz''
** RAM: 128
** IP: 192.168.1.23
** Bridge Xen: xenbr0
** Create the machine using the command:

<pre>
./createvm test 3G zero51.tgz 128 192.168.1.23 xenbr0
</pre>

* The script automatically performs the following steps:
** Creates a LVM volume for the machine.
** Creates and initializes a LVM swap volume.
** Configures the network with a specified IP (for Centos).
** Generates the virtual machine configuration (The MAC is calculated from the IP).


h2. PICA objects and monitoring

Note: To avoid false positives in the monitoring tool, this step should only be done if the machine is fully operational. If the machine is showing critical alerts, add the variable _nagios_skip_host = '1'_, reinstall the Nagios objects and restart Nagios (see below). Using this variable the alerts to the NOC operators are suppressed for machines in a partially installed state (knowledge centre/support/maintenance).

* Ensure that the machine is included in the PICA base group.
* Install PIFIA and load the machine configuration.

<pre>
pica -iv +F pifia +H ctk.nagios
</pre>

* The Nagios configuration is updated and the machines are included:

<pre>
pica -iv +F nagios +H ctk.nagios
</pre>
<pre>
pica -xv +F "service nagios restart" +H ctk.nagios
</pre>

* Check that the new machine appears in the Nagios.
* The execution of warning alerts is forced to ensure that the notifications arrive:

<pre>
pica -xv +F "scheduler Emergency" +H maquina
</pre>
<pre>
pica -xv +F "scheduler Warning" +H maquina
</pre>

* Install _munin-node_ on the machine:

<pre>
pica -xv +F "yum install munin-node" +H maquina
</pre>
<pre>
pica -xv +F munin +H maquina
</pre>