sagcc list stacks migrate properties
Lists the required and optional migration properties for a stack. Required are properties, for which you must specify values when migrating product installations. For example, product and fix repositories are required properties. Optional are properties, for which you can keep the current value or specify a new value. Information about the properties can include:
![*](chapterTOC_bullet.png)
Layer - The name of the layer, which uses the property.
![*](chapterTOC_bullet.png)
Name - Describes the function of the property.
![*](chapterTOC_bullet.png)
Key - The parameter name of the property. For properties that have the same parameter name in different layers of the stack, the key starts with the name of the layer. For example
"infrastructure.fixes" is the key for the fixes parameter in the infrastructure layer;
"database.fixes" is the key for the fixes parameter in the database layer.
![*](chapterTOC_bullet.png)
Value - The value of the property. The values of the required properties are empty,
${}. The optional properties have a specific value.
The migration properties that the command returns will depend on the type of migration you want to run. You can list migration properties for the following 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.
Syntax
Command Central syntax:
sagcc list stacks stackName migrate properties migration.type={overinstall|sidebyside|crosshost}
[-f application/properties] [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. Specifies the type of migration to execute when upgrading product installations. Valid values: overinstall sidebyside crosshost |
[-f application/properties] | Optional. Returns a list of the required and optional properties in the <parameter>=<value> format. The required properties have an empty value, for example cc.installer=${}. The optional properties are listed with their current value, for example nodes.ssh.port=22. |
[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)
When you run the command without the
-f application/properties option, the command output is in tabular format. When you include the
-f application/properties option, the output is in the
<parameter>=<value> format, which is easier to transfer to a properties file, or as an argument on the command line.
![*](chapterTOC_bullet.png)
You can add the properties from the command output in a properties file, which you can use with the
sagcc exec stacks migrate command or to import the properties into a stack, using the
Stacks >
Ugrade Stack web user interface.
![*](chapterTOC_bullet.png)
The command returns the
fixes property for all layers in the stack with the value
ALL. When
fixes=ALL,
Command Central installs all the latest fixes for the respective layer, which are available in the specified fix repository for the products in the target installations. For more information about using the
fixes property when migrating the stack, see the "Usage Notes" in
sagcc exec stacks migrate.
Examples
To list the migration properties for the stack with name "stack01", when running an overinstall upgrade:
sagcc list stacks stack01 migrate properties migration.type=overinstall
Layer Name Key Value
Infrastructure Command Central Bootstrap Installer cc.installer ${}
Infrastructure Product Repository repo.product ${}
Infrastructure Fix Repository repo.fix ${}
Infrastructure Platform Manager Credentials Key nodes.spm.credentials.key ${}
Infrastructure Remote Machine SSH Port nodes.ssh.port 22
Infrastructure Infrastructure Fixes infrastructure.fixes ALL
...
To list the migration properties for the stack with name "stack01" as key-value pairs, when running a side-by-side upgrade:
sagcc list stacks stack01 migrate properties migration.type=sidebyside
-f application/properties
nodes.spm.credentials.key=${}
repo.fix=${}
nodes.ssh.substitute.credentials.key=${nodes.ssh.login.credentials.key}
cc.installer=${}
nodes.ssh.port=22
infrastructure.fixes=ALL
nodes.ssh.login.credentials.key=${}
repo.product=${}
To add the migration properties for the stack with name "stack01" as key-value pairs in a properties file with name "stack01-migration.properties", when running a cross-host upgrade:
sagcc list stacks stack01 migrate properties migration.type=crosshost
-f application/properties -o stack01-migration.properties
Related Topics