blob: 958e63eb75eded5cdccdf2fe5f5ff19b87f889c1 [file] [log] [blame]
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Apache Object Oriented Data Technology (OODT) is the smart way to integrate and archive your processes, your data, and its metadata. It facilitates the generation, processing, management, distribution, analysis of data management, data archiving, and data analytics systems allowing for the integration of data, computation, visualization and other components.
">
<meta name="author" content="Apache OODT">
<title>Apache OODT - Distributed Data Management</title>
<!-- Bootstrap Core CSS -->
<link href="/css/bootstrap.min.css" rel="stylesheet">
<!-- Custom CSS -->
<link href="/css/stylish-portfolio.css" rel="stylesheet">
<!-- Custom Fonts -->
<link href="/font-awesome/css/font-awesome.min.css" rel="stylesheet" type="text/css">
<link href="http://fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,700,300italic,400italic,700italic" rel="stylesheet" type="text/css">
<!-- HTML5 Shim and Respond.js IE8 support of HTML5 elements and media queries -->
<!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
<script src="https://oss.maxcdn.com/libs/respond.js/1.4.2/respond.min.js"></script>
<![endif]-->
</head>
<body>
<nav class="navbar navbar-default">
<div class="container-fluid">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1" aria-expanded="false">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="#"><img src="/img/oodt_asf_logo_sm.png"/></a>
</div>
<div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
<ul class="nav navbar-nav">
<!--<a id="menu-close" href="#" class="btn btn-light btn-lg pull-right toggle"><i class="fa fa-times"></i></a>-->
<li>
<a href="/">Home</a>
</li>
<li>
<a href="/blog">News</a>
<li>
<a href="/site_docs/oodt/index.html">Components</a>
</li>
<li>
<a href="/documentation.html">Documentation</a>
</li>
<li>
<a href="/community.html" >Community</a>
</li>
<li>
<a href="/users.html">Users</a>
</li>
<li>
<a href="/download.html" >Download</a>
</li>
</ul>
</div>
</div>
</nav>
<div class="container" >
<!-- Nav tabs -->
<ul class="nav nav-tabs" role="tablist">
<li role="presentation" class="active"><a href="#home" aria-controls="home" role="tab" data-toggle="tab">Getting Started</a></li>
<li role="presentation"><a href="#radix" aria-controls="radix" role="tab" data-toggle="tab">Radix</a></li>
<li role="presentation"><a href="#vagrant" aria-controls="vagrant" role="tab" data-toggle="tab">Vagrant</a></li>
<li role="presentation"><a href="#devres" aria-controls="devres" role="tab" data-toggle="tab">Development Resources</a></li>
</ul>
<!-- Tab panes -->
<div class="tab-content">
<div role="tabpanel" class="tab-pane active" id="home">
<div class="row col-md-12">
<h1>Getting Started</h1>
<p>Getting started with Apache OODT can be a daunting task. With a number of components to setup and configure it can be both time consuming and confusing. To help solve this problem Radix and the Vagrant Virtual Machine were created.</p>
<h2>RADiX</h2>
<p>RADiX is a Maven Archtype designed to get OODT up and running quickly and easily. Maven will download the correct libraries and run the correct configuration routines to deploy a fully working OODT platform including File Manage, Workflow, OpsUI etc.</p>
<p>RADiX can run on both Unix systems and Windows and requires nothing more than a Java JDK and Apache Maven installed on your computer.</p>
<p>To find out how to get started with RADiX quickly then visit its wiki page <a href="https://cwiki.apache.org/confluence/display/OODT/RADiX+Powered+By+OODT">here</a></p>
<h2>Vagrant VM</h2>
<p>Vagrant extends upon Radix to give you a configured Virtual Machine with a preconfigured RADiX installation already built and ready along with the networking configuration setup so you can connect to OpsUI without having to change the networking setup.</p>
<p>The Vagrant VM is idea if you want a portable image that can be replicated time after time or copied around colleagues.</p>
<p>To get started with the OODT Vagrant VM, visit the wiki page.</p>
<h2>Apache OODT Wiki Documentation</h2>
<p>Apache OODT has a number of components and various ways to configure and use each one. To keep the documentation as up to date as possible, we have migrated all our documentation to the Apache OODT Wiki space.</p>
<p>The documentation on the wiki is updated regularly with component information, tutorials and examples. If you use Apache OODT and would like to help contribute to the sizable documentation effort, then please ask on the development mailing list for details about how you can help with OODT documentation.</p>
<h2>OODT Javadoc</h2>
<p>The Javadoc links below are a convenient way for your to browse current and previous versions of the project Java documentation:</p>
<ul>
<li>Nightly (current master SNAPSHOT)</li>
<li>0.10</li>
<li>0.9</li>
<li>0.8.1</li>
<li>0.8</li>
<li>0.7</li>
</ul>
<p>For earlier version of the Javadoc please get in touch with us and we can generate them for you.</p>
</div>
</div>
<div role="tabpanel" class="tab-pane" id="radix">
<div class="row col-md-12 ">
<h1>Overview</h1>
<p>The high level goal of this effort is to build a distribution of OODT that sets up, installs, and runs within a few commands. Reducing the number of commands to run OODT is an effort to push the edge of ease of setup and configuration required to get going. This distribution of OODT will include both a deployment and source structure for managing the evolution of your installation of OODT.</p>
<p>Maven offers an improved way to export, configure and build OODT called Archetypes. Archetypes simply put are a way to define templates for projects. Within these project templates we will include packaging instructions to conform to the guidelines below to increase the similarity amongst deployments of OODT. Moreover, we will build higher level scripts and configuration to tie the pieces together at the system level. Finally, we will leverage the CAS Install Maven Plugin to take us from our source structure to our deployment structure.</p>
<p>This wiki will be used to capture thoughts, ideas and plans for the first archetypes we develop for OODT. To keep things simple we are going to initially focus on a small number of modules that are typically deployed and configured together. Finally, our goal is to build an 80% solution that works in most cases to get people out of the gates and running with a full OODT solution. We believe this effort will help increase adoption and conformity amongst installations of an already great system.</p>
<h1>Installing OODT with Radix</h1>
<div class="panel panel-default">
<div class="panel-body">
<kbd>curl -s "https://git-wip-us.apache.org/repos/asf?p=oodt.git;a=blob_plain;f=mvn/archetypes/radix/src/main/resources/bin/radix;hb=HEAD" | bash</kbd><br/>
<kbd>mv oodt oodt-src; cd oodt-src; mvn install</kbd><br/>
<kbd>mkdir ../oodt; tar -xvf distribution/target/oodt-distribution-0.1-bin.tar.gz -C ../oodt</kbd><br/>
<kbd>cd ../oodt; ./bin/oodt start</kbd><br/>
<kbd>./resmgr/bin/batch_stub 2001</kbd><br/>
</div>
</div>
</div>
</div>
<div role="tabpanel" class="tab-pane" id="vagrant">
<div class="row col-md-12 ">
<h1>Introduction</h1>
<p>This user-guide will help you understand, and set up a Vagrant powered Virtual Machine containing a pre-configured OODT installation.</p>
<h2>Requirements</h2>
<ul>
<li>Vagrant - please download from: http://www.vagrantup.com</li>
<li>VirtualBox - please download from: https://www.virtualbox.org/</li>
<li>At least 4GB disk space</li>
</ul>
<h2>OODT RADiX Vagrant Virtual Machine</h2>
<p>Launching this Vagrant VM will provide you with:
<ul>
<li>A pre-configured RADiX installation with a version of OODT of your choosing (including the latest OODT snapshots!)</li>
<li>A port-forwarded OPSUI control webapp at http://localhost:8080/opsui that you can quickly use to verify and control OODT</li>
<li>More time, because installing OODT is as easy as "vagrant up"</li>
<li>A fast way to produce a RADiX project tar-ball, which you can copy and use elsewhere</li>
</ul>
</p>
<h2>Steps</h2>
<ol>
<li>Download the latest Apache OODT distribution.</li>
<li>Extract the OODT distribution somewhere on your machine
<div class="panel panel-default">
<div class="panel-body">
<kbd># please change ${version} to the version you have</kbd><br/>
<kbd>$ unzip apache-oodt-${version}-src.zip</kbd><br/>
<kbd>$ cd apache-oodt-${version}-src/vagrant/radix/</kbd>
</div>
</div>
</li>
<li>
Customize your RADiX Vagrant distribution for your organization/project:
<ol>
<li>Open vagrant/env.sh in your favorite editor</li>
<li>Make sure you customize entries for the following variables:
<ol>
<li>(required) PROJECT_GROUP_ID - The namespace that will be used to create the RADiX distribution of OODT (e.g. com.mycompany.myorg)</li>
<li>(required) PROJECT_ARTIFACT_ID - The specific name of the RADiX distribution project (e.g. myproject)</li>
<li>(optional) BUILD_FLAGS - Set of build flags that will customize the RADiX deployment Vagrant will build. See more build flag options here.</li>
<li>(optional) OODT_DEPLOYMENT_HOME - The location on the Vagrant Virtual Machine where OODT RADiX will be installed to</li>
<li>(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.</li>
</ol>
</li>
</ol>
</li>
<li>
Install/Launch RADiX OODT
<ol>
<li>
Type vagrant up to launch the Virtual Machine (can take up to 15 minutes the first time you run)
<div class="panel panel-default">
<div class="panel-body">
<kbd>$ vagrant up</kbd>
</div>
</div>
</li>
</ol>
</li>
<li>
After the above command finished, navigate to the OODT OpsUI on your host machine: http://localhost:8080/opsui
</li>
</ol>
</div>
</div>
<div role="tabpanel" class="tab-pane" id="devres">
<div class="row col-md-6 col-md-offset-2">
<h2>Getting started</h2>
<p>To get started with OODT development you will need JDK7+, an IDE(of course we recommend Netbeans as soon as it arrvies in the Apache Incubator, but Intellij and Eclipse are perfectly acceptable! ;) ) and Maven 3 or later is also needed to compile the source code.</p>
<p>The easiest place to checkout the code is from Github: <a href="https://github.com/apache/oodt">https://github.com/apache/oodt</a></p>
<p>To compile the code from source simply run `mvn clean install` on the command line from within the checkout directory and the OODT code will start to compile.</p>
<p>To file bugs or find new tasks to work on you can find the OODT issue track on the ASF Jira: <a href="http://issues.apache.org">http://issues.apache.org</a></p>
</div>
</div>
</div>
</div>
<footer class="sitefooter">
<div class="container">
<div class="row">
<div class="col-lg-10 col-lg-offset-1 text-center">
<a href="http://www.apache.org/events/current-event.html">
<img src="http://www.apache.org/events/current-event-234x60.png"/>
</a>
<h4><strong>Apache OODT</strong>
</h4>
<p>
</p>
<ul class="list-unstyled">
<li><i class="fa fa-envelope-o fa-fw"></i> <a href="mailto:dev@oodt.apache.org">dev@oodt.apache.org</a>
</li>
</ul>
<br>
<ul class="list-inline">
<!-- <li>
<a href="https://facebook.com/"><i class="fa fa-facebook fa-fw fa-3x"></i></a>
</li>-->
<li>
<a href="https://twitter.com/apache_oodt"><i class="fa fa-twitter fa-fw fa-3x"></i></a>
</li>
<li>
<a href="https://github.com/apache/oodt"><i class="fa fa-github fa-fw fa-3x"></i></a>
</li>
</ul>
<hr class="small">
<p class="text-muted">Copyright &copy; The Apache Foundation 2018</p>
</div>
</div>
</div>
</footer>
<!-- jQuery -->
<script src="/js/jquery.js"></script>
<!-- Bootstrap Core JavaScript -->
<script src="/js/bootstrap.min.js"></script>
<!-- Custom Theme JavaScript -->
<script src="/js/custom.js"></script>
</body>
</html>