Gitiles
Code Review Sign In
gerrit.nordix.org / onap / sdc / 2a1481fcd1553c261f6e54610f1ef601dc7a9c51
commit2a1481fcd1553c261f6e54610f1ef601dc7a9c51[log] [tgz]
authorAlexis de Talhouët <adetalhouet89@gmail.com>Wed Mar 08 13:48:07 2017 -0500
committerAlexis de Talhouët <adetalhouet89@gmail.com>Wed Mar 08 13:48:07 2017 -0500
tree16208a757a71f75c1d855e9c7260d8c860bc49f9
parent55faed7c9dc608f9428cc96ae7cdff3dfd5ad9dd [diff]
Do not load kibana_dashboard_virtualization.json

    The recipe is loading kibana_dashboard_virtualization.json although this
    file doesn't exist.
    I see three possible reasons:
    i. the file is mising in the repo
    ii. the file could be created by the user, and loaded only if exist
    iii. this is a remaining config that shouldn't apply in ONAP

Change-Id: I821eb506d3dab28dad14e72458b313ee45482fa6
Signed-off-by: Alexis de Talhouët <adetalhouet89@gmail.com>
1 file changed
tree: 16208a757a71f75c1d855e9c7260d8c860bc49f9
  1. asdc-tests/
  2. asdctool/
  3. catalog-be/
  4. catalog-dao/
  5. catalog-fe/
  6. catalog-model/
  7. catalog-ui/
  8. common-app-api/
  9. common-be/
  10. distribution-ci/
  11. dox-sequence-diagram-ui/
  12. openecomp-be/
  13. openecomp-ui/
  14. sdc-os-chef/
  15. security-utils/
  16. ui-ci/
  17. ui-ci-dev/
  18. webseal-simulator/
  19. .gitignore
  20. .gitreview
  21. .pydevproject
  22. LICENSE.TXT
  23. pom.xml
  24. README.md
  25. version.properties
README.md

OpenECOMP SDC

Introduction

OpenECOMP SDC is delivered with 5 Docker containers:

  1. sdc-FE - frontend SDC application running on jetty server
  2. sdc-BE - backend SDC application running on jetty server
  3. sdc-kbn - hosting kibana application
  4. sdc-cs - hosting cassandra
  5. sdc-es - hosting elastic search

All containers runs on the same machine and can be started by runnin the command: /data/scripts/docker_run.sh -e -r -p Example: /data/scripts/docker_run.sh -e OS-ETE-DFW -p 51220

Compiling SDC

SDC is built from several projects, while "sdc-main" contains the main pom.xml for all project:

  • catalog-be - backend code
  • catalog-fe - frontend java code (servlet, proxy)
  • catalog-dao - database layer
  • catalog-model - data model of the application
  • catalog-ui - front end code (javascript, html, css)
  • common-app-api - common code for frontend and backend
  • common-be - utilities, datatypes and enums
  • security-utils - handle encryption/decryption of passwords

SDC projects can be compiled easily using maven command: mvn clean install. In order to build all projects, enter to sdc-main project and run the command: mvn clean install. By default unit test will run when compiling

** igor ** Docker containers are build with the following profile -P docker -Ddocker.buildArg.chef_repo_branch_name=bugfix/external_adress -Ddocker.buildArg.chef_repo_git_username=git -Ddocker.buildArg.chef_repo_address=23.253.149.175/SDC -Ddocker.buildArg.chef_repo_git_name=chef-repo

Getting the containers

to be changed for rrelease OpenECOMP SDC containers are stored on the Rackspace Nexus Docker Registry

The following Docker images are the actual deployment images used for running SDC

NameTagDescription
sdc-FE1610.2.16Contains Jetty + OpenJDK + SDC frontend code + 3rd party jars
sdc-BE1610.2.16Contains Jetty + OpenJDK + SDC backend code + 3rd party jars
sdc-kbn1610.2.16Contains nodeJs + Kibana application
sdc-cs1610.2.16OpenJDK + Contains cassandra application
sdc-es1610.2.16Elastic search application

*********************** Israel ************************

Starting SDC

There are several ways to start OpenECOMP SDC: TBD - Israel

Accessing SDC

SDC UI can be accessed from:

Ecomp portal

Login to ecomp portal URL with user that has permission for SDC application. Define in your hosts file the following: sdc.api.simpledemo.openecomp.org portal.api.simpledemo.openecomp.org Open browser and navigate to: http://portal.api.simpledemo.openecomp.org:8989/ECOMPPORTAL/login.htm

Webseal simulator

This options is for developers to run locally SDC

  1. Build web simulator WAR file: run mvn clean install on project "webseal simulator". This will generate war file (WSSimulator.war) in the target folder.
  2. Copy the war to: /home/vagrant/webseal-simulator/webapps
  3. Add users to simulator: open configuration file - /home/vagrant/webseal-simulator/config/webseal.conf and add new user to the user list. Note: You need to define the user in the SDC as well.
  4. Restart the simulator: Stop the simulator: stopWebsealSimulator.sh Start the simulator: startWebsealSimulator.sh
  5. Enter to UI: http://:8285/sdc1/login

SDC import normatives from CLI

SDC needs to work with predefined basic normatives, in order to update the database with the normatives need to:

  1. From catalog-be project copy: src\main\resources\import\tosca -> to :catalog-be/import/tosca src\main\resources\scripts\import\tosca ->to :catalog-be/scripts/import/tosca
  2. cd catalog-be/scripts/import/tosca
  3. Run: python importNormativeAll.py
  4. Wait until all normatives are loaded to the database

SDC APIs

TBD

Main API endpoints in the first open source release
  • to be completed APIHandler health checks TBD

Configuration of SDC

TBD

Here are the main parameters you could change: TBD

The credentials are defined in 2 places: TBD

Logging

TBD

Jetty

TBD

Debuging

TBD

Testing SDC Functionalities

TBD

Frontend Local Env - onboarding

Steps:

Install nodejs & gulp

  1. download nodejs from here: https://nodejs.org/en/ (take the "current" version with latest features) & install it.
  2. install gulp by running the following command: npm install --global gulp-cli

Install DOX-UI a:

  1. pull for latest changes
  2. go to folder dox-sequence-diagram-ui
  3. run npm install
  4. wait for it...
  5. go to folder dox-ui
  6. run npm install
  7. create a copy of devConfig.defaults.json file and name it devConfig.json (we already configured git to ignore it so it will not be pushed)
  8. in that file, populate the fields of the IP addresses of your BE machine you'd like to connect (pay attention, it is a JSON file): For example http://:
  9. after everything was successful, run gulp
  10. after server was up, your favorite UI will wait for you at: http://localhost:9000/sdc1/proxy-designer1#/onboardVendor

Troubleshooting:

| Problem | Why is this happening | Solution |

| npm cannot reach destination | onboarding proxy | When within onboarding network, you should set onboarding proxy to NPM as the following: | | | | npm config set proxy http://genproxy:8080 | | | | npm config set https-proxy http://genproxy:8080 | | | | | | git protocol is blocked | onboarding network | When within onboarding network, you should set globally that when git | | and cannot connect | rules for protocols | protocol is used, then it will be replaced with "https" | | | | git config --global url."https://".insteadOf git:// |

Getting Help

*** to be completed on rrelease ***

SDC@lists.openecomp.org

SDC Javadoc and Maven site

*** to be completed on rrelease ***