Skip to main content

Install, Configure, and Upgrade Guide for 26.x

pcemigrate transplant-vens-status

The pcemigrate transplant-vens-status command checks the VENs migration status 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.