Skip to content

Commit 91a8c1c

Browse files
SOA blogs links and other info updated (#1459)
* SOA doc updates regarding early access * incorporated review comments * Updated the content to pull FMW infra image * Added content about patch 27117282 * Updated links and Domain URLs * Added SOA blogs links and missing information * incorporated review comments * fix for osb domain creation failure bug 30806072 Co-authored-by: Mark Nelson <mark.x.nelson@oracle.com>
1 parent ce622de commit 91a8c1c

File tree

4 files changed

+60
-13
lines changed

4 files changed

+60
-13
lines changed

docs-source/content/samples/simple/domains/soa-domain/_index.md

Lines changed: 48 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,57 @@ artifacts of the corresponding domain.
1919

2020
#### Prerequisites
2121

22-
Before you begin, we recommend the following:
22+
Before you begin, perform the following steps:
2323

2424
* Review the [Domain resource]({{< relref "/userguide/managing-domains/domain-resource/_index.md" >}}) documentation.
25-
* Review the [operator prerequisites](https://oracle.github.io/weblogic-kubernetes-operator/userguide/introduction/introduction/#operator-prerequisites)
26-
section for the supported versions of Kubernetes and Helm.
27-
* Complete the preliminary required steps documented [here]({{< relref "/userguide/managing-fmw-domains/soa-suite/_index.md" >}}).
25+
* Review the [system requirements]({{< relref "/userguide/managing-fmw-domains/soa-suite#prerequisites-for-soa-suite-domains" >}}) for deploying Oracle SOA Suite domains on Kubernetes.
26+
* Make sure that Kubernetes is set up in the environment. For details, see the [Kubernetes setup guide]({{< relref "/userguide/overview/k8s-setup.md" >}}).
27+
* Make sure that the WebLogic Kubernetes operator is running. See [Manage operators]({{< relref "/userguide/managing-operators/_index.md" >}}) for operator infrastructure setup and [Install the operator]({{< relref "/userguide/managing-operators/installation/_index.md" >}}) for operator installation. Make sure you install the operator version 2.4.0.
28+
* Create a Kubernetes namespace (for example, `soans`) for the domain unless you intend to use the default namespace. Use the newly created namespace in all the other steps.
29+
For details, see [Prepare to run a domain]({{< relref "/userguide/managing-domains/prepare.md" >}}).
2830

31+
```
32+
$ kubectl create namespace soans
33+
```
34+
35+
* In the Kubernetes namespace created above, create the PV and PVC for the database
36+
by running the [create-pv-pvc.sh]({{< relref "/samples/simple/storage/_index.md" >}}) script.
37+
Follow the instructions for using the scripts to create a PV and PVC.
38+
39+
* Change the values in the [create-pv-pvc-inputs.yaml](https://github.com/oracle/weblogic-kubernetes-operator/blob/master/kubernetes/samples/scripts/create-weblogic-domain-pv-pvc/create-pv-pvc-inputs.yaml) file based on your requirements.
40+
41+
* Ensure that the path mentioned for the `weblogicDomainStoragePath` property does exists (if not, you need to create it), has read and write access permissions, and it must be an empty directory.
42+
43+
* Create the Kubernetes secrets `username` and `password` of the administrative account in the same Kubernetes
44+
namespace as the domain. For details, see this [document](https://github.com/oracle/weblogic-kubernetes-operator/blob/master/kubernetes/samples/scripts/create-weblogic-domain-credentials/README.md).
45+
46+
```bash
47+
$ cd kubernetes/samples/scripts/create-weblogic-domain-credentials
48+
$ ./create-weblogic-credentials.sh -u weblogic -p Welcome1 -n soans -d soainfra -s soainfra-domain-credentials
49+
```
50+
51+
You can check the secret with the `kubectl get secret` command. See the following example, including the output:
52+
53+
```bash
54+
$ kubectl get secret soainfra-domain-credentials -o yaml -n soans
55+
apiVersion: v1
56+
data:
57+
password: V2VsY29tZTE=
58+
username: d2VibG9naWM=
59+
kind: Secret
60+
metadata:
61+
creationTimestamp: 2019-06-02T07:05:25Z
62+
labels:
63+
weblogic.domainName: soainfra
64+
weblogic.domainUID: soainfra
65+
name: soainfra-domain-credentials
66+
namespace: soans
67+
resourceVersion: "11561988"
68+
selfLink: /api/v1/namespaces/soans/secrets/soainfra-domain-credentials
69+
uid: a91ef4e1-6ca8-11e9-8143-fa163efa261a
70+
type: Opaque
71+
```
72+
* Complete the other preliminary required steps documented [here]({{< relref "/userguide/managing-fmw-domains/soa-suite/_index.md" >}}).
2973

3074
#### Prepare to use the create domain script
3175

docs-source/content/userguide/managing-fmw-domains/soa-suite/_index.md

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -193,12 +193,8 @@ Oracle Support for Database Running on Docker (Doc ID 2216342.1).
193193
Follow these instructions to perform a basic deployment of the Oracle
194194
database in Kubernetes. For more details about database setup and configuration, refer to this [page]({{< relref "/userguide/managing-fmw-domains/fmw-infra/_index.md#running-the-database-inside-kubernetes" >}}).
195195

196-
When running the Oracle database in Kubernetes, you have an option
197-
to attach persistent volumes (PV) so that the database storage will
198-
be persisted across database restarts.
199-
If you prefer not to persist the database storage, follow the instructions in this
200-
[document](https://github.com/oracle/weblogic-kubernetes-operator/tree/master/kubernetes/samples/scripts/create-rcu-schema#create-the-rcu-schema-in-the-oracle-database)
201-
to set up a database in a container with no persistent volume (PV) attached.
196+
When running the Oracle database in Kubernetes, you have an option to attach persistent volumes (PV) so that the database storage will be persisted across database restarts. If you prefer not to persist the database storage, follow the instructions in this
197+
[document](https://github.com/oracle/weblogic-kubernetes-operator/tree/master/kubernetes/samples/scripts/create-rcu-schema#start-an-oracle-database-service-in-a-kubernetes-cluster) to set up a database in a container with no persistent volume (PV) attached.
202198

203199
>**NOTE**: `start-db-service.sh` creates the database in the `default` namespace. If you
204200
>want to create the database in a different namespace, you need to manually update
@@ -422,7 +418,7 @@ Now you can access the Oracle SOA Suite domain URLs, as listed below, based on t
422418

423419
http://\<hostname\>:\<port\>/weblogic/ready
424420
http://\<hostname\>:\<port\>/console
425-
http://\<hostname\>:\<port\>/em
421+
http://\<hostname\>:\<port\>/em
426422
http://\<hostname\>:\<port\>/soa-infra
427423
http://\<hostname\>:\<port\>/soa/composer
428424
http://\<hostname\>:\<port\>/integration/worklistapp

kubernetes/samples/scripts/create-soa-domain/README.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,4 +25,11 @@ Refer to the [User guide](https://oracle.github.io/weblogic-kubernetes-operator/
2525

2626
### Getting started
2727

28-
The fastest way to experience the operator is to follow the [User guide](https://oracle.github.io/weblogic-kubernetes-operator/userguide/managing-fmw-domains/soa-suite/).
28+
For detailed information about deploying Oracle SOA Suite domains, see the [User guide](https://oracle.github.io/weblogic-kubernetes-operator/userguide/managing-fmw-domains/soa-suite/).
29+
30+
### Additional Resources
31+
32+
* [Using JDeveloper to Deploy Composites](https://blogs.oracle.com/integration/deploying-soa-composites-from-oracle-jdeveloper-to-oracle-soa-in-weblogic-kubernetes-operator-environment)
33+
* [Expose T3 protocol for Managed Servers in SOA Domain](https://blogs.oracle.com/integration/expose-t3-protocol-for-managed-servers-in-soa-domain-on-kubernetes)
34+
* [Persisting SOA Adapters Customizations](https://blogs.oracle.com/integration/persisting-soa-adapters-customizations)
35+

kubernetes/samples/scripts/create-soa-domain/domain-home-on-pv/common/createSOADomain.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -390,7 +390,7 @@ def extendOsbDomain(self, domainHome, db, dbPrefix, dbPassword, exposeAdminT3Cha
390390
self.applyOSBTemplates()
391391
print 'Extension Templates added'
392392

393-
if 'osb_server1' not in self.ADDL_MANAGED_SERVERS:
393+
if 'osb_server1' not in self.MANAGED_SERVERS and 'osb_server1' not in self.ADDL_MANAGED_SERVERS:
394394
print 'INFO: deleting osb_server1'
395395
cd('/')
396396
delete('osb_server1','Server')

0 commit comments

Comments
 (0)