Doc updates (#903)

Doc updates

Author: andytael

docs-source/spring/content/_index.md

@@ -4,13 +4,11 @@ description: "Spring and Spring Boot"
 keywords: "spring springboot microservices development oracle backend"
 ---
 
-Oracle Backend for Spring Boot and Microservices allows developers to build microservices in Spring Boot and provisions a "backend as a service" with
-Oracle Database and other infrastructure components that operate on multiple clouds. Oracle Backend for Spring Boot and Microservices vastly simplifies the task of
-building, testing, and operating microservices platforms for reliable, secure, and scalable enterprise applications.
+Oracle Backend for Spring Boot and Microservices allows developers to build microservices in Spring Boot and provisions a "backend as a service" with Oracle Database and other infrastructure components that operate on multiple clouds. Oracle Backend for Spring Boot and Microservices vastly simplifies the task of building, testing, and operating microservices platforms for reliable, secure, and scalable enterprise applications.
 
  
-{{< hint type=[warning] icon=gdoc_fire title="Version 1.1.3 (production) released March, 2024" >}}
- Oracle Backend for Spring Boot and Microservices Version 1.1.3 is now generally available and suitable for production use.  This version supports and recommends Spring Boot 3.2.x, Spring 6.1 and Spring Cloud 2023.0.0, with limited backwards compatibility for Spring Boot 2.7.x.  
+{{< hint type=[warning] icon=gdoc_fire title="Version 1.2.0 (production) released June, 2024" >}}
+ Oracle Backend for Spring Boot and Microservices Version 1.2.0 is now generally available and suitable for production use. This version supports and recommends Spring Boot 3.2.x, Spring 6.1 and Spring Cloud 2023.0.x, with limited backwards compatibility for Spring Boot 2.7.x.  
 {{< /hint >}}
 &nbsp;
 
@@ -37,7 +35,6 @@ Infrastructure (OCI) Container Engine for Kubernetes cluster (OKE cluster):
 - [Oracle Database Operator for Kubernetes (OraOperator or the operator)](https://github.com/oracle/oracle-database-operator)
 - Oracle Database Observability Exporter
 - [Oracle Transaction Manager for Microservices (MicroTx)](platform/microtx/)
-- Parse and Parse Dashboard (Optional)
 - [Prometheus](observability/metrics/)
 - Promtail
 - [Spring Boot Admin dashboard](platform/spring-admin/)
@@ -83,10 +80,3 @@ In the [CloudBank](https://bit.ly/CloudBankOnOBaaS) hands-on lab, you can learn
 We'd love to hear from you!  You can contact us in the
 [#oracle-db-microservices](https://oracledevs.slack.com/archives/C06L9CDGR6Z) channel in the
 Oracle Developers slack workspace, or [open an issue in GitHub](https://github.com/oracle/microservices-datadriven/issues/new).
-
-&nbsp;
-{{< hint type=[warning] icon=gdoc_fire title="Interested in Mobile or web apps too?" >}}
-Check out [Oracle Backend for Parse Platform](https://oracle.github.io/microservices-datadriven/mbaas/) - our "MERN"
-stack for Oracle Database!  Available as an optional component in Oracle Backend for Spring Boot and Microservices.
-{{< /hint >}}
-&nbsp;

docs-source/spring/content/development/project.md

@@ -8,9 +8,9 @@ To take advantage of the built-in platform services, Oracle recommends using the
 
 Recommended versions:
 
-* Spring Boot 3.2.x
+* Spring Boot 3.3.x
 * Spring Cloud 2023.x.x
-* Java 17 or 21
+* Java 21 (or 17)
 
 Table of Contents:
 
@@ -29,9 +29,9 @@ Oracle recommends adding the following dependencies to your application so that
 ```xml
 <properties>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    <java.version>17</java.version>
-    <spring.boot.dependencies.version>3.2.1</spring.boot.dependencies.version>
-    <spring-cloud.version>2023.0.0</spring-cloud.version>
+    <java.version>21</java.version>
+    <spring.boot.dependencies.version>3.3.1</spring.boot.dependencies.version>
+    <spring-cloud.version>2023.0.2</spring-cloud.version>
 </properties>
 
 <dependencies>
@@ -167,7 +167,7 @@ If you are using Liquibase to manage your database schema and data, then you sho
 
 ```xml
 <properties>
-    <liquibase.version>4.25.1</liquibase.version>
+    <liquibase.version>4.28.0</liquibase.version>
 </properties>
 
 <dependencies>
@@ -200,8 +200,8 @@ If you are using Oracle Transaction Manager for Microservices (MicroTx) to manag
 ```xml
 <dependency>
     <groupId>com.oracle.microtx.lra</groupId>
-    <artifactId>microtx-lra-spring-boot-starter-3x</artifactId>
-    <version>23.4.1</version>
+    <artifactId>microtx-lra-spring-boot-starter</artifactId>
+    <version>24.2.1</version>
 </dependency>
 ```
 
@@ -296,6 +296,6 @@ To get tracing for the database calls you need to add the following dependency t
 <dependency>
     <groupId>net.ttddyy.observation</groupId>
     <artifactId>datasource-micrometer-spring-boot</artifactId>
-    <version>$1.0.2</version>
+    <version>1.0.3</version>
 </dependency>
 ```

docs-source/spring/content/getting-started/_index.md

@@ -4,12 +4,11 @@ description: "Get started with Oracle Backend for Spring Boot and Microservices"
 keywords: "spring springboot microservices demos videos samples cloudbank development oracle backend"
 ---
 
-There are a number of demonstrations (videos) and hands-on labs (Live Lab) that show how to use Oracle Backend for Spring Boot and Microservices (Spring Boot) and
-Oracle Backend for Parse Platform (Parse Platform).
+There are a number of demonstrations (videos) and hands-on labs (Live Lab) that show how to use Oracle Backend for Spring Boot and Microservices (Spring Boot).
 
 ## Prerequisites
 
-* [Deployed Oracle Backend for Spring Boot and Microservices](../setup/) (and Parse Platform)
+* [Deployed Oracle Backend for Spring Boot and Microservices](../setup/).
 
 ## Introduction Video
 
@@ -30,14 +29,13 @@ Watch this video for more information.
 [In this workshop (~ 2 hours)](https://bit.ly/CloudBankOnOBaaS), you learn how to build Microservices using Spring Boot and deploy
 them to the Oracle Backend for Spring Boot and Microservices. You learn about accessing the database using the Java Persistence API (JPA), service
 discovery, exposing services with the API Gateway, managing transactions across Microservices, workflow, and using observability tools
-to monitor your services and diagnose issues. You also learn about building a web and mobile user interface for your services using
-Flutter and Parse Platform.
+to monitor your services and diagnose issues.
 
 If you have already deployed Oracle Backend for Spring Boot and Microservices, you can skip Lab 1 (Provision an Instance).
 
 ## More Learning
 
-There are more channels to learn about Oracle Backend for Spring Boot and Microservices (and Parse Platform):
+There are more channels to learn about Oracle Backend for Spring Boot and Microservices:
 
 * [Check out our blogs](../blogs/)
 * [Join our Youtube Channel](https://bit.ly/convergeddatabase)

docs-source/spring/content/release-notes/_index.md

@@ -12,6 +12,7 @@ This release includes:
 * Spring Boot upgrade to 3.3.0 and Spring Cloud 2023.0.2 for internal components.
 * Oracle Backend for Spring Boot and Microservices are running Java 21 with Virtual Threads enabled.
 * oractl is compiled using Java 21 and Virtual Threads.
+* Openshift support
 
 The following components were updated:
 
@@ -37,7 +38,7 @@ The following components were updated:
 | HashiCorp Vault | 1.16.1 | 1.15.2 |
 
 {{< hint type=[warning] icon=gdoc_fire title="Deprecation Notice" >}}
-The following components are deprecated and will be removed in a future release:
+The following components are deprecated and are removed from this release:
 
 * Oracle Database Storage Adapter for Parse
 * Parse Server

docs-source/spring/content/setup/_index.md

@@ -54,9 +54,6 @@ resources:
   - name: oci-stack-byodb-options
     src: "oci-stack-byodb-options.png"
     title: "Bring your Own Database Options - Standard Edition"
-  - name: oci-stack-parse-options
-    src: "oci-stack-parse-options.png"
-    title: "Parse Server Options"
   - name: oci-stack-app-name
     src: "oci-stack-app-name.png"
     title: "Compartment, Application and Edition"
@@ -116,6 +113,93 @@ You must meet the following prerequisites to use Oracle Backend for Spring Boot
   - Oracle Backend for Spring Boot and Microservices command-line interface (oractl). [Download oractl](https://github.com/oracle/microservices-datadriven/releases).
   - [OPTIONAL]Oracle Backend for Spring Boot and Microservices VS Code Extension. [Download VS Code Extension](https://github.com/oracle/microservices-datadriven/releases).
 
+## OCI policies
+
+The following policies needs to be in place to be able to install Oracle Backend for Spring Boot and Microservices. Top level and their dependencies listed.
+
+### Oracle Container Engine for Kubernetes
+
+```text
+Allow group `<group-name>` to manage cluster-family in `<location>`
+├── Allow group `<group-name>` to inspect compartments in `<location>`
+├── Allow group `<group-name>` to read virtual-network-family in `<location>`
+├── Allow group `<group-name>` to use network-security-groups in `<location>`
+├── Allow group `<group-name>` to use private-ips in `<location>`
+├── Allow group `<group-name>` to use subnets in `<location>`
+├── Allow group `<group-name>` to use vnics in `<location>`
+├── Allow group `<group-name>` to manage cluster-node-pools in `<location>`
+├── Allow group `<group-name>` to manage instance-family in `<location>`
+└── Allow group `<group-name>` to manage public-ips in `<location>`
+```
+
+### VCN
+
+```text
+Allow group `<group-name>` to manage vcns in `<location>`
+├── Allow group `<group-name>` to manage route-tables in `<location>`
+├── Allow group `<group-name>` to manage-security-lists in `<location>`
+├── Allow group `<group-name>` to manage-dhcp-options in `<location>`
+
+
+Allow group `<group-name>` to manage vcns in `<location>`
+Allow group `<group-name>` to manage route-tables in `<location>`
+Allow group `<group-name>` to manage security-lists in `<location>`
+Allow group `<group-name>` to manage dhcp-options in `<location>`
+Allow group `<group-name>` to manage nat-gateways in `<location>`
+Allow group `<group-name>` to manage service-gateways in `<location>`
+Allow group `<group-name>` to manage network-security-groups in `<location>`
+Allow group `<group-name>` to manage subnets in `<location>`
+```
+
+### Container Registry
+
+```text
+Allow group `<group-name>` to manage repos in `<location>`
+```
+
+### Object Storage
+
+```text
+Allow group `<group-name>` to read objectstorage-namespaces in `<location>`
+Allow group `<group-name>` to manage objects in `<location>`
+└── Allow group `<group-name>` to manage buckets in `<location>`
+```
+
+### Autonomous Database
+
+```text
+Allow group `<group-name>` to manage autonomous-database-family in `<location>`
+```
+
+### Vault
+
+If you deploy Oracle Backend for Spring Boot and Microservices **STANDARD** edition you need the following policies.
+
+```text
+Allow group `<group-name>` to manage vaults in `<location>`
+Allow group `<group-name>` to manage keys in `<location>`
+```
+
+#### Additional Vault
+
+To allow Container Engine for Kubernetes to access Vault via Groups:
+
+```text
+Allow group `<group-name>` to manage policies in `<location>`
+Allow group `<group-name>` to manage tag-namespaces in `<location>`
+Allow group `<group-name>` to manage dynamic-groups in `<location>`
+Allow group `<group-name>` to manage secret-family in `<location>`
+```
+
+### Oracle Resource Manager
+
+```text
+Allow group `<group-name>` to read orm-template in `<location>`
+Allow group `<group-name>` to use orm-stacks in `<location>`
+└── Allow group `<group-name>` to manage orm-jobs in `<location>`
+Allow group `<group-name>` to manage orm-private-endpoints in `<location>`
+```
+
 ## Summary of Components
 
 Oracle Backend for Spring Boot and Microservices setup installs the following components:
@@ -137,10 +221,7 @@ Oracle Backend for Spring Boot and Microservices setup installs the following co
 | OpenTelemetry Collector      | 0.101.0        | Collects process and export telemetry data.                                                 |
 | Oracle Database Observability Exporter | 1.2.1 | Exposes Oracle Database metrics in standard Prometheus format.                            |
 | Oracle Database Operator     | 1.0           | Helps reduce the time and complexity of deploying and managing Oracle databases.            |
-| Oracle Database storage adapter for Parse  (optional) | 1.0.0    | Enables the Parse Server to store data in Oracle Database.              |
 | Oracle Transaction Manager for Microservices | 23.4.2 | Manages distributed transactions to ensure consistency across Microservices.       |
-| Parse Server (optional)      | 6.3.0         | Provides backend services for mobile and web applications.                                  |
-| Parse Dashboard (optional)   | 5.2.0         | Provides web user interface for managing the Parse Server.                                  |
 | Prometheus                   | 2.52.0        | Provides event monitoring and alerts.                                                       |
 | Prometheus Operator          | 0.74.0        | Provides management for Prometheus monitoring tools.                                        |
 | Promtail                     | 2.8.2     | Collects logs.                       |
@@ -189,27 +270,15 @@ To set up the OCI environment, process these steps:
 
       **WARNING:** Deletion or expiration of the token will result in the failure to pull images later.  Also you must have one free OCI auth token (note that the maximum is two per user). You can *NOT* use someone elses token.
 
-    | Edition   | Parse Platform | BYO Network  | BYO Database     | Production Vault | Registry Scanning |
-    |-----------|----------------|--------------|------------------|------------------| ------------------|
-    | Community | x              |              |                  |                  |                   |
-    | Standard  | x              | x            | x                | x                | x                 |
+    | Edition   | BYO Network  | BYO Database     | Production Vault | Registry Scanning |
+    |-----------|--------------|------------------|------------------| ------------------|
+    | Community |              |                  |                  |                   |
+    | Standard  | x            | x                | x                | x                 |
 
     <!-- spellchecker-disable -->
     {{< img name="oci-stack-app-name" size="large" lazy=false >}}
     <!-- spellchecker-enable -->
 
-1. If you check the checkbox *Enable Parse Platform* in the **Parse Server** section a Parse Server will be installed. Fill in the following for the Parse Server:
-
-   - `Application ID` (optional) : Leave blank to auto-generate.
-   - `Server Master Key` (optional) : Leave blank to auto-generate.
-   - `Dashboard Username` : The user name of the user to whom access to the dashboard is granted.
-   - `Dashboard Password` (optional) : The password of the dashboard user (a minimum of 12 characters). Leave blank to auto-generate.
-   - `Enable Parse S3 Storage` : Check the checkbox to enable Parse Server S3 Adaptor and create a S3 compatible Object Storage Bucket.
-
-     <!-- spellchecker-disable -->
-     {{< img name="oci-stack-parse-options" size="large" lazy=false >}}
-     <!-- spellchecker-enable -->
-
 1. If you check the checkbox *Set Administrator Passwords* in the **Administrator Passwords** section you have the option to fill in the following passwords (if not they are autogenerated):
 
    - `APISIX Administrator Password` (optional) : Leave blank to auto-generate.