Page History

Step 0 – Verify Release

Verify that the maven artifacts are the right version by inspecting the top level pom.xml and looking at the version.

Verify that the release bits are the signed properly by running:

gpg --import KEYS

export VERSION=<metron-release-version>
gpg --verify ./apache-metron_$VERSION.tar.gz.asc apache-metron_$VERSION.tar.gz

Note: on Mac you might not have gpg installed by default. You can add it via Homebrew with the command "brew install gpg"

Step 1 – Build Metron

cd incubatorapache-metron/_$VERSION
mvn clean install

Verify that all tests are passing

Step 2 – Deploy metron as a single VM via vagrant and ansibleAnsible

cd metron-deployment/development/vagrantcentos6/full-dev-platform
vagrant plugin install vagrant-hostmanager
./run.shvagrant up

For a more complete set of instructions refer to:
https://github.com/apache/incubator-metron/tree/master/metron-deployment and 
https://github.com/apache/metron/tree/master/metron-deployment/development

deployment

Verify metron is working:
- Check Ambari to make sure all the services are up by going to ambari in a browser at http://node1:8080- Check the Monit service interface at 

http://node1:2812 (user/pass of admin/admin) and turn on the bro, snort, and yaf topologies
- Check Storm to make sure all the topologies are up
      From Ambari navigate to Storm -> Quick Links -> Storm UI
- Check that the enrichment topology has emitted some data (could take a few minutes to show
up in the Storm UI)
- Check indexes to make sure indexing is done correctly and data is visualized in Kibana in
a browser at http://node1:5000
- Check that some data is written into HDFS for at least one of the data sources
      Look in HDFS under /apps/metron/enrichmentindexing/indexed/yaf_doc|bro_doc|snort_doc

      This can be done fromby therunning browserhdfs by going to http://node:50070/explorer.html#dfs -ls /apps/metron/enrichmentindexing/indexed/

- Test the Management UI at http://node1:4200/ 

Step 3 (optional) – Verify AWS Multi-Node Deploy with Ansible (NOTE: This will cost money to deploy AWS servers)
cd metron-deployment/amazon-ec2
./run.sh

For a more complete set of instructions refer to:
https://github.com/apache/incubator-metron/tree/master/metron-deployment

To verify the working build go through the same verifications as in Step2, but on AWS.  Reference
playbook.yml for location of the services.
Ambari-master contains Ambari, web contains Kibana and sensors.