Parallels H-Sphere Documentation System Administrator Guide

 

SSE Installer/Updater Options

 
 

Related Docs:   Single Server Edition Master Key

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.

H-Sphere SSE 3.0 is installed and updated by a common script. This script brings about more flexibility in the process of installation, update and post-configuration.

Before running H-Sphere updater/installer:

  1. Log into the server where you install H-Sphere SSE as root:
  2. $ su -l
  3. Download the H-Sphere SSE install script (for instance, SSE 3.0):
    # wget http://www.psoft.net/shiv/HS/releases/U30.0/U30.0SSE/U30.0SSE
    Please make sure that permissions to /usr/bin/wget are set to 0755 during the installation.

  4. Run script with corresponding option:
    To update SSE, run the script in the update mode. You will get the list of update options, each having its own options.
    # sh U30.0SSE update
    To install SSE, run the script in the install mode. You will get the list of installation options, each having its own options.
    # sh U30.0SSE install

 

Installation Options

After running the script with install mode, you will get the below menu with the choice of update options:

                   H-SPHERE SSE INSTALLATION
====================================================================
(1) presingle  -- Single Server Edition installation package mode
                  (with/without SiteStudio installation).
                  (for more details, type '1').
====================================================================
(2) postsingle -- Single Server Edition installation deploy mode
                  (with/without SiteStudio installation).
                  Mode '1' must be executed beforehand.
                  (for more details, type '2').

If you want more info on every mode, simply type its number in the command line.

Install modes:

  • presingle: prepare a preconfigured H-Sphere SSE installation with a set of services (Web, mail, DNS, MySQL, MRTG) you need (with/without SiteStudio installation).
    presingle    [ skip-sitestudio ] [ group=cp,mail,unix_hosting,mysql,dns,mrtg ] [ url=Link ]
  • postsingle: Single Server Edition post-configuration. It will install and run post-configuration scripts to complete Single Server installation.
    postsingle   zone=SERVICE_ZONE ip=IP1  [ skip-sitestudio ]
                 [ group=cp,mail,unix_hosting,mysql,dns,mrtg ]
                 [ ip2=IP2 ] [ natip=NAT_IP ] [ mask=MASK ] [ url=Link ]

Obligatory parameters:

  • zone - service domain name (e.g., samplehosting.com).
  • ip - service zone IP - IP of Control Panel box.

Optional parameters:

  • skip-sitestudio - install H-Sphere without SiteStudio.
  • group - comma-separated list of logical servers to be installed. Possible groups: mail, web, dns, mysql, pgsql, cp, vps (using common ips and group tags is allowed).
  • ip2 - the IP of the second DNS logical server (ns2). If ip2 is not set, the ns2 logical server will not be created.
  • natip - the external server IP for NAT mapping.
  • mask - the network mask. If mask is not set, the default value (255.255.255.0) is used.
  • url=Link - alternative path for package download (instead of http://www.psoft.net/shiv/HS/)

 

Update Options

After running the script with update mode, you will get the below menu with the choice of update options:

                           UPDATE
=====================================================================
(1) hsupdate   -- update H-Sphere SSE, except SiteStudio.
                  (for more details, type '1').
=====================================================================
(2) update     -- update H-Sphere SSE including SiteStudio.
                  (for more details, type '2').
=====================================================================
(3) sitestudio -- update SiteStudio on the Control Panel box.
                  (for more details, type '3').
=====================================================================
(4) cpupdate   -- update H-Sphere SSE core and related packages only.
                  (for more details, type '4').

If you want more info on every mode, simply type its number in the command line.

  • hsupdate: update H-Sphere SSE without SiteStudio.

    hsupdate    [ help ] [ ips=IP1,IP2,.. ] [ group=lgroup1,lgroup2,... ]
                [ private ] [ strict ] [ nomd5 ] [ force ] [ skip=stage ] [ url=Link ]
  • update - update H-Sphere SSE togethet with SiteStudio.

    update      [ help ] [ ips=IP1,IP2,.. ] [ group=lgroup1,lgroup2,... ]
                [ private ] [ strict ] [ nomd5 ] [ force ] [ skip=stage ] [ url=Link ]
  • sitestudio - update SiteStudio.

    sitestudio  [ help ] [ ips=IP1,IP2,.. ] [ group=lgroup1,lgroup2,... ] [ url=Link ]
  • cpupdate - update only Control Panel packages, templates, jars, etc.

    cpupdate    [ help ] [ ips=IP1,IP2,.. ] [ group=lgroup1,lgroup2,... ] [ url=Link ]

Options description:

  • ips - specify comma-separated list of target boxes' IPs the update will be resricted to;
  • group - specify the list of comma-separated logical server groups to be affected by the update. Possible groups: mail, web, dns, mysql, pgsql, cp, vps (using common ips and group tags is allowed).
  • private - private update for testing purpose.
  • strict - form package list based exclusively on package list. By default, downgrade to older package version is skipped.
  • nomd5 - update is not critical for wrong md5 sum, only warning;
  • force - check md5 sum of the installed packages with the same version too, if wrong md5 sum, install new package by force;
  • skip=[check|preparing|update]
    • check - skip check-up and regeneration of the existing updater.
    • preparing - skip config.xml regeneration on boxes during update.
    • update - skip update steps.
  • url=Link - alternative path for package download (instead of http://www.psoft.net/shiv/HS/);

Related Docs:   Single Server Edition Master Key



© Copyright 2017. Parallels Holdings. All rights reserved.