SOA 20.4.2 deployment scripts and documentation updates

SOA 20.4.2 Release with OCT 2020 CPU.

Author: sbattagi

OracleSOASuite/kubernetes/README.md

@@ -9,7 +9,7 @@ The Oracle WebLogic Server Kubernetes Operator (the “operator”) supports dep
 * `soaessosb`: Deploys a domain with SOA, OSB, and ESS
 
 ***
-The current supported production release is [20.3.3](https://github.com/oracle/fmw-kubernetes/releases).
+The current supported production release is [20.4.2](https://github.com/oracle/fmw-kubernetes/releases).
 ***
 
 In this release, Oracle SOA Suite domains are supported using the “domain on a persistent volume”

OracleSOASuite/kubernetes/create-database/README.md

@@ -3,6 +3,7 @@
 ENV ORACLE_HOME=/u01/oracle \
     VOLUME_DIR=/u01/oracle/user_projects \
     SCRIPT_FILE=/u01/oracle/container-scripts/* \
+    HEALTH_SCRIPT_FILE=/u01/oracle/container-scripts/get_healthcheck_url.sh \
     JAVA_OPTIONS="-Doracle.jdbc.fanEnabled=false -Dweblogic.StdoutDebugEnabled=false" \
     PATH=$PATH:/usr/java/default/bin:/u01/oracle/oracle_common/common/bin:/u01/oracle/wlserver/common/bin:/u01/oracle/container-scripts
 
@@ -17,5 +18,6 @@ COPY --chown=oracle:oracle files/container-scripts/ /u01/oracle/container-script
 RUN chmod +xr $SCRIPT_FILE
 
 USER oracle
+HEALTHCHECK --start-period=5m --interval=1m CMD curl -k -s --fail `$HEALTH_SCRIPT_FILE` || exit 1
 WORKDIR ${ORACLE_HOME}
 CMD ["/u01/oracle/container-scripts/createDomainAndStart.sh"]

OracleSOASuite/kubernetes/create-database/db-with-pv.yaml

@@ -27,7 +27,8 @@ The operator has several key features to assist you with deploying and managing
 
 #### Current production release
 
-The current supported production release of the Oracle WebLogic Server Kubernetes Operator, for Oracle SOA Suite domains deployment is [3.0.1](https://github.com/oracle/weblogic-kubernetes-operator/releases).
+The current production release for the Oracle SOA Suite domains deployment on Kubernetes is [20.4.2](https://github.com/oracle/fmw-kubernetes/releases). This release uses the Oracle WebLogic Server Kubernetes Operator version [3.0.1](https://github.com/oracle/weblogic-kubernetes-operator/releases).
+
 
 #### Recent changes and known issues
 
@@ -55,6 +56,11 @@ please consult this table of contents:
    * Removing/deleting domains.
    * And much more!
 
+#### Documentation for earlier releases
+
+If you wish to view documentation for an older version, please see 
+
+* [Version 20.3.3]({{< relref "/20.3.3/soa-domains/" >}})
 
 #### Additional reading
 

OracleSOASuite/kubernetes/imagetool-scripts/additionalBuildCmds.txt

@@ -30,7 +30,7 @@ Follow these steps to set up Traefik as a load balancer for an Oracle SOA Suite
 
 #### Install the Traefik (ingress-based) load balancer
 
-1. Use Helm to install the Traefik (ingress-based) load balancer. For detailed information, see [here](https://github.com/oracle/weblogic-kubernetes-operator/blob/master/kubernetes/samples/charts/traefik/README.md).
+1. Use Helm to install the Traefik (ingress-based) load balancer.
 Use the `values.yaml` file in the sample but set `kubernetes.namespaces` specifically.
 
 
@@ -193,7 +193,7 @@ If needed, you can update the ingress YAML file to define more path rules (in se
 
    ```bash
     $ openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /tmp/tls1.key -out /tmp/tls1.crt -subj "/CN=*"
-    $ kubectl -n soans create secret tls domain1-tls-cert --key /tmp/tls1.key --cert /tmp/tls1.crt
+    $ kubectl -n soans create secret tls soainfra-tls-cert --key /tmp/tls1.key --cert /tmp/tls1.crt
    ```
 
 1. Create Traefik Middleware custom resource
@@ -226,7 +226,7 @@ If needed, you can update the ingress YAML file to define more path rules (in se
      namespace: soans
    spec:
      defaultCertificate:
-       secretName:  domain1-tls-cert   
+       secretName:  soainfra-tls-cert   
    EOF
    ```
 
@@ -384,7 +384,7 @@ $ helm delete soa-traefik-ingress  -n soans
 
 #### Install the Traefik load balancer for end-to-end SSL
 
-1. Use Helm to install the Traefik (ingress-based) load balancer. For detailed information, see [here](https://github.com/oracle/weblogic-kubernetes-operator/blob/master/kubernetes/samples/charts/traefik/README.md).
+1. Use Helm to install the Traefik (ingress-based) load balancer.
 Use the `values.yaml` file in the sample but set `kubernetes.namespaces` specifically.
 
 

docs-source/content/soa-domains/_index.md

@@ -608,7 +608,7 @@ Follow these steps to build an Oracle Fusion Middleware Infrastructure image, an
 
    >Note: Copy the installer binaries to the same location as the Dockerfile.
 
-1. To build the Oracle SOA Suite image with patches, you must download and drop the patch zip files (for example, `p29928100_122140_Generic.zip`) into the `patches/` folder under the version that is required. For example, for `12.2.1.4.0` the folder is `12.2.1.4/patches`.
+1. To build the Oracle SOA Suite image with patches, you must download and drop the patch zip files (for example, `p29928100_122140_Generic.zip`) into the `patches/` folder under the version that is required. For example, for `12.2.1.4.0` the folder is `12.2.1.4/patches`. Similarly, to build the image by including the OPatch patch, download and drop the OPatch patch zip file (for e.g. `p28186730_139424_Generic.zip`) into the `opatch_patch/` folder.
 
 1. Create the Oracle SOA Suite image by running the provided script:
 
@@ -617,8 +617,8 @@ Follow these steps to build an Oracle Fusion Middleware Infrastructure image, an
     $ ./buildDockerImage.sh -v 12.2.1.4 -s
     ```
 
-    The image produced will be named `oracle/soa:12.2.1.4`. The samples and instructions assume the Oracle SOA Suite image is named `soasuite:12.2.1.4`. You must rename your image to match this name, or update the samples to refer to the image you created.
+    The image produced will be named `oracle/soasuite:12.2.1.4`. The samples and instructions assume the Oracle SOA Suite image is named `soasuite:12.2.1.4`. You must rename your image to match this name, or update the samples to refer to the image you created.
 
     ```bash
-    $ docker tag oracle/soa:12.2.1.4 soasuite:12.2.1.4
+    $ docker tag oracle/soasuite:12.2.1.4 soasuite:12.2.1.4
     ```

docs-source/content/soa-domains/adminguide/configure-load-balancer/traefik.md

@@ -64,7 +64,7 @@ Oracle SOA Suite domain deployment on Kubernetes leverages the WebLogic Kubernet
 
 1. Create a working directory to set up the source code:
    ```bash
-   $ export WORKDIR=$HOME/soa_20.3.3
+   $ export WORKDIR=$HOME/soa_20.4.2
    $ mkdir ${WORKDIR}
    ```
 
@@ -77,16 +77,14 @@ Oracle SOA Suite domain deployment on Kubernetes leverages the WebLogic Kubernet
 1. Download the Oracle SOA Suite Kubernetes deployment scripts from the SOA [repository](https://github.com/oracle/fmw-kubernetes.git) and copy them to the WebLogic Kubernetes operator samples location:
 
     ``` bash
-    $ git clone https://github.com/oracle/fmw-kubernetes.git --branch release/20.3.3
+    $ git clone https://github.com/oracle/fmw-kubernetes.git --branch release/20.4.2
 
     $ mv -f ${WORKDIR}/weblogic-kubernetes-operator/kubernetes/samples/scripts/create-soa-domain  ${WORKDIR}/weblogic-kubernetes-operator/kubernetes/samples/scripts/create-soa-domain_backup
     $ cp -rf ${WORKDIR}/fmw-kubernetes/OracleSOASuite/kubernetes/create-soa-domain  ${WORKDIR}/weblogic-kubernetes-operator/kubernetes/samples/scripts/
 
-     $ mv -f ${WORKDIR}/weblogic-kubernetes-operator/kubernetes/samples/scripts/common  ${WORKDIR}/weblogic-kubernetes-operator/kubernetes/samples/scripts/common_backup
+    $ mv -f ${WORKDIR}/weblogic-kubernetes-operator/kubernetes/samples/scripts/common  ${WORKDIR}/weblogic-kubernetes-operator/kubernetes/samples/scripts/common_backup
     $ cp -rf ${WORKDIR}/fmw-kubernetes/OracleSOASuite/kubernetes/common  ${WORKDIR}/weblogic-kubernetes-operator/kubernetes/samples/scripts/
 
-    $ cp -rf ${WORKDIR}/fmw-kubernetes/OracleSOASuite/kubernetes/create-database  ${WORKDIR}/weblogic-kubernetes-operator/kubernetes/samples/scripts/
-
     $ mv -f ${WORKDIR}/weblogic-kubernetes-operator/kubernetes/samples/scripts/create-rcu-schema  ${WORKDIR}/weblogic-kubernetes-operator/kubernetes/samples/scripts/create-rcu-schema_backup
     $ cp -rf ${WORKDIR}/fmw-kubernetes/OracleSOASuite/kubernetes/create-rcu-schema  ${WORKDIR}/weblogic-kubernetes-operator/kubernetes/samples/scripts/
 
@@ -106,14 +104,14 @@ You can now use the deployment scripts from `${WORKDIR}/weblogic-kubernetes-oper
 
 The Oracle SOA Suite image with latest bundle patch and required interim patches can be obtained from My Oracle Support (MOS). This is the only image supported for production deployments. Follow the below steps to download the Oracle SOA Suite image from My Oracle Support.
 
-1. Download the patch `31966923` from My Oracle Support (MOS).
+1. Download the patch `32215749` from My Oracle Support (MOS).
 1. Unzip the downloaded patch zip file.
 1. Load the image archive using `docker load` command:
 
    For example:
    ```bash
-   $ docker load < soasuite.12214.tar
-   Loaded image: soasuite:12.2.1.4
+   $ docker load < soasuite.12214.2042.tar
+   Loaded image: soasuite:12.2.1.4-20.4.2
    $
    ```
 

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

@@ -10,15 +10,16 @@ This section provides information about the system requirements and limitations
 
 ### System requirements for Oracle SOA Suite domains
 
-For the current production release 20.3.3:
+For the current production release 20.4.2:
 
 * Oracle Linux 7 (UL6+) and Red Hat Enterprise Linux 7 (UL3+ only with standalone Kubernetes) are supported.
+* Oracle Linux Cloud Native Environment (OLCNE) version 1.1.2 is supported.
 * Kubernetes 1.14.8+, 1.15.7+, 1.16.0+, 1.17.0+, and 1.18.0+ (check with `kubectl version`).
 * Docker 18.09.1ce+, 19.03.1+ (check with `docker version`) or CRI-O 1.14.7 (check with `crictl version | grep RuntimeVersion`).
 * Flannel networking v0.9.1-amd64 or later (check with `docker images | grep flannel`).
 * Helm 3.1.3+ (check with `helm version --client --short`).
 * Oracle WebLogic Kubernetes operator 3.0.1 (see [operator releases](https://github.com/oracle/weblogic-kubernetes-operator/releases) page).
-* Oracle SOA Suite 12.2.1.4 Docker image downloaded from My Oracle Support (MOS patch 31966923). This image contains the latest bundle patch and one-off patches for Oracle SOA Suite.
+* Oracle SOA Suite 12.2.1.4 Docker image downloaded from My Oracle Support (MOS patch 32215749). This image contains the latest bundle patch and one-off patches for Oracle SOA Suite.
 * You must have the `cluster-admin` role to install the operator. The operator does not need the `cluster-admin` role at runtime.
 * We do not currently support running SOA in non-Linux containers.
 * Additionally, see the Oracle SOA Suite [documentation](https://docs.oracle.com/en/middleware/fusion-middleware/12.2.1.4/insoa/preparing-install-and-configure-product.html#GUID-E2D4D481-BE80-4600-8078-FD9C03A30210) for other requirements such as database version.
@@ -45,5 +46,6 @@ following limitations currently exist for Oracle SOA Suite domains:
 * Some features such as multicast, multitenancy, production redeployment, and Node Manager (although it is used internally for the liveness probe and to start WebLogic Server instances) are not supported in this release.
 * Features such as Java Messaging Service whole server migration, consensus leasing, and maximum availability architecture (Oracle SOA Suite EDG setup) are not supported in this release.
 * Enabling or disabling the memory resiliency for Oracle Service Bus using the Enterprise Manager Console is not supported in this release.
+* Zero downtime upgrade (ZDT) of the domain is not supported.
 
 For up-to-date information about the features of WebLogic Server that are supported in Kubernetes environments, see My Oracle Support Doc ID 2349228.1.

docs-source/content/soa-domains/installguide/prepare-your-environment/_index.md

@@ -18,11 +18,16 @@ If you have access to the Oracle SOA Suite patches, you can patch an existing Or
 
 #### Apply the patched image
 
-1. Update the `image:` field in `domain.yaml` configuration file with the patched image.
+1. Shut down the domain, by updating the `spec.serverStartPolicy:` field value to `NEVER` in `domain.yaml` configuration file and apply the updated `domain.yaml` file.
+    
+    ``` bash
+    $ kubectl apply -f domain.yaml
+    ```
+
+1. In `domain.yaml` configuration file, update the `image:` field value with the patched image and also update the `spec.serverStartPolicy:` field value to `IF_NEEDED`.
 
-1. Apply the updated `domain.yaml` configuration file:
+1. Apply the updated `domain.yaml` configuration file, to start up the domain.
 
     ``` bash
     $ kubectl apply -f domain.yaml
     ```
-> Note: The server pods will be automatically restarted (rolling restart).