Virtual Machine Setup with Chef

This section describes how to set up Cuneiform inside a Virtual Machine (VM).

Note

Since Cuneiform will run in a Virtual Machine, this setup has no special requirements towards your operating system or Java version. Root access is required only for installing the prerequisites.

Prerequisites

The following software has to be available on your system:

Attention

When installing Git on Windows, make sure to select Use Git from the Windows Command Prompt when asked to adjust your PATH environment.

Hint

If you are running a Debian-based operatin system you can install these packages simply by entering:

wget https://opscode-omnibus-packages.s3.amazonaws.com/debian/6/x86_64/chefdk_0.10.0-1_amd64.deb
sudo dpkg -i chefdk_0.10.0-1_amd64.deb
sudo apt-get install git virtualbox vagrant

Setting up a VM

Clone the chef-cuneiform repository by opening a command line terminal and entering:

git clone https://github.com/joergen7/chef-cuneiform.git

Hint

If you are living behind a proxy then update the .kitchen.yml file in the chef-cuneiform folder by updating the provisioner: entry as follows:

provisioner:
  name: chef_zero
  http_proxy: http://proxy.example.com:PORT
  https_proxy: http://proxy.example.com:PORT

Change into the cloned directory and have Chef create a VM by entering:

cd chef-cuneiform
berks install
kitchen converge

The process of setting up the VM may take a few minutes depending on your internet connection. A Ubuntu 14.04 image is fetched from the internet and a Java environment is set up in the VM. All dependencies are installed and the Cuneiform source code is downloaded and compiled.

Hint

To destroy the VM again after using it, enter:

kitchen destroy

You can login to the VM by entering

kitchen login

Inside the VM check the success of the installation by observing the output of:

cuneiform --help