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:
- The XML definition (<?xml version="1.0" encoding="UTF-8"?>) must be at the very beginning of the XML script. No spaces or line breaks are allowed before the XML definition.
- You must follow XML guidelines for characters when modifying values. That is, you cannot use characters reserved for use in XML, such as <, >, [, and ].
- Save the sample script as an XML file in the root directory of the domain that you want to upgrade. You must use the same name for the script as identified in this appendix.
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.
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.
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
If this option is specified, the wizard backs up the original domain directory and stores it in a zip file.
- DOMAIN_DIRECTORY_BACKUP_LOG_FILES_INCLUDED_SELECTED_VALUE
If this option is specified, log files are included in the backup zip file. The number and size of log files can be large, so you may want to exclude them from the backup file by disabling this option. By default, log files are included in the backup file.
- SKIP_BACKWARDS_COMPATIBILITY_FLAGS_SELECTED_VALUE
Some behavior supported in pre-9.0 releases of WebLogic Server has been changed as of 9.0 to comply with J2EE 1.4. By default, the wizard sets flags to enable the previous behavior in the new domain. If you specify this option, these flags for backward compatibility are not set.
DOMAIN_DIRECTORY_
BACKUP_SELECTED_VALUE, DOMAIN_DIRECTORY_
BACKUP_LOG_FILES_INCLUDED_SELECTED_VALUEBACKUP_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