Virtual Machine Re-image

These instructions show how to update an OVA Virtual Machine by re-imaging from the latest Gateway ISO image. As a result of this procedure, the machine is wiped and a new Gateway is installed.
Be sure to backup your system before performing these steps. Your old machine is wiped clean, and the new virtual machine is installed over it with default factory settings.
If updating from Gateway 9.4 to Gateway 10.1, CentOS 7 is installed. Some downtime is required for MySQL replication.
In Gateway 10.1, the OVA disk size is increased to 70GB. Before reimaging the Gateway 9.4 VM, increase the disk size to 70GB to support the new partitions in Gateway 10.1. But if you have snapshots in your Gateway 9.4 VM, disk expansion is not possible. Do one of the following tasks before reimaging your Gateway 9.4 VM to resolve the disk expansion issue:
  • Delete all the existing snapshots and then expand the disk size to 70GB.
  • If you must retain the snapshots, keep the disk size as it is (by default, it is 60GB in Gateway 9.4 VM) and then upgrade to Gateway 10.1. After upgrade, the partition sizes remain the same. If you need to increase the partition sizes, see Increase Disk Space Using LVM for instructions.
Before You Begin
Ensure you have the following:
  • A running Gateway virtual machine in ESXi
  • Permission to control the virtual machine settings and upload an ISO file to the data store
Re-image the VM
To Re-image from the latest Gateway ISO file:
  1. Are you planning to restore the previous MySQL database?
    If so, install the new Gateway 10 license key before proceeding. See Manage Gateway Licenses.
  2. Upload the latest Gateway ISO file to ESXi.
  3. In ESXi, power off the virtual machine. Use the snapshot feature to take a new snapshot as a backup.
  4. Go to
    Edit Settings
    and click the
    Virtual Hardware
  5. In the
    Hard Disk
    section, update the disk space to
    GB if you do not have snapshots. If you have snapshots, you cannot edit this section.
  6. In the
    CD/DVD Media
    section, click
    and select the ISO file for the new image.
  7. Click the
    VM Options
    tab. In the Force BIOS Setup section, select the checkbox to force entry into the BIOS setup screen. 
  8. Click
  9. Power on the VM machine.  In the BIOS Setup Utility, under
    , change the boot order so that CD-ROM appears before Hard Drive.
  10. Save the setting and the machine will reboot. A CA technologies screen appears. Press ENTER to use the default
    value. The installation begins. When the new OS is installed, the VM turns off.
  11. With the VM off, return to
    Edit Settings
    , under the
    Virtual Hardware
    tab, and deselect the
    checkbox for the CD/DVD Drive. This ensures that the machine does not boot into the CD-ROM when turned on.
  12. Power on the VM. A first-run boot script runs automatically. No user action is required. The script may runs for 5 minutes or more. After the script completes, the VM is powered off automatically.
  13. Power on the VM again. The screen displays the new version of the Gateway taken from the ISO image.
  14. Ensure that your Gateway System Settings are re-entered as required, beginning with your networking and system time settings.
After your VM is upgraded, continue with configuration or customization using the Automated Expedited Procedure or Manual procedure.