Skip to content

Commit 2fb80ae

Browse files
ohs_24.4.1_minorDocFixes (#229)
1 parent 7ca9213 commit 2fb80ae

File tree

8 files changed

+194
-197
lines changed

8 files changed

+194
-197
lines changed

docs-source/content/ohs/create-ohs-container/_index.md

Lines changed: 45 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -30,9 +30,9 @@ The nodeport is the entry point for OHS. For example `http://ohs.example.com:317
3030
1. Edit the `$MYOHSFILES/ohs_service.yaml` and make the following changes:
3131

3232
+ `<NAMESPACE>` to your namespace, for example `ohsns`.
33-
+ If you want your OHS node port to listen on something other that 31777 and 31443, change accordingly
34-
+ If you are using your own `httpd.conf` file and have changed the port to anything other than `7777`, you must change the `targetPort` and `port` to match.
35-
+ If you are using your own `ssl.conf` file and have changed the port to anything other than `4443`, you must change the `targetPort` and `port` to match.
33+
+ If you want your OHS node port to listen on something other that 31777 and 31443, change accordingly
34+
+ If you are using your own `httpd.conf` file and have changed the port to anything other than `7777`, you must change the `targetPort` and `port` to match.
35+
+ If you are using your own `ssl.conf` file and have changed the port to anything other than `4443`, you must change the `targetPort` and `port` to match.
3636

3737

3838
```
@@ -63,33 +63,33 @@ The nodeport is the entry point for OHS. For example `http://ohs.example.com:317
6363

6464
**Note**: Administrators should be aware of the following:
6565

66-
+ As this is a Kubernetes service the port is accessible on all the worker nodes in the cluster.
67-
+ If you create another OHS container on a different port, you will need to create another nodeport service for that OHS.
66+
+ As this is a Kubernetes service the port is accessible on all the worker nodes in the cluster.
67+
+ If you create another OHS container on a different port, you will need to create another nodeport service for that OHS.
6868

6969

7070
```
71-
$ kubectl create -f $MYOHSFILES/ohs_service.yaml
71+
$ kubectl create -f $MYOHSFILES/ohs_service.yaml
7272
```
7373

74-
The output will look similar to the following:
74+
The output will look similar to the following:
7575

7676
```
7777
service/ohs-domain-nodeport created
7878
```
7979

8080
1. Validate the service has been created using the command:
8181

82-
```
82+
```
8383
$ kubectl get service -n <namespace>
84-
```
84+
```
8585

86-
For example:
86+
For example:
8787

8888
```
8989
$ kubectl get service -n ohsns
90-
```
90+
```
9191

92-
The output will look similar to the following:
92+
The output will look similar to the following:
9393

9494
```
9595
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
@@ -117,50 +117,50 @@ In this section you create the OHS container using the `ohs.yaml` file created i
117117
deployment.apps/ohs-domain created
118118
```
119119

120-
Run the following command to view the status of the pods:
120+
Run the following command to view the status of the pods:
121121

122-
```bash
122+
```bash
123123
$ kubectl get pods -n <namespace> -w
124124
```
125125

126-
For example:
126+
For example:
127127

128128

129129
```bash
130130
$ kubectl get pods -n ohsns -w
131131
```
132132

133-
Whilst the OHS container is creating you, may see:
133+
Whilst the OHS container is creating you, may see:
134134

135-
```
135+
```
136136
NAME READY STATUS RESTARTS AGE
137137
ohs-domain-d5b648bc5-vkp4s 0/1 ContainerCreating 0 2m13s
138138
```
139139

140-
To check what is happening while the pod is in `ContainerCreating` status, you can run:
140+
To check what is happening while the pod is in `ContainerCreating` status, you can run:
141141

142-
```
143-
kubectl describe pod <podname> -n <namespace>
144-
```
142+
```
143+
kubectl describe pod <podname> -n <namespace>
144+
```
145145

146-
For example:
146+
For example:
147147

148-
```
149-
$ kubectl describe pod ohs-domain-d5b648bc5-vkp4s -n ohsns
150-
```
148+
```
149+
$ kubectl describe pod ohs-domain-d5b648bc5-vkp4s -n ohsns
150+
```
151151

152-
Once the container is created, it will go to a `READY` status of `0/1` with `STATUS` of `Running`. For example:
152+
Once the container is created, it will go to a `READY` status of `0/1` with `STATUS` of `Running`. For example:
153153

154154
```
155155
NAME READY STATUS RESTARTS AGE
156156
ohs-domain-d5b648bc5-vkp4s 1/1 Running 0 3m10s
157157
```
158158

159-
To check what is happening while the pod is in this status, you can run:
159+
To check what is happening while the pod is in this status, you can run:
160160

161-
```
162-
$ kubectl logs -f <pod> -n <namespace>
163-
```
161+
```
162+
$ kubectl logs -f <pod> -n <namespace>
163+
```
164164
165165
Once everything is started you should see the OHS is running (`READY 1/1`):
166166

@@ -169,7 +169,7 @@ In this section you create the OHS container using the `ohs.yaml` file created i
169169
ohs-domain-d5b648bc5-vkp4s 1/1 Running 0 4m10s
170170
```
171171

172-
If there are any failures, follow [Troubleshooting](../troubleshooting).
172+
If there are any failures, follow [Troubleshooting](../troubleshooting).
173173

174174

175175

@@ -186,49 +186,49 @@ To validate the OHS container file system:
186186
1. Run the following command to get the name of the OHS container:
187187

188188

189-
```bash
189+
```bash
190190
$ kubectl get pods -n <namespace>
191191
```
192192

193-
For example:
193+
For example:
194194

195195

196196
```bash
197197
$ kubectl get pods -n ohsns
198198
```
199199

200-
The output will look similar to the following:
200+
The output will look similar to the following:
201201

202-
```
202+
```
203203
NAME READY STATUS RESTARTS AGE
204204
ohs-domain-d5b648bc5-vkp4s 1/1 Running 0 5m34s
205205
```
206206

207207
1. Run the following command to create a bash shell inside the container:
208208

209209
```
210-
kubectl exec -n <namespace> -ti <pod> -- /bin/bash
211-
```
210+
$ kubectl exec -n <namespace> -ti <pod> -- /bin/bash
211+
```
212212

213-
For example:
213+
For example:
214214

215-
```
216-
kubectl exec -n ohsns -ti ohs-domain-79f8f99575-8qwfh -- /bin/bash
215+
```
216+
$ kubectl exec -n ohsns -ti ohs-domain-79f8f99575-8qwfh -- /bin/bash
217217
```
218218

219-
This will take you to a bash shell inside the container:
219+
This will take you to a bash shell inside the container:
220220

221-
```
222-
[oracle@ohs-domain-75fbd9b597-z77d8 oracle]$
223-
```
221+
```
222+
[oracle@ohs-domain-75fbd9b597-z77d8 oracle]$
223+
```
224224

225225
1. Inside the bash shell navigate to the `/u01/oracle/user_projects/domains/ohsDomain/config/fmwconfig/components/OHS/ohs1/` directory:
226226

227227
```
228228
cd /u01/oracle/user_projects/domains/ohsDomain/config/fmwconfig/components/OHS/ohs1/
229229
```
230230

231-
From within this directory, you can navigate around and list (`ls`) or `cat` any files you configured using the configmaps.
231+
From within this directory, you can navigate around and list (`ls`) or `cat` any files you configured using the configmaps.
232232

233233

234234

docs-source/content/ohs/create-or-update-image/_index.md

Lines changed: 31 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -69,33 +69,33 @@ To set up the WebLogic Image Tool:
6969

7070
1. Execute the following commands to set up the WebLogic Image Tool:
7171

72-
```bash
73-
$ cd <workdir>/imagetool-setup/imagetool/bin
74-
$ source setup.sh
75-
```
72+
```bash
73+
$ cd <workdir>/imagetool-setup/imagetool/bin
74+
$ source setup.sh
75+
```
7676

77-
For example:
77+
For example:
7878

79-
```bash
80-
$ cd /scratch/imagetool-setup/imagetool/bin
81-
$ source setup.sh
82-
```
79+
```bash
80+
$ cd /scratch/imagetool-setup/imagetool/bin
81+
$ source setup.sh
82+
```
8383

8484
##### Validate setup
8585
To validate the setup of the WebLogic Image Tool:
8686

8787
1. Enter the following command to retrieve the version of the WebLogic Image Tool:
8888

89-
``` bash
90-
$ imagetool --version
91-
```
89+
``` bash
90+
$ imagetool --version
91+
```
9292

9393
1. Enter `imagetool` then press the Tab key to display the available `imagetool` commands:
9494

95-
``` bash
96-
$ imagetool <TAB>
97-
cache create help rebase update
98-
```
95+
``` bash
96+
$ imagetool <TAB>
97+
cache create help rebase update
98+
```
9999

100100
##### WebLogic Image Tool build directory
101101

@@ -155,14 +155,13 @@ You must download the required Oracle HTTP Server installation binaries and patc
155155
The installation binaries and patches required are:
156156

157157
* Oracle Web Tier 12.2.1.4.0
158-
* V983369-01.zip
158+
* V983369-01.zip
159159

160160
* Oracle JDK v8
161-
* jdk-8uXXX-linux-x64.tar.gz
161+
* jdk-8uXXX-linux-x64.tar.gz
162162

163163
* Oracle Database 19c Upgrade for FMW 12.2.1.4.0 (OID/OHS/OTD homes only)
164-
165-
* Patch 34761383 DB Client 19c Upgrade for FMW 12.2.1.4.0 (OID/OHS/OTD homes only)
164+
* Patch 34761383 DB Client 19c Upgrade for FMW 12.2.1.4.0 (OID/OHS/OTD homes only)
166165

167166
##### Update required build files
168167

@@ -190,17 +189,17 @@ The following files are used for creating the image:
190189
COPY --chown=oracle:root files/create-sa-ohs-domain.py files/configureWLSProxyPlugin.sh files/mod_wl_ohs.conf.sample files/provisionOHS.sh files/start-ohs.py files/stop-ohs.py files/helloWorld.html /u01/oracle/
191190
WORKDIR ${ORACLE_HOME}
192191
CMD ["/u01/oracle/provisionOHS.sh"]
193-
```
192+
```
194193

195-
**Note:** `oracle:root` is used for OpenShift which has more stringent policies. Users who do not want those permissions can change to the permissions they require.
194+
**Note:** `oracle:root` is used for OpenShift which has more stringent policies. Users who do not want those permissions can change to the permissions they require.
196195

197196

198197
1. Create the `<workdir>/imagetool-setup/docker-images/OracleHTTPServer/buildArgs` file as follows and change the following:
199198

200199
+ `<workdir>` to your working directory, for example `/scratch/`
201-
+ `%BUILDTAG%` to the tag you want create for the image, for example `oracle/ohs:12.2.1.4-db19`
202-
+ `%JDK_VERSION%` to the version of your JDK, for example `8uXXX`
203-
+ `<user>` to your [My Oracle Support](https://support.oracle.com) username
200+
+ `%BUILDTAG%` to the tag you want create for the image, for example `oracle/ohs:12.2.1.4-db19`
201+
+ `%JDK_VERSION%` to the version of your JDK, for example `8uXXX`
202+
+ `<user>` to your [My Oracle Support](https://support.oracle.com) username
204203

205204
```
206205
create
@@ -235,7 +234,7 @@ The following files are used for creating the image:
235234
```
236235

237236

238-
Refer to [this page](https://oracle.github.io/weblogic-image-tool/userguide/tools/create-image/) for the complete list of options available with the WebLogic Image Tool `create` command.
237+
Refer to [this page](https://oracle.github.io/weblogic-image-tool/userguide/tools/create-image/) for the complete list of options available with the WebLogic Image Tool `create` command.
239238

240239
##### Create the image
241240

@@ -284,14 +283,14 @@ The following files are used for creating the image:
284283
1. If you want to see what patches were installed, you can run:
285284

286285
```
287-
imagetool inspect --image=<REPOSITORY>:<TAG> --patches
288-
```
286+
$ imagetool inspect --image=<REPOSITORY>:<TAG> --patches
287+
```
289288

290-
For example:
289+
For example:
291290

292-
```
293-
imagetool inspect --image=oracle/ohs:12.2.1.4-db19 --patches
294-
```
291+
```
292+
$ imagetool inspect --image=oracle/ohs:12.2.1.4-db19 --patches
293+
```
295294

296295
1. Run the following command to save the container image to a tar file:
297296

docs-source/content/ohs/manage-ohs-containers/delete-ohs-container.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -28,14 +28,14 @@ The following commands show how to remove the OHS container, OHS nodeport servic
2828
$ kubectl delete cm -n ohsns webgate-config
2929
$ kubectl delete cm -n ohsns webgate-wallet
3030
$ kubectl delete cm -n ohsns ohs-wallet
31-
```
31+
```
3232

3333
1. Run the following command to delete the secrets:
3434

3535
```
36-
$ kubectl delete secret regcred -n ohsns
37-
$ kubectl delete secret ohs-secret -n ohsns
38-
```
36+
$ kubectl delete secret regcred -n ohsns
37+
$ kubectl delete secret ohs-secret -n ohsns
38+
```
3939

4040
1. Run the following command to delete the namespace:
4141

docs-source/content/ohs/manage-ohs-containers/domain-lifecycle.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ The number of OHS Servers running is dependent on the `replicas` parameter confi
4545
$ kubectl -n <namespace> patch deployment ohs-domain -p '{"spec": {"replicas": <replica count>}}'
4646
```
4747

48-
where `<replica count>` is the number of OHS servers to start.
48+
where `<replica count>` is the number of OHS servers to start.
4949

5050
In the example below, two additional OHS servers are started:
5151

@@ -66,7 +66,7 @@ The number of OHS Servers running is dependent on the `replicas` parameter confi
6666
$ kubectl get pods -n <namespace> -w
6767
```
6868

69-
For example:
69+
For example:
7070

7171
```bash
7272
$ kubectl get pods -n ohsns -w
@@ -81,7 +81,7 @@ The number of OHS Servers running is dependent on the `replicas` parameter confi
8181
ohs-domain-d5b648bc5-vkp4s 1/1 Running 0 5h21m
8282
```
8383

84-
Two new OHS pods have now been created, in this example `ohs-domain-d5b648bc5-2q8bw` and `ohs-domain-d5b648bc5-qvdjn`.
84+
Two new OHS pods have now been created, in this example `ohs-domain-d5b648bc5-2q8bw` and `ohs-domain-d5b648bc5-qvdjn`.
8585

8686
1. To check what is happening while the pods are in `ContainerCreating` status, you can run:
8787

@@ -91,9 +91,9 @@ The number of OHS Servers running is dependent on the `replicas` parameter confi
9191

9292
1. To check what is happening while the pods are in `0/1 Running` status, you can run:
9393

94-
```
95-
$ kubectl logs -f <pod> -n <namespace>
96-
```
94+
```
95+
$ kubectl logs -f <pod> -n <namespace>
96+
```
9797

9898
1. Once everything is started you should see all the additional OHS containers are running (`READY 1/1`):
9999

@@ -116,7 +116,7 @@ As mentioned in the previous section, the number of OHS servers running is depen
116116
$ kubectl -n <namespace> patch deployment ohs-domain -p '{"spec": {"replicas": <replica count>}}'
117117
```
118118

119-
where `<replica count>` is the number of OHS servers you want to run.
119+
where `<replica count>` is the number of OHS servers you want to run.
120120

121121
In the example below, replicas is dropped to `1` so only one OHS is running:
122122

@@ -149,7 +149,6 @@ As mentioned in the previous section, the number of OHS servers running is depen
149149
ohs-domain-d5b648bc5-2q8bw 0/1 Terminating 0 12m
150150
ohs-domain-d5b648bc5-qvdjn 0/1 Terminating 0 12m
151151
ohs-domain-d5b648bc5-vkp4s 1/1 Running 0 5h31m
152-
153152
```
154153

155154
Two pods now have a `STATUS` of `Terminating`. Keep executing the command until the pods have disappeared and you are left with the one OHS pod:

0 commit comments

Comments
 (0)