Documentrcudbinfo (#318)

* initial add rcudb info documentation

* Update rcuinfo.md

Add RCUDbInfo document

* renme key tns.entry to tns.alias

* fix formatting

* formatting

* formatting

* add linkage to rcudb info

* fix link

* Update rcuinfo.md

fix syntax and grammar

* Update rcuinfo.md

* Update rcuinfo.md

* Update create.md

* Update create.md

* Update create.md

* Update rcuinfo.md

* Update rcuinfo.md

* Update rcuinfo.md

* Update create.md

Author: jshum2479

core/src/main/java/oracle/weblogic/deploy/create/RCURunner.java

@@ -144,7 +144,7 @@ public RCURunner(String domainType, String oracleHome, String javaHome, List<Str
 
         this.oracleHome = validateExistingDirectory(oracleHome, "ORACLE_HOME");
         this.javaHome = validateExistingDirectory(javaHome, "JAVA_HOME");
-        this.rcuDb = "jdbc:oracle:thin:@" + rcuProperties.get(new PyString("tns.entry")).toString();
+        this.rcuDb = "jdbc:oracle:thin:@" + rcuProperties.get(new PyString("tns.alias")).toString();
         this.rcuPrefix = rcuProperties.get(new PyString("rcu_prefix")).toString();
         this.rcuSchemas = validateNonEmptyListOfStrings(rcuSchemas, "rcu_schema_list");
         this.atpAdminUser = rcuProperties.get(new PyString("atp.admin.user")).toString();

core/src/main/python/wlsdeploy/aliases/model_constants.py

@@ -24,7 +24,7 @@
 RCU_DB_CONN = 'rcu_db_conn_string'
 RCU_VARIABLES = 'rcu_variables'
 USE_ATP = 'useATP'
-ATP_TNS_ENTRY = 'tns.entry'
+ATP_TNS_ENTRY = 'tns.alias'
 ATP_DEFAULT_TABLESPACE = 'atp.default.tablespace'
 ATP_TEMPORARY_TABLESPACE = 'atp.temp.tablespace'
 ATP_ADMIN_USER = 'atp.admin.user'

site/create.md

@@ -19,6 +19,8 @@ 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](rcuinfo.md)
+
 The Create Domain Tool has an extensible domain type system.  The three built-in domain types (`WLS`, `RestrictedJRF`, and `JRF`) are defined in JSON files of the same name in the `WLSDEPLOY_HOME/lib/typedefs` directory.  For example, the `JRF` domain type is defined in the `WLSDEPLOY_HOME/lib/typedefs/JRF.json` file whose contents look like those shown below.
 
 ```json

site/rcuinfo.md

@@ -0,0 +1,45 @@
+## 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.
+
+For example, in order to use the Oracle Autonomous Transaction Processing Cloud Database for the JRF domain, specify the following information in the model:
+
+```yaml
+domainInfo:
+    RCUDbInfo:
+        useATP : 1
+        rcu_prefix : DEV
+        rcu_schema_password : xxxxx
+        rcu_admin_user : admin
+        tns.alias : dbatp_tp
+        javax.net.ssl.keyStorePassword : xxxx
+        javax.net.ssl.trustStorePassword : xxxx
+```           
+The database wallet can be included in the archive file under `atpwallet` zipentry structure
+
+`atpwallet/Walletxyz.zip`
+        
+Using the Create Domain Tool with the `-run_rcu` flag will create the RCU schemas against the Oracle Autonomous Transaction Processing Cloud Database and configure the datasources in the JRF domain to use the database.  For example:
+
+    weblogic-deploy/bin/updateDomain.sh -oracle_home /u01/wls12213 -domain_type JRF -domain_home /u01/data/domains/demodomain -archive_file DemoDomain.zip -run_rcu 
+
+For a non-ATP database, use the following example:
+
+```yaml
+domainInfo:
+    RCUDbInfo:
+        useATP : 0
+        rcu_prefix : DEV
+        rcu_schema_password : xxxxx
+        rcu_admin_password : xxxx
+        rcu_db_conn_string : 'dbhost:1521/pdborcl'
+```        
+RCU `-variables` option of the repository creation utility can now be included in the `RCUDbInfo` section with the key `rcu_variables`:
+
+```yaml
+domainInfo:
+    RCUDbInfo:
+        rcu_variables : 'xxxx'
+```    
+        
+