Add parameter tables to 2.0 documentation (#1062)

CarolynRountree · web-flow · commit 7953bc76a079 · 2022-02-04T14:03:22.000-06:00
* Add parameter tables to 2.0 documentation

* fix for comments. standardize where necessary

* quotes around parameters in table

* Update DomainInfo.json
diff --git a/documentation/2.0/content/userguide/tools/compare.md b/documentation/2.0/content/userguide/tools/compare.md
@@ -285,10 +285,17 @@ Comparing the new and old models:
 
  To compare the two model files and generate the output to files, run the tool as follows:
 
-    $ weblogic-deploy\bin\compareModel.cmd -oracle_home c:\wls12213 -output_dir c:\cm-output ew_model.yaml old_model.yaml
+    $ weblogic-deploy\bin\compareModel.cmd -oracle_home c:\wls12213 -output_dir c:\cm-output new_model.yaml old_model.yaml
 
     The following files will be written to the directory:
 
     diffed_model.json
     diffed_model.yaml
     compare_model_stdout
+
+### Parameter table for compareModel
+| Parameter | Definition | Default |
+| --- | --- | --- |
+| `-oracle_home` | Home directory of the Oracle installation. Required if ORACLE_HOME environment variable is not set. |    |
+| `-output_dir` | (Required) Directory in which to store the output. |    |
+| `-variable_file` | Variable file used for token substitution. |    |
diff --git a/documentation/2.0/content/userguide/tools/create.md b/documentation/2.0/content/userguide/tools/create.md
@@ -58,3 +58,24 @@ topology:
     AdminServerName: "admin-server"
     ProductionModeEnabled: false
 ```
+
+### Parameter table for createDomain
+| Parameter | Definition | Default |
+| --- | --- | --- |
+| `-archive_file` | The path to the archive file to use.  If the -model_file argument is not specified, the model file in this archive will be used.  This can also be specified as a comma-separated list of archive files.  The overlapping contents in each archive take precedence over previous archives in the list. |    |
+| `-domain_home` | Required if -domain_parent is not used. The full directory and name where the domain should be created.
+| `-domain_parent` | Required if -domain_home is not used. The parent directory where the domain should be created. The name is the domain name in the model. |    |
+| `-domain_type` | The type of domain (for example, WLS, JRF). | WLS |
+| `-java_home` | The Java Home to use for the new domain. If not specified, it defaults to the value of the JAVA_HOME environment variable. |    |
+| `-model_file` | The location of the model file.  This can also be specified as a comma-separated list of model locations, where each successive model layers on top of the previous ones. |    |
+| `-oracle_home` | Home directory of the Oracle WebLogic installation. Required if ORACLE_HOME environment variable is not set.|    |
+| `-opss_wallet_passphrase_env` | An alternative to entering the OPSS wallet passphrase at a prompt. The value is an ENVIRONMENT VARIABLE name that WDT will use to retrieve the passphrase. |    |
+| `-opss_wallet_passphrase_file` | An alternative to entering the OPSS wallet passphrase at a prompt. The value is the name of a file with a string value which WDT will read to retrieve the passphrase.
+| `-passphrase_env` | An alternative to entering the encryption passphrase at a prompt. The value is an ENVIRONMENT VARIABLE name that WDT will use to retrieve the passphrase. |    |
+| `-passphrase_file` | An alternative to entering the encryption passphrase at a prompt. The value is the name of a file with a string value which WDT will read to retrieve the passphrase. |    |
+| `-rcu_database` | The RCU database connect string.  |    |
+| `-rcu_prefix` | The RCU prefix to use. |    |
+| `-rcu_db_user` | The RCU dbUser to use. | sys |
+| `-run_rcu` | Run RCU to create the database schemas specified by the domain type using the specified RCU prefix. Running RCU will drop any existing schemas with the same RCU prefix if they exist prior to trying to create them. |    |
+| `-use_encryption` | One or more of the passwords in the model or variables file(s) are encrypted and must be decrypted. Java 8 or later required for this feature. |    |
+| `-variable_file` | The location of the property file containing the values for variables used in the model. This can also be specified as a comma-separated list of property files, where each successive set of properties layers on top of the previous ones. |    |
diff --git a/documentation/2.0/content/userguide/tools/deploy.md b/documentation/2.0/content/userguide/tools/deploy.md
@@ -41,3 +41,23 @@ If the model or variables file contains passwords encrypted with the WDT Encrypt
 ### Using multiple models
 
 The Deploy Applications Tool supports the use of multiple models, as described in [Using multiple models]({{< relref "/concepts/model#using-multiple-models" >}}).
+
+### Parameter table for deployApps
+| Parameter | Definition | Default |
+| ---- | ---- | ---- |
+| `-admin_pass_env` | An alternative to entering the admin password at a prompt. The value is an ENVIRONMENT VARIABLE name that WDT will use to retrieve the password. |    |
+| `-admin_pass_file` |  An alternative to entering the admin password at a prompt. The value is a the name of a file that contains a password string that the tool will read to retrieve the password. |    |
+| `-admin_url` | The admin server URL used for online deploy. |    |
+| `-admin_user` | The admin username used for online deploy. |    |
+| `-archive_file` | The path to the archive file. If the model_file argument is not used, the model file in this file will be used. This can also be specified as a comma-separated list of archive files.  The overlapping contents in each archive take precedence over previous archives in the list. |    |
+| `-cancel_changes_if_restart_required` | Cancel the changes if the update requires domain restart. |    |
+| `-discard_current_edit` | Discard all current domain edits before starting update. |    |
+| `-domain_home` | (Required). The location of the existing domain home. |    |
+| `-domain_type` | The type of domain.  (for example, WLS, JRF) | WLS |
+| `-model_file` | The location of the model file. This can also be specified as a comma-separated list of model locations, where each successive model layers on top of the previous ones. |    |
+| `-oracle_home` | Home directory of the Oracle WebLogic installation. Required if ORACLE_HOME environment variable is not set.|    |
+| `-output_dir` | If present, write restart information to this directory as restart.file, or, if cancel_changes_if_restart_required used, write non dynamic changes information to file. |    |
+| `-passphrase_env` | An alternative to entering the encryption passphrase at a prompt. The value is an ENVIRONMENT VARIABLE name that WDT will use to retrieve the passphrase. |    |
+| `-passphrase_file` | An alternative to entering the encryption passphrase at a prompt. The value is the name of a file with a string value which WDT will read to retrieve the passphrase. |    |
+| `-use_encryption` | One or more of the passwords in the model or variables file(s) are encrypted and must be decrypted. Java 8 or later required for this feature. |    |
+| `-variable_file` | The location of the property file containing the values for variables used in the model. This can also be specified as a comma-separated list of property files, where each successive set of properties layers on top of the previous ones. |    |
diff --git a/documentation/2.0/content/userguide/tools/discover.md b/documentation/2.0/content/userguide/tools/discover.md
@@ -76,3 +76,22 @@ The following environment variables may be set.
 ### Opening an issue against Discover Domain
 
 Please provide the `STDOUT` and `STDERR` log streams in the GitHub Issue. If the summary is not listed (unhandled exception stack trace occurs), be sure and include the Oracle and WDT install versions and whether the tool was run in online or offline WLST mode. If possible, provide the model, variable and archive files, and the log file, `discoverDomain.log`, from location `<install home>\weblogic-deploy\log`.
+
+### Parameter table for discoverDomain
+| Parameter | Definition | Default |
+| ---- | ---- | ---- |
+| `-archive_file` | The path to the archive file. |    |
+| `-admin_pass_env` | An alternative to entering the admin password at a prompt. The value is a ENVIRONMENT VARIABLE name that WDT will use to retrieve the password. |    |
+| `-admin_pass_file` | An alternative to entering the admin password at a prompt. The value is a the name of a file that contains a password string that the tool will read to retrieve the password. |    |
+| `-admin_url` | The admin server URL used for online discovery. |    |
+| `-admin_user` | The admin user used for online discovery. |    |
+| `-domain_home` | (Required). The location of the existing domain home. |    |
+| `-domain_type` | The type of domain.  (for example, WLS, JRF) | WLS |
+| `-java_home` | Overrides the JAVA_HOME value when discovering domain values to be replaced with the java home global token. |    |
+| `-model_file` | The path to the model file. If not present, model file will be stored in archive file. |    |
+| `-oracle_home` | Home directory of the Oracle WebLogic installation. Required if ORACLE_HOME environment variable is not set. |    |
+| `-output_dir` | Output directory required for -target. |    |
+| `-skip_archive` | Do not generate an archive file. The archive_file option will be ignored. |    |
+| `-target` | Targeting platform - k8s, wko, vz. |    |
+| `-variable_file` | The location to write properties for attributes that have been replaced with tokens by the variable injector. If this is included, all credentials will automatically be replaced by tokens and the property written to this file. |    |
+
diff --git a/documentation/2.0/content/userguide/tools/encrypt.md b/documentation/2.0/content/userguide/tools/encrypt.md
@@ -219,3 +219,13 @@ The variable file will now look something like the following:
     db.url=mydb.example.com:1539/PDBORCL
     db.password={AES}czFXMkNFWNG9jNTNYd0hRL2R1anBnb0hDUlp4K1liQWFBdVM4UTlvMnE0NU1aMUZ5UVhiK25oaWFBc2lIQ20\=
     mymailsession.password={AES}RW9nRnUzcE41WGNMdnEzNDdRQVVNWm1LMGhidkFBVXg6OUN3aXcyci82cmh3cnpNQTpmY2UycUp5YWl4UT0\=
+
+### Parameter table for encrypt tool
+| Parameter | Definition | Default |
+| ---- | ---- | ---- |
+| `-manual` | Run without a model and get an encrypted value for a single password. |    |
+| `-model_file` | The location of the model file or a set of model files. |    |
+| `-oracle_home` | Home directory of the Oracle WebLogic installation. Required if ORACLE_HOME environment variable is not set. |    |
+| `-passphrase_env` | An alternative to entering the encryption passphrase at a prompt. The value is a ENVIRONMENT VARIABLE name that WDT will use to retrieve the passphrase. |    |
+| `-passphrase_file` | An alternative to entering the encryption passphrase at a prompt. The value is a the name of a file with a string value which WDT will read to retrieve the passphrase. |    |
+| `-variable_file` | The location and name of the property file containing the variable values for all variables used in the model(s). |    |
diff --git a/documentation/2.0/content/userguide/tools/kubernetes.md b/documentation/2.0/content/userguide/tools/kubernetes.md
@@ -123,3 +123,13 @@ The [Model Help Tool]({{< relref "/userguide/tools/model_help.md" >}}) can be us
 ```
 
 The content in the `kubernetes` section is not generated when a model is discovered by the Discover Domain Tool.  
+
+### Parameter table for extractResources
+| Parameter | Definition | Default |
+| ---- | ---- | ---- |
+| `-archive_file` | The path to the archive file.  If the -model_file argument is not specified, the model file in this archive will be used.  This can also be specified as a comma-separated list of archive files.  The overlapping contents in each archive take precedence over previous archives in the list. |    |
+| `-domain_home` | (Required) The domain home directory. |    |
+| `-domain_resource_file` | (Required) The location of the extracted domain resource file. |    |
+| `-model_file` | The location of the model file.  This can also be specified as a comma-separated list of model locations, where each successive model layers on top of the previous ones. |    |
+| `-oracle_home` | Home directory of the Oracle WebLogic installation. Required if ORACLE_HOME environment variable is not set. |    |
+| `-variable_file` | The location of the property file containing the values for variables used in the model. This can also be specified as a comma-separated list of property files, where each successive set of properties layers on top of the previous ones. |    |
diff --git a/documentation/2.0/content/userguide/tools/model_help.md b/documentation/2.0/content/userguide/tools/model_help.md
@@ -120,9 +120,18 @@ resources:
                 JDBCDataSourceParams:
                 JDBCDriverParams:
                     Properties:
-                        'Properties-1':
+                        'Properties-1'
                 JDBCOracleParams:
                 JDBCXAParams:
             SubDeployment:
                 'SubDeployment-1':
 ```
+
+### Parameter table for model_help
+| Parameter | Definition | Default |
+| ---- | ---- | ---- | 
+| `-attributes_only` | List only the attributes for the specified model path. |    |
+| `-folders_only` | List only the folders for the specified model path. |    |
+| `-oracle_home` | Home directory of the Oracle WebLogic installation. Required if ORACLE_HOME environment variable is not set. |    |
+| `-recursive` | List only the folders for the specified model path, and recursively include the folders below that path. |    |
+| `<model_path>` | The path to the model element to be examined. The format is [^<section^>:][/^<folder^>]... |    |
diff --git a/documentation/2.0/content/userguide/tools/prepare.md b/documentation/2.0/content/userguide/tools/prepare.md
@@ -37,4 +37,13 @@ wko-domain.yaml
 You can then customize the `wko_variable.properties` and `create_k8s_secrets.sh` to provide environment-specific values.
 
 
-For more information about additional target environments and options, see [Target environments]({{< relref "/userguide/target_env.md" >}}).
+For more information about additional target environments and options, see [Target environments]({{< relref "/userguide/target_env.md" >}}). 
+
+### Parameter table for prepareModel
+| Parameter | Definition | Default |
+| ---- | ---- | ---- |
+| `-model_file` | (Required). Location of the model file. This can also be specified as a comma-separated list of models, where each successive model layers on top of the previous ones. |    |
+| `-oracle_home` | Home directory of the Oracle WebLogic installation. Required if ORACLE_HOME environment variable is not set. |    |
+| `-output_dir` | (Required) Location where to write the output files. |    |
+| `-target` | (Required) Name of the target configuration such as wko, vz, k8s. |    |
+| `-variable_file` | The location of the property file containing the values for variables used in the model. This can also be specified as a comma-separated list of property files, where each successive set of properties layers on top of the previous ones. |    |
diff --git a/documentation/2.0/content/userguide/tools/update.md b/documentation/2.0/content/userguide/tools/update.md
@@ -37,3 +37,23 @@ If the model or variables file contains passwords encrypted with the WDT Encrypt
 ### Using multiple models
 
 The Update Domain Tool supports the use of multiple models, as described in [Using multiple models]({{< relref "/concepts/model#using-multiple-models" >}}).
+
+### Parameter table for updateDomain
+| Parameter | Definition | Default |
+| ---- | ---- | ---- |
+| `-admin_pass_env` | An alternative to entering the admin password at a prompt. The value is a ENVIRONMENT VARIABLE name that WDT will use to retrieve the password. |    |
+| `-admin_pass_file` | An alternative to entering the admin password at a prompt. The value is a the name of a file that contains a password string that the tool will read to retrieve the password. |    |
+| `-admin_url` | The admin server URL for online update. |    |
+| `-admin_user` | The admin username for online update. |    |
+| `-archive_file` | The path to the archive file to use. If the -model_file argument is not specified, the model file in this archive will be used. This can also be specified as a comma-separated list of archive files. The overlapping contents in each archive take precedence over previous archives in the list. |    |
+| `-cancel_changes_if_restart_required` | Cancel the changes if the update requires domain restart. |   |
+| `-discard_current_edit` | Discard all existing domain edits before the update. |    |
+| `-domain_home` | (Required) The location of the existing domain home. |    |
+| `-domain_type` | The type of domain.  (for example, WLS, JRF) | WLS |
+| `-model_file` | The location of the model file. This can also be specified as a comma-separated list of model locations, where each successive model layers on top of the previous ones. |    |
+| `-oracle_home` | Home directory of the Oracle WebLogic installation. Required if ORACLE_HOME environment variable is not set. |    |
+| `-passphrase_env` | An alternative to entering the encryption passphrase at a prompt. The value is a ENVIRONMENT VARIABLE name that WDT will use to retrieve the passphrase. |    |
+| `-passphrase_file` | An alternative to entering the encryption passphrase at a prompt. The value is a the name of a file with a string value which WDT will read to retrieve the passphrase. |    |
+| `-update_dir` | If present, write restart information to this directory as restart.file, or if cancel_changes_if_restart_required used, write non dynamic changes information to non_dynamic_changes file. |    |
+| `-use_encryption` | One or more of the passwords in the model or variables file(s) are encrypted and must be decrypted. Java 8 or later required for this feature. |    |
+| `-variable_home` | The location of the property file containing the values for variables used in the model. This can also be specified as a comma-separated list of property files, where each successive set of properties layers on top of the previous ones. |    |
diff --git a/documentation/2.0/content/userguide/tools/validate.md b/documentation/2.0/content/userguide/tools/validate.md
@@ -99,3 +99,14 @@ Results in output similar to that shown below, if the `simpleear.ear` file is no
 ### Using multiple models
 
 The Validate Model Tool supports the use of multiple models, as described in [Using multiple models]({{< relref "/concepts/model#using-multiple-models" >}}).
+
+### Parameter table for validateModel
+| Parameter | Definition | Default |
+| ---- | ---- | ---- |
+| `-archive_file` | The path to the archive file to use.  If the archive file is not provided, validation will only validate the artifacts provided.  This can also be specified as a comma-separated list of archive files.  The overlapping contents in each archive take precedence over previous archives in the list. |    |
+| `-domain_type` | The type of domain.  (for example, WLS, JRF) | WLS |
+| `-model_file` | The location of the model file to use.  This can also be specified as a comma-separated list of model locations, where each successive model layers on top of the previous ones. If not specified, the tool will look for the model in the archive. If the model is not found, validation will only validate the artifacts provided. |    |
+| `-oracle_home` | Home directory of the Oracle WebLogic installation. Required if ORACLE_HOME environment variable is not set. |    |
+| `-target_mode` | The target WLST mode that the tool should use to validate the model content.  The only valid values are online or offline. | offline |
+| `-target_version` | The target version of WebLogic Server the tool should use to validate the model content.  This version number can be different than the version being used to run the tool.  | Oracle home version   |
+| `-variable_file` | The location of the property file containing the variable values for all variables used in the model. If the variable file is not provided, validation will only validate the artifacts provided. |    |
diff --git a/documentation/2.0/content/userguide/tools/variable_injection.md b/documentation/2.0/content/userguide/tools/variable_injection.md
diff --git a/installer/src/main/bin/deployApps.cmd b/installer/src/main/bin/deployApps.cmd
