Upgrading a VMware virtual machine to R12.0.x

Last Updated : Apr 18, 2024 |

About this task

This process boots the virtual machine from the copy of the VMDK upgrade file. The boot process backs up the server data, upgrades it to R12.0.x, and then restores the server data.

Before you begin

  • You must upgrade the server to IP Office R11.1.3.x.

  • After upgrading to IP Office R11.1.3.x, back up all the servers and services before upgrading to R12.0.x. See Creating an IP Office backup.

Procedure

  1. Shut down the server using the following method:
    1. Connect to the server's platform view/web control menus using port 7071.
    2. Click Shutdown and click Yes. Wait approximately 90 seconds, after which on the connected monitor you will see services shutting down.
    warning
    • Do not use any other method to shut down the server. Doing so will cause the loss of data and settings. This method creates files which the upgrade process uses.

  2. Login to the VMware platform hosting the virtual machine.
  3. Mount the upgrade vmdk files as a new hard disk for the virtual machine:
    1. Select the virtual machine and click Edit virtual machine settings.
    2. On the Virtual Hardware tab, at the bottom set New device to Existing Hard Disk and click Add.
    3. Browse to the copy of the upgrade vmdk file and select that file.
      Important:
      • Do not use the originally vmdk file which you uploaded. You must use the copy of that file that you created.

      • If upgrading a network of servers, each server can use the same copied vmdk file. However, only one server can use the file at any time.

    4. Click Next >. Check the settings and click OK.
  4. Adjust the boot order of the virtual machine hard disks to boot using the upgrade vmdk file:
    1. Expand the settings of the hard disk.
    2. Next to Virtual Device Node, click on the SCSI setting and select the drive's position in the boot order. SCSI(0:0) is the first drive and the one from which the server boots, SCSI(0:1) the second drive, and so on.
    3. Click OK and repeat the process for the other drives present.
    4. When completed, check that:
      • The upgrade vmdk drive is SCSI(0:0).

      • The original IP Office drive is SCSI(0:1).

      • If present, the Media Manager drive is SCSI(0:2).

  5. Click Power on the virtual machine.
  6. Click Summary.
  7. Click on the screen image to monitor the upgrade process from the console.
  8. When completed, the server automatically switches off.
  9. Remove the upgrade vmdk file from the virtual machine and reset the drive boot order:
    1. Select the virtual machine and click Edit virtual machine settings.
    2. Move the cursor to the right of the upgrade hard disk entry and click the x icon.
    3. Reverse the process in step 4 to return the remaining drives back to their original boot order.
    4. When complete, check that:
      • The original IP Office drive is SCSI(0:0).

      • If present, the Media Manager drive to SCSI(0:1).

  10. Restart the virtual server by clicking Power on the virtual machine.
  11. Wait 10 minutes. During this time, the upgrade process will complete additional steps and reboot the server again.
  12. When the server has restarted:
    1. Check that the version shown is R12.0.x. If not, see Failure to upgrade.
    2. Cancel any Consolidate Configuration Entries menu shown in IP Office Manager or IP Office Web Manager. The menu disappears after you have upgraded all IP Office servers in a network to R12.0.x.
    3. Ignore any Upgrade Available prompts shown in IP Office Web Manager. You must only upgrade other IP Office servers using the processes in this document.
    4. Following the upgrade, test and verify the operation of all services. If you find any issues, see Known upgrade issues.
  13. If the server is part of a network, continue with the next server. See Upgrading a network of IP Office servers.
    • You can reuse the upgrade image to upgrade multiple servers in sequence. However, you must only use an upgrade image to upgrade one server at a time.

  14. When satisfied with the operation of the upgraded servers, you can delete the copies of the upgrade disk.
    • Only do this after when you are satisfied with the upgrade. The upgrade disk contains log files relating to the upgrade, see Upgrade logs. You need those log files to report upgrade issues.