Introduction

This user-guide will help you understand, and set up a Vagrant powered Virtual Machine containing a pre-configured OODT installation.

Requirements

OODT RADiX Vagrant Virtual Machine

Launching this Vagrant VM will provide you with:

  • A pre-configured RADiX installation with a version of OODT of your choosing (including the latest OODT snapshots!)
  • A port-forwarded OPSUI control webapp at http://localhost:8080/opsui that you can quickly use to verify and control OODT
  • More time, because installing OODT is as easy as "vagrant up"
  • A fast way to produce a RADiX project tar-ball, which you can copy and use elsewhere

Steps:

  1. Download the latest Apache OODT distribution.

  2. Extract the OODT distribution somewhere on your machine

    # please change ${version} to the version you have
$ unzip apache-oodt-${version}-src.zip
$ cd apache-oodt-${version}-src/vagrant/radix/
  3. Customize your RADiX Vagrant distribution for your organization/project:
    1. Open vagrant/env.sh in your favorite editor
    2. Make sure you customize entries for the following variables:

      1. (required) PROJECT_GROUP_ID - The namespace that will be used to create the RADiX distribution of OODT (e.g. com.mycompany.myorg)

      2. (required) PROJECT_ARTIFACT_ID - The specific name of the RADiX distribution project (e.g. myproject)

      3. (optional) BUILD_FLAGS - Set of build flags that will customize the RADiX deployment Vagrant will build. See more build flag options here.

      4. (optional) OODT_DEPLOYMENT_HOME - The location on the Vagrant Virtual Machine where OODT RADiX will be installed to

    3. (Optional) Change the top line of Vagrantfile that sets the VM_NAME to a name of your choosing. Note, every Vagrant virtual machine must have a unique name.
  4. Install/Launch RADiX OODT

    1. Type vagrant up to launch the Virtual Machine (can take up to 15 minutes the first time you run)

      $ vagrant up
  5. After the above command finished, navigate to the OODT OpsUI on your host machine: http://localhost:8080/opsui
  • No labels