You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@heron.apache.org by jo...@apache.org on 2019/07/31 13:55:45 UTC

[incubator-heron] branch master updated: Updating Heron UI docs (#3320)

This is an automated email from the ASF dual-hosted git repository.

joshfischer pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-heron.git


The following commit(s) were added to refs/heads/master by this push:
     new 07ed678  Updating Heron UI docs (#3320)
07ed678 is described below

commit 07ed678af629dac94a542e1c15328080d648e38e
Author: ChethanU <ch...@outlook.com>
AuthorDate: Wed Jul 31 19:25:40 2019 +0530

    Updating Heron UI docs (#3320)
    
    * Updating Heron UI docs
    
    * Update Heron UI port
    
    * Updating the link
---
 website2/docs/guides-ui-guide.md       | 22 ++++++++++++++++++++++
 website2/docs/user-manuals-heron-ui.md |  2 ++
 2 files changed, 24 insertions(+)

diff --git a/website2/docs/guides-ui-guide.md b/website2/docs/guides-ui-guide.md
index a847226..52ee5fe 100644
--- a/website2/docs/guides-ui-guide.md
+++ b/website2/docs/guides-ui-guide.md
@@ -38,6 +38,18 @@ listed below. A complete set of features can be found in following sections.
 
 #### Topologies Page
 
+Heron UI is a user interface that uses the Heron Tracker to display detailed, colorful visual representations of topologies, including the logical and physical plan for each topology. 
+
+Start the Heron tracker using `heron-tracker &` which uses default heron_tracker.yaml configuration file. It's a centralized gateway for cluster-wide information about topologies, including which topologies are running, being launched, being killed, etc. It exposes Json Restful endpoint and relies on Zookeeper nodes.
+
+Launc the Heron UI by the command:
+
+```bash
+heron-ui &
+```
+
+By default Heron UI will be started at `http://localhost:8889`
+
 Below is the home page of Heron UI.
 
 The following information or actions can be found on this page.
@@ -181,3 +193,13 @@ agaist the PID for the instance. Follow the instructions on the page to download
 the heap dump file. This link does not download the file.
 
 ![Memory Dump](assets/dump.png)
+
+#### Kill Heron UI server
+
+To kill Heron UI server run the following command:
+
+```bash
+kill $(pgrep -f heron-ui)
+```
+
+To stop all the Heron tools, kill the Heron Tracker as well using `kill $(pgrep -f heron-tracker)`.
diff --git a/website2/docs/user-manuals-heron-ui.md b/website2/docs/user-manuals-heron-ui.md
index 021735e..a6cb68d 100644
--- a/website2/docs/user-manuals-heron-ui.md
+++ b/website2/docs/user-manuals-heron-ui.md
@@ -51,6 +51,8 @@ $ ./bazel-bin/heron/tools/ui/src/python/heron-ui
 * `--port` - Port to run the heron-ui on. Default port is `8889`.
 * `--tracker_url` - The base url for tracker. All the information about the
   topologies is fetched from tracker. Default url is `http://localhost:8888`.
+* `--address` - Address to listen; Default address is `0.0.0.0`
+* `--base_url` - The base url path if operating behind proxy; Default is [`None`](https://github.com/apache/incubator-heron/blob/master/heron/tools/ui/src/python/main.py#L145)
 
 ```bash
 $ heron-ui