> Upgrading WebLogic Application Environments > Silent Upgrade XML Script Reference

Upgrading WebLogic Application Environments

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

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

Note: Only WebLogic Server domains can be upgraded using silent mode.

Table E-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://download.oracle.com/docs/cd/E13179_01/common/docs100/upgrade/scripts/weblogic-upgrade-securityproviders-responses.xml
Node Manager
weblogic-upgrade-nodemanager-responses.xml
Sample: http://download.oracle.com/docs/cd/E13179_01/common/docs100/upgrade/scripts/weblogic-upgrade-nodemanager-responses.xml
Domain
weblogic-upgrade-domain-responses.xml
Sample: http://download.oracle.com/docs/cd/E13179_01/common/docs100/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 E-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 E-2 to match your requirements. If you do not specify a value for a keyword, the wizard uses the default value.
    4. 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 E-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-10.0 installation.
      Path of directory from which the Upgrade Wizard is run, such as:
      c:\bea\wlserver_10.0\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 10.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-10.0 installation.
      Directory from which the Upgrade Wizard is run. For example: c:\bea\wlserver_10.0\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-10.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)
      		     
      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_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 select this option, these flags or backward compatibility are not set.

      DOMAIN_DIRECTORY_
      BACKUP_SELECTED_VALUE, DOMAIN_DIRECTORY_
      BACKUP_LOG_FILES_INCLUDED_SELECTED_VALUE
      Domains (Continued)
      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


  Back to Top       Previous  Next