From 4ee20f9e403d9fd25954a63179fa786b838d7d9b Mon Sep 17 00:00:00 2001
From: Jose Perez Carranza <jose.perez.carranza@intel.com>
Date: Mon, 12 Aug 2019 11:08:41 -0500
Subject: [PATCH] [robot] Add configs and environment setup

Enable different configurations and setup requirements for deployment
environments as well as pip requirements.

- Config : Serie of configuration files to be used on deployment
        as well as exposed to the framework in order to use the values
        on the test cases.
- Qemu : All artifacts needed to deploy the virtual
        machines that simulate the nodes on libvirt/qemu
- Baremetal : Series of configuration files used
        to setup a deployment on a baremetal environment
- requirements.txt, test-requirements.txt : series of packages needed by
            the suite to work on a python virtualenv.

Depends-On: I796dcaf71089424dd37a050691fd0ee003ad3176
Change-Id: I34dfe1c01b27e5e8ce046de3305dd78c7f9d1383
Signed-off-by: Jose Perez Carranza <jose.perez.carranza@intel.com>
---
 automated-robot-suite/Config/__init__.py      |   0
 automated-robot-suite/Config/config.ini       |  54 ++
 automated-robot-suite/Config/config.py        | 144 ++++
 automated-robot-suite/Config/stx-duplex.yml   |  16 +
 .../Config/stx-multinode.yml                  |  16 +
 automated-robot-suite/Config/stx-simplex.yml  |  12 +
 automated-robot-suite/Qemu/README.md          | 155 +++++
 automated-robot-suite/Qemu/__init__.py        |   0
 automated-robot-suite/Qemu/compute.xml        |  92 +++
 .../Qemu/configs/duplex.yaml                  |  18 +
 .../configs/multinode_controller_storage.yaml |  29 +
 .../configs/multinode_dedicated_storage.yaml  |  42 ++
 .../Qemu/configs/simplex.yaml                 |  12 +
 .../Qemu/images/qemu_logo.png                 | Bin 0 -> 19079 bytes
 .../Qemu/master_controller.xml                | 106 +++
 automated-robot-suite/Qemu/nat-network.xml    |   7 +
 automated-robot-suite/Qemu/qemu_setup.py      | 638 ++++++++++++++++++
 automated-robot-suite/Qemu/qemu_setup.yaml    |  32 +
 .../Qemu/slave_controller.xml                 |  99 +++
 automated-robot-suite/Qemu/storage.xml        |  92 +++
 .../baremetal/baremetal_setup.yaml            |  47 ++
 .../baremetal/configs/duplex.yaml             |  18 +
 .../configs/multinode_controller_storage.yaml |  32 +
 .../configs/multinode_dedicated_storage.yaml  |  46 ++
 .../baremetal/configs/simplex.yaml            |  11 +
 automated-robot-suite/requirements.txt        |  14 +
 automated-robot-suite/test-requirements.txt   |   9 +
 27 files changed, 1741 insertions(+)
 create mode 100644 automated-robot-suite/Config/__init__.py
 create mode 100644 automated-robot-suite/Config/config.ini
 create mode 100644 automated-robot-suite/Config/config.py
 create mode 100644 automated-robot-suite/Config/stx-duplex.yml
 create mode 100644 automated-robot-suite/Config/stx-multinode.yml
 create mode 100644 automated-robot-suite/Config/stx-simplex.yml
 create mode 100644 automated-robot-suite/Qemu/README.md
 create mode 100644 automated-robot-suite/Qemu/__init__.py
 create mode 100644 automated-robot-suite/Qemu/compute.xml
 create mode 100644 automated-robot-suite/Qemu/configs/duplex.yaml
 create mode 100644 automated-robot-suite/Qemu/configs/multinode_controller_storage.yaml
 create mode 100644 automated-robot-suite/Qemu/configs/multinode_dedicated_storage.yaml
 create mode 100644 automated-robot-suite/Qemu/configs/simplex.yaml
 create mode 100644 automated-robot-suite/Qemu/images/qemu_logo.png
 create mode 100644 automated-robot-suite/Qemu/master_controller.xml
 create mode 100644 automated-robot-suite/Qemu/nat-network.xml
 create mode 100644 automated-robot-suite/Qemu/qemu_setup.py
 create mode 100644 automated-robot-suite/Qemu/qemu_setup.yaml
 create mode 100644 automated-robot-suite/Qemu/slave_controller.xml
 create mode 100644 automated-robot-suite/Qemu/storage.xml
 create mode 100644 automated-robot-suite/baremetal/baremetal_setup.yaml
 create mode 100644 automated-robot-suite/baremetal/configs/duplex.yaml
 create mode 100644 automated-robot-suite/baremetal/configs/multinode_controller_storage.yaml
 create mode 100644 automated-robot-suite/baremetal/configs/multinode_dedicated_storage.yaml
 create mode 100644 automated-robot-suite/baremetal/configs/simplex.yaml
 create mode 100644 automated-robot-suite/requirements.txt
 create mode 100644 automated-robot-suite/test-requirements.txt

