Skip to content

Commit ed66ef9

Browse files
committed
minor ol7 adjustments
1 parent 0cc1c9f commit ed66ef9

File tree

1 file changed

+9
-66
lines changed
  • OracleDatabase/RAC/OracleRACStorageServer

1 file changed

+9
-66
lines changed

OracleDatabase/RAC/OracleRACStorageServer/README.md

Lines changed: 9 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,6 @@ Refer to the following instructions for setup of NFS Container for Oracle RAC:
1111
- [NFS Server installation on Podman Host](#nfs-server-installation-on-podman-host)
1212
- [SELinux Configuration on Podman Host](#selinux-configuration-on-podman-host)
1313
- [Oracle RAC Storage Container for Podman Host](#oracle-rac-storage-container-for-podman-host)
14-
- [Oracle RAC Storage container for Docker Host](#oracle-rac-storage-container-for-docker-host)
1514
- [Create NFS Volume](#create-nfs-volume)
1615
- [Copyright](#copyright)
1716

@@ -22,7 +21,7 @@ To create the files for Oracle RAC storage, ensure that you have at least 60 GB
2221

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

25-
In this guide, we refer to Oracle Linux 8 onwards as the Podman Host, and Oracle Linux 7 as the Docker Host machines.
24+
In this guide, we refer to Oracle Linux 8 onwards as the Podman Host.
2625

2726
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:
2827

@@ -38,20 +37,15 @@ In a successful build, you should see build messages similar to the following:
3837
--> oracle/rac-storage-server:latest
3938
```
4039

41-
**NOTE**: To build an Oracle RAC storage Image for the Docker host, pass the version `ol7` to buildContainerImage.sh
42-
4340
For detailed usage notes for this script, run the following command:
4441
```bash
4542
./buildContainerImage.sh -h
46-
Usage: buildContainerImage.sh -v [version] [-o] [Docker build option]
47-
Builds a Docker Image for Oracle Database.
43+
Usage: buildContainerImage.sh -v [version] [-o] [Podman build option]
44+
Builds a Podman Image for Oracle Database.
4845

4946
Parameters:
50-
-v: version to build
51-
Choose one of: latest or ol7
52-
Choose "latest" version for podman host machines
53-
Choose "ol7" for docker host machines
54-
-o: passes on Docker build option
47+
-v: version to build e.g latest
48+
-o: passes on Podman build option
5549
```
5650

5751
### Create Bridge Network
@@ -130,7 +124,7 @@ podman run -d -t \
130124
localhost/oracle/rac-storage-server:latest
131125
```
132126

133-
To check the Oracle RAC storage container and services creation logs, you can run a `tail` command on the Docker logs. It should take approximately 10 minutes to create the racnode-storage container service.
127+
To check the Oracle RAC storage container and services creation logs, you can run a `tail` command on the Podman logs. It should take approximately 10 minutes to create the racnode-storage container service.
134128

135129
```bash
136130
podman exec racnode-storage tail -f /tmp/storage_setup.log
@@ -144,61 +138,15 @@ Export list for racnode-storage:
144138
#################################################
145139
```
146140

147-
148-
### Oracle RAC Storage container for Docker Host
149-
150-
To use NFS volumes in containers, you must install NFS server RPMs on the Podman host:
151-
152-
```bash
153-
yum install -y nfs-utils
154-
```
155-
#### Prerequisites for an Oracle RAC Storage Container for Docker Host
156-
157-
Create a placeholder for NFS storage, and ensure that it is empty:
158-
```bash
159-
export ORACLE_DBNAME=ORCLCDB
160-
mkdir -p /scratch/docker_volumes/asm_vol/$ORACLE_DBNAME
161-
rm -rf /scratch/docker_volumes/asm_vol/$ORACLE_DBNAME/asm_disk0*
162-
```
163-
164-
#### Deploying Oracle RAC Storage Container for Docker Host
165-
166-
If you are building an Oracle RAC storage container on Docker host machines, then run the following commands:
167-
168-
```bash
169-
export ORACLE_DBNAME=ORCLCDB
170-
docker run -d -t \
171-
--hostname racnode-storage \
172-
--dns-search=example.info \
173-
--cap-add SYS_ADMIN \
174-
--cap-add AUDIT_WRITE \
175-
--volume /scratch/docker_volumes/asm_vol/$ORACLE_DBNAME:/oradata --init \
176-
--network=rac_pub1_nw --ip=10.0.20.80 \
177-
--tmpfs=/run \
178-
--volume /sys/fs/cgroup:/sys/fs/cgroup:ro \
179-
--name racnode-storage \
180-
oracle/rac-storage-server:ol7
181-
```
182-
183-
To check the Oracle RAC storage container and services creation logs, you can run a `tail` command on the Docker logs. It should take 10 minutes to create the racnode-storage container service.
184-
185-
```bash
186-
docker logs -f racnode-storage
187-
```
188-
189141
**IMPORTANT:** During the container startup, five files with the name `asm_disk0[1-5].img` will be created under `/oradata`. If the files are already present, then they will not be recreated. These files can be used for ASM storage in Oracle RAC containers.
190142

191143
**NOTE**: Place the directory in a container that has at least 60 GB. In the preceding example, we are using `/scratch/stage/rac-storage/$ORACLE_DBNAME`. Change these values according to your environment. Inside the container, the directory will be `/oradata`. Do not change this value.
192144

193145
In the following example, we use **192.168.17.0/24** as the subnet for the NFS server. You can change the subnet values according to your environment.
194146

195-
You should see following in the Docker logs output:
196-
197-
198147
**IMPORTANT:** The NFS volume must be `/oradata`, which you will export to Oracle RAC containers for ASM storage. It will take approximately 10 minutes to set up the NFS server.
199148

200149
### Create NFS Volume
201-
#### Create NFS volume using the following command on the Podman Host
202150

203151
```bash
204152
podman volume create --driver local \
@@ -208,15 +156,7 @@ podman volume create --driver local \
208156
racstorage
209157
```
210158

211-
#### Create NFS volume using following command on Docker Host
212159

213-
```bash
214-
docker volume create --driver local \
215-
--opt type=nfs \
216-
--opt o=addr=192.168.17.80,rw,bg,hard,tcp,vers=3,timeo=600,rsize=32768,wsize=32768,actimeo=0 \
217-
--opt device=192.168.17.80:/oradata \
218-
racstorage
219-
```
220160
**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.
221161

222162
## Environment variables explained
@@ -226,6 +166,9 @@ racstorage
226166
| DNS_SERVER | Default set to `10.0.20.25`. Specify the comma-separated list of DNS server IP addresses where both Oracle RAC nodes are resolved. |
227167
| DOMAIN | Default set to `example.info`. Specify the domain details for the Oracle RAC Container Environment. |
228168

169+
## Sample Container Files for Older Releases
170+
To setup an Oracle RAC storage Container for the Docker host on Oracle Linux 7, refer older [README](./README1.md#how-to-build-nfs-storage-container-image-on-docker-host)
171+
instructions.
229172
## License
230173
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.
231174

0 commit comments

Comments
 (0)