Parallels
®
H-Sphere
Legal and Copyright Notice
ISBN: N/A
Parallels Holdings, Ltd.
c/o Parallels International GmbH
Vordergasse 59
CH-Schaffhausen
Switzerland
Phone: +41-526320-411
Fax: +41-52672-2010
© Copyright 2011,
Parallels, Inc.
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 15
Typographical Conventions ......................................................................................................... 15
Feedback ..................................................................................................................................... 16
About This Guide 17
Introduction To Parallels H-Sphere 18
DNS Management ....................................................................................................................... 19
Server Management .................................................................................................................... 20
User Signup ................................................................................................................................. 20
Billing And Plan Management ..................................................................................................... 21
Merchant Gateway Management ................................................................................................ 21
User/Account/Domain Management ............................................................................................ 22
Resellers ...................................................................................................................................... 23
Domain Management .................................................................................................................. 24
SSL .............................................................................................................................................. 25
Support Center ............................................................................................................................ 26
Look and Feel Management ........................................................................................................ 26
Parallels H-Sphere Licensing 27
Purchasing and Leasing Parallels H-Sphere .................................................................... 27
Upgrading to Parallels H-Sphere 3.5.1 or higher .............................................................. 27
Upgrading Parallels H-Sphere Accounts ........................................................................... 28
Getting Started 29
Step1. Disable Global Resources ................................................................................................ 30
Step 2. Set up a Domain Registrar .............................................................................................. 30
Step 3. Configure Mail Notification Addresses ............................................................................ 31
Step 4. Set up Payment Settings ................................................................................................. 32
Step 5. Create Plans.................................................................................................................... 33
Step 6. Create Billing Periods ...................................................................................................... 33
Step 7. Configure Support Center ............................................................................................... 34
Step 8. Configure Look and Feel ................................................................................................. 34
Server Configuration 35
Physical Servers .......................................................................................................................... 35
Adding Physical Servers ................................................................................................... 36
Physical Server Controls ................................................................................................... 37
Deleting a Physical Server ................................................................................................ 39
Logical Servers ............................................................................................................................ 39
Adding Logical Servers ..................................................................................................... 40
Enabling User Signup on Logical Servers ......................................................................... 42
Removing Logical Servers ................................................................................................ 43
Setting Logical Server Additional Options ......................................................................... 44
Preface 4
Adding IPs ................................................................................................................................... 49
DNS Servers ................................................................................................................................ 53
Mail Server Settings..................................................................................................................... 55
SPF and SRS .............................................................................................................................. 55
Enabling SPF and SRS ..................................................................................................... 56
Configuring SPF and SRS ................................................................................................. 56
AntiSpam and AntiVirus ............................................................................................................... 57
Enabling AntiSpam and AntiVirus in Control Panel........................................................... 58
Configuring AntiSpam and AntiVirus Default Settings ...................................................... 58
System SMTP Relays .................................................................................................................. 59
Advanced Web Server Settings ................................................................................................... 60
Apache Version ................................................................................................................. 60
Apache Modules ................................................................................................................ 61
Using Gotroot.com Modsecurityâ„¢ Rules With H-Sphere ................................................. 64
PHP Modes ....................................................................................................................... 68
PHP Plugins ...................................................................................................................... 71
PHP Accelerators .............................................................................................................. 72
Server Groups ............................................................................................................................. 73
Load Balanced Server Clusters ................................................................................................... 76
Platform Change .......................................................................................................................... 79
Updating Physical Boxes From CP Interface .............................................................................. 82
Procedure .......................................................................................................................... 82
Physical Server Installation/Update Profiles ................................................................................ 84
Resource Prerequisites ............................................................................................................... 88
System Service Management ...................................................................................................... 92
DNS and Hosting 95
DNS Manager .............................................................................................................................. 95
Adding DNS Zones ...................................................................................................................... 96
Instant Alias Templates ............................................................................................................... 98
Adding Instant Alias Templates ......................................................................................... 98
Editing Instant Alias Templates ....................................................................................... 100
DNS Records ............................................................................................................................. 101
Adding custom A records ................................................................................................ 102
Adding custom MX records ............................................................................................. 103
Adding custom CNAME records ...................................................................................... 103
Re-generating System Custom DNS Records ................................................................ 105
Hosting Your Corporate Site ...................................................................................................... 106
Step 1. Make sure you have a service DNS zone ........................................................... 106
Step 2. Create a service plan .......................................................................................... 106
Step 3. Disallow signups from outside your admin account. ........................................... 107
Step 4. Create a service account .................................................................................... 107
Adding Domains for Third Level Hosting ................................................................................... 108
Providing Mail Under Service Domain for Third-Level Hosting ................................................. 108
Control Panel Web Interface 109
Regional Settings ....................................................................................................................... 110
Images and Icons ...................................................................................................................... 113
Logo Images .................................................................................................................... 113
Icons And Control Images ............................................................................................... 114
Interface Texts ........................................................................................................................... 116
Login Texts ...................................................................................................................... 116
Signup Texts .................................................................................................................... 116
Miscellaneous Texts ........................................................................................................ 116
Skins and Colors ........................................................................................................................ 117
Disabling CP Skins .................................................................................................................... 120
Disabling CP Skins globally ............................................................................................. 120
Preface 5
Disabling CP Skins for reseller plans .............................................................................. 120
Setting Interface Language ....................................................................................................... 121
Setting Default System Language ................................................................................... 121
Setting Admin Interface Language .................................................................................. 121
E-Mail Notifications 123
Setting E-Mail Notification Recipients ........................................................................................ 124
Editing E-Mail Notifications ........................................................................................................ 126
Configuring User Notification Rules ........................................................................................... 132
Online Invoices ................................................................................................................ 133
"No Charge" Notifications ................................................................................................ 134
Control Panel Configuration 135
Entering Company Information .................................................................................................. 136
Disabling Global Resources, Hosting Platforms And Reseller CP SSL .................................... 138
Using Background Job Manager ............................................................................................... 141
Supported TLD's ........................................................................................................................ 145
Installing Shared SSL Certificates ............................................................................................. 146
Shared SSL installation wizard ........................................................................................ 148
Managing Mail SSL.................................................................................................................... 151
Enabling Mail SSL ........................................................................................................... 151
Editing Mail SSL .............................................................................................................. 153
Reposting Certificates ..................................................................................................... 155
Disabling Mail SSL .......................................................................................................... 155
Using Credit Card Encryption .................................................................................................... 156
Turning On ....................................................................................................................... 156
Loading Private Key ........................................................................................................ 158
Turning Off ....................................................................................................................... 159
If You Lose Your Private Key .......................................................................................... 160
Adding Credit Card Brands ........................................................................................................ 161
Domain Registrars 162
Domain Registrar Manager ....................................................................................................... 162
Configuring Domain Registration Settings ...................................................................... 163
Step 1. Creating Connections with Domain Registrars ................................................... 163
Step 2. Associating Top Level Domains with Domain Registrars ................................... 163
Step 3. Setting Default Domain Registration Prices........................................................ 165
Step 4. Configuring Registrar Connections for Resellers ............................................... 166
Editing Registrar Connection Settings ............................................................................ 166
Removing TLD Associations ........................................................................................... 166
Deleting Registrar Connections ....................................................................................... 167
Enom Configuration ................................................................................................................... 168
Setting Up Enom Connection .......................................................................................... 168
OpenSRS Configuration ............................................................................................................ 171
Setting Up OpenSRS Connection ................................................................................... 171
Asynchronous Response Management .......................................................................... 173
OnlineNIC Configuration ............................................................................................................ 175
Getting Prepared ............................................................................................................. 175
Setting Up OnlineNIC Connection ................................................................................... 175
RRPproxy Configuration ............................................................................................................ 178
Setting Up RRPproxy Connection ................................................................................... 178
Ascionic Configuration ............................................................................................................... 181
Setting Up Ascionic Connection ...................................................................................... 181
TPPInternet Configuration ......................................................................................................... 184
Setting Up TPPInternet Connection ................................................................................ 184
Preface 6
Email Domain Registration ........................................................................................................ 187
Configuring Email Registrar ............................................................................................ 187
Merchant Gateways 190
Merchant Gateway Manager ..................................................................................................... 191
Setting Up Merchant Gateway ........................................................................................ 192
Editing Merchant Gateway Settings ................................................................................ 192
Associating Merchant Gateways with Credit Card Vendors ........................................... 193
Editing Description for User Credit Card Statements ...................................................... 193
Handling CC Charge Request Failures ........................................................................... 194
One Step Gateways ........................................................................................................ 195
AssureBuy Configuration ........................................................................................................... 196
Preparation ...................................................................................................................... 196
Configuration ................................................................................................................... 196
AuthorizeNet (Sim Protocol) Configuration ............................................................................... 198
Preparation ...................................................................................................................... 198
Configuration ................................................................................................................... 198
Bibit Configuration ..................................................................................................................... 201
Preparation ...................................................................................................................... 201
Configuration ................................................................................................................... 201
Cardia Services Configuration ................................................................................................... 202
Preparation ...................................................................................................................... 202
Configuration ................................................................................................................... 202
ECHO Configuration .................................................................................................................. 203
Preparation ...................................................................................................................... 203
Configuration ................................................................................................................... 203
ePDQ Configuration................................................................................................................... 204
Preparation ...................................................................................................................... 204
Configuration ................................................................................................................... 204
eWay Configuration ................................................................................................................... 206
Preparation ...................................................................................................................... 206
Configuration ................................................................................................................... 206
HSBC Configuration .................................................................................................................. 207
Preparation ...................................................................................................................... 207
Configuration ................................................................................................................... 207
Innovative Gateway Configuration ............................................................................................. 208
Preparation ...................................................................................................................... 208
Configuration ................................................................................................................... 208
LinkPoint (API v3.01) Configuration .......................................................................................... 210
Preparation ...................................................................................................................... 210
Configuration ................................................................................................................... 211
Moneris Configuration................................................................................................................ 214
Preparation ...................................................................................................................... 214
Configuration ................................................................................................................... 214
NetBilling Configuration ............................................................................................................. 215
Preparation ...................................................................................................................... 215
Configuration ................................................................................................................... 216
NTPNow Configuration .............................................................................................................. 217
Preparation ...................................................................................................................... 217
Configuration ................................................................................................................... 217
Paradata Configuration .............................................................................................................. 219
Preparation ...................................................................................................................... 219
Configuration ................................................................................................................... 219
PayGate Configuration .............................................................................................................. 220
Preparation ...................................................................................................................... 220
Configuration ................................................................................................................... 220
PayJunction Configuration ......................................................................................................... 222
Preparation ...................................................................................................................... 222
Preface 7
Configuration ................................................................................................................... 222
Plug'n Pay Configuration ........................................................................................................... 224
Preparation ...................................................................................................................... 224
Configuration ................................................................................................................... 224
Pay-Me-Now Configuration ....................................................................................................... 226
Preparation ...................................................................................................................... 226
Configuration ................................................................................................................... 226
PosNet Configuration................................................................................................................. 227
Preparation ...................................................................................................................... 227
Configuration ................................................................................................................... 227
Protx (VSP Direct Protocol 2.22) Configuration ........................................................................ 228
Preparation ...................................................................................................................... 228
Configuration ................................................................................................................... 228
PSiGate (XML API) Configuration ............................................................................................. 230
Preparation ...................................................................................................................... 230
Configuration ................................................................................................................... 230
SecurePay Configuration ........................................................................................................... 232
Preparation ...................................................................................................................... 232
Configuration ................................................................................................................... 232
SkipJack Configuration .............................................................................................................. 233
Preparation ...................................................................................................................... 233
Configuration ................................................................................................................... 234
SecurePay.com.au Configuration .............................................................................................. 235
Preparation ...................................................................................................................... 235
Configuration ................................................................................................................... 235
SecureTrading Configuration ..................................................................................................... 237
Preparation ...................................................................................................................... 237
Configuration ................................................................................................................... 237
ThePayDesk Configuration ........................................................................................................ 239
Preparation ...................................................................................................................... 239
Configuration ................................................................................................................... 240
Tucows Configuration ................................................................................................................ 241
Preparation ...................................................................................................................... 241
Configuration ................................................................................................................... 241
VeriSign PayFlow Pro Configuration ......................................................................................... 244
Preparation ...................................................................................................................... 244
Configuration ................................................................................................................... 244
VeriSign PayFlow Pro With SSL Support .................................................................................. 246
Preparation ...................................................................................................................... 246
Configuration ................................................................................................................... 246
Web-based Payments 248
Web Payment Systems Manager .............................................................................................. 249
Work Principles................................................................................................................ 249
Configuration Procedure ................................................................................................. 249
Setting Web Payment Instant Notification URL ............................................................... 251
2CheckOut Configuration .......................................................................................................... 252
Authorize.Net (Sim Protocol) Configuration .............................................................................. 253
Setting Up Authorize.Net ................................................................................................. 253
ChronoPay Configuration .......................................................................................................... 255
Setting Up ChronoPay ..................................................................................................... 255
GestPay Configuration............................................................................................................... 256
PayNova Configuration .............................................................................................................. 257
PayPal Merchant Gateway Configuration ................................................................................. 258
Preparation ...................................................................................................................... 258
Configuration ................................................................................................................... 258
Sentry Configuration .................................................................................................................. 259
Preparation ...................................................................................................................... 259
Preface 8
Setup Procedure.............................................................................................................. 259
Webmoney Configuration .......................................................................................................... 261
1. Set your own purse ..................................................................................................... 261
2. Activate Webmoney payments in your Parallels H-Sphere control panel ................... 261
WorldPay Configuration ............................................................................................................. 263
Setting Up WorldPay ....................................................................................................... 263
Plans 265
Creating and Editing Plans (Plan Wizards) ............................................................................... 266
Starting Plan Creation Wizards ....................................................................................... 266
Starting Plan Edit Wizards ............................................................................................... 267
Simplified Plan Wizards ................................................................................................... 267
A Typical Web Hosting Plan Wizard .......................................................................................... 270
Step 1. Selecting Resources and Configuring Plan Settings .......................................... 271
Subsequent Steps. Setting Prices ................................................................................... 277
MySQL Plan Wizard .................................................................................................................. 277
Windows Plan Wizard ................................................................................................................ 278
Windows RealMedia Plan Wizard ............................................................................................. 279
E-mail Plan Wizard .................................................................................................................... 279
Markup Plan Wizard .................................................................................................................. 279
Admin Plans ............................................................................................................................... 280
Creating Admin Plans ...................................................................................................... 280
Editing Admin Plans ........................................................................................................ 281
Demo Plans ............................................................................................................................... 282
Access to Plans ......................................................................................................................... 285
Plan Controls ............................................................................................................................. 286
Show ................................................................................................................................ 287
Copy ................................................................................................................................ 288
Delete .............................................................................................................................. 288
Plan Settings .............................................................................................................................. 289
Controlling RAM And CPU Usage ............................................................................................. 292
Enable RLimit in Plans .................................................................................................... 292
Configure RLimit Values .................................................................................................. 293
Limiting Resource Use For Individual Accounts .............................................................. 294
Placing Plans on Particular Boxes ............................................................................................. 295
Resources 299
Users, Accounts, Domains ........................................................................................................ 299
Users ............................................................................................................................... 299
Accounts .......................................................................................................................... 300
Domains .......................................................................................................................... 303
Traffic ......................................................................................................................................... 304
Traffic Calculation ............................................................................................................ 305
Traffic Limit ...................................................................................................................... 305
Traffic Pricing ................................................................................................................... 306
Restricting Traffic Usage and Traffic Limit ...................................................................... 307
Charging for Traffic .......................................................................................................... 308
Traffic Configuration Changes ......................................................................................... 314
Tracking End User Traffic Consumption ......................................................................... 315
Disk Space ................................................................................................................................. 315
Charging Users for Disk Space ....................................................................................... 316
Enabling/Disabling Summary Disk Usage ....................................................................... 317
Recreating Resources ............................................................................................................... 318
Blacklists in Parallels H-Sphere ................................................................................................. 319
Domains in blacklist ......................................................................................................... 319
Emails in blacklist ............................................................................................................ 320
Uploading and Exporting Black Lists ............................................................................... 321
Preface 9
Billing 322
Plans ................................................................................................................................ 322
Billing Types .................................................................................................................... 322
Trial Hosting .................................................................................................................... 322
Billing Profiles .................................................................................................................. 322
Prices ............................................................................................................................... 323
Limiting Resources .......................................................................................................... 323
Billing Periods .................................................................................................................. 323
Crediting Accounts .......................................................................................................... 323
Debiting Accounts ........................................................................................................... 324
Billing Modes ................................................................................................................... 324
Traffic ............................................................................................................................... 324
Disk Space ...................................................................................................................... 324
E-mailing Invoices ........................................................................................................... 325
Taxes ............................................................................................................................... 325
Promotions ...................................................................................................................... 325
Billing Resellers ............................................................................................................... 325
Managing Debtors ........................................................................................................... 325
Money Returns ................................................................................................................ 326
Billing Statements ............................................................................................................ 326
Billing Types .............................................................................................................................. 327
Billing Profiles ............................................................................................................................ 328
Billing Periods and Discounts .................................................................................................... 329
Default and Actual Billing Periods. Base Prices .............................................................. 329
Monthly and Billing Period Resources ............................................................................ 329
Opening a New Billing Period/Month............................................................................... 329
Creating and Configuring Actual Billing Periods ............................................................. 330
Changing Account's Billing Period ............................................................................................. 331
Changing Billing Period Start Date ............................................................................................ 332
Credit Limit ................................................................................................................................. 334
Setting Credit Limit in a Plan ........................................................................................... 335
Increasing Credit Limit for Individual Accounts ............................................................... 335
Resetting Credit Limit For All Users ................................................................................ 336
Fees Collected From Customers ............................................................................................... 337
Plan Fees ........................................................................................................................ 337
Free Units .................................................................................................................................. 338
Setting Prices and Free Units .................................................................................................... 339
Comments on Resources ................................................................................................ 340
Discounts ................................................................................................................................... 345
Billing Consequences of Editing Prices and Free Units ............................................................ 346
Taxes ......................................................................................................................................... 346
Tax Exemption ........................................................................................................................... 348
Enabling Tax Exemption ................................................................................................. 349
Setting Tax Exemption Mode at Signup .......................................................................... 349
Activating User Accounts with Tax Exemption Code Entered ........................................ 350
Money Returns .......................................................................................................................... 352
Events that Trigger Refunds ............................................................................................ 352
Refund Formulas ............................................................................................................. 353
Moneyback Period ........................................................................................................... 353
Reducing Quotas and Limits ........................................................................................... 354
Refund Percentage ......................................................................................................... 354
Managing Debtors ..................................................................................................................... 355
Punitive Measures ........................................................................................................... 355
Punitive Measures Automation ........................................................................................ 355
Start Date of Time in Debt ............................................................................................... 356
Promotions ................................................................................................................................. 357
Promotion Types ............................................................................................................. 357
Preface 10
Calculating Promotion Discounts .................................................................................... 357
Creating Promotions ........................................................................................................ 357
Calculators shipped with H-Sphere ................................................................................. 360
Validators shipped with H-Sphere ................................................................................... 360
Associating Promotions With Plans................................................................................. 360
Extra Packages .......................................................................................................................... 361
Creating Extra Packs ....................................................................................................... 361
Managing Extra Packs .................................................................................................... 362
Anniversary Based Billing .......................................................................................................... 363
Switching Between Billing Modes .............................................................................................. 364
Sending "No charge" Notifications ............................................................................................. 364
Warning of Immediate Charges in Case of Buying Additional Resources ................................ 365
Dedicated Servers 366
Enabling Dedicated Servers in Globals ..................................................................................... 367
Adding MRTG Logical Servers and Network Switches ............................................................. 367
Adding MRTG Logical Servers ........................................................................................ 368
Adding Network Switches ................................................................................................ 368
Viewing MRTG Server Info .............................................................................................. 370
Creating/Managing Dedicated Server Templates ..................................................................... 371
Custom-built Dedicated Servers ...................................................................................... 372
Dedicated Server Plans ............................................................................................................. 373
User Plans ....................................................................................................................... 373
User's Choosing a Server at Signup ............................................................................... 375
Reseller Plans ................................................................................................................. 376
Managing Dedicated Servers .................................................................................................... 378
Adding Dedicated Servers ............................................................................................... 378
Editing Dedicated Servers ............................................................................................... 380
Deleting Dedicated Servers ............................................................................................. 380
Dedicated Server Status ............................................................................................................ 381
Assigning Additional IP Ranges ................................................................................................ 383
1. Set Prices for Extra IPs in Plans ................................................................................. 383
2. Add IP Subnet ............................................................................................................. 383
3. Split IP Subnet to Smaller IP Ranges ......................................................................... 385
4. Create PTR zone for Reverse DNS Records .............................................................. 386
5. Assign IP Range to Dedicated Server ......................................................................... 387
6. Unassign IP Range ..................................................................................................... 388
Billing Dedicated Servers .......................................................................................................... 389
Bandwidth Billing Types .................................................................................................. 390
Bandwidth Billing Types Options ..................................................................................... 391
Dedicated Servers' Maintenance ............................................................................................... 392
Regular Backups ............................................................................................................. 392
Maintenance Requests .................................................................................................... 393
Automatic Cancellation Settings...................................................................................... 395
Resellers 396
Plans ................................................................................................................................ 396
Dual Nature of Resellers ................................................................................................. 396
Private Label .................................................................................................................... 396
Look and Feel and Regional Settings ............................................................................. 397
Merchant Gateways ........................................................................................................ 397
Domain Registration ........................................................................................................ 397
Providing Support ............................................................................................................ 397
Control Panel ................................................................................................................... 398
Web, Mail, and SQL Resources ...................................................................................... 398
Servers ............................................................................................................................ 398
SSL .................................................................................................................................. 398
Preface 11
Billing ............................................................................................................................... 398
Markup plans ................................................................................................................... 399
Reseller DNS ............................................................................................................................. 400
Step 1. Adding Reseller CP Alias Template .................................................................... 400
Step 2. Configuring Reseller DNS Servers ..................................................................... 402
Creating And Editing Reseller Plans ......................................................................................... 403
Step 1. Configuring The Plan .......................................................................................... 403
Step 2 .............................................................................................................................. 406
Billing Resellers ......................................................................................................................... 410
Fees Collected From Resellers ....................................................................................... 410
Fees for services provided with reseller account ............................................................ 410
Fees for services distributed with user accounts ............................................................ 410
Charging Resellers for Traffic .......................................................................................... 411
Reseller Control Panel SSL ....................................................................................................... 413
Enabling Reseller Control Panel SSL Protection ............................................................ 414
Disabling Reseller Control Panel SSL Protection ........................................................... 418
Reseller Shared SSL ................................................................................................................. 418
Resellers' Own Wildcard Certificates .............................................................................. 419
Sharing Your Wildcard Certificates with Resellers .......................................................... 420
Placing Resellers on Separate Boxes ....................................................................................... 422
Allocating Physical Servers to Resellers ................................................................................... 426
Supporting Resellers' Customers .............................................................................................. 427
Deleting Resellers ...................................................................................................................... 428
Suspending And Resuming Resellers ....................................................................................... 429
Moving Accounts Between Resellers ........................................................................................ 430
Account Management 431
Finding User Accounts............................................................................................................... 432
Generic Search................................................................................................................ 433
Search by Domain Name ................................................................................................ 434
Search by Contact Info .................................................................................................... 434
Search in Resellers ......................................................................................................... 435
Search Suspended Accounts .......................................................................................... 436
Search Deleted Accounts ................................................................................................ 437
Search Dedicated Server Accounts ................................................................................ 437
Search by VPS Hostname ............................................................................................... 437
Search by Account Balance ............................................................................................ 438
Search by Merchant Gateway Transactions ................................................................... 438
Search by Invoice/Balance Entries.................................................................................. 438
Search by Credit Card Charges ...................................................................................... 438
Search by Transfer Traffic ............................................................................................... 439
Search by Disk Usage ..................................................................................................... 439
Search by CC Processing Errors .................................................................................... 439
Search by Logical and Physical Servers ......................................................................... 440
Search by Reseller Traffic ............................................................................................... 440
Search by Resellers Disk Usage ..................................................................................... 440
User Details ............................................................................................................................... 441
Admin Notes .............................................................................................................................. 441
Crediting Accounts ..................................................................................................................... 442
Debiting Accounts ...................................................................................................................... 443
View debits ...................................................................................................................... 446
Deleting Accounts ...................................................................................................................... 447
Suspending and Resuming Accounts........................................................................................ 448
Suspending Accounts ...................................................................................................... 450
Resuming Accounts ........................................................................................................ 451
Restoring Accounts.................................................................................................................... 452
Reports ...................................................................................................................................... 453
Exporting Reports ............................................................................................................ 454
Preface 12
Billing Balance ................................................................................................................. 455
Estimated balance exhaustion date ................................................................................ 456
Daily Report ..................................................................................................................... 457
Web Payments Log ......................................................................................................... 458
Charge Log ...................................................................................................................... 459
Registrar Log ................................................................................................................... 460
Credit Card Charge ......................................................................................................... 461
Billing Entries ................................................................................................................... 462
Signup/Go-away Statistics .............................................................................................. 464
Monthly Revenue ............................................................................................................ 465
Monetary Transactions .................................................................................................... 466
Transfer Traffic Report .................................................................................................... 467
Disk Usage Report .......................................................................................................... 469
Reseller Traffic Report .................................................................................................... 470
In Resellers Disk Usage Report ...................................................................................... 471
IP Addresses Report ....................................................................................................... 472
CC Processing Errors Report .......................................................................................... 473
Account Check ................................................................................................................ 473
Reports Installed in a Package ........................................................................................ 474
Processing Check Payments ..................................................................................................... 481
Setting up the Check Mailing Address ............................................................................ 482
Setting E-mail .................................................................................................................. 482
Moderating Accounts ....................................................................................................... 482
Turning Off Check Payments For the Entire System ...................................................... 484
Splitting Multiple Accounts ......................................................................................................... 485
Granting SSH Access To Users ................................................................................................ 486
Customer Signup 488
Signing Up Users ....................................................................................................................... 488
Signing Up Users from Admin Control Panel .................................................................. 489
Signing Up Users from the Street .................................................................................... 490
Moderating User Signups .......................................................................................................... 491
Moderated Signups ......................................................................................................... 491
Email Notifications ........................................................................................................... 491
Activating Or Rejecting Signups ...................................................................................... 492
Changing Details of Moderated Accounts ....................................................................... 492
Moderated Credit Card Signup ........................................................................................ 493
Signup Guard Settings .............................................................................................................. 494
Creating moderation rules ............................................................................................... 494
Setting Signup Guard Blacklist ........................................................................................ 496
Viewing Signup Info ................................................................................................................... 497
Signup IPs ....................................................................................................................... 497
Signup Statistics .............................................................................................................. 498
Trial Hosting ............................................................................................................................... 499
Introduction to Trial Hosting ............................................................................................ 499
Managing Trial Accounts ................................................................................................. 499
Enabling Trial Registration .............................................................................................. 500
Grouping Trial Plans ........................................................................................................ 501
Managing Trial Accounts ................................................................................................. 502
Enabling Trial Registration .............................................................................................. 503
Grouping Trial Plans ........................................................................................................ 504
Migration 505
Moving Domains Between Accounts ......................................................................................... 505
Domain Move Requirements ........................................................................................... 505
Moving Domains with Domain Mover .............................................................................. 506
Compatibility .................................................................................................................... 507
Preface 13
Manual Domain Move ..................................................................................................... 507
Moving Accounts Between Servers ........................................................................................... 508
Account move implies: .................................................................................................... 508
Cautions .......................................................................................................................... 508
Requirements .................................................................................................................. 509
Procedure ........................................................................................................................ 510
Migrating Individual Cobalt RAQ4 Accounts to Parallels H-Sphere .......................................... 511
Migration Procedure ........................................................................................................ 512
Billing Issues .................................................................................................................... 515
Migrating Individual cPanel Accounts to Parallels H-Sphere .................................................... 516
Preparing for Migration .................................................................................................... 516
Migration Procedure ........................................................................................................ 517
Billing Issues .................................................................................................................... 519
Migrating Individual Ensim Accounts to Parallels H-Sphere ..................................................... 520
Preparing for Migration .................................................................................................... 521
Migration Procedure ........................................................................................................ 522
Migration Notes ............................................................................................................... 525
Billing Issues .................................................................................................................... 525
Migrating Mass Accounts to Parallels H-Sphere ....................................................................... 526
Preparing for Migration .................................................................................................... 526
Migration Procedure ........................................................................................................ 526
Billing Issues .................................................................................................................... 527
Technical Support 528
Client Support Center ................................................................................................................ 529
Configuring Administration Security ................................................................................ 530
Managing Trouble Tickets ............................................................................................... 531
Task System .................................................................................................................... 535
Searching Trouble Tickets ............................................................................................... 536
Exchanging Private Messages ........................................................................................ 537
Managing KnowledgeBase .............................................................................................. 538
Ticket Statistics................................................................................................................ 538
Ticket Queues ................................................................................................................. 539
Supporting Reseller End Users ....................................................................................... 540
Configuring Support Center ....................................................................................................... 541
Knowledge Base ........................................................................................................................ 544
Creating Knowledge Bases ............................................................................................. 546
Editing and Removing Knowledge Bases ....................................................................... 547
Exporting Knowledge Base ............................................................................................. 548
Importing Knowledge Bases ............................................................................................ 548
Spellcheck ....................................................................................................................... 549
Search ............................................................................................................................. 549
Settings ............................................................................................................................ 550
Custom Jobs .............................................................................................................................. 551
Adding Custom Jobs ....................................................................................................... 552
Adding Tasks to Custom Jobs ......................................................................................... 553
Tracking Custom Job Status ........................................................................................... 554
Mass Mail ................................................................................................................................... 555
Crash Report ............................................................................................................................. 557
Installation ....................................................................................................................... 557
Update ............................................................................................................................. 558
Changing E-Mail Address Where Reports Are Sent ....................................................... 559
Sending Crash Reports ................................................................................................... 559
Extended Physical Server Information ............................................................................ 561
Preface 14
Parallels Virtuozzo Containers 562
Setting Up Parallels Virtuozzo Containers Node Server ........................................................... 563
Creating Virtuozzo Plans ........................................................................................................... 565
Creating Virtuozzo Plan Groups ................................................................................................ 566
Signing Up Users for Virtuozzo Plans ....................................................................................... 567
Parallels Sitebuilder Integration 568
Setting Up Parallels Sitebuilder ................................................................................................. 569
Licensing Parallels Sitebuilder Accounts ................................................................................... 570
Configuring Access to Parallels Sitebuilder Plans from Parallels H-Sphere Plans ................... 571
Migrating from Parallels SiteStudio to Parallels Sitebuilder ...................................................... 572
Third Party Products 573
Urchin ........................................................................................................................................ 574
Miva Kit (intro) ............................................................................................................................ 575
How Does It Work? ......................................................................................................... 575
Adding Miva Merchant Licenses ................................................................................................ 576
Affiliate Programs ...................................................................................................................... 577
How Do Affiliate Programs Work? ................................................................................... 578
How Do I Set Up an Affiliate Program? ........................................................................... 579
Kanoodleâ„¢ Support .................................................................................................................. 581
AWStats Support ....................................................................................................................... 582
Setup ............................................................................................................................... 582
Configuration on Unix/Linux ............................................................................................ 582
Configuration on Windows .............................................................................................. 583
SpamAssassin Configuration Manager ..................................................................................... 584
In this chapter:
Typographical Conventions ............................................................................... 15
Feedback .......................................................................................................... 16
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
16 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.
Parallels H-Sphere Administrator guide aims at hosting providers and explains how to
configure and administer Parallels H-Sphere control panel.
C H A P T E R 2
About This Guide
Parallels H-Sphere is a comprehensive hosting automation system that allows you to
provide a heterogeneous operating system environment to your customers across
multiple servers. It can manage hosting servers located in various data centers.
Parallels H-Sphere can have a multiple server layout, called a cluster. The main server
in the cluster is the actual Parallels H-Sphere Control Panel, a web application with
graphical interface, which centralizes all hosting management tasks, controls all hosting
servers and services, manages users, domains, events, and processes. Through
Parallels H-Sphere web interface, you can configure and manage these and other
subsystems, other servers (on page 18), user accounts and domains, etc. All system
data, such as billing, domain, and other info, is stored in the Postgres system database.
The Control panel consists of many subsystems, the major of them described below.
In this chapter:
DNS Management ............................................................................................. 19
Server Management .......................................................................................... 20
User Signup ...................................................................................................... 20
Billing And Plan Management............................................................................ 21
Merchant Gateway Management ....................................................................... 21
User/Account/Domain Management .................................................................. 22
Resellers ........................................................................................................... 23
Domain Management ........................................................................................ 24
SSL ................................................................................................................... 25
Support Center .................................................................................................. 26
Look and Feel Management .............................................................................. 26
C H A P T E R 3
Introduction To Parallels H-Sphere
Introduction To Parallels H-Sphere 19
DNS Management
All DNS is managed by Parallels H-Sphere.
A typical Parallels H-Sphere setup requires one service domain name (example.com)
which is used as:
 the control panel domain (cp.example.com:8080 or cp.example.com:8443),
 web server domain (web1.example.com, web2.example.com),
 name server domain (ns1.example.com, ns2.example.com), etc.
