You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: documentation/2.0/content/userguide/tools/create.md
+13-12Lines changed: 13 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,7 +32,8 @@ To create more complex domains, it may be necessary to create a custom domain ty
32
32
33
33
### Using an encrypted model
34
34
35
-
If the model or variables file contains passwords encrypted with the WDT Encryption tool, decrypt the passwords during create with the `-use_encryption` flag on the command line to tell the Create Domain Tool that encryption is being used and to prompt for the encryption passphrase. As with the database passwords, the tool can also read the passphrase from standard input (for example, `stdin`) to allow the tool to run without any user input. You can bypass the stdin prompt with two other options. You can bypass the stdin prompt with two other options: store the passphrase in an environment variable, and use the environment variable name with the command-line option -passphrase_env or create a file with the single value of the passphrase. Provide the name of the file with the command-line option -passphrase_file. The passphrase will be read by the tool from the file.
35
+
If the model or variables file contains passwords encrypted with the WDT Encryption tool, decrypt the passwords during create with the `-use_encryption` flag on the command line to tell the Create Domain Tool that encryption is being used and to prompt for the encryption passphrase. As with the database passwords, the tool can also read the passphrase from standard input (for example, `stdin`) to allow the tool to run without any user input. You can bypass the stdin prompt with two other options. You can bypass the stdin prompt with two other options: store the passphrase in an environment variable, and use the environment variable name with the command-line
36
+
option `-passphrase_env` or create a file with the single value of the passphrase. Provide the name of the file with the command-line option `-passphrase_file`. The passphrase will be read by the tool from the file.
36
37
37
38
### Using multiple models
38
39
@@ -59,23 +60,23 @@ topology:
59
60
ProductionModeEnabled: false
60
61
```
61
62
62
-
### Parameter table for createDomain
63
+
### Parameter table for `createDomain`
63
64
| Parameter | Definition | Default |
64
65
| --- | --- | --- |
65
-
| `-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. | |
66
-
| `-domain_home` | Required if -domain_parent is not used. The full directory and name where the domain should be created.
67
-
| `-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. | |
68
-
| `-domain_type` | The type of domain (for example, WLS, JRF). | WLS |
69
-
| `-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. | |
66
+
| `-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. | |
67
+
| `-domain_home` | Required if `-domain_parent` is not used. The full directory and name where the domain should be created.
68
+
| `-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. | |
69
+
| `-domain_type` | The type of domain (for example, `WLS`, `JRF`). | `WLS` |
70
+
| `-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. | |
70
71
| `-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. | |
71
-
| `-oracle_home` | Home directory of the Oracle WebLogic installation. Required if ORACLE_HOME environment variable is not set.| |
72
-
| `-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. | |
72
+
| `-oracle_home` | Home directory of the Oracle WebLogic installation. Required if the `ORACLE_HOME` environment variable is not set.| |
73
+
| `-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. | |
73
74
| `-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.
74
-
| `-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. | |
75
+
| `-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. | |
75
76
| `-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. | |
76
77
| `-rcu_database` | The RCU database connect string. | |
77
78
| `-rcu_prefix` | The RCU prefix to use. | |
78
-
| `-rcu_db_user` | The RCU dbUser to use. | sys |
79
+
| `-rcu_db_user` | The RCU `dbUser` to use. | `sys` |
79
80
| `-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. | |
80
81
| `-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. | |
81
-
| `-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. | |
82
+
| `-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. | |
To run the tool in online mode, add the `-admin_url` and `admin_user` arguments with the necessary values to connect to the WebLogic Server Administration Server. For example:
25
+
To run the tool in online mode, add the `-admin_url` and `-admin_user` arguments with the necessary values to connect to the WebLogic Server Administration Server. For example:
As usual, the tool will prompt for the password (it can also be supplied by piping it to standard input of the tool). To bypass the prompt, you can use one of two options. Store the password in an environment variable, and use the variable name with commandline option -admin_pass_env. Store the password in a file. Provide the file name with commandline option -admin_pass_file.
29
+
As usual, the tool will prompt for the password (it can also be supplied by piping it to standard input of the tool). To bypass the prompt, you can use one of two options. Store the password in an environment variable, and use the variable name with command-line option `-admin_pass_env`. Store the password in a file. Provide the file name with command-line option `-admin_pass_file`.
30
30
31
31
When running the tool in WLST online mode, the deploy operation may require server restarts or a domain restart to pick up the changes. The deploy operation can also encounter situations where it cannot complete its operation until the domain is restarted. To communicate these conditions to scripts that may be calling the Deploy Applications Tool, the shell scripts have three special, non-zero exit codes to communicate these states:
32
32
33
33
-`103` - The entire domain needs to be restarted.
34
-
-`104` - The domain changes have been canceled because the changes in the model requires a domain restart and -cancel_changes_if_restart_required is specified.
34
+
-`104` - The domain changes have been canceled because the changes in the model requires a domain restart and `-cancel_changes_if_restart_required` is specified.
35
35
36
36
### Using an encrypted model
37
37
38
-
If the model or variables file contains passwords encrypted with the WDT Encryption tool, decrypt the passwords during create with the `-use_encryption` flag on the command line to tell the Deploy Applications Tool that encryption is being used and to prompt for the encryption passphrase. As with the database passwords, the tool can also read the passphrase from standard input (for example, `stdin`) to allow the tool to run without any user input. You can bypass the stdin prompt with two other options. Store the passphrase in an environment variable, and use the environment variable name with commandline option -passphrase_env. Another option is to create a file containing the passphrase value. Pass this filename using the commandline option -passphrase_file
38
+
If the model or variables file contains passwords encrypted with the WDT Encryption tool, decrypt the passwords during create with the `-use_encryption` flag on the command line to tell the Deploy Applications Tool that encryption is being used and to prompt for the encryption passphrase. As with the database passwords, the tool can also read the passphrase from standard input (for example, `stdin`) to allow the tool to run without any user input. You can bypass the stdin prompt with two other options. Store the passphrase in an environment variable, and use the environment variable name with command-line option `-passphrase_env`. Another option is to create a file containing the passphrase value. Pass this filename using the command-line option `-passphrase_file`.
39
39
40
40
41
41
### Using multiple models
42
42
43
43
The Deploy Applications Tool supports the use of multiple models, as described in [Using multiple models]({{< relref "/concepts/model#using-multiple-models" >}}).
44
44
45
-
### Parameter table for deployApps
45
+
### Parameter table for `deployApps`
46
46
| Parameter | Definition | Default |
47
47
| ---- | ---- | ---- |
48
-
|`-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. ||
48
+
|`-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. ||
49
49
|`-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. ||
50
50
|`-admin_url`| The admin server URL used for online deploy. ||
51
-
|`-admin_user`| The admin username used for online deploy. ||
52
-
|`-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. ||
53
-
|`-cancel_changes_if_restart_required`| Cancel the changes if the update requires domain restart. ||
54
-
|`-discard_current_edit`| Discard all current domain edits before starting update. ||
51
+
|`-admin_user`| The admin user name used for online deploy. ||
52
+
|`-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. ||
53
+
|`-cancel_changes_if_restart_required`| Cancel the changes if the update requires a domain restart. ||
54
+
|`-discard_current_edit`| Discard all current domain edits before starting the update. ||
55
55
|`-domain_home`| (Required). The location of the existing domain home. ||
56
-
|`-domain_type`| The type of domain. (for example, WLS, JRF) | WLS |
56
+
|`-domain_type`| The type of domain. (for example, `WLS`, `JRF`) |`WLS`|
57
57
|`-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. ||
58
-
|`-oracle_home`| Home directory of the Oracle WebLogic installation. Required if ORACLE_HOME environment variable is not set.||
59
-
|`-output_dir`| If present, write restart information to this directory as restart.file, or, if cancel_changes_if_restart_required used, write nondynamic changes information to file. ||
60
-
|`-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. ||
58
+
|`-oracle_home`| Home directory of the Oracle WebLogic installation. Required if the `ORACLE_HOME` environment variable is not set.||
59
+
|`-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. ||
60
+
|`-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. ||
61
61
|`-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. ||
62
-
|`-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. ||
62
+
|`-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 is required for this feature. ||
63
63
|`-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. ||
0 commit comments