Updated release notes for 1.12.0
[sdc.git] / docs / release-notes.rst
index 95189c1..0a3ea11 100644 (file)
 Release Notes
 =============
 
+Version: 1.12.0
+==============
+
+:Release Date: 2022-10-28
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client (Kafka)
+
+   :Version: 2.0.0
+   
+-  sdc-distribution-client (DMaap MR - deprecated)
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.7.0
+
+Release Purpose
+----------------
+SDC London early release
+
+**Epics**
+
+N/A
+
+
+**Stories**
+
+*  `SDC-4207 <https://jira.onap.org/browse/SDC-4207>`_ - Constraint validation - Node Template Interfaces
+*  `SDC-4229 <https://jira.onap.org/browse/SDC-4229>`_ - Default Substitution Mapping
+*  `DMAAP-1787 <https://jira.onap.org/browse/DMAAP-1787>`_ - [SDC] Migrate SDC to use kafka native messaging
+*  `SDC-4216 <https://jira.onap.org/browse/SDC-4216>`_ - Support import of VFCs with property constraints
+*  `SDC-4209 <https://jira.onap.org/browse/SDC-4209>`_ - Constraint validation - Instance Attributes in a Service
+*  `SDC-4210 <https://jira.onap.org/browse/SDC-4210>`_ - VFC properties - Increase character limit to 100 and allow use of @ character
+*  `SDC-4214 <https://jira.onap.org/browse/SDC-4214>`_ - View Data type properties in UI
+*  `SDC-4142 <https://jira.onap.org/browse/SDC-4142>`_ - Service import - Import updated node types with new attributes
+*  `SDC-4208 <https://jira.onap.org/browse/SDC-4208>`_ - Enable viewing of VFC property details when checked in
+*  `SDC-4190 <https://jira.onap.org/browse/SDC-4190>`_ - Constraint validation - Instance Properties in a Service
+*  `SDC-4193 <https://jira.onap.org/browse/SDC-4193>`_ - View data type in UI
+*  `SDC-4184 <https://jira.onap.org/browse/SDC-4184>`_ - API for fetching single data type
+*  `DMAAP-1744 <https://jira.onap.org/browse/DMAAP-1744>`_ - Move SDC and clients to use Strimzi Kafka
+
+
+**Bug Fixes**
+
+*  `SDC-4224 <https://jira.onap.org/browse/SDC-4224>`_ - Import service with policy error
+*  `SDC-4225 <https://jira.onap.org/browse/SDC-4225>`_ - Import of service with concat property value issue
+*  `SDC-4227 <https://jira.onap.org/browse/SDC-4227>`_ - Error importing service with instance interfaces
+*  `SDC-4189 <https://jira.onap.org/browse/SDC-4189>`_ - security risk: Improper Input Validation
+*  `SDC-4217 <https://jira.onap.org/browse/SDC-4217>`_ - Setting value on interface operation property with constraint throws exception
+*  `SDC-4218 <https://jira.onap.org/browse/SDC-4218>`_ - Fix cant set properties on an instance in the composition view
+*  `SDC-4211 <https://jira.onap.org/browse/SDC-4211>`_ - Fetch data type endpoint is returning Optional instead of the requested Data Type
+*  `SDC-4213 <https://jira.onap.org/browse/SDC-4213>`_ - Onboard-ui build started to fail with problems in ./node_modules/react-show-more-text/lib/ShowMoreText.css
+*  `SDC-4196 <https://jira.onap.org/browse/SDC-4196>`_ - Empty interface operation definitions throw exception
+*  `SDC-4192 <https://jira.onap.org/browse/SDC-4192>`_ - X-Frame-Options not configured: Lack of clickjacking protection
+*  `SDC-4185 <https://jira.onap.org/browse/SDC-4185>`_ - Composition Window doesnot allow to update new version of VFC
+
+
+**Tasks**
+
+*  `SDC-4204 <https://jira.onap.org/browse/SDC-4204>`_ - Finalize Documentation
+*  `SDC-4232 <https://jira.onap.org/browse/SDC-4232>`_ - Remove temp file if Minio-upload failed
+*  `SDC-4231 <https://jira.onap.org/browse/SDC-4231>`_ - Fix potential NPE in importing property constraints
+*  `SDC-4230 <https://jira.onap.org/browse/SDC-4230>`_ - Fix Critical bug reported by Sonar
+*  `SDC-4228 <https://jira.onap.org/browse/SDC-4228>`_ - Update Vulnerable 3PP commons-text-1.9
+*  `SDC-4205 <https://jira.onap.org/browse/SDC-4205>`_ - Remove unused code
+
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
+Version: 1.11.9
+==============
+
+:Release Date: 2022-09-28
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.7.0
+
+Release Purpose
+----------------
+SDC Kohn M4 release
+
+**Epics**
+
+*  `SDC-4034 <https://jira.onap.org/browse/SDC-4034>`_ - Service Import
+*  `SDC-4037 <https://jira.onap.org/browse/SDC-4037>`_ - Additional TOSCA constructs support Kohn
+*  `SDC-4035 <https://jira.onap.org/browse/SDC-4035>`_ - Deletion of archived assets
+*  `SDC-4037 <https://jira.onap.org/browse/SDC-4037>`_ - Additional TOSCA constructs support Kohn
+*  `SDC-4036 <https://jira.onap.org/browse/SDC-4036>`_ - Enable application metrics
+
+
+**Stories**
+
+*  `SDC-4186 <https://jira.onap.org/browse/SDC-4186>`_ - Service import - Import unknown interface types
+*  `SDC-4187 <https://jira.onap.org/browse/SDC-4187>`_ - Service import - Import unknown capability types
+*  `SDC-4176 <https://jira.onap.org/browse/SDC-4176>`_ - Service import - Import unknown group types
+*  `SDC-4173 <https://jira.onap.org/browse/SDC-4173>`_ - Support tosca functions for node capability filters
+*  `SDC-4153 <https://jira.onap.org/browse/SDC-4153>`_ - Service import - Import necessary artifact types
+*  `SDC-4162 <https://jira.onap.org/browse/SDC-4162>`_ - Service Import - yaml error
+
+
+**Bug Fixes**
+
+*  `SDC-4125 <https://jira.onap.org/browse/SDC-4125>`_ - Error thrown when setting policy property with get_property
+*  `SDC-4188 <https://jira.onap.org/browse/SDC-4188>`_ - Fix show add button for Req and Capabilities in VF
+*  `SDC-4181 <https://jira.onap.org/browse/SDC-4181>`_ - Simulator showing server exception when no content type is provided
+*  `SDC-4179 <https://jira.onap.org/browse/SDC-4179>`_ - maven-resources-plugin filtering problem with plugins-configuration.yaml
+*  `SDC-4175 <https://jira.onap.org/browse/SDC-4175>`_ - Capablity Types not refreshing after model change
+
+
+**Tasks**
+
+*  `SDC-4183 <https://jira.onap.org/browse/SDC-4183>`_ - Improve the catalog-fe README
+*  `SDC-4066 <https://jira.onap.org/browse/SDC-4066>`_ - Improve catalog-ui test coverage
+*  `SDC-4180 <https://jira.onap.org/browse/SDC-4180>`_ - Local paths shown in the compiled onboard UI app
+*  `SDC-4178 <https://jira.onap.org/browse/SDC-4178>`_ - Update 'Deployment dependency map'
+
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
+Version: 1.11.8
+==============
+
+:Release Date: 2022-09-09
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.7.0
+
+Release Purpose
+----------------
+SDC Kohn early release
+
+**Epics**
+
+    N/A
+
+
+**Stories**
+
+*  `SDC-4168 <https://jira.onap.org/browse/SDC-4168>`_ - Support import of service with TOSCA functions in sub properties
+*  `SDC-4171 <https://jira.onap.org/browse/SDC-4171>`_ - Relax checking on operation property values
+*  `SDC-4128 <https://jira.onap.org/browse/SDC-4128>`_ - Support TOSCA functions for node filters
+*  `SDC-4151 <https://jira.onap.org/browse/SDC-4151>`_ - Support TOSCA functions in sub properties in properties assignment
+*  `SDC-4131 <https://jira.onap.org/browse/SDC-4131>`_ - Service import - Import updated node types
+*  `SDC-4149 <https://jira.onap.org/browse/SDC-4149>`_ - Allow to select properties in the get_attribute function
+*  `SDC-4140 <https://jira.onap.org/browse/SDC-4140>`_ - Service import - Import updated data types
+*  `SDC-4137 <https://jira.onap.org/browse/SDC-4137>`_ - Service Import - general page validation
+*  `SDC-4082 <https://jira.onap.org/browse/SDC-4082>`_ - Service Import - Inputs
+*  `SDC-4136 <https://jira.onap.org/browse/SDC-4136>`_ - Allow ETSI VNF without other node template
+
+
+**Bug Fixes**
+
+*  `SDC-4174 <https://jira.onap.org/browse/SDC-4174>`_ - New node filter API does not accept legacy payload
+*  `SDC-4166 <https://jira.onap.org/browse/SDC-4166>`_ - Importing service with TOSCA function yaml value
+*  `SDC-4169 <https://jira.onap.org/browse/SDC-4169>`_ - application exposed to path traversal attack
+*  `SDC-4134 <https://jira.onap.org/browse/SDC-4134>`_ - Import VFC not importing interfaces
+*  `SDC-4145 <https://jira.onap.org/browse/SDC-4145>`_ - NPE thrown for interface operation template with no inputs
+*  `SDC-4150 <https://jira.onap.org/browse/SDC-4150>`_ - Import service - sub import files are not loading
+*  `SDC-4097 <https://jira.onap.org/browse/SDC-4097>`_ - Wrong Inputs creation on 'Add Service'
+*  `SDC-4144 <https://jira.onap.org/browse/SDC-4144>`_ - SDC Jakarta release: "create service" does not work when new category added
+*  `SDC-4141 <https://jira.onap.org/browse/SDC-4141>`_ - Encrypted user not being handled correctly in SDC-BE
+*  `SDC-4130 <https://jira.onap.org/browse/SDC-4130>`_ - Fix Wrongly generated tosca implementation
+*  `SDC-4132 <https://jira.onap.org/browse/SDC-4132>`_ - Fix error handling for instances with no properties
+*  `SDC-4133 <https://jira.onap.org/browse/SDC-4133>`_ - ClassCastException thrown for artifact primary string value
+
+
+**Tasks**
+
+*  `SDC-4167 <https://jira.onap.org/browse/SDC-4167>`_ - Update/remove vulnerable dependencies
+*  `SDC-4165 <https://jira.onap.org/browse/SDC-4165>`_ - Update SDC with new 'security-util-lib' version
+*  `DOC-782 <https://jira.onap.org/browse/DOC-782>`_ - Create docs for 'Jakarta' main release
+*  `SDC-4143 <https://jira.onap.org/browse/SDC-4143>`_ - Improve error's message readability
+*  `SDC-4017 <https://jira.onap.org/browse/SDC-4017>`_ - Remove/update vulnerable dependency
+*  `SDC-4139 <https://jira.onap.org/browse/SDC-4139>`_ - Fix broken build
+*  `SDC-4133 <https://jira.onap.org/browse/SDC-4133>`_ - ClassCastException thrown for artifact primary string value
+
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
+Version: 1.11.7
+==============
+
+:Release Date: 2022-08-15
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.7.0
+
+Release Purpose
+----------------
+SDC Kohn early release
+
+**Epics**
+
+    N/A
+
+
+**Stories**
+
+*  `SDC-4113 <https://jira.onap.org/browse/SDC-4113>`_ - Service Import - Node Template Interface Definitions
+*  `SDC-4118 <https://jira.onap.org/browse/SDC-4118>`_ - Service import - Import unknown node types
+*  `SDC-4119 <https://jira.onap.org/browse/SDC-4119>`_ - Service import - Import unknown data types
+*  `SDC-4123 <https://jira.onap.org/browse/SDC-4123>`_ - Support property get_input value in deprecated format
+*  `SDC-4122 <https://jira.onap.org/browse/SDC-4122>`_ - Support tosca functions for policy instance properties in property assignment view
+*  `SDC-4120 <https://jira.onap.org/browse/SDC-4120>`_ - Support for TOSCA functions for Service Import
+*  `SDC-4083 <https://jira.onap.org/browse/SDC-4083>`_ - Service Import - Node Template Relationship Template
+*  `SDC-4109 <https://jira.onap.org/browse/SDC-4109>`_ - Enable configuration of instance name
+*  `SDC-4099 <https://jira.onap.org/browse/SDC-4099>`_ - Set property to yaml string in TOSCA functions modal
+
+
+**Bug Fixes**
+
+*  `SDC-4129 <https://jira.onap.org/browse/SDC-4129>`_ - Newly imported data types not found in UI
+*  `SDC-4126 <https://jira.onap.org/browse/SDC-4126>`_ - Properties of the previous instance is loading in the Hierarchical panel
+*  `SDC-4127 <https://jira.onap.org/browse/SDC-4127>`_ - Fix unable to delete default value for a complex property
+*  `SDC-4124 <https://jira.onap.org/browse/SDC-4124>`_ - Empty node filter in template when directives added with no filter
+*  `SDC-4117 <https://jira.onap.org/browse/SDC-4117>`_ - Error Importing node filter with multiple capability properties
+*  `SDC-4125 <https://jira.onap.org/browse/SDC-4125>`_ - Error thrown when setting policy property with get_property
+*  `SDC-4098 <https://jira.onap.org/browse/SDC-4098>`_ - Error adding capability with properties to VFC
+*  `SDC-4121 <https://jira.onap.org/browse/SDC-4121>`_ - Fix outputs of complex type display and delete
+*  `SDC-4114 <https://jira.onap.org/browse/SDC-4114>`_ - Fix Tosca Function Validation for Group and Policy properties
+*  `SDC-4116 <https://jira.onap.org/browse/SDC-4116>`_ - UI shows text overlay on value field
+*  `SDC-4115 <https://jira.onap.org/browse/SDC-4115>`_ - Fix functionaljava dependency for onboarding
+*  `SDC-4084 <https://jira.onap.org/browse/SDC-4084>`_ - Group Property value display not easily readable
+*  `SDC-4110 <https://jira.onap.org/browse/SDC-4110>`_ - Save button disabled in update property in composition view
+
+
+**Tasks**
+
+*  `SDC-4017 <https://jira.onap.org/browse/SDC-4017>`_ - Remove/update vulnerable dependency
+*  `SDC-4100 <https://jira.onap.org/browse/SDC-4100>`_ - Add fast build profile ignoring the frontend build
+
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
+Version: 1.11.6
+==============
+
+:Release Date: 2022-07-21
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.7.0
+
+Release Purpose
+----------------
+SDC Kohn early release
+
+**Epics**
+
+    N/A
+
+**Stories**
+
+*  `SDC-4078 <https://jira.onap.org/browse/SDC-4078>`_ - Support tosca functions for group instances in composition view
+*  `SDC-4060 <https://jira.onap.org/browse/SDC-4060>`_ - Service Import - Policies
+*  `SDC-4051 <https://jira.onap.org/browse/SDC-4051>`_ - Service Import - Outputs
+*  `SDC-4080 <https://jira.onap.org/browse/SDC-4080>`_ - Allow set values in properties of type timestamp
+*  `SDC-4095 <https://jira.onap.org/browse/SDC-4095>`_ - Support concat for string property values
+*  `SDC-4090 <https://jira.onap.org/browse/SDC-4090>`_ - Support tosca functions for group instances
+
+
+
+**Bug Fixes**
+
+*  `SDC-4048 <https://jira.onap.org/browse/SDC-4048>`_ - VFC properties of type timestamp not visible in property assignment
+*  `SDC-4063 <https://jira.onap.org/browse/SDC-4063>`_ - Directives drop down list cut short
+*  `SDC-4087 <https://jira.onap.org/browse/SDC-4087>`_ - Node Filters displayed incorrectly
+*  `SDC-4088 <https://jira.onap.org/browse/SDC-4088>`_ - Save/discard button not showing for an instance attributes
+*  `SDC-4081 <https://jira.onap.org/browse/SDC-4081>`_ - Fail to declare Input for duplicated name of property
+*  `SDC-4089 <https://jira.onap.org/browse/SDC-4089>`_ - Fix upgrade failure
+*  `SDC-4079 <https://jira.onap.org/browse/SDC-4079>`_ - Service Import - Input appearing as a property
+*  `SDC-4091 <https://jira.onap.org/browse/SDC-4091>`_ - Fix clear value for group instances toscaGetFunction
+*  `SDC-4085 <https://jira.onap.org/browse/SDC-4085>`_ - Unable to create a property on SELF of type List <Map>
+*  `SDC-4096 <https://jira.onap.org/browse/SDC-4096>`_ - Changing VFC version on composition page results in error
+*  `SDC-4101 <https://jira.onap.org/browse/SDC-4101>`_ - Fix incorrect dependency scope change
+
+
+
+**Tasks**
+
+*  `SDC-4017 <https://jira.onap.org/browse/SDC-4017>`_ - Update vulnerable dependencies
+*  `SDC-4094 <https://jira.onap.org/browse/SDC-4094>`_ - Remove unused dependency (functionaljava)
+*  `SDC-4100 <https://jira.onap.org/browse/SDC-4100>`_ - Add fast build profile ignoring frontend
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
+Version: 1.11.5
+==============
+
+:Release Date: 2022-06-24
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.7.0
+
+Release Purpose
+----------------
+SDC Kohn early release
+
+**Epics**
+
+    N/A
+
+**Stories**
+
+*  `SDC-3982 <https://jira.onap.org/browse/SDC-3982>`_ - Rearrange Interface Operation Implementation
+*  `SDC-4055 <https://jira.onap.org/browse/SDC-4055>`_ - Delete interface operation from VFC
+*  `SDC-4052 <https://jira.onap.org/browse/SDC-4052>`_ - Service Import - Input Metadata
+*  `SDC-4049 <https://jira.onap.org/browse/SDC-4049>`_ - Service Import - Node Template Node Filter
+*  `SDC-4053 <https://jira.onap.org/browse/SDC-4053>`_ - Support get_attribute in Property Assignment TOSCA functions
+*  `SDC-4054 <https://jira.onap.org/browse/SDC-4054>`_ - Service Import - Groups
+*  `SDC-4044 <https://jira.onap.org/browse/SDC-4044>`_ - Service Import - Read metadata from csar
+*  `SDC-4065 <https://jira.onap.org/browse/SDC-4065>`_ - Make instance count optional
+
+**Bug Fixes**
+
+*  `SDC-4041 <https://jira.onap.org/browse/SDC-4041>`_ - Fix broken build
+*  `SDC-4042 <https://jira.onap.org/browse/SDC-4042>`_ - TOSCA function modal input/property not found message does not disappear
+*  `SDC-4046 <https://jira.onap.org/browse/SDC-4046>`_ - After a checkout in the VFC Properties page, can't edit a property
+*  `SDC-4043 <https://jira.onap.org/browse/SDC-4043>`_ - Load inputs/properties in Tosca Get Function dialog considering the selected property schema
+*  `SDC-4047 <https://jira.onap.org/browse/SDC-4047>`_ - Disable the save button in Property assignment TOSCA Function Modal for invalid values
+*  `SDC-4039 <https://jira.onap.org/browse/SDC-4039>`_ - Fix getToscaFunction validation for property value
+*  `SDC-4038 <https://jira.onap.org/browse/SDC-4038>`_ - Fix loading issue and double errors in properties assignment
+*  `SDC-4050 <https://jira.onap.org/browse/SDC-4050>`_ - Update a list of map in VFC Properties - error while adding a new entry
+*  `SDC-4057 <https://jira.onap.org/browse/SDC-4057>`_ - get_input not working for complex properties
+*  `SDC-4059 <https://jira.onap.org/browse/SDC-4059>`_ - Fix interface name and operation not being disabled on edit
+*  `SDC-4058 <https://jira.onap.org/browse/SDC-4058>`_ - VFC interface operation can be edited even when checked in
+*  `SDC-4061 <https://jira.onap.org/browse/SDC-4061>`_ - Fix Interface Operation mandatory fields
+*  `SDC-4045 <https://jira.onap.org/browse/SDC-4045>`_ - Fix interface operation implementation not being updated on version change
+
+
+**Tasks**
+
+*  `SDC-4056 <https://jira.onap.org/browse/SDC-4056>`_ - Remove unused maven properties in main pom
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
+Version: 1.11.4
+==============
+
+:Release Date: 2022-06-09
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.7.0
+
+Release Purpose
+----------------
+SDC Kohn early release
+
+**Epics**
+
+    N/A
+
+**Stories**
+
+*  `SDC-4031 <https://jira.onap.org/browse/SDC-4031>`_ - get_property support in Update Property modal from Composition page
+*  `SDC-4028 <https://jira.onap.org/browse/SDC-4028>`_ - Allow to edit a TOSCA get function value in the Properties Assignment
+*  `SDC-4025 <https://jira.onap.org/browse/SDC-4025>`_ - Maintain VFC instance attribute outputs on instance version change
+*  `SDC-4018 <https://jira.onap.org/browse/SDC-4018>`_ - Maintain VFC UI added interface operations after an upgrade
+*  `SDC-4012 <https://jira.onap.org/browse/SDC-4012>`_ - Maintain VFC UI added properties after an upgrade
+*  `SDC-4016 <https://jira.onap.org/browse/SDC-4016>`_ - Maintain VFC external capabilities and requirements on instance version change
+*  `SDC-4026 <https://jira.onap.org/browse/SDC-4026>`_ - Component Instance property selection in Property Assignment get property
+*  `SDC-4009 <https://jira.onap.org/browse/SDC-4009>`_ - Maintain VFC instance interface operation details on instance version change
+*  `SDC-4023 <https://jira.onap.org/browse/SDC-4023>`_ - Delete VSP - Ensure complete deletion of VSP from DB
+*  `SDC-4014 <https://jira.onap.org/browse/SDC-4014>`_ - Support get_property in Property Assignment TOSCA functions
+*  `SDC-4015 <https://jira.onap.org/browse/SDC-4015>`_ - Maintain VFC instance occurrences values on instance version change
+
+**Bug Fixes**
+
+*  `SDC-4032 <https://jira.onap.org/browse/SDC-4032>`_ - sdc-be-init fails intermittently
+*  `SDC-4030 <https://jira.onap.org/browse/SDC-4030>`_ - Fix Component Instance requirements and capabilities not updating
+*  `SDC-4024 <https://jira.onap.org/browse/SDC-4024>`_ - Interface Operation Implementation artifact file name incorrect for extended notation
+*  `SDC-4027 <https://jira.onap.org/browse/SDC-4027>`_ - Error when restoring VLM: Unable to restore partially deleted VSP, re-try VSP deletion
+*  `SDC-4022 <https://jira.onap.org/browse/SDC-4022>`_ - Inconsistent behavior adding a CONCAT string to VFC property and node filter property
+*  `SDC-4021 <https://jira.onap.org/browse/SDC-4021>`_ - Fix Component Instance versions not updating
+*  `SDC-4013 <https://jira.onap.org/browse/SDC-4013>`_ - Exception thrown when accessing a VF General page
+*  `SDC-3987 <https://jira.onap.org/browse/SDC-3987>`_ - Node Filter string property value displayed as object
+
+
+**Tasks**
+
+*  `SDC-4029 <https://jira.onap.org/browse/SDC-4029>`_ - Fix Blocker Vulnerability
+*  `SDC-4017 <https://jira.onap.org/browse/SDC-4017>`_ - Remove/update vulnerable dependency
+*  `SDC-4011 <https://jira.onap.org/browse/SDC-4011>`_ - Include ETSI metadata in VSP package metadata
+
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
+Version: 1.11.3
+==============
+
+:Release Date: 2022-05-17
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.7.0
+
+Release Purpose
+----------------
+SDC Kohn early release
+
+**Epics**
+
+    N/A
+
+**Stories**
+
+*  `SDC-3999 <https://jira.onap.org/browse/SDC-3999>`_ - Import VFC with interface operation implementation extended notataion
+*  `SDC-4001 <https://jira.onap.org/browse/SDC-4001>`_ - Support list<map<string, string>> properties in composition screen dialog
+*  `SDC-3996 <https://jira.onap.org/browse/SDC-3996>`_ - Generalise Select Input button in Properties Assignment view
+*  `SDC-4003 <https://jira.onap.org/browse/SDC-4003>`_ - Onboarded ASD csar included in VF csar
+
+**Bug Fixes**
+
+*  `SDC-3989 <https://jira.onap.org/browse/SDC-3989>`_ - additional_type_definition file missing in the csar package
+*  `SDC-3990 <https://jira.onap.org/browse/SDC-3990>`_ - Custom datatype error when creating new property/input
+*  `SDC-3983 <https://jira.onap.org/browse/SDC-3983>`_ - Fix inputs/policy tabs view for self and instances
+*  `SDC-3991 <https://jira.onap.org/browse/SDC-3991>`_ - VLM duplicate name gives generic error
+*  `SDC-4000 <https://jira.onap.org/browse/SDC-4000>`_ - Edit Operation modal does not offer correct artifact types and data types
+*  `SDC-3997 <https://jira.onap.org/browse/SDC-3997>`_ - Interface panel is blank when switch to a different version of a VFC
+*  `SDC-3998 <https://jira.onap.org/browse/SDC-3998>`_ - Datatypes for a property are not specific to the VFC model
+*  `SDC-4007 <https://jira.onap.org/browse/SDC-4007>`_ - Unable to delete Map from List<Maps> property type
+*  `SDC-4010 <https://jira.onap.org/browse/SDC-4010>`_ - Fix UI not displaying directives list correctly
+
+
+**Tasks**
+
+    N/A
+
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
+Version: 1.11.2
+==============
+
+:Release Date: 2022-04-23
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.7.0
+
+Release Purpose
+----------------
+SDC Kohn early release
+
+**Epics**
+
+    N/A
+
+**Stories**
+
+*  `SDC-3964 <https://jira.onap.org/browse/SDC-3964>`_ - Onboarding UI support for VLM deletion
+*  `SDC-3957 <https://jira.onap.org/browse/SDC-3957>`_ - Add application metrics in the catalog backend
+*  `SDC-3956 <https://jira.onap.org/browse/SDC-3956>`_ - Add application metrics in the onboarding backend
+*  `SDC-3966 <https://jira.onap.org/browse/SDC-3966>`_ - Restrict deletion of a VLM that is in use by any VSP
+*  `SDC-3968 <https://jira.onap.org/browse/SDC-3968>`_ - Delete VLM - Support deletion of archived VLMs in onboarding BE
+*  `SDC-3972 <https://jira.onap.org/browse/SDC-3972>`_ - Delete VFC - distinguish between system deployed or user deployed VFCs
+*  `SDC-3981 <https://jira.onap.org/browse/SDC-3981>`_ - Delete VFC - restrict deletion of system deployed VFCs
+*  `SDC-3936 <https://jira.onap.org/browse/SDC-3936>`_ - Delete Service - Support deletion of archived services in SDC BE
+*  `SDC-3962 <https://jira.onap.org/browse/SDC-3962>`_ - Delete service - UI support for deleting services
+*  `SDC-3969 <https://jira.onap.org/browse/SDC-3969>`_ - Add an UI feedback when saving a interface operation
+*  `SDC-3973 <https://jira.onap.org/browse/SDC-3973>`_ - Delete Service - Support deletion of archived VFs in SDC BE
+
+**Bug Fixes**
+
+*  `SDC-3960 <https://jira.onap.org/browse/SDC-3960>`_ - Adjust onboarding UI min node npm version
+*  `SDC-3957 <https://jira.onap.org/browse/SDC-3957>`_ - Add application metrics in the catalog backend
+*  `SDC-3967 <https://jira.onap.org/browse/SDC-3967>`_ - Failed to launch to SDC from Portal
+*  `SDC-3971 <https://jira.onap.org/browse/SDC-3971>`_ - Fix incorrect version in metrics-rest
+*  `SDC-3975 <https://jira.onap.org/browse/SDC-3975>`_ - Unit tests with conflicting output folder, resulting in intermittent build errors
+*  `SDC-3974 <https://jira.onap.org/browse/SDC-3974>`_ - NPE thrown when adding ASD VF to a service
+*  `SDC-3985 <https://jira.onap.org/browse/SDC-3985>`_ - Edit/Delete options for directives are not disabled when service is checked in / certified
+*  `SDC-3986 <https://jira.onap.org/browse/SDC-3986>`_ - Fix check to restrict deletion for system deployed VFCs
+
+**Tasks**
+
+*  `SDC-3932 <https://jira.onap.org/browse/SDC-3932>`_ - Remove deprecated/unused base images
+*  `DOC-782 <https://jira.onap.org/browse/DOC-782>`_ - Create docs for 'Jakarta' main release
+*  `SDC-3984 <https://jira.onap.org/browse/SDC-3984>`_ - Replace deprecated GEventEvaluator with JaninoEventEvaluator
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
+Version: 1.11.1
+==============
+
+:Release Date: 2022-04-08
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.6.6
+
+Release Purpose
+----------------
+SDC Kohn early release
+
+**Epics**
+
+    N/A
+
+**Stories**
+
+*  `SDC-3938 <https://jira.onap.org/browse/SDC-3938>`_ - Add ASD node and data types to SDC AID model
+*  `SDC-3952 <https://jira.onap.org/browse/SDC-3952>`_ - Delete VSP - Onboarding UI support for VSP deletion 
+
+**Bug Fixes**
+
+*  `SDC-3953 <https://jira.onap.org/browse/SDC-3953>`_ - Fix error handling for VSP usage check in VF 
+
+**Tasks**
+
+    N/A
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
+Version: 1.11.0
+==============
+
+:Release Date: 2022-04-05
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.6.6
+
+Release Purpose
+----------------
+SDC Kohn early release
+
+**Epics**
+
+    N/A
+
+**Stories**
+
+*  `SDC-3893 <https://jira.onap.org/browse/SDC-3893>`_ - UI support for editing interfaces on a node type
+*  `SDC-3931 <https://jira.onap.org/browse/SDC-3931>`_ - Delete VSP - Handling partial delete failure
+*  `SDC-3935 <https://jira.onap.org/browse/SDC-3935>`_ - Delete VSP - Restore of partially deleted VSP
+*  `SDC-3948 <https://jira.onap.org/browse/SDC-3948>`_ - Add ASD artifact type to SDC AID model
+*  `SDC-3893 <https://jira.onap.org/browse/SDC-3893>`_ - UI support for editing interfaces on a node type
+*  `SDC-3894 <https://jira.onap.org/browse/SDC-3894>`_ - Delete VSP - Restrict deletion of archived VSPs if used in VF
+*  `SDC-3884 <https://jira.onap.org/browse/SDC-3884>`_ - Copy entry_defintion_type to TOSCA.meta
+*  `SDC-3890 <https://jira.onap.org/browse/SDC-3890>`_ - Delete VSP - Support deletion of archived VSPs in onboarding BE
+
+**Bug Fixes**
+
+*  `SDC-3939 <https://jira.onap.org/browse/SDC-3939>`_ - NPE thrown in service import
+*  `SDC-3934 <https://jira.onap.org/browse/SDC-3934>`_ - Package storage and reducer config are not reloading when there is a config change
+*  `SDC-3937 <https://jira.onap.org/browse/SDC-3937>`_ - PM_DICTIONARY check is causing nullpointer
+*  `SDC-3926 <https://jira.onap.org/browse/SDC-3926>`_ - Setting value of list or map property with complex type results in single value
+*  `SDC-3928 <https://jira.onap.org/browse/SDC-3928>`_ - Fix unable to update 'Interface Name' in VF
+
+**Tasks**
+
+*  `SDC-3933 <https://jira.onap.org/browse/SDC-3933>`_ - Upgrade vulnerable dependency 'org.apache.httpcomponents:httpcore'
+*  `SDC-3927 <https://jira.onap.org/browse/SDC-3927>`_ - Remove unused vulnerable dependency
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
+
+Version: 1.10.3
+==============
+
+:Release Date: 2022-03-22
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.6.6
+
+Release Purpose
+----------------
+SDC Jakarta
+
+**Epics**
+    N/A
+
+**Stories**
+    N/A
+
+**Bug Fixes**
+
+*  `SDC-3921 <https://jira.onap.org/browse/SDC-3921>`_ - Map entry deletion not showing for inputs of type map<a complex type> in interface operation 
+*  `SDC-3922 <https://jira.onap.org/browse/SDC-3922>`_ - Node filters not loading while editing the select directive list 
+*  `SDC-3919 <https://jira.onap.org/browse/SDC-3919>`_ - Instance count not being added correctly to node template
+*  `SDC-3918 <https://jira.onap.org/browse/SDC-3918>`_ - Interface operation artifact implementation is being persisted even if not selected
+*  `SDC-3920 <https://jira.onap.org/browse/SDC-3920>`_ - Default value for inputs of complex type (in a instance interface operation) not being saved as JSON string
+*  `SDC-3916 <https://jira.onap.org/browse/SDC-3916>`_ - Error assigning substitution filter property to service property
+
+**Tasks**
+
+*  `SDC-3923 <https://jira.onap.org/browse/SDC-3923>`_ - Implement redirecting root url to sdc1
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
+Version: 1.10.2
+==============
+
+:Release Date: 2022-03-15
+
+SDC SDKs Versions
+-----------------
+
+-  sdc-distribution-client
+
+   :Version: 1.4.5
+
+-  sdc-tosca
+
+   :Version: 1.6.6
+
+Release Purpose
+----------------
+SDC Jakarta
+
+**Epics**
+    N/A
+
+**Stories**
+
+*  `SDC-3885 <https://jira.onap.org/browse/SDC-3885>`_ - Remove single request bottleneck from the simulator 
+*  `SDC-3886 <https://jira.onap.org/browse/SDC-3886>`_ - Implement improved MinIo client
+*  `SDC-3861 <https://jira.onap.org/browse/SDC-3861>`_ - Support for multiple directives
+*  `SDC-3898 <https://jira.onap.org/browse/SDC-3898>`_ - Support properties of type List<Map<String, String>>
+*  `SDC-3891 <https://jira.onap.org/browse/SDC-3891>`_ - Update SDC for rename of TOSCA CL to ACM
+*  `SDC-3891 <https://jira.onap.org/browse/SDC-3882>`_ - Support occurrences on node templates
+*  `SDC-3891 <https://jira.onap.org/browse/SDC-3897>`_ - Support complex types in interface operation inputs
+*  `SDC-3891 <https://jira.onap.org/browse/SDC-3899>`_ - Support complex types for artifact properties in interface operation implementation
+*  `SDC-3891 <https://jira.onap.org/browse/SDC-3887>`_ - Support instance count on node template
+
+**Bug Fixes**
+
+*  `SDC-3881 <https://jira.onap.org/browse/SDC-3881>`_ - Fix NSD plugin to find version by model and category metadata 
+*  `SDC-3892 <https://jira.onap.org/browse/SDC-3892>`_ - SDC build failing
+*  `SDC-3889 <https://jira.onap.org/browse/SDC-3889>`_ - Error when no derived from exists
+*  `SDC-3888 <https://jira.onap.org/browse/SDC-3888>`_ - VSP upload with large files can handle the upload status incorrectly
+*  `SDC-3901 <https://jira.onap.org/browse/SDC-3901>`_ - Cannot create node filter capability if capability has different type properties
+*  `SDC-3901 <https://jira.onap.org/browse/SDC-3907>`_ - Exception when mouse over and out the node pallet in the composition screen
+*  `SDC-3901 <https://jira.onap.org/browse/SDC-3905>`_ - Error updating node filter capability
+*  `SDC-3901 <https://jira.onap.org/browse/SDC-3904>`_ - Error creating node filter capability using get_property
+
+**Tasks**
+
+*  `SDC-3877 <https://jira.onap.org/browse/SDC-3877>`_ - Implement redirecting root url to sdc1
+*  `SDC-3870 <https://jira.onap.org/browse/SDC-3870>`_ - Include new category to NSD generation plugin
+*  `SDC-3880 <https://jira.onap.org/browse/SDC-3880>`_ - Fix SDC-Helm-Validator CSITs
+*  `SDC-3895 <https://jira.onap.org/browse/SDC-3895>`_ - Update vulnerable dependencies
+
+Security Notes
+--------------
+
+*Fixed Security Issues*
+
+    N/A
+
+*Known Security Issues*
+
+*  `OJSI-94 <https://jira.onap.org/browse/OJSI-94>`_ - sdc-wfd-fe allows to impersonate any user by setting USER_ID
+
+*Known Vulnerabilities in Used Modules*
+
+Quick Links:
+
+- `SDC project page <https://wiki.onap.org/pages/viewpage.action?pageId=6592847>`__
+- `Passing Badge information for SDC <https://bestpractices.coreinfrastructure.org/en/projects/1629>`__
+
+**Known Issues**
+
+-   Uploading and on-boarding several VSP in parallel can cause SDC exceptions, a user should retry failed operations which typically succeed on second try.
+
+**Upgrade Notes**
+
+    N/A
+
+**Deprecation Notes**
+
+    N/A
+
+**Other**
+
+    N/A
+
 Version: 1.10.1
 ==============