Skip to content

Commit f3e7870

Browse files
committed
remove extra spaces
1 parent f1e8062 commit f3e7870

File tree

8 files changed

+79
-82
lines changed

8 files changed

+79
-82
lines changed

OracleDatabase/RAC/OracleRealApplicationClusters/README.md

Lines changed: 15 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,11 @@ 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 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.
88

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 v21c, and setup 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+
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/).
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 v21c, and setup 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.
1012

1113
## Using this Documentation
1214
To create an Oracle RAC environment, follow these steps:
@@ -38,23 +40,22 @@ To create an Oracle RAC environment, follow these steps:
3840
Before you proceed to the next section, you must complete each of the steps listed in this section and complete the following prerequisites.
3941

4042
* 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-
4243
* Overview of Oracle RAC on Podman
4344
* Host Preparation for Oracle RAC on Podman
4445
* 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+
* **Note**: As we are following command line installation for Oracle RAC on containers, we don't need X Window System to be configured
4647
* Podman Containers and Oracle RAC Nodes
4748
* Provisioning the Podman Host Server
4849
* Podman Host Preparation
4950
* Preparing for Podman Container Installation
5051
* Installing Podman Engine
5152
* Allocate Linux Resources for Oracle Grid Infrastructure Deployment
52-
* How to Configure Podman for SELinux Mode
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.
53+
* How to Configure Podman for SELinux Mode
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.
5455
* 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.
5556
* 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.
5657

57-
* To resolve VIPs and SCAN IPs in this guide, we use a preconfigured DNS server in our environment. 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 with the `DOMAIN` and `DNS_SERVERS` based on your environment.
58+
* To resolve VIPs and SCAN IPs in this guide, we use a preconfigured DNS server in our environment. 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 with the `DOMAIN` and `DNS_SERVERS` based on your environment.
5859

5960
* 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.
6061
- Oracle Grid Infrastructure 21c (21) for Linux x86-64
@@ -65,9 +66,9 @@ Before you proceed to the next section, you must complete each of the steps list
6566

6667
## Getting Oracle RAC Database Container Images
6768

68-
Oracle RAC is supported for production use on Podman starting with Oracle Database 19c (19.16), and Oracle Database 21c (21.7). You can also deploy Oracle RAC on Podman using the pre-built images available on the Oracle Container Registry. Refer [this documentation](https://docs.oracle.com/en/operating-systems/oracle-linux/docker/docker-UsingDockerRegistries.html#docker-registry) for details on using Oracle Container Registry.
69+
Oracle RAC is supported for production use on Podman starting with Oracle Database 19c (19.16), and Oracle Database 21c (21.7). You can also deploy Oracle RAC on Podman using the pre-built images available on the Oracle Container Registry. Refer [this documentation](https://docs.oracle.com/en/operating-systems/oracle-linux/docker/docker-UsingDockerRegistries.html#docker-registry) for details on using Oracle Container Registry.
6970

70-
Example of pulling an Oracle RAC Image from the Oracle Container Registry:
71+
Example of pulling an Oracle RAC Image from the Oracle Container Registry:
7172
```bash
7273
podman pull container-registry.oracle.com/database/rac:21.16
7374
podman tag container-registry.oracle.com/database/rac:21.16 localhost/oracle/database-rac:21.3.0
@@ -97,7 +98,7 @@ Example: Building Oracle RAC image for v 21.3.0-
9798
./buildContainerImage.sh -v 21.3.0
9899
```
99100

100-
### Building Oracle RAC Database Container Slim Image
101+
### Building Oracle RAC Database Container Slim Image
101102
In this document, an `Oracle RAC container slim image` refers to a container image that does not include installing Oracle Grid Infrastructure and Oracle Database during the Oracle RAC image creation. To build an Oracle RAC slim image that doesn't contain the Oracle RAC Database and Grid infrastructure software, run the following command:
102103
```bash
103104
./buildContainerImage.sh -v <Software Version> -i -o '--build-arg SLIMMING=true'
@@ -140,7 +141,7 @@ a. Create Podman Bridge networks using the following commands:
140141
podman network create --driver=bridge --subnet=192.168.18.0/24 rac_priv2_nw --disable-dns --internal
141142
```
142143

143-
- To run Oracle RAC using Oracle Container Runtime for Podman on multiple hosts, you must create one of the following:
144+
- To run Oracle RAC using Oracle Container Runtime for Podman on multiple hosts, you must create one of the following:
144145

145146
b. Create Podman macvlan networks using the following commands:
146147

@@ -181,7 +182,7 @@ podman network create -d ipvlan --subnet=10.0.20.0/24 --opt mtu=9000 -o parent=e
181182
podman network create -d ipvlan --subnet=192.168.17.0/24 --opt mtu=9000 -o parent=ens6 rac_priv1_nw --disable-dns --internal
182183
podman network create -d ipvlan --subnet=192.168.18.0/24 --opt mtu=9000 -o parent=ens7 rac_priv2_nw --disable-dns --internal
183184
```
184-
## Password Management
185+
## Password Management
185186
- 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:
186187

187188
```bash
@@ -215,7 +216,7 @@ Notes:
215216
## Oracle RAC on Containers Deployment Scenarios
216217
Oracle RAC can be deployed with various scenarios, such as using 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 below.
217218

218-
### Oracle RAC Containers on Podman
219+
### Oracle RAC Containers on Podman
219220
#### [1. Setup Using Oracle RAC Container Image](docs/rac-container/racimage/README.md)
220221
#### [2. Setup Using Oracle RAC Container Slim Image](docs/rac-container/racslimimage/README.md)
221222

@@ -243,7 +244,7 @@ This project offers example container files for Oracle Grid Infrastructure and O
243244
* Oracle Database 12c Release 2 Oracle Grid Infrastructure (12.2.0.1.0) for Linux x86-64
244245
* Oracle Database 12c Release 2 (12.2.0.1.0) Enterprise Edition for Linux x86-64
245246

246-
To install older releases of Oracle RAC on Podman or Oracle RAC on Docker, refer to the [README.md](./docs/README_1.md )
247+
To install older releases of Oracle RAC on Podman or Oracle RAC on Docker, refer to the [README.md](./docs/README_1.md)
247248

248249
## Support
249250

OracleDatabase/RAC/OracleRealApplicationClusters/docs/developers/OTHERS.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,9 @@ 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 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.
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.
8+
9+
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.
810

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

@@ -53,10 +55,11 @@ Before you proceed to the next section, you must complete each of the steps list
5355
* How to Configure Podman for SELinux Mode
5456
* 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.
5557
* 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).
58+
5659
* 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.
5760

58-
* To resolve VIPs and SCAN IPs, in this guide we use a DNS container. Before proceeding to the next step, create a [DNS server container](../OracleDNSServer/README.md).
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.
61+
* To resolve VIPs and SCAN IPs, in this guide we use a DNS container. Before proceeding to the next step, create a [DNS server container](../OracleDNSServer/README.md).
62+
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.
6063

6164
* 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.
6265
- Oracle Grid Infrastructure 21c (21.3) for Linux x86-64
@@ -70,9 +73,9 @@ If you have a preconfigured DNS server in your environment, then you can replace
7073

7174
## Getting Oracle RAC Database Container Images
7275

73-
Oracle RAC is supported for production use on Podman starting with Oracle Database 19c (19.16), and Oracle Database 21c (21.7). You can also deploy Oracle RAC on Podman using the pre-built images available on the Oracle Container Registry. Refer to [this documentation](https://docs.oracle.com/en/operating-systems/oracle-linux/docker/docker-UsingDockerRegistries.html#docker-registry) for details on using the Oracle Container Registry.
76+
Oracle RAC is supported for production use on Podman starting with Oracle Database 19c (19.16), and Oracle Database 21c (21.7). You can also deploy Oracle RAC on Podman using the pre-built images available on the Oracle Container Registry. Refer to [this documentation](https://docs.oracle.com/en/operating-systems/oracle-linux/docker/docker-UsingDockerRegistries.html#docker-registry) for details on using the Oracle Container Registry.
7477

75-
Example of pulling an Oracle RAC Image from the Oracle Container Registry:
78+
Example of pulling an Oracle RAC Image from the Oracle Container Registry:
7679
```bash
7780
# For Oracle RAC Container Image
7881
podman pull container-registry.oracle.com/database/rac:21.16
@@ -92,7 +95,8 @@ To assist in building the images, you can use the [`buildContainerImage.sh`](./c
9295

9396
### Building Oracle RAC Database Container Image
9497

95-
In this document, Oracle RAC Database Container Image refers to an Oracle RAC Database Container Image with Oracle Grid Infrastructure and Oracle Database software binaries installed during Oracle RAC Podman image creation. The resulting images will contain the Oracle Grid Infrastructure and Oracle RAC Database software binaries. Before you begin, you must download grid and database binaries and stage them under `<GITHUB_REPO_CLONED_PATH>/docker-images/OracleDatabase/RAC/OracleRealApplicationCluster/containerfiles/<VERSION>`.
98+
In this document, Oracle RAC Database Container Image refers to an Oracle RAC Database Container Image with Oracle Grid Infrastructure and Oracle Database software binaries installed during Oracle RAC Podman image creation. The resulting images will contain the Oracle Grid Infrastructure and Oracle RAC Database software binaries.
99+
Before you begin, you must download grid and database binaries and stage them under `<GITHUB_REPO_CLONED_PATH>/docker-images/OracleDatabase/RAC/OracleRealApplicationCluster/containerfiles/<VERSION>`.
96100

97101
```bash
98102
./buildContainerImage.sh -v <Software Version>

0 commit comments

Comments
 (0)