diff --git a/documentation/2.0/content/userguide/tools/compare.md b/documentation/2.0/content/userguide/tools/compare.md index 1a88545b3..1e1118805 100644 --- 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. | | \ No newline at end of file diff --git a/documentation/2.0/content/userguide/tools/create.md b/documentation/2.0/content/userguide/tools/create.md index 1c50bbf4c..17c5e106a 100644 --- 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. | | \ No newline at end of file diff --git a/documentation/2.0/content/userguide/tools/deploy.md b/documentation/2.0/content/userguide/tools/deploy.md index 896dfd1e1..634ec22ae 100644 --- 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 index 872f6d202..82727ca95 100644 --- 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 `\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 index e01c0faec..56bd98077 100644 --- 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 index c4e6063fe..ba9be6ea3 100644 --- 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. | | \ No newline at end of file diff --git a/documentation/2.0/content/userguide/tools/model_help.md b/documentation/2.0/content/userguide/tools/model_help.md index db6ed4ed8..662a9d51a 100644 --- 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. | | +| `` | The path to the model element to be examined. The format is [^:][/^]... | | diff --git a/documentation/2.0/content/userguide/tools/prepare.md b/documentation/2.0/content/userguide/tools/prepare.md index 3b23aa751..6c78ad3a6 100644 --- a/documentation/2.0/content/userguide/tools/prepare.md +++ b/documentation/2.0/content/userguide/tools/prepare.md @@ -36,4 +36,13 @@ wko_variable.properties 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 index d569031c9..df7edce8c 100644 --- 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 index 594dc1d5f..69cbb55ad 100644 --- 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 index 18ab913da..278c55307 100644 --- a/documentation/2.0/content/userguide/tools/variable_injection.md +++ b/documentation/2.0/content/userguide/tools/variable_injection.md @@ -214,3 +214,12 @@ A custom injector for the Administration Server SSL listen port is: ### Variable injector sample A sample of a `model_variable_injector.json` file and a custom injector JSON file are installed in the `WLSDEPLOY/samples` directory. + +### Parameter table for injectVariables +| Parameter | Definition | Default | +| ---- | ---- | ---- | +| `-archive_file` | The path to the archive file that contains a model in which the variables will be injected. If the -model_file argument is used, this argument will be ignored. | | +| `-model_file` | The location of the model file in which variables will be injected. If not specified, the tool will look for the model in the archive file. Either the model_file or the archive_file argument must be provided. | | +| `-oracle_home` | Home directory for the Oracle WebLogic installation. This is required unless the ORACLE_HOME environment variable is set. | | +| `-variable_injector_file` | The location of the variable injector file which contains the variable injector keywords for this model injection run. If this argument is not provided, the `model_variable_injector.json` file must exist in the lib directory in the WLSDEPLOY_HOME location. | | +| `-variable_properties_file` | The location of the property file in which to store any variable names injected into the model. If this command-line argument is not specified, the variable will be located and named based on the model file or archive file name and location. If the file exists, the file will be updated with new variable values. | | \ No newline at end of file diff --git a/installer/src/main/bin/deployApps.cmd b/installer/src/main/bin/deployApps.cmd index 581fc3c8e..b09e0ee97 100644 --- a/installer/src/main/bin/deployApps.cmd +++ b/installer/src/main/bin/deployApps.cmd @@ -79,7 +79,7 @@ ECHO [-domain_type ^] ECHO [-passphrase_env ^] ECHO [-passphrase_file ^] ECHO [-wlst_path ^] -ECHO [-canel_changes_if_restart_required] +ECHO [-cancel_changes_if_restart_required] ECHO [-discard_current_edit] ECHO [-output_dir] ECHO [-admin_pass_env ^