This document will show how to:
- Deploy quickly a Flexcube Image
- Create a Container Flexcube Image
- Create a DevOps build and deploy Flexcube inside a Kubernetes Cluster
Layers for Containerization:
- Fusion
- Flexcube
- WebLogic Configuration
- Database Configuration
- Flexcube Servers
This is the rapid way to deploy the Flexcube (fcubs) in your cluster. Attention for the CPU and Memory pre-requisites:
5CPUs
40Gb RAM
Execute the YAML integrated144.yaml to start a Flexcube Weblogic instance on the cluster. If you want to clusterize your instances, you have to do it manually.
If you already have a Pod/Deployment:
kubectl delete deployment integrated144-deployment
------
Or if you want to create a new Deployment:
kubectl apply -f integrated144.yaml
Remember: Change the JDBC parameters inside integrated144.yaml
You can build a customized image of Flexcube, but you can use this image on my repository:
iad.ocir.io/id3kyspkytmr/flexcube/integrated144:v1
Here I explain how to make your Flexcube base image in docker. First, we need to use a Fusion Image. There is a Fusion image on my repository. Execute the docker run to start the process:
sudo docker run --name integrated144 -h "fcubs.oracle.com" -p 7001-7020:7001-7020 -it "iad.ocir.io/id3kyspkytmr/oraclefmw-infra_with_patch:12.2.1.4.0" /bin/bash
This step loads the Flexcube kernel inside the Fusion image. This bash script do the job. All the scripts necessary to execute the process is inside this project:
flexcube.sh file:
su - gsh
cd /
wget "https://objectstorage.us-ashburn-1.oraclecloud.com/p/Y86rX7N3n5m39BuMsxkRY-uP5O1ha2ZVEOv-oazTmA6MDf0XNtki8gGymsvYvPEf/n/id3kyspkytmr/b/bucket_banco_conceito/o/kernel144_11Mar21.zip"
unzip -o kernel144_11Mar21.zip -d /
cd /scratch/gsh/kernel144/user_projects/domains/integrated/bin
Now, we need to start the image to configure and finalize the Flexcube image:
Execute docker image with:
sudo docker start integrated144
Then execute:
sudo docker cp flexcube.sh integrated144:/
sudo docker exec integrated144 /bin/bash -c "sh /flexcube.sh"
Let's run the Weblogic Admin instance with:
sudo docker exec integrated144 /bin/bash -c "sh /scratch/gsh/kernel144/user_projects/domains/integrated/bin/startNodeManager.sh &"
sudo docker exec integrated144 /bin/bash -c "sh /scratch/gsh/kernel144/user_projects/domains/integrated/bin/startWebLogic.sh &"
Go to Weblogic Admin Server and change machine-1 Listen Address:
http://<your docker IP>:7001/console
if you mount your image locally, you can access the Admin Manager with:
http://0.0.0.0:7001/console
Now, you need to configure the Listen Address:
1. Go to Environment (left side of the menu)
2. Go to Machines
3. Select Machine-1
4. Select Configuration and Node Manager
5. Put "fcubs.oracle.com" in the Listen Address
6. Save the configuration and Apply the update
And for push the docker image to OCIR:
sudo docker stop integrated144
sudo docker commit integrated144 flexcube/integrated144:v1
sudo docker tag flexcube/integrated144:v1 iad.ocir.io/id3kyspkytmr/flexcube/integrated144:v1
sudo docker push iad.ocir.io/id3kyspkytmr/flexcube/integrated144:v1
The Flexcube team needs to build the image with:
Fusion Middleware
Flexcube (/scratch/gsh/...)
Remember the URL of your new Flexcube image and update the YAML file named integrated144.yaml and integrated144-devops.yaml files. IT'S IMPORTANT!!!!
First we need to get the database (a template backup of an Oracle Database for the Flexcube) password. The password original will not work inside the scripts for this automation. The password needs to be converted in AES format, so you need to use the setWLSEnv.sh script to get your passsword into this format:
cd /scratch/gsh/oracle/wlserver/server/bin
. ./setWLSEnv.sh
java -Dweblogic.RootDirectory=/scratch/gsh/kernel144/user_projects/domains/integrated weblogic.security.Encrypt <Database Password>
The DevOps process needs only these 2 parameters to run Flexcube inside a Kubernetes Cluster:
$JDBCPassword: {AES256}7kfaltdnEBjKNq.......RIU0IcLOynq1ee8Ib8= (In AES format*)
$JDBCString: <JDBC Connection String>
This is the DevOps shell script to prepare a Flexcube Image and make it work for use. This can be used in Jenkins or Oracle Visual Builder Studio
OCI CLI Install
Unix Shell
# Prepare for kubectl from OCI CLI
mkdir -p $HOME/.kube
oci ce cluster create-kubeconfig --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaae3tmyldgbtgmyjrmyzdeytbhazdmmbrgfstmntdgc2wmzrxgbrt --file $HOME/.kube/config --region us-ashburn-1 --token-version 2.0.0
export KUBECONFIG=$HOME/.kube/config
# Set Variables
export JDBCString=$JDBCString
export JDBCPassword=$JDBCPassword
# setup the JDBC variables in integrated144-devops.yaml
sed -i "s~--JDBCString--~$JDBCString~g" integrated144-devops.yaml
sed -i "s~--JDBCPassword--~$JDBCPassword~g" integrated144-devops.yaml
# Deploy integrated144
kubectl config view
kubectl replace -f integrated144-devops.yaml --force
You can configure your Build Pipeline in Oracle Visual Builder Studio like this:
Git Configuration:
Parameters Configuration:
Steps Configuration
This is the file responsible for deploy your Flexcube image into Kubernetes Cluster. The configuration file replaces the $JDBCString and $JDBCPassword environment variables before execution. The scripts inside this projects will configure your Weblogic instance with all parameters.
Deployment YAML (integrated144-devops.yaml)
apiVersion: apps/v1
kind: Deployment
metadata:
name: integrated144-deployment
spec:
replicas: 1
selector:
matchLabels:
app: integrated144
template:
metadata:
labels:
app: integrated144
spec:
hostname: integrated144
hostAliases:
- ip: "127.0.0.1"
hostnames:
- "fcubs.oracle.com"
containers:
- name: integrated144
image: iad.ocir.io/id3kyspkytmr/flexcube/integrated144:v1
env:
- name: JDBCSTRING
value: "--JDBCString--"
- name: JDBCPASSWORD
value: "--JDBCPassword--"
command: [ "/bin/sh", "-c"]
args:
[ "sleep 180; cd /; wget https://objectstorage.us-ashburn-1.oraclecloud.com/p/0YTvKvrmiae_ZUoq4ft48Wt3eQfZRCYlrIgjrzADHdJfkkyfkr_4lA4PNF8MrOCj/n/id3kyspkytmr/b/bucket_banco_conceito/o/initializeConfig.sh; sh initializeConfig.sh $(JDBCSTRING) $(JDBCPASSWORD); while true; do sleep 30; done;" ]
ports:
- name: port7001
containerPort: 7001
- name: port7002
containerPort: 7002
- name: port7003
containerPort: 7003
- name: port7004
containerPort: 7004
- name: port7005
containerPort: 7005
- name: port7006
containerPort: 7006
- name: port7007
containerPort: 7007
- name: port7008
containerPort: 7008
- name: port7009
containerPort: 7009
- name: port7010
containerPort: 7010
- name: port7011
containerPort: 7011
- name: port7012
containerPort: 7012
- name: port7013
containerPort: 7013
- name: port7014
containerPort: 7014
- name: port7015
containerPort: 7015
- name: port7016
containerPort: 7016
- name: port7017
containerPort: 7017
- name: port7018
containerPort: 7018
- name: port7019
containerPort: 7019
- name: port7020
containerPort: 7020
- name: port5556
containerPort: 5556
livenessProbe:
httpGet:
path: /console
port: 7001
initialDelaySeconds: 3000
timeoutSeconds: 30
periodSeconds: 300
failureThreshold: 3
resources:
requests:
cpu: "5"
memory: "40Gi"
limits:
cpu: "5"
memory: "40Gi"
restartPolicy: Always
imagePullSecrets:
# enter the name of the secret you created
- name: ocirsecret
---
apiVersion: v1
kind: Service
metadata:
name: integrated144-service
labels:
app: integrated144
spec:
selector:
app: integrated144
ports:
- port: 7004
targetPort: 7004
type: LoadBalancer
---
apiVersion: v1
kind: Service
metadata:
name: integrated144-service-weblogic
labels:
app: integrated144
spec:
selector:
app: integrated144
ports:
- port: 7001
targetPort: 7001
type: LoadBalancer
---
apiVersion: v1
kind: Service
metadata:
name: integrated144-webservices
labels:
app: integrated144
spec:
selector:
app: integrated144
ports:
- port: 7005
targetPort: 7005
type: LoadBalancer
The Flexcube deployment is resilient, so if the Weblogic or Flexcube falls down, the Kubernetes Cluster will load and execute again. The responsible for this is the livenessprobe inside the integrated144-devops.yaml file.
If you want to start or stop WebLogic, you can execute these commands.
kubectl exec $(kubectl get pod -l app=integrated144 -o jsonpath="{.items[0].metadata.name}") -- /bin/bash -c "sh /scratch/gsh/kernel144/user_projects/domains/integrated/bin/startNodeManager.sh &"
kubectl exec $(kubectl get pod -l app=integrated144 -o jsonpath="{.items[0].metadata.name}") -- /bin/bash -c "sh /scratch/gsh/kernel144/user_projects/domains/integrated/bin/startWebLogic.sh &"
kubectl exec $(kubectl get pod -l app=integrated144 -o jsonpath="{.items[0].metadata.name}") -- /bin/bash -c "sh /scratch/gsh/kernel144/user_projects/domains/integrated/bin/stopNodeManager.sh &"
kubectl exec $(kubectl get pod -l app=integrated144 -o jsonpath="{.items[0].metadata.name}") -- /bin/bash -c "sh /scratch/gsh/kernel144/user_projects/domains/integrated/bin/stopWebLogic.sh &"
These are the scripts responsible for automate the deployment, configuration and execution of the Flexcube instance
These scripts change the configuration of all JDBC XML files inside the Weblogic. The environmental variables $JDBCString and $JDBCPassword will be used here
domainsDetails.properties
ds.jdbc.new.1=jdbc:oracle:thin:@xxx.xxx.xxx.xxx:1521/DBSTRING.subnet04...815.vcn04...815.oraclevcn.com
ds.password.new.1={AES256}7kfaltdnEBjKNqdH..............ynq1ee8Ib8=
ChangeJDBC.py
from java.io import FileInputStream
propInputStream = FileInputStream("/domainsDetails.properties")
configProps = Properties()
configProps.load(propInputStream)
for i in 1,1:
newJDBCString = configProps.get("ds.jdbc.new."+ str(i))
newDSPassword = configProps.get("ds.password.new."+ str(i))
i = i + 1
print("*** Trying to Connect.... *****")
connect('weblogic','weblogic123','t3://localhost:7001')
print("*** Connected *****")
cd('/Servers/AdminServer')
edit()
startEdit()
cd('JDBCSystemResources')
pwd()
ls()
allDS=cmo.getJDBCSystemResources()
for tmpDS in allDS:
dsName=tmpDS.getName();
print 'DataSource Name: ', dsName
print ' '
print ' '
print 'Changing Password & URL for DataSource ', dsName
cd('/JDBCSystemResources/'+dsName+'/JDBCResource/'+dsName+'/JDBCDriverParams/'+dsName)
print('/JDBCSystemResources/'+dsName+'/JDBCResource/'+dsName+'/JDBCDriverParams/'+dsName)
set('PasswordEncrypted', newDSPassword)
cd('/JDBCSystemResources/'+dsName+'/JDBCResource/'+dsName+'/JDBCDriverParams/'+dsName)
set('Url',newJDBCString)
print("*** CONGRATES !!! Username & Password has been Changed for DataSource: ", dsName)
print ('')
print ('')
save()
activate()
Important: The JDBC configuration files for the Flexcube is on /scratch/gsh/kernel144/user_projects/domains/integrated/config/jdbc
ChangeJDBC.sh
cd /scratch/gsh/oracle/wlserver/server/bin
. ./setWLSEnv.sh
java weblogic.WLST /ChangeJDBC.py
JDBCReplace.sh
#!/bin/bash
su - gsh
filename=$1
while read line; do
# reading each line
echo $line
sed -i 's/<url>jdbc:oracle:thin:@whf00fxh.in.oracle.com:1521\/prodpdb<\/url>/<url>$JDBCString<\/url>/' /scratch/gsh/kernel144/user_projects/domains/integrated/config/jdbc/$line
sed -i 's/<password-encrypted><\/password-encrypted>/<password-encrypted>$JDBCPassword<\/password-encrypted>/' /scratch/gsh/kernel144/user_projects/domains/integrated/config/jdbc/$line
done < $filename
JDBCList
FLEXTEST2eMDB-9656-jdbc.xml
jdbc2ffcelcmDS-6351-jdbc.xml
jdbc2ffcjdevDSBranch-1885-jdbc.xml
jdbc2ffcjdevDS_EL-0091-jdbc.xml
jdbc2ffcjpmDS_GTXN-9747-jdbc.xml
FLEXTEST2eWORLD-1247-jdbc.xml
jdbc2ffcjDevXADS-7492-jdbc.xml
jdbc2ffcjdevDSSMS-8814-jdbc.xml
jdbc2ffcjdevDS_GTXN-7273-jdbc.xml
jdbc2ffcjsmsDS-7727-jdbc.xml
jdbc2fINT144_integrated144-0549-jdbc.xml
jdbc2ffcjSchedulerDS-6833-jdbc.xml
jdbc2ffcjdevDSSMS_XA-5306-jdbc.xml
jdbc2ffcjdevDS_XA-0669-jdbc.xml
jdbc2fODT14_4-1795-jdbc.xml
jdbc2ffcjdevDS-9467-jdbc.xml
jdbc2ffcjdevDS_ASYNC-6792-jdbc.xml
jdbc2ffcjpmDS-1925-jdbc.xml
These scripts start the Weblogic Admin, Node Manager and the application (Flexcube) and are used in the automation in the deployment YAML file
ExecuteWebLogic.sh
cd /
su - gsh
cd /scratch/gsh/kernel144/user_projects/domains/integrated/bin
sh /scratch/gsh/kernel144/user_projects/domains/integrated/bin/startNodeManager.sh &
sh /scratch/gsh/kernel144/user_projects/domains/integrated/bin/startWebLogic.sh &
StartApps.py
from java.io import FileInputStream
print("*** Trying to Connect.... *****")
connect('weblogic','weblogic123','t3://localhost:7001')
print("*** Connected *****")
start('gateway_server')
start('rest_server')
start('integrated_server')
disconnect()
exit()
StartApps.sh
cd /scratch/gsh/oracle/wlserver/server/bin
. ./setWLSEnv.sh
java weblogic.WLST /StartApps.py
RestartFlexcube.sh
cd /
sh ExecuteWebLogic.sh
sleep 180
cd /
sh StartApps.sh