Parallels H-Sphere 3.6.1 User guide

Category
Software
Type
User guide
Revision 1.0
Parallels H-Sphere 3.6.1 System
Administrator Guide
Legal and Copyright Notice
Parallels IP Holdings GmbH
Vordergasse 59
CH-Schaffhausen
Switzerland
Phone: +41-526320-411
Fax: +41-52672-2010
Copyright © 2012 Parallels IP Holdings GmbH. All rights reserved.
www.parallels.com
This product is protected by United States and international copyright laws. The product’s
underlying technology, patents, and trademarks are listed at
http://www.parallels.com/trademarks.
Microsoft, Windows, Windows Server, Windows NT, Windows Vista, and MS-DOS are
registered trademarks of Microsoft Corporation.
Linux is a registered trademark of Linus Torvalds.
Mac is a registered trademark of Apple, Inc.
All other marks and names mentioned herein may be trademarks of their respective owners.
Contents
Preface 11
Typographical Conventions ......................................................................................................... 11
Feedback ..................................................................................................................................... 12
About This Guide 13
Pre-configuration Wizard 14
Parallels H-Sphere config.xml ..................................................................................................... 17
Elements and Attributes .................................................................................................... 17
Software Used in Parallels H-Sphere 19
Integrated Third Party Products ................................................................................................... 20
Supplementary Software ............................................................................................................. 22
Used Libraries and Technologies ................................................................................................ 23
Update of Operating Systems 24
Updating FreeBSD Kernel ........................................................................................................... 25
Updating Linux ............................................................................................................................. 25
Linux Up2Date ................................................................................................................... 27
Linux Apt-Get..................................................................................................................... 27
Network Address Translation (NAT) 28
Configuring Newly Installed H-Sphere with NAT Support ........................................................... 29
Enabling NAT Support on a Live System .................................................................................... 30
Configuring NAT Firewall ............................................................................................................. 31
Migrating IPs with NAT ................................................................................................................ 31
Server Time Synchronization 32
NTP Time Servers ....................................................................................................................... 32
Cron Scripts 33
Control Panel Server Crons ......................................................................................................... 33
Web Server Crons ....................................................................................................................... 34
DNS Server Cron ......................................................................................................................... 34
Mail Server Crons ........................................................................................................................ 35
PostgreSQL/MySQL Server ........................................................................................................ 35
Traffic Calculation 36
Checking Traffic via Parallels H-Sphere Control Panel ............................................................... 37
Checking Traffic on Physical Servers .......................................................................................... 37
Preface 4
Processing Traffic by Crons ........................................................................................................ 38
HTTP traffic ....................................................................................................................... 38
User FTP traffic ................................................................................................................. 38
Virtual FTP traffic ............................................................................................................... 38
Mail traffic .......................................................................................................................... 38
Parsing Traffic by TrafficLoader .................................................................................................. 39
IP Migration (Changing IPs) 40
Changing IPs on Systems Without NAT ...................................................................................... 40
IP Migration Pre-requisites ................................................................................................ 41
IP Migration Map File ........................................................................................................ 42
Creating ipmigration.xml Manually .................................................................................... 43
Creating ipmigration.xml by Parallels H-Sphere IP Migrator ............................................. 43
IP Migration Step by Step .................................................................................................. 44
Changing External IPs on Systems with NAT ............................................................................. 49
Changing Internal IPs on Systems With NAT .............................................................................. 50
Configuring Parallels H-Sphere to Work on Two Sets of IPs ...................................................... 51
Restarting Services 52
Restarting Parallels H-Sphere Control Panel .............................................................................. 54
Restarting Parallels H-Sphere Database..................................................................................... 54
Restarting Web Server ................................................................................................................ 55
Restarting PostgreSQL Server .................................................................................................... 55
Restarting Mail Server ................................................................................................................. 57
Restarting MySQL Server ............................................................................................................ 57
Restarting Named ........................................................................................................................ 58
Control Panel Server 59
Understanding Control Panel Server Configuration .................................................................... 60
Installed Software .............................................................................................................. 60
Interaction Between Servers ............................................................................................. 61
Location of CP Files and Directories ................................................................................. 61
The Parallels H-Sphere Configuration File ........................................................................ 62
Control Panel Apache Server Configuration ..................................................................... 62
Control Panel Back-End Servlet Engine ........................................................................... 62
Reseller Configuration ....................................................................................................... 62
Reseller SSL Configuration ............................................................................................... 63
CP SSL Configuration ....................................................................................................... 63
CP Apache Log Files ......................................................................................................... 63
CP Traffic Calculation ........................................................................................................ 64
The Parallels H-Sphere System Database ....................................................................... 64
The System Database Settings ......................................................................................... 64
Logging into the System Database ................................................................................... 64
VACUUM Utility ................................................................................................................. 65
CP Mail Queue .................................................................................................................. 65
Logging in as the cpanel User ..................................................................................................... 66
Logging into Parallels H-Sphere System Database .................................................................... 66
Launching Control Panel Cron Jobs ............................................................................................ 66
CP Cron XML Configuration Files ..................................................................................... 67
Background Job Manager ................................................................................................. 67
Configuring Tomcat ..................................................................................................................... 67
Tomcat Configuration Files ............................................................................................... 68
Tomcat Log File ................................................................................................................. 68
Restarting Tomcat ............................................................................................................. 68
Customizing Tomcat Environment Variables .................................................................... 69
Preface 5
Running Java Command Line Tools ........................................................................................... 70
DNSCreator ....................................................................................................................... 71
IPMigratorFast ................................................................................................................... 72
PhysicalCreator ................................................................................................................. 73
PostApacheConfigs ........................................................................................................... 74
PostFTPConfigs ................................................................................................................ 74
ServerAliasesRenamer ..................................................................................................... 75
ChangeLServerId .............................................................................................................. 76
MIVAEmpresaFix............................................................................................................... 76
KeyPairGenerator .............................................................................................................. 77
PGPEncrypter.................................................................................................................... 77
PGPMessageSigner .......................................................................................................... 77
PGPMessageVerify ........................................................................................................... 78
RepostResellerSSLConfigs ............................................................................................... 78
ServiceZoneRenamer ....................................................................................................... 79
BillingEraser ...................................................................................................................... 79
SetQuota ........................................................................................................................... 80
UrchinReconfig .................................................................................................................. 80
OffLogs .............................................................................................................................. 81
Reset Balance ................................................................................................................... 82
RegenerateIpsFile ............................................................................................................. 83
LicenseExtractor ................................................................................................................ 83
MailRelayCorrector ............................................................................................................ 84
Securing Your CP Server with SSL ............................................................................................. 85
Disabling HTTP Access ..................................................................................................... 87
Switching Between IP and Domain Name ........................................................................ 88
Upgrading Java ............................................................................................................................ 88
Supported Versions ........................................................................................................... 88
Upgrade Procedure ........................................................................................................... 89
Converting Parallels H-Sphere System Database from MS SQL to PgSQL ............................... 91
Step 1. Convert Database from MSSQL Server to MySQL .............................................. 92
Step 2. Convert Database from MySQL Server to PgSQL ............................................... 93
Converting Parallels H-Sphere Database To UNICODE............................................................. 95
Accelerating Control Panel .......................................................................................................... 98
Parallels H-Sphere Java-related Issues ............................................................................ 98
Optimizing Parallels H-Sphere System Database ............................................................. 98
Troubleshooting ............................................................................................................... 104
Changing CP URL ..................................................................................................................... 104
Changing IP Address to Domain Name in CP URL ........................................................ 105
Changing Parallels H-Sphere Port .................................................................................. 106
Changing Entire CP URL ................................................................................................ 107
Setting Multiple Alternative CP URL's ............................................................................. 108
Migrating Control Panel Server ................................................................................................. 109
Generating SSH Keys for Parallels H-Sphere Servers ............................................................. 111
Encrypting Trouble Tickets ........................................................................................................ 112
Generating PGP Public Key and PGP Private Key ......................................................... 112
Enabling PGP Encryption In Your Support Center.......................................................... 113
Encrypting Texts With PGP Public Key ........................................................................... 113
Using Encrypted Parts in Trouble Tickets ....................................................................... 114
Customizing Domain Registration Lookup Script ...................................................................... 115
Web Server 116
Understanding Web Server Configuration ................................................................................. 117
FTP Server ...................................................................................................................... 118
SSL Implementation on Unix Web Servers ..................................................................... 123
Dedicated SSL................................................................................................................. 123
Shared SSL ..................................................................................................................... 123
Third Party Log Analyzers Integrated in Parallels H-Sphere .......................................... 124
Preface 6
WebShell ......................................................................................................................... 128
MnoGoSearch ................................................................................................................. 129
Parallels H-Sphere Jail .................................................................................................... 131
Preventing Manipulation with Logs Directory Permissions........................................................ 133
Altering Virtual Host Configuration ............................................................................................ 134
Calculating Web Traffic.............................................................................................................. 135
Using Third-Party Log Analyzers for Traffic Calculation ................................................. 136
Calculating Parallels H-Sphere Built-In Traffic ................................................................ 138
Adding Directories for User Homes ........................................................................................... 139
Installing Ruby on Rails ............................................................................................................. 139
Installing Chili!Soft ASP ............................................................................................................. 140
WORKFLOW ................................................................................................................... 140
Installing mod_perl..................................................................................................................... 147
Mail System 149
Understanding Parallels H-Sphere Mail .................................................................................... 150
Mail Package ................................................................................................................... 151
Included Software ............................................................................................................ 151
Webmails ......................................................................................................................... 152
IMAP Server .................................................................................................................... 155
Choosing Remote Web and MySQL Logical Servers for Horde Webmail Frontend ................. 157
Changing Mail Server Roles ...................................................................................................... 158
Blocking IPs on Mail Servers ..................................................................................................... 160
Adding Qmail Settings to IP/Subnet .......................................................................................... 160
Bouncing Mail ............................................................................................................................ 161
1. Separate IP for Sending Bounced Mail ....................................................................... 161
2. Processing Error Responses ....................................................................................... 162
3. Bounced Message Delivery ......................................................................................... 163
Configuring Qmail ...................................................................................................................... 163
Antivirus and Antispam Filters (SpamAssassin and ClamAV) ........................................ 164
Integrated Antispam Addons ........................................................................................... 167
Qmail Server Settings ..................................................................................................... 168
Command Line Qmail Configuration ............................................................................... 180
Syslog Facility/Level Configuration For rblsmtpd ............................................................ 180
SMTP Log ........................................................................................................................ 181
Mail Client and ESMTP Destination Server .................................................................... 182
Qmail-spp Support .......................................................................................................... 183
Qmail TLS Support .......................................................................................................... 184
Integrated Plugins ........................................................................................................... 184
Choosing Remote MySQL Logical Server for SpamAssassin................................................... 185
SPF and SRS ............................................................................................................................ 186
SPF (Sender Policy Framework) ..................................................................................... 187
SRS (Sender Re-write Scheme) ..................................................................................... 189
Updating SpamAssassin Rulesets Automatically ...................................................................... 189
Sa-update Script .............................................................................................................. 190
Rules Du Jour Script ....................................................................................................... 190
Migrating Mail Server/IP ............................................................................................................ 194
Moving Mail Domains ................................................................................................................ 197
Calculating Mail Traffic .............................................................................................................. 198
Mail Traffic Log ................................................................................................................ 200
POP3 and IMAP Traffic ................................................................................................... 201
Web Mailing List Traffic ................................................................................................... 201
SpamGuard Setup ..................................................................................................................... 202
DNS Server 203
DNS Config Files ....................................................................................................................... 204
Parallels H-Sphere DNS Zones ....................................................................................... 204
Preface 7
Custom DNS Zones ........................................................................................................ 204
Reverse DNS ................................................................................................................... 205
Restarting Named ...................................................................................................................... 206
Bind 9.3 ...................................................................................................................................... 206
New Features .................................................................................................................. 207
Restarting Bind ................................................................................................................ 207
Using rndc ....................................................................................................................... 208
Adding DNS Servers.................................................................................................................. 209
Configuring Single DNS ............................................................................................................. 209
Installing and Configuring MyDNS ............................................................................................. 211
Installation ....................................................................................................................... 211
Uninstallation ................................................................................................................... 212
Migrating DNS from Bind to MyDNS ......................................................................................... 212
Moving DNS ............................................................................................................................... 213
Removing Broken DNS Zones .................................................................................................. 215
Removing User Domain Zone ......................................................................................... 217
Removing Service Domain Zone..................................................................................... 218
Using DNS Creator .................................................................................................................... 219
MySQL Server 220
Installing MySQL Server ............................................................................................................ 221
Backing Up MySQL Database ................................................................................................... 221
Running Parallels H-Sphere MySQL Scripts ............................................................................. 222
Getting Remote Access to MySQL Logical Server .................................................................... 223
Enabling Linked Tables in phpMyAdmin ................................................................................... 224
Changing MySQL Root Password ............................................................................................. 225
Option 1 ........................................................................................................................... 226
Option 2 ........................................................................................................................... 227
Moving MySQL .......................................................................................................................... 228
Step 1. Preparing Servers ............................................................................................... 228
Step 2. Moving MySQL Content ...................................................................................... 229
Step 3. Updating System Database ................................................................................ 229
Step 4. Updating Resellers' Server Aliases ..................................................................... 229
Step 5. Synchronizing MySQL Content ........................................................................... 230
Step 6. Finalizing the Migration ....................................................................................... 230
Step 7. Checking Functionality ........................................................................................ 231
Moving MySQL Accounts .......................................................................................................... 231
PostgreSQL Server 233
Configuring PostgreSQL ............................................................................................................ 234
Backing Up PostgreSQL Database ........................................................................................... 235
Using VACUUM Utility ............................................................................................................... 235
Running PostgreSQL Scripts ..................................................................................................... 236
Changing Postgres User Password ........................................................................................... 237
Localizing PostgreSQL .............................................................................................................. 238
Moving PostgreSQL................................................................................................................... 238
Configuring Parallels H-Sphere to Use Non-Default MySQL/PostgreSQL Versions ................ 239
Choosing Remote Web Logical Servers for phpMyAdmin/phpPgAdmin Frontends ................. 240
Downgrading Postgres .............................................................................................................. 242
Windows Servers 243
MSI Packages ............................................................................................................................ 244
Download and Installation ............................................................................................... 245
Packages Requiring Third-party Software ...................................................................... 246
Dependencies Tree ......................................................................................................... 246
Preface 8
Winbox Directory Structure ........................................................................................................ 247
HSphere .......................................................................................................................... 247
HShome ........................................................................................................................... 248
HSlogfiles ........................................................................................................................ 249
Restarting Winbox Service ........................................................................................................ 249
Restarting IIS ............................................................................................................................. 250
Enabling Winbox Shared SSL ................................................................................................... 250
Integrating Winbox Shared SSL ...................................................................................... 251
Updating Winbox Shared SSL ......................................................................................... 251
Winbox Statistics ....................................................................................................................... 252
Statistics Modules ........................................................................................................... 253
Setting Up SharePoint to Use MSSQL Server .......................................................................... 255
Preinstallation Requirements .......................................................................................... 255
Installing and Configuring SharePoint ............................................................................. 256
Adding ODBC Resource ............................................................................................................ 259
Interface ........................................................................................................................... 260
Configuration ................................................................................................................... 265
Configuring ColdFusion ............................................................................................................. 267
Specifying Default ASP.NET Version ........................................................................................ 268
Enabling ASP.NET 4.0 .............................................................................................................. 268
Moving Log Files ........................................................................................................................ 269
Removing Old Log Files ............................................................................................................ 270
Moving User Homes .................................................................................................................. 271
Changing hsadmin Login and Password ................................................................................... 271
Winbox IP Migration................................................................................................................... 272
Step 1. Bind Target IPs on Winbox ................................................................................. 272
Step 2. Add Double Bindings on IIS ................................................................................ 273
Step 3. Create Migration XML ......................................................................................... 273
Step 4. Run the Migration ................................................................................................ 274
Step 5. Remove Old IP Bindings on IIS .......................................................................... 274
Winbox Security Scheme .......................................................................................................... 275
Accounts Hierarchy ......................................................................................................... 276
IIS Security Management ................................................................................................ 277
NTFS permissions ........................................................................................................... 278
FrontPage Server Extensions Management Notes ......................................................... 278
ASP.NET Management Notes ......................................................................................... 279
Migration Notes ............................................................................................................... 279
Recovery Notes ............................................................................................................... 279
Calculating Winbox Traffic ......................................................................................................... 280
Microsoft SQL Server 281
Installing Microsoft SQL 2005 Server ........................................................................................ 282
Moving MS SQL Databases Across Servers ............................................................................. 283
Moving MS SQL Databases to a New Location ........................................................................ 284
Dedicated Servers 290
Configuring MRTG ..................................................................................................................... 291
Managing MRTG Service ................................................................................................ 291
Configuration Directory and File ...................................................................................... 291
Scripts Processing Data .................................................................................................. 291
RRD Files ........................................................................................................................ 292
The Problem with Calculating Large (>100mbps) Bandwidth Traffic .............................. 292
System Packages 293
Common Packages ................................................................................................................... 293
Preface 9
hsphere-info: Collecting Information About Parallels H-Sphere Servers into XML Configs294
hsphere-update Package ................................................................................................ 295
upackages Syntax ........................................................................................................... 295
Parallels H-Sphere Perl Modules .................................................................................... 297
Parallels H-Sphere Apache ............................................................................................. 299
Parallels H-Sphere PHP .................................................................................................. 310
Parallels SiteStudio Packages ................................................................................................... 321
Load Balancing 322
Load Balancers................................................................................................................ 324
Supported NAS................................................................................................................ 324
Load Balanced Cluster .................................................................................................... 324
Implementation of Load Balanced Cluster in Parallels H-Sphere ............................................. 325
Load Balanced Cluster in CP .......................................................................................... 326
Distribution of Requests Across Load Balanced Cluster ................................................ 326
Shared Content ............................................................................................................... 326
Specific Master/Slave Content ........................................................................................ 327
Synchronization Between Master and Slave Servers ..................................................... 327
Traffic Calculation ............................................................................................................ 328
Load Balanced Cluster Map ............................................................................................ 329
NAT Configuration for Load Balanced Clusters .............................................................. 330
Load Balancing Support in Parallels H-Sphere ......................................................................... 331
Installing Load Balanced Web/Mail Clusters in Parallels H-Sphere .......................................... 331
Step 1. Install and Configure Load Balancer ................................................................... 332
Step 2. Prepare NAS ....................................................................................................... 333
Step 3. Prepare Master and Slave Web/Mail Boxes ....................................................... 338
Step 4. Install Parallels H-Sphere to Load Balanced Parallels H-Sphere Clusters ........ 340
Quota Managers ........................................................................................................................ 341
Resources Migration 342
Migratable Resources ..................................................................................................... 342
Migration Procedure .................................................................................................................. 343
Step 1. Create XML File Containing User Data .............................................................. 343
Data Type Definitions ...................................................................................................... 346
DTD Chart ....................................................................................................................... 346
Attributes Description ...................................................................................................... 346
Files ................................................................................................................................. 348
XML Validation ................................................................................................................ 349
Step 2. Create XML File Containing Reseller Plan Data ................................................ 349
Step 3. Prepare The Target Control Panel ...................................................................... 355
Step 4. Create Reseller Plans ......................................................................................... 355
Step 5. Create Resellers ................................................................................................. 355
Step 6. Create End Users ............................................................................................... 356
Troubleshooting ............................................................................................................... 356
Backup and Recovery 357
Backing Up Parallels H-Sphere Control Panel Server .............................................................. 358
System DB Dump ............................................................................................................ 359
Parallels H-Sphere Backup and Recovery List ......................................................................... 359
Recovering Parallels H-Sphere Control Panel .......................................................................... 361
Step 1. Prepare for the Recovery .................................................................................... 361
Step 2. Recover System Data ......................................................................................... 361
Files and Directories To Be Recovered .......................................................................... 362
Recovering Unix Hosted Parallels H-Sphere Servers ............................................................... 363
Step 1. Prepare Crashed Server for Recovery ............................................................... 364
Preface 10
Step 2. Run Parallels H-Sphere Updater ........................................................................ 364
Step 3. Run the Recovery Tool ....................................................................................... 364
Step 4. Restore User Content ......................................................................................... 365
Restoring Files and Directories from Backup ............................................................................ 366
Restoring the Parallels H-Sphere System Database From Backup .......................................... 366
Restoring the Parallels H-Sphere Database on a Server with PostgreSQL Not Installed368
Restoring the Parallels H-Sphere Database Content if PostgreSQL Is Installed: ........... 369
Fixing Crashed Parallels H-Sphere Database ........................................................................... 370
Backing Up Winbox ................................................................................................................... 371
Backing Up the Metabase ............................................................................................... 372
Backing Up MS SQL Databases ..................................................................................... 372
Backing Up User Content ................................................................................................ 372
Recovering Winbox.................................................................................................................... 373
Step 1. Back Up User Content ........................................................................................ 373
Step 2. Install Parallels H-Sphere ................................................................................... 374
Step 3. Set Up Dedicated IPs .......................................................................................... 374
Step 4. Prepare Target Winbox for Physical Creator ...................................................... 374
Step 5. Run PhysicalCreator on the CP Box ................................................................... 375
Step 6. Restore Content from Backup ............................................................................ 376
Step 7. Install Shared SSL .............................................................................................. 377
Step 8. Set Correct NTFS Permissions and Owner for the Home Directory .................. 378
Recovering Winbox Quota ......................................................................................................... 379
Miva 380
Miva Installation for *nix ............................................................................................................. 380
Requirements .................................................................................................................. 380
Miva Empresa Installation ............................................................................................... 381
Miva Merchant Installation ............................................................................................... 384
Miva Installation for Windows .................................................................................................... 385
Updating Miva 4 to Miva 5 ......................................................................................................... 386
Urchin 387
Urchin 4 and 5 Installation on Unix ............................................................................................ 388
Urchin 4 and 5 Installation on Windows .................................................................................... 390
Urchin 4 And Urchin 5 Database Utilities .................................................................................. 391
Urchin Database Utilities ................................................................................................. 391
Urchin Database Tables .................................................................................................. 391
RealServer 394
RealServer Installation for Unix ................................................................................................. 395
RealServer Installation for Windows .......................................................................................... 401
RealServer Config File Example ............................................................................................... 401
Softaculous 409
Softaculous Installation for UNIX ............................................................................................... 410
In this chapter:
Typographical Conventions ............................................................................... 11
Feedback .......................................................................................................... 12
Typographical Conventions
Before you start using this guide, it is important to understand the documentation
conventions used in it.
The following kinds of formatting in the text identify special information.
Formatting convention
Type of Information
Example
Special Bold
Items you must select,
such as menu options,
command buttons, or
items in a list.
Go to the System tab.
Titles of chapters,
sections, and
subsections.
Read the Basic
Administration chapter.
Italics
Used to emphasize the
importance of a point, to
introduce a term or to
designate a command
line placeholder, which is
to be replaced with a real
name or value.
The system supports the
so called wildcard
character search.
Monospace
The names of
commands, files,
directories, and domain
names.
The license file is located
in the
http://docs/common/
licenses directory.
C H A P T E R 1
Preface
12 Preface
Preformatted
On-screen computer
output in your command-
line sessions; source
code in XML, C++, or
other programming
languages.
# ls –al /files
total 14470
Preformatted
Bold
What you type,
contrasted with on-screen
computer output.
# cd /root/rpms/php
CAPITALS
Names of keys on the
keyboard.
SHIFT, CTRL, ALT
KEY+KEY
Key combinations for
which the user must
press and hold down one
key and then press
another.
CTRL+P, ALT+F4
Feedback
If you have found a mistake in this guide, or if you have suggestions or ideas on how to
improve this guide, please send your feedback using the online form at
http://www.parallels.com/en/support/usersdoc/. Please include in your report the
guide's title, chapter and section titles, and the fragment of text in which you have found
an error.
Welcome to the Parallels H-Sphere System Administrator Guide. It aims at system
administrators and explains how to install, configure and maintain Parallels H-Sphere
and its components.
C H A P T E R 2
About This Guide
This document explains how to shape your Parallels H-Sphere cluster, add boxes and
hosting services and configure basic Parallels H-Sphere settings after Control Panel
installation.
C H A P T E R 3
Pre-configuration Wizard
Pre-configuration Wizard 15
Parallels H-Sphere Pre-Configuration Wizard writes the cluster configuration into the
specially formatted config.xml file (download sample config.xml from
http://hsphere.parallels.com/HSdocumentation/xmls/config.xml). The Configuration File
form on the main page enables you to:
 Import: You upload the prepared XML file from a local machine to Parallels H-
Sphere and later reconfigure Parallels H-Sphere in the wizard.
 Export: export config.xml with your Parallels H-Sphere cluster configuration to
your local machine.
 Restore to Default: choose this option to recreate config.xml and to restart
configuring Parallels H-Sphere cluster in the wizard.
 To complete the pre-configuration wizard:
1. Click the Edit General Settings icon on the right corner of the General Settings
caption and fill in the data on the page that appears:
 System Domain: Specify the service domain name here.
 One Server Installation: check this box if you need a single server installation.
 Use NAT IP mapping: Check this box if you implement NAT (on page 28) on your
Parallels H-Sphere.
Press Submit and return to the main page of the wizard.
2. If you choose multiple server installation mode, you will see the Add
Physical Server icon on the right corner of the Physical Servers caption. Click
this icon and proceed to the form for adding new physical servers and
services.
Here you set physical server name, IP, root password to connect to, and choose
which hosting services (CP, Web, mail, DNS, MySQL, PostgreSQL) will be installed
there.
Note: At the moment, VPS, Windows, MRTG are not installed via Parallels H-
Sphere pre-configuration wizard.
Choose Use defaults for this server to apply default names for Parallels H-Sphere
logical servers on this server. By default, they are named webN, mailN, nsN, mailN,
mysqlN, respectively.
3. After you have added physical servers into Parallels H-Sphere cluster,
you will see them on the main page of the wizard.
Click the Edit icon in front of a physical server in the list and edit logical server
parameters. More on Logical Servers read in Parallels H-Sphere Service
Administrator Guide.
4. After you have done with Parallels H-Sphere configuration, press
Proceed Installation Wizard.
5. You will be taken to the Confirm Installation page. To complete installation
via CP web interface, click Yes, continue
6. On the page that appears check the servers you want to be
updated/installed and click Start.
To see the update log, click the server name link.
16 Pre-configuration Wizard
7. When update is finished and the light turns green, click Proceed to
complete installation.
8. On the page that appears, click Return to Admin CP.
You will be taken to the administrator control panel where you can maintain your
hosting business.
In this chapter:
Parallels H-Sphere config.xml ........................................................................... 17
Pre-configuration Wizard 17
Parallels H-Sphere config.xml
The config.xml file is used in Parallels H-Sphere Pre-configuration Wizard (on page 14).
It contains Parallels H-Sphere cluster configuration: physical servers with their IPs and
root passwords to install Parallels H-Sphere to, and logical servers to be installed on
these boxes.
During regular Parallels H-Sphere installation, config.xml is formed in Parallels H-
Sphere Pre-Configuration wizard in admin CP and is temporarily stored in the
~cpanel/.settings directory. After completing Parallels H- Sphere installation in
the postinstall mode, installer removes this file. However, the postinstall mode
won't continue if config.xml is missing or is different from the one used at the
installation.
When installer runs in the install mode, it is required that you specify location of the
correctly formed config.xml. See Appendix B. Installation Script Options of Parallels H-
Sphere Control Panel Installation Guide.
Elements and Attributes
In the following chart xml elements are marked in bold and their attributes -- in italics.
physicalServers - a list of Parallels H-Sphere physical servers, each of them
described as physicalServer with attributes:
 id - id of the physical server
 name - name of the physical server
password - root password to the physical server Each physicalServer contains ip and
logicalServers elements:
 ip - server IP with attribute:
 type - type of the physical server
Element ip contains such child elements:
 addr - IP address
 ipExt - external IP for NAT mapping
Note: If Parallels H-Sphere does not use NAT, this child element is redundant.
 mask - IP mask
 logicalServers - a list of Parallels H-Sphere logical servers each of them described
as logicalServer with attributes:
 group - group of the logical server
 id -id of the logical server
 name - name of the logical server
18 Pre-configuration Wizard
Each logicalServer element contains ips element - a list of IPs, each of them
described as ip with the following child elements:
 addr - IP address
 ipExt - external IP for NAT mapping
Note: If Parallels H-Sphere does not use NAT this child element is redundant.
 mask - IP mask
systemzone - a Parallels H-Sphere DNS zone
hsversion - a Parallels H-Sphere version
This chapter lists various types of software used in Parallels H-Sphere.
In this chapter:
Integrated Third Party Products ......................................................................... 20
Supplementary Software ................................................................................... 22
Used Libraries and Technologies ...................................................................... 23
C H A P T E R 4
Software Used in Parallels H-Sphere
20 Software Used in Parallels H-Sphere
Integrated Third Party Products
Even though we integrate or use the below products in Parallels H-Sphere, we do not
assume any responsibility for bugs in their source code. Should you have any problems
with these products, please contact the developers. The packages are listed in the
alphabetical order.
BS Counter http://www.stanback.net/programming/bscounter
"This is a web hit counter/tracker written in Perl, features include: blocking of multiple
hits from the same user, insertion of commas, text-based or graphical modes, supports
multiple counters from the same script, and tracks users' browsers, operating systems,
locations, top 20 referrers, and top 20 search engine keywords. (requires SSI OR
GD.pm)"
ezmlm http://www.ezmlm.org
"ezmlm is a modern mailing list manager. Its purpose is to efficiently send a message to
a large number of recipients with minimal delay. It allows automated additions and
subtractions from the subscriber database. In addition, it may keep an archive of
messages. It can also impose restrictions on what may be sent or retrieved and by
whom. Some mailing list managers keep a database of subscriber information and
tailor the message specifically for each subscriber. ezmlm sends the same message to
all subscribers. This is much more efficient. The benefits to the user are that on
average posts to ezmlm lists reach subscribers much faster than they would with other
mailing list manager."
FormMail http://www.scriptarchive.com/formmail.html
"FormMail is a generic WWW form to e-mail gateway, which will parse the results of
any form and send them to the specified user. This script has many formatting and
operational options, most of which can be specified through the form, meaning you
don't need any programming knowledge or multiple scripts for multiple forms. This also
makes FormMail a perfect system-wide solution for allowing users form-based user
feedback capabilities without the risks of allowing freedom of CGI access."
Miva Merchant http://www.miva.com
"Miva Merchant is a dynamic browser based storefront development and management
system that allows merchants to create and administrate multiple online stores from
anywhere in the world."
mnoGoSearch http://www.mnogosearch.org/
"mnoGoSearch (formerly known as UdmSearch) is a full-featured web search engine
software for intranet and internet servers. mnoGoSearch software has a number of
unique features, which makes it appropriate for a wide range of applications from
search within your site to specialized search systems such as cooking recipes or
newspaper searches, ftp archive search, MP3 search, news articles search or even
national-wide portal search engine."
ModLogAn http://jan.kneschke.de/projects/modlogan/
"ModLogAn is a modular logfile analyzer which is able to analyze logfiles from 15
different server types."
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89
  • Page 90 90
  • Page 91 91
  • Page 92 92
  • Page 93 93
  • Page 94 94
  • Page 95 95
  • Page 96 96
  • Page 97 97
  • Page 98 98
  • Page 99 99
  • Page 100 100
  • Page 101 101
  • Page 102 102
  • Page 103 103
  • Page 104 104
  • Page 105 105
  • Page 106 106
  • Page 107 107
  • Page 108 108
  • Page 109 109
  • Page 110 110
  • Page 111 111
  • Page 112 112
  • Page 113 113
  • Page 114 114
  • Page 115 115
  • Page 116 116
  • Page 117 117
  • Page 118 118
  • Page 119 119
  • Page 120 120
  • Page 121 121
  • Page 122 122
  • Page 123 123
  • Page 124 124
  • Page 125 125
  • Page 126 126
  • Page 127 127
  • Page 128 128
  • Page 129 129
  • Page 130 130
  • Page 131 131
  • Page 132 132
  • Page 133 133
  • Page 134 134
  • Page 135 135
  • Page 136 136
  • Page 137 137
  • Page 138 138
  • Page 139 139
  • Page 140 140
  • Page 141 141
  • Page 142 142
  • Page 143 143
  • Page 144 144
  • Page 145 145
  • Page 146 146
  • Page 147 147
  • Page 148 148
  • Page 149 149
  • Page 150 150
  • Page 151 151
  • Page 152 152
  • Page 153 153
  • Page 154 154
  • Page 155 155
  • Page 156 156
  • Page 157 157
  • Page 158 158
  • Page 159 159
  • Page 160 160
  • Page 161 161
  • Page 162 162
  • Page 163 163
  • Page 164 164
  • Page 165 165
  • Page 166 166
  • Page 167 167
  • Page 168 168
  • Page 169 169
  • Page 170 170
  • Page 171 171
  • Page 172 172
  • Page 173 173
  • Page 174 174
  • Page 175 175
  • Page 176 176
  • Page 177 177
  • Page 178 178
  • Page 179 179
  • Page 180 180
  • Page 181 181
  • Page 182 182
  • Page 183 183
  • Page 184 184
  • Page 185 185
  • Page 186 186
  • Page 187 187
  • Page 188 188
  • Page 189 189
  • Page 190 190
  • Page 191 191
  • Page 192 192
  • Page 193 193
  • Page 194 194
  • Page 195 195
  • Page 196 196
  • Page 197 197
  • Page 198 198
  • Page 199 199
  • Page 200 200
  • Page 201 201
  • Page 202 202
  • Page 203 203
  • Page 204 204
  • Page 205 205
  • Page 206 206
  • Page 207 207
  • Page 208 208
  • Page 209 209
  • Page 210 210
  • Page 211 211
  • Page 212 212
  • Page 213 213
  • Page 214 214
  • Page 215 215
  • Page 216 216
  • Page 217 217
  • Page 218 218
  • Page 219 219
  • Page 220 220
  • Page 221 221
  • Page 222 222
  • Page 223 223
  • Page 224 224
  • Page 225 225
  • Page 226 226
  • Page 227 227
  • Page 228 228
  • Page 229 229
  • Page 230 230
  • Page 231 231
  • Page 232 232
  • Page 233 233
  • Page 234 234
  • Page 235 235
  • Page 236 236
  • Page 237 237
  • Page 238 238
  • Page 239 239
  • Page 240 240
  • Page 241 241
  • Page 242 242
  • Page 243 243
  • Page 244 244
  • Page 245 245
  • Page 246 246
  • Page 247 247
  • Page 248 248
  • Page 249 249
  • Page 250 250
  • Page 251 251
  • Page 252 252
  • Page 253 253
  • Page 254 254
  • Page 255 255
  • Page 256 256
  • Page 257 257
  • Page 258 258
  • Page 259 259
  • Page 260 260
  • Page 261 261
  • Page 262 262
  • Page 263 263
  • Page 264 264
  • Page 265 265
  • Page 266 266
  • Page 267 267
  • Page 268 268
  • Page 269 269
  • Page 270 270
  • Page 271 271
  • Page 272 272
  • Page 273 273
  • Page 274 274
  • Page 275 275
  • Page 276 276
  • Page 277 277
  • Page 278 278
  • Page 279 279
  • Page 280 280
  • Page 281 281
  • Page 282 282
  • Page 283 283
  • Page 284 284
  • Page 285 285
  • Page 286 286
  • Page 287 287
  • Page 288 288
  • Page 289 289
  • Page 290 290
  • Page 291 291
  • Page 292 292
  • Page 293 293
  • Page 294 294
  • Page 295 295
  • Page 296 296
  • Page 297 297
  • Page 298 298
  • Page 299 299
  • Page 300 300
  • Page 301 301
  • Page 302 302
  • Page 303 303
  • Page 304 304
  • Page 305 305
  • Page 306 306
  • Page 307 307
  • Page 308 308
  • Page 309 309
  • Page 310 310
  • Page 311 311
  • Page 312 312
  • Page 313 313
  • Page 314 314
  • Page 315 315
  • Page 316 316
  • Page 317 317
  • Page 318 318
  • Page 319 319
  • Page 320 320
  • Page 321 321
  • Page 322 322
  • Page 323 323
  • Page 324 324
  • Page 325 325
  • Page 326 326
  • Page 327 327
  • Page 328 328
  • Page 329 329
  • Page 330 330
  • Page 331 331
  • Page 332 332
  • Page 333 333
  • Page 334 334
  • Page 335 335
  • Page 336 336
  • Page 337 337
  • Page 338 338
  • Page 339 339
  • Page 340 340
  • Page 341 341
  • Page 342 342
  • Page 343 343
  • Page 344 344
  • Page 345 345
  • Page 346 346
  • Page 347 347
  • Page 348 348
  • Page 349 349
  • Page 350 350
  • Page 351 351
  • Page 352 352
  • Page 353 353
  • Page 354 354
  • Page 355 355
  • Page 356 356
  • Page 357 357
  • Page 358 358
  • Page 359 359
  • Page 360 360
  • Page 361 361
  • Page 362 362
  • Page 363 363
  • Page 364 364
  • Page 365 365
  • Page 366 366
  • Page 367 367
  • Page 368 368
  • Page 369 369
  • Page 370 370
  • Page 371 371
  • Page 372 372
  • Page 373 373
  • Page 374 374
  • Page 375 375
  • Page 376 376
  • Page 377 377
  • Page 378 378
  • Page 379 379
  • Page 380 380
  • Page 381 381
  • Page 382 382
  • Page 383 383
  • Page 384 384
  • Page 385 385
  • Page 386 386
  • Page 387 387
  • Page 388 388
  • Page 389 389
  • Page 390 390
  • Page 391 391
  • Page 392 392
  • Page 393 393
  • Page 394 394
  • Page 395 395
  • Page 396 396
  • Page 397 397
  • Page 398 398
  • Page 399 399
  • Page 400 400
  • Page 401 401
  • Page 402 402
  • Page 403 403
  • Page 404 404
  • Page 405 405
  • Page 406 406
  • Page 407 407
  • Page 408 408
  • Page 409 409
  • Page 410 410
  • Page 411 411

Parallels H-Sphere 3.6.1 User guide

Category
Software
Type
User guide

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI