Upgrading WebLogic Application Environments

      

Silent Upgrade XML Script Reference

Before using the WebLogic Upgrade Wizard in silent mode, you have the option of creating an XML script that defines your upgrade requirements, and passing that script to the wizard on the command line.

When run in silent mode, the Upgrade Wizard searches the domain's root directory for an XML script with a name that indicates the type of upgrade task to be performed. If the wizard does not locate an XML script, it uses default system values.

This appendix provides the following sample XML upgrade scripts:

Depending on the particular configuration of the environment you are upgrading, you can modify specific values in these scripts, as explained in this appendix, and have the WebLogic Upgrade Wizard use them instead. This appendix identifies those values and their defaults, and explains how they can be modified.

Only WebLogic Server domains can be upgraded using silent mode.

 


About Modifying the Sample XML Scripts

To create an XML script for a silent mode upgrade, modify one of the sample scripts provided in this appendix. Note the following:

 


Security Provider Upgrade Script

To upgrade the security providers in a domain, the WebLogic Upgrade Wizard looks for an XML script named weblogic-upgrade-securityproviders-responses.xml, which is displayed in Listing E-1. The values that may be modified are shown in bold. Listing E-1 Sample Silent-Mode XML Script for Upgrading security providers

<?xml version="1.0" encoding="UTF-8"?>


<plugin-silent-responses>
</plugin-silent-responses>

<!--
<plugin-silent-responses>
<group name="SecurityProviderUpgradeGroup">
<plugin name="SecurityProviderUpgradeStepOne">
<input-adapter name="IA">
<bind-property name="selectedFileNames">
<value>__INPUT_DIRECTORY__</value>
</bind-property>
</input-adapter>
</plugin>
<plugin name="SecurityProviderUpgradeStepTwo">
<input-adapter name="IA">
<bind-property name="selectedFileNames">
<value>__OUTPUT_DIRECTORY__</value>
</bind-property>
</input-adapter>
</plugin>
</group>
</plugin-silent-responses>

Table E-1 identifies the keywords contained in this script, the values you can specify for those keywords, and the default values that are used by the WebLogic Upgrade Wizard if you do not modify them.

Table E-1 Silent-Mode XML Script Values for Upgrading security providers
For this keyword... Set the value to the... This keyword defaults to the...
INPUT_DIRECTORY Path of the directory that contains the security provider JARs to be upgraded. For example: d:/bea/weblogic81/server/lib/mbeantypes By default, security providers are located in WL_HOME\server\lib\mbeantypes, where WL_HOME specifies the root directory of the pre-10.x installation. Path of directory from which the Upgrade Wizard is run, such as: c:\bea\wlserver_10.3\server\lib\mbeantypes
OUTPUT_DIRECTORY Path of the directory in which you want to save the new security provider JAR files. For example: d:/bea/wlserver_10.3/server/lib/mbeantypes WL_HOME\server\lib\mbeantypes, where WL_HOME specifies the root directory of the WebLogic Server 10.x installation.

 


Node Manager Upgrade Script

To upgrade the Node Manager from an existing domain, the WebLogic Upgrade Wizard looks for an XML script named weblogic-upgrade-nodemanager-responses.xml, which is displayed in Listing E-2. The values that may be modified are shown in bold. Listing E-2 Sample Silent-Mode XML Script for Upgrading a Node Manager

<?xml version="1.0" encoding="UTF-8"?>


<plugin-silent-responses>
</plugin-silent-responses>

<!--
<plugin-silent-responses>
<group name="NodeManagerPlugInGroup">
<plugin name="NodeManagerPlugIn">
<input-adapter name="IA">
<bind-property name="selectedFileNames">
<value>__NODE_MANAGER_HOME__</value>
</bind-property>
</input-adapter>
</plugin>
</group>
</plugin-silent-responses>

Table E-2 identifies the keyword contained in this script, the value you can specify for that keyword, and the default value used by the WebLogic Upgrade Wizard if you do not modify it.

Table E-2 Silent-Mode XML Script Value for Upgrading the Node Manager
For this keyword... Set the value to the... This keyword defaults to the...
NODE_MANAGER_HOME Path of the directory of Node Manager to be upgraded by navigating the local directory hierarchy. By default, the Node Manager home directory is located in WL_HOME\common\nodemanager, where WL_HOME specifies the root directory of the pre-10.x installation. Directory from which the Upgrade Wizard is run. For example: c:\bea\wlserver_10.3\common\nodemanager

 


Domain Upgrade Script

To upgrade an existing domain, the WebLogic Upgrade Wizard looks for an XML script named weblogic-upgrade-domain-responses.xml, which is displayed in Listing E-3. The values that may be modified are shown in bold.

Specifying the name of the domain Administration Server, as described in Table E-3 for the keyword ADMIN_SERVER_NAME, is required because there is no default value. Listing E-3 Sample Silent-Mode XML Script for Upgrading a Domain

<?xml version="1.0" encoding="UTF-8"?>


<plugin-silent-responses>
</plugin-silent-responses>

