Skip to content

Commit d0af650

Browse files
committed
fix readme file
1 parent 2adeaa0 commit d0af650

File tree

1 file changed

+18
-20
lines changed
  • OracleDatabase/RAC/OracleRACStorageServer

1 file changed

+18
-20
lines changed

OracleDatabase/RAC/OracleRACStorageServer/README.md

Lines changed: 18 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,39 @@
11
# Oracle ASM on NFS Server for RAC testing
22
Example Podman build files to facilitate installation, configuration, and environment setup NFS Server for RAC testing for DevOps users.
33

4-
**IMPORTANT:** This image can be used to set up ASM on NFS for Oracle RAC. You can skip this procedure if you have physical block devices or a NAS server for Oracle RAC and Oracle Grid Infrastructure. You must ensure that NFS server container is up and running for Oracle RAC functioning.
4+
**IMPORTANT:** This image can be used to set up ASM on NFS for Oracle RAC. You can skip this procedure if you have physical block devices or a NAS server for Oracle RAC and Oracle Grid Infrastructure. You must ensure that the NFS server container is up and running for Oracle RAC functioning.
55

6-
Refer to the following instructions for setup of NFS Container for Oracle RAC:
6+
Refer to the following instructions for setup of NFS Container for Oracle RAC:
77

88
- [Oracle ASM on NFS Server for Oracle RAC testing](#oracle-asm-on-nfs-server-for-rac-testing)
99
- [How to build NFS Storage Container Image on Container host](#how-to-build-nfs-storage-container-image-on-container-host)
1010
- [Create Bridge Network](#create-bridge-network)
1111
- [NFS Server installation on Podman Host](#nfs-server-installation-on-podman-host)
1212
- [Running RACStorageServer Podman container](#running-racstorageserver-podman-container)
1313
- [Oracle RAC Storage Container for Podman Host](#rac-storage-container-for-podman-host)
14-
- [Oracle RAC Storage container for Docker Host](#rac-storage-container-for-docker-host)
14+
- [Oracle RAC Storage container for Docker Host](#rac-storage-container-for-docker-host)
1515
- [Create NFS Volume](#create-nfs-volume)
1616
- [Copyright](#copyright)
1717

1818
## How to build NFS Storage Container Image on Container host
19-
To create the files for Oracle RAC storage, ensure that you have at least 60 GB space available for container.
19+
To create the files for Oracle RAC storage, ensure that you have at least 60 GB space available for the container.
2020

21-
**IMPORTANT:** If you are behind a proxy, you must set the `http_proxy` and `https_proxy` env variable to values based on your enviornment before building the image.
21+
**IMPORTANT:** If you are behind a proxy, you must set the `http_proxy` and `https_proxy` env variable to values based on your environment before building the image.
2222

2323
To assist in building the images, you can use the [buildContainerImage.sh](containerfiles/buildContainerImage.sh) script. See below for instructions and usage.
2424

25-
In this guide, we are refering Oracle Linux 8 onwards as the Podman Host, and Oracle Linux 7 as the Docker Host machines.
25+
In this guide, we are referring to Oracle Linux 8 onwards as the Podman Host, and Oracle Linux 7 as the Docker Host machines.
2626

27-
The `buildContainerImage.sh` script is just a utility shell script that performs MD5 checks. It provides an easy way for beginners to get started. Expert users are welcome to directly call `podman build` with their prefered set of parameters. Go into the **containerfiles** folder and run the **buildContainerImage.sh** script on your podman host:
27+
The `buildContainerImage.sh` script is just a utility shell script that performs MD5 checks. It provides an easy way for beginners to get started. Expert users are welcome to directly call `podman build` with their preferred set of parameters. Go into the **containerfiles** folder and run the **buildContainerImage.sh** script on your Podman host:
2828

2929
```bash
3030
./buildContainerImage.sh -v (Software Version)
3131
./buildContainerImage.sh -v latest
3232
```
33-
In a successful build, you see build messages similar to the following:
33+
34+
In a successful build, you see build messages similar to the following:
3435
```bash
35-
Oracle RAC Storage Server Container Image version latest is ready to be extended:
36+
Oracle RAC Storage Server Container Image version latest is ready to be extended:
3637

3738
--> oracle/rac-storage-server:latest
3839
```
@@ -58,11 +59,11 @@ Before creating the container, create the bridge public network for the NFS stor
5859

5960
The following are examples of creating `bridge`, `macvlan` or `ipvlan` [networks](#https://docs.podman.io/en/latest/markdown/podman-network-create.1.html).
6061

61-
Example of creating bridge networks:
62+
Example of creating bridge networks:
6263
```bash
6364
podman network create --driver=bridge --subnet=10.0.20.0/24 rac_pub1_nw
6465
```
65-
Example of creating macvlan networks:
66+
Example of creating macvlan networks:
6667
```bash
6768
podman network create -d macvlan --subnet=10.0.20.0/24 -o parent=ens5 rac_pub1_nw
6869
```
@@ -82,9 +83,9 @@ dnf install -y nfs-utils
8283
```
8384

8485
### SELinux Configuration on Podman Host
85-
If SELinux is enabled on the Podman host then you must install another SELINUX module, specifically allowing permissions to write to the Podman host. To check if your SELinux is enabled or not, run the `getenforce` command.
86+
If SELinux is enabled on the Podman host then you must install another SELINUX module, specifically allowing permissions to write to the Podman host. To check if your SELinux is enabled or not, run the `getenforce` command.
8687

87-
Copy [rac-storage.te](./rac-storage.te) to `/var/opt` folder in your host and then execute below-
88+
Copy [rac-storage.te](./rac-storage.te) to `/var/opt` folder in your host and then execute below-
8889

8990
```bash
9091
cd /var/opt
@@ -135,7 +136,7 @@ To check the Oracle RAC storage container and services creation logs, you can ru
135136
```bash
136137
podman exec racnode-storage tail -f /tmp/storage_setup.log
137138
```
138-
In a successful deployment, you should see messages similar to the following:
139+
In a successful deployment, you should see messages similar to the following:
139140
```bash
140141
Export list for racnode-storage:
141142
/oradata *
@@ -147,14 +148,14 @@ Export list for racnode-storage:
147148

148149
### Oracle RAC Storage container for Docker Host
149150

150-
To use NFS volumes in containers, you must install NFS server rpms on the Podman host:
151+
To use NFS volumes in containers, you must install NFS server rpms on the Podman host:
151152

152153
```bash
153154
yum install -y nfs-utils
154155
```
155156
#### Prerequisites for an Oracle RAC Storage Container for Docker Host
156157

157-
Create a placeholder for NFS storage, and ensure that it is empty:
158+
Create a placeholder for NFS storage, and ensure that it is empty:
158159
```bash
159160
export ORACLE_DBNAME=ORCLCDB
160161
mkdir -p /scratch/docker_volumes/asm_vol/$ORACLE_DBNAME
@@ -163,7 +164,7 @@ rm -rf /scratch/docker_volumes/asm_vol/$ORACLE_DBNAME/asm_disk0*
163164

164165
#### Deploying Oracle RAC Storage Container for Docker Host
165166

166-
If you are building an Oracle RAC storage container on Docker host machines, then run the following commands:
167+
If you are building an Oracle RAC storage container on Docker host machines, then run the following commands:
167168

168169
```bash
169170
export ORACLE_DBNAME=ORCLCDB
@@ -217,7 +218,6 @@ docker volume create --driver local \
217218
--opt device=192.168.17.80:/oradata \
218219
racstorage
219220
```
220-
221221
**IMPORTANT:** If you are not using the 192.168.17.0/24 subnet then you must change **addr=192.168.17.80** based on your environment.
222222

223223
# Environment variables explained
@@ -228,9 +228,7 @@ racstorage
228228
| DOMAIN | Default set to example.info. Specify the domain details for Oracle RAC Container Environment. |
229229

230230
## License
231-
232231
Unless otherwise noted, all scripts and files hosted in this repository that are required to build the container images are under UPL 1.0 license.
233232

234233
## Copyright
235-
236234
Copyright (c) 2014-2024 Oracle and/or its affiliates.

0 commit comments

Comments
 (0)