Skip to content

Commit 8747299

Browse files
committed
lint fixes
1 parent b3faad0 commit 8747299

File tree

7 files changed

+50
-37
lines changed

7 files changed

+50
-37
lines changed

OracleDatabase/RAC/OracleRealApplicationClusters/README.md

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,11 @@ Learn about container deployment options for Oracle Real Application Clusters (O
66

77
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-
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/).
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.
10+
For more information on Oracle RAC Database 21c refer to the [Oracle Database documentation](http://docs.oracle.com/en/database/).
1011

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.
12+
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.
13+
In this installation guide, we use [Podman](https://docs.podman.io/en/v3.0/) to create Oracle RAC Containers and manage them.
1214

1315
## Using this Documentation
1416
To create an Oracle RAC environment, follow these steps:
@@ -37,7 +39,7 @@ To create an Oracle RAC environment, follow these steps:
3739

3840
## Preparation Steps for running Oracle RAC Database in containers
3941

40-
Before you proceed to the next section, you must complete each of the steps listed in this section and complete the following prerequisites.
42+
Before you proceed to the next section, you must complete each of the steps listed in this section and complete the following prerequisites.
4143

4244
* 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:
4345
* Overview of Oracle RAC on Podman
@@ -52,14 +54,16 @@ Before you proceed to the next section, you must complete each of the steps list
5254
* Allocate Linux Resources for Oracle Grid Infrastructure Deployment
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.
55-
* 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.
57+
* 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.
58+
**Note:** You can skip this step if you are planning to use block devices for storage.
5659
* 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.
5760

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.
61+
* To resolve VIPs and SCAN IPs in this guide, we use a preconfigured DNS server in our environment.
62+
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.
5963

6064
* 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.
61-
- Oracle Grid Infrastructure 21c (21) for Linux x86-64
62-
- Oracle Database 21c (21) for Linux x86-64
65+
- Oracle Grid Infrastructure 21c (21) for Linux x86-64
66+
- Oracle Database 21c (21) for Linux x86-64
6367

6468
**Notes**
6569
* If the Podman bridge network is not available outside your host, you can use the Oracle Connection Manager [CMAN Container](../OracleConnectionManager/README.md) to access the Oracle RAC Database from outside the host.
@@ -88,7 +92,8 @@ Note:
8892
* Ensure that you have enough space in `/var/lib/containers` while building the Oracle RAC image. Also, if required use `export TMPDIR=</path/to/tmpdir>` for Podman to refer to any other folder as the temporary podman cache location instead of the default `/tmp` location.
8993

9094
### Building Oracle RAC Database Container Image
91-
In this document,an `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>`.
95+
In this document,an `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.
96+
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>`.
9297

9398
```bash
9499
./buildContainerImage.sh -v <Software Version>

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

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,8 @@ In this document, an Oracle RAC container slim image refers to a container image
139139
## Network Management
140140

141141
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://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.
142-
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`.
142+
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.
143+
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`.
143144

144145
```bash
145146
podman network create --driver=bridge --subnet=10.0.20.0/24 rac_pub1_nw

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

Lines changed: 8 additions & 4 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. 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.
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.
9+
For more information on Oracle RAC Database 21c refer to the [Oracle Database documentation](http://docs.oracle.com/en/database/).
810

911
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 v26.0, 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

@@ -29,7 +31,8 @@ To create an Oracle RAC environment, follow these steps:
2931
- [Copyright](#copyright)
3032

3133
## Before you begin
32-
- Before proceeding further, the below prerequisites related to the Oracle RAC (Real Application Cluster) Podman host Environment need to be setup as a preparation steps for the Podman host machine for Oracle RAC Containers. For more details related to the preparation of the host machine, refer to [Preparation Steps for running Oracle RAC Database in containers](../../README.md#preparation-steps-for-running-oracle-rac-database-in-containers). We have pre-created script `setup_rac_host.sh` which will prepare the podman host with the following pre-requisites-
34+
- Before proceeding further, the below prerequisites related to the Oracle RAC (Real Application Cluster) Podman host Environment need to be setup as a preparation steps for the Podman host machine for Oracle RAC Containers. For more details related to the preparation of the host machine, refer to [Preparation Steps for running Oracle RAC Database in containers](../../README.md#preparation-steps-for-running-oracle-rac-database-in-containers).
35+
We have pre-created script `setup_rac_host.sh` which will prepare the podman host with the following pre-requisites-
3336
- Validate Host machine for supported Os version(OL >9.3), Kernel(>UEKR7), Memory(>32GB), Swap(>32GB), shm(>4GB) etc.
3437
- Update /etc/sysctl.conf
3538
- Setup node directories for Slim Image
@@ -57,10 +60,11 @@ OracleRealApplicationClusters/containerfiles/setup_rac_host.sh](../containerfile
5760
```bash
5861
INFO: Finished setting up the pre-requisites for Podman-Host
5962
```
60-
63+
6164
## Getting Oracle RAC Database Container Images
6265

63-
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 and [Getting Oracle RAC Database Container Images](../../README.md#getting-oracle-rac-database-container-images)
66+
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.
67+
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 and [Getting Oracle RAC Database Container Images](../../README.md#getting-oracle-rac-database-container-images)
6468

6569
Example of pulling an Oracle RAC Image from the Oracle Container Registry:
6670
```bash

OracleDatabase/RAC/OracleRealApplicationClusters/docs/rac-container/racimage/README.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Refer to the following instructions to set up Oracle RAC on Podman using an Orac
1616
- [Attach the network to racnodep1](#attach-the-network-to-racnodep1)
1717
- [Attach the network to racnodep2](#attach-the-network-to-racnodep2)
1818
- [Section 4: Start the Containers](#section-4-start-the-containers)
19-
- [Section 5: Validate the Oracle RAC Environment](#section-5-validating-oracle-rac-environment)
19+
- [Section 5: Validate the Oracle RAC Environment](#section-5-validate-the-oracle-rac-environment)
2020
- [Section 6: Connecting to Oracle RAC environment](#section-6-connecting-to-oracle-rac-environment)
2121
- [Section 7: Example of Node Addition to Oracle RAC Containers Based on Oracle RAC Image with block devices](#section-7-example-of-node-addition-to-oracle-rac-containers-based-on-oracle-rac-image-with-block-devices)
2222
- [Section 7.1: Example of node addition to Oracle RAC containers based on Oracle RAC image without Response File](#section-71-example-of-node-addition-to-oracle-rac-containers-based-on-oracle-rac-image-without-response-file)
@@ -57,7 +57,8 @@ To set up Oracle RAC on Podman using an Oracle RAC Image without providing respo
5757
#### Section 2.1.1: Deploying With Block Devices
5858
##### Section 2.1.1.1: Prerequisites for setting up Oracle RAC with block devices
5959

60-
Ensure that you have created at least one Block Device with at least 50 Gb of storage space that can be accessed by two Oracle RAC Nodes, and can be shared between them. You can create more block devices in accordance with your requirements and pass those environment variables and devices to the `podman create` command as well as in the Oracle Grid Infrastructure (grid) response files. **Note:** if you use response files. You can skip this step if you are planning to use NFS storage devices.
60+
Ensure that you have created at least one Block Device with at least 50 Gb of storage space that can be accessed by two Oracle RAC Nodes, and can be shared between them. You can create more block devices in accordance with your requirements and pass those environment variables and devices to the `podman create` command as well as in the Oracle Grid Infrastructure (grid) response files.
61+
**Note:** if you use response files. You can skip this step if you are planning to use NFS storage devices.
6162

6263
Ensure that the ASM devices do not have any existing file system. To clear any other file system from the devices, use the following command:
6364

@@ -272,7 +273,7 @@ localhost/oracle/database-rac:21.3.0
272273
```
273274
### Section 2.2: Deploying Two-Node Oracle RAC Setup on Podman using Oracle RAC Image Using User Defined Response files
274275

275-
Follow the below instructions to setup Oracle RAC on Podman using Oracle RAC Image for using user-defined response files.
276+
Follow the below instructions to setup Oracle RAC on Podman using Oracle RAC Image for using user-defined response files.
276277

277278
#### Section 2.2.1: Deploying With BlockDevices
278279

@@ -521,7 +522,7 @@ podman create -t -i \
521522

522523
You must assign the podman networks created based on the preceding examples. Complete the following tasks:
523524

524-
#### Attach the network to racnodep1
525+
### Attach the network to racnodep1
525526

526527
```bash
527528
podman network disconnect podman racnodep1
@@ -530,7 +531,7 @@ podman network connect rac_priv1_nw --ip 192.168.17.170 racnodep1
530531
podman network connect rac_priv2_nw --ip 192.168.18.170 racnodep1
531532
```
532533

533-
#### Attach the network to racnodep2
534+
### Attach the network to racnodep2
534535

535536
```bash
536537
podman network disconnect podman racnodep2
@@ -649,7 +650,7 @@ Oracle Database ORCLCDB3 is up and running on racnodep3.
649650
## Section 8: Example of Node Addition to Oracle RAC Containers Based on Oracle RAC Image with NFS Storage Devices
650651

651652
### Section 8.1: Example of node addition to Oracle RAC Containers based on Oracle RAC Image without Response File
652-
In the following example, we add an additional node to the existing Oracle RAC two-node cluster using the Oracle RAC image without user-defined files.
653+
In the following example, we add an additional node to the existing Oracle RAC two-node cluster using the Oracle RAC image without user-defined files.
653654

654655
Create additional Oracle RAC Container. In this example, the hostname is `racnodep3`
655656

0 commit comments

Comments
 (0)