Added: dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/packaging/docker/ansible-docker/index.html ============================================================================== --- dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/packaging/docker/ansible-docker/index.html (added) +++ dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/packaging/docker/ansible-docker/index.html Thu Apr 20 05:38:46 2017 @@ -0,0 +1,253 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 2017-04-19 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20170419" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Metron – Overview</title> + <link rel="stylesheet" href="../../../../css/apache-maven-fluido-1.3.0.min.css" /> + <link rel="stylesheet" href="../../../../css/site.css" /> + <link rel="stylesheet" href="../../../../css/print.css" media="print" /> + + + <script type="text/javascript" src="../../../../js/apache-maven-fluido-1.3.0.min.js"></script> + + + +<script type="text/javascript">$( document ).ready( function() { $( '.carousel' ).carousel( { interval: 3500 } ) } );</script> + + </head> + <body class="topBarDisabled"> + + + + + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"> + <a href="http://metron.incubator.apache.org/" id="bannerLeft"> + <img src="../../../../images/metron-logo.png" alt="Apache Metron - Incubating" width="148px" height="48px"/> + </a> + </div> + <div class="pull-right"> <a href="http://incubator.apache.org/" id="bannerRight"> + <img src="../../../../images/ApacheIncubating_Logo.png" alt="Apache Incubating" width="192px" height="48px"/> + </a> + </div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + + + <li class=""> + <a href="http://www.apache.org" class="externalLink" title="Apache"> + Apache</a> + </li> + <li class="divider ">/</li> + <li class=""> + <a href="http://metron.incubator.apache.org/" class="externalLink" title="Metron-Incubating"> + Metron-Incubating</a> + </li> + <li class="divider ">/</li> + <li class=""> + <a href="../../../../index.html" title="Documentation"> + Documentation</a> + </li> + <li class="divider ">/</li> + <li class="">Overview</li> + + + + <li id="publishDate" class="pull-right">Last Published: 2017-04-19</li> <li class="divider pull-right">|</li> + <li id="projectVersion" class="pull-right">Version: 0.4.0</li> + + </ul> + </div> + + + <div class="row-fluid"> + <div id="leftColumn" class="span3"> + <div class="well sidebar-nav"> + + + <ul class="nav nav-list"> + <li class="nav-header">User Documentation</li> + + <li> + + <a href="../../../../index.html" title="Metron"> + <i class="icon-chevron-down"></i> + Metron</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../../../Upgrading.html" title="Upgrading"> + <i class="none"></i> + Upgrading</a> + </li> + + <li> + + <a href="../../../../metron-analytics/index.html" title="Analytics"> + <i class="icon-chevron-right"></i> + Analytics</a> + </li> + + <li> + + <a href="../../../../metron-deployment/index.html" title="Deployment"> + <i class="icon-chevron-down"></i> + Deployment</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../../../metron-deployment/amazon-ec2/index.html" title="Amazon-ec2"> + <i class="none"></i> + Amazon-ec2</a> + </li> + + <li class="active"> + + <a href="#"><i class="none"></i>Ansible-docker</a> + </li> + + <li> + + <a href="../../../../metron-deployment/packaging/docker/rpm-docker/index.html" title="Rpm-docker"> + <i class="none"></i> + Rpm-docker</a> + </li> + + <li> + + <a href="../../../../metron-deployment/packaging/packer-build/index.html" title="Packer-build"> + <i class="none"></i> + Packer-build</a> + </li> + + <li> + + <a href="../../../../metron-deployment/roles/index.html" title="Roles"> + <i class="icon-chevron-right"></i> + Roles</a> + </li> + + <li> + + <a href="../../../../metron-deployment/vagrant/index.html" title="Vagrant"> + <i class="icon-chevron-right"></i> + Vagrant</a> + </li> + </ul> + </li> + + <li> + + <a href="../../../../metron-docker/index.html" title="Docker"> + <i class="none"></i> + Docker</a> + </li> + + <li> + + <a href="../../../../metron-interface/metron-config/index.html" title="Config"> + <i class="none"></i> + Config</a> + </li> + + <li> + + <a href="../../../../metron-interface/metron-rest/index.html" title="Rest"> + <i class="none"></i> + Rest</a> + </li> + + <li> + + <a href="../../../../metron-platform/index.html" title="Platform"> + <i class="icon-chevron-right"></i> + Platform</a> + </li> + + <li> + + <a href="../../../../metron-sensors/index.html" title="Sensors"> + <i class="icon-chevron-right"></i> + Sensors</a> + </li> + </ul> + </li> + </ul> + + + + <hr class="divider" /> + + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div class="clear"></div> + <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"> + <img class="builtBy" alt="Built by Maven" src="../../../../images/logos/maven-feather.png" /> + </a> + </div> + </div> + </div> + + + <div id="bodyColumn" class="span9" > + + <h1>Overview</h1> +<p><a name="Overview"></a></p> +<p>The Metron ansible-docker container is provided in an effort reduce the installation burden of deploying Metron in a live envirionment. It is provisioned with software required to sucessfully run the deployment scripts.</p> +<div class="section"> +<h2><a name="Building_the_Container"></a>Building the Container</h2> + +<ol style="list-style-type: decimal"> + +<li>Install Docker [https://www.docker.com/products/overview]</li> + +<li>Navigate to <project-directory>/metron-deployment/packaging/docker/ansible-docker</li> + +<li>Build the container <tt>docker build -t ansible-docker:2.0.0.2 .</tt></li> +</ol></div> +<div class="section"> +<h2><a name="Using_the_Container"></a>Using the Container</h2> +<p>Full instructions are found on the wiki [https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=65144361].</p> +<p>tl;dr</p> + +<ol style="list-style-type: decimal"> + +<li>docker run -it -v <project-directory>:/root/incubator-metron ansible-docker:2.0.0.2 bash</li> + +<li>cd /root/incubator-metron</li> + +<li>mvn clean package -DskipTests</li> +</ol></div> + </div> + </div> + </div> + + <hr/> + + <footer> + <div class="container-fluid"> + <div class="row span12">Copyright © 2017. + All Rights Reserved. + + </div> + + + + </div> + </footer> + </body> +</html>
Added: dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/packaging/docker/rpm-docker/index.html ============================================================================== --- dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/packaging/docker/rpm-docker/index.html (added) +++ dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/packaging/docker/rpm-docker/index.html Thu Apr 20 05:38:46 2017 @@ -0,0 +1,240 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 2017-04-19 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20170419" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Metron – Overview</title> + <link rel="stylesheet" href="../../../../css/apache-maven-fluido-1.3.0.min.css" /> + <link rel="stylesheet" href="../../../../css/site.css" /> + <link rel="stylesheet" href="../../../../css/print.css" media="print" /> + + + <script type="text/javascript" src="../../../../js/apache-maven-fluido-1.3.0.min.js"></script> + + + +<script type="text/javascript">$( document ).ready( function() { $( '.carousel' ).carousel( { interval: 3500 } ) } );</script> + + </head> + <body class="topBarDisabled"> + + + + + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"> + <a href="http://metron.incubator.apache.org/" id="bannerLeft"> + <img src="../../../../images/metron-logo.png" alt="Apache Metron - Incubating" width="148px" height="48px"/> + </a> + </div> + <div class="pull-right"> <a href="http://incubator.apache.org/" id="bannerRight"> + <img src="../../../../images/ApacheIncubating_Logo.png" alt="Apache Incubating" width="192px" height="48px"/> + </a> + </div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + + + <li class=""> + <a href="http://www.apache.org" class="externalLink" title="Apache"> + Apache</a> + </li> + <li class="divider ">/</li> + <li class=""> + <a href="http://metron.incubator.apache.org/" class="externalLink" title="Metron-Incubating"> + Metron-Incubating</a> + </li> + <li class="divider ">/</li> + <li class=""> + <a href="../../../../index.html" title="Documentation"> + Documentation</a> + </li> + <li class="divider ">/</li> + <li class="">Overview</li> + + + + <li id="publishDate" class="pull-right">Last Published: 2017-04-19</li> <li class="divider pull-right">|</li> + <li id="projectVersion" class="pull-right">Version: 0.4.0</li> + + </ul> + </div> + + + <div class="row-fluid"> + <div id="leftColumn" class="span3"> + <div class="well sidebar-nav"> + + + <ul class="nav nav-list"> + <li class="nav-header">User Documentation</li> + + <li> + + <a href="../../../../index.html" title="Metron"> + <i class="icon-chevron-down"></i> + Metron</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../../../Upgrading.html" title="Upgrading"> + <i class="none"></i> + Upgrading</a> + </li> + + <li> + + <a href="../../../../metron-analytics/index.html" title="Analytics"> + <i class="icon-chevron-right"></i> + Analytics</a> + </li> + + <li> + + <a href="../../../../metron-deployment/index.html" title="Deployment"> + <i class="icon-chevron-down"></i> + Deployment</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../../../metron-deployment/amazon-ec2/index.html" title="Amazon-ec2"> + <i class="none"></i> + Amazon-ec2</a> + </li> + + <li> + + <a href="../../../../metron-deployment/packaging/docker/ansible-docker/index.html" title="Ansible-docker"> + <i class="none"></i> + Ansible-docker</a> + </li> + + <li class="active"> + + <a href="#"><i class="none"></i>Rpm-docker</a> + </li> + + <li> + + <a href="../../../../metron-deployment/packaging/packer-build/index.html" title="Packer-build"> + <i class="none"></i> + Packer-build</a> + </li> + + <li> + + <a href="../../../../metron-deployment/roles/index.html" title="Roles"> + <i class="icon-chevron-right"></i> + Roles</a> + </li> + + <li> + + <a href="../../../../metron-deployment/vagrant/index.html" title="Vagrant"> + <i class="icon-chevron-right"></i> + Vagrant</a> + </li> + </ul> + </li> + + <li> + + <a href="../../../../metron-docker/index.html" title="Docker"> + <i class="none"></i> + Docker</a> + </li> + + <li> + + <a href="../../../../metron-interface/metron-config/index.html" title="Config"> + <i class="none"></i> + Config</a> + </li> + + <li> + + <a href="../../../../metron-interface/metron-rest/index.html" title="Rest"> + <i class="none"></i> + Rest</a> + </li> + + <li> + + <a href="../../../../metron-platform/index.html" title="Platform"> + <i class="icon-chevron-right"></i> + Platform</a> + </li> + + <li> + + <a href="../../../../metron-sensors/index.html" title="Sensors"> + <i class="icon-chevron-right"></i> + Sensors</a> + </li> + </ul> + </li> + </ul> + + + + <hr class="divider" /> + + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div class="clear"></div> + <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"> + <img class="builtBy" alt="Built by Maven" src="../../../../images/logos/maven-feather.png" /> + </a> + </div> + </div> + </div> + + + <div id="bodyColumn" class="span9" > + + <h1>Overview</h1> +<p><a name="Overview"></a></p> +<p>The Metron ansible-docker container is provided in an effort reduce the installation burden of deploying Metron in a live envirionment. It is provisioned with software required to sucessfully run the deployment scripts.</p> +<div class="section"> +<h2><a name="Building_the_Container"></a>Building the Container</h2> + +<ol style="list-style-type: decimal"> + +<li>Install Docker [https://www.docker.com/products/overview]</li> + +<li>Navigate to <project-directory>/metron-deployment/packaging/rpm-docker</li> + +<li>Build the container <tt>docker build -t rpm-docker .</tt></li> +</ol></div> + </div> + </div> + </div> + + <hr/> + + <footer> + <div class="container-fluid"> + <div class="row span12">Copyright © 2017. + All Rights Reserved. + + </div> + + + + </div> + </footer> + </body> +</html> Added: dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/packaging/packer-build/index.html ============================================================================== --- dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/packaging/packer-build/index.html (added) +++ dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/packaging/packer-build/index.html Thu Apr 20 05:38:46 2017 @@ -0,0 +1,286 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 2017-04-19 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20170419" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Metron – Build Metron Images</title> + <link rel="stylesheet" href="../../../css/apache-maven-fluido-1.3.0.min.css" /> + <link rel="stylesheet" href="../../../css/site.css" /> + <link rel="stylesheet" href="../../../css/print.css" media="print" /> + + + <script type="text/javascript" src="../../../js/apache-maven-fluido-1.3.0.min.js"></script> + + + +<script type="text/javascript">$( document ).ready( function() { $( '.carousel' ).carousel( { interval: 3500 } ) } );</script> + + </head> + <body class="topBarDisabled"> + + + + + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"> + <a href="http://metron.incubator.apache.org/" id="bannerLeft"> + <img src="../../../images/metron-logo.png" alt="Apache Metron - Incubating" width="148px" height="48px"/> + </a> + </div> + <div class="pull-right"> <a href="http://incubator.apache.org/" id="bannerRight"> + <img src="../../../images/ApacheIncubating_Logo.png" alt="Apache Incubating" width="192px" height="48px"/> + </a> + </div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + + + <li class=""> + <a href="http://www.apache.org" class="externalLink" title="Apache"> + Apache</a> + </li> + <li class="divider ">/</li> + <li class=""> + <a href="http://metron.incubator.apache.org/" class="externalLink" title="Metron-Incubating"> + Metron-Incubating</a> + </li> + <li class="divider ">/</li> + <li class=""> + <a href="../../../index.html" title="Documentation"> + Documentation</a> + </li> + <li class="divider ">/</li> + <li class="">Build Metron Images</li> + + + + <li id="publishDate" class="pull-right">Last Published: 2017-04-19</li> <li class="divider pull-right">|</li> + <li id="projectVersion" class="pull-right">Version: 0.4.0</li> + + </ul> + </div> + + + <div class="row-fluid"> + <div id="leftColumn" class="span3"> + <div class="well sidebar-nav"> + + + <ul class="nav nav-list"> + <li class="nav-header">User Documentation</li> + + <li> + + <a href="../../../index.html" title="Metron"> + <i class="icon-chevron-down"></i> + Metron</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../../Upgrading.html" title="Upgrading"> + <i class="none"></i> + Upgrading</a> + </li> + + <li> + + <a href="../../../metron-analytics/index.html" title="Analytics"> + <i class="icon-chevron-right"></i> + Analytics</a> + </li> + + <li> + + <a href="../../../metron-deployment/index.html" title="Deployment"> + <i class="icon-chevron-down"></i> + Deployment</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../../metron-deployment/amazon-ec2/index.html" title="Amazon-ec2"> + <i class="none"></i> + Amazon-ec2</a> + </li> + + <li> + + <a href="../../../metron-deployment/packaging/docker/ansible-docker/index.html" title="Ansible-docker"> + <i class="none"></i> + Ansible-docker</a> + </li> + + <li> + + <a href="../../../metron-deployment/packaging/docker/rpm-docker/index.html" title="Rpm-docker"> + <i class="none"></i> + Rpm-docker</a> + </li> + + <li class="active"> + + <a href="#"><i class="none"></i>Packer-build</a> + </li> + + <li> + + <a href="../../../metron-deployment/roles/index.html" title="Roles"> + <i class="icon-chevron-right"></i> + Roles</a> + </li> + + <li> + + <a href="../../../metron-deployment/vagrant/index.html" title="Vagrant"> + <i class="icon-chevron-right"></i> + Vagrant</a> + </li> + </ul> + </li> + + <li> + + <a href="../../../metron-docker/index.html" title="Docker"> + <i class="none"></i> + Docker</a> + </li> + + <li> + + <a href="../../../metron-interface/metron-config/index.html" title="Config"> + <i class="none"></i> + Config</a> + </li> + + <li> + + <a href="../../../metron-interface/metron-rest/index.html" title="Rest"> + <i class="none"></i> + Rest</a> + </li> + + <li> + + <a href="../../../metron-platform/index.html" title="Platform"> + <i class="icon-chevron-right"></i> + Platform</a> + </li> + + <li> + + <a href="../../../metron-sensors/index.html" title="Sensors"> + <i class="icon-chevron-right"></i> + Sensors</a> + </li> + </ul> + </li> + </ul> + + + + <hr class="divider" /> + + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div class="clear"></div> + <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"> + <img class="builtBy" alt="Built by Maven" src="../../../images/logos/maven-feather.png" /> + </a> + </div> + </div> + </div> + + + <div id="bodyColumn" class="span9" > + + <h1>Build Metron Images</h1> +<p>Based on the fantastic <a class="externalLink" href="https://github.com/chef/bento">Bento</a> project developed by Chef.</p> +<div class="section"> +<h2><a name="Images_Provided"></a>Images Provided</h2> + +<ul> + +<li>base-centos-6.7: Centos 6.7 + HDP. Used in the full-dev-platform Vagrant image</li> + +<li>quick-dev-centos-6.7: Centos 6.7 + HDP + Metron. Used for the quick-dev-platform Vagrant image.</li> +</ul></div> +<div class="section"> +<h2><a name="Prerequisites"></a>Prerequisites</h2> + +<ul> + +<li><a class="externalLink" href="https://www.packer.io/">Packer</a> 0.12.2</li> + +<li><a class="externalLink" href="https://www.virtualbox.org/">Virtualbox</a> 5.0.16+ (Tested with 5.0.20)</li> +</ul> +<p>Build Both Images ———————- Navigate to <your-project-directory>/metron-deployment/packer-build Execute bin/bento build</p> +<p>Packer will build both images and export .box files to the ./builds directory.</p> +<p>Build Single Images ———————- Navigate to <i>your-project-directory</i>/metron-deployment/packer-build</p> + +<ul> + +<li>Base Centos (full-dev)</li> +</ul> + +<div class="source"> +<div class="source"> +<pre>bin/bento build base-centos-6.7.json +</pre></div></div> + +<ul> + +<li>Quick Dev</li> +</ul> + +<div class="source"> +<div class="source"> +<pre>bin/bento build quick-dev-centos-6.7.json +</pre></div></div> +<p>Using Your New Box File ———————- Modify the relevant Vagrantfile (full-dev-platform or quick-dev-platform) replacing the lines:</p> + +<div class="source"> +<div class="source"> +<pre><pre><code>config.vm.box = "<i>box_name</i>" +config.ssh.insert_key = true</code></pre> +</pre></div></div> +<p>with</p> + +<div class="source"> +<div class="source"> +<pre><pre></code>config.vm.box = "<i>test_box_name</i>" +config.vm.box = "<i>PathToBoxfile/Boxfilename</i>" +config.ssh.insert_key = true</code></pre> +</pre></div></div> +<p>Launch the image as usual.</p> +<p>Node: Vagrant will cache boxes, you can force Vagrant to reload your box by running <tt>vagrant box remove <i>test_box_name</i></tt> before launching your new image.</p></div> + </div> + </div> + </div> + + <hr/> + + <footer> + <div class="container-fluid"> + <div class="row span12">Copyright © 2017. + All Rights Reserved. + + </div> + + + + </div> + </footer> + </body> +</html> Added: dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/roles/index.html ============================================================================== --- dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/roles/index.html (added) +++ dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/roles/index.html Thu Apr 20 05:38:46 2017 @@ -0,0 +1,278 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 2017-04-19 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20170419" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Metron – Ansible Roles</title> + <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" /> + <link rel="stylesheet" href="../../css/site.css" /> + <link rel="stylesheet" href="../../css/print.css" media="print" /> + + + <script type="text/javascript" src="../../js/apache-maven-fluido-1.3.0.min.js"></script> + + + +<script type="text/javascript">$( document ).ready( function() { $( '.carousel' ).carousel( { interval: 3500 } ) } );</script> + + </head> + <body class="topBarDisabled"> + + + + + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"> + <a href="http://metron.incubator.apache.org/" id="bannerLeft"> + <img src="../../images/metron-logo.png" alt="Apache Metron - Incubating" width="148px" height="48px"/> + </a> + </div> + <div class="pull-right"> <a href="http://incubator.apache.org/" id="bannerRight"> + <img src="../../images/ApacheIncubating_Logo.png" alt="Apache Incubating" width="192px" height="48px"/> + </a> + </div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + + + <li class=""> + <a href="http://www.apache.org" class="externalLink" title="Apache"> + Apache</a> + </li> + <li class="divider ">/</li> + <li class=""> + <a href="http://metron.incubator.apache.org/" class="externalLink" title="Metron-Incubating"> + Metron-Incubating</a> + </li> + <li class="divider ">/</li> + <li class=""> + <a href="../../index.html" title="Documentation"> + Documentation</a> + </li> + <li class="divider ">/</li> + <li class="">Ansible Roles</li> + + + + <li id="publishDate" class="pull-right">Last Published: 2017-04-19</li> <li class="divider pull-right">|</li> + <li id="projectVersion" class="pull-right">Version: 0.4.0</li> + + </ul> + </div> + + + <div class="row-fluid"> + <div id="leftColumn" class="span3"> + <div class="well sidebar-nav"> + + + <ul class="nav nav-list"> + <li class="nav-header">User Documentation</li> + + <li> + + <a href="../../index.html" title="Metron"> + <i class="icon-chevron-down"></i> + Metron</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../Upgrading.html" title="Upgrading"> + <i class="none"></i> + Upgrading</a> + </li> + + <li> + + <a href="../../metron-analytics/index.html" title="Analytics"> + <i class="icon-chevron-right"></i> + Analytics</a> + </li> + + <li> + + <a href="../../metron-deployment/index.html" title="Deployment"> + <i class="icon-chevron-down"></i> + Deployment</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../metron-deployment/amazon-ec2/index.html" title="Amazon-ec2"> + <i class="none"></i> + Amazon-ec2</a> + </li> + + <li> + + <a href="../../metron-deployment/packaging/docker/ansible-docker/index.html" title="Ansible-docker"> + <i class="none"></i> + Ansible-docker</a> + </li> + + <li> + + <a href="../../metron-deployment/packaging/docker/rpm-docker/index.html" title="Rpm-docker"> + <i class="none"></i> + Rpm-docker</a> + </li> + + <li> + + <a href="../../metron-deployment/packaging/packer-build/index.html" title="Packer-build"> + <i class="none"></i> + Packer-build</a> + </li> + + <li class="active"> + + <a href="#"><i class="icon-chevron-down"></i>Roles</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../metron-deployment/roles/monit/index.html" title="Monit"> + <i class="none"></i> + Monit</a> + </li> + + <li> + + <a href="../../metron-deployment/roles/opentaxii/index.html" title="Opentaxii"> + <i class="none"></i> + Opentaxii</a> + </li> + + <li> + + <a href="../../metron-deployment/roles/pcap_replay/index.html" title="Pcap_replay"> + <i class="none"></i> + Pcap_replay</a> + </li> + + <li> + + <a href="../../metron-deployment/roles/sensor-stubs/index.html" title="Sensor-stubs"> + <i class="none"></i> + Sensor-stubs</a> + </li> + + <li> + + <a href="../../metron-deployment/roles/sensor-test-mode/index.html" title="Sensor-test-mode"> + <i class="none"></i> + Sensor-test-mode</a> + </li> + </ul> + </li> + + <li> + + <a href="../../metron-deployment/vagrant/index.html" title="Vagrant"> + <i class="icon-chevron-right"></i> + Vagrant</a> + </li> + </ul> + </li> + + <li> + + <a href="../../metron-docker/index.html" title="Docker"> + <i class="none"></i> + Docker</a> + </li> + + <li> + + <a href="../../metron-interface/metron-config/index.html" title="Config"> + <i class="none"></i> + Config</a> + </li> + + <li> + + <a href="../../metron-interface/metron-rest/index.html" title="Rest"> + <i class="none"></i> + Rest</a> + </li> + + <li> + + <a href="../../metron-platform/index.html" title="Platform"> + <i class="icon-chevron-right"></i> + Platform</a> + </li> + + <li> + + <a href="../../metron-sensors/index.html" title="Sensors"> + <i class="icon-chevron-right"></i> + Sensors</a> + </li> + </ul> + </li> + </ul> + + + + <hr class="divider" /> + + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div class="clear"></div> + <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"> + <img class="builtBy" alt="Built by Maven" src="../../images/logos/maven-feather.png" /> + </a> + </div> + </div> + </div> + + + <div id="bodyColumn" class="span9" > + + <h1>Ansible Roles</h1> +<p><a name="Ansible_Roles"></a></p> + +<ul> + +<li>Kibana</li> + +<li>Monit</li> + +<li>OpenTaxii</li> + +<li>Pcap Relay</li> + +<li>Sensor Test Mode</li> +</ul> + </div> + </div> + </div> + + <hr/> + + <footer> + <div class="container-fluid"> + <div class="row span12">Copyright © 2017. + All Rights Reserved. + + </div> + + + + </div> + </footer> + </body> +</html> Added: dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/roles/monit/index.html ============================================================================== --- dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/roles/monit/index.html (added) +++ dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/roles/monit/index.html Thu Apr 20 05:38:46 2017 @@ -0,0 +1,334 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 2017-04-19 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20170419" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Metron – Monit Integration</title> + <link rel="stylesheet" href="../../../css/apache-maven-fluido-1.3.0.min.css" /> + <link rel="stylesheet" href="../../../css/site.css" /> + <link rel="stylesheet" href="../../../css/print.css" media="print" /> + + + <script type="text/javascript" src="../../../js/apache-maven-fluido-1.3.0.min.js"></script> + + + +<script type="text/javascript">$( document ).ready( function() { $( '.carousel' ).carousel( { interval: 3500 } ) } );</script> + + </head> + <body class="topBarDisabled"> + + + + + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"> + <a href="http://metron.incubator.apache.org/" id="bannerLeft"> + <img src="../../../images/metron-logo.png" alt="Apache Metron - Incubating" width="148px" height="48px"/> + </a> + </div> + <div class="pull-right"> <a href="http://incubator.apache.org/" id="bannerRight"> + <img src="../../../images/ApacheIncubating_Logo.png" alt="Apache Incubating" width="192px" height="48px"/> + </a> + </div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + + + <li class=""> + <a href="http://www.apache.org" class="externalLink" title="Apache"> + Apache</a> + </li> + <li class="divider ">/</li> + <li class=""> + <a href="http://metron.incubator.apache.org/" class="externalLink" title="Metron-Incubating"> + Metron-Incubating</a> + </li> + <li class="divider ">/</li> + <li class=""> + <a href="../../../index.html" title="Documentation"> + Documentation</a> + </li> + <li class="divider ">/</li> + <li class="">Monit Integration</li> + + + + <li id="publishDate" class="pull-right">Last Published: 2017-04-19</li> <li class="divider pull-right">|</li> + <li id="projectVersion" class="pull-right">Version: 0.4.0</li> + + </ul> + </div> + + + <div class="row-fluid"> + <div id="leftColumn" class="span3"> + <div class="well sidebar-nav"> + + + <ul class="nav nav-list"> + <li class="nav-header">User Documentation</li> + + <li> + + <a href="../../../index.html" title="Metron"> + <i class="icon-chevron-down"></i> + Metron</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../../Upgrading.html" title="Upgrading"> + <i class="none"></i> + Upgrading</a> + </li> + + <li> + + <a href="../../../metron-analytics/index.html" title="Analytics"> + <i class="icon-chevron-right"></i> + Analytics</a> + </li> + + <li> + + <a href="../../../metron-deployment/index.html" title="Deployment"> + <i class="icon-chevron-down"></i> + Deployment</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../../metron-deployment/amazon-ec2/index.html" title="Amazon-ec2"> + <i class="none"></i> + Amazon-ec2</a> + </li> + + <li> + + <a href="../../../metron-deployment/packaging/docker/ansible-docker/index.html" title="Ansible-docker"> + <i class="none"></i> + Ansible-docker</a> + </li> + + <li> + + <a href="../../../metron-deployment/packaging/docker/rpm-docker/index.html" title="Rpm-docker"> + <i class="none"></i> + Rpm-docker</a> + </li> + + <li> + + <a href="../../../metron-deployment/packaging/packer-build/index.html" title="Packer-build"> + <i class="none"></i> + Packer-build</a> + </li> + + <li> + + <a href="../../../metron-deployment/roles/index.html" title="Roles"> + <i class="icon-chevron-down"></i> + Roles</a> + <ul class="nav nav-list"> + + <li class="active"> + + <a href="#"><i class="none"></i>Monit</a> + </li> + + <li> + + <a href="../../../metron-deployment/roles/opentaxii/index.html" title="Opentaxii"> + <i class="none"></i> + Opentaxii</a> + </li> + + <li> + + <a href="../../../metron-deployment/roles/pcap_replay/index.html" title="Pcap_replay"> + <i class="none"></i> + Pcap_replay</a> + </li> + + <li> + + <a href="../../../metron-deployment/roles/sensor-stubs/index.html" title="Sensor-stubs"> + <i class="none"></i> + Sensor-stubs</a> + </li> + + <li> + + <a href="../../../metron-deployment/roles/sensor-test-mode/index.html" title="Sensor-test-mode"> + <i class="none"></i> + Sensor-test-mode</a> + </li> + </ul> + </li> + + <li> + + <a href="../../../metron-deployment/vagrant/index.html" title="Vagrant"> + <i class="icon-chevron-right"></i> + Vagrant</a> + </li> + </ul> + </li> + + <li> + + <a href="../../../metron-docker/index.html" title="Docker"> + <i class="none"></i> + Docker</a> + </li> + + <li> + + <a href="../../../metron-interface/metron-config/index.html" title="Config"> + <i class="none"></i> + Config</a> + </li> + + <li> + + <a href="../../../metron-interface/metron-rest/index.html" title="Rest"> + <i class="none"></i> + Rest</a> + </li> + + <li> + + <a href="../../../metron-platform/index.html" title="Platform"> + <i class="icon-chevron-right"></i> + Platform</a> + </li> + + <li> + + <a href="../../../metron-sensors/index.html" title="Sensors"> + <i class="icon-chevron-right"></i> + Sensors</a> + </li> + </ul> + </li> + </ul> + + + + <hr class="divider" /> + + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div class="clear"></div> + <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"> + <img class="builtBy" alt="Built by Maven" src="../../../images/logos/maven-feather.png" /> + </a> + </div> + </div> + </div> + + + <div id="bodyColumn" class="span9" > + + <h1>Monit Integration</h1> +<p><a name="Monit_Integration"></a></p> +<p>This role will leverage Monit as a process watchdog to manage sensors, topologies, and core services. </p> + +<ul> + +<li>Monit can be used to start, stop, or check status of any of the sensors or topologies.</li> + +<li>When monitoring is enabled (on by default) if a process dies, it will be restarted.</li> + +<li>The Monit web interface is exposed at <a class="externalLink" href="http://hostname:2812">http://hostname:2812</a>.</li> + +<li>The web interface username and password is defined by the <tt>monit_user</tt> and <tt>monit_password</tt> variables. These default to <tt>admin</tt>/<tt>monit</tt>.</li> + +<li>Monit CLI tools can also be used to simplify the process of managing Metron components.</li> + +<li> +<p>The post-deployment report for Amazon-EC2 provides links to Monit’s web interface labeled as ‘Sensor Status’ and ‘Topology Status.’</p> + +<div class="source"> +<div class="source"> +<pre> ok: [localhost] => { +"Success": [ + "Apache Metron deployed successfully", + " Metron @ http://ec2-52-39-143-62.us-west-2.compute.amazonaws.com:5000", + " Ambari @ http://ec2-52-39-4-93.us-west-2.compute.amazonaws.com:8080", + " Sensor Status @ http://ec2-52-39-4-93.us-west-2.compute.amazonaws.com:2812", + " Topology Status @ http://ec2-52-39-130-62.us-west-2.compute.amazonaws.com:2812", + "For additional information, see https://metron.incubator.apache.org/'" +] + } +</pre></div></div></li> +</ul> +<div class="section"> +<h2><a name="Usage"></a>Usage</h2> +<p>Start all Metron components</p> + +<div class="source"> +<div class="source"> +<pre>monit start all +</pre></div></div> +<p>Stop all Metron components</p> + +<div class="source"> +<div class="source"> +<pre>monit stop all +</pre></div></div> +<p>Start an individual Metron component</p> + +<div class="source"> +<div class="source"> +<pre>monit start bro-parser +</pre></div></div> +<p>Start all components required to ingest Bro data</p> + +<div class="source"> +<div class="source"> +<pre>monit -g bro start +</pre></div></div> +<p>Start all parsers</p> + +<div class="source"> +<div class="source"> +<pre>monit -g parsers start +</pre></div></div> +<p>What is running?</p> + +<div class="source"> +<div class="source"> +<pre>monit summary +</pre></div></div></div> + </div> + </div> + </div> + + <hr/> + + <footer> + <div class="container-fluid"> + <div class="row span12">Copyright © 2017. + All Rights Reserved. + + </div> + + + + </div> + </footer> + </body> +</html> Added: dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/roles/opentaxii/index.html ============================================================================== --- dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/roles/opentaxii/index.html (added) +++ dev/incubator/metron/0.4.0-RC1-incubating/book-site/metron-deployment/roles/opentaxii/index.html Thu Apr 20 05:38:46 2017 @@ -0,0 +1,426 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 2017-04-19 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20170419" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Metron – OpenTAXII</title> + <link rel="stylesheet" href="../../../css/apache-maven-fluido-1.3.0.min.css" /> + <link rel="stylesheet" href="../../../css/site.css" /> + <link rel="stylesheet" href="../../../css/print.css" media="print" /> + + + <script type="text/javascript" src="../../../js/apache-maven-fluido-1.3.0.min.js"></script> + + + +<script type="text/javascript">$( document ).ready( function() { $( '.carousel' ).carousel( { interval: 3500 } ) } );</script> + + </head> + <body class="topBarDisabled"> + + + + + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"> + <a href="http://metron.incubator.apache.org/" id="bannerLeft"> + <img src="../../../images/metron-logo.png" alt="Apache Metron - Incubating" width="148px" height="48px"/> + </a> + </div> + <div class="pull-right"> <a href="http://incubator.apache.org/" id="bannerRight"> + <img src="../../../images/ApacheIncubating_Logo.png" alt="Apache Incubating" width="192px" height="48px"/> + </a> + </div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + + + <li class=""> + <a href="http://www.apache.org" class="externalLink" title="Apache"> + Apache</a> + </li> + <li class="divider ">/</li> + <li class=""> + <a href="http://metron.incubator.apache.org/" class="externalLink" title="Metron-Incubating"> + Metron-Incubating</a> + </li> + <li class="divider ">/</li> + <li class=""> + <a href="../../../index.html" title="Documentation"> + Documentation</a> + </li> + <li class="divider ">/</li> + <li class="">OpenTAXII</li> + + + + <li id="publishDate" class="pull-right">Last Published: 2017-04-19</li> <li class="divider pull-right">|</li> + <li id="projectVersion" class="pull-right">Version: 0.4.0</li> + + </ul> + </div> + + + <div class="row-fluid"> + <div id="leftColumn" class="span3"> + <div class="well sidebar-nav"> + + + <ul class="nav nav-list"> + <li class="nav-header">User Documentation</li> + + <li> + + <a href="../../../index.html" title="Metron"> + <i class="icon-chevron-down"></i> + Metron</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../../Upgrading.html" title="Upgrading"> + <i class="none"></i> + Upgrading</a> + </li> + + <li> + + <a href="../../../metron-analytics/index.html" title="Analytics"> + <i class="icon-chevron-right"></i> + Analytics</a> + </li> + + <li> + + <a href="../../../metron-deployment/index.html" title="Deployment"> + <i class="icon-chevron-down"></i> + Deployment</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../../metron-deployment/amazon-ec2/index.html" title="Amazon-ec2"> + <i class="none"></i> + Amazon-ec2</a> + </li> + + <li> + + <a href="../../../metron-deployment/packaging/docker/ansible-docker/index.html" title="Ansible-docker"> + <i class="none"></i> + Ansible-docker</a> + </li> + + <li> + + <a href="../../../metron-deployment/packaging/docker/rpm-docker/index.html" title="Rpm-docker"> + <i class="none"></i> + Rpm-docker</a> + </li> + + <li> + + <a href="../../../metron-deployment/packaging/packer-build/index.html" title="Packer-build"> + <i class="none"></i> + Packer-build</a> + </li> + + <li> + + <a href="../../../metron-deployment/roles/index.html" title="Roles"> + <i class="icon-chevron-down"></i> + Roles</a> + <ul class="nav nav-list"> + + <li> + + <a href="../../../metron-deployment/roles/monit/index.html" title="Monit"> + <i class="none"></i> + Monit</a> + </li> + + <li class="active"> + + <a href="#"><i class="none"></i>Opentaxii</a> + </li> + + <li> + + <a href="../../../metron-deployment/roles/pcap_replay/index.html" title="Pcap_replay"> + <i class="none"></i> + Pcap_replay</a> + </li> + + <li> + + <a href="../../../metron-deployment/roles/sensor-stubs/index.html" title="Sensor-stubs"> + <i class="none"></i> + Sensor-stubs</a> + </li> + + <li> + + <a href="../../../metron-deployment/roles/sensor-test-mode/index.html" title="Sensor-test-mode"> + <i class="none"></i> + Sensor-test-mode</a> + </li> + </ul> + </li> + + <li> + + <a href="../../../metron-deployment/vagrant/index.html" title="Vagrant"> + <i class="icon-chevron-right"></i> + Vagrant</a> + </li> + </ul> + </li> + + <li> + + <a href="../../../metron-docker/index.html" title="Docker"> + <i class="none"></i> + Docker</a> + </li> + + <li> + + <a href="../../../metron-interface/metron-config/index.html" title="Config"> + <i class="none"></i> + Config</a> + </li> + + <li> + + <a href="../../../metron-interface/metron-rest/index.html" title="Rest"> + <i class="none"></i> + Rest</a> + </li> + + <li> + + <a href="../../../metron-platform/index.html" title="Platform"> + <i class="icon-chevron-right"></i> + Platform</a> + </li> + + <li> + + <a href="../../../metron-sensors/index.html" title="Sensors"> + <i class="icon-chevron-right"></i> + Sensors</a> + </li> + </ul> + </li> + </ul> + + + + <hr class="divider" /> + + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div class="clear"></div> + <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"> + <img class="builtBy" alt="Built by Maven" src="../../../images/logos/maven-feather.png" /> + </a> + </div> + </div> + </div> + + + <div id="bodyColumn" class="span9" > + + <h1>OpenTAXII</h1> +<p><a name="OpenTAXII"></a></p> +<p>Installs <a class="externalLink" href="https://github.com/EclecticIQ/OpenTAXII">OpenTAXII</a> as a deamon that can be launched via a SysV service script. The complementary client implementation, <a class="externalLink" href="https://github.com/EclecticIQ/cabby">Cabby</a> is also installed.</p> +<p>OpenTAXII is a robust Python implementation of TAXII Services that delivers a rich feature set and friendly pythonic API. <a class="externalLink" href="https://stixproject.github.io/">TAXII</a> (Trusted Automated eXchange of Indicator Information) is a collection of specifications defining a set of services and message exchanges used for sharing cyber threat intelligence information between parties.</p> +<div class="section"> +<h2><a name="Getting_Started"></a>Getting Started</h2> +<p>After deployment completes the OpenTAXII service is installed and running. A set of <a class="externalLink" href="http://hailataxii.com/">Hail a TAXII</a> threat intel collections have been defined and configured. Use the <tt>status</tt> option to view the collections that have been defined.</p> + +<div class="source"> +<div class="source"> +<pre>$ service opentaxii status +Checking opentaxii... Running +guest.phishtank_com 0 +guest.Abuse_ch 0 +guest.CyberCrime_Tracker 0 +guest.EmergingThreats_rules 0 +guest.Lehigh_edu 0 +guest.MalwareDomainList_Hostlist 0 +guest.blutmagie_de_torExits 0 +guest.dataForLast_7daysOnly 0 +guest.dshield_BlockList 0 +</pre></div></div> +<p>Notice that each collections contain zero records. None of the data is automatically synced during deployment. To sync the data manually use the <tt>sync</tt> option as defined below. The following example does not provide a begin and end time so the data will be fetched for the current day only.</p> + +<div class="source"> +<div class="source"> +<pre># service opentaxii sync guest.blutmagie_de_torExits +2016-04-21 20:34:42,511 INFO: Starting new HTTP connection (1): localhost +2016-04-21 20:34:42,540 INFO: Response received for Inbox_Message from http://localhost:9000/services/inbox +2016-04-21 20:34:42,542 INFO: Sending Inbox_Message to http://localhost:9000/services/inbox +... +2016-04-21 20:34:42,719 INFO: Response received for Poll_Request from http://localhost:9000/services/poll +2016-04-21 20:34:42,719 INFO: Content blocks count: 1618, is partial: False +</pre></div></div> +<p>The OpenTAXII service now contains 1,618 threat intel records indicating Tor Exit nodes.</p> + +<div class="source"> +<div class="source"> +<pre>[root@source ~]# service opentaxii status +Checking opentaxii... Running +guest.phishtank_com 0 +guest.Abuse_ch 0 +guest.CyberCrime_Tracker 0 +guest.EmergingThreats_rules 0 +guest.Lehigh_edu 0 +guest.MalwareDomainList_Hostlist 0 +guest.blutmagie_de_torExits 1618 +guest.dataForLast_7daysOnly 0 +guest.dshield_BlockList 0 +</pre></div></div></div> +<div class="section"> +<h2><a name="Usage"></a>Usage</h2> +<p>A standard SysV script has been installed to manage OpenTAXII. The following functions are available.</p> +<p><tt>start</tt> <tt>stop</tt> <tt>restart</tt> the OpenTAXII service</p> +<p><tt>status</tt> of the OpenTAXII service. The command displays the collections that have been defined and the number of records in each.</p> + +<div class="source"> +<div class="source"> +<pre>$ service opentaxii status +Checking opentaxii... Running +guest.phishtank_com 984 +guest.Abuse_ch 45 +guest.CyberCrime_Tracker 482 +guest.EmergingThreats_rules 0 +guest.Lehigh_edu 1030 +guest.MalwareDomainList_Hostlist 84 +guest.blutmagie_de_torExits 3236 +guest.dataForLast_7daysOnly 3377 +guest.dshield_BlockList 0 +</pre></div></div> +<p><tt>setup</tt> Initializes the services and collections required to operate the OpenTAXII service. This will destroy all existing data. The user is prompted to continue before any data is destroyed.</p> + +<div class="source"> +<div class="source"> +<pre># service opentaxii setup +WARNING: force reset and destroy all opentaxii data? [Ny]: y +Stopping opentaxii ..Ok +2016-04-21T19:56:01.886157Z [opentaxii.server] info: api.persistence.loaded {timestamp=2016-04-21T19:56:01.886157Z, logger=opentaxii.server, api_class=SQLDatabaseAPI, event=api.persistence.loaded, level=info} +2016-04-21T19:56:01.896503Z [opentaxii.server] info: api.auth.loaded {timestamp=2016-04-21T19:56:01.896503Z, logger=opentaxii.server, api_class=SQLDatabaseAPI, event=api.auth.loaded, level=info} +2016-04-21T19:56:01.896655Z [opentaxii.server] info: taxiiserver.configured {timestamp=2016-04-21T19:56:01.896655Z, logger=opentaxii.server, event=taxiiserver.configured, level=info} +... +Ok +</pre></div></div> +<p><tt>sync [collection] [begin-at] [end-at]</tt> Syncs the threat intel data available at <a class="externalLink" href="http://hailataxii.com/">Hail a TAXII</a>. If no begin and end date is provided then data is synced over the current day only.</p> + +<ul> + +<li><tt>collection</tt> Name of the collection to sync.</li> + +<li><tt>begin-at</tt> Exclusive begin of time window; ISO8601</li> + +<li><tt>end-at</tt> Inclusive end of time window; ISO8601</li> +</ul> + +<div class="source"> +<div class="source"> +<pre>$ service opentaxii sync guest.phishtank_com ++ /usr/local/opentaxii/opentaxii-venv/bin/taxii-proxy --poll-path http://hailataxii.com/taxii-data --poll-collection guest.phishtank_com --inbox-path http://localhost:9000/services/guest.phishtank_com-inbox --inbox-collection guest.phishtank_com --binding urn:stix.mitre.org:xml:1.1.1 --begin 2016-04-21 --end 2016-04-22 +2016-04-21 17:36:23,778 INFO: Sending Poll_Request to http://hailataxii.com/taxii-data +2016-04-21 17:36:23,784 INFO: Starting new HTTP connection (1): hailataxii.com +2016-04-21 17:36:24,175 INFO: Response received for Poll_Request from http://hailataxii.com/taxii-data +2016-04-21 17:36:24,274 INFO: Sending Inbox_Message to http://localhost:9000/services/guest.phishtank_com-inbox +... +2016-04-21 17:36:34,867 INFO: Response received for Poll_Request from http://localhost:9000/services/guest.phishtank_com-poll +2016-04-21 17:36:34,868 INFO: Content blocks count: 6993, is partial: False +</pre></div></div> +<div class="section"> +<h3><a name="Troubleshooting"></a>Troubleshooting</h3> +<p>Should you need to explore the installation, here are instructions on doing so.</p> +<p>OpenTAXII is installed in a virtual environment. Before exploring the environment run the following commands to perform the necessary setup. The specific paths may change depending on your Ansible settings.</p> + +<div class="source"> +<div class="source"> +<pre>export LD_LIBRARY_PATH=/opt/rh/python27/root/usr/lib64 +export OPENTAXII_CONFIG=/usr/local/opentaxii/etc/opentaxii-conf.yml +cd /usr/local/opentaxii +. opentaxii-venv/bin/activate +</pre></div></div> +<p>Discover available services.</p> + +<div class="source"> +<div class="source"> +<pre>taxii-discovery --discovery http://localhost:9000/services/discovery +taxii-discovery --discovery http://hailataxii.com/taxii-data +</pre></div></div> +<p>Explore available collections.</p> + +<div class="source"> +<div class="source"> +<pre>taxii-collections --discovery http://localhost:9000/services/discovery +taxii-collections --discovery http://hailataxii.com/taxii-data +</pre></div></div> +<p>Read data from a collection.</p> + +<div class="source"> +<div class="source"> +<pre>taxii-poll --discovery http://localhost:9000/services/discovery -c guest.phishtank_com +taxii-poll --discovery http://hailataxii.com/taxii-data -c guest.phishtank_com --begin 2016-04-20 +</pre></div></div> +<p>Manually load data into a collection.</p> + +<div class="source"> +<div class="source"> +<pre>taxii-push \ + --discovery http://localhost:9000/services/discovery \ + --dest phishtank \ + --content-file data.xml \ + --username guest \ + --password guest +</pre></div></div> +<p>Fetch data from a remote service and mirror it locally.</p> + +<div class="source"> +<div class="source"> +<pre>taxii-proxy --poll-path http://hailataxii.com/taxii-data \ + --poll-collection guest.phishtank_com \ + --inbox-path http://localhost:9000/services/guest.phishtank_com-inbox \ + --inbox-collection guest.phishtank_com \ + --binding urn:stix.mitre.org:xml:1.1.1 \ + --inbox-username guest \ + --inbox-password guest \ + --begin 2016-04-20 +</pre></div></div></div></div> + </div> + </div> + </div> + + <hr/> + + <footer> + <div class="container-fluid"> + <div class="row span12">Copyright © 2017. + All Rights Reserved. + + </div> + + + + </div> + </footer> + </body> +</html>
