You can use the CLI installer to perform an unattended upgrade of a vCenter Server Appliance or Platform Services Controller appliance. You must run the CLI upgrade from a Windows, Linux, or Mac machine that is in the same network as the appliance that you want to upgrade.



  1. Navigate to the vcsa-cli-installer subdirectory for your operating system.
    • If you are running the upgrade on Windows OS, navigate to the vcsa-cli-installer\win32 directory.
    • If you are running the upgrade on Windows OS Linux OS, navigate to the vcsa-cli-installer/lin64 directory.
    • If you are running the upgrade on Windows OS Mac OS, navigate to the vcsa-cli-installer/mac directory.
  2. (Optional) Run a basic template verification to verify that you prepared the upgrade template correctly.
    vcsa-deploy upgrade --verify-template-only path_to_the_json_file
  3. (Optional) Run a pre-upgrade check to gather and validate the upgrade requirements.
    vcsa-deploy upgrade --precheck-only path_to_the_json_file
    The pre-upgrade check installs the Upgrade Runner on the source appliance that you want to upgrade without upgrading the appliance.

    The Upgrade Runner validates the configurations such as ESXi, network settings, and NTP servers. The Upgrade Runner also checks if you have selected a suitable deployment size and storage size for the new appliance against the compute resources required for the upgrade.

  4. Perform the upgrade by running the following command.
    vcsa-deploy upgrade --accept-eula --acknowledge-ceip optional_arguments path_to_the_json_file

    Use optional_arguments to enter space-separated arguments to set additional execution parameters of the upgrade command.

    For example, you can set the location of the log and other output files that the installer generates.
    vcsa-deploy upgrade --accept-eula --acknowledge-ceip --log-dir=path_to_the_location path_to_the_json_file

What to do next

Verify Your vCenter Server Appliance Upgrade or Migration Is Successful.