Skip to main content

Install, Configure, and Upgrade Guide for 26.x

pcemigrate transplant-vens-status

The command checks the status of the migration of VENs from the source PCE to the target PCE. If the ven href file is specified, the status is provided only for the set of VENs in the file.

If the ven href file is not specified, the command provides information on all VENs that have migrated, or on those within the last migrate-since minutes if --migrate-since is specified.

pcemigrate transplant-vens-status

The command generates a CSV file, which contains the following columns for each VEN:

  • src_href: href of the VEN on the source PCE -

  • status: Status of the migration of the VEN. It can have one of the following values:

    SUCCESS: VEN has migrated successfully to the target PCE

    UNKNOWN: The condition of the migration is unknown. It may be in progress or might have failed. If this state persists, the migration should be considered as failed.

    FAILED_AFTER_MIGRATE: The VEN has migrated to the target PCE

  • dst_href: href of the VEN on the target PCE

  • name: name of the VEN workload

  • hostname: hostname of the VEN workload

  • last_heartbeat: timestamp of the last heartbeat received on the target PCE if dst_href is determined otherwise on the source PCE

  • migrated_at: Corresponds to the managed since timestamp of the VEN on the target PCE

 Usage:
    pcemigrate transplant-vens-status [flags]
  
  Flags:
      --from-pce string          source PCE.
      --to-pce string            target PCE.
      --href-file string         ven href file location. 
                                 if not specified status of VENs 
                                 already migrated is provided.
      --csv-output-dir string    Directory under which timestamp 
                                 CSV output file is saved.
                                 for VENs not detected on target 
                                 PCE. Only relevant if ven href 
                                 file specified.
      --migrated-since int       Only Provide information about 
                                 the VENs that have migrated 
                                 since the last number of minutes 
                                 specified. Only relevant if 
                                 the ven href file is not specified.
  -h, --help                     help for transplant-vens-status
  
  Global Flags (not relevant for all commands):
      --base-data-dir string   Full path of base directory for 
                               migration data. 
                               Migration related data are stored 
                               under <base-data-dir>/data.
      --config-file string     path for pcemigrate pce.yaml file. 
                               Run 'pcemigrate settings' for 
                               platform default location.
      --debug                  Enable debug level logging for 
                               troubleshooting.
      --log-dir string         Full path of logging directory.
      --log-file string        path for pcemigrate log file. 
                               Obsolete. 
                               Use 'pcemigrate settings 
                               --log-dir <dir>' to specify the 
                               logging directory.
      --migrate-op             When migrate-op is set to true, 
                               Import operation are interpreted 
                               as copy of objects from a different 
                               PCE as part of a PCE migration 
                               operation.
      --no-prompt              Remove the user prompt when used 
                               with update-pce.
      --pce string             PCE to use in command if not 
                               using default PCE.
      --update-pce             Command will update the PCE after 
                               a single user prompt. 
                               Default will just log potential 
                               changes.
      --verbose                When verbose is enabled, 
                               nclude the raw API responses. 
                               This makes pcemigrate.log increase 
                               in size significantly.