InfoCenter Home > 3.2.2.2.1: Saving the current configuration by using migration toolsA set of migration tools is provided with the product to help migrate system configurations for installations at Version 3.x and later. The product installation program calls these tools as part of automated migration support. You can call them yourself from the command line. The tool that saves the system configuration is called WASPreUpgrade. This tool saves all files from the following directories in the existing Version 3.x configuration to a specified backup directory:
WASPreUpgrade also saves selected files from the Version 3.x bin directory. Later, the backup directory can be used with the WASPostUpgrade tool to restore the previously saved environment into a Version 4.0 installation. WASPreUpgrade also exports the existing application server configuration from the repository. If you are migrating from an Advanced Edition installation, this step requires that the administration server of the existing environment be running. This command is not typically run from the command line unless both Version 3.x and Version 4.0 are installed on the same machine at the same time. WASPreUpgrade parameterscom.ibm.websphere.migration.preupgrade.WASPreUpgrade backupDirectoryName currentWebSphereDirectory administrationNodeName [-nameServiceHost host_name [-nameServicePort port_number]] [-traceString trace_spec [-traceFile file_name]] The first three parameters are required and positional. The others are optional. A summary follows:
LoggingThe WASPreUpgrade tool displays status to the screen while it is running. It also saves a more extensive set of logging information in the backup directory. This file, WASPreUpgrade.log, can be viewed with a text editor. Special instructions for Linux and Solaris installationsWhen migrating from Version 3.0x on Linux and Solaris installations, mapping problems will occur in the security settings. The resulting configuration contains substitution variables such as $server_password$ and $server_root$. These values must be modified to their correct values after migration has been completed. It is also advisable to migrate these installations with Security disabled. Restoring the previous Version 3.x configurationWith one minor modification, you can use the websphere_3x_backup.xml file (found in the backup directory) with a Version 3.x XMLConfig tool to restore the previous configuration. The version of XMLConfig used by WASPreUpgrade encrypts passwords during export. Before you import the configuration back into the Version 3.x installation, these passwords must be reset to their correct, unencrypted values. Important: This file cannot be used directly in the Version 4.0 environment, because the XMLConfig tool is available only in Version 4.0 Advanced Edition. In addition, the DTDs for the two versions of XML configuration are not compatible; the XML data files exported by the Version 3.x XMLConfig tool cannot be processed by the Version 4.0 tool. |
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|