From: Nicolas Hu Date: Mon, 9 Oct 2017 15:52:23 +0000 (-0400) Subject: Update documentation for ccsdk/dashboard X-Git-Tag: 1.1.0~20 X-Git-Url: https://gerrit.onap.org/r/gitweb?a=commitdiff_plain;h=refs%2Fchanges%2F89%2F17689%2F1;p=ccsdk%2Fdashboard.git Update documentation for ccsdk/dashboard Change-Id: I2ccf21e56fa3163cb98e3b5d82f6915e50ae00f5 Issues-Id: CCSDK-109 Signed-off-by: Nicolas Hu --- diff --git a/docs/index.rst b/docs/index.rst index 9e54192..79bfd40 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,8 +1,38 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. ccsdk dashboard - Common Controller dashboard ---------------------------------------------- +============================================= +This is the web UI for the Common Controller, also known as the CCSDK Dashboard. + .. toctree:: :maxdepth: 1 +Architecture +------------ +Dashboard Project consists of the following Maven projects: + +*oom-app-common: Java classes that run in a web container like Tomcat +*oom-app-overlay: CSS, HTML and Javascript resources for the web application +*oom-app-os: Web application project with features for ONAP use + +Prerequites +----------- +The web application requires these resources: +*Java version 8 +*Apache Tomcat version 8.0 or 8.5 +*A Postgresql database, version 9.2 or later + +Build +----- +Build all artifacts by invoking maven in this directory:: + +mvn package +Deployment steps +---------------- +1.Create a Postgre schema within a Postgres database. +2.Populate the schema using the DDL and DML scripts in the appropriate db-scripts areas; see the README.md there for instructions to set the user's default schema. +3.Configure the application by editing the files portal.properties, system.properties and dashboard.properties. +4.Build a war file within the appropriate web application project ('mvn package'). +5.Deploy the war file to Tomcat. +6.Login the first time using credentials stored in the fn_user table at the "login_external.htm" page.