This Confluence has been LDAP enabled, if you are an ASF Committer, please use your LDAP Credentials to login. Any problems file an INFRA jira ticket please.

Skip to end of metadata
Go to start of metadata

Contributed by Umesh Kaushik <>


These instructions are for an Ubuntu host, with occasional comments about how to do similar tasks in CentOS.  It uses Metron's Vagrant support to launch a single-node VM installation.  The Vagrant image actually uses Debian instead of Ubuntu, because that was readily available, and they are very similar.  Resource requirements: These steps were tested on a Vagrant VM assigned 20 GB RAM, 100GB disk, and 2 CPUs.  Installation may work with lesser resources, but insufficient RAM will require turning off some processes.


As usual, remember to re-type commands, or at least be careful with cut-and-paste, as the cwiki formatter may have changed hyphens, quotes, etc., into similar-looking non-ascii characters.

Step-by-step guide

  • Install pip:
  • sudo apt-get install python-pip python-dev build-essential
  • sudo pip install --upgrade pip
  • Install virtual box ( ubuntu, centos )
  • Install Java
    • (For centos, see here: centos)
    • sudo add-apt-repository ppa:webupd8team/java
    • sudo apt update
    • sudo apt install oracle-java8-installer
  • Install Vagrant:
    • Version issue:
      • 1.8.1 -> Plugin issue, can not download the pulgin
      • 1.8.5 -> Authentication issue while connecting to vmbox
      • Default apt-get install vagrant will give v 1.8.1
    • Download latest version from here for debian and then dpkg the package OR 
  • Install Maven
  • Install ansible
    • Version 2.4.0+ is supported by metron (as per the documents available online)
    • Installation instructions here
    • While installing ansible one may face errors regarding cryptography package following command should resolve that.
      • sudo apt-get install python-pip python-dev libffi-dev libssl-dev libxml2-dev libxslt1-dev libjpeg8-dev zlib1g-dev
      • For Centos this should probably solve it
        • Try following first:
          • sudo pip install -U setuptools
          • sudo pip install distribute
          • Try running the anisble installation command
        • If this doesn’t work:
          • sudo yum install gcc libffi-devel python-devel openssl-devel
          • Else use:
            • yum search python | grep -i devel
            • And see what all packages can resolve the issue (hit and trial)
  • Set Java and Maven Paths
    • mvn -v in terminal should show the maven path
    • Edit /etc/environments
    • Add: JAVA_HOME="java path"
    • Add: MAVEN_HOME="maven path"
  • Clone project from Apache Metron repo and build the packages and launch the Vagrant VM. Run the following commands:
  • Once the launch is successful:
    • The Vagrant VM will be running as "node1"
    • Ambari should be available in your browser at http://node1:8080/
    • Kibana should be available in your browser at http://node1:5000/
    • Monit should be available in your browser at http://node1:2812/ 
      • If Monit fails to work, or does not provide the expected data, then do the following:
      • vagrant ssh
      • sudo vi (or nano or vim) /etc/hosts
      • There should be a line near the top of the file that reads:
        •  localhost
        • (this is good)

      • However, sometimes Vagrant hostmanager adds a line that says:
        •  node1  node1
        • (this is bad)

      • If both lines exist, remove the bad line.  If the good line does not exist, replace the bad line with the good line.
      • Save and exit the editor
      • The rest should work fine

The above steps are based on:

Apache Metron TP 1 Install Instructions- Single Node Vagrant Deployment

which is also related to Metron cwiki page:

Metron 0.3.1 with HDP 2.5.0, Ambari 2.4.1, Centos 6, bare-metal install

Other useful links: