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

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). Tool will encrypt password and store.

Mandatory

tcaWebPassword

TCA-M Web thumbprint

Needed if TCA-M 443 hosts self-signed cert. Tool will provide thumbprint, just confirm to trust or not.

Optional

tcaWebThumbprint

TCA-M/CP appliance management (9443) Password

Needed for backup, migration, fetching the existing details of the setup etc. Tool will encrypt password and store.

Mandatory

appMgrPassword

TCA-M/CP appliance management (9443) thumbprint

Needed if TCA-M/CP 9443 hosts self-signed cert. Tool will provide thumbprint, just confirm to trust or not.

Optional

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. If provided, Tool will encrypt password and store.

Optional

cnPassword

New appliance SSH root password

If not specified, new appliance management admin password is used. Should be encrypted format using encrypt command. If provided, Tool will encrypt password and store.

Optional

cnRootPassword

Deployment Size

Size of appliance. Small/Medium/Large/X-Large. Default Large for TCA-M and Medium for TCA-CP

Optional

deploymentOption

Enable Workflow Hub

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

Optional

service_wfh

3.1 OVA URL

Mandatory for deploy. New TCA OVA URL (*.ova) or VM Template Name Prefix. Supported OVA URL formats: file, http, https, ftp. Refer to OVF Tool user guide for URL formats. If you are using local file, use file://<OVA file path>. If using VM template, VM template should have been uploaded with name '{name_prefix}-{deploy_size}'.

Mandatory

ovaUrl

External IP

External address to connect to the services on this TCA appliance, either FQDN (preferably) or IP address. The external address cannot be changed later on. For TCA-CP, it should be the same as the address used on TCA-M for pairing. When left empty (not recommended), the VM IP address will be used.

Optional

externalAddress

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 if tool deploys appliance.

Mandatory

vcEndpoint

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. Tool will encrypt password and store.

Mandatory

vcPassword

VCenter endpoint thumbprint

Thumbprint of management VC, if self-signed cert. Tool will provide thumbprint, just confirm to trust or not.

Optional

vcThumbprint

2.3 Appliance name

The VM name of the 2.3 appliance in the VC. It could be inventory path of vCenter. Tool will discover the appliance name by IP.

Optional

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.