Creating a Platform Blueprint from an Existing SOA / BPM Domain

Overview

Rubicon Red MyST uses a declarative approach to automation, meaning users simply define the target state of the Oracle Middleware infrastructure to be deployed; which, at the push of a button, is automatically provisioned by MyST.

Within MyST, the target state is captured in the platform definition, which is divided into two layers. First, the Platform Blueprint defines an environment agnostic specification used to define the platform topology and configuration of your Oracle Middleware. Second, the Platform Model, overlays the environment specific configurations.

Splitting the platform definition into two layers, provides infrastructure independence; enabling you to provision consistent middleware platforms across all environments regardless of infrastructure type, on premise and on cloud.

One way to create a Platform Blueprint is to use the Platform Wizard, this guides the user through a simple process to capture the key design decisions for the Oracle Middleware topology and configuration and creates a corresponding Platform Blueprint.

Alternatively MyST allows you to introspect and capture the configuration of an existing WebLogic domain and use that to generate an equivalent Platform Blueprint. This is the topic of this blog.

Discover and Introspect Existing WebLogic Domains

To create a Platform Blueprint based on an existing WebLogic domain, we simply point MyST at the servers hosting the WebLogic domain; MyST will introspect the domain and create a corresponding Platform Blueprint. This supports a number of use cases, including:

  • Side-By-Side Upgrade - We can introspect an existing 11g environment, extract the key configuration information and then use this to automatically provision an equivalent 12c environment in minutes.
  • Lift and Shift to the Cloud - We can introspect an existing 11g/12c environment and then use MyST to provision an equivalent environment to the cloud.
  • Replicate PROD Environment - We can introspect an existing 11g/12c environment, for example Production and then use this to provision equivalent non-prod environments (e.g. DEV, SIT, UAT, PRE), and thus quickly ensure all environments are identically configured and eliminate configuration drift.

We also have the option of creating a Platform Model for the introspected WebLogic Domain, we can then use MyST to manage on-going configuration changes and code deployments to the introspected platform as well as provision new environments with the same configuration.

The end-to-end process consists of three simple steps and can be performed in minutes.

Step 1. Identify WebLogic Domain to Introspect

For the purpose of this blog, we are going to introspect an existing Oracle SOA 11.1.1.7 environment running on two VMs, that consists of a 2 node SOA Cluster and 2 node OSB Cluster. As illustrated in the WebLogic Admin Console.

Note: MyST supports introspection of 11.1.1.7, 12.1.3 and 12.2.1 WebLogic, SOA, OSB and BPM environments.

Step 2. Define WebLogic Domain to MyST

Before we can introspect an existing domain we need to provide details of the physical or virtual servers that the WebLogic domain is to provisioned to, plus SSH connection details.

To do this in MyST, we need to add each WebLogic host to a Pre-Existing Infrastructure Providers. From the side menu navigate toInfrastructure > Infrastructure Providers, this will display a list of existing Infrastructure Providers. From here, open the required Infrastructure Provider (or simply add a new one).

This will open the Infrastructure Providers screen, from here we need to define a host for each of our existing WebLogic hosts. To do this, click Add Host.

For each host we need to specify the following details:

  • Name - Name within MyST used to refer to the host.
  • Host Name - Network address of the host, can also be the IP Address.
  • Compute Definition - Used to specify the Operating System of the target host.
  • SSH Port - The SSH Port of the target host, defaults to 22.
  • Environment(s) - Hosts must be tagged to one or more Environments. This integrates with the Role Based Access Control to define who has access to the host.
  • OS agent credentials - The OS agent credentials is the set of credentials that MyST uses to connect to the host over SSH and run the MyST introspection agent on the host. These credentials consist of the SSH user name and either a password or a key pair (these are also defined within the Infrastructure Provide.
  • Configure OS Agent Credential - For introspection purposes, we can leave this set to No.

Step 3. Introspect SOA / BPM Domain

From the side menu navigate toModeling > Platform Blueprint, this will display a list of existing Platform Blueprints. Click on Create New in the top right-hand corner of the screen. This will launch the New Platform Blueprint wizard.

In the initial dialogue we need to specify the following details about our Platform Blueprint:

  • Name - Short hand name for the Platform Blueprint.
  • Description - A longer description of the Platform Blueprint.
  • Workspaces - This defines the Workspaces to which the Platform Blueprint belongs. See Role Based Access Control for further details.
  • Initial Version - Specifies the initial version of the Platform Blueprint, we will stick with the default.

Finally, we need to specify we want to use introspection to create the Platform Blueprint. Select Introspectand click Next.

Specify WebLogic Domain to Introspect

Next we need to specify the host for the WebLogic Admin Server. First select the infrastructure provider where we defined our WebLogic hosts (in step 1), then from the drop down select the host for the WebLogic Admin Server.

Next specify the absolute location of the WebLogic Domain home directory, which is something like:
/u01/app/oracle/admin/<domain_name>/aserver/<domain_name>

At this point we are not going to create a Platform Model, so leave the default option of No for this drop down.

Finally click introspect.

Review the Summary

MyST will display a Summary screen showing details of the introspected Platform.

Once done, click Finish.

View/Edit Platform Blueprint

MyST will create the corresponding Platform Blueprint and take you to the Platform Blueprint Editor where you can make additional configuration changes if required.

From here we can see that MyST has introspected key configuration details, including JDBC Data Sources, File Stores, JMS Servers, JMS Modules, JCA Adapters and SAF Agents.

We can now use this Platform Blueprint to provision an equivalent WebLogic Domain either on -premise or in the cloud.

Alternatively, we can upgrade the Platform Blueprint to 12.1.3 or 12.2.1 and use it provision an equivalent 12c environment - see this blog for further details.

Matt Wright

Matt Wright is co-founder and CTO of Rubicon Red. Rubicon Red offers organisations a set of innovative and market leading DevOps, Cloud & consulting solutions for Oracle Middleware customers.

Melbourne, Australia https://twitter.com/RubiconMatt

Subscribe to Oracle PaaS, Oracle Middleware and DevOps

Get the latest posts delivered right to your inbox.

or subscribe via RSS with Feedly!