This guides you to create a Virtual Machine in your windows workstation/laptop for Trafodion developers.  It allows developers to build Trafodion in windows laptop by creating Linux virtual machine(VM). After creating the CentOS 6 Linux VM you can obtain Trafodion source from git, make code changes, build and run minimum regression tests in the sandbox.

Configuration

Successfully created Trafodion Development Sandbox with the following configuration of windows 10 laptop.

• Processor Intel(R) Core(TM) i7-6500U CPU @ 2.50GHz, 2592 Mhz, 2 Core(s), 4 Logical Processor(s)
• Installed Physical Memory (RAM) 16.0 GB
• Disk Space required for VM : 75 GB or more

Trafodion sandbox may not be created with 8 GB of physical memory because at least 8 GB of memory is needed for the Trafodion sandbox. 

Enable Virtualization on Your PC

Your PC should have virtualization enabled in its BIOS settings. To enable virtualization on your PC, follow these steps:

• Power off your PC.
• When powering on your PC, press Esc to display the Startup Menu.
• When the Startup Menu appears, press F10 or the function Key for the BIOS Setup of your PC .
• In the BIOS Setup, select the System Configuration tab.
• Select Device Configurations.
• Scroll down and select Virtualization Technology.
• Click Save.
• When prompted to save changes, click Yes.
• Click Exit.
• When prompted again to save changes, click Yes.
• Restart your PC.

Install a Hypervisor

Install one of the tested and supported hypervisors on your PC.  The following steps use Oracle VirtuxBox as the virtual machines manager.

• VirtualBox (free download)
• Choose Virtual box for Windows Host to download and install.

Download CentOS 6 version

Currently Apache Trafodion is built with CentOS 6 version only. So, it is mandatory to use CentOS 6 as the guest OS in the VirtualBox. 

• Download CentOS 6
  • Download the minimal ISO file from the link Download CentOS 6 

Install CentOS 6

There are many useful links that gives step-by-step instructions to install CentOS 6 in Oracle VirtualBox.  Install CentOS in Oracle VM

• Create a new Virtual Machine
  • With Name of your choice say CentOS6_VM1 with Linux as Type and RedHat as Version.
  • Assign at least 8 GB of memory to VM
  • Create a virtual hard drive with disk type either as VDI or VHD with a size of 75GB. You can pre-allocate 75 GB by choosing Fixed Size.
  • The new VM is initially created in powered off state.
• Assign installation media file 
  • Before you start the VM, assign the installation media ISO file as the optical drive by clicking on Machine->storage→Disk ICON
• Additional Configuration
  • Configure Network Type by clicking on Machine->Settings->NetWork->Enable Network Adapter as Bridged Adapter
  • Enable Copy and Paste between the host and guest OS by clicking on Machine->settings->General->Advanced->Birectional for Shared ClipBoard and Drag'N'Drop
• Start the VM
  • The cursor pointer is confined to the VM window once it is clicked within the window. You can move the cursor out of VM window by pressing right ctrl key and move the cursor out of VM window.
  • This installs CentOS VM and prompts you for root password, for additional user creation, time zone etc
  • Before you restart the VM, remove disk from virtual drive by clicking on Machine->Setting->Storage→Disk ICON→Remove Disk from Virtual drive,  If this step is missed you might end of installing  CentOS repeatedly.

Common problems observed while using Trafodion sandbox

• The cursor pointer is confined to the VM window once it is clicked within the window. You can move the cursor out of VM window by pressing right ctrl key and then move the cursor out of VM window.
• After the VM is started, please ensure that you are able to visit webpages using firefox browser in the VM. Only when you are able to browse the internet from Linux VM, you will be able to install other packages needed for Trafodion. If you are unable to connect,, please correct your network configuration. Some of the network configuration becomes effective only after the VM is restarted.
• I had configured two network adaptors; one with NAT and another as bridged adapter. NAT requires Port Forwarding.
• I couldn't get copy-paste to work between the host and guest OS though I have enabled it.  But you can use scp to move the files such as private and public key via scp command.
• Update your .bashrc file with the following
  
  • ulimit -u 65536
  • export TRAF_HOME=~/trafodion/core/sqf
  • export JAVA_HOME and TOOLSDIR
• For git to work from Linux VM, you need to do the following in root user shell.
  • install ssh server using yum install openssh-server command.
  • You need to stop the iptables service using service iptables stop command.
  • You need to start the ssh service using service sshd start command.
• Before installing the hadoop environment via install_local_hadoop step in the VM
  • You need to set the environment variable MY_LOCAL_SW_DIST export MY_LOCAL_SW_DIST=~/Downloads
  • Copy tpcds_kit.zip to the folder pointed by MY_LOCAL_SW_DIST.
  • install_local_hadoop