You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: OracleDatabase/RAC/OracleRealApplicationClusters/README.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,17 +39,17 @@ Before you proceed to the next section, you must complete each of the steps list
39
39
40
40
* Refer to the following sections in the publication [Oracle Real Application Clusters Installation Guide](https://docs.oracle.com/cd/F39414_01/racpd/oracle-real-application-clusters-installation-guide-podman-oracle-linux-x86-64.pdf) for Podman Oracle Linux x86-64 to complete the preparation steps for Oracle RAC on Container deployment:
41
41
42
-
* Overview of Oracle RAC on Podman
43
-
* Host Preparation for Oracle RAC on Podman
44
-
* Podman Host Server Configuration
45
-
***Note**: As we are following command line installation for Oracle RAC on containers, we don't need X Window System to be configured.
46
-
* Podman Containers and Oracle RAC Nodes
47
-
* Provisioning the Podman Host Server
48
-
* Podman Host Preparation
49
-
* Preparing for Podman Container Installation
50
-
* Installing Podman Engine
51
-
* Allocate Linux Resources for Oracle Grid Infrastructure Deployment
52
-
* How to Configure Podman for SELinux Mode
42
+
* Overview of Oracle RAC on Podman
43
+
* Host Preparation for Oracle RAC on Podman
44
+
* Podman Host Server Configuration
45
+
***Note**: As we are following command line installation for Oracle RAC on containers, we don't need X Window System to be configured.
46
+
* Podman Containers and Oracle RAC Nodes
47
+
* Provisioning the Podman Host Server
48
+
* Podman Host Preparation
49
+
* Preparing for Podman Container Installation
50
+
* Installing Podman Engine
51
+
* Allocate Linux Resources for Oracle Grid Infrastructure Deployment
52
+
* How to Configure Podman for SELinux Mode
53
53
* Install `git` from dnf or yum repository and clone the git repo. We clone this repo on a path called `<GITHUB_REPO_CLONED_PATH>` and refer here.
54
54
* Create a NFS Volume if you are planning to use NFS Storage for ASM Devices. See [Configuring NFS for Storage for Oracle RAC on Podman](https://docs.oracle.com/cd/F39414_01/racpd/oracle-real-application-clusters-installation-guide-podman-oracle-linux-x86-64.pdf) for more details. **Note:** You can skip this step if you are planning to use block devices for storage.
55
55
* If SELinux is enabled on the Podman host, then ensure to create an SELinux policy for Oracle RAC on Podman. For details about this procedure, see `How to Configure Podman for SELinux Mode` in the publication [Oracle Real Application Clusters Installation Guide for Podman Oracle Linux x86-64](https://docs.oracle.com/en/database/oracle/oracle-database/21/racpd/target-configuration-oracle-rac-podman.html#GUID-59138DF8-3781-4033-A38F-E0466884D008). Also, When you are performing the installation using any files from podman host machine where SELinux is enabled, you need to make sure they are labeled correctly with `container_file_t` context. You can use `ls -lZ <file_name/<Directory_name>` to see the security context set on files.
Copy file name to clipboardExpand all lines: OracleDatabase/RAC/OracleRealApplicationClusters/docs/developers/OTHERS.md
+55-54Lines changed: 55 additions & 54 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,14 +4,16 @@ Learn about container deployment options for Oracle Real Application Clusters (O
4
4
5
5
## Overview of Running Oracle RAC in Containers
6
6
7
-
Oracle Real Application Clusters (Oracle RAC) is an option for the award-winning Oracle Database Enterprise Edition. Oracle RAC is a cluster database with a shared cache architecture that overcomes the limitations of traditional shared-nothing and shared-disk approaches to provide highly scalable and available database solutions for all business applications. Oracle RAC uses Oracle Clusterware as a portable cluster software that allows clustering of independent servers so that they cooperate as a single system, and Oracle Automatic Storage Management (Oracle ASM) to provide simplified storage management that is consistent across all servers and storage platforms. Oracle Clusterware and Oracle ASM are part of the Oracle Grid Infrastructure, which bundles both solutions in an easy-to-deploy software package. For more information on Oracle RAC Database 21c, refer to the [Oracle Database documentation](http://docs.oracle.com/en/database/).
7
+
Oracle Real Application Clusters (Oracle RAC) is an option for the award-winning Oracle Database Enterprise Edition. Oracle RAC is a cluster database with a shared cache architecture that overcomes the limitations of traditional shared-nothing and shared-disk approaches to provide highly scalable and available database solutions for all business applications. Oracle RAC uses Oracle Clusterware as a portable cluster software that allows clustering of independent servers so that they cooperate as a single system, and Oracle Automatic Storage Management (Oracle ASM) to provide simplified storage management that is consistent across all servers and storage platforms. Oracle Clusterware and Oracle ASM are part of the Oracle Grid Infrastructure, which bundles both solutions in an easy-to-deploy software package.
8
8
9
-
This guide helps you install Oracle RAC on Containers on Host Machines as explained in detail below. With the current release, you prepare the host machine, build or use pre-built Oracle RAC Container Images v21.3, and set up Oracle RAC on Single or Multiple Host machines with Oracle ASM. In this installation guide, we use [Podman](https://docs.podman.io/en/v3.0/) to create Oracle RAC Containers and manage them.
9
+
For more information on Oracle RAC Database 21c, refer to the [Oracle Database documentation](http://docs.oracle.com/en/database/).
10
+
11
+
This guide helps you install Oracle RAC on Containers on Host Machines as explained in detail below. With the current release, you prepare the host machine, build or use pre-built Oracle RAC Container Images v21.3, and set up Oracle RAC on Single or Multiple Host machines with Oracle ASM. In this installation guide, we use [Podman](https://docs.podman.io/en/v3.0/) to create Oracle RAC Containers and manage them.
10
12
11
13
## Using this Documentation
12
14
To create an Oracle RAC environment, follow these steps:
13
15
14
-
-[Oracle Real Application Clusters in Linux Containers](#oracle-real-application-clusters-in-linux-containers)
16
+
-[Oracle Real Application Clusters in Linux Containers for Developers](#oracle-real-application-clusters-in-linux-containers-for-developers)
15
17
-[Overview of Running Oracle RAC in Containers](#overview-of-running-oracle-rac-in-containers)
16
18
-[Using this Documentation](#using-this-documentation)
17
19
-[Preparation Steps for Running Oracle RAC in Containers](#preparation-steps-for-running-oracle-rac-database-in-containers)
@@ -35,20 +37,20 @@ To create an Oracle RAC environment, follow these steps:
35
37
36
38
## Preparation Steps for Running Oracle RAC Database in Containers
37
39
38
-
Before you proceed to the next section, you must complete each of the steps listed in this section and complete the following prerequisites.
40
+
Before you proceed to the next section, you must complete each of the steps listed in this section and complete the following prerequisites.
39
41
40
-
* Refer to the following sections in the publication [Oracle Real Application Clusters Installation Guide](https://review.us.oracle.com/review2/Review.html#reviewId=467473;scope=document;status=open,fixed;documentId=4229197) for Podman Oracle Linux x86-64 to complete the preparation steps for Oracle RAC on Container deployment:
42
+
* Refer to the following sections in the publication [Oracle Real Application Clusters Installation Guide](https://docs.oracle.com/cd/F39414_01/racpd/oracle-real-application-clusters-installation-guide-podman-oracle-linux-x86-64.pdf) for Podman Oracle Linux x86-64 to complete the preparation steps for Oracle RAC on Container deployment:
41
43
42
-
* Overview of Oracle RAC on Podman
43
-
* Host Preparation for Oracle RAC on Podman
44
-
* Podman Host Server Configuration
45
-
* Podman Containers and Oracle RAC Nodes
46
-
* Provisioning the Podman Host Server
47
-
* Podman Host Preparation
48
-
* Preparing for Podman Container Installation
49
-
* Installing Podman Engine
50
-
* Allocating Linux Resources for Oracle Grid Infrastructure Deployment
51
-
* How to Configure Podman for SELinux Mode
44
+
* Overview of Oracle RAC on Podman
45
+
* Host Preparation for Oracle RAC on Podman
46
+
* Podman Host Server Configuration
47
+
* Podman Containers and Oracle RAC Nodes
48
+
* Provisioning the Podman Host Server
49
+
* Podman Host Preparation
50
+
* Preparing for Podman Container Installation
51
+
* Installing Podman Engine
52
+
* Allocating Linux Resources for Oracle Grid Infrastructure Deployment
53
+
* How to Configure Podman for SELinux Mode
52
54
* Install `git` from dnf or yum repository and clone the git repo. We clone this repo on a path called `<GITHUB_REPO_CLONED_PATH>` and refer here.
53
55
* If you are planning to use NFS storage for OCR, Voting Disk, and Database files, then configure NFS storage and export at least one NFS mount. You can also use the `<GITHUB_REPO_CLONED_PATH>/docker-images/OracleDatabase/RAC/OracleRACStorageServer` container for the shared file system on NFS. Refer [OracleRACStorageServer](../OracleRACStorageServer/README.md).
54
56
* If SELinux is enabled on the Podman host, you must create an SELinux policy for Oracle RAC on Podman. For details about this procedure, see `How to Configure Podman for SELinux Mode` in the publication [Oracle Real Application Clusters Installation Guide for Podman Oracle Linux x86-64](https://docs.oracle.com/en/database/oracle/oracle-database/21/racpd/target-configuration-oracle-rac-podman.html#GUID-59138DF8-3781-4033-A38F-E0466884D008). Also, when you are performing the installation using any files from a Podman host machine where SELinux is enabled, make sure they are labeled correctly with `container_file_t` context. You can use `ls -lZ <file_name/<Directory_name>` to see the security context set on files.
@@ -57,9 +59,8 @@ Before you proceed to the next section, you must complete each of the steps list
57
59
If you have a preconfigured DNS server in your environment, then you can replace `-e DNS_SERVERS=10.0.20.25`, `--dns=10.0.20.25`, `-e DOMAIN=example.info`, and `--dns-search=example.info` parameters in the examples in this guide with the `DOMAIN_NAME` and `DNS_SERVER` based on your environment.
58
60
59
61
* The Oracle RAC `Containerfile` does not contain any Oracle software binaries. Download the following software from the [Oracle Technology Network](https://www.oracle.com/technetwork/database/enterprise-edition/downloads/index.html), if you are planning to build Oracle RAC Container Images from the next section. However, if you are using pre-built RAC images from the Oracle Container Registry, you can skip this step.
60
-
61
-
- Oracle Grid Infrastructure 21c (21.3) for Linux x86-64
62
-
- Oracle Database 21c (21.3) for Linux x86-64
62
+
- Oracle Grid Infrastructure 21c (21.3) for Linux x86-64
63
+
- Oracle Database 21c (21.3) for Linux x86-64
63
64
64
65
**Notes**
65
66
@@ -74,11 +75,11 @@ Oracle RAC is supported for production use on Podman starting with Oracle Databa
74
75
Example of pulling an Oracle RAC Image from the Oracle Container Registry:
podman tag container-registry.oracle.com/database/rac:21.16-slim localhost/oracle/database-rac:21.3.0-slim
82
83
```
83
84
84
85
If you are using pre-built Oracle RAC images from the Oracle Container Registry, then you can skip the section that follows where we build the container images.
@@ -131,9 +132,9 @@ Example: Building Oracle RAC image for v 21.3.0-
131
132
Before you start the installation, you must plan your private and public network. Refer to section `Podman Host Preparation` in the publication [Oracle Real Application Clusters Installation Guide](#https://review.us.oracle.com/review2/Review.html#reviewId=467473;scope=document;status=open,fixed;documentId=4229197) for Podman Oracle Linux x86-64. You can create a `network bridge` on every container host so containers running within that host can communicate with each other. For example: create `rac_pub1_nw` for the public network (`10.0.20.0/24`) and `rac_priv1_nw` (`192.168.17.0/24`) for a private network. You can use any network subnet for testing. In this document we define the public network on `10.0.20.0/24` and the private network on `192.168.17.0/24`.
- Specify the secret volume for resetting the grid, oracle, and database user password during node creation or node addition. The volume can be a shared volume among all the containers. For example:
160
161
161
-
```bash
162
-
mkdir /opt/.secrets/
163
-
```
162
+
```bash
163
+
mkdir /opt/.secrets/
164
+
```
164
165
- Generate a password file - Edit the `/opt/.secrets/pwdfile.txt` and seed the password for the grid, oracle, and database users. For this deployment scenario, it will be a common password for the grid, oracle, and database users. Run the command:
7eb7f573905283c808bdabaff keysecret file 13 hours ago 13 hours ago
182
-
e3ac963fd736d8bc01dcd44dd pwdsecret file 13 hours ago 13 hours ago
180
+
podman secret ls
181
+
ID NAME DRIVER CREATED UPDATED
182
+
7eb7f573905283c808bdabaff keysecret file 13 hours ago 13 hours ago
183
+
e3ac963fd736d8bc01dcd44dd pwdsecret file 13 hours ago 13 hours ago
183
184
184
-
podman secret inspect <secret_name>
185
-
```
185
+
podman secret inspect <secret_name>
186
+
```
186
187
Notes:
187
188
- In this example we use `pwdsecret` as the common password for SSH setup between containers for the oracle, grid, and Oracle RAC database users. Also, `keysecret` is used to extract secrets inside the Oracle RAC Containers.
188
189
189
190
## Oracle RAC on Containers Deployment Scenarios
190
191
Oracle RAC can be deployed with various scenarios, such as using podman vs podman-compose, NFS vs Block Devices, Oracle RAC Container Image vs Slim Image, with User Defined Response files, and so on. All are covered in detail in the instructions that follow.
191
192
192
193
### Oracle RAC Containers on Podman
193
-
#### [1. Setup Using Oracle RAC Container Image](./rac-container/racimage/README.md)
194
-
#### [2. Setup Using Oracle RAC Container Slim Image](./rac-container/racslimimage/README.md)
194
+
#### [1. Setup Using Oracle RAC Container Image](./rac-container/racimage/README.md)
195
+
#### [2. Setup Using Oracle RAC Container Slim Image](./rac-container/racslimimage/README.md)
195
196
196
197
### Oracle RAC Containers on Podman Compose
197
-
#### [1. Setup Using Oracle RAC Container Image](../samples/rac-compose/racimage/README.md)
198
-
#### [2. Setup Using Oracle RAC Container Slim Image](../samples/rac-compose/racslimimage/README.md)
198
+
#### [1. Setup Using Oracle RAC Container Image](../samples/rac-compose/racimage/README.md)
199
+
#### [2. Setup Using Oracle RAC Container Slim Image](../samples/rac-compose/racslimimage/README.md)
0 commit comments