Merge pull request #2739 from oracle-devrel/arch-coe-initial-fsdr-content

ver. 0.1

Author: oheimburger

cloud-architecture/architecture-coe/fsdr/README.md

@@ -0,0 +1,25 @@
+# Full Stack Disaster Recovery
+
+Full Stack Disaster Recovery is an Oracle Cloud Infrastructure (OCI) disaster recovery orchestration and management service that provides comprehensive disaster recovery capabilities for all layers of an application stack, including infrastructure, middleware, database, and application.
+
+Using OCI Full Stack DR provides a single pane of glass monitoring and management capability for all disaster recovery needs. Full stack disaster recovery easily integrates Oracle platforms and non-Oracle applications and provides recovery for the entire application stack, instead of recovery of individual components, such as databases or compute instances.
+
+Reviewed: 26.11.2025
+
+# Useful Links
+
+- [Move a virtual machine between OCI regions using Full Stack Disaster Recovery](https://docs.oracle.com/en/learn/full-stack-dr-to-move-vm/)
+    - To move a compute VM that has just a boot volume attached to it from one region to another region using Full Stack Disaster Recovery.
+- [Automate Disaster Recovery switchover and failover operations for Oracle WebLogic Server with OCI Full Stack Disaster Recovery](https://docs.oracle.com/en/learn/full-stack-dr-integration-weblogic/)
+    - To automate Disaster Recovery Switchover and Failover operations of Oracle WebLogic Server using OCI Stack Disaster Recovery.
+- [Documentation: Full Stack Disaster Recovery](https://docs.oracle.com/en-us/iaas/disaster-recovery/index.html)
+- [Oracle WebLogic Server for Oracle Cloud Infrastructure Disaster Recovery](https://www.oracle.com/a/otn/docs/middleware/maa-wls-mp-dr.pdf)
+- [Oracle.com: Full Stack Disaster Recovery](https://www.oracle.com/in/cloud/full-stack-disaster-recovery/)
+
+# License
+
+Copyright (c) 2026 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-architecture/architecture-coe/fsdr/assets/evaluate-rpo/LICENSE

@@ -0,0 +1,35 @@
+Copyright (c) 2026 Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cloud-architecture/architecture-coe/fsdr/assets/evaluate-rpo/README.md

@@ -0,0 +1,112 @@
+# evaluate-pg-rpo.py
+
+RPO Estimation for a FSDR Protection Group
+
+Reviewed: 24.03.2026
+
+# When to use this asset?
+
+It can be used to roughly estimate the global RPO of a _FSDR Protection Group_ and as an example on how
+use the Python SDK and OCI API to get the replication metrics of some services.
+
+# How to use this asset?
+
+This is a simple Python script that can be used just passing the FSDR Protection Group ID and having access to the
+Primary and Secondary region.
+
+# Disclaimer 
+
+This is program is just meant as an example on how to collect replication information from the FSDR PG underlying services. The 
+evaluate RPO is not to consider an indication on a _real RPO_ which depends on multiple factors and which should be always 
+evaluated taking into account the workload characteristics and the application behavior.   
+
+# Overview
+
+FSDR is DR coordinator and orchestrator service and it doesn't influence its Protection Groups RPO in any way. 
+The PG RPO depends only on the underline services and their replication methods. That said, this python script 
+allows to evaluate the _maximum RPO_ of the group using the exposed replication metrics of its services.
+
+# Prerequisites 
+
+You'll need Python3 and the following packages:
+
+- OCI module
+- PyYAML module
+
+
+For example, on Linux or MacOS, using a virtual environment configured with _pyenv_: 
+
+```sh
+pyenv shell 3.14.2 
+pip install OCI
+pip install PyYAML
+```
+
+# Currently Supported Services
+
+Currently, the script supports the following resources in the protection group:
+
+- Movable Virtual Machine
+- Block Volume Group
+- File System Service
+- Object Storage Buckets
+- Base DB System
+- Autonomous Database
+- OKE Cluster 
+
+# Usage 
+
+The script -h flag shows the usage options: 
+
+```sh
+./evaluate_pg_rpo.py -h
+usage: evaluate_pg_rpo [-h] [-p PROTECTION_GROUP_ID] [-r REGION] [-t] [-c CONFIGURATION_FILE] [-d] [-v]
+
+Evaluate the RPO of a FSDR Protection Group.
+
+options:
+  -h, --help            show this help message and exit
+  -p, --protection_group_id PROTECTION_GROUP_ID
+  -r, --region REGION
+  -t, --tagging         Tagging flag, when enabled write the RPO in a free-form tag on the PG. Defaulting to no
+                        tagging.
+  -c, --configuration_file CONFIGURATION_FILE
+                        OCI configuration file, defaulting to ~/.oci/config. If the string "none" is provided, instance principal
+                        authentication is used.
+  -d, --debug           Debug flag, defaulting to no debug
+  -v, --version         Shows version.
+  ```
+
+
+# Output Example
+
+```sh
+ python3 ./evaluate-pg-rpo.py -p ocid1.drprotectiongroup.oc1.eu-milan-1.<hidden>
+
+Components RPO:
+-------- Type --------   -------- Name --------   --- RPO (sec) ---
+OBJECT_STORAGE_BUCKET    mushop-media-cris           108
+OBJECT_STORAGE_BUCKET    mushop-cris                 108
+VOLUME_GROUP             mushop-vg                   173
+AUTONOMOUS_DATABASE      MuShopDB-cris                60
+
+Protection Group RPO:
+Global RPO            :    173 sec
+Component driving RPO : VOLUME_GROUP
+```
+
+# Useful Links
+
+- [FSDR Documentation](https://docs.oracle.com/en-us/iaas/disaster-recovery/index.html)
+- [OCI Python SDK](https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/pythonsdk.htm)
+- [pyenv util](https://github.com/pyenv/pyenv)
+- [PyYAML Module](https://pypi.org/project/PyYAML/)
+
+
+# License
+
+Copyright (c) 2026 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE.txt) for more details.