14 files changed, 300 insertions, 0 deletions
diff --git a/docs/CBA/CDS_Architecture_Design.pptx b/docs/CBA/CDS_Architecture_Design.pptx
new file mode 100644
index 000000000..a6c158d8d
--- /dev/null
+++ b/docs/CBA/CDS_Architecture_Design.pptx
diff --git a/docs/CBA/index.rst b/docs/CBA/index.rst
new file mode 100644
index 000000000..3bc6aca95
--- /dev/null
+++ b/docs/CBA/index.rst
@@ -0,0 +1,113 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2019 IBM.
+
+Controller Blueprint Archived Tool(CBA)
+----------------------------------------
+.. toctree::
+   :maxdepth: 1
+   
+Introduction:
+=============
+The Controller Blueprint Archived is the overall service design, fully model-driven, package needed to automate the resolution of resources for instantiation and any config provisioning operation, such as day0, day1 or day2 configuration.
+
+The CBA is .zip file, comprised of the following folder structure, the files may vary:
+
+|image0|
+
+.. |image0| image:: media/image0.jpg
+   :width: 7.88889in 
+   :height: 4.43750in
+
+Architecture:
+=============
+
+|image3|
+
+.. |image3| image:: media/CDS_architecture.jpg
+   :height: 4.43750in
+   :width: 7.88889in
+   
+Installation:
+=============
+
+Building client html and js files
+=================================
+
+	* FROM alpine:3.8 as builder
+
+	* RUN apk add --no-cache npm
+
+	* WORKDIR /opt/cds-ui/client/
+
+	* COPY client/package.json /opt/cds-ui/client/
+
+	* RUN npm install
+
+	* COPY client /opt/cds-ui/client/
+
+	* RUN npm run build
+
+
+Building and creating server
+============================
+
+	* FROM alpine:3.8
+
+	* WORKDIR /opt/cds-ui/
+
+	* RUN apk add --no-cache npm
+
+	* COPY server/package.json /opt/cds-ui/
+
+	* RUN npm install
+
+	* COPY server /opt/cds-ui/
+	
+	* COPY --from=builder /opt/cds-ui/server/public /opt/cds-ui/public
+
+	* RUN npm run build
+
+	* EXPOSE 3000
+
+	* CMD [ "npm", "start" ]
+   
+Development:
+=============
+
+Pre-requiste:
+=============
+	Visual Studio code editor
+	Git bash
+
+Steps
+=====
+   To compile CDS code:
+
+   1. Make sure your local Maven settings file ($HOME/.m2/settings.xml) contains
+    references to the ONAP repositories and OpenDaylight repositories.
+   2. git clone https://(LFID)@gerrit.onap.org/r/a/ccsdk/cds
+   3. cd cds ; mvn clean install ; cd ..
+   4. Open the cds-ui/client code for development
+   
+Data Flow:
+==========
+|image1|
+
+.. |image1| image:: media/image1.jpg
+   :width: 7.88889in 
+   :height: 4.43750in
+   
+Functional Decomposition:
+=========================
+|image2|
+
+.. |image2| image:: media/image2.jpg
+   :width: 7.88889in 
+   :height: 4.43750in
+   
+Controller design Studio Presentation:
+======================================
+
+Details about CDS Architecture and Design detail, Please click the link.
+:download:`CDS_Architecture_Design.pptx`
+\ No newline at end of file
diff --git a/docs/CBA/media/CDS_architecture.jpg b/docs/CBA/media/CDS_architecture.jpg
new file mode 100644
index 000000000..6401e6bbd
--- /dev/null
+++ b/docs/CBA/media/CDS_architecture.jpg
diff --git a/docs/CBA/media/image0.PNG b/docs/CBA/media/image0.PNG
new file mode 100644
index 000000000..1c5d8c5ff
--- /dev/null
+++ b/docs/CBA/media/image0.PNG
diff --git a/docs/CBA/media/image0.jpg b/docs/CBA/media/image0.jpg
new file mode 100644
index 000000000..8e53a2d98
--- /dev/null
+++ b/docs/CBA/media/image0.jpg
diff --git a/docs/CBA/media/image1.PNG b/docs/CBA/media/image1.PNG
new file mode 100644
index 000000000..7a4b96d5c
--- /dev/null
+++ b/docs/CBA/media/image1.PNG
diff --git a/docs/CBA/media/image1.jpg b/docs/CBA/media/image1.jpg
new file mode 100644
index 000000000..9a5cd63e4
--- /dev/null
+++ b/docs/CBA/media/image1.jpg
diff --git a/docs/CBA/media/image2.PNG b/docs/CBA/media/image2.PNG
new file mode 100644
index 000000000..e6a0cf8d3
--- /dev/null
+++ b/docs/CBA/media/image2.PNG
diff --git a/docs/CBA/media/image2.jpg b/docs/CBA/media/image2.jpg
new file mode 100644
index 000000000..20fc26250
--- /dev/null
+++ b/docs/CBA/media/image2.jpg
diff --git a/docs/CBA/resourceassignment.rst b/docs/CBA/resourceassignment.rst
new file mode 100644
index 000000000..be8b08e25
--- /dev/null
+++ b/docs/CBA/resourceassignment.rst
@@ -0,0 +1,73 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2019 IBM.
+
+Resource Assignment 
+===================
+.. toctree::
+   :maxdepth: 1
+   
+   
+Component executor:
+===================
+Workflow:
+=========
+
+A workflow defines an overall action to be taken for the service; it can be composed of a set of sub-actions to execute. Currently, workflows are backed by Directed Graph engine.
+
+A CBA can have as many workflow as needed.
+
+Template:
+=========
+
+A template is an artifact.
+
+A template is parameterized and each parameter must be defined in a corresponding mapping file.
+
+In order to know which mapping correlate to which template, the file name must start with an artifact-prefix, serving as identifier to the overall template + mapping.
+
+The requirement is as follow:
+
+${artifact-prefix}-template
+${artifact-prefix}-mapping
+
+A template can represent anything, such as device config, payload to interact with 3rd party systems, resource-accumulator template, etc...
+
+Mapping:
+========
+Defines the contract of each resource to be resolved. Each placeholder in the template must have a corresponding mapping definition.
+
+A mapping is comprised of:
+
+- name
+- required / optional
+- type (support complex type)
+- dictionary-name
+- dictionary-source
+
+Dependencies:
+=============
+
+This allows to make sure given resources get resolved prior the resolution of the resources defining the dependency.
+The dictionary fields reference to a specific data dictionary.
+
+Resource accumulator:
+=====================
+
+In order to resolve HEAT environment variables, resource accumulator templates are being in used for Dublin.
+
+These templates are specific to the pre-instantiation scenario, and relies on GR-API within SDNC.
+
+It is composed of the following sections:
+
+resource-accumulator-resolved-data: defines all the resources that can be resolved directly from the context. It expresses a direct mapping between the name of the resource and its value.
+
+capability-data: defines what capability to use to create a specific resource, along with the ingredients required to invoke the capability and the output mapping.
+
+- Scripts
+- Library
+- NetconfClient
+
+In order to facilitate NETCONF interaction within scripts, a python NetconfClient binded to our Kotlin implementation is made available. This NetconfClient can be used when using the netconf-component-executor.
+
+The client can be find here: https://github.com/onap/ccsdk-apps/blob/master/components/scripts/python/ccsdk_netconf/netconfclient.py
+\ No newline at end of file
diff --git a/docs/datadictionary/index.rst b/docs/datadictionary/index.rst
new file mode 100644
index 000000000..83c6e47b8
--- /dev/null
+++ b/docs/datadictionary/index.rst
@@ -0,0 +1,45 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2019 IBM.
+
+Resource Definition 
+-------------------
+.. toctree::
+   :maxdepth: 1
+
+Introduction:
+=============
+A Resource Definition defines a specifc resource that can be resolved using the bellow supported sources.
+
+A Resource Definition can support multiple sources.
+
+The main goal of Resource Definition is to define generic entity that could be shared accross services.
+
+
+Resolution sources:
+===================
+
+   * Input
+   * Default
+   * DB
+   * REST
+   * Capability
+
+Artifacts:
+==========
+
+   * artifact-mapping-resource
+   * artifact-template-velocity
+   * artifact-directed-graph
+
+Node type:
+==========
+	
+   * component-resource-resolution
+   * component-jython-executor
+   * component-netconf-executor
+   * component-restconf-executor
+
+Data type:
+==========
+   * vnf-netconf-device
+\ No newline at end of file
diff --git a/docs/index.rst b/docs/index.rst
new file mode 100644
index 000000000..f46653ab6
--- /dev/null
+++ b/docs/index.rst
@@ -0,0 +1,45 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2019 IBM.
+
+CONTROLLER DESIGN STUDIO (CDS) 
+------------------------------
+.. toctree::
+   :maxdepth: 1
+   
+Introduction:
+=============
+The system is designed to be self service, which means that users, not just programmers, can reconfigure the software system as needed to meet customer requirements. To accomplish this goal, the system is built around models that provide for real-time changes in how the system operates.  Users merely need to change a model to change how a service operates.
+Self service is a completely new way of delivering services.  It removes the dependence on code releases and the delays they cause and puts the control of services into the hands of the service providers.  They can change a model and its parameters and create a new service without writing a single line of code.  
+This makes SERVICE PROVIDER(S) more responsive to its customers and able to deliver products that more closely match the needs of its customers.
+
+Design tools:
+=============
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   CBA/index
+   datadictionary/index
+
+
+Architecture:
+=============
+The Controller Design Studio is composed of two major components: 
+	* The GUI (or frontend)
+	* The Run Time (or backend)  
+The GUI handles direct user input and allows for displaying both design time and run time activities.  For design time, it allows for the creation of controller blueprint, from selecting the DGs to be included, to incorporating the artifact templates, to adding necessary components.  For run time, it allows the user to direct the system to resolve the unresolved elements of the controller blueprint and download the resulting configuration into a VNF.  At a more basic level, it allows for creation of data dictionaries, capabilities catalogs, and controller blueprint, the basic elements that are used to generate a configuration. The essential function of the Controller Design Studio is to create and populate a controller blueprint, create a configuration file from this Controller blueprint, and download this configuration file (configlet) to a VNF/PNF.
+
+Resource assignment:
+=====================
+.. toctree::
+   :maxdepth: 1
+   :glob:
+   
+   resourceassignment
+
+ResolutionHelper:
+=================
+When executing a component executor script, designer might want to perform resource resolution along with template meshing directly from the script itself.
+
+The helper can be find here: https://github.com/onap/ccsdk-apps/blob/master/components/scripts/python/ccsdk_netconf/common.py
+\ No newline at end of file
diff --git a/docs/logging.rst b/docs/logging.rst
new file mode 100644
index 000000000..c6cfad9ef
--- /dev/null
+++ b/docs/logging.rst
@@ -0,0 +1,16 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2019 IBM.
+
+Logging
+-------
+.. toctree::
+   :maxdepth: 1
+
+CCSDK uses slf4j to log messages to the standard OpenDaylight karaf.log
+log file.
+
+Where to Access Information
+---------------------------
+Logs are found within the SDNC docker container, in the directory
+/opt/opendaylight/current/data/logs.
+\ No newline at end of file
diff --git a/docs/release-notes.rst b/docs/release-notes.rst
new file mode 100644
index 000000000..a53419f67
--- /dev/null
+++ b/docs/release-notes.rst
@@ -0,0 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2019 IBM.
+
+Release-Notes
+-------------
+.. toctree::
+   :maxdepth: 1
+\ No newline at end of file