Parallels H-Sphere Documentation System Administrator Guide


Mirror Servers for HS Install/Update


Related Docs:   H-Sphere Update H-Sphere Updater/Installer Options

Last modified: 27 Dec 2007


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.

If you have 2 and more boxes with the same operating system or you want to speed up package downloads, you can create a mirror server and set an alternative URL for package downloads in updater.

Important: Since H-Sphere 3.0, we introduce (Europe) as an alternative location for PSoft documentation, installation and update scripts and packages.

You will be able to choose for H-Sphere installation or update by setting the mirror parameter to [1] in the install/update script. You can also download H-Sphere system packages manually from and its respective subdirectories.

On our website we have created a directory hierarchy for supported OS:

This hierarchy is formed by the cron script on based on files with package listing (pkglist, sspkglist, subpkglist, pkglist.priv) for all H-Sphere versions HS 2.5.0/HS 3.0 accordinlgy.

To create a mirror:

  1. Configure apache on the box to be used as a mirror (example):
    URL: will correspond to DocumentRoot: /var/www/
  2. Specify the OSCODE (the code of the operating system) you are configuring mirror for. To do this, run on every HS cluster box:


  3. Create corresponding sub-directories in DocumentRoot for the OSCODE(s) you arrange mirroring for.
    For instance, if you have to create mirroring for boxes with OSCODE RHES4 i FBSD54, run:

    mkdir -m 0755 /var/www/
    mkdir -m 0755 /var/www/

  4. Create corresponding cron tasks. For instance, mirroring for boxes with RHES4 and FBSD54 oscode for HS 3.0:
    0 5 * * * (cd /var/www/; wget --mirror --limit-rate=45k -np -nH --cut-dirs=7 -erobots=off
    0 5 * * * (cd /var/www/; wget --mirror --limit-rate=45k -np -nH --cut-dirs=7 -erobots=off

    Note: you can change the wget format. For instance, if you don't have VPS servers, you can run wget with --reject=hsphere-vps parameter (--reject=LIST sets comma-separated list of rejected extensions).

  5. On all boxes where mirror server will be used, execute:

    echo '' >/hsphere/shared/etc/mirror


  • If you want to cancel mirroring and download packages from server, run:

    rm -f /hsphere/shared/etc/mirror

  • Package lists (pkglist, sspkglist, subpkglist, pkglist.priv) are downloadable mainly from

Related Docs:   H-Sphere Update H-Sphere Updater/Installer Options

© Copyright 2018. Parallels Holdings. All rights reserved.