Skip to content
imincik edited this page Dec 9, 2014 · 37 revisions

Hardware

  • Intel NUC CPU Intel Core i5 Ivy Bridge DC53427HYE
  • 8 GB RAM KINGSTON KVR16S11/8
  • mSata SSD 525 Series, 60GB

Software requirements

  • latest GIS.lab source code from Git repository
  • Ansible (in our case 1.7.2)

Installation

Basic operating system installation

GIS.lab runs only with Ubuntu 12.04 Precise. Following steps will guide you to install basic operating system with default 'ubuntu' user, password 'ubuntu' created. Network setting is configured to automatically obtain IP address from DHCP server.

  • download latest Ubuntu 12.04 Precise AMD 64 server installation ISO image from http://releases.ubuntu.com/precise

  • use script gislab-unit/gislab-unit-iso.sh to create GIS.lab Unit installation ISO image from Ubuntu image downloaded in previous step. Run gislab-unit-iso.sh -h to see required options

  • prepare bootable installation USB stick from GIS.lab Unit ISO image created in previous step. In Ubuntu you can use Startup Disk Creator application.

  • attach power supply, HDMI display, keyboard and Ethernet cable in to GIS.lab Unit machine. It is assumed that machine is connected to network with automatic IP address assigning from DHCP server

  • insert USB stick prepared in previous step to GIS.lab Unit machine, power it on, press ?TODO? key to run boot manager and select boot from USB. Then, fully automatic installation should start. When finished, machine will be turned of.

  • remove USB stick used for installation

SSD disk usage optimization

GIS.lab Unit is using SSD disk as primary storage. To perform well and preserve longer lifetime some special configuration must be performed. Special Ansible playbook exists for this task.

  • power on GIS.lab Unit machine

  • log in to GIS.lab Unit machine using user name 'ubuntu' and password 'ubuntu' and run following command to detect IP assigned by DHCP server

$ ip addr | grep eth0
  • create Ansible inventory file gislab-unit.inventory with following content (replace with IP address detected in previous step)
gislab-unit ansible_ssh_host=<gislab-unit-ip> ansible_ssh_user=ubuntu
  • run following command to execute Ansible playbook
 $ ansible-playbook --inventory=gislab-unit.inventory --private-key=<private-SSH-key-file> gislab-unit/gislab-unit.yml

GIS.lab configuration and installation

GIS.lab configuration is done in system/host_vars/ file. Configuration placed in to this file will override default ones from system/group_vars/all. Than GIS.lab installation from Ansible playbook is performed as a last step.

  • create configuration file system/host_vars/gislab-unit and place there your configuration which you want to override

  • run following command to execute Ansible playbook

$ ansible-playbook --inventory=gislab-unit.inventory --private-key=<private-SSH-key-file> system/gislab.yml
Clone this wiki locally