VPS Host Installation

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

• Step 1. Preparing Server for H-Sphere VPS Installation
  • Supported Operating Systems
  • Hardware Requirements
  • Recommended Partitioning
  • Required Packages
• Step 2. Installation
• Step 3. VPS Host Configuration
• Step 4. Adding Physical and Logical VPS Server to H-Sphere

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

Step 1. Preparing Server for H-Sphere VPS Installation

Supported OS

H-Sphere VPS is installed on a dedicated box not to intefere with H-Sphere services with one of the following OS installed:

• Red Hat Linux release 7.3
• Red Hat Enterprise Linux release 3, CentOS 3.x, and White Box Enterprise Linux release 3

We do not support H-Sphere VPS on other operating systems.

Hardware Requirements

Hardware requirements for H-Spehre VPS are the same as for a standalone FreeVPS installation.

Recommended Partitioning

For better perfomance, we recommend to divide your H-Sphere FreeVPS box in three partitions for:

• VPS servers with at least 500 MB for each minimal and 1 GB for each complete (all VPS templates installed) VPS installation.
• VPS OS distributives (since VPS installation requires its OS distributives to be stored on the VPS host) with at least 2 GB for each OS you are going to support.
• VPS backups with at least 30-40% of disk space allocated for each VSP server.

Required Packages

• standalone FreeVPS installation packages of a latest version, except for:
  
  kernel-freevps-1.4-9
  freevps-tools-1.4-2
   
  
• H-Sphere VPS packages to provide VPS management and integration with H-Sphere:
  
  
• hsphere-vps-1.3-6.7
• hsphere-script-runner-X
• hsphere-sudo-X
Where X is the latest available package version.

downloaded at:

• http://www.psoft.net/shiv/HS/VPS/RH73/ for RedHat Linux release 7.3
• http://www.psoft.net/shiv/HS/VPS/RHEL/ for Red Hat Enterprise Linux release 3, CentOS 3.x, White Box Enterprise Linux release 3

Notes:


• The scripts assembled into hsphere-vps package are also available in command-line mode.
• We provide hsphere-vps packages only for:
  - RedHat Linux release 7.3 with Perl 5.6.1 installed.
  - Red Hat Enterprise Linux release 3, CentOS 3.x, White Box Enterprise Linux release 3 with Perl 5.8.0 installed.
  If you need to install H-Sphere VPS packages on one of the mentioned platforms with other Perl versions, you need to rebuild H-Sphere VPS.

Step 2. Installation

1. Go through standalone FreeVPS installation procedure
   
   Important: instead of the latest available versions of kernel-freevps and freevps-tools download and install
     kernel-freevps-1.4-9
     freevps-tools-1.4-2
   
   

2. Download the required H-Sphere VPS packages:

   # wget path/to/download-location/package-X.rpm

   where:
   - path/to/download/location is a corresponding OS package download location;
   - package is the name of the downloaded package;
   - X is the latest available package version, except for hsphere-vps-1.3-6.7

3. Install the downloaded packages:

   # rpm -Uvh package-X.rpm

   where:
   - package is the name of the downloaded package;
   - X is the latest available package version, except for hsphere-vps-1.3-6.7.

Step 3. 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 4. Adding Physical and Logical VPS Server to H-Sphere

To add and configure physical and logical VPS servers in H-Sphere:

1. Generate SSH keys on your CP server and place them to VPS host server to provide SSH connection between VPS host and CP server;
2. Follow the instructions in Admin Guide on adding and configuring physical and logical VPS servers in H-Sphere interface.