tree: 9c6c1cfe665a27fc03ae3700e882f21fc884861a [path history] [tgz]
  1. README.md
  2. findbugs-exclude.xml
  3. pom.xml
  4. src/
tez-ui/README.md

Tez-ui

The Tez UI is an ember based web-app that provides visualization of Tez applications running on the Apache Hadoop YARN framework.

For more information on Tez and the Tez UI - Check the Tez homepage.

Configurations

In tez-site.xml

  • tez.runtime.convert.user-payload.to.history-text : Should be enabled to get the configuration options in. If enabled, the config options are set as userpayload per input/output.

In yarn-site.xml

  • yarn.timeline-service.http-cross-origin.enabled : Enable CORS in timeline.
  • yarn.resourcemanager.system-metrics-publisher.enabled : Enable generic history service in timeline server
  • yarn.timeline-service.enabled : Enabled the timeline server for logging details
  • yarn.timeline-service.webapp.address : Value must be the IP:PORT on which timeline server is running

In configs.env

This environment configuration file can be found at ./src/main/webapp/config/configs.env

  • ENV.hosts.timeline : Timeline Server Address. By default TEZ UI looks for timeline server at http://localhost:8188.
  • ENV.hosts.rm : Resource Manager Address. By default RM REST APIs are expected to be at http://localhost:8088.
  • ENV.hosts.rmProxy : This is options. Value configured as RM host will be taken as proxy address by default. Use this configuration when RM web proxy is configured at a different address than RM.
  • ENV.timeZone : Time Zone in which dates are displayed in the UI. If not set, local time zone will be used. Refer http://momentjs.com/timezone/docs/ for valid entries.

Package & deploy

Get war package

  • Tez UI is distributed as a war package.
  • To build & package UI without running test cases, run mvn clean package -DskipTests in this directory.
  • This would give you a war file in ./target.
  • UI build is part of tez build, refer BUILDING.txt for more info.

Using UI war

Remotely:

Use webfront tomcat manager to upload & deploy your war remotely.

Manually:

The war can be added to any tomcat instance.

  1. Remove any old deployments in $TOMCAT_HOME/webapps
  2. Copy the war to $TOMCAT_HOME/webapps
  3. Restart tomcat and the war will get deployed. The content of the war would be available in $TOMCAT_HOME/webapps/tez-ui-[version] directory.

Development

All the following commands must be run inside src/main/webapp.

Prerequisites

You will need the following things properly installed on your computer.

  • Install Node.js (with NPM)
  • Install Bower
  • Install all dependencies by running npm install & bower install

Running UI

Running Tests

  • npm test

Building

  • npm run build (production)
  • Files would be stored in “dist/”

Adding new routes (pages), controllers, components etc.

  • Use ember-cli blueprint generator - Ember CLI