summaryrefslogtreecommitdiffstats
path: root/dcaedftool/README.md
diff options
context:
space:
mode:
authorMichael Hwang <mhwang@research.att.com>2018-07-12 17:17:34 -0400
committerMichael Hwang <mhwang@research.att.com>2018-07-26 15:47:57 -0400
commitd2a9bf7db4e21e5e87ea98efd2d63ef225830d75 (patch)
tree14668f20da133cbb4f4666e08c45030af292313d /dcaedftool/README.md
parent1d40112c568c989e8947b2ac6c89b2cef7b6dd5c (diff)
Add code for data format webtool
Commit is on behalf of Ralph Knag Change-Id: I9bd4cc3c6949ec8b44fe081bb98c0027d90e24c5 Issue-ID: DCAEGEN2-615 Signed-off-by: Michael Hwang <mhwang@research.att.com>
Diffstat (limited to 'dcaedftool/README.md')
-rw-r--r--dcaedftool/README.md41
1 files changed, 41 insertions, 0 deletions
diff --git a/dcaedftool/README.md b/dcaedftool/README.md
new file mode 100644
index 0000000..797c46f
--- /dev/null
+++ b/dcaedftool/README.md
@@ -0,0 +1,41 @@
+# DCAE Data Format Validator
+
+# Purpose & Responsibilities
+The purposes of this repo is provide tools for creating and checking DCAE Data Format Schema used by the DCAP CDAP Broker to define user data formats
+The build is currently done on Windows but since node.js and docker are widely supported a similar process should allow builds in other environments
+
+# DCAE Data Format Schema Tool
+The DCAE Data Format Schema Tool is a web application that checks the validity of a user created Data Format Schema. Schemas can define JSON, delimited, XML, and unstructured data.
+DCAE Data Format Schemas that define JSON schema can be checked against JSON input
+
+## Installation and build on Windows
+It is assumed that node.js and docker Toolkit are installed
+After the git repo is cloned, cd to the dcaedftool directory and issue:
+```
+ npm install
+```
+to load the necessary libraries. Note that the latest libraries will be loaded. If there is a problem the libraries used for testing can be loaded. They are recorded in package-lock.json. There was a problem once when a Material 2 library was upgraded.
+## Regression testing on Windows
+To test use the following command to run the Jasmine/karma regression suite. This currently tests the program logic. Protractor tests may follow...
+```
+ ng test
+```
+## GUI testing using node.js
+To test under node.js using localhost:4200, issue:
+```
+ ng serve
+```
+## Docker build - remember to update the image version
+To build a Docker image using nginx as a static page server issue:
+```
+ . ./dockerbuild.sh
+```
+## Docker windows testing - remember to update the image version
+```
+ sh dockerrun.sh
+```
+## To get the local IP address for testing - use 8080 for the port
+```
+ docker-machine ip box
+```
+## Use docker push to export to production