Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

An Environment Instance, as its name suggests, is simply an The Topology Overview displays the association between one environment and one instance. An Environment InstanceInstance pair is created by either associating an Instance to an Environment on the Edit/Create Environment Wizard, or associating an Environment to an Instance on the Edit/Create Instance Wizard. Endpoints and properties values are mapped to those Environment Instance pairs.

...


SOA1

SOA2

DEV

Endpoint(s)

Properties

N/A

SIT

Endpoint (s)

Properties

Endpoint (s )

Properties

UAT

Endpoint (s)

Properties

N/A

PROD

Endpoint (s)

Properties

Endpoint (s)

Properties

...

The image below depicts the Environment Instances Instance pairing for SOA2. In this case, the FlexDeploy SOA Plugin's soaDeploy operation was associated to the SOA2 instance. The soaDeploy operation defines several Environment-Instance-scoped properties that must be defined for the operation to succeed.


Instances are flexible enogh enough to allow FlexDeploy to adapt to a variety of technologies and platforms. In Oracle Data Integrator, for example, an Instance is most likely one to one with a single installation, spanning all Environments (e.g. DEV, SIT, UAT, and PROD). In the case of Oracle WebLogic, a single installation is partitioned into one or more domains. So for WebLogic it makes more sense to map an Instance to each WebLogic domain, since each domain will require different property configuration to communicate with its servers.

...


wls_customer

wls_order

DEV

Endpoints
devlnx501

Properties
FDWLS_DOMAIN_NAME: wls_customer
FDWLS_ADMIN_LISTEN_ADDRESS: devlnx501
FDWLS_ADMIN_LISTEN_PORT: 7001
FDWLS_ADMIN_USER: weblogic
FDWLS_ADMIN_PASSWORD: ********
etc …

Endpoints
devlnx501

Properties
FDWLS_DOMAIN_NAME: wls_order
FDWLS_ADMIN_LISTEN_ADDRESS: devlnx501
FDWLS_ADMIN_LISTEN_PORT: 7001
FDWLS_ADMIN_USER: weblogic
FDWLS_ADMIN_PASSWORD: ********
etc …

SIT

Endpoints
sitlnx501, sitlnx502

Properties
FDWLS_DOMAIN_NAME: wls_customer
FDWLS_ADMIN_LISTEN_ADDRESS: sitlnx501
FDWLS_ADMIN_LISTEN_PORT: 7001
FDWLS_ADMIN_USER: weblogic
FDWLS_ADMIN_PASSWORD: ********
etc …

Endpoints
sitlnx501, sitlnx502

Properties
FDWLS_DOMAIN_NAME: wls_order
FDWLS_ADMIN_LISTEN_ADDRESS: sitlnx501
FDWLS_ADMIN_LISTEN_PORT: 7001
FDWLS_ADMIN_USER: weblogic
FDWLS_ADMIN_PASSWORD: ********
etc …

UAT

Endpoints
uatlnx501, uatlnx502

Properties
FDWLS_DOMAIN_NAME: wls_customer
FDWLS_ADMIN_LISTEN_ADDRESS: uatlnx501
FDWLS_ADMIN_LISTEN_PORT: 7001
FDWLS_ADMIN_USER: weblogic
FDWLS_ADMIN_PASSWORD: ********
etc …

Endpoints
uatlnx501, uatlnx512

Properties
FDWLS_DOMAIN_NAME: wls_order
FDWLS_ADMIN_LISTEN_ADDRESS: uatlnx501
FDWLS_ADMIN_LISTEN_PORT: 7001
FDWLS_ADMIN_USER: weblogic
FDWLS_ADMIN_PASSWORD: ********
etc …

PROD

Endpoints
prdlnx501, prdlnx502, prdlnx503

Properties
FDWLS_DOMAIN_NAME: wls_customer
FDWLS_ADMIN_LISTEN_ADDRESS: prdlnx501
FDWLS_ADMIN_LISTEN_PORT: 7001
FDWLS_ADMIN_USER: weblogic
FDWLS_ADMIN_PASSWORD: ********
etc …

Endpoints
prdlnx501, prdlnx512, prdlnx513

Properties
FDWLS_DOMAIN_NAME: wls_order
FDWLS_ADMIN_LISTEN_ADDRESS: prdlnx501
FDWLS_ADMIN_LISTEN_PORT: 7001
FDWLS_ADMIN_USER: weblogic
FDWLS_ADMIN_PASSWORD: ********
etc …

Viewing Environment Instances

To view the Environment Instances that have been established select Topology -> Environment Instances from the menu.

Associating Endpoints to Environment Instances

Image Removed, and choose the Topology Overview tab.

Every circle on the screen represents an Environment and Instance assocation. The configuration of these pairings can be viewed and edited by clicking the circle.

<<Image of the Topology page on the Overview Tab>>

Updating Environment Instance Properties

Each Environment Instance has an Endpoints column, which indicates the number of Endpoints pair has a Properties tab which summarizes the required properties that are associated to it. Click on the number in the Endpoints column to add or remove endpoints from the Environment Instance.The circle on the Topology Overview will not become green if all of the required properties are not set (as well as an endpoint is assigned).

<<Image of Properties tab in new screens>>
Image Added


The properties are linked to the Environment Instance intersection because workflows or plugin operations associated to the Instance have Environment-Instance-scoped properties defined. These Environment-Instance-scoped properties must have values defined for every Environment to which that Instance is mapped. This provides, for example, the ability to define unique Weblogic Admin Server host and port for each Environment Instance.

See Properties chapter for more details.

Associating Endpoints to an Environment Instance Pair

Image Added


The different colors of the circles indicates the level of completion of the configuration, see the table below for what each color indicates.

<<Table with image of each circle and description next to it>>

Each intersection has an Endpoints tab, which displays the different Endpoints that are associated to it. 

<<Same image in new screens>>


To associate an Endpoint to the an Environment Instance association, shuttle click and drag one or more Endpoints from the left right over to Selected Endpoints by selecting an endpoint and clicking the Add buttonthe main pane. The list of available Endpoints on the left right can be filtered by entering all or part of the name or port into the Filter field Search field and clicking the Search button. By the list will be automatically filtered. By default, only Endpoints which are active are available for association.

...

To disassociate an Endpoint from the Environment Instance, shuttle one or more Endpoints from Selected Endpoints back over to the left by selecting an endpoint and clicking the Remove Buttonclick an Endpoint row and drag it back to the list on the right.

Click the Save button to save the changes , and then click the Back button to and automatically return to the previous screen.

Updating Environment Instance Properties

Each Environment Instance also has a Properties column which summarizes the required properties that are associated to it. The first number indicates the number of properties which have been assigned values. The second number identifies the total number of required properties associated to that Environment Instance. If the two numbers are not equal it means that additional configuration is required for that Environment Instance. Click on the link in the Properties column to provide the ability to update properties associated to the Environment Instance.

Image Removed The properties are linked to the Environment Instance because workflows or plugin operations associated to the Instance have Environment-Instance-scoped properties defined. These Environment-Instance-scoped properties must have values defined for every Environment to which that Instance is mapped. This provides, for example, the ability to define unique Weblogic Admin Server host and port for each Environment Instance.See Properties chapter for more detailsAlternatively, click the Apply button to save any changes, but remain on the screen until the Back button is clicked.