Upgrading H-Sphere VPS Host

This document is the step-by-step instruction of upgrading a VPS hosting box in an H-Sphere cluster.

Step 1. Suspend Virtual Servers on the VPS Host

Login as root on the VPS host server and run:

# cd /hsphere/shared/scripts
# ./vps-suspend.pl -a

Step 2. Run H-Sphere Updater on the VPS Box

Please refer to H-Sphere Update and Adding Servers and Services in H-Sphere 2.5 and up.

Note: This procedure will install the following core VPS related packages on the VPS host server:

• FreeVPS kernel: freevps-1.5-6rc3
• FreeVPS tools: freevps-tools-1.4-3rc1
• H-Sphere VPS: hsphere-vps-1.4-4.noarch

Step 3. Edit Boot Loader Configuration File

Edit this file (/boot/grub/grub.conf, or /etc/lilo.conf) so its default variable is set to take newly installed kernel as the boot image.

Important! Keep the old kernel image settings, so the system can start if anything goes wrong with the new kernel installation.

• grub.conf
  

  default=0
  timeout=10
  splashimage=(hd0,0)/grub/splash.xpm.gz
  title Red Hat Linux (2.4.21-freevps-1.5-6rc3)
    root (hd0,0)
    kernel /vmlinuz-2.4.21-freevps-1.5-6rc3 ro root=/dev/sda5
    initrd /initrd-2.4.21-freevps-1.5-6rc3.img
  title Red Hat Linux (2.4.18-3)
    root (hd0,0)
    kernel /vmlinuz-2.4.18-3 ro root=/dev/sda5
    initrd /initrd-2.4.18-3.img
  

• lilo.conf
  

  prompt
  timeout=50
  default=linux_patched
  boot=/dev/sda
  map=/boot/map
  install=/boot/boot.b
  message=/boot/message
  linear
  image=/boot/vmlinuz-2.4.18-3
      label=linux
      initrd=/boot/initrd-2.4.18-3.img
      read-only
      root=/dev/sda5
  image=/boot/vmlinuz-2.4.21-freevps-1.5-6rc3    label=linux_patched
      initrd=/boot/initrd-2.4.21-freevps-1.5-6rc3.img
      read-only
      root=/dev/sda5
  

Now apply changes to lilo.conf (skip this step if you use grub boot loader):

If you correctly edit lilo.conf, the command will list all labels' values as added.

Step 4. Reboot the Server

Run:

# shutdown -r now

Step 5. Check Kernel Version

Run:

If the procedure has been performed correctly, this command will return a line with parameters of the server which must include 1.5-6rc3.

Step 6. Run the Update Script

Run:

# cd /hsphere/shared/scripts/
# ./vps-update.pl

and follow the script instructions.

Step 7. VPS Host Configuration

To configure your virtual servers, run the configuration script:

# /hsphere/shared/scripts/vps-configure.pl

With the further steps, you'll perform basic configuration of your virtual servers.

Step 8. Resume Virtual Servers on the VPS Host

Run:

# cd /hsphere/shared/scripts
# ./vps-resume.pl -a

Step 9. Configure Network Gateways

Follow insructions on adding VPS network gateways.