Migration Utilities
Many products offer migration utilities that automatically migrate data from your old installation to your new installation. This section describes the general behavior of the migration utilities; any exceptions to the general behavior are noted in the product-specific chapters.
Some migration utilities for some products run without prompting you for any information. Migration utilities for other products ask you to select the data to migrate, and offer these options:
You can run a custom migration, in which you select the data to migrate. The utility gathers your settings through a series of prompts, then migrates the selected data. You can export your settings and use them in other upgrades.
You can run a migration with imported settings. The imported settings can come from settings you exported from a custom migration, or from the default migration provided with the product installation. The settings for default migrations are described in the product-specific chapters.
Note: | When you run migration utilities, you provide the full path to the old installation, and sometimes the path to the 9.9 installation. If you supplied a symbolic link as the installation directory when you installed the old or 9.9 product, the path you provide to the migration utility must be the same symbolic link path you supplied during installation. |
If a migration utility fails to migrate a piece of data, the utility asks whether to continue with the next piece of data or abort the migration. If you choose to abort, the utility exits. The utility does not revert the 9.9 product installation. You can address the issue and rerun the utility.
Migration utilities write detailed migration information to the command window and to the migrationLog.txt file in the 9.9_Software AG_directory\install\logs directory. By default, utilities write INFO, ERROR, and FATAL messages to the log. If you want to increase the logging level for a product’s migration to DEBUG, go to the product directory that contains the log4j.properties file (for example, the 9.9_Software AG_directory\product\bin\migrate or \migrate\bin directory), open the file in a text editor, set the log4j.logger.Migration property to DEBUG, MigrationFile, and save and close the file.
