WLST Guide: Creating WebLogic Domains with Advanced Configurations

By -

1. Dynamic Domain Creation Using Python Dictionaries (Unique Approach)

Why? Avoid hardcoding values—use a reusable JSON/YAML-style structure.


WLST Script (createDomain_advanced.py)


# Define domain config as a dictionary (modular & editable)
domain_config = {
    "domain_name": "ProdClusterDomain",
    "admin_user": "weblogic",
    "admin_password": "S3cr3t#123",  # Encrypt in production!
    "java_home": "/usr/java/jdk1.8.0_301",
    "listen_address": "10.0.0.100",
    "listen_port": 7001,
    "clusters": [
        {"name": "ProdCluster", "multicast": "239.192.0.1", "servers": 4}
    ],
    "data_sources": {
        "jdbc/AppDS": {
            "url": "jdbc:oracle:thin:@db-host:1521/ORCL",
            "driver": "oracle.jdbc.OracleDriver"
        }
    }
}

# Create domain from dict
readTemplate('/oracle/wlserver/common/templates/wls/wls.jar')

# Apply config
cd('/Security/base_domain/User/weblogic')
cmo.setPassword(domain_config["admin_password"])

cd('/Servers/AdminServer')
cmo.setListenAddress(domain_config["listen_address"])
cmo.setListenPort(domain_config["listen_port"])

# Dynamic cluster creation
for cluster in domain_config["clusters"]:
    cd('/')
    create(cluster["name"], 'Cluster')
    for i in range(cluster["servers"]):
        create(f"ProdServer_{i}", 'Server')
        cd(f'/Servers/ProdServer_{i}')
        set('Cluster', cluster["name"])

# Save & exit
writeDomain(f"/oracle/domains/{domain_config['domain_name']}")
closeTemplate()
exit()

2. Domain Creation with Rollback on Failure (Robust Error Handling)

Why? Most tutorials ignore failure recovery.

WLST Script (createDomain_rollback.py)

import os
from java.lang import System

try:
    # Start
    print(">>> Creating domain...")
    readTemplate('/oracle/templates/wls.jar')
    
    # Simulate a failure (e.g., port conflict)
    if int(System.getProperty('simulate.failure')) == 1:
        raise Exception("Fake error for rollback testing")
    
    # Normal setup
    cd('/Security/base_domain/User/weblogic')
    cmo.setPassword('weblogic123')
    writeDomain('/oracle/domains/TestDomain')
    
except Exception, e:
    print("!!! ERROR: " + str(e))
    print(">>> Rolling back...")
    
    # Delete incomplete domain
    if os.path.exists('/oracle/domains/TestDomain'):
        shutil.rmtree('/oracle/domains/TestDomain')
    
    # Exit with error
    sys.exit(1)

finally:
    closeTemplate()

3. Template-Based Domain Creation (For DR/Replication)

Why? Clone domains with customizations.


Step 1: Dump Existing Domain as Template

$WL_HOME/common/bin/wlst.sh

wls:/offline> writeTemplate('/backups/prod_domain_template.jar')

Step 2: Modify Template (Add Custom Resources)

readTemplate('/backups/prod_domain_template.jar')

# Add a JMS module
cd('/')
create('MyJMSModule', 'JMSSystemResource')
cd('JMSSystemResource/MyJMSModule/JmsResource/NO_NAME_0')
create('MyQueue', 'Queue')
cd('Queue/MyQueue')
cmo.setJNDIName('jms/MyQueue')

# Save as new template
writeTemplate('/backups/prod_domain_with_jms.jar')

4. Silent Mode + Property Files (CI/CD Ready)

Why? Integrate with DevOps pipelines.

Property File (domain.properties)

domain.name=CI_Domain
admin.port=9001
cluster.name=CI_Cluster
servers=3

5. Post-Creation Validation (Automated Checks)

Why? Most guides skip verification.

WLST Script (verifyDomain.py)

domain_home = '/oracle/domains/ProdDomain'

try:
    readDomain(domain_home)
    
    # Check AdminServer
    cd('/Servers/AdminServer')
    port = get('ListenPort')
    if port != 7001:
        raise Exception(f"AdminServer port is {port}, expected 7001")
    
    # Check clusters
    clusters = ls('/Clusters', returnMap=True)
    if 'ProdCluster' not in clusters:
        raise Exception("ProdCluster missing!")
    
    print(">>> Validation passed!")
    
except Exception, e:
    print("!!! VALIDATION FAILED: " + str(e))
    dumpStack()


Comments

Post a Comment

Popular posts from this blog

Interview question for File and FTP Adapter

By -
1)  Why File Adapter is used in SOA Suite tool ?.  File adapter is used to read and write file from and to local system. 2)  Why FTP Adapter is used in SOA Suite tool ?. FTP adapter is similar to File adapter with one difference that this adapter is used to read/write the file from/to remote system. 3)  What all differences we have between File and FTP adapters.  Following are the major differences between File and FTP adapter. File Adapter 1. It is used to deal with local systems only. 2. Do not require any configuration to make this adapter work. FTP Adapter 1. It is used to deal with remote systems. 2. Outbound Connection Pool needs to be configured with FTP details to make this adapter work. 4)  File & FTP adapters are known and Transactional or Non-Transactional adapters?.  These adapters are known as non-transactional adapters as these adapters does not support transactions. 5)  Can we read flat files using these adapter...
Read more

What is boot.properties file and how to create

By -
Boot.properties is a file, it containing  weblogic server username and password . If your server is in production mode then only you have to create manually this boot.properties file. If your server is in Development then you no need to create this file because server it self create this file while creating Domain. A boot identity file contains the user credentials for starting and stopping an instance of WebLogic Server. An administration server or managed server can refer to this file for user credentials instead of prompting at the command line to provide them. To Create boot.properties: Go to below location Win :   C:\Oracle\Middleware\user_projects\domains\test_domain\servers\AdminServer\ Linux : Oracle\Middleware\user_projects\domains\test_domain\servers\AdminServer\ 1.First you have to create security folder under AdminServer 2.Create boot.properties file under security folder. 3.Open notepad and write the below two lines username=********** password=*****...
Read more

SSL Exceptions in Admin Server and Node Manager.

By -
javax.net.ssl.SSLKeyException: [Security:090482]BAD_CERTIFICATE alert was received from oracle.test.com – xx.xxx.xx.xx. Check the peer to determine why it rejected the certificate chain (trusted CA configuration, hostname verification). SSL debug tracing may be required to determine the exact reason the certificate was rejected. <WARNING> <Uncaught exception in server handlerjavax.net.ssl.SSLHandshakeException: Remote host closed connection during handshake>javax.net.ssl.SSLHandshakeException: Remote host closed connection during handshake at com.sun.net.ssl.internal.ssl.SSLSocketImpl.readRecord(SSLSocketImpl.java:849) at com.sun.net.ssl.internal.ssl.SSLSocketImpl.performInitialHandshake(SSLSocketImpl.java:1170) The above exceptions are  the most common exceptions encountered during the setup of Weblogic Server in an environment. The stack does suggest what could be the reasons but the diagnostics are not mentioned. To debug this issue, first we need...
Read more