Upgrade Harvester in Fully Airgapped Environment

Category:

  • Upgrade Harvester

Environment requirement

  1. Airgapped Network without internet connectivity
  2. Network environment has available VLAN id setup on DHCP server
  3. DHCP server has setup the IP range can allocate to above VLAN id
  4. Harvester node can route to DHCP server through VLAN id to retrieve IP address
  5. Network has at least two NICs
  6. Suggest not to use SMR type HDD disk

We can select VM or Bare machine network setup according to your available resource

Virtual Machine environment setup

  1. Clone ipxe-example https://github.com/harvester/ipxe-examples
  2. Switch to v1.0 or main branch
  3. Edit Vagrantfile, add a new network interface of pxe_server.vm.network
  4. Set the pxe_server.vm.network bond to correct libvirt network
  5. Add two additional new network interface of harvester_node.vm.network
  6. Edit the settings.yml, set harvester_network_config.offline: true
  7. Use ipxe-example to provision a multi nodes Harvester cluster
  8. Run varant ssh pxe_server to access pxe server
  9. Edit the dhcpd.conf, let pxe server can create a vlan and assign IP to it

Bare machine environment setup

  1. Ensure your switch router have setup VLAN network
  2. Setup the VLAN connectivity to your Router/Gateway device
  3. Disable internet connectivity on Router
  4. Provision a multi nodes Harvester cluster

Verification Steps

  1. For VLAN 1 testing, enable network on settings, select harvester-mgmt

  2. Create a vlan1 network with id 1 on Networks page image

  3. For other VLAN id testing, enable network on settings, select correct network interface e.g enps0f1 image

  4. Create a vlan91 network with available id 91 on Networks page (id number depends on your available network setting) image

  5. Create images with different OS distribution

  6. Create several virtual machines, set network to management-network or available vlan

  7. Create virtual machine on different target node

  8. Setup NFS or S3 backup target in settings

  9. Backup each virtual machines

  10. Shutdown all virtual machines

  11. Offline upgrade to target version, refer to https://docs.harvesterhci.io/v1.1/upgrade/automatic

Expected Results

  1. Can completely upgrade Harvester to specific version
  2. All pods are running correctly
  3. Check can display Monitoring Chart
    • Prometheus dashboard
    • VM metrics
  4. Can access dashboard by VIP
  5. Can use original password to login
  6. Can start VM in running status
  7. Image exists without corrupted
  8. Volume exists
  9. Virtual network exists
  10. Backup exists
  11. Setting value exists
  12. Can restore VM from backup
  13. Can create new VMs