FreeVPS Documentation Version 1.2

FreeVPS Host Installation
(version 1.2)

 

Related Docs:  

FreeVPS Kernel FreeVPS Tools VPS Quota



This document will instruct you how to prepare your server for FreeVPS installation and will guide you through the FreeVPS installation procedure.

Please contact us for more information on VPS.

 

System Requirements

FreeVPS requires a separate box with Red Hat Linux 7.3 or Red Hat Enterprise Linux 3 installed.

We do not provide kernel-freevps and freevps-tools packages for other operating systems, but you may try to build your own packages locally according to our documentation:

Building FreeVPS Kernel
Building FreeVPS Tools

We will appretiate if you share your experience in building kernels on other platforms.

Other system requirements:

  • We recommend you to use only standard hardware in your FreeVPS boxes, because kernel packages we provide are compiled on standard kernel configuration.
  • If you use non-standard hardware devices, you need to recompile FreeVPS kernel to work properly with them.
  • FreeVPS is developed to run on Intel and Athlon processors. Multiprocessor systems also supported.
    It is reccomended to use SMP if you plan to intall 10-20 VPS servers on box.
    Cyrix and other CPUs are not recommended;
  • Separate disk partition for virtual servers, with enoth space on it, is required;
  • At least 512MB RAM on FreeVPS host server is advisable;
  • 3com or Intel ethernet interfaces are recommended;
  • RedHat installation should include the minimal set of packages, namely:
    standard Linux make tools, c++/gcc compiler, autoconf, base Perl.

 

Required Packages

The following packages should be installed:

Red Hat Linux release 7.3:

  • kernel-freevps, version 1.2, patched to support VPS:
    kernel-freevps-1.2-x package (x is the release number, e.g., 12).

    You need to choose sutable for your platform, processors count, memory capacity kernel.
    Note: For servers with RAM 1GB and more, we recommend to install the kernel-freevps-hugemem package (supports up to 64 GB of memory). If your server hardware is not standard, you will probably also need to install the kernel-freevps-unsupported package (not trusted by RedHat).

    The latest kernel releases can be found in the FreeVPS download area.

  • New modutils 2.4.25-11.EL or higher:
    modutils-2.4.25-11.EL.i386.rpm
    modutils-devel-2.4.25-11.EL.i386.rpm

  • New SysVinit, pam, pam-devel, vixie-cron packages:
    SysVinit-2.85-4.i386.rpm
    pam-0.75-51.i386.rpm
    pam-devel-0.75-51.i386.rpm
    vixie-cron-3.0.1-74.i386.rpm

  • FreeVPS tools:
    freevps-tools-1.2-6.i386.rpm

Red Hat Enterprise Linux ES release 3

  • kernel-freevps, version 1.2, patched to support VPS:
    kernel-freevps-1.2-x package.

    You need to choose sutable for your platform, processors count, memory capacity kernel.
    Note: For servers with RAM 1GB and more, we recommend to install the kernel-freevps-hugemem package (supports up to 64 GB of memory). If your server hardware is not standard, you will probably also need to install the kernel-freevps-unsupported package (not trusted by RedHat).

    The latest kernel releases can be found in the FreeVPS download area.

  • FreeVPS tools:
    freevps-tools-1.2-6.i386.rpm

 

