Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
b84c933
WMS ID#11455 : Use Raft Replication with Distributed Database for Res…
OraGitPush1 Sep 15, 2025
bccc0e3
Merge branch 'main' into main
OraGitPush1 Sep 16, 2025
27fc04c
WMS ID#11455 : manifest.json update for Oracle AI world 2025
OraGitPush1 Sep 16, 2025
4fa7ebb
Merge branch 'oracle-livelabs:main' into main
OraGitPush1 Sep 16, 2025
70aeb84
Merge branch 'oracle-livelabs:main' into main
OraGitPush1 Sep 17, 2025
3cd9df5
Merge branch 'oracle-livelabs:main' into main
OraGitPush1 Sep 24, 2025
530baaf
WMS ID#11455 : Oracle AI world 2025 updates for Raft LiveLabs includi…
OraGitPush1 Sep 24, 2025
c651838
Merge branch 'main' into main
hope-fisher Sep 24, 2025
da26679
Merge branch 'oracle-livelabs:main' into main
OraGitPush1 Oct 14, 2025
d6d2b6d
Merge branch 'oracle-livelabs:main' into main
OraGitPush1 Dec 11, 2025
2f11e3e
Merge branch 'oracle-livelabs:main' into main
OraGitPush1 Feb 27, 2026
47a4159
Merge branch 'oracle-livelabs:main' into main
OraGitPush1 Mar 13, 2026
e3d57b2
WMS ID#11455 : GDD Raft Replication LiveLabs updates from 23ai to 26ai
OraGitPush1 Mar 13, 2026
1016e4b
WMS ID#11455: image resize for markdown validations
OraGitPush1 Mar 16, 2026
c36378d
WMS ID#11455 : old video links removed
OraGitPush1 Mar 17, 2026
2a97a27
WMS ID#11455 : GDD Raft Replication LiveLabs updates from 23ai to 26a…
OraGitPush1 Mar 17, 2026
cc55066
WMS ID#11455 : GDD Raft Replication LiveLabs updates from 23ai to 26a…
OraGitPush1 Mar 18, 2026
7aa1d3d
Merge branch 'main' into main
OraGitPush1 Mar 19, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions sharding/raft23ai/cleanup/cleanup.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Data cannot be recovered from destroyed resources.

This lab walks you through the steps to running a Destroy Job

Estimated Time - 5 minutes
Estimated Time: 5 minutes

### Objectives

Expand All @@ -25,7 +25,8 @@ Estimated Time - 5 minutes
1. Login to Oracle cloud

2. Open the navigation menu and click **Developer Services**. Under **Resource Manager**, click **Stacks**.
![stack](./images/stack.png " ")

![stack](./images/stack.png " ")

3. Choose the compartment that you chose in Lab 1 to install your stack (on the left side of the page).

Expand All @@ -51,4 +52,4 @@ You have successfully cleaned up your instance.
## Acknowledgements
* **Authors** - Deeksha Sehgal, Ajay Joshi, Oracle Globally Distributed Database, Product Management
* **Contributors** - Pankaj Chandiramani, Shefali Bhargava, Param Saini, Jyoti Verma
* **Last Updated By/Date** - Ajay Joshi, Oracle Globally Distributed Database, Product Management, September 2025
* **Last Updated By/Date** - Ajay Joshi, Oracle Globally Distributed Database, Product Management, March 2026
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,9 @@ This lab assumes you have:

## Task 1: Verify default browser windows.

1. By default, two browser windows are shown. On the left, "Introduction" About Raft Replication and on the right, "RAFT 23ai LiveLabs Demo: All Customers List" like below:
1. By default, two browser windows are shown. On the left, "Introduction" About Raft Replication and on the right, "Raft Replication LiveLabs Demo: All Customers List" like below:

![default_windows_raft_livelabs](images/default_windows_raft_livelabs.png " ")
![default_windows_raft_livelabs](images/default_windows_raft_livelabs.png " ")

You can skip the below stpes if both browser windows are shown.

Expand All @@ -46,7 +46,7 @@ This lab assumes you have:
- Three Oracle shard Database containers
- Appclient Container

2. Click on Activities (shown on top left) >> Terminal icon (shown on center of the screen which is next to Chrome icon) to Launch the Terminal when its not already opened. Proceed as indicated below to validate the services.
2. Click on Activities (shown on top left) >> Terminal icon (shown on center of the screen which is next to Chrome icon) to Launch the Terminal when its not already opened. Proceed as indicated below to validate the services.

- Oracle Sharding container Details

Expand Down Expand Up @@ -83,4 +83,4 @@ You may now proceed to the next lab.
## Acknowledgements
* **Authors** - Deeksha Sehgal, Ajay Joshi, Oracle Globally Distributed Database, Product Management
* **Contributors** - Pankaj Chandiramani, Shefali Bhargava, Param Saini, Jyoti Verma
* **Last Updated By/Date** - Ajay Joshi, Oracle Globally Distributed Database, Product Management, September 2025
* **Last Updated By/Date** - Ajay Joshi, Oracle Globally Distributed Database, Product Management, March 2026
5 changes: 2 additions & 3 deletions sharding/raft23ai/intro/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,6 @@ Raft replication is integrated with transaction execution and is completely tran

