X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Findex.rst;h=424b3d23c082585fb6667ae7eccbd21de8395421;hb=2206cf470405b527b5d666cf657f011eac6e0b80;hp=dfb19eb45af86c5c51fc00e5569da7653415be80;hpb=c3472b1ec153c564fb99b37eb17c764db0d530fc;p=clamp.git diff --git a/docs/index.rst b/docs/index.rst index dfb19eb4..424b3d23 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -11,21 +11,23 @@ CLAMP - Closed Loop Automation Management Platform Offered APIs ------------ -CLAMP offers the following API: -* HealthCheck +The list of APIs that CLAMP has offered could be find in the following table: -.. line-block:: +.. |pdf-icon| image:: images/pdf.png + :width: 40px - URL: http://:8080/restservices/clds/v1/clds/healthcheck - Result: if in good health it will return OK: "HTTP/1.1 200", and the following json string content: +.. |swagger-icon| image:: images/swagger.png + :width: 40px -.. code-block:: json +.. |html-icon| image:: images/html.png + :width: 40px - { - "healthCheckComponent": "CLDS-APP", - "healthCheckStatus": "UP", - "description": "OK" - } +.. csv-table:: + :header: "|Swagger-icon|", "|html-icon|", "|pdf-icon|" + :widths: 60,60,60 + + "swagger json file", "html doc", "pdf doc" + ":download:`link `", ":download:`link `", ":download:`link `" Consumed APIs @@ -110,39 +112,66 @@ There are two needed datasource for Clamp. By default, both will try to connect .. code-block:: json { - "spring.datasource.camunda.url": "jdbc:mariadb://anotherDB.onap.org:3306/camundabpm?verifyServerCertificate=false&useSSL=false&requireSSL=false&autoReconnect=true", - "spring.datasource.camunda.username": "admin", - "spring.datasource.camunda.password": "password", "spring.datasource.cldsdb.url": "jdbc:mariadb://anotherDB.onap.org:3306/cldsdb4?verifyServerCertificate=false&useSSL=false&requireSSL=false&autoReconnect=true", "spring.datasource.cldsdb.username": "admin", - "spring.datasource.cldsdb.password": "password" + "spring.datasource.cldsdb.password": "password", + + "clamp.config.sdc.catalog.url": "https://sdchost:8443/sdc/v1/catalog/", + "clamp.config.sdc.hostUrl": "https://sdchost:8443/", + "clamp.config.sdc.serviceUrl": "https://sdchost:8443/sdc/v1/catalog/services", + "clamp.config.sdc.serviceUsername": "clamp", + "clamp.config.sdc.servicePassword": "b7acccda32b98c5bb7acccda32b98c5b05D511BD6D93626E90D18E9D24D9B78CD34C7EE8012F0A189A28763E82271E50A5D4EC10C7D93E06E0A2D27CAE66B981", + "clamp.config.dcae.inventory.url": "http://dcaegen2.host:8080", + "clamp.config.dcae.dispatcher.url": "http://dcaegen2.host:8080", + "clamp.config.policy.pdpUrl1": "https://policy-pdp.host:9091/pdp/ , testpdp, alpha123", + "clamp.config.policy.pdpUrl2": "https://policy-pdp.host:9091/pdp/ , testpdp, alpha123", + "clamp.config.policy.papUrl": "https://policy-pap.host:8443/pap/ , testpap, alpha123", + "clamp.config.policy.clientKey": "5CE79532B3A2CB4D132FC0C04BF916A7" + "clamp.config.files.sdcController":"file:/opt/clamp/config/sdc-controllers-config.json" } -OR +SDC-Controllers config +---------------------- +This file is a JSON that must be specified to Spring config, here is an example: .. code-block:: json - - { - "spring": - { - "datasource": - { - "camunda": - { - "url": "jdbc:mariadb://anotherDB.onap.org:3306/camundabpm?verifyServerCertificate=false&useSSL=false&requireSSL=false&autoReconnect=true", - "username": "admin", - "password": "password" - }, - - "cldsdb": - { - "url": "jdbc:mariadb://anotherDB.onap.org:3306/cldsdb4?verifyServerCertificate=false&useSSL=false&requireSSL=false&autoReconnect=true", - "username": "admin", - "password": "password" - } - } - } + { + "sdc-connections":{ + "sdc-controller1":{ + "user": "clamp", + "consumerGroup": "consumerGroup1", + "consumerId": "consumerId1", + "environmentName": "AUTO", + "sdcAddress": "localhost:8443", + "password": "b7acccda32b98c5bb7acccda32b98c5b05D511BD6D93626E90D18E9D24D9B78CD34C7EE8012F0A189A28763E82271E50A5D4EC10C7D93E06E0A2D27CAE66B981", + "pollingInterval":30, + "pollingTimeout":30, + "activateServerTLSAuth":"false", + "keyStorePassword":"", + "keyStorePath":"", + "messageBusAddresses":["dmaaphost.com"] + }, + "sdc-controller2":{ + "user": "clamp", + "consumerGroup": "consumerGroup1", + "consumerId": "consumerId1", + "environmentName": "AUTO", + "sdcAddress": "localhost:8443", + "password": "b7acccda32b98c5bb7acccda32b98c5b05D511BD6D93626E90D18E9D24D9B78CD34C7EE8012F0A189A28763E82271E50A5D4EC10C7D93E06E0A2D27CAE66B981", + "pollingInterval":30, + "pollingTimeout":30, + "activateServerTLSAuth":"false", + "keyStorePassword":"", + "keyStorePath":"", + "messageBusAddresses":["dmaaphost.com"] } + } + } + +Multiple controllers can be configured so that Clamp is able to receive the notifications from different SDC servers. +Each Clamp existing in a cluster should have different consumerGroup and consumerId so that they can each consume the SDC notification. +The environmentName is normally the Dmaap Topic used by SDC. +If the sdcAddress is not specified or not available (connection failure) the messageBusAddresses will be used (Dmaap servers) Administration --------------