osbImport

Imports (deploys) a jar file to the OSB Server and performs environment-specific property replacement if a customization/configuration file is present in the code repository.


Environment/Instance Properties

Property Name

Property Code

Required

Description

Weblogic Admin User

FDWLS_ADMIN_USER

Yes

The user for the WLS admin server.

Weblogic Admin Password

FDWLS_ADMIN_PASSWORD

Yes

The password for Weblogic Admin User.

Weblogic Admin Listen Address

FDWLS_ADMIN_LISTEN_ADDRESS

Yes

The listener address of the WLS admin server. For example: localhost

Weblogic Admin Listen Port

FDWLS_ADMIN_LISTEN_PORT

Yes

The port of the WLS admin server. (e.g 7001)

OSB Extended Classpath

FDOSB_EXT_CLASSPATH

No

Allows the user to extend the classpath for this plugin call.

OSB Home

FDOSB_ORACLE_SB_HOME

Yes

The Oracle OSB home. For example: /opt/middleware/Oracle_OSB1

Oracle Weblogic Home (WL_HOME)

FDWLS_WEBLOGIC_HOME

Yes

Weblogic Home Directory. (e.g. /u01/oracle/products/fmw/wlserver)

  

Project Properties

Property Name

Property Code

Required

Description

OSB Project

FDOSB_PROJECT_NAME

Yes

OSB Project Name.

OSB Jar Name

FDOSB_JAR_NAME

Yes

Name of the jar file used to deploy the OSB project.

OSB Passphrase

FDOSB_PASSPHRASE

No

Passphrase used to encrypt or decrypt jar file.

OSB Customization File

FDOSB_CUSTOMIZATION_FILE

No

The name of the customization/configuration file to be applied after the deployment of the project. The Customization file can either be a fully qualified path or a path relative to the FD_TEMP_DIR.

OSB Preserve environment variable valuesFDOSB_PRESERVE_ENV_VAR_VALUESNo

This property was added in version 4.0.3.8

This optional property sets the setPreserveExistingEnvValues value of the ALSBImportPlan. If it is left blank, setPreserveExistingEnvValues is not set.

  

Inputs

Input Name

Input Code

Required

Description

OSB Customization File

FDOSB_INP_CUSTOMIZATION_FILE

No

The name of the customization/configuration file to be applied after the deployment of the project. The Customization file can either be a fully qualified path or a path relative to the FD_TEMP_DIR.

This plugin input overrides project property value for OSB Customization File.

  

Outputs

Output Name

Required

Description




  

Artifacts

This operation consumes a deployable jar file artifact from the artifacts repository.


Endpoint Selection

This operation will select all available endpoints associated to the environment/instance.


Endpoint Execution

This operation will execute on any one of the selected endpoints and will be random in the determination of which one.


Customization/Configuration File

The customization/configuration files that were saved to the FD_ARTIFACTS_DIR will be copied to the FD_TEMP_DIR directory. Configuring the OSB Customization File input on the import operation or the OSB Customization File project property which can be either an absolute path to a customization/configuration file or a relative path of the copied configuration file based relative to the FD_TEMP_DIR directory.

  • If the file path is absolute, the file will be copied to the FD_TEMP_DIR directory and the Property Replacement will be run on the file.
  • If the file is relative to the FD_TEMP_DIR directory, file replacement will be run on it.


Replacement Properties 

Replacement properties are defined by using $FDWLS_ADMIN_LISTEN_ADDRESS and $FDWLS_ADMIN_LISTEN_PORT for environment-instance scoped properties.

For example:
http://localhost:7001/soa-infra/services/default/ProcessPurchaseOrderSync/processpurchaseordersync_client_ep

could be expressed using replacement properties like:


[http://$FDWLS_ADMIN_LISTEN_ADDRESS:$FDWLS_ADMIN_LISTEN_PORT/soa-infra/services/default/ProcessPurchaseOrderSync/processpurchaseordersync_client_ep

With this one-time setup, the plugin will utilize the properties that are configured within FlexDeploy and allow deployment to any environment without manual changes to the files each time it is built for a different environment.