Parallels H-Sphere 3.3, H-Sphere 3.5 User guide

  • Hello! I am an AI chatbot trained to assist you with the Parallels H-Sphere 3.3 User guide. I’ve already reviewed the document and can help you find the information you need or explain it in simple terms. Just ask your questions, and providing more details will help me assist you more effectively!
Revision 1.0
Parallels
®
H-Sphere
Parallels H-Sphere 3.5
Administrator Guide
Parallels H-Sphere 3.5
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
Distribution of this work or derivative of this work in any form is prohibited unless prior
written permission is obtained from the copyright holder.
Product and service names mentioned herein are the 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.4 or higher ................................................................. 27
Upgrading Parallels H-Sphere Accounts ........................................................................... 28
Getting Started 29
Step1. Disable Global Resources ................................................................................................ 30
Step 2. Set up a Domain Registrar .............................................................................................. 31
Step 3. Configure Mail Notification Addresses ............................................................................ 31
Step 4. Set up Payment Settings ................................................................................................. 31
Step 5. Create Plans.................................................................................................................... 32
Step 6. Create Billing Periods ...................................................................................................... 32
Step 7. Configure Support Center ............................................................................................... 33
Step 8. Configure Look and Feel ................................................................................................. 33
Server Configuration 34
Physical Servers .......................................................................................................................... 34
Adding Physical Servers ................................................................................................... 35
Physical Server Controls ................................................................................................... 36
Deleting a Physical Server ................................................................................................ 37
Logical Servers ............................................................................................................................ 37
Adding Logical Servers ..................................................................................................... 38
Enabling User Signup on Logical Servers ......................................................................... 39
Removing Logical Servers ................................................................................................ 40
Setting Logical Server Additional Options ......................................................................... 40
Adding IPs ................................................................................................................................... 45
Preface 4
DNS Servers ................................................................................................................................ 48
Mail Server Settings..................................................................................................................... 49
SPF and SRS .............................................................................................................................. 50
Enabling SPF and SRS ..................................................................................................... 50
Configuring SPF and SRS ................................................................................................. 51
AntiSpam and AntiVirus ............................................................................................................... 52
Enabling AntiSpam and AntiVirus in Control Panel........................................................... 52
Configuring AntiSpam and AntiVirus Default Settings ...................................................... 53
System SMTP Relays .................................................................................................................. 54
Advanced Web Server Settings ................................................................................................... 55
Apache Version ................................................................................................................. 55
Apache Modules ................................................................................................................ 56
Using Gotroot.com Modsecurityâ„¢ Rules With H-Sphere ................................................. 58
PHP Modes ....................................................................................................................... 61
PHP Plugins ...................................................................................................................... 64
PHP Accelerators .............................................................................................................. 65
Server Groups ............................................................................................................................. 66
Load Balanced Server Clusters ................................................................................................... 68
Platform Change .......................................................................................................................... 69
Updating Physical Boxes From CP Interface .............................................................................. 72
Procedure .......................................................................................................................... 73
Physical Server Installation/Update Profiles ................................................................................ 74
Resource Prerequisites ............................................................................................................... 78
System Service Management ...................................................................................................... 82
DNS and Hosting 84
DNS Manager .............................................................................................................................. 84
Adding DNS Zones ...................................................................................................................... 85
Instant Alias Templates ............................................................................................................... 87
Adding Instant Alias Templates ......................................................................................... 87
Editing Instant Alias Templates ......................................................................................... 89
DNS Records ............................................................................................................................... 90
Adding custom A records .................................................................................................. 91
Adding custom MX records ............................................................................................... 92
Adding custom CNAME records ........................................................................................ 92
Re-generating System Custom DNS Records .................................................................. 94
Hosting Your Corporate Site ........................................................................................................ 94
Step 1. Make sure you have a service DNS zone ............................................................. 94
Step 2. Create a service plan ............................................................................................ 95
Step 3. Disallow signups from outside your admin account. ............................................. 95
Step 4. Create a service account ...................................................................................... 96
Adding Domains for Third Level Hosting ..................................................................................... 96
Providing Mail Under Service Domain for Third-Level Hosting ................................................... 96
Control Panel Web Interface 98
Regional Settings ......................................................................................................................... 98
Images and Icons ...................................................................................................................... 100
Logo Images .................................................................................................................... 101
Icons And Control Images ............................................................................................... 102
Interface Texts ........................................................................................................................... 103
Login Texts ...................................................................................................................... 103
Signup Texts .................................................................................................................... 103
Miscellaneous Texts ........................................................................................................ 103
Skins and Colors ........................................................................................................................ 104
Disabling CP Skins .................................................................................................................... 106
Disabling CP Skins globally ............................................................................................. 106
Disabling CP Skins for reseller plans .............................................................................. 106
Preface 5
Setting Interface Language ....................................................................................................... 106
Setting Default System Language ................................................................................... 107
Setting Admin Interface Language .................................................................................. 107
E-Mail Notifications 108
Setting E-Mail Notification Recipients ........................................................................................ 109
Editing E-Mail Notifications ........................................................................................................ 110
Configuring User Notification Rules ........................................................................................... 115
Online Invoices ................................................................................................................ 115
"No Charge" Notifications ................................................................................................ 116
Control Panel Configuration 117
Entering Company Information .................................................................................................. 118
Disabling Global Resources, Hosting Platforms And Reseller CP SSL .................................... 119
Using Background Job Manager ............................................................................................... 122
Supported TLD's ........................................................................................................................ 126
Installing Shared SSL Certificates ............................................................................................. 127
Shared SSL installation wizard ........................................................................................ 129
Managing Mail SSL.................................................................................................................... 131
Enabling Mail SSL ........................................................................................................... 131
Editing Mail SSL .............................................................................................................. 133
Reposting Certificates ..................................................................................................... 135
Disabling Mail SSL .......................................................................................................... 135
Using Credit Card Encryption .................................................................................................... 135
Turning On ....................................................................................................................... 136
Loading Private Key ........................................................................................................ 138
Turning Off ....................................................................................................................... 139
If You Lose Your Private Key .......................................................................................... 139
Adding Credit Card Brands ........................................................................................................ 140
Domain Registrars 141
Domain Registrar Manager ....................................................................................................... 141
Configuring Domain Registration Settings ...................................................................... 142
Step 1. Creating Connections with Domain Registrars ................................................... 142
Step 2. Associating Top Level Domains with Domain Registrars ................................... 142
Step 3. Setting Default Domain Registration Prices........................................................ 144
Step 4. Configuring Registrar Connections for Resellers ............................................... 144
Editing Registrar Connection Settings ............................................................................ 145
Removing TLD Associations ........................................................................................... 145
Deleting Registrar Connections ....................................................................................... 145
Enom Configuration ................................................................................................................... 146
Setting Up Enom Connection .......................................................................................... 146
OpenSRS Configuration ............................................................................................................ 148
Setting Up OpenSRS Connection ................................................................................... 148
Asynchronous Response Management .......................................................................... 150
OnlineNIC Configuration ............................................................................................................ 152
Getting Prepared ............................................................................................................. 152
Setting Up OnlineNIC Connection ................................................................................... 152
RRPproxy Configuration ............................................................................................................ 154
Setting Up RRPproxy Connection ................................................................................... 154
Ascionic Configuration ............................................................................................................... 156
Setting Up Ascionic Connection ...................................................................................... 156
TPPInternet Configuration ......................................................................................................... 158
Setting Up TPPInternet Connection ................................................................................ 158
Email Domain Registration ........................................................................................................ 160
Preface 6
Configuring Email Registrar ............................................................................................ 161
Merchant Gateways 164
Merchant Gateway Manager ..................................................................................................... 165
Setting Up Merchant Gateway ........................................................................................ 166
Editing Merchant Gateway Settings ................................................................................ 166
Associating Merchant Gateways with Credit Card Vendors ........................................... 167
Editing Description for User Credit Card Statements ...................................................... 167
Handling CC Charge Request Failures ........................................................................... 168
One Step Gateways ........................................................................................................ 169
AssureBuy Configuration ........................................................................................................... 169
Preparation ...................................................................................................................... 169
Configuration ................................................................................................................... 170
AuthorizeNet (Sim Protocol) Configuration ............................................................................... 171
Preparation ...................................................................................................................... 171
Configuration ................................................................................................................... 172
Bibit Configuration ..................................................................................................................... 174
Preparation ...................................................................................................................... 174
Configuration ................................................................................................................... 174
Cardia Services Configuration ................................................................................................... 175
Preparation ...................................................................................................................... 175
Configuration ................................................................................................................... 175
ECHO Configuration .................................................................................................................. 176
Preparation ...................................................................................................................... 176
Configuration ................................................................................................................... 176
ePDQ Configuration................................................................................................................... 177
Preparation ...................................................................................................................... 177
Configuration ................................................................................................................... 178
eWay Configuration ................................................................................................................... 179
Preparation ...................................................................................................................... 179
Configuration ................................................................................................................... 179
HSBC Configuration .................................................................................................................. 180
Preparation ...................................................................................................................... 180
Configuration ................................................................................................................... 180
Innovative Gateway Configuration ............................................................................................. 181
Preparation ...................................................................................................................... 181
Configuration ................................................................................................................... 181
LinkPoint (API v3.01) Configuration .......................................................................................... 182
Preparation ...................................................................................................................... 182
Configuration ................................................................................................................... 184
Moneris Configuration................................................................................................................ 185
Preparation ...................................................................................................................... 185
Configuration ................................................................................................................... 185
NetBilling Configuration ............................................................................................................. 187
Preparation ...................................................................................................................... 187
Configuration ................................................................................................................... 188
NTPNow Configuration .............................................................................................................. 188
Preparation ...................................................................................................................... 188
Configuration ................................................................................................................... 188
Paradata Configuration .............................................................................................................. 190
Preparation ...................................................................................................................... 190
Configuration ................................................................................................................... 190
PayGate Configuration .............................................................................................................. 191
Preparation ...................................................................................................................... 191
Configuration ................................................................................................................... 191
PayJunction Configuration ......................................................................................................... 192
Preparation ...................................................................................................................... 192
Configuration ................................................................................................................... 192
Preface 7
Plug'n Pay Configuration ........................................................................................................... 194
Preparation ...................................................................................................................... 194
Configuration ................................................................................................................... 194
Pay-Me-Now Configuration ....................................................................................................... 196
Preparation ...................................................................................................................... 196
Configuration ................................................................................................................... 196
PosNet Configuration................................................................................................................. 197
Preparation ...................................................................................................................... 197
Configuration ................................................................................................................... 197
Protx (VSP Direct Protocol 2.22) Configuration ........................................................................ 198
Preparation ...................................................................................................................... 198
Configuration ................................................................................................................... 198
PSiGate (XML API) Configuration ............................................................................................. 199
Preparation ...................................................................................................................... 199
Configuration ................................................................................................................... 199
SecurePay Configuration ........................................................................................................... 200
Preparation ...................................................................................................................... 200
Configuration ................................................................................................................... 200
SkipJack Configuration .............................................................................................................. 202
Preparation ...................................................................................................................... 202
Configuration ................................................................................................................... 203
SecurePay.com.au Configuration .............................................................................................. 204
Preparation ...................................................................................................................... 204
Configuration ................................................................................................................... 204
SecureTrading Configuration ..................................................................................................... 205
Preparation ...................................................................................................................... 205
Configuration ................................................................................................................... 206
ThePayDesk Configuration ........................................................................................................ 207
Preparation ...................................................................................................................... 207
Configuration ................................................................................................................... 208
Tucows Configuration ................................................................................................................ 209
Preparation ...................................................................................................................... 209
Configuration ................................................................................................................... 210
VeriSign PayFlow Pro Configuration ......................................................................................... 211
Preparation ...................................................................................................................... 211
Configuration ................................................................................................................... 212
VeriSign PayFlow Pro With SSL Support .................................................................................. 214
Preparation ...................................................................................................................... 214
Configuration ................................................................................................................... 214
Web-based Payments 216
Web Payment Systems Manager .............................................................................................. 217
Work Principles................................................................................................................ 217
Configuration Procedure ................................................................................................. 217
Setting Web Payment Instant Notification URL ............................................................... 218
2CheckOut Configuration .......................................................................................................... 219
Authorize.Net (Sim Protocol) Configuration .............................................................................. 220
Setting Up Authorize.Net ................................................................................................. 220
ChronoPay Configuration .......................................................................................................... 222
Setting Up ChronoPay ..................................................................................................... 222
GestPay Configuration............................................................................................................... 223
PayNova Configuration .............................................................................................................. 224
PayPal Merchant Gateway Configuration ................................................................................. 225
Preparation ...................................................................................................................... 225
Configuration ................................................................................................................... 225
Sentry Configuration .................................................................................................................. 226
Preparation ...................................................................................................................... 226
Setup Procedure.............................................................................................................. 226
Preface 8
Webmoney Configuration .......................................................................................................... 228
1. Set your own purse ..................................................................................................... 228
2. Activate Webmoney payments in your Parallels H-Sphere control panel ................... 228
WorldPay Configuration ............................................................................................................. 230
Setting Up WorldPay ....................................................................................................... 230
Plans 232
Creating and Editing Plans (Plan Wizards) ............................................................................... 233
Starting Plan Creation Wizards ....................................................................................... 233
Starting Plan Edit Wizards ............................................................................................... 233
Simplified Plan Wizards ................................................................................................... 234
A Typical Web Hosting Plan Wizard .......................................................................................... 236
Step 1. Selecting Resources and Configuring Plan Settings .......................................... 236
Subsequent Steps. Setting Prices ................................................................................... 242
MySQL Plan Wizard .................................................................................................................. 243
Windows Plan Wizard ................................................................................................................ 243
Windows RealMedia Plan Wizard ............................................................................................. 244
E-mail Plan Wizard .................................................................................................................... 244
Markup Plan Wizard .................................................................................................................. 244
Admin Plans ............................................................................................................................... 245
Creating Admin Plans ...................................................................................................... 245
Editing Admin Plans ........................................................................................................ 246
Demo Plans ............................................................................................................................... 247
Access to Plans ......................................................................................................................... 250
Plan Controls ............................................................................................................................. 251
Show ................................................................................................................................ 252
Copy ................................................................................................................................ 252
Delete .............................................................................................................................. 252
Plan Settings .............................................................................................................................. 253
Controlling RAM And CPU Usage ............................................................................................. 255
Enable RLimit in Plans .................................................................................................... 255
Configure RLimit Values .................................................................................................. 256
Limiting Resource Use For Individual Accounts .............................................................. 257
Placing Plans on Particular Boxes ............................................................................................. 258
Resources 261
Users, Accounts, Domains ........................................................................................................ 261
Users ............................................................................................................................... 262
Accounts .......................................................................................................................... 262
Domains .......................................................................................................................... 265
Traffic ......................................................................................................................................... 266
Traffic Calculation ............................................................................................................ 267
Traffic Limit ...................................................................................................................... 267
Traffic Pricing ................................................................................................................... 267
Restricting Traffic Usage and Traffic Limit ...................................................................... 268
Charging for Traffic .......................................................................................................... 269
Traffic Configuration Changes ......................................................................................... 275
Tracking End User Traffic Consumption ......................................................................... 276
Disk Space ................................................................................................................................. 276
Charging Users for Disk Space ....................................................................................... 277
Enabling/Disabling Summary Disk Usage ....................................................................... 278
Recreating Resources ............................................................................................................... 279
Blacklists in Parallels H-Sphere ................................................................................................. 280
Domains in blacklist ......................................................................................................... 280
Emails in blacklist ............................................................................................................ 281
Uploading and Exporting Black Lists ............................................................................... 281
Preface 9
Billing 283
Plans ................................................................................................................................ 283
Billing Types .................................................................................................................... 283
Trial Hosting .................................................................................................................... 283
Billing Profiles .................................................................................................................. 283
Prices ............................................................................................................................... 284
Limiting Resources .......................................................................................................... 284
Billing Periods .................................................................................................................. 284
Crediting Accounts .......................................................................................................... 284
Debiting Accounts ........................................................................................................... 284
Billing Modes ................................................................................................................... 285
Traffic ............................................................................................................................... 285
Disk Space ...................................................................................................................... 285
E-mailing Invoices ........................................................................................................... 285
Taxes ............................................................................................................................... 285
Promotions ...................................................................................................................... 285
Billing Resellers ............................................................................................................... 286
Managing Debtors ........................................................................................................... 286
Money Returns ................................................................................................................ 286
Billing Statements ............................................................................................................ 286
Billing Types .............................................................................................................................. 288
Billing Profiles ............................................................................................................................ 289
Billing Periods and Discounts .................................................................................................... 289
Default and Actual Billing Periods. Base Prices .............................................................. 289
Monthly and Billing Period Resources ............................................................................ 289
Opening a New Billing Period/Month............................................................................... 290
Creating and Configuring Actual Billing Periods ............................................................. 290
Changing Account's Billing Period ............................................................................................. 292
Changing Billing Period Start Date ............................................................................................ 293
Credit Limit ................................................................................................................................. 295
Setting Credit Limit in a Plan ........................................................................................... 296
Increasing Credit Limit for Individual Accounts ............................................................... 296
Resetting Credit Limit For All Users ................................................................................ 296
Fees Collected From Customers ............................................................................................... 297
Plan Fees ........................................................................................................................ 297
Free Units .................................................................................................................................. 298
Setting Prices and Free Units .................................................................................................... 299
Comments on Resources ................................................................................................ 299
Discounts ................................................................................................................................... 305
Billing Consequences of Editing Prices and Free Units ............................................................ 306
Taxes ......................................................................................................................................... 306
Tax Exemption ........................................................................................................................... 308
Enabling Tax Exemption ................................................................................................. 309
Setting Tax Exemption Mode at Signup .......................................................................... 309
Activating User Accounts with Tax Exemption Code Entered ........................................ 310
Money Returns .......................................................................................................................... 311
Events that Trigger Refunds ............................................................................................ 312
Refund Formulas ............................................................................................................. 312
Moneyback Period ........................................................................................................... 313
Reducing Quotas and Limits ........................................................................................... 313
Refund Percentage ......................................................................................................... 313
Managing Debtors ..................................................................................................................... 314
Punitive Measures ........................................................................................................... 314
Punitive Measures Automation ........................................................................................ 314
Start Date of Time in Debt ............................................................................................... 315
Promotions ................................................................................................................................. 315
Promotion Types ............................................................................................................. 315
Preface 10
Calculating Promotion Discounts .................................................................................... 316
Creating Promotions ........................................................................................................ 316
Associating Promotions With Plans................................................................................. 317
Extra Packages .......................................................................................................................... 318
Creating Extra Packs ....................................................................................................... 318
Managing Extra Packs .................................................................................................... 319
Anniversary Based Billing .......................................................................................................... 320
Switching Between Billing Modes .............................................................................................. 320
Sending "No charge" Notifications ............................................................................................. 321
Warning of Immediate Charges in Case of Buying Additional Resources ................................ 321
Dedicated Servers 322
Enabling Dedicated Servers in Globals ..................................................................................... 323
Adding MRTG Logical Servers and Network Switches ............................................................. 323
Adding MRTG Logical Servers ........................................................................................ 324
Adding Network Switches ................................................................................................ 324
Viewing MRTG Server Info .............................................................................................. 325
Creating/Managing Dedicated Server Templates ..................................................................... 326
Custom-built Dedicated Servers ...................................................................................... 327
Dedicated Server Plans ............................................................................................................. 327
User Plans ....................................................................................................................... 328
User's Choosing a Server at Signup ............................................................................... 329
Reseller Plans ................................................................................................................. 330
Managing Dedicated Servers .................................................................................................... 332
Adding Dedicated Servers ............................................................................................... 332
Editing Dedicated Servers ............................................................................................... 334
Deleting Dedicated Servers ............................................................................................. 335
Dedicated Server Status ............................................................................................................ 335
Assigning Additional IP Ranges ................................................................................................ 337
1. Set Prices for Extra IPs in Plans ................................................................................. 337
2. Add IP Subnet ............................................................................................................. 337
3. Split IP Subnet to Smaller IP Ranges ......................................................................... 338
4. Create PTR zone for Reverse DNS Records .............................................................. 339
5. Assign IP Range to Dedicated Server ......................................................................... 340
6. Unassign IP Range ..................................................................................................... 341
Billing Dedicated Servers .......................................................................................................... 341
Bandwidth Billing Types .................................................................................................. 342
Bandwidth Billing Types Options ..................................................................................... 343
Dedicated Servers' Maintenance ............................................................................................... 343
Regular Backups ............................................................................................................. 344
Maintenance Requests .................................................................................................... 344
Automatic Cancellation Settings...................................................................................... 345
Resellers 347
Plans ................................................................................................................................ 347
Dual Nature of Resellers ................................................................................................. 347
Private Label .................................................................................................................... 347
Look and Feel and Regional Settings ............................................................................. 348
Merchant Gateways ........................................................................................................ 348
Domain Registration ........................................................................................................ 348
Providing Support ............................................................................................................ 348
Control Panel ................................................................................................................... 348
Web, Mail, and SQL Resources ...................................................................................... 349
Servers ............................................................................................................................ 349
SSL .................................................................................................................................. 349
Billing ............................................................................................................................... 349
Markup plans ................................................................................................................... 349
Preface 11
Reseller DNS ............................................................................................................................. 351
Step 1. Adding Reseller CP Alias Template .................................................................... 351
Step 2. Configuring Reseller DNS Servers ..................................................................... 352
Creating And Editing Reseller Plans ......................................................................................... 353
Step 1. Configuring The Plan .......................................................................................... 353
Step 2 .............................................................................................................................. 357
Billing Resellers ......................................................................................................................... 360
Fees Collected From Resellers ....................................................................................... 360
Fees for services provided with reseller account ............................................................ 360
Fees for services distributed with user accounts ............................................................ 360
Charging Resellers for Traffic .......................................................................................... 361
Reseller Control Panel SSL ....................................................................................................... 363
Enabling Reseller Control Panel SSL Protection ............................................................ 364
Disabling Reseller Control Panel SSL Protection ........................................................... 368
Reseller Shared SSL ................................................................................................................. 368
Resellers' Own Wildcard Certificates .............................................................................. 368
Sharing Your Wildcard Certificates with Resellers .......................................................... 369
Placing Resellers on Separate Boxes ....................................................................................... 371
Allocating Physical Servers to Resellers ................................................................................... 374
Supporting Resellers' Customers .............................................................................................. 375
Deleting Resellers ...................................................................................................................... 375
Suspending And Resuming Resellers ....................................................................................... 376
Moving Accounts Between Resellers ........................................................................................ 376
Account Management 378
Finding User Accounts............................................................................................................... 379
Generic Search................................................................................................................ 380
Search by Domain Name ................................................................................................ 381
Search by Contact Info .................................................................................................... 381
Search in Resellers ......................................................................................................... 382
Search Suspended Accounts .......................................................................................... 383
Search Deleted Accounts ................................................................................................ 384
Search Dedicated Server Accounts ................................................................................ 384
Search by VPS Hostname ............................................................................................... 385
Search by Account Balance ............................................................................................ 385
Search by Merchant Gateway Transactions ................................................................... 385
Search by Invoice/Balance Entries.................................................................................. 385
Search by Credit Card Charges ...................................................................................... 385
Search by Transfer Traffic ............................................................................................... 386
Search by Disk Usage ..................................................................................................... 386
Search by CC Processing Errors .................................................................................... 386
Search by Logical and Physical Servers ......................................................................... 387
Search by Reseller Traffic ............................................................................................... 387
Search by Resellers Disk Usage ..................................................................................... 387
User Details ............................................................................................................................... 388
Admin Notes .............................................................................................................................. 388
Crediting Accounts ..................................................................................................................... 389
Debiting Accounts ...................................................................................................................... 390
View debits ...................................................................................................................... 392
Deleting Accounts ...................................................................................................................... 393
Suspending and Resuming Accounts........................................................................................ 394
Suspending Accounts ...................................................................................................... 396
Resuming Accounts ........................................................................................................ 397
Restoring Accounts.................................................................................................................... 397
Reports ...................................................................................................................................... 398
Exporting Reports ............................................................................................................ 400
Billing Balance ................................................................................................................. 400
Estimated balance exhaustion date ................................................................................ 402
Preface 12
Daily Report ..................................................................................................................... 403
Web Payments Log ......................................................................................................... 404
Charge Log ...................................................................................................................... 404
Registrar Log ................................................................................................................... 405
Credit Card Charge ......................................................................................................... 406
Billing Entries ................................................................................................................... 407
Signup/Go-away Statistics .............................................................................................. 408
Monthly Revenue ............................................................................................................ 409
Monetary Transactions .................................................................................................... 410
Transfer Traffic Report .................................................................................................... 411
Disk Usage Report .......................................................................................................... 412
Reseller Traffic Report .................................................................................................... 413
In Resellers Disk Usage Report ...................................................................................... 413
IP Addresses Report ....................................................................................................... 415
CC Processing Errors Report .......................................................................................... 415
Account Check ................................................................................................................ 416
Reports Installed in a Package ........................................................................................ 417
Processing Check Payments ..................................................................................................... 424
Setting up the Check Mailing Address ............................................................................ 425
Setting E-mail .................................................................................................................. 425
Moderating Accounts ....................................................................................................... 425
Turning Off Check Payments For the Entire System ...................................................... 426
Splitting Multiple Accounts ......................................................................................................... 427
Granting SSH Access To Users ................................................................................................ 428
Customer Signup 430
Signing Up Users ....................................................................................................................... 430
Signing Up Users from Admin Control Panel .................................................................. 430
Signing Up Users from the Street .................................................................................... 432
Moderating User Signups .......................................................................................................... 432
Moderated Signups ......................................................................................................... 432
Email Notifications ........................................................................................................... 433
Activating Or Rejecting Signups ...................................................................................... 433
Changing Details of Moderated Accounts ....................................................................... 433
Moderated Credit Card Signup ........................................................................................ 434
Signup Guard Settings .............................................................................................................. 435
Creating moderation rules ............................................................................................... 435
Setting Signup Guard Blacklist ........................................................................................ 437
Viewing Signup Info ................................................................................................................... 438
Signup IPs ....................................................................................................................... 438
Signup Statistics .............................................................................................................. 438
Trial Hosting ............................................................................................................................... 439
Introduction to Trial Hosting ............................................................................................ 439
Managing Trial Accounts ................................................................................................. 440
Enabling Trial Registration .............................................................................................. 441
Grouping Trial Plans ........................................................................................................ 442
Managing Trial Accounts ................................................................................................. 442
Enabling Trial Registration .............................................................................................. 443
Grouping Trial Plans ........................................................................................................ 443
Migration 445
Moving Domains Between Accounts ......................................................................................... 445
Domain Move Requirements ........................................................................................... 445
Moving Domains with Domain Mover .............................................................................. 446
Compatibility .................................................................................................................... 447
Manual Domain Move ..................................................................................................... 447
Moving Accounts Between Servers ........................................................................................... 447
Preface 13
Account move implies: .................................................................................................... 447
Cautions .......................................................................................................................... 448
Requirements .................................................................................................................. 448
Procedure ........................................................................................................................ 449
Migrating Individual Cobalt RAQ4 Accounts to Parallels H-Sphere .......................................... 450
Migration Procedure ........................................................................................................ 451
Billing Issues .................................................................................................................... 453
Migrating Individual cPanel Accounts to Parallels H-Sphere .................................................... 454
Preparing for Migration .................................................................................................... 454
Migration Procedure ........................................................................................................ 455
Billing Issues .................................................................................................................... 457
Migrating Individual Ensim Accounts to Parallels H-Sphere ..................................................... 458
Preparing for Migration .................................................................................................... 458
Migration Procedure ........................................................................................................ 459
Migration Notes ............................................................................................................... 462
Billing Issues .................................................................................................................... 462
Migrating Mass Accounts to Parallels H-Sphere ....................................................................... 463
Preparing for Migration .................................................................................................... 463
Migration Procedure ........................................................................................................ 463
Billing Issues .................................................................................................................... 464
Technical Support 465
Client Support Center ................................................................................................................ 466
Configuring Administration Security ................................................................................ 467
Managing Trouble Tickets ............................................................................................... 468
Task System .................................................................................................................... 471
Searching Trouble Tickets ............................................................................................... 472
Exchanging Private Messages ........................................................................................ 473
Managing KnowledgeBase .............................................................................................. 473
Ticket Statistics................................................................................................................ 474
Ticket Queues ................................................................................................................. 474
Supporting Reseller End Users ....................................................................................... 475
Configuring Support Center ....................................................................................................... 476
Knowledge Base ........................................................................................................................ 479
Creating Knowledge Bases ............................................................................................. 480
Editing and Removing Knowledge Bases ....................................................................... 480
Exporting Knowledge Base ............................................................................................. 481
Importing Knowledge Bases ............................................................................................ 482
Spellcheck ....................................................................................................................... 482
Search ............................................................................................................................. 483
Settings ............................................................................................................................ 483
Custom Jobs .............................................................................................................................. 484
Adding Custom Jobs ....................................................................................................... 485
Adding Tasks to Custom Jobs ......................................................................................... 485
Tracking Custom Job Status ........................................................................................... 487
Mass Mail ................................................................................................................................... 488
Crash Report ............................................................................................................................. 490
Installation ....................................................................................................................... 490
Update ............................................................................................................................. 491
Changing E-Mail Address Where Reports Are Sent ....................................................... 492
Sending Crash Reports ................................................................................................... 493
Extended Physical Server Information ............................................................................ 495
Parallels Virtuozzo Containers 496
Setting Up Parallels Virtuozzo Containers Node Server ........................................................... 497
Creating Virtuozzo Plans ........................................................................................................... 498
Creating Virtuozzo Plan Groups ................................................................................................ 499
Preface 14
Signing Up Users for Virtuozzo Plans ....................................................................................... 499
Parallels Sitebuilder Integration 500
Setting Up Parallels Sitebuilder ................................................................................................. 501
Licensing Parallels Sitebuilder Accounts ................................................................................... 502
Configuring Access to Parallels Sitebuilder Plans from Parallels H-Sphere Plans ................... 503
Migrating from Parallels SiteStudio to Parallels Sitebuilder ...................................................... 504
Third Party Products 505
Urchin ........................................................................................................................................ 505
Miva Kit (intro) ............................................................................................................................ 506
How Does It Work? ......................................................................................................... 506
Adding Miva Merchant Licenses ................................................................................................ 507
Affiliate Programs ...................................................................................................................... 508
How Do Affiliate Programs Work? ................................................................................... 509
How Do I Set Up an Affiliate Program? ........................................................................... 510
Kanoodleâ„¢ Support .................................................................................................................. 511
AWStats Support ....................................................................................................................... 512
Setup ............................................................................................................................... 513
Configuration on Unix/Linux ............................................................................................ 513
Configuration on Windows .............................................................................................. 513
SpamAssassin Configuration Manager ..................................................................................... 514
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............................................................................ 20
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 96) and instant access domain
aliases (on page 87), as well as to host the corporate (promotional) website. (on page
94)
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 48).
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 34) 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 37) 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 66). 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 44), configure system
SMTP relays (on page 54), assign mail server roles, assign name server roles (on page
48), 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 425) through the signup
wizard. Depending on the billing type and signup settings, accounts may not be created
until moderated by administrator (on page 432). For instance, an account may not be
immediately created because it was blacklisted by Signup Guard (on page 435) 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.
1/518