Difference between revisions of "Vnx-tutorial-vagrant"

From VNX
Jump to: navigation, search
Line 1: Line 1:
 
{{Title|Testing VNX using a Vagrant virtual machine}}
 
{{Title|Testing VNX using a Vagrant virtual machine}}
  
You can easily test VNX over a system with Linux, Mac OS X or Windows using the  VNX demo virtual machine. This VM can be run over [http://www.virtualbox.org/ VirtualBox] or other hypervisor that accepts OVA virtual machine format.
+
You can easily test VNX over a system with Linux, Mac OS X or Windows using the  VNX demo virtual machine (VM). This VM can be run over [http://www.virtualbox.org/ VirtualBox] or other hypervisor that accepts OVA virtual machine format.
  
Beware that with this virtual machine you only can start LXC based virtual machines ([https://www.google.es/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&ved=0ahUKEwj9w4rz5IbLAhWDUBQKHVBJCLMQFggkMAA&url=https%3A%2F%2Fwww.virtualbox.org%2Fticket%2F4032&usg=AFQjCNE_xpDVPghBq0dVaV-qyn4spNfHXg no nested virtualization supported by VirtualBox]).
+
Beware that with this VM you only can start LXC based virtual machines ([https://www.google.es/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&ved=0ahUKEwj9w4rz5IbLAhWDUBQKHVBJCLMQFggkMAA&url=https%3A%2F%2Fwww.virtualbox.org%2Fticket%2F4032&usg=AFQjCNE_xpDVPghBq0dVaV-qyn4spNfHXg no nested virtualization supported by VirtualBox]).
  
 
Once you have VirtualBox or other hypervisor installed in your system:
 
Once you have VirtualBox or other hypervisor installed in your system:
* Download the demo virtual machine OVA file from http://idefix.dit.upm.es/vnx/vnx-vm. There are two versions: '''vnx-ubuntu-XX-XX-gui-v01.ova''', with an LXDE (Lubuntu) GUI; and '''vnx-ubuntu-XX-XX-v01.ova''', without GUI.
+
* Download the demo VM OVA file from http://idefix.dit.upm.es/vnx/vnx-vm. There are two versions: '''vnx-ubuntu-XX-XX-gui-v01.ova''', with an LXDE (Lubuntu) GUI; and '''vnx-ubuntu-XX-XX-v01.ova''', without GUI.
 
 
 
* Import the OVA file into VirtualBox using "File|Import Appliance" menu option.
 
* Import the OVA file into VirtualBox using "File|Import Appliance" menu option.
 +
* Start the newly created VM.
  
 +
Once the VM has started, you can access it through the GUI or, if you have installed the one without GUI, you can access it using:
 +
slogin vnx@10.11.11.2 -X      # password 'xxxx'
  
 
+
and test, for example, the LXC VNX tutorial scenario:
 
 
vagrant box add vnx http://idefix.dit.upm.es/vnx/vnx-vm/vnx-ubuntu-15.10-v01.box
 
mkdir vnx
 
cd vnx
 
vagrant init vnx
 
vagrant up
 
Once the VM has started, you can access it using:
 
slogin vnx@10.11.11.2 -X      # password 'xxxx'
 
or:
 
vagrant ssh
 
And test, for example, the LXC VNX tutorial scenario:
 
 
  cd /usr/share/vnx/examples/
 
  cd /usr/share/vnx/examples/
 
  sudo vnx -f tutorial_lxc_ubuntu.xml -v -t
 
  sudo vnx -f tutorial_lxc_ubuntu.xml -v -t

Revision as of 19:11, 21 February 2016

Testing VNX using a Vagrant virtual machine

You can easily test VNX over a system with Linux, Mac OS X or Windows using the VNX demo virtual machine (VM). This VM can be run over VirtualBox or other hypervisor that accepts OVA virtual machine format.

Beware that with this VM you only can start LXC based virtual machines (no nested virtualization supported by VirtualBox).

Once you have VirtualBox or other hypervisor installed in your system:

  • Download the demo VM OVA file from http://idefix.dit.upm.es/vnx/vnx-vm. There are two versions: vnx-ubuntu-XX-XX-gui-v01.ova, with an LXDE (Lubuntu) GUI; and vnx-ubuntu-XX-XX-v01.ova, without GUI.
  • Import the OVA file into VirtualBox using "File|Import Appliance" menu option.
  • Start the newly created VM.

Once the VM has started, you can access it through the GUI or, if you have installed the one without GUI, you can access it using:

slogin vnx@10.11.11.2 -X       # password 'xxxx'

and test, for example, the LXC VNX tutorial scenario:

cd /usr/share/vnx/examples/
sudo vnx -f tutorial_lxc_ubuntu.xml -v -t

See more details about LXC tutorial scenario here.

Aditional notes:

  • Installation on Windows:
    • X11 server: to allow virtual machine consoles to be shown properly, you need to install and start an X11 server in your Windows machine. We recommend using Xming (http://sourceforge.net/projects/xming/).
    • SSH client: for "vagrant ssh" command to work on windows you need a "ssh" command available from PATH directories. We recommend using git for windows (http://git-scm.com/download/win), which includes and ssh command and automatically modifies PATH variable. Just download and install it choosing "Use Git and optional Unix tools from the Windows Command Prompt" in "Adjusting your PATH enviromnment" step. Use default values for the rest of parameters.
  • Installation on Mac OSX:
  • You can customize the VM (e.g. memory assigned or the number of cpus) by editing Vagrantfile. For example, to increase memory to 2Gb and the number of CPUs to 4, add the following lines:
  • config.vm.provider :virtualbox do |vb|
      vb.customize ["modifyvm", :id,
                    "--memory", "2048",
                    "--cpus", "4"]
    end
    
  • You can see the procedure followed to create the VNX ready Vagrant VM here