Creates or updates EIS Entries defined within properties files. The properties files will be processed for property replacement using $VARIABLE_NAME
format. See the Appendix for more information about property replacement.
Environment/Instance Properties
Property Name | Required | Description |
---|---|---|
FDWLS_WEBLOGIC_HOME | Yes | WebLogic Home Directory. (e.g. /u01/oracle/products/fmw/wlserver) |
FDWLS_DOMAIN_NAME | Yes | WebLogic Domain Name. |
FDWLS_ADMIN_LISTEN_ADDRESS | Yes | The listener address of the WLS admin server. (e.g. localhost) |
FDWLS_ADMIN_LISTEN_PORT | Yes | The port of the WLS admin server. (e.g. 7001) |
FDWLS_ADMIN_USE_SSL | No | Indicates whether the admin server is using SSL. |
FDWLS_ADMIN_USER | Yes | The user name for the WLS admin server. |
FDWLS_ADMIN_PASSWORD | Yes | The password for FDWLS_ADMIN_USER. |
FDWLS_ADMIN_DOMAIN_DIRECTORY | No | WebLogic Domain Directory for AdminServer. Used when the admin server runs from a different domain folder than managed servers |
FDWLS_DOMAIN_DIRECTORY | Yes | WebLogic Domain Directory for managed servers. |
FDWLS_ADAPTER_PLAN_PATH | No | The folder where the Adapter plans are stored. If this parameter is not used, the adapters' last-used setting will be used. |
Project Properties
Property Name | Required | Description |
---|---|---|
|
|
|
Inputs
Input Name | Required | Description |
---|---|---|
FILE_PATH_TO_PROPERTIES | No | Comma-separated Paths to the properties file(s) or folders containing properties files. |
Outputs
Output Name | Required | Description |
---|---|---|
FDWLS_OUT_IS_RESTART_REQUIRED | No | A boolean value that indicates whether the server needs to be restarted to finish applying the configuration changes. You could use this in a workflow condition. |
...
If FILE_PATH_TO_PROPERTIES is not specified, the FD_ARTIFACTS_DIR folder will be used. If a relative path is specified, the path will be relative to the FD_ARTIFACTS_DIR directory. Each EIS Adapter plan file is backed up to FD_TEMP_DIR/configbackup before it is modified. As with all files in the endpoint working directory, these files will be saved for 3 days before being deleted. It is important to set up the properties files like the examples below.
Example Folder Structure
- Properties file can be named per your requirements. See Properties File Format.
- eisconfigurations.properties – This is the main properties file. The path to it is referenced by FILE_PATH_TO_PROPERTIES.
- DEV/ eisconfigurations.properties - optionally create a file here and override some properties with it per environment. The filename must match.
- PROD/ eisconfigurations.properties - optionally have several environments.
- Sub folder names for environment overrides must be FlexDeploy environment code
...
This sample file creates 3 EIS entries with properties. Property names can be gathered from the Weblogic console, WLST, Oracle's documentation, or existing plan.xml files. EISList
Code Block | ||
---|---|---|
| ||
EISList=SOADB,SOAJMS,SOARODB |
...
SOADB.Adapter=DbAdapter |
...
SOADB.JNDI=eis/db/SOA |
...
SOADB.properties.XADataSourceName=jdbc/ebs01 |
...
SOAJMS.Adapter=JmsAdapter |
...
SOAJMS.JNDI=eis/jms/SOAJMS |
...
SOAJMS.properties.ConnectionFactoryLocation=jms/ConnectionFactoryName |
...
SOARODB.Adapter=DbAdapter |
...
SOARODB.JNDI=eis/db/SOASOARODB |
...
SOARODB.properties.XADataSourceName=jdbc/ebs02 |
...
...
Properties
...
File
...
Format
...
Multiple EIS Entries can be defined in the properties file. The properties file must start with a list of EIS Entries present in the format EISList=eis1,eis2,eis3. Change eis1, eis2, eis3 to the names of the EIS Entries for your projects. Any number of EIS Entries is acceptable. The properties files will be processed for property replacement using $VARIABLE_NAME
format. See the Appendix for more information about property replacement.
...
...
Required Properties
Each EIS Entry must contain the following required properties
Property Name | Description |
---|---|
Adapter | The adapter name (e.g. JmsAdapter,DbAdapter). The adapter name is used to find its associated rar file, so it must be named exactly the same. The first part of the adapter name will also be used to create the plan file name. |
JNDI | The JNDI name (e.g. eis/db/SOA) |
The ConnectionFactoryInterface is an optional property. If not specified in your properties file, the default value will apply. The default value varies by adapter name.
Adapter Name | Default Value |
---|---|
JmsAdapter | oracle.tip.adapter.jms.IJmsConnectionFactory |
OracleBamAdapter | bam.adapter.adc.soap.SOAPConnectionFactory |
All other adapters | javax.resource.cci.ConnectionFactory |
User-Specified Properties
Any number of properties of any kind may be applied to each EIS Entry. Please use this format: <EISNAME>
Code Block | ||
---|---|---|
| ||
<EISNAME>.properties.username=weblogic |
...
<EISNAME>.properties.password=welcome1 |
...