Skip to main content

VM In Place Upgrades

This page contains instructions for upgrading both KVM and VMWare rWebs in place to 10.0.

danger

This process will delete data! While it will preserve IP addresses and serial numbers, other configuration and data will be lost. Be sure to have fully downloaded a backup to a safe location.

Preconditions​

Ensure you have these items on hand first:

  • Your rWeb backup
  • A copy of the rWeb 10 vm.iso uploaded to your hypervisor

KVM rWeb In Place Upgrade​

rWeb can be upgraded in-place by booting from the VM upgrade ISO. It will require an interactive console to confirm the upgrade. The following instructions are for the libvirt Virtual Machine Manager interface.

  1. If not already done, ensure you have a backup (full or config only) generated and saved off from your existing rWeb.
  2. Shut down the virtual machine.
  3. Click “Show virtual hardware details”.
  4. Click “Add hardware” at the bottom.
  5. Check “Select or create custom storage”.
  6. Select the vm-upgrade.iso image of rWeb 10.0.
  7. Set device type to be “CDROM” and bus type to be “SATA” and hit finish.
  8. Under Boot Options check “SATA CDROM1” and make it the first on the Boot device order list.
  9. Hit apply and power on the virtual machine.
  10. Hit enter when the screen shows "Install rWeb 10" and wait for it to finish.
  11. After the installation is finished, the VM will power itself down.
  12. Reconfigure the VM, removing the cdrom drive.
  13. Power on the system to let it run the initial setup script.
  14. The system will reboot once, after which it is ready to use.
  15. Log in with the default user and password (admin/admin123) and reload your backup. Your browser may refuse to connect to rWeb because of HSTS. In this case you'll need to clear your browser's HSTS settings for rWeb temporarily in order to restore the backup.
  16. Load the latest copy of your license manually or use the "pull and apply" option from the rWeb licensing section.

VMWare rWeb In Place Upgrade​

rWeb can be upgraded in-place by booting from the VM upgrade ISO. It will require an interactive console to confirm the upgrade. The following instructions are for the ESXi web interface.

  1. If not already done, ensure you have a backup (full or config only) generated and saved off from your existing rWeb.
  2. Shut down the virtual machine.
  3. Select the VM.
  4. Click "Actions", then "Edit Settings". rweb10-vmware-upgrade-step-1.png
  5. Click "VM Options", then expand "Boot Options". rweb10-vmware-upgrade-step-2.png
  6. Make sure "Force BIOS setup" is enabled.
  7. In "Virtual Hardware", select "Add Another Device" and add a CD/DVD Drive.
  8. Select datastore ISO, then select the vm-upgrade.iso image of rWeb 10.0.
  9. Turn on the VM, waiting until you see the BIOS setup screen.
  10. Under Boot Options make sure the CD/DVD is first on the order list, then Save and Exit. rweb10-vmware-upgrade-step-3.png
  11. Hit enter when the screen shows "Install rWeb 10" and wait for it to finish.
  12. After the installation is finished, the VM will power itself down.
  13. Repeat the process starting from step 3, this time making sure the Hard Drive is first in boot order.
  14. Power on the system to let it run the initial setup script.
  15. The system will reboot three times, after which it is ready to use.
  16. Log in with the default user and password (admin/admin123) and reload your backup. Your browser may refuse to connect to rWeb because of HSTS. In this case you'll need to clear your browser's HSTS settings for rWeb temporarily in order to restore the backup.
  17. Load the latest copy of your license manually or use the "pull and apply" option from the rWeb licensing section.