X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=openecomp-ui%2FREADME.md;h=a41aa27e37328ab3c35b9a413279d36506aa3035;hb=1a7328539ebfae1be8ed525fd7fead7af88a95d2;hp=883aeb41e3125511056e3cc10f1acddf970231f8;hpb=f070300ac0e134badd57a2ce276b25d84c7d53c0;p=sdc.git diff --git a/openecomp-ui/README.md b/openecomp-ui/README.md index 883aeb41e3..a41aa27e37 100644 --- a/openecomp-ui/README.md +++ b/openecomp-ui/README.md @@ -2,33 +2,41 @@ ## Setup -##### Install `nodejs`: +###Install `npm` -download nodejs from here: https://nodejs.org/en/ (take the "current" version with latest features) & install it. -##### Install `gulp` +Install npm v6. + +###Install `Node.js` + +Install node v10.17.0 (as in the pom.xml v10.17.0). + +* To manage different versions of node, is recommended to install "n" (https://github.com/tj/n). + +### Install `gulp` install gulp by running the following command `npm install --global gulp-cli` -##### Install DOX-UI +## Build + +### Install DOX-UI * pull for latest changes -* go to folder `dox-sequence-diagram-ui` -* run `npm install` -* wait for it... -* go to folder `openecomp-ui` -* run `npm install` -* 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) -in that file. +* go to folder `../dox-sequence-diagram-ui` +* run `npm install && npm run build` - set "proxyCatalogTarget" to the URL of the sdc-frontend; set "proxyTarget" to the URL of the sdc-onboard-backend (**pay attention, it is a JSON file**): +#### Install onboarding-fe +* go to the current project folder `openecomp-ui` +* run `npm install` +* create a copy of `devConfig.defaults.json` file and name it `devConfig.json` (it is already configured to gitignore, so it will not be pushed) +* in `devConfig.json`: + * set "proxyCatalogTarget" to the URL of the sdc-frontend; set "proxyTarget" to the URL of the sdc-onboard-backend (**pay attention, it is a JSON file**): - For example *http://\:\* + For example *http://\:\* * run `npm start` * your favorite UI will wait for you at: `http://localhost:9000/sdc1/#!/onboardVendor` - - -#### Troubleshooting -Problem | Why is this happening | Solution -------- | --------------------- | -------- -npm cannot reach destination | proxy | When within managed network, you should set your proxy to NPM as the following:
`npm config set proxy http://:`
`npm config set https-proxy http://:` -git protocol is blocked and cannot connect | managed network rules for protocols | When within managed network, you should set globally that when git protocol is used, then it will be replaced with "https"
`git config --global url."https://".insteadOf git://` +## Troubleshooting +| Problem | Why is this happening | Solution | +|--------------------------------------------|--------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Build (npm install) error | npm/node_modules cache | If having problems with the compilation of dox-sequence-diagram-ui and openecomp-ui, delete the node_modules and package-lock.json in each respective projects folder. | +| npm cannot reach destination | proxy | When within managed network, you should set your proxy to NPM as the following:
`npm config set proxy http://:`
`npm config set https-proxy http://:` | +| git protocol is blocked and cannot connect | managed network rules for protocols | When within managed network, you should set globally that when git protocol is used, then it will be replaced with "https"
`git config --global url."https://".insteadOf git://` |