This chapter describes how to use the Configuration Wizard to update a WebLogic domain. It also describes how to update startup scripts on remote servers.
You can add product component functionality or additional applications and services to an existing WebLogic domain by updating it using the Configuration Wizard. For example, if you created a base WebLogic domain and you want to add the Avitek Medical Records Examples functionality, you can update the domain by using the medrec.jar
template. 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 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 the Domain Template Reference.
This chapter contains the following sections:
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
This decreases the amount of time it takes for the Configuration Wizard to create or update a domain.
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.
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 Understanding the WebLogic Scripting Tool.
If your installation includes Fusion Middleware products, refer to Chapter 4, "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 Chapter 5, "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. |
|
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 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 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 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 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 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 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 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 a system component, such as OHS, is installed. |
Click Add to add system components to the domain. Configure each system component. Click Next to continue. |
|
Only if OHS is installed. Note: A similar screen is displayed for other installed system components. |
Select a system component to configure. Specify the settings for that component. Click Next to continue. |
|
Only if a system component, such as OHS, is installed. |
Assign the system component servers to the appropriate machines. Click Next to continue. |
|
Only if you 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. Click Next to continue. |
|
Only if you 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 selected JMS 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.
To ensure that startup scripts on the remote machines are updated, perform the following steps after updating the domain:
Delete the Managed Server directories on the remote machines.
Create a Managed Server template from the updated domain by using the pack
command with the -managed=true
option.
Create Managed Servers on the remote machines by using the unpack
command to unpack the Managed Server template.
For more information about the pack
and unpack
commands, see Creating Templates and Domains Using the Pack and Unpack Commands.