H-Sphere VPS Versions


Updating H-Sphere VPS To 1.5-4

(manual procedure - all supported H-Sphere versions or non H-Sphere boxes)

08 Feb 2007

Features   |   Install   |   Update


This document is the step-by-step instruction of manually (i.e., not by means of H-Sphere update script) upgrading a VPS hosting box.

Note: In H-Sphere 2.5 RC 2 and up it is preferable to update the server by means of automatically by H-Sphere updater.

Note: H-Sphere VPS 1.5 and up comes under the GPL license and is admissible for installation on non H-Sphere boxes.

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. Update H-Sphere VPS on the VPS Box

Update procedure is different for H-Sphere 2.5 and up and for H-Sphere before 2.5 or on non H-Sphere boxes.

 

H-Sphere 2.5 and up

Run H-Sphere update script for your version of H-Sphere to update H-Sphere VPS. Please refer to H-Sphere Updater 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-8
  • FreeVPS tools: freevps-tools-1.4-6
  • H-Sphere VPS: hsphere-vps-1.5-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.

 

H-Sphere 2.4.x or non H-Sphere boxes

  1. Download the following packages:

    RH73
    RHEL3
    RHEL4
    TRUSTIX22
    Location: http://www.psoft.net/shiv/HS/VPS/RH73/

    hsphere-perl-1-8.rpm
    hsphere-vps-install-0.7-0.noarch.rpm
    hsphere-vps-1.5-4.noarch.rpm
    hsphere-scripts-0.2-1.vps.noarch.rpm
    hsphere-sudo-1.6.8p12-2.rpm
    hsphere-script-runner-1-10.rpm
    Location: http://www.psoft.net/shiv/HS/VPS/RHEL3/

    hsphere-perl-1-8.rpm
    hsphere-vps-install-0.7-0.noarch.rpm
    hsphere-vps-1.5-4.noarch.rpm
    hsphere-scripts-0.2-1.vps.noarch.rpm
    hsphere-sudo-1.6.8p12-2.rpm
    hsphere-script-runner-1-10.rpm
    Location: http://www.psoft.net/shiv/HS/VPS/RHEL4/

    hsphere-perl-1-8.rpm
    hsphere-vps-install-0.7-0.noarch.rpm
    hsphere-vps-1.5-4.noarch.rpm
    hsphere-scripts-0.2-1.vps.noarch.rpm
    hsphere-sudo-1.6.8p12-2.rpm
    hsphere-script-runner-1-10.rpm
    Location: http://www.psoft.net/shiv/HS/VPS/TRUSTIX22/

    hsphere-perl-1-8.rpm
    hsphere-vps-install-0.7-0.noarch.rpm
    hsphere-vps-1.5-4.noarch.rpm
    hsphere-scripts-0.2-1.vps.noarch.rpm
    hsphere-sudo-1.6.8p12-2.rpm
    hsphere-script-runner-1-10.rpm

    We recommend downloading these packages into a separate directory.

  2. Update the downloaded packages:

    1. Enter the directory with downloaded packages, and run rpm -Uv to update the H-Sphere VPS related package in the order they are listed in the table above, up to the hsphere-install package (including the latter):

      # rpm -Uv PACKAGE_FILE

    2. 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:
      Platform   i386
      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 FreeVPS documentation.

    3. Update the rest of the packages specified in the table list after the hsphere-install package:

      # rpm -Uv PACKAGE_FILE

 

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-8)
      root (hd0,0)
      kernel /vmlinuz-2.4.21-freevps-1.5-8 ro root=/dev/sda5
      initrd /initrd-2.4.21-freevps-1.5-8.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-8    label=linux_patched
        initrd=/boot/initrd-2.4.21-freevps-1.5-8.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-8.

 

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

(only in H-Sphere 2.5 and up)

Follow insructions on adding VPS network gateways.





See Also:

FreeVPS
H-Sphere Versions
H-Sphere Documentation
H-Sphere VPS (Sysadmin Guide)
H-Sphere VPS (Admin Guide)
H-Sphere VPS (User Guide)
   
Request VPS Installation



Copyright 1998-2017. Positive Software Corporation.
All rights reserved.