Skip to content

Move RCU doc #1363

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jan 24, 2023
Merged

Move RCU doc #1363

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
57d50cc
Move RCU doc
rosemarymarano Jan 24, 2023
43300f9
update the description
rosemarymarano Jan 24, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 19 additions & 12 deletions documentation/3.0/content/rcuinfo.md → .../content/userguide/database/connect-db.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,18 @@
---
title: "Connect to a Database"
date: 2019-02-23T17:19:24-05:00
draft: false
weight: 3
description: "Create a connection to access your database."
---

### Specifying RCU connection information in the model

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
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
`-rcu_db` and `-rcu_prefix`. Use this when the connection string is more complex and requires extra options.

### Background on JRF domain RCU tables
### Background on JRF domain RCU tables

A JRF domain creates several data sources from the JRF domain template.

Expand Down Expand Up @@ -156,7 +164,7 @@ domainInfo:
rcu_admin_password : <database admin password is required only when you specify -run_rcu flag, will be prompted
if not specified>
rcu_db_conn_string : dbhost:1521/pdborcl
```
```

### Specify variables for RCU

Expand All @@ -166,7 +174,7 @@ RCU `-variables` option of the repository creation utility can now be included i
domainInfo:
RCUDbInfo:
rcu_variables : xxxx
```
```

### Specify extended XML files for RCU

Expand All @@ -189,9 +197,9 @@ In the following examples of the JRF data source sparse model, you can use it to

#### Default template data source

This is a sparse model for JRF data sources with the RCU prefix `FMW1`.
You will need to update at least the `URL`, `PasswordEncrypted`, and the `user` property value. When you specify the value of `URL`, it
must be a valid `JDBC URL` format, which is different from the `rcu_db_conn_string` which does not require the `jdbc:oracle:thin:...` part.
This is a sparse model for JRF data sources with the RCU prefix `FMW1`.
You will need to update at least the `URL`, `PasswordEncrypted`, and the `user` property value. When you specify the value of `URL`, it
must be a valid `JDBC URL` format, which is different from the `rcu_db_conn_string` which does not require the `jdbc:oracle:thin:...` part.

```yaml
resources:
Expand Down Expand Up @@ -313,7 +321,7 @@ resources:

#### Oracle Active Grid Link Data Source (AGL)

For setting the data source to access Oracle Active Grid Link database, besides updating the `URL`, `PasswordEncrypted`, and the `user` property value;
For setting the data source to access Oracle Active Grid Link database, besides updating the `URL`, `PasswordEncrypted`, and the `user` property value;
you can specify additional `JDBCOracleParams` under `JdbcResource` of each data source. For example,

```yaml
Expand All @@ -325,7 +333,7 @@ you can specify additional `JDBCOracleParams` under `JdbcResource` of each data
....
```

For the complete list of fields, run the WDT command,
For the complete list of fields, run the WDT command,

```shell
modelHelp.sh -oracle_home <oracle home> resources:/JDBCSystemResource/JdbcResource/JDBCOracleParams
Expand All @@ -349,7 +357,7 @@ For example (note: details replaced by `....` for easier reading):
JDBCDriverParams:
URL: jdbc:oracle:thin://@somewhere:1521/db-node1
PasswordEncrypted: 'actualpassword`
....
....
'opss-data-source-1':
....
JDBCDataSourceParams:
Expand Down Expand Up @@ -391,4 +399,3 @@ For the complete list of fields, run the WDT command,
```shell
modelHelp.sh -oracle_home <oracle home> resources:/JDBCSystemResource/JdbcResource/JDBCOracleParams
```

2 changes: 1 addition & 1 deletion documentation/3.0/content/userguide/tools/create.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ The Create Domain Tool understands three domain types: `WLS`, `RestrictedJRF`, a

To have the Create Domain Tool run RCU, simply add the `-run_rcu` argument to the previous command line and the RCU schemas will be automatically created. Be aware that when the tool runs RCU, it will automatically drop any conflicting schemas that already exist with the same RCU prefix prior to creating the new schemas!

It is also possible to specify the connection information in the model instead of using the command-line arguments. This is especially easier for databases that require complex database connection string and extra parameters, such as RAC or Oracle Autonomous Transaction Processing Cloud Service database. For information on how to use it, refer to [Specifying RCU connection information in the model]({{< relref "/content/rcuinfo.md" >}}).
It is also possible to specify the connection information in the model instead of using the command-line arguments. This is especially easier for databases that require complex database connection string and extra parameters, such as RAC or Oracle Autonomous Transaction Processing Cloud Service database. For information on how to use it, refer to [Specifying RCU connection information in the model]({{< relref "/content/userguide/database/connect-db.md" >}}).

To create more complex domains, it may be necessary to create a custom domain type. This is useful for cases where the domain has custom templates, or templates for other Oracle products. For more information, refer to [Domain type definitions]({{< relref "/userguide/tools-config/domain_def.md" >}}).

Expand Down