You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@spot.apache.org by ev...@apache.org on 2017/03/14 16:57:06 UTC

incubator-spot git commit: Improves UI Install documentation

Repository: incubator-spot
Updated Branches:
  refs/heads/master be3849dbe -> f05dde6af


Improves UI Install documentation


Project: http://git-wip-us.apache.org/repos/asf/incubator-spot/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-spot/commit/f05dde6a
Tree: http://git-wip-us.apache.org/repos/asf/incubator-spot/tree/f05dde6a
Diff: http://git-wip-us.apache.org/repos/asf/incubator-spot/diff/f05dde6a

Branch: refs/heads/master
Commit: f05dde6aff9b313e0aca9187bc57fe77d018a2d1
Parents: be3849d
Author: Diego Ortiz Huerta <di...@intel.com>
Authored: Wed Mar 8 14:30:49 2017 -0800
Committer: Everardo Lopez Sandoval (Intel) <el...@elopezsa-mac02.local>
Committed: Tue Mar 14 10:56:37 2017 -0600

----------------------------------------------------------------------
 spot-oa/README.md     | 13 ++++++-------
 spot-oa/ui/INSTALL.md | 22 ++++++++++++----------
 2 files changed, 18 insertions(+), 17 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-spot/blob/f05dde6a/spot-oa/README.md
----------------------------------------------------------------------
diff --git a/spot-oa/README.md b/spot-oa/README.md
index 27976e6..ee9b85b 100644
--- a/spot-oa/README.md
+++ b/spot-oa/README.md
@@ -1,5 +1,5 @@
 # **Apache Spot (incubating)**
-Apache Spots (incubating) Operational Analytics (OA) is a collection of modules, which includes both the data processing and transformation as well as the GUI module for data visualization. 
+Apache Spot (incubating) Operational Analytics (OA) is a collection of modules, which includes both the data processing and transformation as well as the GUI module for data visualization.
 
 The visualization repository (UI folder) contains all the front-end code and files related to the Open Network Insight visual elements, such as styles, pages, data files, etc.
 Some of the technologies used are:
@@ -16,7 +16,7 @@ Some of the technologies used are:
 ## **Installation**
 
 1. Install python dependencies `pip install -r requirements.txt`
-2. Install and build NPM requirements with `npm install`
+2. Install UI requirements and build UI following the steps from [here](ui/INSTALL.md)
 
 ## **Folder Structure**
 
@@ -35,19 +35,19 @@ spot-oa is the root folder, below are more details about child folders:
 
 ## **IPython Notebooks**
 * Flow
- * [EdgeNotebook](/spot-oa/oa/flow/ipynb_templates/EdgeNotebook.md) 
+ * [EdgeNotebook](/spot-oa/oa/flow/ipynb_templates/EdgeNotebook.md)
  * [ThreatInvestigation](/spot-oa/oa/flow/ipynb_templates/ThreatInvestigation.md)
 * DNS
- * [EdgeNotebook](/spot-oa/oa/dns/ipynb_templates/EdgeNotebook.md) 
+ * [EdgeNotebook](/spot-oa/oa/dns/ipynb_templates/EdgeNotebook.md)
  * [ThreatInvestigation](/spot-oa/oa/dns/ipynb_templates/ThreatInvestigation.md)
 * PROXY
- * [EdgeNotebook](/spot-oa/oa/proxy/ipynb_templates/EdgeNotebook.md) 
+ * [EdgeNotebook](/spot-oa/oa/proxy/ipynb_templates/EdgeNotebook.md)
  * [ThreatInvestigation](/spot-oa/oa/proxy/ipynb_templates/ThreatInvestigation.md)
 
 ##**Views**
 
 ###Analyst View (suspicious.html)
-The Analyst view provides a dashboard showing the top 250 suspicious connects. 
+The Analyst view provides a dashboard showing the top 250 suspicious connects.
 
 ###**Threat Investigation (threat-investigation.html)**
 HTML page container for the Threat Investigation Notebook
@@ -57,4 +57,3 @@ Executive Briefing dashboard
 
 ###**Ingest Summary (ingest-summary.html)**
 Interactive histogram dashboard that shows the amount of data captured in a certain period of time.
-

http://git-wip-us.apache.org/repos/asf/incubator-spot/blob/f05dde6a/spot-oa/ui/INSTALL.md
----------------------------------------------------------------------
diff --git a/spot-oa/ui/INSTALL.md b/spot-oa/ui/INSTALL.md
index 1d70e2b..8f27a6e 100755
--- a/spot-oa/ui/INSTALL.md
+++ b/spot-oa/ui/INSTALL.md
@@ -13,26 +13,28 @@ Here you will find instructions to get Spot UI up and running. For more informat
 
 ## Install Spot UI
 
-1. Go to Spot UI folder
+1. Install Python dependencies following the steps from [here](../README.md)
 
-	`$ cd PATH_TO_SPOT/ui/`
+2. Go to Spot UI dir
 
-2. With root privileges, install browserify and uglify as global commands on your system.
+    `$ cd PATH_TO_SPOT/spot-oa/ui/`
 
-	`# npm install -g browserify uglifyjs`
+3. With root privileges, install browserify and uglify as global commands on your system.
 
-3. Install dependencies and build Spot UI
+    `# npm install -g browserify uglifyjs`
 
-	`$ npm install`
+4. As a regular user install dependencies and build Spot UI
+
+    `$ npm install`
 
 ## How to run Spot UI
 
-1. Go to Spot UI folder
+1. Go to Spot OA dir
 
-	`$ cd PATH_TO_SPOT/`
+    `$ cd PATH_TO_SPOT/spot-oa/`
 
 2. Start the web server
 
-	`$ ./runIpython.sh`
+    `$ ./runIpython.sh`
 
-3. Verify your installation by going to one of the URLs found [here](https://github.com/Open-Network-Insight/open-network-insight/wiki/Suspicious%20Connects).
+3. Verify your installation, go to http://SPOT_OA_SERVER:8889/files/ui/flow/suspicious.html.