Frequently Asked Questions

Overriding tuning parameters is not supported using configuration overrides

The Oracle WebLogic Server Kubernetes operator enables you to override some of the domain configuration using configuration overrides (also called situational configuration). See supported overrides. Overriding the tuning parameters such as MaxMessageSize and PAYLOAD, for Oracle SOA Suite domains is not supported using the configuration overrides feature. However, you can override them using the following steps:

  1. Specify the new value using the environment variable K8S_REFCONF_OVERRIDES in serverPod.env section in domain.yaml configuration file (example path: <domain-creation-output-directory>/weblogic-domains/soainfra/domain.yaml) based on the servers to which the changes are to be applied.

    For example, to override the value at the Administration Server pod level:

      spec:
    adminServer:
      serverPod:
        env:
        - name: K8S_REFCONF_OVERRIDES
          value: "-Dweblogic.MaxMessageSize=78787878"
        - name: USER_MEM_ARGS
          value: '-Djava.security.egd=file:/dev/./urandom -Xms512m -Xmx1024m '
      serverStartState: RUNNING

    For example, to override the value at a specific cluster level (soa_cluster or osb_cluster):

      - clusterName: soa_cluster
  serverService:
    precreateService: true
  serverStartState: "RUNNING"
  serverPod:
    env:
    - name: K8S_REFCONF_OVERRIDES
      value: "-Dsoa.payload.threshold.kb=102410"

    Note: When multiple system properties are specified for serverPod.env.value, make sure each system property is separated by a space.

  2. Apply the updated domain.yaml file:

    $ kubectl apply -f domain.yaml

    Note: The server pod(s) will be automatically restarted (rolling restart).

Deployments in the WebLogic Server Administration Console may display unexpected error

In an Oracle SOA Suite environment deployed using the operator, accessing Deployments from the WebLogic Server Administration Console home page may display the error message Unexpected error encountered while obtaining monitoring information for applications. This error does not have any functional impact and can be ignored. You can verify that the applications are in Active state from the Control tab in Summary of deployments page.

Enterprise Manager Console may display ADF_FACES-30200 error

In an Oracle SOA Suite environment deployed using the operator, the Enterprise Manager Console may intermittently display the following error when the domain servers are restarted:

ADF_FACES-30200: For more information, please see the server's error log for an entry beginning with: The UIViewRoot is null. Fatal exception during PhaseId: RESTORE_VIEW 1.

You can refresh the Enterprise Manager Console URL to successfully log in to the Console.

Configure the external URL access for Oracle SOA Suite composite applications

For Oracle SOA Suite composite applications to access the external URLs over the internet (if your cluster is behind a http proxy server), you must configure the following proxy parameters for Administration Server and Managed Server pods.

-Dhttp.proxyHost=www-your-proxy.com  
-Dhttp.proxyPort=proxy-port  
-Dhttps.proxyHost=www-your-proxy.com  
-Dhttps.proxyPort=proxy-port  
-Dhttp.nonProxyHosts="localhost|soainfra-adminserver|soainfra-soa-server1|soainfra-osb-server1|...soainfra-soa-serverN|*.svc.cluster.local|*.your.domain.com|/var/run/docker.sock"

To do this, edit the domain.yaml configuration file and append the proxy parameters to the spec.serverPod.env.JAVA_OPTIONS environment variable value.

For example:

  serverPod:
    env:
    - name: JAVA_OPTIONS
      value: -Dweblogic.StdoutDebugEnabled=false -Dweblogic.ssl.Enabled=true -Dweblogic.security.SSL.ignoreHostnameVerification=true -Dhttp.proxyHost=www-your-proxy.com -Dhttp.proxyPort=proxy-port -Dhttps.proxyHost=www-your-proxy.com -Dhttps.proxyPort=proxy-port -Dhttp.nonProxyHosts="localhost|soainfra-adminserver|soainfra-soa-server1|soainfra-osb-server1|...soainfra-soa-serverN|*.svc.cluster.local|*.your.domain.com|/var/run/docker.sock"
    - name: USER_MEM_ARGS
      value: '-Djava.security.egd=file:/dev/./urandom -Xms256m -Xmx1024m '
    volumeMounts:

Note: The -Dhttp.nonProxyHosts parameter must have the pod names of the Administration Server and each Managed Server. For example: soainfra-adminserver, soainfra-soa-server1, soainfra-osb-server1, and so on.

Apply the updated domain.yaml file:

 $ kubectl apply -f domain.yaml

Note: The server pod(s) will be automatically restarted (rolling restart).

Configure the external access for the Oracle Enterprise Scheduler WebServices WSDL URLs

In an Oracle SOA Suite domain deployed including the Oracle Enterprise Scheduler (ESS) component, the following ESS WebServices WSDL URLs shown in the table format in the ess/essWebServicesWsdl.jsp page are not reachable outside the Kubernetes cluster.

ESSWebService
EssAsyncCallbackService
EssWsJobAsyncCallbackService

Follow these steps to configure the external access for the Oracle Enterprise Scheduler WebServices WSDL URLs:

  1. Log in to the Administration Console URL of the domain.
    For example: http://<LOADBALANCER-HOST>:<port>/console
  2. In the Home Page, click Clusters. Then click the soa_cluster.
  3. Click the HTTP tab and then click Lock & Edit in the Change Center panel.
  4. Update the following values:
    • Frontend Host: host name of the load balancer. For example, domain1.example.com.
    • Frontend HTTP Port: load balancer port. For example, 30305.
    • Frontend HTTPS Port: load balancer https port. For example, 30443.
  5. Click Save.
  6. Click Activate Changes in the Change Center panel.
  7. Restart the servers in the SOA cluster.

Note: Do not restart servers from the Administration Console.

Oracle WebLogic Server Kubernetes Operator FAQs

See the general frequently asked questions for using the Oracle WebLogic Server Kubernetes operator.