H-Sphere VPS 1.5-3 Installation
(manual procedure - all supported H-Sphere versions or non H-Sphere boxes)
21 Sep 2006
Features | Install | Update
This document is the step-by-step instruction of manual (i.e., not by means of
H-Sphere update script) H-Sphere VPS installation on a
VPS hosting box.
Note: In H-Sphere 2.5 RC 2 and up it is preferable to install the server by means of
automatically by H-Sphere updater.
Note: H-Sphere VPS 1.5 and up comes under the
license and is admissible for installation on non H-Sphere boxes.
For more information on VPS, please contact
Step 1. Preparation
See Preparing Server for H-Sphere VPS Installation in a separate document.
Step 2. Installation
Installation procedure is different for H-Sphere 2.5 and up and for H-Sphere before 2.5 or non H-Sphere boxes.
Add VPS service to a separate H-Sphere physical box
reserved only for VPS. We don't recommend to add other services to this box like web, mail etc.
H-Sphere 2.5 and up
Starting with H-Sphere 2.5 RC 2, a new physical 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-8
- FreeVPS tools: freevps-tools-1.4-6
- H-Sphere VPS: hsphere-vps-1.5-3.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
H-Sphere 2.4.x or non H-Sphere boxes
Download the following packages:
We recommend downloading these packages into a separate directory.
Install the downloaded packages:
Enter downloaded packages directory,
and install the packages for your operating system in the order they are listed in the table above,
up to the hsphere-vps-install package (including the latter).
Use the rpm -iv option for installation:
# rpm -iv PACKAGE_FILE
Run the FreeVPS kernel and tools' installation script:
# /hsphere/pkg/scripts/hsphere-vps-install/hsphere-vps-install.pl -v
It will inform you about host configuration (platform, processor, memory capicity, OS):
The following system detected:
CPU type athlon
CPU count 2
Mem. total 1539888 Kb
OS family RHEL4
It will also remind you about the new kernel version to boot with, for example:
+ Do not forget to configure boot loader to boot with new kernel: '1.5-8'
Note: If there are no sutable FreeVPS kernel/tools found for your host or install failed, please use the
following documentation to install them manually according to
Install the rest of the packages specified in the table list after the hsphere-install package:
# rpm -iv PACKAGE_FILE
Add VPS host server as new H-Sphere physical/logical server
(skip this step for non H-Sphere boxes)
- Generate SSH keys on your CP server
and place them to the VPS host server to provide SSH connection between VPS host and CP server
- Follow the instructions in Admin Guide on
adding and configuring physical and logical VPS servers in H-Sphere interface.
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
title Red Hat Linux (2.4.21-freevps-1.5-8)
kernel /vmlinuz-2.4.21-freevps-1.5-8 ro root=/dev/sda5
title Red Hat Linux (2.4.18-3)
kernel /vmlinuz-2.4.18-3 ro 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
# 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
Step 6. VPS Host Configuration
To configure your virtual servers, run the configuration script:
With the further steps, you'll perform basic configuration of your virtual servers.
See more on VPS host configuration.
Step 7. Configure Network Gateways
(Only for H-Sphere 2.5 and up)
Follow insructions on adding VPS network gateways.