mirror of
https://github.com/datahub-project/datahub.git
synced 2025-07-19 07:30:54 +00:00
104 lines
3.1 KiB
Markdown
104 lines
3.1 KiB
Markdown
# WhereHows Frontend UI
|
|
The Web UI provides navigation between the bits of information and the ability to annotate the collected data with comments, ownership and more. The example below is for collecting Hive metadata collected from the Cloudera Hadoop VM
|
|
|
|
Wherehows comes in three operational components:
|
|
- [Backend service](../wherehows-backend/README.md)
|
|
- **A web-ui service**
|
|
- Database schema for MySQL
|
|
|
|
## Key notes
|
|
Please become familiar with these pages:
|
|
- https://github.com/linkedin/WhereHows/wiki/Architecture (Nice tech overview)
|
|
- https://github.com/linkedin/WhereHows
|
|
- https://github.com/linkedin/WhereHows/blob/master/wherehows-docs/getting-started.md
|
|
|
|
|
|
## Build
|
|
```
|
|
$ ../gradlew build dist
|
|
|
|
Starting a Gradle Daemon (subsequent builds will be faster)
|
|
|
|
> Task :wherehows-web:bowerInstall
|
|
bower ember-cli-shims extra-resolution Unnecessary resolution: ember-cli-shims#0.1.3
|
|
bower bootstrap extra-resolution Unnecessary resolution: bootstrap#3.3.7
|
|
|
|
> Task :wherehows-web:emberBuild
|
|
...
|
|
- dist/legacy-app/vendors/toastr/toastr.min-c4d50504a82305d607ae5ff7b33e0c39.css: 5.85 KB (2.68 KB gzipped)
|
|
- dist/legacy-app/vendors/toastr/toastr.min-d59436971aa13b0e0c24d4332543fbef.js: 4.87 KB (1.91 KB gzipped)
|
|
|
|
|
|
BUILD SUCCESSFUL in 56s
|
|
21 actionable tasks: 9 executed, 12 up-to-date
|
|
```
|
|
|
|
## Install (In Production)
|
|
Download/upload the distribution binaries, unzip to
|
|
**/opt/wherehows/wherehows-frontend**
|
|
|
|
|
|
Create temp space for wherehows
|
|
```
|
|
$ sudo mkdir /var/tmp/wherehows
|
|
$ sudo chmod a+rw /var/tmp/wherehows
|
|
$ sudo mkdir /var/tmp/wherehows/resource
|
|
```
|
|
|
|
```
|
|
$ cd /opt/wherehows/wherehows-frontend
|
|
```
|
|
|
|
## Configuration
|
|
Forntend has a seperate configuration file in **wherehows-frontend/application.env**
|
|
```
|
|
# Secret Key
|
|
WHZ_SECRET="change_me"
|
|
|
|
# Database Connection
|
|
WHZ_DB_NAME="wherehows"
|
|
WHZ_DB_USERNAME="wherehows"
|
|
WHZ_DB_PASSWORD="wherehows"
|
|
|
|
# Fully qualified jdbc url
|
|
WHZ_DB_URL="jdbc:mysql://localhost/wherehows"
|
|
|
|
# Serach Engine
|
|
WHZ_SEARCH_ENGINE=elasticsearch
|
|
|
|
# Elasticsearch (Change "localhost" to your Es host )
|
|
WHZ_ES_DATASET_URL="http://localhost:9200/wherehows/dataset/_search"
|
|
WHZ_ES_METRIC_URL="http://localhost:9200/wherehows/metric/_search"
|
|
WHZ_ES_FLOW_URL="http://localhost:9200/wherehows/flow_jobs/_search"
|
|
|
|
# LDAP
|
|
WHZ_LDAP_URL=your_ldap_url
|
|
WHZ_LDAP_PRINCIPAL_DOMAIN=your_ldap_principal_domain
|
|
WHZ_LDAP_SEARCH_BASE=your_ldap_search_base
|
|
|
|
# Piwik tracking configuration
|
|
PIWIK_SITE_ID="0000" # change_to_your_piwik_id
|
|
PIWIK_URL="change_to_your_piwik_url"
|
|
|
|
```
|
|
|
|
|
|
## Run
|
|
To run frontend app, go to **wherehows-frontend**
|
|
```
|
|
$ ./runFrontend
|
|
|
|
NettyServer.main is deprecated. Please start your Play server with the
|
|
2017-08-02 14:19:58 INFO p.a.Play:97 - Application started (Prod)
|
|
2017-08-02 14:19:58 INFO p.c.s.NettyServer:165 - Listening for HTTP on /0:0:0:0:0:0:0:0:9001
|
|
|
|
```
|
|
|
|
Open browser to ```http://<edge node>:9001/```
|
|
This will show WhereHows login page.
|
|
|
|
## Troubleshooting
|
|
- To log in the first time to the web UI:
|
|
You have to create an account. In the upper right corner there is a "Not a member yet? Join Now" link. Click on that and get a form to fill out.
|
|
|