diff --git a/automated-robot-suite/Config/__init__.py b/automated-robot-suite/Config/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/automated-robot-suite/Config/config.ini b/automated-robot-suite/Config/config.ini
new file mode 100644
index 0000000..ffe86a5
--- /dev/null
+++ b/automated-robot-suite/Config/config.ini
@@ -0,0 +1,54 @@
+[general]
+LOG_PATH = /tmp/logs
+IP_UNIT_0_ADDRESS = 10.10.10.3
+IP_UNIT_1_ADDRESS = 10.10.10.4
+CIRROS_FILE = cirros-0.4.0-x86_64-disk.qcow2
+CENTOS_FILE = CentOS-7-x86_64-GenericCloud.qcow2
+UBUNTU_FILE = xenial-server-cloudimg-amd64-disk1.qcow2
+WINDOWS_FILE = windows_server_2012_r2.qcow2
+APP_TARBALL = stx-openstack.tgz
+STX_ISO_FILE = bootimage.iso
+ENV_YAML_FILE = Qemu/qemu_setup.yaml
+CONFIGURATION_TYPE = simplex
+ENVIRONMENT = virtual
+CONFIGURATION_FILE = stx-simplex.yml
+
+[credentials]
+STX_DEPLOY_USER_NAME = sysadmin
+STX_DEPLOY_USER_PSWD = St4rlingX*
+
+[iso_installer]
+KERNEL_OPTION = 0
+VIRSH_CMD = virsh -c qemu:///system console controller-0
+VMLINUZ = vmlinuz append rootwait
+CONSOLES = console=tty0,115200 console=ttyS0,115200 inst.text
+SERIAL = serial
+OPTS_1 = inst.stage2=hd:LABEL=oe_iso_boot user_namespace.enable=1
+SYS_TYPE_1 = inst.ks=hd:LABEL=oe_iso_boot:/ks.cfg
+SYS_TYPE_2 = inst.ks=hd:LABEL=oe_iso_boot:/smallsystem_ks.cfg
+SYS_TYPE_3 = inst.ks=hd:LABEL=oe_iso_boot:/smallsystem_lowlatency_ks.cfg
+OPTS_2 = boot_device=sda rootfs_device=sda biosdevname=0 usbcore.autosuspend=-1 inst.gpt
+SEC_PROF_1 = security_profile=standard
+SEC_PROF_2 = security_profile=extended
+INITRD = initrd=initrd.img
+BOOT_TIMEOUT = 1200
+CONFIG_CONTROLLER_TIMEOUT = 3600
+CONTROLLER_TMP_IP = 10.10.10.3
+CONTROLLER_TMP_GATEWAY = 10.10.10.1
+
+[logical_interface]
+OAM = enp2s1
+MGMT = enp2s2
+
+[baremetal]
+HTTP_SERVER = 192.168.200.3
+
+[dashboard]
+HORIZON_USERNAME = admin
+HORIZON_PASSWORD = St4rlingX*
+BROWSER = firefox
+PROFILE = nk0f1p65.automation
+
+[qemu]
+XML = /etc/libvirt/qemu/networks/autostart/default.xml
+CONFIG_FILE = /etc/libvirt/qemu.conf
diff --git a/automated-robot-suite/Config/config.py b/automated-robot-suite/Config/config.py
new file mode 100644
index 0000000..a8cb28d
--- /dev/null
+++ b/automated-robot-suite/Config/config.py
@@ -0,0 +1,144 @@
+"""Config file parser and config file generator.
+
+Configuration values will be read from a file called <CONFIG_FILE>.
+A config file with default values can be generated by running this module as a
+script and using the --generate option.
+
+The config file is a standard INI file that contains [sections] and options.
+
+Variables that are between %(option)s are interpolated automatically by the
+ConfigParser (with the caveat that they have to be in the same section).
+Variables that are between ${section:option} will be interpolated with the
+value from the appropriate section (similar to the way ConfigParse from
+Python3 works).
+
+Example of a config file:
+
+E.g.
+
+[Section1]
+key_1 = value 1
+key_2 = value 2
+country = mexico
+
+[section2]
+name = John
+lastname = Doe
+fullname = %(name)s %(lastname)s
+country = ${Section1:country}
+
+To access config values from other modules follow this approach:
+
+import Config.config as CONF
+full_name = CONF.get('section2', 'fullname')
+"""
+
+from __future__ import print_function
+
+import argparse
+import configparser
+import os
+import re
+
+
+CONFIG_FILE = os.path.join(os.path.dirname(__file__), 'config.ini')
+CONFIG = configparser.SafeConfigParser()
+
+
+def get(section, option, raw=False, variables=None):
+    """Wrapper function to mimic behavior of ConfigParse (Python3).
+
+    Python3 uses a ConfigParse that is different than the Python2 ConfigParser,
+    it has some additional functionality. One of the biggest differences is
+    that with ConfigParse you can interpolate variables from one section into
+    another section of the config file. This functionality is not included in
+    the ConfigParse. Since it is very useful, this function wraps the original
+    get function from ConfigParser so it includes the missing interpolation.
+    :param section: the section where the option to be gotten is
+    :param option: the option to look for in the config file
+    :param raw: all the '%' interpolations are expanded in the return values,
+        unless the raw argument is true.
+    :param variables: the option is looked up in variables (if provided)
+    :return: the specified value from the config file
+    """
+    # ensure file readed is up to date always
+    CONFIG.read(CONFIG_FILE)
+    original_option = CONFIG.get(section, option, raw=raw, vars=variables)
+    # find all matches that have the following pattern: ${something}
+    matches = re.findall(r'\$\{(.*?)\}', original_option)
+    new_value = original_option
+    for match in matches:
+        # interpolate matches found with ${something} with the referenced
+        # option from the appropriate section
+        pattern = '${' + match + '}'
+        value = match.split(':')
+        foreign_value = CONFIG.get(value[0], value[1])
+        new_value = new_value.replace(pattern, foreign_value)
+    if original_option != new_value:
+        CONFIG.set(section, option, new_value)
+
+    # return the interpolated value
+    return CONFIG.get(section, option, raw=raw, vars=variables)
+
+
+def getint(section, option):
+    """Wrapper that returns the value as an integer.
+
+    :param section: the section where the option to be gotten is
+    :param option: the option to look for in the config file
+    :return: the specified value from the config file
+    """
+    return int(CONFIG.get(section, option))
+
+
+def getfloat(section, option):
+    """Wrapper that returns the value as a float.
+
+    :param section: the section where the option to be gotten is
+    :param option: the option to look for in the config file
+    :return: the specified value from the config file
+    """
+    return float(CONFIG.get(section, option))
+
+
+def getboolean(section, option):
+    """Wrapper that returns the value as a boolean.
+
+    :param section: the section where the option to be gotten is
+    :param option: the option to look for in the config file
+    :return: the specified value from the config file
+    """
+    value = CONFIG.get(section, option)
+    return value.lower() == 'true'
+
+
+def _unload_current_values():
+    """Removes current sections from the existing config object"""
+    for section in CONFIG.sections():
+        CONFIG.remove_section(section)
+
+
+def create_config():
+    """Creates the config file in the current directory"""
+    if os.path.isfile(CONFIG_FILE):
+        os.remove(CONFIG_FILE)
+    with open(CONFIG_FILE, 'wb') as configfile:
+        _unload_current_values()
+        CONFIG.write(configfile)
+
+
+def parse_arguments():
+    """Parses arguments from the command line"""
+    parser = argparse.ArgumentParser(
+        description='Config file generator')
+    parser.add_argument(
+        '--generate', action='store_true',
+        help='Generates a config file with default values')
+    return parser.parse_args()
+
+
+if __name__ == '__main__':
+    ARGUMENTS = parse_arguments()
+    if ARGUMENTS.generate:
+        create_config()
+        print('Config file created at: {name}'.format(name=CONFIG_FILE))
diff --git a/automated-robot-suite/Config/stx-duplex.yml b/automated-robot-suite/Config/stx-duplex.yml
new file mode 100644
index 0000000..bf3617d
--- /dev/null
+++ b/automated-robot-suite/Config/stx-duplex.yml
@@ -0,0 +1,16 @@
+system_mode: duplex
+
+dns_servers:
+  - 8.8.8.8
+
+docker_http_proxy: http://<url>:<port>
+docker_https_proxy: http://<url>:<port>
+
+external_oam_subnet: 10.10.10.0/24
+external_oam_gateway_address: 10.10.10.1
+external_oam_floating_address: 10.10.10.2
+external_oam_node_0_address: 10.10.10.3
+external_oam_node_1_address: 10.10.10.4
+
+ansible_become_pass: ANSIBLE_PASS
+admin_password: ADMIN_PASS
diff --git a/automated-robot-suite/Config/stx-multinode.yml b/automated-robot-suite/Config/stx-multinode.yml
new file mode 100644
index 0000000..bf3617d
--- /dev/null
+++ b/automated-robot-suite/Config/stx-multinode.yml
@@ -0,0 +1,16 @@
+system_mode: duplex
+
+dns_servers:
+  - 8.8.8.8
+
+docker_http_proxy: http://<url>:<port>
+docker_https_proxy: http://<url>:<port>
+
+external_oam_subnet: 10.10.10.0/24
+external_oam_gateway_address: 10.10.10.1
+external_oam_floating_address: 10.10.10.2
+external_oam_node_0_address: 10.10.10.3
+external_oam_node_1_address: 10.10.10.4
+
+ansible_become_pass: ANSIBLE_PASS
+admin_password: ADMIN_PASS
diff --git a/automated-robot-suite/Config/stx-simplex.yml b/automated-robot-suite/Config/stx-simplex.yml
new file mode 100644
index 0000000..cca8f24
--- /dev/null
+++ b/automated-robot-suite/Config/stx-simplex.yml
@@ -0,0 +1,12 @@
+dns_servers:
+  - 8.8.8.8
+
+docker_http_proxy: http://<url>:<port>
+docker_https_proxy: http://<url>:<port>
+
+external_oam_subnet: 10.10.10.0/24
+external_oam_gateway_address: 10.10.10.1
+external_oam_floating_address: 10.10.10.3
+
+ansible_become_pass: ANSIBLE_PASS
+admin_password: ADMIN_PASS
diff --git a/automated-robot-suite/Qemu/README.md b/automated-robot-suite/Qemu/README.md
new file mode 100644
index 0000000..d4cc402
--- /dev/null
+++ b/automated-robot-suite/Qemu/README.md
@@ -0,0 +1,155 @@
+[qemu_logo]: ./images/qemu_logo.png
+
+![alt text][qemu_logo]
+
+Table of Contents
+
+- [qemu_setup.yml](#qemu_setupyml)
+- [Description](#description)
+- [Examples](#examples)
+  - [1 controller + 2 compute](#1-controller--2-computes)
+    - [parameters](#parameters)
+  - [1 controller + 2 computes & 1 controller + 1 compute](#1-controller--2-computes--1-controller--1-compute)
+  - [Highlights](#highlights)
+  - [general_system_configurations section](#general_system_configurations-section)
+
+# qemu_setup.yml
+The purpose of this configurations file is to setup easily QEMU in the host.
+
+# Description
+YAML is a human-readable data serialization format that takes concepts from
+programming languages such as C, Perl, and Python, and ideas from XML and the
+data format of electronic mail.
+It is available for several programming languages.
+
+# Examples
+
+## 1 controller + 2 computes
+Please consider the following example to setup the following configuration:
+
+`1 controller + 2 computes`
+
+```yaml
+configuration_0:
+  controller-0:
+    controller_0_partition_a: 20
+    controller_0_partition_b: 10
+    controller_0_memory_size: 5120
+    controller_0_system_cores: 2
+  controller-0-compute-0:
+    controller_0_compute_0_partition_a: 20
+    controller_0_compute_0_partition_b: 20
+    controller_0_compute_0_memory_size: 3072
+    controller_0_compute_0_system_cores: 1
+  controller-0-compute-1:
+    controller_0_compute_1_partition_a: 20
+    controller_0_compute_1_partition_b: 20
+    controller_0_compute_1_memory_size: 3072
+    controller_0_compute_1_system_cores: 1
+````
+
+### parameters
+
+**`@param: configuration_0`**: which contains the controller and the computes.<br>
+
+**`@param: controller-0`**: which contains the following:<br>
+- `@param: controller_0_partition_a`: which is the controller 0 partition size
+    A in GB.
+- `@param: controller_0_partition_b`: which is the controller 0 partition size
+    B size in GB.
+- `@param: controller_0_memory_size`: which is the controller 0 memory size
+    in MB.
+- `@param: controller_0_system_cores`: which is the controller 0 system cores
+    to be assigned.
+
+**`@param: controller-0-compute-0`**: which contains the following:<br>
+- `@param: controller_0_compute_0_partition_a`: which is the controller's
+    compute 0 partition size A in GB.
+- `@param: controller_0_compute_0_partition_b`: which is the controller's
+    compute 0 partition size B in GB.
+- `@param: controller_0_compute_0_memory_size`: which is the controller's
+    compute 0 memory size B in MB.
+- `@param: controller_0_compute_0_system_cores`: which is the controller's
+    compute 0 system cores to be assigned.
+
+**`@param: controller-0-compute-1`**: which contains the following:<br>
+- `@param: controller_0_compute_1_partition_a`: which is the controller's
+    compute 1 partition size A in GB.
+- `@param: controller_0_compute_1_partition_b`: which is the controller's
+    compute 1 partition size B in GB.
+- `@param: controller_0_compute_1_memory_size`: which is the controller's
+    compute 1 memory size B in MB.
+- `@param: controller_0_compute_1_system_cores`: which is the controller's
+    compute 1 system cores to be assigned.
+
+## 1 controller + 2 computes & 1 controller + 1 compute
+Please consider the following example to setup the following configuration:
+
+`1 controller + 2 computes & 1 controller + 1 compute`
+
+```yaml
+configuration_0:
+  controller-0:
+    controller_0_partition_a: 20
+    controller_0_partition_b: 10
+    controller_0_memory_size: 5120
+    controller_0_system_cores: 2
+  controller-0-compute-0:
+    controller_0_compute_0_partition_a: 20
+    controller_0_compute_0_partition_b: 20
+    controller_0_compute_0_memory_size: 3072
+    controller_0_compute_0_system_cores: 1
+  controller-0-compute-1:
+    controller_0_compute_1_partition_a: 20
+    controller_0_compute_1_partition_b: 20
+    controller_0_compute_1_memory_size: 3072
+    controller_0_compute_1_system_cores: 1
+configuration_1:
+  controller-1:
+    controller_1_partition_a: 15
+    controller_1_partition_b: 10
+    controller_1_memory_size: 5120
+    controller_1_system_cores: 2
+  controller-1-compute-0:
+    controller_1_compute_0_partition_a: 20
+    controller_1_compute_0_partition_b: 20
+    controller_1_compute_0_memory_size: 3072
+    controller_1_compute_0_system_cores: 1
+```
+
+:notebook: the parameters description are the same that the [section above](#parameters).
+
+## Highlights
+Please consider the following when creating the yaml configuration file:
+
+- The total sum of the partitions must not exceed of the total free disk space
+    in the host.
+- The total sum of the memory size must not exceed of the total free memory
+    size in the host.
+- The total sum of the system cores must not exceed of the total system cores
+    subtracting the `os_system_cores` assigned in `general_system_configurations`
+    section.
+
+
+## general_system_configurations section
+The general_system_configurations will be explained below:
+
+```yaml
+general_system_configurations:
+  os_system_memory: 1024
+  disk_space_allocated_to_os: 20
+  os_system_cores: 2
+  default_mount_point: '/'
+```
+
+**`@param: general_system_configurations`**: which contains the following:
+- `@param: os_system_memory`: which is the system memory reserved for the OS.
+- `@param: disk_space_allocated_to_os`: which is the disk space reserved for
+    the OS.
+- `@param: os_system_cores`: which is the system cores reserved for the OS.
+- `@param: default_mount_point`: which is the mount point where the space in
+    disk will be analyzed by the script.
+
+:notebook: The first 3 params are used for system reservation and they are for
+the user's consideration in order to avoid that QEMU takes all the resources
+making slow the current system.
\ No newline at end of file
diff --git a/automated-robot-suite/Qemu/__init__.py b/automated-robot-suite/Qemu/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/automated-robot-suite/Qemu/compute.xml b/automated-robot-suite/Qemu/compute.xml
new file mode 100644
index 0000000..e5f6522
--- /dev/null
+++ b/automated-robot-suite/Qemu/compute.xml
@@ -0,0 +1,92 @@
+<domain type='kvm' id='187'>
+  <name>NAME</name>
+  <memory unit='UNIT'>MEMORY</memory>
+  <currentMemory unit='UNIT'>MEMORY</currentMemory>
+  <vcpu placement='static'>CORES</vcpu>
+  <resource>
+    <partition>/machine</partition>
+  </resource>
+  <os>
+    <type arch='x86_64' machine='pc'>hvm</type>
+  </os>
+  <features>
+    <acpi/>
+    <apic/>
+    <pae/>
+  </features>
+  <cpu match='exact'>
+    <model fallback='forbid'>Nehalem</model>
+    <topology sockets='1' cores='CORES' threads='1'/>
+    <feature policy='require' name='vmx'/>
+    <feature policy='optional' name='svm'/>
+  </cpu>
+  <clock offset='utc'/>
+  <on_poweroff>destroy</on_poweroff>
+  <on_reboot>restart</on_reboot>
+  <on_crash>destroy</on_crash>
+  <devices>
+    <emulator>/usr/bin/qemu-system-x86_64</emulator>
+    <disk type='file' device='disk'>
+      <driver name='qemu' type='qcow2'/>
+      <source file='DISK0'/>
+      <backingStore/>
+      <target dev='sda' bus='sata'/>
+      <boot order='1'/>
+    </disk>
+    <disk type='file' device='disk'>
+      <driver name='qemu' type='qcow2'/>
+      <source file='DISK1'/>
+      <backingStore/>
+      <target dev='sdb' bus='sata'/>
+    </disk>
+    <interface type='bridge'>
+      <source bridge='stxbr1'/>
+      <target dev='vnet8'/>
+      <model type='e1000'/>
+      <alias name='net0'/>
+    </interface>
+    <interface type='bridge'>
+      <source bridge='stxbr2'/>
+      <target dev='vnet9'/>
+      <model type='e1000'/>
+      <boot order='2'/>
+      <alias name='net1'/>
+    </interface>
+    <interface type='bridge'>
+      <source bridge='stxbr3'/>
+      <target dev='vnet10'/>
+      <model type='virtio'/>
+      <alias name='net2'/>
+    </interface>
+    <interface type='bridge'>
+      <source bridge='stxbr4'/>
+      <target dev='vnet11'/>
+      <model type='virtio'/>
+      <alias name='net3'/>
+    </interface>
+    <serial type='pty'>
+      <source path='/dev/pts/12'/>
+      <target port='0'/>
+      <alias name='serial0'/>
+    </serial>
+    <console type='pty' tty='/dev/pts/12'>
+      <source path='/dev/pts/12'/>
+      <target type='serial' port='0'/>
+      <alias name='serial0'/>
+    </console>
+    <input type='mouse' bus='ps2'/>
+    <input type='keyboard' bus='ps2'/>
+    <graphics type='vnc' port='5903' autoport='yes' listen='127.0.0.1' keymap='en-us'>
+      <listen type='address' address='127.0.0.1'/>
+    </graphics>
+    <video>
+      <model type='cirrus' vram='16384' heads='1'/>
+      <alias name='video0'/>
+      <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x0'/>
+    </video>
+    <memballoon model='virtio'>
+      <alias name='balloon0'/>
+      <address type='pci' domain='0x0000' bus='0x00' slot='0x05' function='0x0'/>
+    </memballoon>
+  </devices>
+</domain>
diff --git a/automated-robot-suite/Qemu/configs/duplex.yaml b/automated-robot-suite/Qemu/configs/duplex.yaml
new file mode 100644
index 0000000..d1ab32b
--- /dev/null
+++ b/automated-robot-suite/Qemu/configs/duplex.yaml
@@ -0,0 +1,18 @@
+Controllers:
+  controller-0:
+    partition_a: 600
+    partition_b: 100
+    partition_d: 100
+    memory_size: 25600
+    system_cores: 6
+  controller-1:
+    partition_a: 600
+    partition_b: 100
+    partition_d: 100
+    memory_size: 25600
+    system_cores: 6
+general_system_configurations:
+  os_system_memory: 1024
+  disk_space_allocated_to_os: 20
+  os_system_cores: 2
+  default_mount_point: '/'
diff --git a/automated-robot-suite/Qemu/configs/multinode_controller_storage.yaml b/automated-robot-suite/Qemu/configs/multinode_controller_storage.yaml
new file mode 100644
index 0000000..2435b90
--- /dev/null
+++ b/automated-robot-suite/Qemu/configs/multinode_controller_storage.yaml
@@ -0,0 +1,29 @@
+Controllers:
+  controller-0:
+    partition_a: 250
+    partition_b: 250
+    partition_d: 50
+    memory_size: 16384
+    system_cores: 4
+  controller-1:
+    partition_a: 250
+    partition_b: 250
+    partition_d: 50
+    memory_size: 16384
+    system_cores: 4
+Computes:
+  compute-0:
+    partition_a: 250
+    partition_b: 250
+    memory_size: 10240
+    system_cores: 3
+  compute-1:
+    partition_a: 250
+    partition_b: 250
+    memory_size: 10240
+    system_cores: 3
+general_system_configurations:
+  os_system_memory: 1024
+  disk_space_allocated_to_os: 20
+  os_system_cores: 2
+  default_mount_point: '/'
diff --git a/automated-robot-suite/Qemu/configs/multinode_dedicated_storage.yaml b/automated-robot-suite/Qemu/configs/multinode_dedicated_storage.yaml
new file mode 100644
index 0000000..27116b5
--- /dev/null
+++ b/automated-robot-suite/Qemu/configs/multinode_dedicated_storage.yaml
@@ -0,0 +1,42 @@
+Controllers:
+  controller-0:
+    partition_a: 250
+    partition_b: 250
+    partition_d: 50
+    memory_size: 16384
+    system_cores: 4
+  controller-1:
+    partition_a: 250
+    partition_b: 250
+    partition_d: 50
+    memory_size: 16384
+    system_cores: 4
+Computes:
+  compute-0:
+    partition_a: 250
+    partition_b: 250
+    memory_size: 10240
+    system_cores: 3
+  compute-1:
+    partition_a: 250
+    partition_b: 250
+    memory_size: 10240
+    system_cores: 3
+Storages:
+  storage-0:
+    partition_a: 250
+    partition_b: 250
+    partition_d: 50
+    memory_size: 6144
+    system_cores: 3
+  storage-1:
+    partition_a: 250
+    partition_b: 250
+    partition_d: 50
+    memory_size: 6144
+    system_cores: 3
+general_system_configurations:
+  os_system_memory: 1024
+  disk_space_allocated_to_os: 20
+  os_system_cores: 2
+  default_mount_point: '/'
diff --git a/automated-robot-suite/Qemu/configs/simplex.yaml b/automated-robot-suite/Qemu/configs/simplex.yaml
new file mode 100644
index 0000000..681b69e
--- /dev/null
+++ b/automated-robot-suite/Qemu/configs/simplex.yaml
@@ -0,0 +1,12 @@
+Controllers:
+  controller-0:
+    partition_a: 600
+    partition_b: 100
+    partition_d: 100
+    memory_size: 25600
+    system_cores: 6
+general_system_configurations:
+  os_system_memory: 1024
+  disk_space_allocated_to_os: 20
+  os_system_cores: 2
+  default_mount_point: '/'
diff --git a/automated-robot-suite/Qemu/images/qemu_logo.png b/automated-robot-suite/Qemu/images/qemu_logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..d0106d6397616bccdfde0e4fe2433749ae91d1de
GIT binary patch
literal 19079
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
J*Jcx({a>>etMdQ=

literal 0
HcmV?d00001

diff --git a/automated-robot-suite/Qemu/master_controller.xml b/automated-robot-suite/Qemu/master_controller.xml
new file mode 100644
index 0000000..ddb5cbf
--- /dev/null
+++ b/automated-robot-suite/Qemu/master_controller.xml
@@ -0,0 +1,106 @@
+<domain type='kvm' id='164'>
+  <name>NAME</name>
+  <memory unit='UNIT'>MEMORY</memory>
+  <currentMemory unit='UNIT'>MEMORY</currentMemory>
+  <vcpu placement='static'>CORES</vcpu>
+  <resource>
+    <partition>/machine</partition>
+  </resource>
+  <os>
+    <type arch='x86_64' machine='pc'>hvm</type>
+  </os>
+  <features>
+    <acpi/>
+    <apic/>
+    <pae/>
+  </features>
+  <cpu match='exact'>
+    <model fallback='forbid'>Nehalem</model>
+    <topology sockets='1' cores='CORES' threads='1'/>
+    <feature policy='optional' name='vmx'/>
+    <feature policy='optional' name='svm'/>
+  </cpu>
+  <clock offset='utc'/>
+  <on_poweroff>destroy</on_poweroff>
+  <on_reboot>restart</on_reboot>
+  <on_crash>destroy</on_crash>
+  <devices>
+    <emulator>/usr/bin/qemu-system-x86_64</emulator>
+    <disk type='file' device='disk'>
+      <driver name='qemu' type='qcow2'/>
+      <source file='DISK0'/>
+      <backingStore/>
+      <target dev='sda' bus='sata'/>
+      <boot order='1'/>
+    </disk>
+    <disk type='file' device='disk'>
+      <driver name='qemu' type='qcow2'/>
+      <source file='DISK1'/>
+      <backingStore/>
+      <target dev='sdb' bus='sata'/>
+    </disk>
+    <disk type='file' device='disk'>
+      <driver name='qemu' type='qcow2'/>
+      <source file='DISK2'/>
+      <backingStore/>
+      <target dev='sdd' bus='sata'/>
+    </disk>
+    <disk type='file' device='cdrom'>
+      <driver name='qemu' type='raw'/>
+      <source file='ISO'/>
+      <backingStore/>
+      <target dev='sdc' bus='sata'/>
+      <readonly/>
+      <boot order='2'/>
+    </disk>
+    <interface type='network'>
+      <source network='stx-nat'/>
+      <target dev='vnet0'/>
+      <model type='e1000'/>
+      <alias name='net0'/>
+    </interface>
+    <interface type='bridge'>
+      <source bridge='stxbr2'/>
+      <target dev='vnet1'/>
+      <model type='e1000'/>
+      <alias name='net1'/>
+    </interface>
+    <interface type='bridge'>
+      <source bridge='stxbr3'/>
+      <target dev='vnet2'/>
+      <model type='virtio'/>
+      <alias name='net2'/>
+    </interface>
+    <interface type='bridge'>
+      <source bridge='stxbr4'/>
+      <target dev='vnet3'/>
+      <model type='virtio'/>
+      <alias name='net3'/>
+    </interface>
+    <serial type='pty'>
+      <source path='/dev/pts/8'/>
+      <target port='0'/>
+      <alias name='serial0'/>
+    </serial>
+    <console type='pty' tty='/dev/pts/8'>
+      <source path='/dev/pts/8'/>
+      <target type='serial' port='0'/>
+      <alias name='serial0'/>
+    </console>
+    <input type='mouse' bus='ps2'/>
+    <input type='keyboard' bus='ps2'/>
+    <graphics type='vnc' port='5900' autoport='yes' listen='127.0.0.1' keymap='en-us'>
+      <listen type='address' address='127.0.0.1'/>
+    </graphics>
+    <video>
+      <model type='cirrus' vram='16384' heads='1'/>
+      <alias name='video0'/>
+      <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x0'/>
+    </video>
+    <memballoon model='virtio'>
+      <alias name='balloon0'/>
+      <address type='pci' domain='0x0000' bus='0x00' slot='0x05' function='0x0'/>
+    </memballoon>
+  </devices>
+</domain>
+
diff --git a/automated-robot-suite/Qemu/nat-network.xml b/automated-robot-suite/Qemu/nat-network.xml
new file mode 100644
index 0000000..7895878
--- /dev/null
+++ b/automated-robot-suite/Qemu/nat-network.xml
@@ -0,0 +1,7 @@
+<network>
+	<name>stx-nat</name>
+	<bridge name="stxbr1" stp="off"/>
+	<forward mode="nat"/>
+	<ip address="10.10.10.1" netmask="255.255.255.0">
+	</ip>
+</network>
diff --git a/automated-robot-suite/Qemu/qemu_setup.py b/automated-robot-suite/Qemu/qemu_setup.py
new file mode 100644
index 0000000..0e5b589
--- /dev/null
+++ b/automated-robot-suite/Qemu/qemu_setup.py
@@ -0,0 +1,638 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""This module setup the controller(s)/computes(s) in the current host"""
+
+from __future__ import print_function
+
+import argparse
+from argparse import RawDescriptionHelpFormatter
+from imp import reload
+import multiprocessing
+import os
+import re
+from shutil import copy
+from shutil import rmtree
+import sys
+
+# this needs to be exactly here after call network.delete_network_interfaces()
+# otherwise the suite local modules they will not be recognized
+# hence adding `noqa` to avoid linter issues.
+SUITE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+sys.path.append(SUITE_DIR)
+
+from Config import config  # noqa: E402
+from Utils import bash_utils as bash  # noqa: E402
+from Utils import logger  # noqa: E402
+from Utils import network  # noqa: E402
+from Utils import utils  # noqa: E402
+import kmodpy  # noqa: E402
+import yaml  # noqa: E402
+
+# reloading config.ini
+reload(config)
+
+# Global variables
+THIS_PATH = os.path.dirname(os.path.abspath(__file__))
+
+# setup the logger
+LOG_FILENAME = 'qemu_setup.log'
+LOG_PATH = config.get('general', 'LOG_PATH')
+LOG = logger.setup_logging(
+    'qemu_setup', log_file='{path}/{filename}'.format(
+        path=LOG_PATH, filename=LOG_FILENAME), console_log=False)
+
+
+def enable_nat_network():
+    """Enable NAT network for VMs
+
+    This function creates a NAT network to allow VM external connection
+    needed for download docker images.
+
+    """
+
+    nat_xml = os.path.join(THIS_PATH, 'nat-network.xml')
+    nat_net_name = 'stx-nat'
+    bash.run_command('sudo virsh net-define {}'.format(nat_xml))
+    bash.run_command('sudo virsh net-start {}'.format(nat_net_name))
+
+
+def exit_dict_status(code):
+    """Exit status
+
+    The aim of this function is to provide a exit status in dictionary format
+    as an string in order to grab it for robot for perform actions.
+
+    :param code: which is the exit status code
+        code 0: which represents an exit status god.
+        code 1: which represents an exit status bad.
+    """
+    # defining the dictionary
+
+    if code == 1:
+        LOG.info('status: FAIL')
+    elif code == 0:
+        LOG.info('status: PASS')
+    else:
+        LOG.error('exit code not valid')
+
+    sys.exit(code)
+
+
+def check_kernel_virtualization():
+    """Check kernel virtualization
+
+    Checks if Virtualization Technology is enabled in the BIOS and it is
+    present in the kernel as a module.
+    QEMU requires KVM (Kernel Virtualization Module) to run the nodes.
+    """
+    _km = kmodpy.Kmod()
+    module_list = [m for m in _km.list()]
+
+    virtualization = filter(lambda mod: mod[0] == 'kvm_intel', module_list)
+
+    if not virtualization:
+        message = ('KVM (vmx) is disabled by your BIOS\nEnter your BIOS setup '
+                   'and enable Virtualization Technology (VT), and then hard '
+                   'power off/power on your system')
+        raise OSError(message)
+
+
+def check_preconditions():
+    """Check host preconditions
+
+    The aim of this function is to check the requirements to run QEMU in the
+    host.
+    """
+    # if this script is running through ssh connection the following
+    # environment variable needs to be setup in the host bashrc
+    if 'DISPLAY' not in os.environ:
+        LOG.info('configuring DISPLAY environment variable')
+        os.environ['DISPLAY'] = ':0'
+
+
+def get_system_memory(configurations):
+    """Get the system memory
+
+    The aim of this function is to get the system memory to be setup with QEMU.
+
+    :param: configurations
+        - which is an object with the values loaded from the yaml.
+    :return:
+        - system_free_memory: which is the total system free memory.
+        - recommended_system_free_memory: which is the recommended system free
+            memory.
+    """
+
+    # calculating the system memory to be assigned (value in megabytes)
+    # os_system_memory will return 0 if either key1 or key2 does not exists
+    os_system_memory = configurations.get(
+        'general_system_configurations', 0).get("os_system_memory", 0)
+    system_free_memory = map(
+        int, os.popen('free -m | grep Mem').readlines()[-1][4:].split())[-1]
+    # subtracting OS system memory
+    recommended_system_free_memory = system_free_memory - os_system_memory
+
+    return system_free_memory, recommended_system_free_memory
+
+
+def get_free_disk_space(configurations):
+    """Get the system free disk space
+
+    The aim of this function if to get the system free disk in order to setup
+    with QEMU.
+
+    :param: configurations
+        - which is an object with the values loaded from the yaml.
+    :return
+        - system_free_disk_size: which is the total system free disk size in GB
+        - r_system_free_disk_size: which is the recommended system
+            free disk size in GB subtracting the disk_space_allocated_to_os
+            from yaml configuration file for the host OS in order to avoid
+            low performance.
+    """
+    # disk_space_allocated_to_os will return 0 if either key1 or key2 does
+    # not exists
+    disk_space_allocated_to_os = configurations.get(
+        'general_system_configurations', 0).get(
+            "disk_space_allocated_to_os", 0)
+    # the mount point in which will be calculated the free space in disk
+    default_mount_point = configurations.get(
+        'general_system_configurations', 0).get(
+            "default_mount_point", '/')
+    statvfs = os.statvfs(default_mount_point)
+    # the following value will be get in megabytes
+    system_free_disk_size = statvfs.f_frsize * statvfs.f_bavail / 1000000000
+    # subtracting the 20% of the total disk free
+    r_system_free_disk_size = (
+        (100 - disk_space_allocated_to_os) * system_free_disk_size / 100)
+
+    return system_free_disk_size, r_system_free_disk_size
+
+
+def get_system_resources(configurations):
+    """Get resources from the current host
+
+    The aim of this function is to get resources for the virtual environment
+    with QEMU in order to setup properly it and avoid configuration issues.
+
+    :param: configurations
+        - which is an object with the values loaded from the yaml.
+    :return:
+        - recommended_system_free_memory: which is the recommended system free
+            memory to be setup with QEMU.
+        - system_free_disk_size: which is the total system free disk size.
+        - r_system_free_disk_size: which is the recommended  system
+        - r_system_free_disk_size: which is the recommended  system
+            free disk size.
+        - recommended_system_cores: which is the recommended system cores to be
+        setup with QEMU.
+    """
+    # os_system_cores will return 0 if either key1 or key2 does not exists
+    os_system_cores = configurations.get(
+        'general_system_configurations', 0).get("os_system_cores", 0)
+
+    # Getting the system free memory and the recommended system memory
+    _, recommended_system_free_memory = get_system_memory(
+        configurations)
+
+    # Getting the system free disk size and the recommended system free (GB)
+    system_free_disk_size, r_system_free_disk_size = (
+        get_free_disk_space(configurations))
+
+    # Calculating the system cores to be assigned to the controller/computes
+    recommended_system_cores = multiprocessing.cpu_count() - os_system_cores
+
+    return (
+        recommended_system_free_memory,
+        system_free_disk_size, r_system_free_disk_size,
+        recommended_system_cores)
+
+
+def check_system_resources(configurations):
+    """Check basic configurations.
+
+    The aim of this function is to check the following aspects before to
+    proceed to configure the nodes.
+    - checks if the disk setup by the user in the yaml is less than the
+        recommended free space
+    - checks if the memory size setup by the user in the yaml is less than the
+        recommended memory size.
+    - checks if the system cores setup by the user in the yaml is less than the
+        recommended system cores.
+
+    :param configurations: which is the object that contains all the
+        configurations from the yaml file.
+    """
+    # checking how many configurations the yaml file has
+    configurations_keys = configurations.keys()
+    regex = re.compile('configuration_.')
+    total_configurations = list(filter(regex.match, configurations_keys))
+
+    # getting the system recommendations
+    (recommended_system_free_memory, _,
+     r_system_free_disk_size,
+     recommended_system_cores) = get_system_resources(configurations)
+
+    # iterating over the total configurations setup in yaml file in order to
+    # get the disk/memory space assigned by the user
+    user_memory_defined, user_disk_space_defined, user_system_cores_defined = (
+        0, 0, 0)
+
+    for configuration in range(0, len(total_configurations)):
+        # iterating over the configurations
+
+        current_controller = 'controller-{}'.format(configuration)
+        # controller will return NoneType if either key1 or key2 does
+        # not exists
+        controller = configurations.get(
+            'configuration_{}'.format(configuration), {}).get(
+                'controller-{}'.format(configuration), {})
+        controller_partition_a = int(controller.get(
+            'controller_{}_partition_a'.format(configuration)))
+        controller_partition_b = int(controller.get(
+            'controller_{}_partition_b'.format(configuration)))
+        controller_partition_d = int(controller.get(
+            'controller_{}_partition_d'.format(configuration)))
+        controller_memory = int(controller.get(
+            'controller_{}_memory_size'.format(configuration)))
+        controller_system_cores = int(controller.get(
+            'controller_{}_system_cores'.format(configuration)))
+
+        # checking if the current controller at least has 1 cpu assigned in
+        # order to avoid the following error:
+        # error: XML error: Invalid CPU topology
+        if controller_system_cores < 1:
+            LOG.error('{}: must have assigned at least 1 core'.format(
+                current_controller))
+            exit_dict_status(1)
+
+        # checking how many computes the current controller has
+        compute_keys = configurations.get('configuration_{}'.format(
+            configuration), {}).keys()
+        regex = re.compile('controller-{0}-compute-.'.format(configuration))
+        total_computes = list(filter(regex.match, compute_keys))
+
+        for compute_number in range(0, len(total_computes)):
+            current_compute = '{0}-compute-{1}'.format(
+                current_controller, compute_number)
+            # compute will return NoneType if either key1 or key2 does
+            # not exists  controller_1_compute_2:
+            compute = configurations.get('configuration_{}'.format(
+                configuration), {}).get(
+                    'controller-{0}-compute-{1}'.format(
+                        configuration, compute_number), {})
+            compute_partition_a = int(compute.get(
+                'controller_{0}_compute_{1}_partition_a'.format(
+                    configuration, compute_number)))
+            compute_partition_b = int(compute.get(
+                'controller_{0}_compute_{1}_partition_b'.format(
+                    configuration, compute_number)))
+            compute_memory = int(compute.get(
+                'controller_{0}_compute_{1}_memory_size'.format(
+                    configuration, compute_number)))
+            compute_system_cores = int(compute.get(
+                'controller_{0}_compute_{1}_system_cores'.format(
+                    configuration, compute_number)))
+
+            # checking if the current compute at least has 1 cpu assigned in
+            # order to avoid the following error:
+            # error: XML error: Invalid CPU topology
+            if compute_system_cores < 1:
+                LOG.error('{}: must have assigned at least 1 core'.format(
+                    current_compute))
+                exit_dict_status(1)
+
+            # increasing the variables (computes loop)
+            user_disk_space_defined = (
+                user_disk_space_defined + compute_partition_a +
+                compute_partition_b)
+            user_memory_defined = user_memory_defined + compute_memory
+            user_system_cores_defined = (
+                user_system_cores_defined + compute_system_cores)
+
+        # increasing the variables (controller loop)
+        user_disk_space_defined = (
+            user_disk_space_defined + controller_partition_a +
+            controller_partition_b + controller_partition_d)
+        user_memory_defined = user_memory_defined + controller_memory
+        user_system_cores_defined = (
+            user_system_cores_defined + controller_system_cores)
+
+    # checking the conditions defined in the yaml
+    if user_memory_defined > recommended_system_free_memory:
+        LOG.error(
+            'the memory defined in the yaml is greater than the recommended '
+            'free memory')
+        LOG.error('user memory defined            : {}'.format(
+            user_memory_defined))
+        LOG.error('recommended system free memory : {}'.format(
+            recommended_system_free_memory))
+        exit_dict_status(1)
+    elif user_disk_space_defined > r_system_free_disk_size:
+        LOG.error(
+            'the disk space defined in the yaml is greater than the '
+            'recommended free disk size')
+        LOG.error('user disk space defined            : {}'.format(
+            user_disk_space_defined))
+        LOG.error('recommended system free disk size  : {}'.format(
+            r_system_free_disk_size))
+        exit_dict_status(1)
+    elif user_system_cores_defined > recommended_system_cores:
+        LOG.error(
+            'the system cores defined in the yaml is greater than the '
+            'recommended system cores')
+        LOG.error('user system cores defined  : {}'.format(
+            user_system_cores_defined))
+        LOG.error('recommended  system cores  : {}'.format(
+            recommended_system_cores))
+        exit_dict_status(1)
+
+
+def setup_controller_computes(iso_file, configurations):
+    """Setup the configurations in the host
+
+    This function setup the network and the configurations from yaml in the
+    current host.
+
+    :param iso_file: which is the absolute/relative path to the iso file which
+    will be setup in the controller(s) node(s).
+    :param configurations: which is the object that has all the configurations
+        to be setup in the system.
+    """
+    # define the module's variables
+    libvirt_images_path = '/var/lib/libvirt/images'
+
+    # ----------------------------------
+    # customize Qemu configuration files
+    # ----------------------------------
+    utils.qemu_configuration_files()
+
+    # ----------------------------------
+    # configuring the network interfaces
+    # ----------------------------------
+    network.delete_network_interfaces()
+    enable_nat_network()
+    network.configure_network_interfaces()
+
+    # ------------------------------
+    # clean qemu/libvirt environment
+    # ------------------------------
+    utils.clean_qemu_environment()
+
+    if os.path.exists(os.path.join(THIS_PATH, 'vms')):
+        rmtree(os.path.join(THIS_PATH, 'vms'))
+
+    os.mkdir(os.path.join(THIS_PATH, 'vms'))
+
+    # ----------------------------------------------------------
+    # iterating over the total configurations setup in yaml file
+    # ----------------------------------------------------------
+
+    for controller, values in configurations.get('Controllers').items():
+        # iterating over the controllers
+        controller_partition_a = int(values.get('partition_a'))
+        controller_partition_b = int(values.get('partition_b'))
+        controller_partition_d = int(values.get('partition_d'))
+        controller_memory = int(values.get('memory_size'))
+        controller_system_cores = int(values.get('system_cores'))
+
+        # creating controller's partitions in the system
+        bash.run_command(
+            'sudo qemu-img create -f qcow2 {0}/{1}-0.img {2}G'.format(
+                libvirt_images_path, controller, controller_partition_a),
+            raise_exception=True)
+        bash.run_command(
+            'sudo qemu-img create -f qcow2 {0}/{1}-1.img {2}G'.format(
+                libvirt_images_path, controller, controller_partition_b),
+            raise_exception=True)
+        bash.run_command(
+            'sudo qemu-img create -f qcow2 {0}/{1}-2.img {2}G'.format(
+                libvirt_images_path, controller, controller_partition_d),
+            raise_exception=True)
+
+        # Only controller-0 needs to have the ISO file in order to boot the
+        # subsequent controllers
+        # heck_controller = False if configuration == 'controller-0' else True
+
+        if controller == 'controller-0':
+            bash.run_command(
+                'sed -e "s,NAME,{0}," '
+                '-e "s,ISO,{1}," '
+                '-e "s,UNIT,MiB," '
+                '-e "s,MEMORY,{2}," '
+                '-e "s,CORES,{3}," '
+                '-e "s,DISK0,{4}/{0}-0.img," '
+                '-e "s,DISK1,{4}/{0}-1.img," '
+                '-e "s,DISK2,{4}/{0}-2.img," '
+                '-e "s,destroy,restart," {5}/master_controller.xml > '
+                '{5}/vms/{0}.xml'.format(
+                    controller, iso_file, controller_memory,
+                    controller_system_cores, libvirt_images_path, THIS_PATH),
+                raise_exception=True)
+        else:
+            # this mean that is the controller-N
+            # modifying xml parameters for the current controller
+            bash.run_command(
+                'sed -e "s,NAME,{0}," '
+                '-e "s,UNIT,MiB," '
+                '-e "s,MEMORY,{1}," '
+                '-e "s,CORES,{2}," '
+                '-e "s,DISK0,{3}/{0}-0.img," '
+                '-e "s,DISK1,{3}/{0}-1.img," '
+                '-e "s,DISK2,{3}/{0}-2.img," '
+                '-e "s,destroy,restart," {4}/slave_controller.xml > '
+                '{4}/vms/{0}.xml'.format(
+                    controller, controller_memory,
+                    controller_system_cores, libvirt_images_path, THIS_PATH),
+                raise_exception=True)
+
+        # the following command define a domain and it does not start it and
+        # makes it persistent even after shutdown
+        bash.run_command('sudo virsh define {0}/vms/{1}.xml'.format(
+            THIS_PATH, controller))
+
+        # starting only the controller-0 which is the one with ISO in the xml
+        if controller == 'controller-0':
+            # the following command start a domain
+            bash.run_command('sudo virsh start {}'.format(
+                controller), raise_exception=True)
+
+    if 'Computes' in configurations:
+        for compute, values in configurations.get('Computes').items():
+            # iterating over the computes
+            compute_partition_a = int(values.get('partition_a'))
+            compute_partition_b = int(values.get('partition_b'))
+            compute_memory = int(values.get('memory_size'))
+            compute_system_cores = int(values.get('system_cores'))
+
+            # copy the compute.xml to vms folder
+            origin = os.path.join(THIS_PATH, 'compute.xml')
+            destination = os.path.join(THIS_PATH,
+                'vms', '{}.xml'.format(compute))
+
+            copy(origin, destination)
+
+            # creating both compute's partitions in the system
+            bash.run_command(
+                'sudo qemu-img create -f qcow2 {0}/{1}-0.img {2}G'.format(
+                    libvirt_images_path, compute, compute_partition_a),
+                raise_exception=True)
+            bash.run_command(
+                'sudo qemu-img create -f qcow2 {0}/{1}-1.img {2}G'.format(
+                    libvirt_images_path, compute, compute_partition_b),
+                raise_exception=True)
+
+            # modifying xml compute parameters
+            bash.run_command(
+                'sed -i -e "s,NAME,{0}," '
+                '-e "s,UNIT,MiB," '
+                '-e "s,MEMORY,{1}," '
+                '-e "s,CORES,{2}," '
+                '-e "s,destroy,restart," '
+                '-e "s,DISK0,{3}/{0}-0.img," '
+                '-e "s,DISK1,{3}/{0}-1.img," '
+                '{4}/vms/{0}.xml'.format(compute, compute_memory,
+                    compute_system_cores, libvirt_images_path, THIS_PATH),
+                raise_exception=True)
+
+            # creating the computes according to the XML, the following command
+            # create a domain but it does not start it and makes it persistent
+            # even after shutdown
+            bash.run_command('sudo virsh define {0}/vms/{1}.xml'.format(
+                THIS_PATH, compute))
+
+    if 'Storages' in configurations:
+        for storage, values in configurations.get('Storages').items():
+            # iterating over the storage
+            storage_partition_a = int(values.get('partition_a'))
+            storage_partition_b = int(values.get('partition_b'))
+            storage_memory = int(values.get('memory_size'))
+            storage_system_cores = int(values.get('system_cores'))
+
+            # copy the storage.xml to vms folder
+            origin = os.path.join(THIS_PATH, 'storage.xml')
+            destination = os.path.join(THIS_PATH,
+                'vms', '{}.xml'.format(storage))
+
+            copy(origin, destination)
+
+            # creating both storage's partitions in the system
+            bash.run_command(
+                'sudo qemu-img create -f qcow2 {0}/{1}-0.img {2}G'.format(
+                    libvirt_images_path, storage, storage_partition_a),
+                raise_exception=True)
+            bash.run_command(
+                'sudo qemu-img create -f qcow2 {0}/{1}-1.img {2}G'.format(
+                    libvirt_images_path, storage, storage_partition_b),
+                raise_exception=True)
+
+            # modifying xml storage parameters
+            bash.run_command(
+                'sed -i -e "s,NAME,{0}," '
+                '-e "s,UNIT,MiB," '
+                '-e "s,MEMORY,{1}," '
+                '-e "s,CORES,{2}," '
+                '-e "s,destroy,restart," '
+                '-e "s,DISK0,{3}/{0}-0.img," '
+                '-e "s,DISK1,{3}/{0}-1.img," '
+                '{4}/vms/{0}.xml'.format(storage, storage_memory,
+                    storage_system_cores, libvirt_images_path, THIS_PATH),
+                raise_exception=True)
+
+            # creating the storage according to the XML, the following command
+            # create a domain but it does not start it and makes it persistent
+            # even after shutdown
+            bash.run_command('sudo virsh define {0}/vms/{1}.xml'.format(
+                THIS_PATH, storage))
+
+    # opening the graphical interface
+    if bash.is_process_running('virt-manager'):
+        # in order that virt-manager takes the new configurations from the yaml
+        # file, is needed to kill it and start again.
+        LOG.info('Virtual Machine Manager is active, killing it ...')
+        bash.run_command('sudo kill -9 $(pgrep -x virt-manager)',
+                         raise_exception=True)
+
+    # opening Virtual Machine Manager
+    bash.run_command('sudo virt-manager', raise_exception=True)
+    # opening the controller console
+    bash.run_command('virt-manager -c qemu:///system --show-domain-console '
+                     'controller-0', raise_exception=True)
+    exit_dict_status(0)
+
+
+def setup_qemu(iso_file, configuration_file):
+    """Setup StarlingX
+
+    The aim of this function is to setup StarlingX in a smart way in order
+    to avoid configuration issues.
+
+    :param iso_file: the iso file to be configured in the controller(s).
+    :param configuration_file: the yaml configuration file.
+    """
+    # before to run anything, KVM needs to be checked it this is present in the
+    # current host
+    check_kernel_virtualization()
+
+    # check the host requirements
+    check_preconditions()
+
+    # loading all the configurations from yaml file
+    configurations = yaml.safe_load(open(configuration_file))
+
+    # fixme(Humberto): check_system_resources is commented out due
+    # check is giving problems when configuring an instance on qemu virtual
+    # machine, for now this will be commented until more investigation is done
+
+    # this part will check the values given in the yaml
+    # check_system_resources(configurations)
+
+    # setting the controller/computes nodes
+    setup_controller_computes(iso_file, configurations)
+
+
+def arguments():
+    """Provides a set of arguments
+
+    Defined arguments must be specified in this function in order to interact
+    with the others functions in this module.
+    """
+
+    parser = argparse.ArgumentParser(
+        formatter_class=RawDescriptionHelpFormatter, description='''
+Program description:
+This is a tool for setup virtual environments with libvirt/Qemu in the host.
+maintainer : humberto.i.perez.rodriguez@intel.com''',
+        epilog='StarlingX |https://opendev.org/starlingx/test/',
+        usage='%(prog)s [options]')
+    group_mandatory = parser.add_argument_group('mandatory arguments')
+    group_mandatory.add_argument(
+        '-i', '--iso', dest='iso', required=True,
+        help='the iso file to be setup in the controller')
+    parser.add_argument(
+        '-c', '--configuration', dest='configuration',
+        help='the Qemu configuration file in yaml format. The default '
+             'configuration file is qemu_setup.yaml in this folder')
+    args = parser.parse_args()
+
+    # checks if the iso file given exists
+    if not os.path.isfile(args.iso):
+        print('{0}: does not exists, please verify it'.format(args.iso))
+        exit_dict_status(1)
+
+    # checks if the configuration exists
+    configuration_file = os.path.join(THIS_PATH, 'qemu_setup.yaml')
+    if args.configuration:
+        configuration_file = args.configuration
+
+    if not os.path.exists(configuration_file):
+        print('{0}: does not exists, please verify it'.format(
+            configuration_file))
+        exit_dict_status(1)
+
+    setup_qemu(args.iso, configuration_file)
+
+
+if __name__ == '__main__':
+    arguments()
diff --git a/automated-robot-suite/Qemu/qemu_setup.yaml b/automated-robot-suite/Qemu/qemu_setup.yaml
new file mode 100644
index 0000000..11fc37b
--- /dev/null
+++ b/automated-robot-suite/Qemu/qemu_setup.yaml
@@ -0,0 +1,32 @@
+configuration_0:
+  controller-0:
+    controller_0_partition_a: 200
+    controller_0_partition_b: 200
+    controller_0_memory_size: 10240
+    controller_0_system_cores: 4
+  controller-0-compute-0:
+    controller_0_compute_0_partition_a: 200
+    controller_0_compute_0_partition_b: 200
+    controller_0_compute_0_memory_size: 16384
+    controller_0_compute_0_system_cores: 4
+  controller-0-compute-1:
+    controller_0_compute_1_partition_a: 200
+    controller_0_compute_1_partition_b: 200
+    controller_0_compute_1_memory_size: 16384
+    controller_0_compute_1_system_cores: 4
+configuration_1:
+  controller-1:
+    controller_1_partition_a: 200
+    controller_1_partition_b: 200
+    controller_1_memory_size: 10240
+    controller_1_system_cores: 4
+  controller-1-compute-0:
+    controller_1_compute_0_partition_a: 200
+    controller_1_compute_0_partition_b: 200
+    controller_1_compute_0_memory_size: 3072
+    controller_1_compute_0_system_cores: 2
+general_system_configurations:
+  os_system_memory: 1024
+  disk_space_allocated_to_os: 20
+  os_system_cores: 2
+  default_mount_point: '/'
diff --git a/automated-robot-suite/Qemu/slave_controller.xml b/automated-robot-suite/Qemu/slave_controller.xml
new file mode 100644
index 0000000..75a380c
--- /dev/null
+++ b/automated-robot-suite/Qemu/slave_controller.xml
@@ -0,0 +1,99 @@
+<domain type='kvm' id='164'>
+  <name>NAME</name>
+  <memory unit='UNIT'>MEMORY</memory>
+  <currentMemory unit='UNIT'>MEMORY</currentMemory>
+  <vcpu placement='static'>CORES</vcpu>
+  <resource>
+    <partition>/machine</partition>
+  </resource>
+  <os>
+    <type arch='x86_64' machine='pc'>hvm</type>
+  </os>
+  <features>
+    <acpi/>
+    <apic/>
+    <pae/>
+  </features>
+  <cpu match='exact'>
+    <model fallback='forbid'>Nehalem</model>
+    <topology sockets='1' cores='CORES' threads='1'/>
+    <feature policy='optional' name='vmx'/>
+    <feature policy='optional' name='svm'/>
+  </cpu>
+  <clock offset='utc'/>
+  <on_poweroff>destroy</on_poweroff>
+  <on_reboot>restart</on_reboot>
+  <on_crash>destroy</on_crash>
+  <devices>
+    <emulator>/usr/bin/qemu-system-x86_64</emulator>
+    <disk type='file' device='disk'>
+      <driver name='qemu' type='qcow2'/>
+      <source file='DISK0'/>
+      <backingStore/>
+      <target dev='sda' bus='sata'/>
+      <boot order='1'/>
+    </disk>
+    <disk type='file' device='disk'>
+      <driver name='qemu' type='qcow2'/>
+      <source file='DISK1'/>
+      <backingStore/>
+      <target dev='sdb' bus='sata'/>
+    </disk>
+    <disk type='file' device='disk'>
+      <driver name='qemu' type='qcow2'/>
+      <source file='DISK2'/>
+      <backingStore/>
+      <target dev='sdd' bus='sata'/>
+    </disk>
+    <interface type='bridge'>
+      <source bridge='stxbr1'/>
+      <target dev='vnet0'/>
+      <model type='e1000'/>
+      <alias name='net0'/>
+    </interface>
+    <interface type='bridge'>
+      <source bridge='stxbr2'/>
+      <target dev='vnet1'/>
+      <model type='e1000'/>
+      <boot order='2'/>
+      <alias name='net1'/>
+    </interface>
+    <interface type='bridge'>
+      <source bridge='stxbr3'/>
+      <target dev='vnet2'/>
+      <model type='virtio'/>
+      <alias name='net2'/>
+    </interface>
+    <interface type='bridge'>
+      <source bridge='stxbr4'/>
+      <target dev='vnet3'/>
+      <model type='virtio'/>
+      <alias name='net3'/>
+    </interface>
+    <serial type='pty'>
+      <source path='/dev/pts/8'/>
+      <target port='0'/>
+      <alias name='serial0'/>
+    </serial>
+    <console type='pty' tty='/dev/pts/8'>
+      <source path='/dev/pts/8'/>
+      <target type='serial' port='0'/>
+      <alias name='serial0'/>
+    </console>
+    <input type='mouse' bus='ps2'/>
+    <input type='keyboard' bus='ps2'/>
+    <graphics type='vnc' port='5900' autoport='yes' listen='127.0.0.1' keymap='en-us'>
+      <listen type='address' address='127.0.0.1'/>
+    </graphics>
+    <video>
+      <model type='cirrus' vram='16384' heads='1'/>
+      <alias name='video0'/>
+      <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x0'/>
+    </video>
+    <memballoon model='virtio'>
+      <alias name='balloon0'/>
+      <address type='pci' domain='0x0000' bus='0x00' slot='0x05' function='0x0'/>
+    </memballoon>
+  </devices>
+</domain>
+
diff --git a/automated-robot-suite/Qemu/storage.xml b/automated-robot-suite/Qemu/storage.xml
new file mode 100644
index 0000000..e5f6522
--- /dev/null
+++ b/automated-robot-suite/Qemu/storage.xml
@@ -0,0 +1,92 @@
+<domain type='kvm' id='187'>
+  <name>NAME</name>
+  <memory unit='UNIT'>MEMORY</memory>
+  <currentMemory unit='UNIT'>MEMORY</currentMemory>
+  <vcpu placement='static'>CORES</vcpu>
+  <resource>
+    <partition>/machine</partition>
+  </resource>
+  <os>
+    <type arch='x86_64' machine='pc'>hvm</type>
+  </os>
+  <features>
+    <acpi/>
+    <apic/>
+    <pae/>
+  </features>
+  <cpu match='exact'>
+    <model fallback='forbid'>Nehalem</model>
+    <topology sockets='1' cores='CORES' threads='1'/>
+    <feature policy='require' name='vmx'/>
+    <feature policy='optional' name='svm'/>
+  </cpu>
+  <clock offset='utc'/>
+  <on_poweroff>destroy</on_poweroff>
+  <on_reboot>restart</on_reboot>
+  <on_crash>destroy</on_crash>
+  <devices>
+    <emulator>/usr/bin/qemu-system-x86_64</emulator>
+    <disk type='file' device='disk'>
+      <driver name='qemu' type='qcow2'/>
+      <source file='DISK0'/>
+      <backingStore/>
+      <target dev='sda' bus='sata'/>
+      <boot order='1'/>
+    </disk>
+    <disk type='file' device='disk'>
+      <driver name='qemu' type='qcow2'/>
+      <source file='DISK1'/>
+      <backingStore/>
+      <target dev='sdb' bus='sata'/>
+    </disk>
+    <interface type='bridge'>
+      <source bridge='stxbr1'/>
+      <target dev='vnet8'/>
+      <model type='e1000'/>
+      <alias name='net0'/>
+    </interface>
+    <interface type='bridge'>
+      <source bridge='stxbr2'/>
+      <target dev='vnet9'/>
+      <model type='e1000'/>
+      <boot order='2'/>
+      <alias name='net1'/>
+    </interface>
+    <interface type='bridge'>
+      <source bridge='stxbr3'/>
+      <target dev='vnet10'/>
+      <model type='virtio'/>
+      <alias name='net2'/>
+    </interface>
+    <interface type='bridge'>
+      <source bridge='stxbr4'/>
+      <target dev='vnet11'/>
+      <model type='virtio'/>
+      <alias name='net3'/>
+    </interface>
+    <serial type='pty'>
+      <source path='/dev/pts/12'/>
+      <target port='0'/>
+      <alias name='serial0'/>
+    </serial>
+    <console type='pty' tty='/dev/pts/12'>
+      <source path='/dev/pts/12'/>
+      <target type='serial' port='0'/>
+      <alias name='serial0'/>
+    </console>
+    <input type='mouse' bus='ps2'/>
+    <input type='keyboard' bus='ps2'/>
+    <graphics type='vnc' port='5903' autoport='yes' listen='127.0.0.1' keymap='en-us'>
+      <listen type='address' address='127.0.0.1'/>
+    </graphics>
+    <video>
+      <model type='cirrus' vram='16384' heads='1'/>
+      <alias name='video0'/>
+      <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x0'/>
+    </video>
+    <memballoon model='virtio'>
+      <alias name='balloon0'/>
+      <address type='pci' domain='0x0000' bus='0x00' slot='0x05' function='0x0'/>
+    </memballoon>
+  </devices>
+</domain>
diff --git a/automated-robot-suite/baremetal/baremetal_setup.yaml b/automated-robot-suite/baremetal/baremetal_setup.yaml
new file mode 100644
index 0000000..ea870e0
--- /dev/null
+++ b/automated-robot-suite/baremetal/baremetal_setup.yaml
@@ -0,0 +1,47 @@
+nodes:
+  controller-0:
+    name: controller-0
+    personality: controller
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: psw
+    pxe_nic_mac:
+    installation_ip:
+  controller-1:
+    name: controller-1
+    personality: controller
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: psw
+    pxe_nic_mac:
+  compute-0:
+    name: compute-0
+    personality: worker
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: psw
+    pxe_nic_mac:
+  compute-1:
+    name: compute-1
+    personality: worker
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: psw
+    pxe_nic_mac:
+  storage-0:
+    name: storage-0
+    personality: storage
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: psw
+    pxe_nic_mac:
+  storage-1:
+    name: storage-1
+    personality: storage
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: psw
+    pxe_nic_mac:
+extra_data_if_needed:
+    value1:
+    value2:
diff --git a/automated-robot-suite/baremetal/configs/duplex.yaml b/automated-robot-suite/baremetal/configs/duplex.yaml
new file mode 100644
index 0000000..ec03c7b
--- /dev/null
+++ b/automated-robot-suite/baremetal/configs/duplex.yaml
@@ -0,0 +1,18 @@
+nodes:
+  controller-0:
+    name: controller-0
+    personality: controller
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
+    installation_ip:
+    oam_if:
+    mgmt_if:
+  controller-1:
+    name: controller-1
+    personality: controller
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
diff --git a/automated-robot-suite/baremetal/configs/multinode_controller_storage.yaml b/automated-robot-suite/baremetal/configs/multinode_controller_storage.yaml
new file mode 100644
index 0000000..6705853
--- /dev/null
+++ b/automated-robot-suite/baremetal/configs/multinode_controller_storage.yaml
@@ -0,0 +1,32 @@
+nodes:
+  controller-0:
+    name: controller-0
+    personality: controller
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
+    installation_ip:
+    oam_if:
+    mgmt_if:
+  controller-1:
+    name: controller-1
+    personality: controller
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
+  compute-0:
+    name: compute-0
+    personality: worker
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
+  compute-1:
+    name: compute-1
+    personality: worker
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
diff --git a/automated-robot-suite/baremetal/configs/multinode_dedicated_storage.yaml b/automated-robot-suite/baremetal/configs/multinode_dedicated_storage.yaml
new file mode 100644
index 0000000..450870c
--- /dev/null
+++ b/automated-robot-suite/baremetal/configs/multinode_dedicated_storage.yaml
@@ -0,0 +1,46 @@
+nodes:
+  controller-0:
+    name: controller-0
+    personality: controller
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
+    installation_ip:
+    oam_if:
+    mgmt_if:
+  controller-1:
+    name: controller-1
+    personality: controller
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
+  compute-0:
+    name: compute-0
+    personality: worker
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
+  compute-1:
+    name: compute-1
+    personality: worker
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
+  storage-0:
+    name: storage-0
+    personality: storage
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
+  storage-1:
+    name: storage-1
+    personality: storage
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
diff --git a/automated-robot-suite/baremetal/configs/simplex.yaml b/automated-robot-suite/baremetal/configs/simplex.yaml
new file mode 100644
index 0000000..9453b54
--- /dev/null
+++ b/automated-robot-suite/baremetal/configs/simplex.yaml
@@ -0,0 +1,11 @@
+nodes:
+  controller-0:
+    name: controller-0
+    personality: controller
+    bmc_ip:
+    bmc_user: usr
+    bmc_pswd: pswd
+    pxe_nic_mac:
+    installation_ip:
+    oam_if:
+    mgmt_if:
diff --git a/automated-robot-suite/requirements.txt b/automated-robot-suite/requirements.txt
new file mode 100644
index 0000000..4d31ac5
--- /dev/null
+++ b/automated-robot-suite/requirements.txt
@@ -0,0 +1,14 @@
+watchdog
+robotframework==3.1.1
+robotframework-debuglibrary
+robotframework-seleniumlibrary
+robotframework-sshlibrary
+pexpect
+PyYaml
+netifaces
+bash
+elevate
+ifparser
+pynetlinux
+kmodpy
+psutil
diff --git a/automated-robot-suite/test-requirements.txt b/automated-robot-suite/test-requirements.txt
new file mode 100644
index 0000000..5a3ddd6
--- /dev/null
+++ b/automated-robot-suite/test-requirements.txt
@@ -0,0 +1,9 @@
+flake8==2.6.2
+hacking
+flake8-import-order
+mock
+coverage
+pylint
+pep8-naming
+ipdb
+ipython