Oracle SOA Suite on Kubernetes documentation and script changes for release 25.1.2 (#241)

Author: ashageetha

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

@@ -1,4 +1,4 @@
-# Copyright (c) 2020, 2024, Oracle and/or its affiliates.
+# Copyright (c) 2020, 2025, Oracle and/or its affiliates.
 # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
 
 import os
@@ -91,23 +91,31 @@ def createSOADomain(self, domainName, user, password, db, dbPrefix, dbPassword,
 
         readDomain(domainHome)
         # Update the default port values for default servers for 14.1.2.0.0 
-        if ( self.domainVersion == "14.1.2.0.0" and self.secureDomain == 'false' ):
+        if ( self.domainVersion == "14.1.2.0.0" ):
             if ("soa" in domainType and 'soa_server1' in self.SOA_MANAGED_SERVERS ):
-               self.updateDefaultServerParameters(domainHome, sslEnabled, "soa_server1")
+               self.updateDefaultServerParameters(domainHome, sslEnabled, "soa_server1", soaManagedServerPort, soaManagedServerSSLPort, soaAdministrationPort)
             if "osb" in domainType and 'osb_server1' in self.OSB_MANAGED_SERVERS:
-               self.updateDefaultServerParameters(domainHome, sslEnabled, "osb_server1")
+               self.updateDefaultServerParameters(domainHome, sslEnabled, "osb_server1", osbManagedServerPort, osbManagedServerSSLPort, osbAdministrationPort)
 
         # Fix for bug 36654711
         self.updateAppTarget(domainHome,"wsm-pm",adminName)
         updateDomain()
 
 
-    def updateDefaultServerParameters(self, domainHome, sslEnabled, serverName):
+    def updateDefaultServerParameters(self, domainHome, sslEnabled, serverName, ms_port, ms_ssl_port , ms_admin_port):
         print 'Removing administrationPort and SSL entries for default server ' + serverName
         cd('/Servers/'+ serverName)
-        set('administrationPort', 0)
+        if (self.secureDomain == 'true'):
+           set('administrationPort', int(ms_admin_port))
+        else:
+           set('administrationPort', 0)
+        set('ListenPort', int(ms_port))
         if (sslEnabled == 'false'):
            delete(serverName, 'SSL')
+        else:
+           cd('/Servers/' + serverName + '/SSL/' + serverName)
+           set('ListenPort', int(ms_ssl_port))
+           set('Enabled', 'True')
 
     def updateAppTarget(self, domainHome, appName, targetName):
         print 'Adding target: '+ targetName+' for '+appName

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

@@ -25,7 +25,7 @@ The operator has several key features to assist you with deploying and managing
 
 #### Current production release
 
-The current production release for the Oracle SOA Suite domains deployment on Kubernetes is [24.4.2](https://github.com/oracle/fmw-kubernetes/releases). This release uses the WebLogic Kubernetes Operator version [4.2.9](https://github.com/oracle/weblogic-kubernetes-operator/releases/tag/v4.2.9).
+The current production release for the Oracle SOA Suite domains deployment on Kubernetes is [25.1.2](https://github.com/oracle/fmw-kubernetes/releases). This release uses the WebLogic Kubernetes Operator version [4.2.13](https://github.com/oracle/weblogic-kubernetes-operator/releases/tag/v4.2.13).
 
 
 #### Recent changes and known issues
@@ -64,6 +64,7 @@ please consult this table of contents:
 
 To view documentation for an earlier release, see:
 
+* [Version 24.4.2](https://oracle.github.io/fmw-kubernetes/24.4.2/soa-domains/)
 * [Version 24.3.2](https://oracle.github.io/fmw-kubernetes/24.3.2/soa-domains/)
 * [Version 24.2.2](https://oracle.github.io/fmw-kubernetes/24.2.2/soa-domains/)
 * [Version 24.1.2](https://oracle.github.io/fmw-kubernetes/24.1.2/soa-domains/)

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

@@ -133,7 +133,7 @@ Refer to the [sample](https://github.com/oracle/docker-images/tree/main/OracleWe
 
    {{% /expand %}}
 
-1. Create a PV and PVC (pv-claim-name) that can be used to store the custom_mod_wl_apache.conf. Refer to the [Sample](https://github.com/oracle/weblogic-kubernetes-operator/blob/v4.2.9/kubernetes/samples/scripts/create-weblogic-domain-pv-pvc/README.md) for creating a PV or PVC.
+1. Create a PV and PVC (pv-claim-name) that can be used to store the custom_mod_wl_apache.conf. Refer to the [Sample](https://github.com/oracle/weblogic-kubernetes-operator/blob/v4.2.13/kubernetes/samples/scripts/create-weblogic-domain-pv-pvc/README.md) for creating a PV or PVC.
 
 #### Prepare the certificate and private key
 

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

@@ -202,7 +202,7 @@ Follow these steps to set up NGINX as a load balancer for an Oracle SOA Suite do
 1. Create an ingress for the domain in the domain namespace by using the sample Helm chart. Here path-based routing is used for ingress. Sample values for default configuration are shown in the file `${WORKDIR}/charts/ingress-per-domain/values.yaml`. By default, `type` is `TRAEFIK` , `sslType` is `NONSSL`, and `domainType` is `soa`. These values can be overridden by passing values through the command line or can be edited in the sample file `values.yaml`.   
 If needed, you can update the ingress YAML file to define more path rules (in section `spec.rules.host.http.paths`) based on the domain application URLs that need to be accessed. Update the template YAML file for the NGINX load balancer located at `${WORKDIR}/charts/ingress-per-domain/templates/nginx-ingress.yaml`.
 
-   > Note: See [here](https://github.com/oracle/fmw-kubernetes/blob/v24.2.2/OracleSOASuite/kubernetes/charts/ingress-per-domain/README.md#configuration) for all the configuration parameters.
+   > Note: See [here](https://github.com/oracle/fmw-kubernetes/blob/v25.1.2/OracleSOASuite/kubernetes/charts/ingress-per-domain/README.md#configuration) for all the configuration parameters.
 
    ```bash
     $ cd ${WORKDIR}

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

@@ -156,7 +156,7 @@ Sample values for default configuration are shown in the file `${WORKDIR}/charts
 By default, `type` is `TRAEFIK`, `sslType` is `NONSSL`, and `domainType` is `soa`. These values can be overridden by passing values through the command line or can be edited in the sample file `values.yaml` based on the type of configuration (NONSSL, SSL, and E2ESSL).  
 If needed, you can update the ingress YAML file to define more path rules (in section `spec.rules.host.http.paths`) based on the domain application URLs that need to be accessed. The template YAML file for the Traefik (ingress-based) load balancer is located at `${WORKDIR}/charts/ingress-per-domain/templates/traefik-ingress.yaml`.
 
-> Note: See [here](https://github.com/oracle/fmw-kubernetes/blob/v24.4.2/OracleSOASuite/kubernetes/charts/ingress-per-domain/README.md#configuration) for all the configuration parameters.
+> Note: See [here](https://github.com/oracle/fmw-kubernetes/blob/v25.1.2/OracleSOASuite/kubernetes/charts/ingress-per-domain/README.md#configuration) for all the configuration parameters.
 
 1. Choose an appropriate `LOADBALANCER_HOSTNAME` for accessing the Oracle SOA Suite domain application URLs.
 

docs-source/content/soa-domains/adminguide/monitoring-soa-domains.md

@@ -18,7 +18,7 @@ After the Oracle SOA Suite domain is set up, you can:
 Using the `WebLogic Monitoring Exporter` you can scrape runtime information from a running Oracle SOA Suite instance and monitor them using Prometheus and Grafana.
 
 #### Set up monitoring
-Follow [these steps](https://github.com/oracle/fmw-kubernetes/blob/v24.4.2/OracleSOASuite/kubernetes/monitoring-service/README.md) to set up monitoring for an Oracle SOA Suite instance. For more details on WebLogic Monitoring Exporter, see [here](https://github.com/oracle/weblogic-monitoring-exporter).
+Follow [these steps](https://github.com/oracle/fmw-kubernetes/blob/v25.1.2/OracleSOASuite/kubernetes/monitoring-service/README.md) to set up monitoring for an Oracle SOA Suite instance. For more details on WebLogic Monitoring Exporter, see [here](https://github.com/oracle/weblogic-monitoring-exporter).
 
 ### Publish WebLogic Server logs into Elasticsearch
 

docs-source/content/soa-domains/appendix/quickstart-deployment-on-prem.md

@@ -419,23 +419,23 @@ Refer to the official [documentation](https://kubernetes.io/docs/setup/#producti
 
 1. Create a working directory to set up the source code:
     ```bash
-    $ mkdir $HOME/soa_24.4.2
-    $ cd $HOME/soa_24.4.2
+    $ mkdir $HOME/soa_25.1.2
+    $ cd $HOME/soa_25.1.2
     ```
 
 1. Download the WebLogic Kubernetes Operator source code and  Oracle SOA Suite Kubernetes deployment scripts from the SOA [repository](https://github.com/oracle/fmw-kubernetes.git). Required artifacts are available at `OracleSOASuite/kubernetes`.
 
     ``` bash
     $ git clone https://github.com/oracle/fmw-kubernetes.git
-    $ export WORKDIR=$HOME/soa_24.4.2/fmw-kubernetes/OracleSOASuite/kubernetes
+    $ export WORKDIR=$HOME/soa_25.1.2/fmw-kubernetes/OracleSOASuite/kubernetes
     ```
 
 #### 3.2 Get required Docker images and add them to your local registry
 
 1. Pull the WebLogic Kubernetes Operator image:
 
     ```shell
-    $ podman pull ghcr.io/oracle/weblogic-kubernetes-operator:4.2.9
+    $ podman pull ghcr.io/oracle/weblogic-kubernetes-operator:4.2.13
     ```
 
 1. Obtain the Oracle Database image and Oracle SOA Suite Docker image from the [Oracle Container Registry](https://container-registry.oracle.com):
@@ -486,7 +486,7 @@ Refer to the official [documentation](https://kubernetes.io/docs/setup/#producti
    ```shell
    $ helm install weblogic-kubernetes-operator weblogic-operator/weblogic-operator \
      --namespace opns \
-     --version 4.2.9 \
+     --version 4.2.13 \
      --set serviceAccount=op-sa \
      --wait
    ```
@@ -503,7 +503,7 @@ Refer to the official [documentation](https://kubernetes.io/docs/setup/#producti
    $ kubectl logs -n opns -c weblogic-operator deployments/weblogic-operator
    ```
 
-The WebLogic Kubernetes Operator v4.2.9 has been installed. Continue with the load balancer and Oracle SOA Suite domain setup.
+The WebLogic Kubernetes Operator v4.2.13 has been installed. Continue with the load balancer and Oracle SOA Suite domain setup.
 
 ### 5. Install the Traefik (ingress-based) load balancer