Parallels H-Sphere Documentation System Administrator Guide

 

Upgrading H-Sphere VPS Host

(HS VPS 1.4-4; H-Sphere 2.5 RC 2 and up)
 
 

Related Docs:   VPS Host Installation FreeVPS Docs

Last modified: 27 Dec 2007

 

WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

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

Important!
These instructions are valid only for H-Sphere 2.5 RC 2 and up. For lower versions, perform steps described here.

For more information on VPS, please contact vps@psoft.net.

 

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

The packages may vary depending upon the operating system. For a full list of VPS related packages installed on VPS box, please refer to VPS Server per supported operating systems in H-Sphere 2.5 RC 2 Package List

 

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):

# lilo

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:

# uname -a

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. See more on VPS host configuration.

 

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.


Related Docs:   VPS Host Installation FreeVPS Docs



© Copyright 2017. Parallels Holdings. All rights reserved.