Medusa Integration Testing System

About

Medusa Integration Testing System (MITS) is based on MTE (Medusa Testing Environment) developed by Roderik Ploszek in 2016. Link: https://github.com/Programator2/medusa-testing-environment

Prerequisites

We recommend the newest version of VirtualBox. For Medusa testing and development, we recommend the Debian distribution, specifically the Testing distribution that offers a compromise between new versions of packages and stability.

Network settings of the virtual machine

SSH server is provided by the openssh-server package on Debian distribution.

There are many ways to configure network connection between guest and host operating systems. We recommend using NAT with port forwarding from the guest port 22 to the host port 3022. Host port can be set to any value, but it has to be correctly set in the testing environment config.yaml configuration on Host system.

Superuser settings on the virtual machine

Testing environment uses the sudo command extensively and works best if the guest system is configured not to ask for the password. You can set this up by adding following line to the /etc/sudoers file:

username    ALL=NOPASSWD: ALL

Replace username with your own username.

Python dependencies on Guest system

Make sure that following modules for Python3 are installed on your host system:

pexpect pyyaml sh

Python module dependencies on Host system

Make sure that following modules for Python2 are installed on your guest system (see requirements.txt for version):

paramiko pyyaml scp setuptools tk vbox_sdk

Installation instructions

Windows Installation Instructions

Complete config.yaml.sample file and rename it to config.yaml. Without correct information about virtual machine, the setup procedure won't work.

Install module win32com from http://sourceforge.net/projects/pywin32/

Set environment variables. Via PowerShell:

[Environment]::SetEnvironmentVariable("VBOX_INSTALL_PATH", "C:\Program Files\Oracle\VirtualBox", "Machine")
[Environment]::SetEnvironmentVariable("VBOX_VERSION", "5.1.8", "Machine")

Replace path to the VirtualBox installation folder and its version number if it doesn't correspond to your system. The last parameter, "Machine" means that the environment variable is tied to the computer as a whole, don't replace it with a virtual machine name.

Run:

py -2 setup.py install

Linux Installation Instructions

Complete config.yaml.sample file and rename it to config.yaml. Without correct information about virtual machine, the setup procedure won't work.

Run:

python setup.py install

Usage

Run the command from your Host system.

Windows

Run:

py -3 mits_parser.py CI

Linux

Run:

python3 mits_parser.py CI

Running environment from virtual machine as Host system

It is possible to run the testing environment from host system being virtual machine. In this case it is required to specify option is_virtual_machine: yes under host_settings in configuration.