Appendix B. Installation Script Options

Parallels H-Sphere installation is performed by a script that brings about more flexibility in the process of installation and introduces a variety of advanced features and improvements.

Before running Parallels H-Sphere installer:

Download the install script. For example, for Parallels H-Sphere 3.2 Patch 2 run under root on Linux box:
# wget http://download.hsphere.parallels.com/shiv/HS/releases/U32.0/U32.0P2/U32.0P2
Run script the script in the install mode:
# sh U32.0P2 install

You will get the list of installation modes, each having its own options.

(1) install -- Full installation mode. Requires prepared config.xml with Parallels H-Sphere cluster configuration.

(2) cpinstall -- Control Panel installation mode. Afterwards, log into Parallels H-Sphere Control Panel Web interface, go through Pre-Configuration wizard, and then complete installation in mode (3).

(3) postinstall -- post-installation Parallels H-Sphere cluster configuration, to be run after mode (2).

(4) sitestudio -- install Parallels SiteStudio on the Control Panel box.

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

Install Modes:

install - Parallels H-Sphere installation from the prepared config.xml file with configuration of Parallels H-Sphere cluster to be installed. config.xml contains information about Parallels H- Sphere physical and logical servers, with root passwords to physical server where Parallels H-Sphere is to be installed (see sample config.xml at http://download.hsphere.parallels.com/HSdocumentation/xmls/config.xml). During the installation this file is temporarily stored in the ~cpanel/.settings directory. You can also use the cpinstall mode and run Parallels H-Sphere Pre-Configuration Wizard in admin CP to create and import/export config.xml.
install xml=CONFIG_XML [ skip-sitestudio ] [ url=Link ] [ mirror=mirror_number ]
cpinstall - install only system PostgreSQL and packages to be able to run Control Panel. Later on, you need to log into admin CP and go through Parallels H-Sphere Pre-Configuration Wizard to shape your Parallels H-Sphere cluster, and finally, run the installer in the postinstall mode.
cpinstall zone=SERVICE_ZONE ip=IP1 [ ip2=IP2 ] [ natip=NAT_IP ] [ mask=MASK ] [ url=Link ] [ mirror=mirror_number ]
postinstall - run this mode to complete Parallels H-Sphere installation after cpinstall and after adding servers and services in the Parallels H-Sphere Pre-Configuration mode in admin CP.
postinstall
sitestudio - install Parallels SiteStudio on the Control Panel box.
sitestudio [ url=Link ] [ mirror=mirror_number ]

Where:

Obligatory Parameters:

xml - the path to config.xml file. This path should not be /hsphere/shared/etc/config.xml
zone - service domain name (e.g., samplehosting.com).
ip - service zone IP - IP of Control Panel box.

Optional parameters:

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.
skip-sitestudio - install Parallels H-Sphere without Parallels 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).
url - alternative path to package download, this option differs from 'mirror', which includes predefined list of the maintained HS mirrors. Package lists are downloaded from default location or mirror, pointed via mirror option. (Default path is http://download.hsphere.parallels.com/shiv/HS)
mirror - allows setting another mirror instead of the default one. At this moment available the following HS servers: [0] - download.hsphere.parallels.com (USA, default) and [1] - download2.hsphere.parallels.com (Europe).