Repository: incubator-htrace Updated Branches: refs/heads/master 81cfc473b -> dedbd5205
HTRACE-167. Update go build instructions in BUILDING.txt (iwasakims) Project: http://git-wip-us.apache.org/repos/asf/incubator-htrace/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-htrace/commit/dedbd520 Tree: http://git-wip-us.apache.org/repos/asf/incubator-htrace/tree/dedbd520 Diff: http://git-wip-us.apache.org/repos/asf/incubator-htrace/diff/dedbd520 Branch: refs/heads/master Commit: dedbd52056add7eb979a9c048f1c0ef010087224 Parents: 81cfc47 Author: Masatake Iwasaki <[email protected]> Authored: Thu May 14 15:28:42 2015 -0700 Committer: Masatake Iwasaki <[email protected]> Committed: Thu May 14 15:28:42 2015 -0700 ---------------------------------------------------------------------- BUILDING.txt | 22 +++++++++++++--------- htrace-htraced/BUILDING.txt | 30 ++++++++++++++++++++++++++++++ htrace-htraced/src/go/BUILDING.txt | 30 ------------------------------ 3 files changed, 43 insertions(+), 39 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-htrace/blob/dedbd520/BUILDING.txt ---------------------------------------------------------------------- diff --git a/BUILDING.txt b/BUILDING.txt index d8314b0..e1bf0e9 100644 --- a/BUILDING.txt +++ b/BUILDING.txt @@ -1,21 +1,25 @@ -On Building HTrace +Building HTrace +=============== -Requires the go programming language, version 1.3 or higher. See -htrace-core/src/go/BUILDING.txt for more information. +Building HTrace requires -Requires Java 1.6 at least. +* Java 1.7 at least. +* Apache Maven 3.x. +* Go programming language, version 1.3 or higher (for htrace-htraced) +* The development package for leveldb (for htrace-htraced) -Requires maven 3.x. +After installing dependencies, to build, run: -After installing go, to build, run: - - $ mvn install + $ mvn install To build a tarball, do: - $ mvn clean install -DskipTests assembly:single -Pdist + $ mvn clean install -DskipTests assembly:single -Pdist This will build a tarball into ./target. To skip the rat-check -- it can take a while -- pass a -Drat.skip on the mvn command-line. + + +See htrace-htraced/BUILDING.txt for more information to build htrace-htraced. http://git-wip-us.apache.org/repos/asf/incubator-htrace/blob/dedbd520/htrace-htraced/BUILDING.txt ---------------------------------------------------------------------- diff --git a/htrace-htraced/BUILDING.txt b/htrace-htraced/BUILDING.txt new file mode 100644 index 0000000..d54d410 --- /dev/null +++ b/htrace-htraced/BUILDING.txt @@ -0,0 +1,30 @@ +Building the HTrace Go code +=========================== +The htrace go code consists of 4 main parts: +* The "htraced" standalone server + This is a server which accepts trace spans, and services REST queries. + +* The "htrace" command-line program which can query the server + This is a simple command-line program which can query the htrace server. + +* The htraced Javascript Web UI (not yet implemented) + +* The htrace go client library (not yet implemented) + This is the equivalent of the Java HTrace client library, but written in Go. + +You can build all these parts simply by running "gobuild.sh". +The binaries will be created in bin/. + +Dependencies +============ +You will need to install: +* The Go programming language +* The development package for leveldb (some Linux distros call this "leveldb-devel") containing libleveldb.so + +htraced requires libleveldb.so to be in your shared library path in order to run. +You can set LD_LIBRARY_PATH to the path for this library, or simply install +libleveldb.so to your system library path. + +Testing +======= +You can run the unit tests by running "./gobuild.sh test" http://git-wip-us.apache.org/repos/asf/incubator-htrace/blob/dedbd520/htrace-htraced/src/go/BUILDING.txt ---------------------------------------------------------------------- diff --git a/htrace-htraced/src/go/BUILDING.txt b/htrace-htraced/src/go/BUILDING.txt deleted file mode 100644 index d54d410..0000000 --- a/htrace-htraced/src/go/BUILDING.txt +++ /dev/null @@ -1,30 +0,0 @@ -Building the HTrace Go code -=========================== -The htrace go code consists of 4 main parts: -* The "htraced" standalone server - This is a server which accepts trace spans, and services REST queries. - -* The "htrace" command-line program which can query the server - This is a simple command-line program which can query the htrace server. - -* The htraced Javascript Web UI (not yet implemented) - -* The htrace go client library (not yet implemented) - This is the equivalent of the Java HTrace client library, but written in Go. - -You can build all these parts simply by running "gobuild.sh". -The binaries will be created in bin/. - -Dependencies -============ -You will need to install: -* The Go programming language -* The development package for leveldb (some Linux distros call this "leveldb-devel") containing libleveldb.so - -htraced requires libleveldb.so to be in your shared library path in order to run. -You can set LD_LIBRARY_PATH to the path for this library, or simply install -libleveldb.so to your system library path. - -Testing -======= -You can run the unit tests by running "./gobuild.sh test"
