This use case demonstrates dynamically changing the Work Manager threads constraint and data source configuration in your running domain without restarting (rolling) running WebLogic Servers. This use case requires that the Update 1 use case has been run and expects that its sample-domain1
domain is deployed and running.
In the use case, you will:
Here are the steps:
Make sure that you have deployed the domain from the Update 1 use case, or have deployed an updated version of this same domain from the Update 3 use case.
There should be three WebLogic Server pods with names that start with sample-domain1
running in the sample-domain1-ns
namespace, a domain named sample-domain1
, a ConfigMap named sample-domain1-wdt-config-map
, and a Secret named sample-domain1-datasource-secret
.
Add the Work Manager threads constraint configuration WDT model updates to the existing data source model updates in the Model in Image model ConfigMap.
In this step, we will update the model ConfigMap from the Update 1 use case with the desired changes to the minimum and maximum threads constraints.
Here’s an example model configuration that updates the configured count values for the SampleMinThreads
minimum threads constraint and SampleMaxThreads
maximum threads constraint:
resources:
SelfTuning:
MinThreadsConstraint:
SampleMinThreads:
Count: 2
MaxThreadsConstraint:
SampleMaxThreads:
Count: 20
Optionally, place the preceding model snippet in a file named /tmp/sample/myworkmanager.yaml
and then use it when deploying the updated model ConfigMap, or simply use the same model snippet that’s provided in /tmp/sample/model-configmaps/workmanager/model.20.workmanager.yaml
.
Run the following commands:
$ kubectl -n sample-domain1-ns delete configmap sample-domain1-wdt-config-map
$ kubectl -n sample-domain1-ns create configmap sample-domain1-wdt-config-map \
--from-file=/tmp/sample/model-configmaps/workmanager \
--from-file=/tmp/sample/model-configmaps/datasource
$ kubectl -n sample-domain1-ns label configmap sample-domain1-wdt-config-map \
weblogic.domainUID=sample-domain1
Notes:
--from-file=
parameters (we suggested /tmp/sample/myworkmanager.yaml
and /tmp/sample/mydatasource.xml
earlier).-from-file=
parameter can reference a single file, in which case it puts the designated file in the ConfigMap, or it can reference a directory, in which case it populates the ConfigMap with all of the files in the designated directory. It can be specified multiple times on the same command line to load the contents from multiple locations into the ConfigMap.weblogic.domainUID
label as a convenience for finding all resources associated with a domain.Update the data source secret that you created in the Update 1 use case with the correct password as well as with an increased maximum pool capacity:
NOTE: Replace MY_ORACLE_SYS_PASSWORD with the same database sys
account password
that you chose (or plan to choose) when deploying the database.
$ kubectl -n sample-domain1-ns delete secret sample-domain1-datasource-secret
$ kubectl -n sample-domain1-ns create secret generic \
sample-domain1-datasource-secret \
--from-literal='user=sys as sysdba' \
--from-literal='password=MY_ORACLE_SYS_PASSWORD' \
--from-literal='max-capacity=10' \
--from-literal='url=jdbc:oracle:thin:@oracle-db.default.svc.cluster.local:1521/devpdb.k8s'
$ kubectl -n sample-domain1-ns label secret \
sample-domain1-datasource-secret \
weblogic.domainUID=sample-domain1
Update your Domain YAML file to enable onlineUpdate
.
If onlineUpdate
is enabled for your domain and the only model changes are to WebLogic Domain dynamic attributes, then the operator will attempt to update the running domains online without restarting the servers when you update the domain’s introspectVersion
.
Option 1: Edit your domain custom resource.
kubectl -n sample-domain1-ns edit domain sample-domain1
.spec.configuration.model.onlineUpdate
stanza so it contains enabled: true
and save....
spec:
...
configuration:
...
model:
...
onlineUpdate:
enabled: true
Option 2: Dynamically change your domain using kubectl patch
. For example:
$ kubectl -n sample-domain1-ns patch domain sample-domain1 --type=json '-p=[{"op": "replace", "path": "/spec/configuration/model/onlineUpdate", "value": {"enabled" : 'true'} }]'
Option 3: Use the sample helper script.
/tmp/sample/utils/patch-enable-online-update.sh -n sample-domain1-ns -d sample-domain1
.kubectl patch
commands as Option 2.Prompt the operator to introspect the updated WebLogic domain configuration.
Now that the updated Work Manager configuration is deployed in an updated model ConfigMap and the updated data source configuration is reflected in the updated data source Secret, we need to have the operator rerun its introspector job to regenerate its configuration.
Change the spec.introspectVersion
of the domain to trigger domain introspection.
To do this:
Option 1: Edit your domain custom resource.
kubectl -n sample-domain1-ns edit domain sample-domain1
.spec.introspectVersion
field and save.Option 2: Dynamically change your domain using kubectl patch
.
Get the current introspectVersion
:
$ kubectl -n sample-domain1-ns get domain sample-domain1 '-o=jsonpath={.spec.introspectVersion}'
Choose a new introspect version that’s different from the current introspect version.
Use kubectl patch
to set the new value. For example, assuming the new introspect version is 2
:
$ kubectl -n sample-domain1-ns patch domain sample-domain1 --type=json '-p=[{"op": "replace", "path": "/spec/introspectVersion", "value": "2" }]'
Option 3: Use the sample helper script.
/tmp/sample/utils/patch-introspect-version.sh -n sample-domain1-ns -d sample-domain1
.kubectl patch
command as Option 2.Because we have set the enabled
value in spec.configuration.model.onlineUpdate
to true
, and all of
the model changes we have specified are for WebLogic dynamic configuration attributes, we expect that the
domain introspector job will apply the changes to the WebLogic Servers without restarting (rolling) their pods.
Wait for the introspector job to run to completion. You can:
Call kubectl get pods -n sample-domain1-ns --watch
and wait for the introspector pod to get into Terminating
state and exit.
sample-domain1-introspector-vgxxl 0/1 Terminating 0 78s
For a more detailed view of this activity,
you can use the waitForDomain.sh
sample lifecycle script.
This script provides useful information about a domain’s pods and
optionally waits for its Completed
status condition to become True
.
A Completed
domain indicates that all of its expected
pods have reached a ready
state
plus their target restartVersion
, introspectVersion
, and image
.
For example:
$ cd /tmp/weblogic-kubernetes-operator/kubernetes/samples/scripts/domain-lifecycle
$ ./waitForDomain.sh -n sample-domain1-ns -d sample-domain1 -p Completed
If the introspector job fails, then consult Debugging.
Call the sample web application to:
Send a web application request to the ingress controller:
$ curl -s -S -m 10 -H 'host: sample-domain1-cluster-cluster-1.sample.org' \
http://localhost:30305/myapp_war/index.jsp
Or, if Traefik is unavailable and your Administration Server pod is running, you can run kubectl exec
:
$ kubectl exec -n sample-domain1-ns sample-domain1-admin-server -- bash -c \
"curl -s -S -m 10 http://sample-domain1-cluster-cluster-1:8001/myapp_war/index.jsp"
You will see something like the following:
<html><body><pre>
*****************************************************************
Hello World! This is version 'v2' of the sample JSP web-app.
Welcome to WebLogic server 'managed-server2'!
domain UID = 'sample-domain1'
domain name = 'domain1'
Found 1 local cluster runtime:
Cluster 'cluster-1'
Found min threads constraint runtime named 'SampleMinThreads' with configured count: 2
Found max threads constraint runtime named 'SampleMaxThreads' with configured count: 20
Found 1 local data source:
Datasource 'mynewdatasource': State='Running', testPool='Passed'
*****************************************************************
</pre></body></html>
The testPool='Passed'
for mynewdatasource
verifies that your update to the data source Secret to correct the password succeeded.
If you see a testPool='Failed'
error, then it is likely you did not deploy the database or your database is not deployed correctly.
If you see any other error, then consult Debugging.
This completes the sample scenarios.
To remove the resources you have created in the samples, see Cleanup.