Parallels H-Sphere Documentation System Administrator Guide


VPS Host Installation

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

Related Docs:   Providing VPS Hosting (Admin Guide) VPS Upgrade VPS Scripts FreeVPS Docs

Last modified: 13 Mar 2006


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 adding a VPS hosting box into an H-Sphere cluster.

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


Step 1. Prepare Server for H-Sphere VPS Installation

Please refer to a separate doc.


Step 2. Installation

Add a VPS service to a separate physical box reserved only for VPS. We don't recommend to add other services to this box like web, mail etc.

Starting with H-Sphere 2.5 RC 2, a new physcical VPS box is added to H-Sphere cluster within the standard procedure of adding servers and services (first add a physical Unix box via the cp, then add a logical vps server to it, then run the installation script).

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
    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
    image=/boot/vmlinuz-2.4.21-freevps-1.5-6rc3    label=linux_patched

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


# shutdown -r now


Step 5. Check Kernel Version


# 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. VPS Host Configuration

To configure your virtual servers, run the configuration script:

# /hsphere/shared/scripts/

With the further steps, you'll perform basic configuration of your virtual servers. See more on VPS host configuration.


Step 7. Configure Network Gateways

Follow insructions on adding VPS network gateways.

Related Docs:   Providing VPS Hosting (Admin Guide) VPS Upgrade VPS Scripts FreeVPS Docs

© Copyright 2018. Parallels Holdings. All rights reserved.