From 0bdcd9f65dbca34501f4988bd8a3dbbfee8e17ec Mon Sep 17 00:00:00 2001
From: Johan Oskarsson <johan@oskarsson.nu>
Date: Wed, 22 Aug 2012 11:44:38 -0700
Subject: [PATCH] Added Centos6 quick start & fixed that bin/sbt '[' annoyance

First sane draft of a quick start on centos6
Also fixed the SBT '[' thing as
it's been bugging me (https://github.com/twitter/zipkin/issues/30)

Author: @glynd
Fixes #116
URL: https://github.com/twitter/zipkin/pull/116
---
 bin/sbt                    |   3 +-
 doc/centos6-quickstart.txt | 130 +++++++++++++++++++++++++++++++++++++
 2 files changed, 132 insertions(+), 1 deletion(-)
 create mode 100644 doc/centos6-quickstart.txt

diff --git a/bin/sbt b/bin/sbt
index 6edeb6493b5..295073007dc 100755
--- a/bin/sbt
+++ b/bin/sbt
@@ -13,7 +13,8 @@ if [ ! -f $sbtjar ]; then
 fi
 
 test -f $sbtjar || exit 1
-if [ $(openssl md5 < $sbtjar) != 2886cc391e38fa233b3e6c0ec9adfa1e ]; then
+sbtchksum=`openssl md5 <$sbtjar | cut -d" " -f2`
+if [ $sbtchksum != 2886cc391e38fa233b3e6c0ec9adfa1e ]; then
   echo 'bad sbtjar!' 1>&2
   exit 1
 fi
diff --git a/doc/centos6-quickstart.txt b/doc/centos6-quickstart.txt
new file mode 100644
index 00000000000..c52b111632a
--- /dev/null
+++ b/doc/centos6-quickstart.txt
@@ -0,0 +1,130 @@
+This doc describes a quickstart to running the basic Zipkin/Finatra service, with everything running on one machine
+It presumes you have a clean-ish Centos 6 install, and a user with sudo capabilities (eg user is in wheel group and wheel group is allowed in /etc/sudoers)
+
+This includes building Zipkin from the current master branch from Github.
+Glyn Davies - 22/8/2012
+glyn@snax.net
+
+--------------------------------
+Groundwork - perform this as ROOT
+--------------------------------
+
+
+1. Add the Datastax REPO, from http://www.datastax.com/docs/1.1/install/install_rpm
+
+vi /etc/yum.repos.d/datastax.repo
+
+8<---------8<---------8<---------8<---------8<---------8<---------
+[datastax]
+name= DataStax Repo for Apache Cassandra
+baseurl=http://rpm.datastax.com/community
+enabled=1
+gpgcheck=0
+8<---------8<---------8<---------8<---------8<---------8<---------
+
+2. Install Cassandra
+yum install dsc1.1 
+
+
+3. Add the Cloudera Repo
+
+cd /etc/yum.repos.d/
+wget http://archive.cloudera.com/cdh4/redhat/6/x86_64/cdh/cloudera-cdh4.repo
+
+4. Install Zookeeper
+yum install zookeeper-server
+
+
+5. Install Java 7 JDK
+
+Download RPM from: http://www.oracle.com/technetwork/java/javase/downloads/jdk-7u3-download-1501626.html
+
+6. Install Java RPM: 
+rpm -i jdk-7u3-linux-x64.rpm
+
+7. Set Sun JVM as the operative JVM
+
+alternatives --install /usr/bin/java java /usr/java/jdk1.7.0_03/bin/java 20000
+alternatives --set java /usr/java/jdk1.7.0_03/bin/java
+
+
+8. Add Casssandra to the startup system, then start it
+ chkconfig --add cassandra
+ service cassandra start
+
+
+9. Initialise Zookeeper install (different if you are doing a multi node cluster) 
+/etc/init.d/zookeeper-server init
+/sbin/service zookeeper-server start
+See: https://ccp.cloudera.com/display/CDH4DOC/ZooKeeper+Installation#ZooKeeperInstallation-InstallingtheZooKeeperPackages
+
+
+10. Install GIT
+yum install git
+
+11. Install screen
+yum install screen
+
+12. Disable IPtables (WARNING - THIS IS A SECURITY RISK IF YOU ARE NOT IN A CONTROLLED ENVIRONMENT)
+
+service iptables stop
+chkconfig iptables off
+
+
+
+--------------------------------
+Zipkin time - perform as your user (glynd in my case)
+--------------------------------
+
+13. Obtain Zipkin
+
+cd 
+mkdir github
+cd github
+
+Follow instructions from: https://github.com/twitter/zipkin/
+
+git clone https://github.com/twitter/zipkin.git
+
+
+14. Become root / sudo to stop zookeeper (otherwise the zipkin tests fail)
+
+sudo service zookeeper-server stop
+
+
+15. Build Zipkin
+
+cd zipkin
+bin/sbt update package-dist
+
+Note: This can take a while, and also relies on certain mirrors being up to provide required libraries
+
+16. Restart zookeeper (assuming build was successful)
+
+sudo service zookeeper-server start
+
+17. Create somewhere to install to:
+
+sudo mkdir /usr/local/zipkin
+sudo chown **MYUSERNAME** /usr/local/zipkin
+
+18. Expand out the required components (here collector, query and finatra)
+unzip -d /usr/local/zipkin/zipkin-server zipkin-server/dist/zipkin-server.zip
+unzip -d /usr/local/zipkin/zipkin-scribe  zipkin-scribe/dist/zipkin-scribe.zip
+unzip -d /usr/local/zipkin/zipkin-finatra zipkin-finatra/dist/zipkin-finatra.zip
+
+19. Set scripts to be executable...
+cd /usr/local/zipkin/
+chmod +x zipkin-server/scripts/*
+chmod +x zipkin-scribe/scripts/*
+chmod +x zipkin-finatra/scripts/*
+
+20. Run it up!
+
+zipkin-server/scripts/query.sh -f zipkin-server/config/query-dev.scala &
+zipkin-scribe/scripts/collector.sh -f zipkin-scribe/config/collector-dev.scala &
+zipkin-finatra/scripts/finatra.sh -f zipkin-finatra/config/web-localhost.scala &
+
+
+
+