The Migration tool requires following inputs for each appliance (TCA-M or TCA-CP) in the given TCA topology.

Section

Name

Description

Mandatory/Optional

JSON Field Name

2.3 Appliance Details

Name

Unique Name of the appliance. Generated by default from generate-template CLI.

Mandatory

name

TCA-M IP/FQDN

IP or FQDN of TCA appliance. Generated by default from generate-template CLI.

Mandatory

vmEndpoint

TCA-M Web (443) User name

Needed to generate input.json which contains list of appliances (TCA-M and TCA-CPs) and also used to validate whether the deployment ready for migration (Pre checks)

Mandatory

tcaWebUsername

TCA-M Web (443) Password

Needed to generate input.json which contains list of appliances (TCA-M and TCA-CPs) and also used to validate whether the deployment ready for migration (Pre checks). Should be encrypted format using encrypt command.

Mandatory

tcaWebPassword

TCA-M Web thumbprint

Needed thumbprint in SHA-256 format if TCA-M 443 hosts self-signed cert

Mandatory if self signed

tcaWebThumbprint

TCA-M/CP appliance management (9443) Password

Needed for backup, migration, fetching the existing details of the setup etc.

Mandatory

appMgrPassword

TCA-M/CP appliance management (9443) thumbprint

Needed thumbprint in SHA-256 format if TCA-M/CP 9443 hosts self-signed cert.

Mandatory if self signed

appMgrThumbprint

New Appliance Details

New appliance SSH admin password

If not specified, old appliance management admin password is used. Should be encrypted format using encrypt command

Optional

cnPassword

New appliance SSH root password

If not specified, new appliance management admin password is used. Should be encrypted format using encrypt command

Optional

cnRootPassword

Deployment Size

Size of appliance. Small/Medium/Large/X-Large

Mandatory

deploymentOption

Enable Workflow Hub

Enable WorkflowHub in the new appliance or not (True/False)

Mandatory

service_wfh

3.0 OVA URL

Mandatory for deploy. URL of OVA download (*.ova). Supported formats: file, http, https, ftp. Refer to URL File or Web Syntax in OVFTool user guide for URL syntax.

If deploy is not required, remove this field.

Mandatory

ovaUrl

External IP

VM IP will be assigned by TCX installer. This config is used by Kafka Event Mesh

Optional

external_address

Platform manager password (tca user)

Platform manager password. If not specified, New appliance SSH admin password is used.

Optional

tca_user_passwd

Deployment VC details

VC where the TCA appliance is deployed

IP or FQDN of the management VC where the TCA appliance is deployed. All vCenter details are mandatory including old VM name, if tool deploys appliance

Mandatory

cEndpoint

VC user name where the TCA appliance is deployed

Management VC username

Mandatory

vcUsername

VC password where the TCA appliance is deployed

Management VC password in encrypted format using encrypt command

Mandatory

vcPassword

VCenter endpoint thumbprint

Needed thumbprint in SHA-256 format of management VC, if self-signed cert

Mandatory if self signed

vcThumbprint

2.3 Appliance name

The VM name of the 2.3 appliance in the VC. It could be inventory path of this resource in the vCenter.

Mandatory

oldVmName

New Appliance Name

Name of the new VM, default is {oldVmName}-CN

Optional

newVmName

Migration

Revert partial deployed or failed appliance

When set to True, deletes failed appliance 'newVmName', if exists. Default value is False

Optional

forceDeploy
You can migrate one TCA deployment topology (TCA-M and associated TCA-CPs) at a time from the tool.