Skip to main content

A Python client for the Weblogic REST API

Project description

https://travis-ci.org/magnuswatn/wls-rest-python.svg?branch=master https://codecov.io/gh/magnuswatn/wls-rest-python/branch/master/graph/badge.svg https://badge.fury.io/py/wls-rest-python.svg

This is a Python client for Weblogics RESTful Management Services. It takes care of some of the quirks with the API, without being so closely linked that it becomes limiting.

It creates Python objects dynamically based on the response from the server, so that it’s easy to quickly write useful and Pythonic scripts.

It’s tested against 12.2.1.2, but should work fine with all 12c R2 releases.

Installation

$ pipenv install wls-rest-python

Example usage

Explore the API, change properties and undeploy applications:

>>> from wls_rest_python import WLS
>>>
>>> wls = WLS('https://wls.example.com:7001', 'weblogic', 'welcome1')
>>>
>>> dir(wls.edit.batchConfig)
['canonical', 'dynamicallyCreated', 'id', 'identity', 'name', 'notes','parent',
'schemaName', 'self', 'tags', 'type']
>>>
>>> wls.edit.servers.myServer.nativeIOEnabled
True
>>> wls.edit.servers.myServer.update(nativeIOEnabled=False)
>>> wls.edit.servers.myServer.nativeIOEnabled
False
>>> wls.domainRuntime.deploymentManager.appDeploymentRuntimes.myApp.getState(
... target='myServer')
{'return': 'STATE_ACTIVE'}
>>>
>>> wls.domainRuntime.deploymentManager.appDeploymentRuntimes.myApp.undeploy()
>>>

Start all managed servers asynchronously:

from wls_rest_python import WLS

wls = WLS('https://wls.example.com:7001', 'weblogic', 'welcome1')

admin_server_name = wls.edit.adminServerName

running_jobs = []
for server in wls.domainRuntime.serverLifeCycleRuntimes:
    if server.name != admin_server_name:
        running_jobs.append(server.start(prefer_async=True))

while running_jobs:
    for job in running_jobs:
        if job.completed:
            running_jobs.remove(job)
    time.sleep(10)

Undeploy all applications and deploy a new one:

import json
from wls_rest_python import WLS

wls = WLS('https://wls.example.com:7001', 'weblogic', 'welcome1')

for deployment in wls.edit.appDeployments:
    deployment.delete()

deployment_model = {
    'name': 'myWebApp',
    'targets': [
        {'identity': [
            'servers',
            'myServer'
            ]
        }
    ]
}

deployment_info = {
    'model': (None, json.dumps(deployment_model)),
    'sourcePath': open('/u01/wars/myWebApp.war', 'rb'),
    'planPath': open('/u01/wars/myWebAppPlan.xml', 'rb')
}
wls.edit.appDeployments.create(files=deployment_info)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
wls-rest-python-0.1.4.tar.gz (6.1 kB) Copy SHA256 hash SHA256 Source None Oct 7, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page