Virtual Client
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.
Download and install VirtualBox for your system from https://www.virtualbox.org/wiki/Downloads .
Create new virtual machine in VirtualBox (Machine > New) with following configuration:
Do not create any virtual hard drive
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)
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).
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)
Add virtual gislab-desktop-bootloader.iso file as virtual CD/DVD (Settings > Storage)
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).
See HTTP boot page for more details.
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>
Start GIS.lab client virtual machine, by pressing Start button in VirtualBox Manager, log in and enjoy.
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.