Table 1-1 Procedure for Upgrading a WebLogic Domain
|
|
|
Select the version of the domain that you are upgrading.
|
Select a Domain to Upgrade
|
Select the directory that contains the WebLogic domain to be upgraded.
|
|
Review progress of the wizard as it inspects the domain.
If you attempt to upgrade a domain in which custom security providers are used, without first upgrading those security providers, an error message is displayed and the wizard exits. If you receive this error message, upgrade the custom security providers, as described in
Upgrading a Security Provider, and then restart the Domain Upgrade Wizard.
The wizard proceeds automatically to the next window.
|
Select Administration Server
|
This window is displayed only if the domain contains multiple servers.
Select the server that you want to use as the administration server in the new domain.
|
Enter Node Manager Credentials
|
Enter the user name and password (and confirm the password) for Node Manager authorization.
For WebLogic Server 10.0, the Node Manager requires user name and password credentials to be specified for each domain. By default, the user name and password are set to weblogic . If you do not use the Node Manager, leave the default values unchanged.
|
|
Back up current domain (recommended): If selected, the wizard backs up the original domain directory and stores it in a zip file. By default, this option is selected.
Note: |
The wizard backs up the domain directory only; it does not preserve file permissions. BEA recommends that you back up the domain and any external application and application database resources in a separate process, as described in Step 3: Back Up the Application Environment in
Roadmap for Upgrading Your Application Environment. |
Add log files to backup zip: If selected, log files are included in the backup zip file. By default, log files are included in the backup file.
Note: |
The number and size of log files might be large; so use this option judiciously. |
Do not set backwards compatibility flags: As of WebLogic Server 9.0, certain previously supported behavior has changed to comply with J2EE 1.4. By default, the wizard sets flags to enable the previous behavior in the new domain. If you select this option, these flags are not set for backward compatibility. For more information about the backward compatibility flags, see the Backward Compatibility Flags section in
WebLogic Server 10.0 Compatibility with Previous Releases.
|
Directory Selection Analysis and Optional Tasks
|
Review progress as the wizard processes the domain information and options provided. Progress messages are displayed in the window.
The wizard proceeds automatically to the next window.
|
|
Review progress of the wizard as it prepares to back up the domain. Progress messages are displayed in the window.
The wizard proceeds automatically to the next window.
|
Select Directory for Domain Backup
|
This window is displayed only if you selected the Back up current domain option in the Select Upgrade Options window. If you did not select that option, proceed to Restructure Domain Directory.
- Backup directory: Select the directory in which you want to save the backup zip file. By default, the original domain directory is used.
- Backup file name: Enter the name of the backup file. The default file name is
weblogic-domain-backup- domain .zip , where domain specifies the name of the domain.
|
|
Review progress as the wizard backs up the domain. A progress bar displays the percentage of the backup process that is complete, and progress messages are displayed in the window.
Note: |
Backup files created by the wizard need to be protected by the user as they might contain confidential information. |
The wizard proceeds automatically to the next window.
|
Restructure Domain Directory
|
Review progress as the wizard restructures the domain directory.
The wizard proceeds automatically to the next window.
|
Upgrade Configuration Settings
|
Review progress as the wizard upgrades the configuration settings.
The wizard proceeds automatically to the next window.
|
Upgrade Persisted Messages and Transaction Log Formats
|
Review progress as the wizard upgrades the persisted messages (JMS file and JDBC stores) and transaction (JTA) logs that exist in the domain.
The wizard proceeds automatically to the next window.
|
Upgrade RDBMS Authenticator Security Provider
|
This window is displayed only when an RDBMSAuthenticator Security Provider exists in the domain that you are upgrading.
Specify whether the deprecated RDBMSAuthenticator must be replaced by the SQLAuthenticator.
Click Next to proceed.
|
Execute P13n Components Domain Upgrade
|
This window is displayed only if the domain contains WLI or WLP resources.
Review progress as the wizard updates the personalization components.
|
Execute Upgrade of Personalization Databases
|
This window is displayed only if the domain contains WLI or WLP resources.
Review progress as the wizard prepares to upgrade the database schema objects used by personalization. You have the option to upgrade the database in a subsequent step.
|
Execute WLP Domain Upgrade Plugins
|
This window is displayed only if the domain contains WLP resources.
The wizard upgrades the WLP-specific resources in the domain.
|
Prepare WLI Domain Upgrade Plugins
|
This window is displayed only if the domain contains WLI resources.
The wizard upgrades WLI-specific resources in the domain.
|
Execute WLI Domain Upgrade Plugins
|
This window is displayed only if the domain contains WLI resources.
The wizard upgrades WLI resources in the domain.
|
|
Review progress of the wizard as it saves the upgraded configuration and deletes any temporary files that were created during the upgrade process. Progress messages are displayed in the window.
Note: |
While upgrading remote managed servers, the wizard does not persist the configuration information. |
|
|
This window is displayed only if the domain contains WLP or WLI resources.
Specify whether you want to upgrade the domain database. BEA recommends that you use the Domain Upgrade Wizard to upgrade the domain database.
Note: |
The wizard does not back up the domain database. You must back up your domain database before starting the domain upgrade. |
|
Initialize Category/Datasource Table
|
This window is displayed only if the domain contains WLI or WLP resources, and if you have opted to upgrade the domain database.
Review progress of the wizard as it prepares to upgrade the domain database schema objects.
The wizard proceeds automatically to the next window.
|
Associate DB Categories with Datasources
|
This window is displayed only if the domain contains WLI or WLP resources, and if you have opted to upgrade the domain database.
The table displays the database “categories” and their associated data sources. The categories are used with their associated data source to initialize the domain database. If the data source for a database category is undefined, you can update the category with the correct data source. If the data source remains undefined, it is skipped during the upgrade process. In most cases, the default association is correct and no further changes are required.
Note: |
Ensure that a data source is associated with each database category that you want to upgrade. Database categories for which the data source is not defined are not upgraded. |
|
|
This window is displayed only if the domain contains WLI or WLP resources, and if you have opted to upgrade the domain database.
Review progress of the wizard as it prepares to upgrade the database schema objects.
The wizard proceeds automatically to the next window.
|
|
Review the results of the upgrade, including any important messages that require further analysis.
Click Done to close the Domain Upgrade Wizard.
|