Upgrade the vSphere Integrated Containers Appliance by Manually Copying Disks

By default, the upgrade script automatically copies the relevant disk files from the old appliance to the new appliance. As an alternative, you can perform the upgrade by manually copying disks from the old appliance to the new appliance.

IMPORTANT: The recommended method of upgrading the appliance is to follow the procedure in Upgrade the vSphere Integrated Containers Appliance. Only use the manual method if the fully automatic method fails.

Manually upgrading the vSphere Integrated Containers appliance requires you to copy disks from the old appliance VM to a new instance of the appliance. Because disk files are copied rather than moved, the old appliance is not affected by the upgrade process. You can keep it as a backup.

During a manual upgrade, all configurations that you made in vSphere Integrated Containers Management Portal and Registry in the previous installation transfer to the upgraded appliance. The old appliance is no longer functional after you move the disks.

Prerequisites

  • You have completed the pre-upgrade tasks listed in Tasks to Perform Before Upgrading the vSphere Integrated Containers Appliance.
  • If you deployed the old version of the vSphere Integrated Containers appliance with a static IP address, and you want the new appliance to retain the same IP address after the upgrade, reconfigure the old appliance to use a temporary IP address before you start the upgrade procedure. For information about how to reconfigure the old appliance, see Reconfigure the vSphere Integrated Containers Appliance.
  • Deploy the latest version of the vSphere Integrated Containers appliance. For information about deploying the appliance, see Deploy the vSphere Integrated Containers Appliance.
    • If you use vCenter Server 6.7 update 1 or later, you can use the HTML5 vSphere Client to deploy the appliance. If you use an older version of vCenter Server, you must use the Flex-based vSphere Web Client to deploy the appliance. You cannot deploy OVA files from versions of the HTML5 vSphere Client that pre-date vCenter Server 6.7 update 1.
    • When you deploy the new version of the apppliance, you can optionally configure the network settings to use the same static IP address as you used on the old version.
    • The upgrade process copies data from the old appliance to the new appliance. Consequently, if you deployed the appliances to a cluster, the virtual disks for the two appliances must be located in the same datastore cluster.
    • IMPORTANT: If you used custom certificates when you deployed the previous version of the appliance, you must use the same certificates when you deploy the new version of the appliance. If you do not provide the certificate details when you deploy the new version, self-signed certificates are generated.
    • Do not disable SSH access to the new appliance. You require SSH access to the appliance during the upgrade procedure.
    • Deploy the new version of the appliance to the same vCenter Server instance as the one on which the previous version is running, or to a vCenter Server instance that is managed by the same Platform Services Controller.
    • Do not power on the new version of the appliance.
  • Log in to the vSphere Client for the vCenter Server instance on which the previous version is running and on which you deployed the new version.

Procedure 1: Copy Disks

  1. In the Hosts and Clusters view of the vSphere Client, right-click the new version of the appliance and select Edit Settings.
  2. Remove the following hard disks from the new appliance.

    Disk to Remove Description
    Hard disk 2 Data disk
    Hard disk 3 Database disk
    Hard disk 4 Log disk. Migrating logs is optional.
    1. Hover your pointer over each hard disk and click the Remove button on the right-hand side of the row.
    2. For each disk, select the Delete files from this datastore checkbox.
    3. When you have marked disks 2,3, and 4 for removal, click OK.
  3. In the Hosts and Clusters view, right-click the old version of the appliance and select Power > Shut Down Guest OS.

    IMPORTANT: Do not select Power Off.

  4. Go to the Storage view of the vSphere Client and navigate to the datastore and datastore folder that contain the VM files for the old version of the appliance.
  5. Use ctrl-click to select the following VMDK disk files from the old version of the appliance.

    File to Select Description
    <appliance_name>_1.vmdk Hard disk 2, data disk
    <appliance_name>_2.vmdk Hard disk 3, database disk
    <appliance_name>_3.vmdk Hard disk 4, log disk. Migrating logs is optional.
  6. Click Copy to, select the datastore folder of the new appliance as the destination, and click OK.

  7. When the copy operation finishes, attach the disks from the old appliance to the appropriate nodes on the new appliance.

    VMDK File Virtual Device Node
    <appliance_name>_1.vmdk SCSI(0:1)
    <appliance_name>_2.vmdk SCSI(0:2)
    <appliance_name>_3.vmdk SCSI(0:3)
    1. In the Hosts and Clusters view, right-click the new appliance and select Edit Settings.
    2. Select the option to add a new disk:
      • HTML5 vSphere Client: Click the Add New Device button and select Existing Hard Disk.
      • Flex-based vSphere Web Client: Click the New device drop-down menu, select Existing Hard Disk, and click Add.
    3. Navigate to the datastore folder for the new appliance, select the <appliance_name>_1.vmdk disk file from the old appliance, and click OK.
    4. Expand New Hard Disk and make sure that the Virtual Device Node for the disk is set to SCSI(0:1).
    5. Repeat the procedure to attach <appliance_name>_2.vmdk to SCSI(0:2) and <appliance_name>_3.vmdk to SCSI(0:3).
    6. Click OK.

