10.3 Upgrading the VMs

  1. Complete the steps in Table 10-1 for each appliance that you are upgrading

Table 10-1 Upgrading a VMware VM

Page, Dialog, or Option

Do This

VMware Host Client

  1. On your management workstation, start the browser-based VMware Host Client.

    IMPORTANT:These instructions describe the browser-based client. The vSphere path is documented in previous versions of TeamWorks if needed.

  2. In the Navigator side bar, click Virtual Machines, then click Create / Register VM.

Select creation type

  1. Select Deploy a virtual machine from an OVF or OVA file, then click Next.

Select OVF and VMDK files

  1. Name the appliance with a name that is easily associated with (but not the same as) the VM name of the associated appliance being upgraded

    Consider including information in the names that easily identifies the appliance type and other information, such as the IP address.

    For example,

    • v18-1-TeamWorks-1-192.168.1.61

    • v18-1-TeamWorks-2-192.168.1.62

    • v18-1-Search-1-192.168.1.71

    • v18-1-Search-2-192.168.1.72

    • v18-1-Search-3-192.168.1.73

  2. In a file browser, navigate to the contents of the folder extracted in Step 2.

  3. Select the .ovf and .vmdk files and drop them in the area indicated as you hoover over the VMware dialog.

  4. Click Next.

Select storage

  1. Choose the datastore for the appliance you are upgrading and click Next.

Deployment options

  1. Ensure that Disk provisioning is set to Thick.

  2. Deselect Power on after deployment.

  3. Click Next.

Ready to complete

  1. Click Finish.

    The boot disk is created and the appliance is deployed as specified to this point.

3 - Copy Disk 2 to the New Appliance.

VMware Host Client

Copying each appliance’s disk is at the heart of the upgrade process because it uses the corresponding old appliance’s configuration settings on Disk 2 to create an upgraded version of the appliance with minimal input on your part.

Disk copying can take a while, depending on disk size and the VM host environment.

Therefore, we recommend keeping service downtime to a minimum by making the copies while the TeamWorks system is still running.

  1. Shutdown the appliance from which you need to copy Disk 2.

  2. Copy Disk 2 to its associated folder or directory that you created for your upgraded appliances in Downloading and Preparing Software for the Upgrades.

    NOTE:Default VMware disk names are constructed as follows:

    • vm_name.vmdk

    • vm_name_1.vmdk - This is Disk 2

    • vm_name_2.vmdk

  3. When the disk finishes copying, start up the appliance so that the TeamWorks service can continue.

4 - Editing the VM settings.

VMware Host Client

  1. In the Virtual Machines list, right-click the VM you just deployed and select Edit Settings.

    The Virtual Machine Properties dialog displays.

Virtual Hardware

  1. Set the Memory and CPU settings to match the appliance you are replacing, or increase them as planned.

 

5 - Configuring disk 2 (/vastorage)

Virtual Hardware

  1. Click Add Hard Disk.

  2. Select Existing Hard Disk.

  3. Navigate to and select the copy of disk 2 that you made for this appliance.

  4. Click Select.

 

6 - Adding and Configuring disk 3 (/var)

Virtual Hardware

  1. Click Add Hard Disk.

  2. Select New Standard Hard Disk.

  3. Adjust the Disk Size and other settings to match disk 3 (/var) on the appliance you are replacing.

  4. If you need to add network adapters, continue with 7 - (Optional) Adding a Network Adapter.

    Otherwise, click OK, and deploy the next appliance.

    When all of your planned appliances have been deployed, continue with Deploying the Upgraded (Replacement) VMs.

Virtual Hardware

7 - (Optional) Adding a Network Adapter

If the appliance you are replacing has a second network adapter, add a network adapter matching network adapter to this appliance

VMware Host Client

  1. Repeat the steps in this table until all of your planned appliances have been deployed, then continue with Shutting Down the Old Deployment.