Note:
To update a WebLogic domain that includes other Fusion Middleware products in addition to WebLogic Server, see Updating a WebLogic Domain That Includes Fusion Middleware Products.
For example, if you created a base WebLogic domain and you want to add Advanced Web Services for JAX-WS, you can select the WebLogic Advanced Web Services for JAX-WS Extension template on the Templates screen. You can also use the Configuration Wizard to change your domain configuration without adding additional applications. For example, you may want to add additional Managed Servers and clusters, or you may want to change service targeting or migratable target settings.
Note:
You can only update a domain that was created by the same WebLogic Server installation from which you run the Configuration Wizard. That is, the domain you are updating must be registered in the domain-registry.xml file of your WebLogic Server installation. You cannot update a domain that was created by another WebLogic Server installation.
Prior to updating a domain that was created with an earlier release of WebLogic Server, you must use the Reconfiguration Wizard to reconfigure the domain. Doing so updates the domain to be compatible with the current WebLogic Server release, and registers the domain in your current WebLogic Server installation. For more information, see Reconfiguring WebLogic Domains in Oracle Fusion Middleware Upgrading Oracle WebLogic Server.
The Configuration Wizard simplifies the task of updating an existing WebLogic domain by using extension templates. Oracle provides various sample extension templates, as well as extension templates for various Fusion Middleware products. You can also create your own extension templates using WLST or the unpack command.
For information about extension templates provided by Oracle, see Types of Templates in Oracle Fusion Middleware Domain Template Reference.
This chapter includes the following sections:
CONFIG_JVM_ARGS to reduce the time it takes for the Configuration Wizard to create or update a domain.pack and unpack commands) to remote machines, the startup scripts on the remote machines are not updated automatically. You must update them manually.Set the value of the environment variable CONFIG_JVM_ARGS to reduce the time it takes for the Configuration Wizard to create or update a domain.
Prior to running the Configuration Wizard to update a domain on a UNIX or Linux operating system, if you have not already done so, set the CONFIG_JVM_ARGS environment variable to the following value:
-Djava.security.egd=file:/dev/./urandom
You can update a domain by adding additional product components to the domain or by specifying an extension template JAR file.
To update a WebLogic domain, select the domain to update and, if you want to add additional products to the domain, select one or more additional product components on the Templates screen. Alternatively, you can update an existing domain by specifying an extension template JAR file that includes additional applications and services, or defines additional components (such as Managed Servers and clusters). You can also customize the JDBC connections and change the JMS file store. The Configuration Wizard uses your input to update the configuration files, such as config.xml, and all other generated components in the domain directory, as required.
Use the Configuration Wizard in graphical mode to update a WebLogic Domain. The Configuration Wizard takes you through a series of screens that help you update a WebLogic Server domain.
To update a new WebLogic Domain by using the Configuration Wizard in graphical mode, start the Configuration Wizard as described in Starting the Configuration Wizard.
Note:
In situations where you cannot run the Configuration Wizard in GUI mode, Oracle recommends that you use a WLST script to create or update a domain. For more information, see Creating and Using a Domain Template (Offline) in Oracle Fusion Middleware Understanding the WebLogic Scripting Tool.
If your installation includes Fusion Middleware products, refer to Configuring Fusion Middleware Domains, for instructions. Fusion Middleware product configuration includes additional Configuration Wizard screens that are not included in the workflow in this chapter.
The Configuration Wizard displays a sequence of screens, in the order listed in Table 3-1. For more information on each screen, refer to the related section in Configuration Wizard Screens, or click the link in the Screen column.
Table 3-1 Configuration Screens for Extending an Existing WebLogic Domain
| Screen | When Does This Screen Appear? | Perform the Following Action |
|---|---|---|
|
Always |
Select Update an Existing Domain. Select the domain directory from the Existing Domain Directory drop-down list, or click Browse to navigate to and select the domain directory. Click Next to continue. |
|
|
Always |
Do one of the following:
Click Next to continue. Note: When updating a domain using a custom template, you must comply with domain version restrictions as described in Domain Version Restrictions. |
|
|
Only if one or more of the selected templates define an application. |
Specify the directory in which the domain's applications are to be stored. Click Next to continue. |
|
|
Data Source Configuration |
Only if the selected products or template includes components that require JDBC data sources or Oracle RAC multi data sources |
See Configuring Data Sources, for information about these screens. |
|
Always |
Select the check box for each category (if any) for which you want to perform advanced configuration tasks The available check boxes depend on the resources that are configured in the selected products or template. Note: When extending a domain, you cannot change the Administration Server and Node Manager configurations. Therefore, these options are not available. Click Next to continue. |
|
|
Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen |
Add, delete, or reconfigure Managed Servers as needed. Click Next to continue. |
|
|
Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen |
Add, delete, or reconfigure clusters as needed. Click Next to continue. |
|
|
Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen, and your domain includes at least one cluster |
Add servers to or remove servers from the clusters in your domain. Click Next to continue. |
|
|
Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen, and your domain includes at least one cluster, and at least one Managed Server that is not assigned to a cluster |
For each cluster, specify whether or not you want to create an HTTP proxy application for the cluster. If you select the Create HTTP Proxy check box for a cluster, select the proxy server to use for that cluster. a Click Next to continue. |
|
|
Only if you have selected Managed Servers, Clusters, and Coherence on the Advanced Configuration screen, and Coherence is installed with WebLogic Server |
Accept the default cluster name or type a new name for the Coherence cluster. Enter the port number to use as the Coherence cluster listen port. Click Next to continue. |
|
|
Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen. |
Add, delete, or reconfigure machines as needed. Click Next to continue. |
|
|
Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen, and there is at least on machine configured in the domain |
Assign the Administration Server and Managed Servers to the appropriate machines. Click Next to continue. |
|
|
Only if you have selected Topology on the Advanced Configuration screen. |
Add, configure, and delete virtual targets that you want to use to run WebLogic Server in a multitenant mode. For an overview of multitenancy in Oracle WebLogic Server, see Oracle WebLogic Server Multitenant in Oracle Fusion Middleware Using Oracle WebLogic Server Multitenant. For a definition of virtual targets, see Virtual Targets in Oracle Fusion Middleware Using Oracle WebLogic Server Multitenant. Click Next to continue. |
|
|
Only if you have selected Topology on the Advanced Configuration screen. |
Add the required number of partitions. Later, you will assign virtual targets to each partition that you define. For more information, see the following resources in Oracle Fusion Middleware Using Oracle WebLogic Server Multitenant
Click Next to continue. |
|
|
Only if you have defined virtual targets and partitions for the domain being configured |
Associate a virtual target to a partition. A partition can have zero or more virtual targets. Click Next to continue. |
|
|
Only if you have selected Deployments and Services on the Select Advanced Configuration screen, and a selected product or template contains J2EE applications or libraries |
Select the target server or cluster on which you want to deploy applications or libraries. Select the check box for each application or library you want to deploy on the selected target. Note: While creating a Restricted JRF domain by using the Click Next to continue. |
|
|
Only if you have selected Deployments and Services on the Select Advanced Configuration screen |
Select the target server or cluster. Select the check box for each service you want to target to it. Click Next to continue. |
|
|
Only if you have selected File Store on the Select Advanced Configuration screen |
Change the settings for each JMS file store as needed, and select the synchronous write policy for each file store. Click Next to continue. |
|
|
Always |
Review the configuration for your domain by selecting a Summary View, and then selecting individual items in the list for that view. If the domain is configured as you want it, click Update to extend the domain. If you need to make changes to the configuration, click Previous to return to the appropriate screen for the settings you want to change. |
|
|
Always |
Shows the progress of the domain creation. When the process completes, click Next. |
|
|
Always |
Click Finish to exit the Configuration Wizard. |
When you update a WebLogic domain in which the Managed Servers are distributed (by using the pack and unpack commands) to remote machines, the startup scripts on the remote machines are not updated automatically. You must update them manually.
To ensure that startup scripts on the remote machines are updated:
pack command with the -managed=true option.unpack command to unpack the Managed Server template.For more information about the pack and unpack commands, see Overview of the Pack and Unpack Commands in Oracle Fusion Middleware Creating Templates and Domains Using the Pack and Unpack Commands.