Version: Early Access

Oracle Service Bus plugin

This topic provides information about the Deploy Oracle Service Bus (OSB) plugin, which supports the importing and deleting OSB projects.

For more information, see OSB Plugin Reference.

The osb.Configuration CI is a folder that contains:

One JAR file containing the projects
One or more XML customization files

When you use the Deploy user interface to upload an osb.Configuration artifact, ensure that the JAR and XML files are at the root of the ZIP file.

Features

Import and delete OSB configuration.
Import OSB customization files with placeholder replacement.
Configure Preserve Existing settings to control how existing service configurations are handled during deployment.

Preserve Existing deployment settings

OSB plugin supports configurable Preserve Existing settings on the osb.Configuration CI. These properties control whether certain existing configurations on the target OSB domain are preserved or overwritten during deployment.

Property	Type	Default	Description
`preserveExistingEnvValues`	Boolean	`true`	Preserve existing environment values on the target domain during import.
`preserveExistingCredentials`	Boolean	`true`	Preserve existing credentials on the target domain during import.
`preserveExistingAccessControlPolicies`	Boolean	`true`	Preserve existing access control policies on the target domain during import.
`preserveExistingOperationalValues`	Boolean	`true`	Preserve existing operational values on the target domain during import.
`preserveExistingSecurityAndPolicyConfig`	Boolean	`true`	Preserve existing security and policy configuration on the target domain during import.

These properties are part of the Deployment category on the osb.Configuration CI and default to true.

Use in deployment packages

This is a sample deployment package (DAR) manifest file (deployit-manifest.xml). It contains declarations for an osb.Configuration CI that contains project1 and project2.

    <?xml version="1.0" encoding="UTF-8"?>
    <udm.DeploymentPackage version="2.0" application="SampleApplication">
        <deployables>
            <osb.Configuration name="osbConfiguration" file="osbConfiguration/osbConfiguration.jar">
                <projectNames>
                    <value>project2</value>
                    <value>project1</value>
                </projectNames>
            </osb.Configuration>
        </deployables>
    </udm.DeploymentPackage>

Deployment and rollback

Initial deployment

When an OSB configuration is deployed, the plugin imports the configuration to the target OSB domain and applies the Preserve Existing settings as configured.

Rollback

The plugin supports rolling back an OSB deployment, which undeploys the configuration from the target domain.

Features​

Preserve Existing deployment settings​

Use in deployment packages​

Deployment and rollback​

Initial deployment​

Rollback​