<!-- SAMPLE BELOW -->
<!--
<plugin-silent-responses>
<group name="DomainSelectionGroup">
<plugin name="SelectWebLogicVersionPlugIn">
<input-adapter name="ChoiceIA">
<bind-property name="selectedChoiceIds">
<value>__WEBLOGIC_VERSION__</value>
</bind-property>
</input-adapter>
</plugin>
<plugin name="DomainDirectorySelectionPlugIn">
<input-adapter name="IA">
<bind-property name="selectedFile">
<value>__DOMAIN_DIR__</value>
</bind-property>
</input-adapter>
</plugin>
</group>
<group name="PostDirSelectionGroup">
<plugin name="AdminServerSelectionPlugIn">
<input-adapter name="IA">
<bind-property name="selectedChoiceIds">
<value>__ADMIN_SERVER_NAME__</value>
</bind-property>
</input-adapter>
</plugin>
<plugin name="NodeManagerCredentialsPlugIn">
<input-adapter name="UsernameIA">
<bind-property name="value">
<value>__NODE_MANAGER_USERNAME__</value>
</bind-property>
</input-adapter>
<input-adapter name="PasswordIA">
<bind-property name="value">
<value>__NODE_MANAGER_PASSWORD__</value>
</bind-property>
</input-adapter>
<input-adapter name="PasswordConfirmIA">
<bind-property name="value">
<value>__NODE_MANAGER_PASSWORD__</value>
</bind-property>
</input-adapter>
</plugin>
<plugin name="OptionalGroupsSelectionPlugIn">
<input-adapter name="IA">
<bind-property name="selectedChoiceIds">
<value>__OPTIONAL_ACTION_1__</value>
<value> . . . </value>
</bind-property>
</input-adapter>
</plugin>
</group>
<group name="PostDirSelectionPost81Group">
<plugin name="AdminServerSelectionPlugIn">
<input-adapter name="IA">
<bind-property name="selectedChoiceIds">
<value>__ADMIN_SERVER_NAME__</value>
</bind-property>
</input-adapter>
</plugin>
<plugin name="OptionalGroupsSelectionPlugIn">
<input-adapter name="IA">
<bind-property name="selectedChoiceIds">
<value>__OPTIONAL_ACTION_1__</value>
<value> . . . </value>
</bind-property>
</input-adapter>
</plugin>
</group>
<group name="DomainBackupGroup">
<plugin name="DomainDirectoryBackupPlugIn">
<input-adapter name="FileSelectionIA">
<bind-property name="selectedFileNames">
<value>__BACKUP_DIR__</value>
</bind-property>
</input-adapter>
<input-adapter name="TextIA">
<bind-property name="value">
<value>___BACKUP_FILE_NAME__</value>
</bind-property>
</input-adapter>
</plugin>
</group>
</plugin-silent-responses>

-->

Table E-3 identifies the keywords contained in this script, the values you can specify for the keywords, and the default values used by the WebLogic Upgrade Wizard if you do not modify them.

Table E-3 Silent-Mode XML Script Value for Upgrading a Domain
For this keyword... Set the value to ... This keyword defaults to ...
WEBLOGIC_VERSION The version of WebLogic Server contained in the domain being upgraded1. The version of WebLogic Server identified in the configuration file (config.xml) of the domain being upgraded. For example, 8.1.4.0. If the software version number is not specified in the domain configuration file, the wizard displays the version number as 8.1.0.0, by default. In this case, there is no impact if the default value does not match the actual version number of the pre-10.x domain.
ADMIN_SERVER_NAME Name of the domain's Administration Server instance.

Assigning a value for this keyword is required because there is no default. If you do not provide the Administration Server name, this silent upgrade script will generate an exception and terminate.

No default value is assigned. DOMAIN_DIR The path of the directory that contains the WebLogic domain to be upgraded. The directory from which the Upgrade Wizard is run. For example: c:\bea\user_projects\domains\mydomain NODE_MANAGER_USERNAME The username for Node Manager. weblogic NODE_MANAGER_PASSWORD The password for Node Manager. weblogic NODE_MANAGER_PASSWORD The confirmation password for Node Manager. weblogic OPTIONAL_ACTION_1 One or more of the following options2:

DOMAIN_DIRECTORY_
BACKUP_SELECTED_VALUE, DOMAIN_DIRECTORY_
BACKUP_LOG_FILES_INCLUDED_SELECTED_VALUE BACKUP_DIR Path of the directory in which you want to save the backup zip file. Directory from which the Upgrade Wizard is run. For example: c:\bea\user_projects\domains\mydomain BACKUP_FILE_NAME Name of the backup zip file. weblogic-domain-backup-mydomain.zip

1You can specify multiple versions of WebLogic Server, as in the following example:

1 6.1 OR 7.0 OR 8.1 OR "9.0 or higher"

2OPTIONAL_ACTION_1 may be specified so that one of multiple options is used. For example:

2 DOMAIN_DIRECTORY_BACKUP_SELECTED_VALUE OR

2 DOMAIN_DIRECTORY_BACKUP_LOG_FILES_INCLUDED_SELECTED_VALUE OR

2 SKIP_BACKWARDS_COMPATIBILITY_FLAGS_SELECTED_VALUE