Skip to content
Ivan Mincik edited this page Jul 29, 2015 · 17 revisions

Running GIS.lab virtual client mode is very useful when you want to keep working in your favorite operating system (for example your favorite Windows 7 OS) and still want to use GIS.lab environment. Virtual client runs in VirtualBox virtual machine, which is capable to run on Windows, Linux or Mac OSX operating systems.

Installation

Download and install VirtualBox for your system from https://www.virtualbox.org/wiki/Downloads .

Virtual machine creation

Create new virtual machine in VirtualBox (Machine > New) with following configuration:
VirtualBox client

Do not create any virtual hard drive
VirtualBox client

PXE boot

PXE boot is a default boot mode for GIS.lab clients. It is a simplest method to get your client up and running.

Configure boot order to boot only from network and enable IO APIC (Settings > System)
VirtualBox client

Configure network adapter in bridged mode, make sure you select PCnet-FAST III (Am79C973) as the adapter type and allow promiscuous mode for all (Settings > Network).
VirtualBox client

HTTP boot

In addition to default PXE boot method, GIS.lab clients can boot also directly from GIS.lab server using HTTP boot method. Here are some advantages over PXE which are valid for virtual clients:

  • it allows to use para-virtualized network adapter for Virtual clients (VirtualBox), which is many times faster than network adapter used for PXE
  • it allows to manually choose target GIS.lab server which is very handy if multiple GIS.lab instances are running in one network
  • boot process is faster

HTTP boot is enabled by special GIS.lab bootloader ISO image file, which exists in http-boot/gislab-desktop-bootloader.iso.

Configure boot order to boot only from CD/DVD and enable IO APIC (Settings > System)
VirtualBox client

Add virtual gislab-desktop-bootloader.iso file as virtual CD/DVD (Settings > Storage) VirtualBox client

Configure network adapter in bridged mode, make sure you select Paravirtualized Network (virtio-net) as the adapter type and allow promiscuous mode for all (Settings > Network).
VirtualBox client

See HTTP boot page for more details.

Enabling client machine

Open Advanced options and make a note of assigned MAC Address. It will be needed in next step.

Log in to GIS.lab server and allow your client machine to connect.

$ vagrant ssh gislab_vagrant
$ sudo gislab-machines -a <MAC-address-of-virtual-client-machine>

Virtual client start

Start GIS.lab client virtual machine, by pressing Start button in VirtualBox Manager, log in and enjoy. VirtualBox client

Additional configuration

To set custom client display resolution run following command on host machine
$ VBoxManage controlvm "GIS.lab client" setvideomodehint <xresolution> <yresolution> 32
for example
$ VBoxManage controlvm "GIS.lab client" setvideomodehint 1000 660 32

Continue with Physical client.

Clone this wiki locally