Installation Procedure

  1. Enter the server console as root. The installation procedure requires reboot, therefore it is preferable to reboot from the server console so that you can reload from the old kernel if the problem with the new one occurs.

  2. Download the packages and put them into a separate directory, for example, to /root/inst:

    Red Hat Linux release 7.3:
    http://www.freevps.com/download/rpms/RH_73

    Red Hat Enterprise Linux ES release 3:
    http://www.freevps.com/download/rpms/RH_EL

    You can also build FreeVPS tools locally on your server.

  3. Install the packages in the following sequence:
    Note: You need to satisfy all dependences during installation.

    1) (RH 7.3 only) Update modutils:

    # rpm -Uvh modutils-2.4.25-11.EL.i386.rpm modutils-devel-2.4.25-11.EL.i386.rpm

    2) (RH 7.3 only) Update SysVinit, pam, pam-devel, vixie-cron packages:

    # rpm -Uvh SysVinit-2.85-4.i386.rpm pam-0.75-51.i386.rpm pam-devel-0.75-51.i386.rpm vixie-cron-3.0.1-74.i386.rpm

  4. Install the new kernel package.
    Note: Skip this step if you have the latest kernel release.

    1) Install the new kernel package kernel-freevps-1.2-x.

    2) Go to the /boot directory to check if the kernel update takes place:

    # cd /boot
    # ls -la

    The new kernel is vmlinuz-2.4.21-freevps-1.2-x.
    The old one would look like vmlinuz-2.4.18-3 or vmlinuz-2.4.21-4.EL.

    3) Modify the boot loader, (a) for GRUB or (b) for LILO:

    (a) GRUB: Edit the /boot/grub/grub.conf configuration file/

    Note: GRUB loader may automatically update its configs. In such case you need to change the default boot image.

    # vi /boot/grub.conf

    The file should look like this:

    Red Hat Linux release 7.3:

    default=0
    timeout=10
    splashimage=(hd0,0)/grub/splash.xpm.gz
    title Red Hat Linux (2.4.21-freevps-1.2-31)
                  root (hd0,0)
                  kernel /vmlinuz-2.4.21-freevps-1.2-31 ro root=/dev/sda5
                  initrd /initrd-2.4.21-freevps-1.2-31.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
    

    Red Hat Enterprise Linux release 3:

    default=0
    timeout=10
    splashimage=(hd0,0)/grub/splash.xpm.gz
    title Red Hat Enterprise Linux ES (2.4.21-freevps-1.2-31)
                  root (hd0,0)
                  kernel /vmlinuz-2.4.21-freevps-1.2-31 ro root=/dev/sda5
                  initrd /initrd-2.4.21-freevps-1.2-31.img
    title Red Hat Enterprise Linux ES (2.4.21-4.EL)
                  root (hd0,0)
                  kernel /vmlinuz-2.4.21-4.EL ro root=/dev/sda5
                  initrd /initrd-2.4.21-4.EL.img
    

    default=0 means that GRUB would take the first title record as the boot image, i.e., our new kernel.

    GRUB loader would update the kernel automatically after reboot.

    (b) LILO:
    Step 1: Modify the lilo.conf configuration file:

    # vi /etc/lilo.conf

    Copy and paste the kernel image settings lines and change the kernel number and the label parameter. Change the default kernel loading parameter to the new kernel label name.

    Important! Do not delete the old kernel image settings! If you delete these lines and something goes wrong with the new kernel installation, your system would not start!

    After these changes, lilo.conf would look like:

    Red Hat Linux release 7.3:

    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.2-31
            label=linux_patched
            initrd=/boot/initrd-2.4.21-freevps-1.2-31.img
            read-only
            root=/dev/sda5
    

    Red Hat Enterprise Linux release 3:

    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.21-4.EL
            label=linux
            initrd=/boot/initrd-2.4.21-4.EL.img
            read-only
            root=/dev/sda5
    
    image=/boot/vmlinuz-2.4.21-freevps-1.2-31
            label=linux_patched
            initrd=/boot/initrd-2.4.21-freevps-1.2-31.img
            read-only
            root=/dev/sda5
    

    Step 2: Type lilo to apply changes:
    # lilo
    You will see the line:
    Added linux
    Added linux_patched *

    4) Reboot the server:

    # shutdown -r now

    5) Check if the kernel update takes effect:

    # uname -a

    If the kernel version is 2.4.21-freevps-1.2-x, the kernel is patched successfully.

    6) Install FreeVPS tools.

    If you are not going to install H-Sphere VPS, download the basic FreeVPS tools package from the FreeVPS download area:

    # wget http://www.freevps.com/download/freevps-tools/freevps-tools-1.2-6.i386.rpm

    If you install H-Sphere VPS, you need to download special FreeVPS tools for H-Sphere VPS from the PSoft site:

    RedHat 7.3:
    # wget http://www.psoft.net/shiv/HS/VPS/RH73/freevps-tools-1.2-6.i386.rpm
    RedHat EL 3:
    # wget http://www.psoft.net/shiv/HS/VPS/RHEL/freevps-tools-1.2-6.i386.rpm

    Then, install the package:

    # rpm -ivh freevps-tools-1.2-6.i386.rpm



Home   Downloads   Docs   FAQ   News  Partners   Contact
© Copyright 1998-2006. Positive Software Corporation.
All rights reserved.