Parallels H-Sphere Documentation System Administrator Guide

 

Winbox 2.3.2 Installation

 
 

Related Docs:   Winbox Pre-Installation Guide Versions H-Sphere 2.3.2 Installation

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.

The HSInst232P5.exe program installs H-Sphere to winbox and configures all required software (Download HSInst232P5.exe). It is organized in the form of a wizard. During the installation you will have to set below parameters that determine the behavior of your H-Sphere Windows box. Some of these parameters are predetermined by the installation program and can be left unchanged. If you are unsure about setting any of the parameters, it is also advisable to leave them as they are. You can stop the installation wizard at any time.

Download HSInst232P5.exe

 

Step 1. Customization of Third-party Additional Systems Integrable with H-Sphere Installed on the Winbox

Prior to installing H-Sphere, make sure to have all third party products installed on the Winbox, or else you will have to configure corresponding parameters in the conf.inc file. Currently, H-Sphere integrates with the following systems:

Check the boxes next to the systems already installed on the box:

Step 2. Setting General Parameters

  • Company name: enter your company name which will be displayed in index.html and login.html files and used in every newly created website.
  • H-Sphere control panel URL: enter your H-Sphere control panel URL. This value will also be used in index.html and login.html files as links to the H-Sphere control panel.
  • SiteStudio is used as a site builder: check the box if you would like to have SiteStudio integrated with HSphere. After you have done that, enter your SiteStudio URL in the SiteStudio URL field, e.g.: http://65.219.197.236:8080/studio/servlet/psoft.masonry.Builder. This URL is also used in the index.html and login.html files.
  • Network interface: if you have several net interfaces, choose the one that you intend to use for hosting services.
  • Read config on the fly: check the box if you want H-Sphere service to read the changes in the conf.inc configuration file immediately after they have been made. If you leave the box unchecked, you will have to restart H-Sphere Windows Service each time you make any changes in this file to make it reread them.
  • Use separate users' group: check the box if you want each new H-Sphere user to be created in a local group (its name can be set in the H-Sphere control panel). If you leave the box blank, H-Sphere users will be created in the Users built-in group.
  • Rotate by: select the rotation type of internal H-Sphere log files.
    • The Size option will rotate the log files when the current file reaches the set limit.
    • The Period option will rotate the log files every specified number of hours.

Step 3. Setting Web Parameters

  • Path to the FrontPage Server extensions admin program: enter the full path to the program which administrates FrontPage server extensions.
  • Web application isolation level: select the isolation level of H-Sphere users' web programs. We recommend to set the web application isolation level to medium during the installation.


Step 4. Configuration of ActivePerl Parameters

This step is omitted if you have not specified ActivePerl as an installed system on step 1 .

Enter the full path to the directory where ActivePerl is located.

Step 5. Configuration of Miva Parameters

This step is omitted if you have not specified Miva as an installed system on step 1 .

  • Miva Empresa directory: enter the full path to the directory where Miva Empresa is located.
  • Miva Merchant directory: enter the full path to the directory where Miva Merchant is located.

If you have Miva commerce libraries, check the box and fill in the field.

  • Miva commerce libraries directory: enter the full path to the directory where commerce libraries are located.

Step 6. Configuration of PHP Parameters

This step is omitted if you have not specify PHP as an installed system on step 1 .

Enter the full path to the directory where PHP is located.

Step 7. Setting Webalizer Parameters

This step is omitted if you have not specified Webalizer as an installed system on step 1 .

Enter the complete path to the directory where Webalizer is located.

Step 8. Configuration of Microsoft SQL Server Parameters

This step is omitted if you have not specified MSSQL as an installed system on step 1 .

  • MSSQL server name or IP address: enter the NetBIOS name or the IP address of the computer on which MSSQL server is installed. This can be 'localhost'.
  • MSSQL server admin login: enter the administrator of MSSQL server login. It is used by the installation program to connect to the server.
  • MSSQL password: enter the password to the administrator's login entered in the previous field.
  • HSphere login for MSSQL: enter the login which will be generated by the installation program as additional MSSQL server administrator login to to be used by H-Sphere to connect to this MSSQL server.
  • HSphere password: enter the password for the login entered in the previous field.

Step 9. Setting Urchin Parameters

This step is omitted if you have not specified Urchin as an installed system on step 1 .

Enter the complete path to the directory where Urchin is located.

Step 10. FTP Server type choosing

This step is omitted if Serv-U FTP server is not installed.

  • Choose FTP server which will be used for hosting: select one of IIS or Serv-U.

Step 11. Configuration of Installation Parameters

  • Scripts account name: enter the name of the user's account which will be used when accessing H-Sphere scripts and under which they will be performed (hsadmin by default). This account will be created to the local "Administrators" built-in group. This user's name must be used when configuring Windows box for the H-Sphere control panel.
  • Scripts account password: enter the user's account password.
  • Default H-Sphere website: select the webhost where the H-Sphere scripts will be installed. If you want to create a new website, select the New... item.
  • Guest FTP site: select FTP site which will be used by H-Sphere users to access their homedirs by FTP.
  • H-Sphere directory: enter the full path to the directory where you intend to install H-Sphere. H-Sphere is by default installed to C:\HSphere.
  • Users home directory: enter the full path to the directory where the users' home directories will be located.
    Note: We recommend placing user content to another partition, for example, to D:\HShome. See Winbox hardware requirements.
  • Web and FTP logs directory: enter the full path to the directory where the sites' web and ftp log files will be located.
  • Change: check the box if you want to change the name of virtual directory where H-Sphere scripts will be located.
  • H-Sphere scripts virtual directory name: enter the name for the directory where H-Sphere scripts will be located. Virtual directory with this name will be created on the website chosen as the default H-Sphere website.

Step 12. Creating New Default Website

This step can be omitted if you have chosen one of the existing websites as the default H-Sphere website on the previous step.

New webhost description: enter the name of a new webhost which will be displayed in the webhost list.

New webhost IP address: select the IP address for a new webhost. Note that a new webhost will be created under a "white" hostname, which enables it to be a default webhost for this IP. That is why we should be sure that there is not any webhost by default on this IP and 80 port.

Step 13. Finishing the Installation

When all parameters are set, click the Finish button to start the installation.

Start service after the installation: check the box if you want the installation program to start H-Sphere service immediately after it has been installed.

Step 14. Adding Servers

Now that you have completed the installation, go to the admin control panel and add the box to H-Sphere.

To verify your windows box, click the view icon next to the physical server link. You will get server info if the server has been added to your cluster. Plan wizard will be activated automatically.

Read additional info about MSSQL server integration with H-Sphere.


Related Docs:   Winbox Pre-Installation Guide Versions H-Sphere 2.3.2 Installation



© Copyright 2014. Parallels Holdings. All rights reserved.