It can also be used for third level hosting (on page 108) and instant access domain
aliases (on page 98), as well as to host the corporate (promotional) website. (on page
106)
The most typical configuration is to have two DNS servers, each on a separate box. In
case of one-server installations, you can put two DNS servers on one box (on page 53).
By default, Parallels H-Sphere randomly assigns primary and secondary DNS servers
for each domain to balance server load. If you want, you can assign master and slave
roles to DNS logical servers.
Parallels H-Sphere creates a zone file for each domain name on both name servers,
and allows end users to create custom DNS records through a web interface.
You can find more info on DNS Server Configuration in Understanding DNS Server
Configuration documentation in System Administrator Guide.
20 Introduction To Parallels H-Sphere
Server Management
We differentiate between physical and logical servers.
Physical servers (on page 35) are actually or virtually separate computers with their
own operating systems (Linux, FreeBSD Unix, or Windows). They can be emulated
with VMWare or other software packages.
Logical servers (on page 39) are programs that run on physical servers and process
client requests. For instance when we talk about web, mail, DNS, mysql and other
servers, we mean logical servers. A physical server can have one or more logical
servers running.
Logical servers of the same nature and purpose make a server group (on page 73). In
case of multiserver installations, logical servers of the same group are located on
different physical servers, and Parallels H-Sphere randomly chooses from them to
create user accounts, which evens server load and disk space usage.
In most instances, Parallels H-Sphere operates with logical servers, not physical
servers. We work with logical servers when we add IPs (on page 49), configure system
SMTP relays (on page 59), assign mail server roles, assign name server roles (on page
53), etc.
User Signup
To use hosting services, users (site owners and resellers) need to sign up for a hosting
plan.
Parallels H-Sphere offers fully automated user signup (on page 482) through the signup
wizard. Depending on the billing type and signup settings, accounts may not be created
until moderated by administrator (on page 491). For instance, an account may not be
immediately created because it was blacklisted by Signup Guard (on page 494) or
because the user doesn't pay with a credit card.
Depending on the plan, access to the signup wizard can be unrestricted (available
"from the street") or allowed only from the admin control panel. Registration "from the
street" can be performed by anybody without admin's interaction. Registration from the
admin control panel goes through exactly the same steps, but can be performed only
by the administrator. The latter is the only way to sign users up for publicly unavailable
plans.
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
/
