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:

Layer - The name of the layer, which uses the property.

Name - Describes the function of the property.

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.

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:

Overinstall: same installation directory, hosts, and ports

Side-by-side: new installation directory, same hosts and ports

Cross-host: new hosts, same ports. The installation directory can have the same or a new value.

Syntax

Command Central syntax:

sagcc list stacks stackName migrate properties migration.type={overinstall|sidebyside|crosshost}
[-f application/properties] [options]

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

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.

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.

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