Parallels H-Sphere 3.4 User guide

  • Hello! I am an AI chatbot trained to assist you with the Parallels H-Sphere 3.4 User guide. I’ve already reviewed the document and can help you find the information you need or explain it in simple terms. Just ask your questions, and providing more details will help me assist you more effectively!
Parallels
®
H-Sphere
Legal and Copyright Notice
Parallels Holdings, Ltd.
c/o Parallels International GMbH.
Parallels International GmbH
Vordergasse 49
CH8200 Schaffhausen
Switzerland
Tel: + 49 (6151) 42996 - 0
Fax: + 49 (6151) 42996 - 255
www.parallels.com
© 1999-2010 Parallels Holdings, Ltd. and its affiliates. All rights reserved.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 12
Typographical Conventions ......................................................................................................... 12
Feedback ..................................................................................................................................... 13
About This Guide 14
Pre-configuration Wizard 15
Parallels H-Sphere config.xml ..................................................................................................... 18
Elements and Attributes .................................................................................................... 18
Software Used in Parallels H-Sphere 20
Integrated Third Party Products ................................................................................................... 21
Supplementary Software ............................................................................................................. 23
Used Libraries and Technologies ................................................................................................ 24
Update of Operating Systems 25
Updating FreeBSD Kernel ........................................................................................................... 26
Updating Linux ............................................................................................................................. 26
Linux Up2Date ................................................................................................................... 28
Linux Apt-Get..................................................................................................................... 28
Network Address Translation (NAT) 29
Configuring Newly Installed H-Sphere with NAT Support ........................................................... 30
Enabling NAT Support on a Live System .................................................................................... 31
Configuring NAT Firewall ............................................................................................................. 32
Migrating IPs with NAT ................................................................................................................ 32
Server Time Synchronization 33
NTP Time Servers ....................................................................................................................... 33
Cron Scripts 34
Control Panel Server Crons ......................................................................................................... 34
Web Server Crons ....................................................................................................................... 35
DNS Server Cron ......................................................................................................................... 35
Mail Server Crons ........................................................................................................................ 36
PostgreSQL/MySQL Server ........................................................................................................ 36
Traffic Calculation 37
Checking Traffic via Parallels H-Sphere Control Panel ............................................................... 38
Checking Traffic on Physical Servers .......................................................................................... 38
Preface 4
Processing Traffic by Crons ........................................................................................................ 39
HTTP traffic ....................................................................................................................... 39
User FTP traffic ................................................................................................................. 39
Virtual FTP traffic ............................................................................................................... 39
Mail traffic .......................................................................................................................... 39
Parsing Traffic by TrafficLoader .................................................................................................. 40
IP Migration (Changing IPs) 41
Changing IPs on Systems Without NAT ...................................................................................... 41
IP Migration Pre-requisites ................................................................................................ 42
IP Migration Map File ........................................................................................................ 43
Creating ipmigration.xml Manually .................................................................................... 44
Creating ipmigration.xml by Parallels H-Sphere IP Migrator ............................................. 45
IP Migration Step by Step .................................................................................................. 45
Changing External IPs on Systems with NAT ............................................................................. 55
Changing Internal IPs on Systems With NAT .............................................................................. 56
Configuring Parallels H-Sphere to Work on Two Sets of IPs ...................................................... 57
Restarting Services 58
Restarting Parallels H-Sphere Control Panel .............................................................................. 60
Restarting Parallels H-Sphere Database..................................................................................... 60
Restarting Web Server ................................................................................................................ 61
Restarting PostgreSQL Server .................................................................................................... 61
Restarting Mail Server ................................................................................................................. 63
Restarting MySQL Server ............................................................................................................ 63
Restarting Named ........................................................................................................................ 64
Control Panel Server 65
Understanding Control Panel Server Configuration .................................................................... 66
Installed Software .............................................................................................................. 66
Interaction Between Servers ............................................................................................. 67
Location of CP Files and Directories ................................................................................. 67
The Parallels H-Sphere Configuration File ........................................................................ 68
Control Panel Apache Server Configuration ..................................................................... 68
Control Panel Back-End Servlet Engine ........................................................................... 68
Reseller Configuration ....................................................................................................... 68
Reseller SSL Configuration ............................................................................................... 69
CP SSL Configuration ....................................................................................................... 69
CP Apache Log Files ......................................................................................................... 69
CP Traffic Calculation ........................................................................................................ 70
The Parallels H-Sphere System Database ....................................................................... 70
The System Database Settings ......................................................................................... 70
Logging into the System Database ................................................................................... 70
VACUUM Utility ................................................................................................................. 71
CP Mail Queue .................................................................................................................. 71
Logging in as the cpanel User ..................................................................................................... 72
Logging into Parallels H-Sphere System Database .................................................................... 72
Launching Control Panel Cron Jobs ............................................................................................ 72
CP Cron XML Configuration Files ..................................................................................... 73
Background Job Manager ................................................................................................. 73
Configuring Tomcat ..................................................................................................................... 73
Tomcat Configuration Files ............................................................................................... 74
Tomcat Log File ................................................................................................................. 74
Restarting Tomcat ............................................................................................................. 74
Customizing Tomcat Environment Variables .................................................................... 75
Preface 5
Running Java Command Line Tools ........................................................................................... 76
DNSCreator ....................................................................................................................... 77
IPMigratorFast ................................................................................................................... 78
PhysicalCreator ................................................................................................................. 79
PostApacheConfigs ........................................................................................................... 80
PostFTPConfigs ................................................................................................................ 81
ServerAliasesRenamer ..................................................................................................... 82
ChangeLServerId .............................................................................................................. 83
MIVAEmpresaFix............................................................................................................... 84
KeyPairGenerator .............................................................................................................. 84
PGPEncrypter.................................................................................................................... 84
PGPMessageSigner .......................................................................................................... 85
PGPMessageVerify ........................................................................................................... 85
RepostResellerSSLConfigs ............................................................................................... 86
ServiceZoneRenamer ....................................................................................................... 86
BillingEraser ...................................................................................................................... 87
SetQuota ........................................................................................................................... 87
UrchinReconfig .................................................................................................................. 88
OffLogs .............................................................................................................................. 89
Reset Balance ................................................................................................................... 90
RegenerateIpsFile ............................................................................................................. 91
LicenseExtractor ................................................................................................................ 92
VPSConvertor24_25 ......................................................................................................... 93
MailRelayCorrector ............................................................................................................ 94
Securing Your CP Server with SSL ............................................................................................. 95
Disabling HTTP Access ..................................................................................................... 97
Switching Between IP and Domain Name ........................................................................ 98
Upgrading Java ............................................................................................................................ 98
Supported Versions ........................................................................................................... 98
Upgrade Procedure ........................................................................................................... 99
Converting Parallels H-Sphere System Database from MS SQL to PgSQL ............................. 101
Step 1. Convert Database from MSSQL Server to MySQL ............................................ 102
Step 2. Convert Database from MySQL Server to PgSQL ............................................. 103
Upgrading System Postgres ...................................................................................................... 104
Converting Parallels H-Sphere Database To UNICODE........................................................... 106
Accelerating Control Panel ........................................................................................................ 109
Parallels H-Sphere Java-related Issues .......................................................................... 110
Optimizing Parallels H-Sphere System Database ........................................................... 111
Troubleshooting ............................................................................................................... 117
Changing CP URL ..................................................................................................................... 117
Changing IP Address to Domain Name in CP URL ........................................................ 118
Changing Parallels H-Sphere Port .................................................................................. 118
Changing Entire CP URL ................................................................................................ 119
Setting Multiple Alternative CP URL‘s ............................................................................. 120
Migrating Control Panel Server ................................................................................................. 121
Generating SSH Keys for Parallels H-Sphere Servers ............................................................. 123
Encrypting Trouble Tickets ........................................................................................................ 124
Generating PGP Public Key and PGP Private Key ......................................................... 124
Enabling PGP Encryption In Your Support Center.......................................................... 125
Encrypting Texts With PGP Public Key ........................................................................... 125
Using Encrypted Parts in Trouble Tickets ....................................................................... 126
Customizing Domain Registration Lookup Script ...................................................................... 127
Web Server 129
Understanding Web Server Configuration ................................................................................. 130
FTP Server ...................................................................................................................... 131
SSL Implementation on Unix Web Servers ..................................................................... 136
Dedicated SSL................................................................................................................. 136
Preface 6
Shared SSL ..................................................................................................................... 136
Third Party Log Analyzers Integrated in Parallels H-Sphere .......................................... 137
WebShell ......................................................................................................................... 141
MnoGoSearch ................................................................................................................. 142
Parallels H-Sphere Jail .................................................................................................... 144
Preventing Manipulation with Logs Directory Permissions........................................................ 146
Altering Virtual Host Configuration ............................................................................................ 146
Calculating Web Traffic.............................................................................................................. 148
Using Third-Party Log Analyzers for Traffic Calculation ................................................. 149
Calculating Parallels H-Sphere Built-In Traffic ................................................................ 151
Adding Directories for User Homes ........................................................................................... 152
Installing Ruby on Rails ............................................................................................................. 152
Installing Chili!Soft ASP ............................................................................................................. 153
WORKFLOW ................................................................................................................... 153
Installing mod_perl..................................................................................................................... 160
Installing Zend Optimizer ........................................................................................................... 162
Mail System 164
Understanding Parallels H-Sphere Mail .................................................................................... 165
Mail Package ................................................................................................................... 166
Included Software ............................................................................................................ 166
Webmails ......................................................................................................................... 167
IMAP Server .................................................................................................................... 170
Choosing Remote Web and MySQL Logical Servers for Horde Webmail Frontend ................. 173
Changing Mail Server Roles ...................................................................................................... 174
Blocking IPs on Mail Servers ..................................................................................................... 176
Adding Qmail Settings to IP/Subnet .......................................................................................... 176
Bouncing Mail ............................................................................................................................ 177
1. Separate IP for Sending Bounced Mail ....................................................................... 177
2. Processing Error Responses ....................................................................................... 178
3. Bounced Message Delivery ......................................................................................... 179
Configuring Qmail ...................................................................................................................... 179
Antivirus and Antispam Filters (SpamAssassin and ClamAV) ........................................ 180
Integrated Antispam Addons ........................................................................................... 183
Qmail Server Settings ..................................................................................................... 184
Command Line Qmail Configuration ............................................................................... 196
Syslog Facility/Level Configuration For rblsmtpd ............................................................ 196
SMTP Log ........................................................................................................................ 197
Mail Client and ESMTP Destination Server .................................................................... 198
Qmail-spp Support .......................................................................................................... 199
Qmail TLS Support .......................................................................................................... 200
Integrated Plugins ........................................................................................................... 200
Choosing Remote MySQL Logical Server for SpamAssassin................................................... 201
SPF and SRS ............................................................................................................................ 202
SPF (Sender Policy Framework) ..................................................................................... 203
SRS (Sender Re-write Scheme) ..................................................................................... 205
Updating SpamAssassin Rulesets Automatically ...................................................................... 205
Sa-update Script .............................................................................................................. 206
Rules Du Jour Script ....................................................................................................... 206
Migrating Mail Server/IP ............................................................................................................ 210
Moving Mail Domains ................................................................................................................ 213
Calculating Mail Traffic .............................................................................................................. 214
Mail Traffic Log ................................................................................................................ 216
POP3 and IMAP Traffic ................................................................................................... 217
Web Mailing List Traffic ................................................................................................... 217
SpamGuard Setup ..................................................................................................................... 218
Preface 7
DNS Server 219
DNS Config Files ....................................................................................................................... 220
Parallels H-Sphere DNS Zones ....................................................................................... 220
Custom DNS Zones ........................................................................................................ 221
Reverse DNS ................................................................................................................... 221
Restarting Named ...................................................................................................................... 222
Bind 9.3 ...................................................................................................................................... 222
New Features .................................................................................................................. 223
Restarting Bind ................................................................................................................ 223
Using rndc ....................................................................................................................... 224
Adding DNS Servers.................................................................................................................. 225
Configuring Single DNS ............................................................................................................. 225
Installing and Configuring MyDNS ............................................................................................. 227
Installation ....................................................................................................................... 227
Uninstallation ................................................................................................................... 228
Migrating DNS from Bind to MyDNS ......................................................................................... 228
Moving DNS ............................................................................................................................... 229
Removing Broken DNS Zones .................................................................................................. 231
Removing User Domain Zone ......................................................................................... 233
Removing Service Domain Zone..................................................................................... 234
Using DNS Creator .................................................................................................................... 235
MySQL Server 236
Installing MySQL Server ............................................................................................................ 236
Step 1. Checking for MySQL on Your Box ...................................................................... 237
Step 2. Downloading MySQL .......................................................................................... 237
Step 3. Installing MySQL ................................................................................................. 237
Step 4. Configuring MySQL ............................................................................................. 238
Step 5. Adding MySQL Server to Parallels H-Sphere ..................................................... 238
Backing Up MySQL Database ................................................................................................... 238
Running Parallels H-Sphere MySQL Scripts ............................................................................. 239
Getting Remote Access to MySQL Logical Server .................................................................... 240
Enabling Linked Tables in phpMyAdmin ................................................................................... 241
Changing MySQL Root Password ............................................................................................. 242
Option 1 ........................................................................................................................... 243
Option 2 ........................................................................................................................... 244
Moving MySQL .......................................................................................................................... 245
Step 1. Preparing Servers ............................................................................................... 245
Step 2. Moving MySQL Content ...................................................................................... 245
Step 3. Updating System Database ................................................................................ 246
Step 4. Updating Resellers‘ Server Aliases .................................................................... 246
Step 5. Synchronizing MySQL Content ........................................................................... 246
Step 6. Finalizing the Migration ....................................................................................... 247
Step 7. Checking Functionality ........................................................................................ 248
Moving MySQL Accounts .......................................................................................................... 248
PostgreSQL Server 250
Installing PostgreSQL Server .................................................................................................... 250
Step 1. Checking for PostgreSQL ................................................................................... 251
Step 2. Downloading PostgreSQL................................................................................... 251
Step 3. Installing PostgreSQL ......................................................................................... 252
Step 4. Configuring PostgreSQL ..................................................................................... 252
Backing Up PostgreSQL Database ........................................................................................... 253
Using VACUUM Utility ............................................................................................................... 253
Preface 8
Running PostgreSQL Scripts ..................................................................................................... 254
Changing Postgres User Password ........................................................................................... 255
Localizing PostgreSQL .............................................................................................................. 256
Configuring Parallels H-Sphere to Use Non-Default MySQL/PostgreSQL Versions ................ 256
Choosing Remote Web Logical Servers for phpMyAdmin/phpPgAdmin Frontends ................. 258
Downgrading Postgres .............................................................................................................. 259
Windows Servers 261
MSI Packages ............................................................................................................................ 262
Download and Installation ............................................................................................... 263
Packages Requiring Third-party Software ...................................................................... 264
Dependencies Tree ......................................................................................................... 264
Winbox Directory Structure ........................................................................................................ 265
HSphere .......................................................................................................................... 265
HShome ........................................................................................................................... 266
HSlogfiles ........................................................................................................................ 267
Restarting Winbox Service ........................................................................................................ 267
Restarting IIS ............................................................................................................................. 268
Enabling Winbox Shared SSL ................................................................................................... 268
Integrating Winbox Shared SSL ...................................................................................... 269
Updating Winbox Shared SSL ......................................................................................... 269
Winbox Statistics ....................................................................................................................... 270
Statistics Modules ........................................................................................................... 271
Setting Up SharePoint to Use MSSQL Server .......................................................................... 273
Preinstallation Requirements .......................................................................................... 273
Installing and Configuring SharePoint ............................................................................. 274
Adding ODBC Resource ............................................................................................................ 277
Interface ........................................................................................................................... 278
Configuration ................................................................................................................... 281
Configuring ColdFusion ............................................................................................................. 283
Enabling ASP.NET 4.0 .............................................................................................................. 284
Moving Log Files ........................................................................................................................ 284
Removing Old Log Files ............................................................................................................ 285
Moving User Homes .................................................................................................................. 286
Maintaining HShome ................................................................................................................. 286
Changing hsadmin Login and Password ................................................................................... 288
Winbox IP Migration................................................................................................................... 289
Step 1. Bind Target IPs on Winbox ................................................................................. 289
Step 2. Add Double Bindings on IIS ................................................................................ 290
Step 3. Create Migration XML ......................................................................................... 291
Step 4. Run the Migration ................................................................................................ 292
Step 5. Remove Old IP Bindings on IIS .......................................................................... 292
Uninstalling Winbox ................................................................................................................... 293
Winbox Security Scheme .......................................................................................................... 295
Accounts Hierarchy ......................................................................................................... 296
IIS Security Management ................................................................................................ 297
NTFS permissions ........................................................................................................... 298
FrontPage Server Extensions Management Notes ......................................................... 298
ASP.NET Management Notes ......................................................................................... 299
Migration Notes ............................................................................................................... 299
Recovery Notes ............................................................................................................... 299
Migrating Serv-U to MS-FTP ..................................................................................................... 300
Step 1. Create a User Account and User FTP Accounts in IIS FTP ............................... 301
Step 2. Reset NTFS Permissions .................................................................................... 303
Step 3. Recover Winbox quota ........................................................................................ 304
Step 4. Reset Anonymous Access for All User Domains in IIS ...................................... 305
Preparing Servers for MS Exchange Hosting (Hosted Messaging and Collaboration 3.0) ....... 306
Step 1. Install Required Software on the Servers ........................................................... 307
Preface 9
Step 2. Deploy Hosted Messaging and Collaboration..................................................... 309
Step 3. Install WS Exchange Provider Adapter Namespace .......................................... 321
Step 4. Create Reseller Organization Unit ...................................................................... 322
Preparing Servers for MS Exchange Hosting (Hosted Messaging and Collaboration 3.5) ....... 324
Step 1. Install Required Software on the Servers ........................................................... 325
Step 2. Deploy Hosted Messaging and Collaboration..................................................... 327
Step 3. Install WS Exchange Provider Adapter Namespace .......................................... 333
Step 4. Create Reseller Organization Unit ...................................................................... 334
Calculating Winbox Traffic ......................................................................................................... 336
Creating Mail Plan on MPS Server ............................................................................................ 337
Microsoft SQL Server 340
Installing Microsoft SQL 2000 Server ........................................................................................ 341
Installing Microsoft SQL 2005 Server ........................................................................................ 342
Moving MS SQL Databases Across Servers ............................................................................. 343
Moving MS SQL Databases to a New Location ........................................................................ 344
Virtual Private Servers 350
Configuration Parameters .......................................................................................................... 350
VPS Scripts ................................................................................................................................ 352
Perl Modules Used by VPS Scripts ................................................................................. 353
VPS Configuration ........................................................................................................... 354
Create VPS ...................................................................................................................... 355
Migrate VPS .................................................................................................................... 357
Delete VPS ...................................................................................................................... 358
VPS Cron Scripts............................................................................................................. 359
VPS Configuration Scripts ............................................................................................... 363
View List of Installed VPS‘s ............................................................................................. 366
Install/Uninstall Additional Packages .............................................................................. 367
Check VPS Files for Changes ......................................................................................... 369
VPS IP Migration Tool ..................................................................................................... 371
VPS Network Configuration Tools ................................................................................... 372
Device Management ....................................................................................................... 374
Backing Up VPS Content .......................................................................................................... 377
Adding VPS Network Gateways ................................................................................................ 378
VPS Subnet XML Configuration ...................................................................................... 379
Parallels H-Sphere VPS Configuration Parameters .................................................................. 380
VPS Templates .......................................................................................................................... 386
Creating and Modifying VPS Templates ......................................................................... 387
Default Templates ........................................................................................................... 388
VPS Limits ................................................................................................................................. 392
Hints On Handling VPS Limits ......................................................................................... 394
Changing VPS Solution ............................................................................................................. 395
Changing Solution from Parallels H-Sphere Control Panel ............................................ 395
Changing Solution from Console..................................................................................... 396
Changing Solution from Parallels H-Sphere Control Panel ............................................ 397
Configuring VPS Host ................................................................................................................ 398
Customizing Operating System Distributive URLs .................................................................... 402
Dedicated Servers 403
Configuring MRTG ..................................................................................................................... 404
Managing MRTG Service ................................................................................................ 404
Configuration Directory and File ...................................................................................... 404
Scripts Processing Data .................................................................................................. 404
RRD Files ........................................................................................................................ 405
Preface 10
The Problem with Calculating Large (>100mbps) Bandwidth Traffic .............................. 405
System Packages 407
Common Packages ................................................................................................................... 407
hsphere-info: Collecting Information About Parallels H-Sphere Servers into XML Configs408
hsphere-update Package ................................................................................................ 410
upackages Syntax ........................................................................................................... 410
Parallels H-Sphere Perl Modules .................................................................................... 412
Parallels H-Sphere Apache ............................................................................................. 414
Parallels H-Sphere PHP .................................................................................................. 425
Parallels SiteStudio Packages ................................................................................................... 435
Load Balancing 436
Load Balancers................................................................................................................ 438
Supported NAS................................................................................................................ 438
Load Balanced Cluster .................................................................................................... 438
Implementation of Load Balanced Cluster in Parallels H-Sphere ............................................. 439
Load Balanced Cluster in CP .......................................................................................... 440
Distribution of Requests Across Load Balanced Cluster ................................................ 440
Shared Content ............................................................................................................... 440
Specific Master/Slave Content ........................................................................................ 441
Synchronization Between Master and Slave Servers ..................................................... 441
Traffic Calculation ............................................................................................................ 442
Load Balanced Cluster Map ............................................................................................ 443
NAT Configuration for Load Balanced Clusters .............................................................. 444
Load Balancing Support in Parallels H-Sphere ......................................................................... 445
Installing Load Balanced Web/Mail Clusters in Parallels H-Sphere .......................................... 445
Step 1. Install and Configure Load Balancer ................................................................... 446
Step 2. Prepare NAS ....................................................................................................... 447
Step 3. Prepare Master and Slave Web/Mail Boxes ....................................................... 452
Step 4. Install Parallels H-Sphere to Load Balanced Parallels H-Sphere Clusters ........ 454
Quota Managers ........................................................................................................................ 455
Resources Migration 456
Migratable Resources ..................................................................................................... 456
Migration Procedure .................................................................................................................. 457
Step 1. Create XML File Containing User Data .............................................................. 457
Data Type Definitions ...................................................................................................... 460
DTD Chart ....................................................................................................................... 460
Attributes Description ...................................................................................................... 461
Files ................................................................................................................................. 462
XML Validation ................................................................................................................ 463
Step 2. Create XML File Containing Reseller Plan Data ................................................ 463
Step 3. Prepare The Target Control Panel ...................................................................... 469
Step 4. Create Reseller Plans ......................................................................................... 469
Step 5. Create Resellers ................................................................................................. 469
Step 6. Create End Users ............................................................................................... 470
Troubleshooting ............................................................................................................... 470
Backup and Recovery 471
Backing Up Parallels H-Sphere Control Panel Server .............................................................. 472
System DB Dump ............................................................................................................ 473
Parallels H-Sphere Backup and Recovery List ......................................................................... 473
Recovering Parallels H-Sphere Control Panel .......................................................................... 475
Preface 11
Step 1. Prepare for the Recovery .................................................................................... 475
Step 2. Recover System Data ......................................................................................... 475
Files and Directories To Be Recovered .......................................................................... 476
Recovering Unix Hosted Parallels H-Sphere Servers ............................................................... 477
Step 1. Prepare Crashed Server for Recovery ............................................................... 478
Step 2. Run Parallels H-Sphere Updater ........................................................................ 478
Step 3. Run the Recovery Tool ....................................................................................... 478
Step 4. Restore User Content ......................................................................................... 479
Restoring Files and Directories from Backup ............................................................................ 480
Restoring the Parallels H-Sphere System Database From Backup .......................................... 480
Restoring the Parallels H-Sphere Database on a Server with PostgreSQL Not Installed482
Restoring the Parallels H-Sphere Database Content if PostgreSQL Is Installed: ........... 483
Fixing Crashed Parallels H-Sphere Database ........................................................................... 484
Backing Up Winbox ................................................................................................................... 486
Backing Up the Metabase ............................................................................................... 486
Backing Up MS SQL Databases ..................................................................................... 486
Backing Up User Content ................................................................................................ 487
Recovering Winbox.................................................................................................................... 487
Step 1. Back Up User Content ........................................................................................ 488
Step 2. Install Parallels H-Sphere ................................................................................... 488
Step 3. Set Up Dedicated IPs .......................................................................................... 489
Step 4. Prepare Target Winbox for Physical Creator ...................................................... 489
Step 5. Run PhysicalCreator on the CP Box ................................................................... 490
Step 6. Restore Content from Backup ............................................................................ 491
Step 7. Install Shared SSL .............................................................................................. 492
Step 8. Set Correct NTFS Permissions and Owner for the Home Directory .................. 493
Recovering Winbox Quota ......................................................................................................... 494
Miva 495
Miva Installation for *nix ............................................................................................................. 495
Requirements .................................................................................................................. 495
Miva Empresa Installation ............................................................................................... 496
Miva Merchant Installation ............................................................................................... 499
Miva Installation for Windows .................................................................................................... 500
Updating Miva 4 to Miva 5 ......................................................................................................... 501
Urchin 502
Urchin 4 and 5 Installation on Unix ............................................................................................ 503
Urchin 4 and 5 Installation on Windows .................................................................................... 505
Urchin 4 And Urchin 5 Database Utilities .................................................................................. 506
Urchin Database Utilities ................................................................................................. 506
Urchin Database Tables .................................................................................................. 506
RealServer 509
RealServer Installation for Unix ................................................................................................. 510
RealServer Installation for Windows .......................................................................................... 516
RealServer Config File Example ............................................................................................... 516
In this chapter:
Typographical Conventions ............................................................................... 12
Feedback .......................................................................................................... 13
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
Preface 13
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
16 Pre-configuration Wizard
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 29) 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.
Pre-configuration Wizard 17
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 ........................................................................... 18
18 Pre-configuration Wizard
Parallels H-Sphere config.xml
The config.xml file is used in Parallels H-Sphere Pre-configuration Wizard (on page 15).
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
Each logicalServer element contains ips element - a list of IPs, each of them
described as ip with the following child elements:
Pre-configuration Wizard 19
 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 ......................................................................... 21
Supplementary Software ................................................................................... 23
Used Libraries and Technologies ...................................................................... 24
C H A P T E R 4
Software Used in Parallels H-Sphere
/