Jaeger Recipe

Building Jaeger

The instructions provided below specify the steps to build Jaeger version 1.6.0 on Linux on IBM Z for the following distributions:

• RHEL (7.3, 7.4, 7.5)
• SLES (12 SP3)
• Ubuntu (16.04, 18.04)

General Notes:

• When following the steps below please use a standard permission user unless otherwise specified.

• A directory /<source_root>/ will be referred to in these instructions, this is a temporary writeable directory anywhere you'd like to place it.

Step 1: Install dependencies

1.1) Install dependencies

• RHEL (7.3, 7.4, 7.5)

   sudo yum install -y git make wget

• SLES (12 SP3)

   sudo zypper install -y git make wget

• Ubuntu (16.04)

   sudo apt-get update 
   sudo apt-get install -y git make  wget

• Ubuntu (18.04)

   sudo apt-get update 
   sudo apt-get install -y git make wget golang-1.10

• Install Go (RHEL, SLES, Ubuntu 16.04 Only)

  Follow the Go build instructions to install Golang.

• Install nodejs

   cd /<source_root>/
   wget https://nodejs.org/dist/v8.11.3/node-v8.11.3-linux-s390x.tar.gz
   tar -xvf node-v8.11.3-linux-s390x.tar.gz
   export PATH=/home/test/node-v8.11.3-linux-s390x/bin:$PATH

• Install yarn

    npm install -g yarn

1.2) Set Environment variables

    cd /<source_root>/
    export GOPATH=/<source_root>/
    export PATH=$GOPATH/bin:$PATH                     
    export PATH=/usr/lib/go-1.10/bin:$PATH:  ### for Ubuntu 18.04 only

Step 2: Download, build and configure

2.1) Clone the latest stable Jaeger 1.6.0 source:

      cd /<source_root>/
      mkdir -p $GOPATH/src/github.com/jaegertracing
      cd $GOPATH/src/github.com/jaegertracing
      git clone https://github.com/jaegertracing/jaeger.git
      cd jaeger/
      git checkout v1.6.0

2.2) Install glide and get Jaeger modules:

      make install-glide
      git submodule update --init --recursive

2.3) Build and Install Jaeger

      glide install

2.4) Build Jaeger UI

      make build_ui

Step 3: Testing (Optional)

3.1) Make changes to the Makefile

@@ -29,7 +29,7 @@ ALL_SRC := $(shell find . -name "*.go" | \
# ALL_PKGS is used with 'go cover'
ALL_PKGS := $(shell go list $(sort $(dir $(ALL_SRC))))

-RACE=-race
+RACE=
GOTEST=go test -v $(RACE)
GOLINT=golint
GOVET=go vet

3.2) Run Tests

      make tests 

Step 4: Verification

4.1) Run Jaeger

      cd $GOPATH/src/github.com/jaegertracing/jaeger             
      go run -tags ui ./cmd/standalone/main.go &

4.2) Run HotR.O.D. Sample application

     cd examples/hotrod
     go run ./main.go all &

4.3) Access Jaeger UI on browser

• Open http://<ip_address>:16686 in your browser to access Jaeger UI.
• Open http://<ip_address>:8080 in your browser to access HotR.O.D. application UI.

References

https://github.com/jaegertracing/jaeger/blob/master/CONTRIBUTING.md

https://www.jaegertracing.io/docs/getting-started/