Various RCU related update #1193
Conversation
…ion, unify the logic for atp, ssl and regular oracle db for rcu datasources connection parameters setup.
…ii use case since we are populated the password from the model or cli
…DBCSystemResource section for more flexibility and robustness
oracle-contributor-agreement
bot
added
the
OCA Required
|
Thank you for your pull request and welcome to our community! To contribute, please sign the Oracle Contributor Agreement (OCA). To sign the OCA, please create an Oracle account and sign the OCA in Oracle's Contributor Agreement Application. When singing the OCA, please provide your GitHub username. After signing the OCA and getting an OCA approval from Oracle, this PR will be automatically updated. |
documentation/2.0/content/rcuinfo.md
Outdated
| @@ -1,10 +1,31 @@ | |||
| ### Specifying RCU connection information in the model | |||
|
|
|||
| During creating or updating a domain, there is new section `RCUDbInfo` in the model, under the `domainInfo` section, for specifying RCU database connection information without using the command-line arguments `-rcu_db` and `-rcu_prefix`. Use this to support a database where the connection string is more complex and requires extra options. | |||
| When creating a JRF domain, you can provide all the RCU connection information in a section `RCUDbInfo` under the `domainInfo` section in the model. | |||
| It provides you with more flexibility over the basic command line arguments of | |||
There was a problem hiding this comment.
command line -> command-line
documentation/2.0/content/rcuinfo.md
Outdated
| | opss-audit-DBDS | jdbc/AuditAppendDataSource | prefix_IAU_APPEND | admin server and cluster | | ||
| | mds-owsm | jdbc/mds/owsm | prefix_MDS | admin server and cluster | | ||
|
|
||
| By default, the JRF domain template data source only has the default information such as URL and schema with the default prefix `DEV`. During domain creation, |
documentation/2.0/content/rcuinfo.md
Outdated
| By default, the JRF domain template data source only has the default information such as URL and schema with the default prefix `DEV`. During domain creation, | ||
| WDT will use the information you provided in the command line or in the `RCUDbinfo` section to override the default values from the template so that it can connect to the database you specified. | ||
|
|
||
| For some advanced use case, such as using Oracle Active Grid Link data source or Multi data sources, you can provide a sparse model of the above data sources in a separate model file |
There was a problem hiding this comment.
advanced use case -> advanced use cases
using Oracle -> using an Oracle
Active Grid Link -> Active GridLink data source
Multi data sources -> Multi Data Sources
of the above data sources -> of the data sources
documentation/2.0/content/rcuinfo.md
Outdated
| WDT will use the information you provided in the command line or in the `RCUDbinfo` section to override the default values from the template so that it can connect to the database you specified. | ||
|
|
||
| For some advanced use case, such as using Oracle Active Grid Link data source or Multi data sources, you can provide a sparse model of the above data sources in a separate model file | ||
| during domain creation. See [Advance use cases](#advanced-jrf-database-use-cases) |
There was a problem hiding this comment.
Period at the end of the sentence.
documentation/2.0/content/rcuinfo.md
Outdated
|
|
||
| ### Access a database using a wallet | ||
|
|
||
| When accessing a database using a wallet, you need to obtain the wallet from your DBA and information about the database: | ||
| When accessing a database such as ATP or SSL using a wallet, you need to obtain the wallet from your DBA and information about the database: |
There was a problem hiding this comment.
database such as ATP or SSL -> database, such as ATP or SSL, (two commas needed)
documentation/2.0/content/rcuinfo.md
Outdated
| #### Multi Data Sources | ||
|
|
||
| If your database does not support high availability natively such as RAC or AGL, then WebLogic provides a Multi Data Source option, which basically the main data source is a logical data source that | ||
| contains multiple physical data sources. In order to create a spare model, you can for each data source |
There was a problem hiding this comment.
you can for each data source -> for each data source, you can:
documentation/2.0/content/rcuinfo.md
Outdated
| contains multiple physical data sources. In order to create a spare model, you can for each data source | ||
|
|
||
| 1. Update the templated data source `URL`, `EncryptedPassword`, and 'user' property value. In the `URL` part, you can specify one of the accessible physical database URL. | ||
| 2. Duplicate each datasource two times |
There was a problem hiding this comment.
Period at the end of the sentence
documentation/2.0/content/rcuinfo.md
Outdated
|
|
||
| 1. Update the templated data source `URL`, `EncryptedPassword`, and 'user' property value. In the `URL` part, you can specify one of the accessible physical database URL. | ||
| 2. Duplicate each datasource two times | ||
| 3. Change the duplicated data source name, `JNDIName` by appending `-1`, `-2` etc. The `-1`, `-2` data sources are the physical data source, you will need to update their `URL` too. |
There was a problem hiding this comment.
etc -> , and such.
data source, you will -> data sources; (semi-colon) you will
documentation/2.0/content/rcuinfo.md
Outdated
| 2. Duplicate each datasource two times | ||
| 3. Change the duplicated data source name, `JNDIName` by appending `-1`, `-2` etc. The `-1`, `-2` data sources are the physical data source, you will need to update their `URL` too. | ||
|
|
||
| For example (note: details replaced by `....` for easier reading), |
There was a problem hiding this comment.
reading), -> reading): (colon)
documentation/2.0/content/rcuinfo.md
Outdated
| .... | ||
| ``` | ||
|
|
||
| You can run WDT tool `modelHelp.sh -oracle_home <oracle home> resources:/JDBCSystemResource/JdbcResource/JDBCDataSourceParams` for the complete list |
There was a problem hiding this comment.
re-write: For the complete list of fields, run the WDT command, modelHelp.sh -oracle_home <oracle home> resources:/JDBCSystemResource/JdbcResource/JDBCOracleParmas.
| For the complete list of fields, run the WDT command, | ||
|
|
||
| ```shell | ||
| modelHelp.sh -oracle_home <oracle home> resources:/JDBCSystemResource/JdbcResource/JDBCOracleParams |
There was a problem hiding this comment.
Preceded commands with a dollar sign ($)
$ modelHelp.sh
| For the complete list of fields, run the WDT command, | ||
|
|
||
| ```shell | ||
| modelHelp.sh -oracle_home <oracle home> resources:/JDBCSystemResource/JdbcResource/JDBCOracleParams |
|
Kudos, SonarCloud Quality Gate passed! |
This PR ccovers