Skip to content

Commit 2fa66fe

Browse files
s1saurabhs1saurabh
committed
lint fixes
1 parent 28525fc commit 2fa66fe

File tree

2 files changed

+38
-31
lines changed

2 files changed

+38
-31
lines changed

‎OracleDatabase/RAC/OracleRealApplicationClusters/README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,8 @@ Also, When you are performing the installation using any files from podman host
6363
* To resolve VIPs and SCAN IPs in this guide, we use a preconfigured DNS server in our environment.
6464
Replace environment variables `-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 based on your environment.
6565

66-
* 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 next section. However, if you are using pre-built RAC images from the Oracle Container Registry, then you can skip this step.
66+
* 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 next section.
67+
However, if you are using pre-built RAC images from the Oracle Container Registry, then you can skip this step.
6768
- Oracle Grid Infrastructure 21c (21) for Linux x86-64
6869
- Oracle Database 21c (21) for Linux x86-64
6970

‎OracleDatabase/RAC/OracleRealApplicationClusters/docs/README_1.md‎

Lines changed: 36 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,8 @@ Learn about container deployment options for Oracle Real Application Clusters (O
44

55
## Overview of Running Oracle RAC in Containers
66

7-
Oracle Real Application Clusters (Oracle RAC) is an option to 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.
7+
Oracle Real Application Clusters (Oracle RAC) is an option to 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.
8+
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.
89

910
For more information on Oracle RAC Database 21c refer to the [Oracle Database documentation](http://docs.oracle.com/en/database/).
1011

@@ -97,7 +98,9 @@ Complete each of the following prerequisites:
9798
sysctl -p
9899
```
99100

100-
8. To resolve VIPs and SCAN IPs, we are using a DNS container in this guide. Before proceeding to the next step, create a [DNS server container](../OracleDNSServer/README.md). If you have a pre-configured DNS server in your environment, then you can replace `-e DNS_SERVERS=172.16.1.25`, `--dns=172.16.1.25`, `-e DOMAIN=example.com` and `--dns-search=example.com` parameters in **Section 2: Building Oracle RAC Database Podman Install Images** with the `DOMAIN_NAME` and `DNS_SERVER` based on your environment. You must ensure that you have the`Podman-docker` package installed on your OL8 Podman host to run the command using the `docker` utility.
101+
8. To resolve VIPs and SCAN IPs, we are using a DNS container in this guide. Before proceeding to the next step, create a [DNS server container](../OracleDNSServer/README.md).
102+
If you have a pre-configured DNS server in your environment, then you can replace `-e DNS_SERVERS=172.16.1.25`, `--dns=172.16.1.25`, `-e DOMAIN=example.com` and `--dns-search=example.com` parameters in **Section 2: Building Oracle RAC Database Podman Install Images** with the `DOMAIN_NAME` and `DNS_SERVER` based on your environment.
103+
You must ensure that you have the`Podman-docker` package installed on your OL8 Podman host to run the command using the `docker` utility.
101104

