Difference between revisions of "Vnx-tutorial-vagrant"

From VNX
Jump to: navigation, search
 
(23 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Title|Testing VNX using a Vagrant virtual machine}}
+
{{Title|Testing VNX using a Vagrant}}
  
 
The easiest way to test VNX over a system with Linux, Mac OSX or Windows is to install [http://www.vagrantup.com/ Vagrant] and clone the virtual machine we have prepared with VNX software and examples installed.
 
The easiest way to test VNX over a system with Linux, Mac OSX or Windows is to install [http://www.vagrantup.com/ Vagrant] and clone the virtual machine we have prepared with VNX software and examples installed.
  
To do that, follow this procedure:
+
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]).
  vagrant box add vnx http://idefix.dit.upm.es/vnx/vagrant-vnx/vnx-ubuntu-14.04-v01.box
+
 
 +
Once you have Vagrant installed in your system, follow this procedure to create the VM:
 +
  vagrant box add vnx http://idefix.dit.upm.es/vnx/vnx-vm/vnx-ubuntu-15.10-v01.box
 
  mkdir vnx
 
  mkdir vnx
 
  cd vnx
 
  cd vnx
Line 10: Line 12:
 
  vagrant up
 
  vagrant up
 
Once the VM has started, you can access it using:
 
Once the VM has started, you can access it using:
 +
slogin vnx@10.11.11.2 -X      # password 'xxxx'
 +
or:
 
  vagrant ssh
 
  vagrant ssh
And test, for example, the VNX tutorial scenario:</li>
+
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
 +
See more details about LXC tutorial scenario [[Vnx-tutorial-lxc|here]].
  
 
+
=== Aditional notes: ===
Optionally, you can customize the VM (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:
+
<ul>
 +
<li>Installation on Windows:</li>
 +
<ul>
 +
<li>'''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/).
 +
<li>'''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.
 +
</ul>
 +
<li>Installation on Mac OSX:</li>
 +
<ul>
 +
<li>'''X11 server''': to allow virtual machine consoles to be shown properly, you need to install an X11 server. The recommended one for Mac OSX is Xquartz (http://xquartz.macosforge.org/landing/)
 +
</ul>
 +
<li>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:</li>
 
<pre>
 
<pre>
  config.vm.provider :virtualbox do |vb|
+
config.vm.provider :virtualbox do |vb|
    vb.customize ["modifyvm", :id,
+
  vb.customize ["modifyvm", :id,
                  "--memory", "2048",
+
                "--memory", "2048",
                  "--cpus", "4"]
+
                "--cpus", "4"]
  end
+
end
 
</pre>
 
</pre>
 +
<li>You can see the procedure followed to create the VNX ready Vagrant VM [[Vnx-create-vagrant-vm|here]]
 +
</ul>

Latest revision as of 19:32, 21 February 2016

Testing VNX using a Vagrant

The easiest way to test VNX over a system with Linux, Mac OSX or Windows is to install Vagrant and clone the virtual machine we have prepared with VNX software and examples installed.

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

Once you have Vagrant installed in your system, follow this procedure to create the VM:

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/
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