![Raft introduction](images/raft-intro.png " ")

[Introduction and verify Lab environment](videohub:1_c5e1jhps)

### Objectives
In this workshop, you will gain first-hand experience in utilizing the Raft Replication within Oracle Globally Distributed Database, enabling participants to manage Raft-enabled replication for robust distributed database solutions.
Expand All @@ -22,7 +21,7 @@ Once you complete your setup, the next lab will cover:
- Exploring the dynamics of Raft
- Testing the use-cases

We will use Podman containers, RAFT UI App and demonstrate multiple use cases.
We will use Podman containers, Raft UI App and demonstrate multiple use cases.

### Prerequisites
- An Oracle Cloud Account - Please view this workshop's LiveLabs landing page to see which environments are supported
Expand All @@ -36,4 +35,4 @@ You may now proceed to the next lab.
## Acknowledgements
* **Authors** - Deeksha Sehgal, Ajay Joshi, Oracle Globally Distributed Database, Product Management
* **Contributors** - Pankaj Chandiramani, Shefali Bhargava, Param Saini, Jyoti Verma
* **Last Updated By/Date** - Ajay Joshi, Oracle Globally Distributed Database, Product Management, September 2025
* **Last Updated By/Date** - Ajay Joshi, Oracle Globally Distributed Database, Product Management, March 2026
8 changes: 4 additions & 4 deletions sharding/raft23ai/prepare-setup/prepare-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,12 +58,12 @@ You may now proceed to the next lab.
## Rate this Workshop
When you are finished don't forget to rate this workshop! We rely on this feedback to help us improve and refine our LiveLabs catalog. Follow the steps to submit your rating.

1. Go back to your **workshop homepage** in LiveLabs by searching for your workshop and clicking the Launch button.
2. Click on the **Brown Button** to re-access the workshop
1. Go back to your **workshop homepage** in LiveLabs by searching for your workshop and clicking the Launch button.
2. Click on the **Brown Button** to re-access the workshop

