sagcc exec stacks migrate
Upgrades product installations with version 10.3 and higher using a stack. You can use an upgrade stack for one of the following supported migration types:
![*](chapterTOC_bullet.png)
Overinstall: same installation directory, hosts, and ports
![*](chapterTOC_bullet.png)
Side-by-side:
![*](chapterTOC_bullet.png)
New installation directory, same hosts and ports
![*](chapterTOC_bullet.png)
New installation directory and ports, same hosts
![*](chapterTOC_bullet.png)
Cross-host: new hosts. The installation directory and ports can have the same or new values.
Note that the migration template that the upgrade stack uses determines which migration type you can run. For details about generating migration templates, see
sagcc exec templates composite generate migration.
Syntax
Command Central syntax:
sagcc exec stacks stackName migrate migration.type={overinstall|sidebyside|crosshost}
[-i input-parameters-file.properties] [param1=value1 param2=value2 ...]
[migration.reuse.templates={true|false}] [migration.dry.run={true|false}] [options]
![*](chapterTOC_bullet.png)
Not applicable to
Platform Manager.
Arguments and Options
Argument or Option | Description |
stackName | Required. The name of the stack to use to migrate the product installations. |
migration.type={overinstall|sidebyside|crosshost} | Required. The type of migration to run when upgrading the product installations. Valid values: overinstall sidebyside crosshost |
[-i input-parameters-file.properties] | Optional. The properties file that contains the required and optional properties, for which you should specify values during migration. |
[param1=value1 param2=value2 ...] | Optional. Include the required and optional properties, for which you should specify values during migration, as arguments in the command. |
[migration.reuse.templates={true|false}] | Optional. After a failed migration attempt, you can include this argument in the command when you next attempt to migrate with the same stack. Indicates whether to use the generated templates from the last failed migration run in the next run. Valid values: true - reuses the generated templates false (default) - does not reuse the generated templates |
[migration.dry.run={true|false}] | Optional. Indicates whether Command Central should try a dry run of the upgrade. In the dry run, Command Central generates templates, validates the templates and the migration properties, but does not apply the templates on the target nodes. You can review the results of the dry-run job and check the templates before the actual migration run. Valid values: true - generate and validate the templates, but do not apply them false - (default) - generate, validate, and apply the templates When you do not include the argument, Command Central does not try a dry run. For information about how Command Central validates a template, see
Validating a Composite Template. |
[options] | Optional. The command allows all options supported by the Command Line Interface. For a description of the options, see
Common Options. |
Usage Notes
![*](chapterTOC_bullet.png)
To obtain the required and optional properties for migration, run the
sagcc list stacks migrate properties command. You can also use the
Stacks >
Upgrade Stack web user interface to export the properties for an existing stack into a properties file to use as input file for the stacks migrate command.
![*](chapterTOC_bullet.png)
You must specify the migration properties either as arguments in the command, or in an input file. You can also include both
[param1=value1 param2=value2 ...] and
[-i <input-parameters-file>.properties] in the same command. The values specified in the arguments will override the values of the parameters specified in the properties file.
![*](chapterTOC_bullet.png)
If a migration attempt fails, run the
sagcc list stacks migrate status command to check the migration status of the stack. The command output also indicates whether any templates were generated during the failed attempt.
![*](chapterTOC_bullet.png)
When running the stacks migrate command, the command processes the
fixes property as follows:
fixes=ALL By default, installs all the latest fixes for the respective layer, which are available in the specified fix repository for the products in the target installations.
fixes= If you leave the value empty, the command does not install fixes on the target installation.
fixes=[fixName1[_version], fixId2, ...,fixIdN] If you include this argument, the command installs only the fixes listed in the argument. To retrieve a list of fix names or fix IDs, run
sagcc list repository fixes content.
Software AG recommends that you install at least fix version 1 for each product, because the _Fix1 fixes typically address important technical changes.
Example
To run an overinstall upgrade for a product installation using the product stack named "stack01" and the properties specified in the "stack01-migrate.properties" file:
sagcc exec stacks stack01 migrate migration.type=overinstall
-i stack01-migrate.properties
Related Topics