Installer 10.15 | Complete Installation and Upgrade Information for Software AG Products | Command Central | Using Composite Templates | Migrating a Product Instance
 
Migrating a Product Instance
 
Changing an Instance Name During Migration
When migrating a product instance, you can define the instance properties you want to migrate in a template. The instance properties to include in the template depend on the product that you migrate and how you migrate it, for example as a single product instance or in a cluster. For details about the migration settings required by the migration utility of each product, see Upgrading Software AG Products On Premises.
environments:
default:
# Required. Name of the new instance on the target node
# (and name of the source instance, when "src.instance.name:" is not included in the template).
instance.name: newInstance
# Name of the instance to migrate.
src.instance.name: oldInstance

# Only for MWS or UM instances in a cluster. The name of the new cluster node that hosts the instance.
node.alias: newNodeName

# A new host name if required, for example if you want to rename the old host.
node.host: newHostName

# Only for MWS or UM instances in a cluster. The name of the old cluster node.
src.node.alias: oldNodeName

# The name of the old host if required, for example if you want to rename the old host.
src.node.host: oldHostName

# The version of the source and target nodes if required.
src.version: sourceNodeVersion
dest.version: targetNodeVersion

# Required. The JDBC URL and user creadentials of the cloned database.
db.url: {}
db.username: {}
db.password: {}
...

templates:
templateAlias
products:
productID:
${instance.name}:
src.instance.name: ${src.instance.name}
node.alias: ${node.alias}
node.host: ${node.host}
src.node.alias: ${src.node.alias}
src.node.host: ${src.node.host}
src.version: ${src.version}
dest.version: ${dest.version}
db.url: "${db.url}"
db.username: ${db.username}
db.password: ${db.password}
The following table shows how Command Central maps the instance properties from the template to the migration settings of the product utilities when migrating an instance:
Instance property in template
Maps to this migration utility setting
instanceName
-newInstanceName or if src.instance.name is not included, maps to -instanceName
src.instance.name
-instanceName
node.alias
-newNodeName
node.host
-newHostName
src.node.alias
-oldNodeName
src.node.host
-oldHostName
src.version
-srcVersion
dest.version
-destVersion
db.url
-cloneDbUrl
db.username
-cloneDbUser
db.password
-cloneDbPassword
If the template includes custom migrate-xxx-yyy-sbs.dat migration settings files, the files are passed to the migration utility as the -importFile parameter.