| Brian Freeman | 6d868cc | 2017-09-28 11:14:02 +0000 | [diff] [blame] | 1 | .. This work is licensed under a Creative Commons Attribution 4.0 International License. |
| 2 | |
| Nicolas Hu | 3747944 | 2017-10-03 15:13:46 -0400 | [diff] [blame] | 3 | ccsdk dashboard - Common Controller dashboard |
| Nicolas Hu | 377afe4 | 2017-10-09 11:52:23 -0400 | [diff] [blame] | 4 | ============================================= |
| 5 | This is the web UI for the Common Controller, also known as the CCSDK Dashboard. |
| 6 | |
| Brian Freeman | 6d868cc | 2017-09-28 11:14:02 +0000 | [diff] [blame] | 7 | .. toctree:: |
| 8 | :maxdepth: 1 |
| 9 | |
| Nicolas Hu | 377afe4 | 2017-10-09 11:52:23 -0400 | [diff] [blame] | 10 | Architecture |
| 11 | ------------ |
| 12 | Dashboard Project consists of the following Maven projects: |
| Brian Freeman | 6d868cc | 2017-09-28 11:14:02 +0000 | [diff] [blame] | 13 | |
| Nicolas Hu | f73ff22 | 2017-10-09 13:24:29 -0400 | [diff] [blame] | 14 | - oom-app-common: Java classes that run in a web container like Tomcat |
| 15 | - oom-app-overlay: CSS, HTML and Javascript resources for the web application |
| 16 | - oom-app-os: Web application project with features for ONAP use |
| Nicolas Hu | 377afe4 | 2017-10-09 11:52:23 -0400 | [diff] [blame] | 17 | |
| 18 | Prerequites |
| 19 | ----------- |
| 20 | The web application requires these resources: |
| Nicolas Hu | 0d7b5be | 2017-10-09 16:18:06 -0400 | [diff] [blame] | 21 | |
| Nicolas Hu | f73ff22 | 2017-10-09 13:24:29 -0400 | [diff] [blame] | 22 | - Java version 8 |
| 23 | - Apache Tomcat version 8.0 or 8.5 |
| 24 | - A Postgresql database, version 9.2 or later |
| Nicolas Hu | 377afe4 | 2017-10-09 11:52:23 -0400 | [diff] [blame] | 25 | |
| 26 | Build |
| 27 | ----- |
| 28 | Build all artifacts by invoking maven in this directory:: |
| 29 | |
| Nicolas Hu | 0d7b5be | 2017-10-09 16:18:06 -0400 | [diff] [blame] | 30 | mvn package |
| Nicolas Hu | 377afe4 | 2017-10-09 11:52:23 -0400 | [diff] [blame] | 31 | |
| 32 | Deployment steps |
| 33 | ---------------- |
| Nicolas Hu | f73ff22 | 2017-10-09 13:24:29 -0400 | [diff] [blame] | 34 | 1. Create a Postgre schema within a Postgres database. |
| 35 | 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. |
| 36 | 3. Configure the application by editing the files portal.properties, system.properties and dashboard.properties. |
| 37 | 4. Build a war file within the appropriate web application project ('mvn package'). |
| 38 | 5. Deploy the war file to Tomcat. |
| 39 | 6. Login the first time using credentials stored in the fn_user table at the "login_external.htm" page. |