Procedure 2: Run the Upgrade Script

  1. Power on the new version of the vSphere Integrated Containers appliance and wait for it to boot up.

    Booting up can take a few minutes. Go to https://vic_appliance_address:9443 and wait until the Complete VIC appliance installation panel appears.

    IMPORTANT: After the new appliance has booted up, do not fill in the Complete VIC appliance installation panel. This step is only applicable to new installations, not to upgrades.

  2. Use SSH to connect to the new appliance as root user.

    $ ssh root@new_vic_appliance_address

    When prompted for the password, enter the appliance password that you specified when you deployed the new version of the appliance.

  3. Navigate to the /etc/vmware/upgrade folder.
    $ cd /etc/vmware/upgrade
  4. Run the upgrade script, specifying the --manual-disks flag.

    $ ./upgrade.sh --manual-disks

    If you attempt to run the script while the appliance is still initializing and you see the following message, wait for a few more minutes, then attempt to run the script again.

    Appliance services not ready. Please wait until vic-appliance-load-docker-images.service has completed.

    To track the progress of the initialization, run watch docker ps -a and wait for the vic-machine-server container to start.

    You can bypass some or all of the following steps by specifying additional optional arguments when you run the upgrade script. For information about the arguments that you can specify, see Specify Command Line Options During Appliance Upgrade.

  5. Enter the IP address or FQDN of the vCenter Server instance on which you deployed the new appliance.
  6. Enter the Single Sign-On user name and password of a vSphere administrator account.

    The script requires these credentials to access the disk files of the old appliance, and to register the new version of vSphere Integrated Containers with the VMware Platform Services Controller.

  7. If vCenter Server is managed by an external Platform Services Controller, enter the IP address or FQDN and the administrator domain of the Platform Services Controller.

    If vCenter Server is managed by an embedded Platform Services Controller, press Enter at each prompt without entering anything.

  8. Enter y if the vCenter Server certificate thumbprint is legitimate.

  9. Enter the root password of the new version of the appliance.
  10. To automatically upgrade the vSphere Integrated Containers plug-in for vSphere Client, enter y at the prompt to Upgrade VIC UI Plugin.

    NOTE: If you enter n to skip the plug-in upgrade, for example because you have multiple appliances of a different version, you can upgrade the plug-in later. You can see version information about the plug-in and the appliance in the Summary tab of the vSphere Integrated Containers plug-in.

  11. Verify that the upgrade script has detected your upgrade path correctly.

    • If the script detects your upgrade path correctly, enter y to proceed with the upgrade.
    • If the upgrade script detects the upgrade path incorrectly, enter n to abort the upgrade and contact VMware support.

Result

After you see confirmation that the upgrade has completed successfully, the upgraded appliance initializes. When the upgraded appliance has initialized, you can access its appliance welcome page at http://new_appliance_address.

What to Do Next

  • If you answered y at the prompt to Upgrade VIC UI Plugin, access the vSphere Integrated Containers plug-in for vSphere Client:
    1. Log out of the HTML5 vSphere Client and log back in again. You should see a banner that states There are plug-ins that were installed or updated.
      1. If you use vSphere 6.7u1 or later, click the button in the banner to refresh the vSphere Client.
      2. On versions of vSphere that pre-date 6.7u1, log out of the HTML5 vSphere Client a second time and log back in again.
    2. Click the vSphere Client logo in the top left corner.
    3. Under Inventories, click vSphere Integrated Containers to access the vSphere Integrated Containers plug-in.
    4. In the vSphere Integrated Containers > Summary tab, check that the plug-in is at the correct version.
  • Click Go to the vSphere Integrated Containers Management Portal in the appliance welcome page, and use vCenter Server Single Sign-On credentials to log in.
    • In the Home tab of the vSphere Integrated Containers Management Portal, check that all existing applications, containers, networks, volumes, and virtual container hosts have migrated successfully.
    • In the Administration tab, check that projects, registries, repositories, and replication configurations have migrated successfully.
  • If, in the previous version, you configured vSphere Integrated Containers Registry instances as replication endpoints, upgrade the appliances that run those registry instances. Replication of images from the new registry instance to the older replication endpoint still functions, but it is recommended that you upgrade the target registry.
  • Download the new vSphere Integrated Containers Engine bundle and upgrade your VCHs. For information about upgrading VCHs, see Upgrade Virtual Container Hosts.
  • If you answered n at the prompt to Upgrade VIC UI Plugin, and you want to upgrade the plug-in later, see Reinitialize the vSphere Integrated Containers Appliance.

Troubleshooting

If upgrade fails, generate a log bundle and obtain the upgrade log to provide to VMware support. For information about obtaining the logs, see Access and Configure Appliance Logs.

results matching ""

    No results matching ""