Before You Run Migration Utilities
Most products offer migration utilities that automatically migrate configurations and 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.
You can run migration utilities as follows:
For some products, migration utilities run without prompting you for any information (that is, silently). If the utility fails to migrate an item, the utility exits. The utility does not revert the new product installation. You can address the issue and rerun the utility.
For other products, you can run migration utilities as follows:
You can run a custom migration, in which you select the configurations and data to migrate. The utility gathers your settings through a series of prompts, then migrates the selected configurations and data. You can export your settings to a file named migrate.dat and use them in other upgrades.
You can run a migration with imported settings and some prompting or without any prompting (that is, silently). The imported settings can come from settings you exported from a custom migration, or from the default migration provided by
Software AG with the product installation in a file named migrate
old_releasesbs.dat. The settings for default migrations are described in the product-specific chapters.
If you are running the utility with prompting, and the utility fails to migrate an item, the utility asks whether to continue with the next item or abort the migration. If you choose to abort, the utility exits. The utility does not revert the new product installation. You can address the issue and rerun the utility.
Note:
When you run migration utilities, you provide the full path to the old installation, and sometimes the path to the new installation. If you supplied a symbolic link as the installation directory when you installed the old or new product, the path you provide to the migration utility must be the same symbolic link path you supplied during installation.
Migration utilities write detailed migration information to the command window and to the migrationLog.txt file in the new_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 log4j2 file (for example, the new_Software AG_directory/product/bin/migrate, or /migrate/bin, or bin/migrate/resources directory), open the file in a text editor, set the logger.1.level property to DEBUG and save and close the file.