![workshop homepage](https://oracle-livelabs.github.io/common/labs/cloud-login/images/workshop-homepage-2.png " ")

3. Click **Rate this workshop**
3. Click **Rate this workshop**

![rate this workshop](https://oracle-livelabs.github.io/common/labs/cloud-login/images/rate-this-workshop.png " ")

Expand All @@ -72,4 +72,4 @@ If you selected the **Green Button** for this workshop and still have an active
## Acknowledgements
* **Authors** - Deeksha Sehgal, Ajay Joshi, Oracle Globally Distributed Database, Product Management
* **Contributors** - Pankaj Chandiramani, Shefali Bhargava, Param Saini, Jyoti Verma
* **Last Updated By/Date** - Ajay Joshi, Oracle Globally Distributed Database, Product Management, September 2025
* **Last Updated By/Date** - Ajay Joshi, Oracle Globally Distributed Database, Product Management, March 2026
Binary file modified sharding/raft23ai/topology/images/t1-podman-containers-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified sharding/raft23ai/topology/images/t2-3-config-chunks-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified sharding/raft23ai/topology/images/t2-4-status-ru-chunks.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified sharding/raft23ai/topology/images/t4-3-appclient-container.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified sharding/raft23ai/topology/images/t4-5-workload-log-index.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified sharding/raft23ai/topology/images/t5-1-podman-containers.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
35 changes: 19 additions & 16 deletions sharding/raft23ai/topology/topology.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ Oracle Globally Distributed Database provides built-in fault tolerance with Raft

The Raft replication feature creates smaller replication units and distributes them automatically among the shards to handle chunk assignment, chunk movement, workload distribution, and balancing upon scaling (addition or removal of shards), including planned or unplanned shard availability changes.

Raft replication provides a consensus-based, high-performance, low-overhead availability solution, with distributed replicas and fast failover with zero data loss, while automatically maintaining the replication factor if shards fail. With Raft replication management overhead does not increase with the number of shards.
Raft replication provides a consensus, high-performance, low-overhead availability solution, with distributed replicas and fast failover with zero data loss, while automatically maintaining the replication factor if shards fail. With Raft replication management overhead does not increase with the number of shards.

This workshop is configured with a custom image having all the required podman containers for Oracle Globally Distributed Database using 23ai RDBMS and GSM Images.
This workshop is configured with a custom image having all the required podman containers for Oracle Globally Distributed AI Database using RDBMS and GSM Images.

In this workshop, we attempt to use minimal resources to show the demonstration, and in the process we chose a single compute instance to install all of the Oracle Globally Distributed Database components and appclient.

Expand Down Expand Up @@ -47,7 +47,7 @@ This lab assumes you have:

![<podman_containers>](./images/t1-podman-containers-1.png " ")

From top left corner of the Terminal, Click on the "File" and choose first option "New Tab" to open a new tab on the same terminal window:
From top left corner of the Terminal, Click on the "File" and choose first option "New Tab" to open a new tab on the same terminal window:

![<click_file_new_tab_from_top_left_terminal_window>](./images/click_file_new_tab_from_top_left_terminal_window.png " ")

Expand Down Expand Up @@ -183,9 +183,9 @@ The -shard option makes the replication unit member on the specified shard datab
<copy>
gdsctl ru -sort
</copy>
```
![<ru_leader_sort_after_change>](./images/t3-6-ru-sort-after-leader-change.png " ")
```

![<ru_leader_sort_after_change>](./images/t3-6-ru-sort-after-leader-change.png " ")


## Task 4: Run the workload
Expand Down Expand Up @@ -223,8 +223,7 @@ Please use the below steps to run the workload using the "app_schema" account wi

![<t4-4-run-workload_and_ctrl_c>](./images/t4-4-run-workload_and_ctrl_c.png " ")

4. Now check the RU details from terminal's 2nd tab which is switched to **gsm1**.
Notice that for each RU#s, the values is "Log Index" columns are increased due to read and write operations are performed while running the workload.
4. Now check the RU details from terminal's 2nd tab which is switched to **gsm1**. Notice that for each RU#s, the values is "Log Index" columns are increased due to read and write operations are performed while running the workload.

```
<copy>
Expand All @@ -236,10 +235,10 @@ Notice that for each RU#s, the values is "Log Index" columns are increased due t

5. From the browser check the increased value of the count on the demo application ( if not running you can rerun using http://localhost:8080).

![<t4-6-ui-after-workload-increase-count>](./images/t4-6-ui-after-workload-increase-count.png " ")
![<t4-6-ui-after-workload-increase-count>](./images/t4-6-ui-after-workload-increase-count.png " ")


6. You can enter CTRL-C to stop the workload if not already and check the RAFT UI Demo main page to confirm the count is increased. You can also restart this workload as in step 3 and keep running during the next task "Perform Failover Test".
6. You can enter CTRL-C to stop the workload if not already and check the Raft UI Demo main page to confirm the count is increased. You can also restart this workload as in step 3 and keep running during the next task "Perform Failover Test".


## Task 5: Perform Failover Test
Expand All @@ -258,7 +257,7 @@ Failover test by stopping shard1 to create shard1 down situation.
![<podman_containers_status>](./images/t5-1-podman-containers.png " ")


2. Run the below command as **oracle** to stop shard1.
2. Run the below command as **oracle** to stop shard1.

```
<copy>
Expand All @@ -277,14 +276,17 @@ Failover test by stopping shard1 to create shard1 down situation.
</copy>
```

Run below in the terminal window that is switched to **gsm1** and check the status of shards, RU's and you will see that database orcl1cdb_orcl1pdb is not present.
Run below in the terminal window that is switched to **gsm1** and check the status of shards, RU's and you will see that database orcl1cdb_orcl1pdb is not present.

```
<copy>
gdsctl config shard
</copy>
```

![<t5-config-shard-after-stop-shard1>](./images/t5-config-shard-after-stop-shard1.png " ")


```
<copy>
gdsctl status ru -show_chunks
Expand All @@ -293,17 +295,17 @@ Failover test by stopping shard1 to create shard1 down situation.

![<chunk_status_after_shard1_down>](./images/t5-3-status-chunks-after-shard1-down.png " ")

You can verify that shard1 down situation has no impact on either the demo ui application or running the workload.
Refresh "Raft Replication Demo: All Customers List" page and you can verify that shard1 down situation has no impact.
Similarly running the workload has no impact when shard1 is down.

4. On a terminal window logged in as **oracle**.
Start the shard1 using the podman start command, to reflect that shard1 is joining back.
4. On a terminal window logged in as **oracle**. Start the shard1 using the podman start command, to reflect that shard1 is joining back.

```
<copy>
sudo podman start shard1
</copy>
```

![<start_shard1>](./images/t5-4-startup-shard1.png " ")


Expand All @@ -314,6 +316,7 @@ Start the shard1 using the podman start command, to reflect that shard1 is joini
gdsctl config shard
</copy>
```
![<t5-config-shard-after-start-shard1>](./images/t5-config-shard-after-start-shard1.png " ")

```
<copy>
Expand Down Expand Up @@ -348,4 +351,4 @@ You may now proceed to the next lab.
## Acknowledgements
* **Authors** - Deeksha Sehgal, Ajay Joshi, Oracle Globally Distributed Database, Product Management
* **Contributors** - Pankaj Chandiramani, Shefali Bhargava, Param Saini, Jyoti Verma
* **Last Updated By/Date** - Ajay Joshi, Oracle Globally Distributed Database, Product Management, September 2025
* **Last Updated By/Date** - Ajay Joshi, Oracle Globally Distributed Database, Product Management, March 2026
Loading
Loading