102105
9. If you are running RAC on Podman, you need to make sure you have installed the `podman-docker` rpm so that podman commands can be run using `docker` utility.
103106
10. The Oracle RAC `Dockerfile` 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) and stage them under `<GITHUB_REPO_CLONED_PATH>/docker-images/OracleDatabase/RAC/OracleRealApplicationCluster/containerfiles/<VERSION>` folder.
@@ -129,14 +132,14 @@ To assist in building the images, you can use the [`buildContainerImage.sh`](htt
129132
### Oracle RAC Container Image for Docker
130133
If you are planing to deploy Oracle RAC container image on Podman, skip to the section [Oracle RAC Container Image for Podman](#oracle-rac-container-image-for-podman).
131134

132-
```bash
133-
./buildContainerImage.sh -v <Software Version> -o '--build-arg BASE_OL_IMAGE=oraclelinux:7' -i
135+
```bash
136+
./buildContainerImage.sh -v <Software Version> -o '--build-arg BASE_OL_IMAGE=oraclelinux:7' -i
134137

135-
# Example: Building Oracle RAC Docker Image
136-
./buildContainerImage.sh -v 21.3.0 -o '--build-arg BASE_OL_IMAGE=oraclelinux:7' -i
137-
```
138-
***Note***
139-
- `IGNORE_PREREQ` is default `false` while building full image, if you want to skip this during dbca/grid installation or basically set `-ignorePrereq` while building the container image, set this to `true`.
138+
# Example: Building Oracle RAC Docker Image
139+
./buildContainerImage.sh -v 21.3.0 -o '--build-arg BASE_OL_IMAGE=oraclelinux:7' -i
140+
```
141+
***Note***
142+
- `IGNORE_PREREQ` is default `false` while building full image, if you want to skip this during dbca/grid installation or basically set `-ignorePrereq` while building the container image, set this to `true`.
140143

141144
### Oracle RAC Container Image for Podman
142145
If you are planing to deploy Oracle RAC container image on Docker, skip to the section [Oracle RAC Container Image for Docker](#oracle-rac-container-image-for-docker).
@@ -156,7 +159,8 @@ If you are planing to deploy Oracle RAC container image on Docker, skip to the s
156159

157160
## Section 3: Network and Password Management
158161

159-
1. Before you start the installation, you must plan your private and public network. 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 (`172.16.1.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 reference the public network on `172.16.1.0/24` and the private network on `192.168.17.0/24`.
162+
1. Before you start the installation, you must plan your private and public network. You can create a network bridge on every container host so containers running within that host can communicate with each other.
163+
For example, create `rac_pub1_nw` for the public network (`172.16.1.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 reference the public network on `172.16.1.0/24` and the private network on `192.168.17.0/24`.
160164

161165
```bash
162166
# docker network create --driver=bridge --subnet=172.16.1.0/24 rac_pub1_nw
@@ -362,7 +366,7 @@ Now create the Oracle RAC container using the image. You can use the following e
362366
- You must have created the `racstorage` volume before the creation of the Oracle RAC Container. For details, please refer [OracleRACStorageServer](../OracleRACStorageServer/README.md).
363367
- For details about the available environment variables, refer the [Section 7](#section-7-environment-variables-for-the-first-node).
364368

365-
#### Assign networks to Oracle RAC containers
369+
#### Assign networks to Oracle RAC docker containers
366370

367371
You need to assign the Docker networks created in section 1 to containers. Execute the following commands:
368372

@@ -372,7 +376,7 @@ You need to assign the Docker networks created in section 1 to containers. Execu
372376
# docker network connect rac_priv1_nw --ip 192.168.17.150 racnode1
373377
```
374378

375-
#### Start the first container
379+
#### Start the first docker container
376380

377381
To start the first container, run the following command:
378382

@@ -394,7 +398,7 @@ You should see the database creation success message at the end:
394398
####################################
395399
```
396400

397-
#### Connect to the Oracle RAC container
401+
#### Connect to the Oracle RAC docker container
398402

399403
To connect to the container execute the following command:
400404

@@ -406,7 +410,7 @@ If the install fails for any reason, log in to the container using the preceding
406410

407411
### Section 4.3: Adding an Oracle RAC Node using a Docker Container
408412

409-
Before proceeding to the next step, ensure Oracle Grid Infrastructure is running and the Oracle RAC Database is open as per instructions in [Section 4.2: Setup Oracle RAC on Docker](#section-4.2-setup-oracle-rac-on-docker). Otherwise, the node addition process will fail.
413+
Before proceeding to the next step, ensure Oracle Grid Infrastructure is running and the Oracle RAC Database is open as per instructions in [Section 4.2: Setup Oracle RAC on Docker](#section-42-setup-oracle-rac-container-on-docker). Otherwise, the node addition process will fail.
410414

411415
Refer the [Section 3: Network and Password Management](#section-3--network-and-password-management) and setup the network on a container host based on your Oracle RAC environment. If you have already done the setup, ignore and proceed further.
412416

@@ -424,7 +428,7 @@ sh /opt/scripts/startup/resetOSPassword.sh --op_type reset_grid_oracle --pwd_fil
424428

425429
#### Deploying Oracle RAC Additional Node on Container with Block Devices on Docker
426430

427-
If you are using an NFS volume, skip to the section [Deploying Oracle RAC on Container with Oracle RAC Storage Container on Docker](#deploying-oracle-rac-node-2-on-container-with-oracle-rac-storage-container-on-docker).
431+
If you are using an NFS volume, skip to the section [Deploying Oracle RAC on Container with Oracle RAC Storage Container on Docker](#deploying-oracle-rac-on-container-with-oracle-rac-storage-container)
428432

429433
To create additional nodes, use the following command:
430434

@@ -473,7 +477,7 @@ For details of all environment variables and parameters, refer to [Section 7](#s
473477

474478
#### Deploying Oracle RAC Additional Node on Container with Oracle RAC Storage Container on Docker
475479

476-
If you are using physical block devices for shared storage, skip to [Deploying Oracle RAC on Container with Block Devices on Docker](#deploying-oracle-rac-node-2-on-container-with-block-devices-on-docker).
480+
If you are using physical block devices for shared storage, skip to [Deploying Oracle RAC on Container with Block Devices on Docker](#deploying-oracle-rac-on-container-with-block-devices-on-docker)
477481

478482
Use the existing `racstorage:/oradata` volume when creating the additional container using the image.
479483

@@ -524,7 +528,7 @@ For example:
524528
- You must have created **racstorage** volume before the creation of the Oracle RAC container.
525529
- You can change env variables such as IPs and ORACLE_PWD based on your env. For details about the env variables, refer the section 8.
526530

527-
#### Assign Network to additional Oracle RAC container
531+
#### Assign Network to additional Oracle RAC docker container
528532

529533
Connect the private and public networks you created earlier to the container:
530534

@@ -556,7 +560,7 @@ ORACLE RAC DATABASE IS READY TO USE!
556560
####################################
557561
```
558562

559-
#### Connect to the Oracle RAC container
563+
#### Connect to the Oracle RAC container on Additional Node
560564

561565
To connect to the container execute the following command:
562566

@@ -684,7 +688,7 @@ Now create the Oracle RAC container using the image. For the details of environm
684688

685689
#### Deploying Oracle RAC on Container With Oracle RAC Storage Container on Podman
686690

687-
If you are using block devices, skip to the section [Deploying RAC Containers with Block Devices on Podman](#deploying-rac-containers-with-block-devices-on-podman).
691+
If you are using block devices, skip to the section [Deploying RAC Containers with Block Devices on Podman](#deploying-oracle-rac-containers-with-block-devices-on-podman)
688692
Now create the Oracle RAC container using the image. You can use the following example to create a container:
689693

690694
```bash
@@ -732,7 +736,7 @@ Now create the Oracle RAC container using the image. You can use the following
732736
- Change environment variables such as `NODE_IP`, `PRIV_IP`, `PUBLIC_IP`, `ASM_DEVICE_LIST`, `PWD_FILE`, and `PWD_KEY` based on your environment. Also, ensure you use the correct device names on each host.
733737
- You must have created the `racstorage` volume before the creation of the Oracle RAC Container. For details about the available environment variables, refer the [Section 7](#section-7-environment-variables-for-the-first-node).
734738

735-
#### Assign networks to Oracle RAC containers
739+
#### Assign networks to Oracle RAC podman containers
736740

737741
You need to assign the Podman networks created in section 1 to containers. Execute the following commands:
738742

@@ -742,7 +746,7 @@ You need to assign the Podman networks created in section 1 to containers. Execu
742746
# podman network connect rac_priv1_nw --ip 192.168.17.150 racnode1
743747
```
744748

745-
#### Start the first container
749+
#### Start the first podman container
746750

747751
To start the first container, run the following command:
748752

@@ -764,7 +768,7 @@ ORACLE RAC DATABASE IS READY TO USE!
764768
####################################
765769
```
766770

767-
#### Connect to the Oracle RAC container
771+
#### Connect to the Oracle RAC podman container
768772

769773
To connect to the container execute the following command:
770774

@@ -897,7 +901,7 @@ For example:
897901
- You must have created **racstorage** volume before the creation of the Oracle RAC container.
898902
- You can change env variables such as IPs and ORACLE_PWD based on your env. For details about the env variables, refer the [Section 8](#section-8-environment-variables-for-the-second-and-subsequent-nodes).
899903

900-
#### Assign Network to additional Oracle RAC container
904+
#### Assign Network to additional Oracle RAC podman container
901905

902906
Connect the private and public networks you created earlier to the container:
903907

@@ -1014,7 +1018,7 @@ If you want to build a patched image based on a base 21.3.0 container image, the
10141018

10151019
## Section 10 : Sample Container Files for Older Releases
10161020

1017-
### Docker
1021+
### Docker Container Files
10181022

10191023
This project offers sample container files for Oracle Grid Infrastructure and Oracle Real Application Clusters for dev and test:
10201024

@@ -1028,10 +1032,12 @@ This project offers sample container files for Oracle Grid Infrastructure and Or
10281032
**Notes:**
10291033

10301034
* Note that the Oracle RAC on Docker Container releases are supported only for test and development environments, but not for production environments.
1031-
* If you are planning to build and deploy Oracle RAC 18.3.0, you need to download Oracle 18.3.0 Grid Infrastructure and Oracle Database 18.3.0 Database. You also need to download Patch# p28322130_183000OCWRU_Linux-x86-64.zip from [Oracle Technology Network](https://www.oracle.com/technetwork/database/database-technologies/clusterware/downloads/docker-4418413.html). Stage it under containerfiles/18.3.0 folder.
1032-
* If you are planning to build and deploy Oracle RAC 12.2.0.1, you need to download Oracle 12.2.0.1 Grid Infrastructure and Oracle Database 12.2.0.1 Database. You also need to download Patch# p27383741_122010_Linux-x86-64.zip from [Oracle Technology Network](https://www.oracle.com/technetwork/database/database-technologies/clusterware/downloads/docker-4418413.html). Stage it under containerfiles/12.2.0.1 folder.
1035+
* If you are planning to build and deploy Oracle RAC 18.3.0, you need to download Oracle 18.3.0 Grid Infrastructure and Oracle Database 18.3.0 Database. You also need to download Patch# p28322130_183000OCWRU_Linux-x86-64.zip from [Oracle Technology Network](https://www.oracle.com/technetwork/database/database-technologies/clusterware/downloads/docker-4418413.html).
1036+
Stage it under containerfiles/18.3.0 folder.
1037+
* If you are planning to build and deploy Oracle RAC 12.2.0.1, you need to download Oracle 12.2.0.1 Grid Infrastructure and Oracle Database 12.2.0.1 Database. You also need to download Patch# p27383741_122010_Linux-x86-64.zip from [Oracle Technology Network](https://www.oracle.com/technetwork/database/database-technologies/clusterware/downloads/docker-4418413.html).
1038+
Stage it under containerfiles/12.2.0.1 folder.
10331039

1034-
### Podman
1040+
### Podman Container Files
10351041

10361042
This project offers sample container files for Oracle Grid Infrastructure and Oracle Real Application Clusters for dev and test:
10371043

@@ -1048,15 +1054,15 @@ This project offers sample container files for Oracle Grid Infrastructure and Or
10481054
* You must add `CV_ASSUME_DISTID=OEL8` inside the `Dockerfile` as an env variable.
10491055

10501056
* Once the `19.3.0` Oracle RAC on Podman image is built, start building patched image with the download 19.16 RU and one-offs. To build the patch the image, refer [Example of how to create a patched database image](https://github.com/oracle/docker-images/tree/main/OracleDatabase/RAC/OracleRealApplicationClusters/samples/applypatch).
1051-
* Make changes in `/opt/containers/envfile` in [Prepare the envfile](#prepare-the-envfile) sectoin as per 19c `Dockerfile`. You need to change all the contents based on 19c such as `GRID_HOME`, `ORACLE_HOME` and `ADDNODE_RSP` which you have used in `Dockerfile` while building the image.
1057+
* Make changes in `/opt/containers/envfile` as per 19c `Dockerfile`. You need to change all the contents based on 19c such as `GRID_HOME`, `ORACLE_HOME` and `ADDNODE_RSP` which you have used in `Dockerfile` while building the image.
10521058

10531059
## Section 11 : Support
10541060

1055-
### Docker
1061+
### Docker Support
10561062

10571063
At the time of this release, Oracle RAC on Docker is supported only on Oracle Linux 7. To see current details, refer the [Real Application Clusters Installation Guide for Docker Containers Oracle Linux x86-64](https://docs.oracle.com/en/database/oracle/oracle-database/21/racdk/oracle-rac-on-docker.html).
10581064

1059-
### Podman
1065+
### Podman Support
10601066

10611067
At the time of this release, Oracle RAC on Podman is supported for Oracle Linux 8.5 later. To see current Linux support certifications, refer [Oracle RAC on Podman Documentation](https://docs.oracle.com/en/database/oracle/oracle-database/21/install-and-upgrade.html)
10621068

0 commit comments

Comments
 (0)