Skip navigation.
Downloads | Product Documentation | Support

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, as listed in Table D-1. If the wizard does not locate an XML script, it uses the default system values, as defined in Table D-2.

Table D-1 XML Scripts for Silent Upgrade

If you are upgrading ... | The wizard looks for an XML script named ...
--- | ---
Security Provider | `weblogic-upgrade-securityproviders-responses.xml` Sample: `http://e-docs.bea.com/common/docs90/upgrade/scripts/weblogic-upgrade-securityproviders-responses.xml`
Node Manager | `weblogic-upgrade-nodemanager-responses.xml` Sample: `http://e-docs.bea.com/common/docs90/upgrade/scripts/weblogic-upgrade-nodemanager-responses.xml`
Domain | `weblogic-upgrade-domain-responses.xml` Sample: `http://e-docs.bea.com/common/docs90/upgrade/scripts/weblogic-upgrade-domain-responses.xml`

To create an XML script for a silent mode upgrade:

1. In a supported browser, click on one of the sample XML scripts provided in Table D-1, based on the type of upgrade task you wish to perform.
2. Save the sample script, as an XML file of the same name, in the root directory of the domain that you want to upgrade.
3. In the XML script that you saved to your system, edit the values for the keywords shown in Table D-2 to match your requirements. If you do not specify a value for a keyword, the wizard uses the default value.

Note: When editing the file, please 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 `]`.

Table D-2 Silent-mode XML Script Values

If you are upgrading... | For this keyword... | Set the value to the... | This keyword defaults to the...
--- | --- | --- | ---
Security Providers | `INPUT_DIRECTORY` | Path of the directory that contains the security provider JARs to be upgraded. 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\weblogic81\server\lib\mbeantypes`
`OUTPUT_DIRECTORY` | Path of the directory in which you want to save the new security provider JAR files. | `WL_HOME``\server\lib\mbeantypes`, where `WL_HOME` specifies the root directory of the WebLogic Server 9.0 installation.
Node Manager | `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\weblogic81\common\nodemanager`
Domains | `WEBLOGIC_VERSION` | Version of WebLogic Server. | Version of WebLogic Server identified in the configuration file (`config.xml`). 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.
`DOMAIN_DIR` | Path of the directory that contains the WebLogic domain to be upgraded. | Directory from which the Upgrade Wizard is run, such as: `c:\bea\user_projects\domains\mydomain`
Domains (Continued) | `ADMIN_SERVER_NAME` | Name of the Administration Server. | Name of the Administration Server specified in the configuration file (`config.xml`), such as: `myserver` This keyword is required to be set for WebLogic Server 6.1 release only, as the Administration Server name was not persisted to the configuration file.
`NODE_MANAGER_USERNAME` | Username for Node Manager. | `weblogic`
`NODE_MANAGER_PASSWORD` | Password for Node Manager. | `weblogic`
`NODE_MANAGER_PASSWORD` | Confirmation password for Node Manager. | `weblogic`
Domains (Continued) | `OPTIONAL_ACTION_1` | One or more of the following options: `DOMAIN_DIRECTORY_BACKUP _SELECTED_VALUE`—If this option is selected, 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 selected, 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_COMPATIB ILITY_FLAGS_SELECTED_VALUE`—Some behavior supported in pre-9.0 releases of WebLogic Server has been changed in 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 select this option, these flags or backward compatibility are not set. | `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, such as: `c:\bea\user_projects\domains\mydomain`
`BACKUP_FILE_NAME` | Name of the backup zip file. | `weblogic-domain-backup-mydomain.zip`