1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
# 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 <environment name> -r <release> -p <docker-hub-port>
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
| Name | Tag | Description |
|---------|-----------|-------------------------------------------------------------------------------------------------------------------------------|
| sdc-FE | 1610.2.16 | Contains Jetty + OpenJDK + SDC frontend code + **3rd party jars** |
| sdc-BE | 1610.2.16 | Contains Jetty + OpenJDK + SDC backend code + **3rd party jars** |
| sdc-kbn | 1610.2.16 | Contains nodeJs + Kibana application |
| sdc-cs | 1610.2.16 | OpenJDK + Contains cassandra application |
| sdc-es | 1610.2.16 | Elastic 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:
<ip address of SDC application> sdc.api.simpledemo.openecomp.org
<ip address of Ecomp portal URL> 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://<ip address>: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 <machine ip address>:catalog-be/import/tosca
src\main\resources\scripts\import\tosca ->to <machine ip address>: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://<host>:<port>
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 ***
|
