E 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:

Security Provider Upgrade Script
Node Manager Upgrade Script
Domain Upgrade Script

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.

Note:

Only WebLogic 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 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 Example E-1. The values that may be modified are shown in bold.

Example 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...

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-9.0 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.

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-9.0 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 Example E-2. The values that may be modified are shown in bold.

Example 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...

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-9.0 installation.	Directory from which the Upgrade Wizard is run. For example, `c:\bea\wlserver_10.3\common\nodemanager`.

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-9.0 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 Example E-3. The values that may be modified are shown in bold.

Note:

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.

Example 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...	The keyword defaults to...
WEBLOGIC_VERSION	The version of WebLogic Server contained in the domain being upgraded^Foot 1.	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-9.0 domain.
ADMIN_SERVER_NAME	Name of the domain's Administration Server instance. Note: 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 generates an exception and terminates.	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 options: `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. Note that `OPTIONAL_ACTION_1` may be specified so that one of multiple options is used. For example: DOMAIN_DIRECTORY_BACKUP_SELECTED_VALUE OR DOMAIN_DIRECTORY_BACKUP_LOG_FILES_INCLUDED_SELECTED_VALUE OR SKIP_BACKWARDS_COMPATIBILITY_FLAGS_SELECTED_VALUE	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`

^Footnote 1You can specify multiple versions of WebLogic Server, as in the following example: 6.1 OR 7.0 OR 8.1 OR "9.0 or higher"