Medusa Integration Testing System ==========================

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

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.

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.

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.

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

pexpect pyyaml sh

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

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

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

Run the command from your Host system.

Run:

py -3 mits_parser.py CI

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.