Parallels H-Sphere 3.1 User guide

  • Hello! I am an AI chatbot trained to assist you with the Parallels H-Sphere 3.1 User guide. I’ve already reviewed the document and can help you find the information you need or explain it in simple terms. Just ask your questions, and providing more details will help me assist you more effectively!
Parallels
®
H-Sphere
Legal and Copyright Notice
ISBN: N/A
Parallels
660 SW 39
th
Street
Suite 205
Renton, Washington 98057
USA
Phone: +1 (425) 282 6400
Fax: +1 (425) 282 6444
© Copyright 2008,
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
Getting Started 27
Step1. Disable Global Resources ................................................................................................ 28
Step 2. Set up a Domain Registrar .............................................................................................. 29
Step 3. Configure Mail Notification Addresses ............................................................................ 29
Step 4. Set up Payment Settings ................................................................................................. 30
Step 5. Create Plans.................................................................................................................... 31
Step 6. Create Billing Periods ...................................................................................................... 31
Step 7. Configure Support Center ............................................................................................... 32
Step 8. Configure Look and Feel ................................................................................................. 32
Server Configuration 33
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 ......................................................................... 40
Removing Logical Servers ................................................................................................ 41
Setting Logical Server Additional Options ......................................................................... 41
Adding IPs ................................................................................................................................... 46
DNS Servers ................................................................................................................................ 50
Mail Server Settings..................................................................................................................... 51
SPF and SRS .............................................................................................................................. 52
Enabling SPF and SRS ..................................................................................................... 52
Configuring SPF and SRS ................................................................................................. 53
AntiSpam and AntiVirus ............................................................................................................... 54
Enabling AntiSpam and AntiVirus in Control Panel........................................................... 54
Preface 4
Configuring AntiSpam and AntiVirus Default Settings ...................................................... 55
System SMTP Relays .................................................................................................................. 56
Advanced Web Server Settings ................................................................................................... 57
Apache Version ................................................................................................................. 57
Apache Modules ................................................................................................................ 58
PHP Modes ....................................................................................................................... 64
PHP Plugins ...................................................................................................................... 67
Server Groups ............................................................................................................................. 68
Load Balanced Server Clusters ................................................................................................... 71
Platform Change .......................................................................................................................... 73
Updating Physical Boxes From CP Interface .............................................................................. 76
Procedure .......................................................................................................................... 76
Physical Server Installation/Update Profiles ................................................................................ 77
Resource Prerequisites ............................................................................................................... 81
System Service Management ...................................................................................................... 85
DNS and Hosting 87
DNS Manager .............................................................................................................................. 88
Adding DNS Zones ...................................................................................................................... 88
Instant Alias Templates ............................................................................................................... 90
Adding Instant Alias Templates ......................................................................................... 91
Editing Instant Alias Templates ......................................................................................... 93
DNS Records ............................................................................................................................... 94
Adding custom A records .................................................................................................. 95
Adding custom MX records ............................................................................................... 96
Adding custom CNAME records ........................................................................................ 96
Re-generating System Custom DNS Records .................................................................. 98
Hosting Your Corporate Site ........................................................................................................ 98
Step 1. Make sure you have a service DNS zone ............................................................. 98
Step 2. Create a service plan ............................................................................................ 99
Step 3. Disallow signups from outside your admin account. ........................................... 100
Step 4. Create a service account .................................................................................... 100
Adding Domains for Third Level Hosting ................................................................................... 101
Providing Mail Under Service Domain for Third-Level Hosting ................................................. 101
Control Panel Web Interface 102
Regional Settings ....................................................................................................................... 103
Images and Icons ...................................................................................................................... 105
Logo Images .................................................................................................................... 105
Icons And Control Images ............................................................................................... 107
Interface Texts ........................................................................................................................... 109
Login Texts ...................................................................................................................... 109
Signup Texts .................................................................................................................... 109
Miscellaneous Texts ........................................................................................................ 109
Skins and Colors ........................................................................................................................ 110
Disabling CP Skins .................................................................................................................... 112
Disabling CP Skins globally ............................................................................................. 112
Disabling CP Skins for reseller plans .............................................................................. 112
Setting Interface Language ....................................................................................................... 113
Setting Default System Language ................................................................................... 113
Setting Admin Interface Language .................................................................................. 113
E-Mail Notifications 114
Setting E-Mail Notification Recipients ........................................................................................ 115
Editing E-Mail Notifications ........................................................................................................ 116
Preface 5
Configuring User Notification Rules ........................................................................................... 121
Online Invoices ................................................................................................................ 122
No Charge Notifications ................................................................................................ 123
Control Panel Configuration 124
Entering Company Information .................................................................................................. 125
Disabling Global Resources, Hosting Platforms And Reseller CP SSL .................................... 126
Using Background Job Manager ............................................................................................... 129
Manipulating Cron Jobs ................................................................................................... 129
Cron Job Details .............................................................................................................. 132
Current Jobs .................................................................................................................... 133
Supported TLDs ........................................................................................................................ 133
Installing Shared SSL Certificates ............................................................................................. 134
Shared SSL installation wizard ........................................................................................ 136
Managing Mail SSL.................................................................................................................... 138
Enabling Mail SSL ........................................................................................................... 139
Editing Mail SSL .............................................................................................................. 141
Reposting Certificates ..................................................................................................... 142
Disabling Mail SSL .......................................................................................................... 143
Using Credit Card Encryption .................................................................................................... 143
Turning On ....................................................................................................................... 143
Loading Private Key ........................................................................................................ 145
Turning Off ....................................................................................................................... 146
If You Lose Your Private Key .......................................................................................... 146
Adding Credit Card Brands ........................................................................................................ 147
Domain Registrars 148
Domain Registrar Manager ....................................................................................................... 149
Configuring Domain Registration Settings ...................................................................... 149
Step 1. Creating Connections with Domain Registrars ................................................... 150
Step 2. Associating Top Level Domains with Domain Registrars ................................... 150
Step 3. Setting Default Domain Registration Prices........................................................ 151
Step 4. Configuring Registrar Connections for Resellers ............................................... 151
Editing Registrar Connection Settings ............................................................................ 152
Removing TLD Associations ........................................................................................... 152
Deleting Registrar Connections ....................................................................................... 152
Enom Configuration ................................................................................................................... 153
Setting Up Enom Connection .......................................................................................... 153
OpenSRS Configuration ............................................................................................................ 155
Setting Up OpenSRS Connection ................................................................................... 156
Asynchronous Response Management .......................................................................... 158
OnlineNIC Configuration ............................................................................................................ 160
Getting Prepared ............................................................................................................. 160
Setting Up OnlineNIC Connection ................................................................................... 160
RRPproxy Configuration ............................................................................................................ 162
Setting Up RRPproxy Connection ................................................................................... 162
Ascionic Configuration ............................................................................................................... 164
Setting Up Ascionic Connection ...................................................................................... 164
TPPInternet Configuration ......................................................................................................... 166
Setting Up TPPInternet Connection ................................................................................ 166
Email Domain Registration ........................................................................................................ 168
Configuring Email Registrar ............................................................................................ 169
Merchant Gateways 172
Merchant Gateway Manager ..................................................................................................... 173
Preface 6
Setting Up Merchant Gateway ........................................................................................ 174
Editing Merchant Gateway Settings ................................................................................ 174
Associating Merchant Gateways with Credit Card Vendors ........................................... 175
Editing Description for User Credit Card Statements ...................................................... 175
Handling CC Charge Request Failures ........................................................................... 176
One Step Gateways ........................................................................................................ 177
AssureBuy Configuration ........................................................................................................... 177
Preparation ...................................................................................................................... 177
Configuration ................................................................................................................... 177
AuthorizeNet (Sim Protocol) Configuration ............................................................................... 180
Preparation ...................................................................................................................... 180
Configuration ................................................................................................................... 180
Bibit Configuration ..................................................................................................................... 182
Preparation ...................................................................................................................... 182
Configuration ................................................................................................................... 182
Cardia Services Configuration ................................................................................................... 183
Preparation ...................................................................................................................... 183
Configuration ................................................................................................................... 183
ECHO Configuration .................................................................................................................. 184
Preparation ...................................................................................................................... 184
Configuration ................................................................................................................... 184
ePDQ Configuration................................................................................................................... 185
Preparation ...................................................................................................................... 185
Configuration ................................................................................................................... 185
eWay Configuration ................................................................................................................... 187
Preparation ...................................................................................................................... 187
Configuration ................................................................................................................... 187
HSBC Configuration .................................................................................................................. 188
Preparation ...................................................................................................................... 188
Configuration ................................................................................................................... 188
Innovative Gateway Configuration ............................................................................................. 189
Preparation ...................................................................................................................... 189
Configuration ................................................................................................................... 189
LinkPoint (API v3.01) Configuration .......................................................................................... 190
Preparation ...................................................................................................................... 190
Configuration ................................................................................................................... 191
Moneris Configuration................................................................................................................ 194
Preparation ...................................................................................................................... 194
Configuration ................................................................................................................... 194
NetBilling Configuration ............................................................................................................. 195
Preparation ...................................................................................................................... 195
Configuration ................................................................................................................... 196
NTPNow Configuration .............................................................................................................. 197
Preparation ...................................................................................................................... 197
Configuration ................................................................................................................... 197
Paradata Configuration .............................................................................................................. 199
Preparation ...................................................................................................................... 199
Configuration ................................................................................................................... 199
PayGate Configuration .............................................................................................................. 200
Preparation ...................................................................................................................... 200
Configuration ................................................................................................................... 200
PayJunction Configuration ......................................................................................................... 202
Preparation ...................................................................................................................... 202
Configuration ................................................................................................................... 202
Plugn Pay Configuration ........................................................................................................... 204
Preparation ...................................................................................................................... 204
Configuration ................................................................................................................... 204
Pay-Me-Now Configuration ....................................................................................................... 206
Preparation ...................................................................................................................... 206
Preface 7
Configuration ................................................................................................................... 206
PosNet Configuration................................................................................................................. 207
Preparation ...................................................................................................................... 207
Configuration ................................................................................................................... 207
Protx (VSP Direct Protocol 2.22) Configuration ........................................................................ 208
Preparation ...................................................................................................................... 208
Configuration ................................................................................................................... 208
PSiGate (XML API) Configuration ............................................................................................. 209
Preparation ...................................................................................................................... 209
Configuration ................................................................................................................... 209
SecurePay Configuration ........................................................................................................... 211
Preparation ...................................................................................................................... 211
Configuration ................................................................................................................... 211
SkipJack Configuration .............................................................................................................. 212
Preparation ...................................................................................................................... 212
Configuration ................................................................................................................... 213
SecurePay.com.au Configuration .............................................................................................. 214
Preparation ...................................................................................................................... 214
Configuration ................................................................................................................... 214
SecureTrading Configuration ..................................................................................................... 215
Preparation ...................................................................................................................... 215
Configuration ................................................................................................................... 215
ThePayDesk Configuration ........................................................................................................ 217
Preparation ...................................................................................................................... 217
Configuration ................................................................................................................... 218
Tucows Configuration ................................................................................................................ 219
Preparation ...................................................................................................................... 219
Configuration ................................................................................................................... 219
VeriSign PayFlow Pro Configuration ......................................................................................... 221
Preparation ...................................................................................................................... 221
Configuration ................................................................................................................... 221
VeriSign PayFlow Pro With SSL Support .................................................................................. 223
Preparation ...................................................................................................................... 223
Configuration ................................................................................................................... 223
Web-based Payments 226
Web Payment Systems Manager .............................................................................................. 227
Work Principles................................................................................................................ 227
Configuration Procedure ................................................................................................. 227
Setting Web Payment Instant Notification URL ............................................................... 228
2CheckOut Configuration .......................................................................................................... 229
Authorize.Net (Sim Protocol) Configuration .............................................................................. 230
Setting Up Authorize.Net ................................................................................................. 230
ChronoPay Configuration .......................................................................................................... 232
Setting Up ChronoPay ..................................................................................................... 232
GestPay Configuration............................................................................................................... 233
PayNova Configuration .............................................................................................................. 234
PayPal Merchant Gateway Configuration ................................................................................. 235
Preparation ...................................................................................................................... 235
Configuration ................................................................................................................... 235
Sentry Configuration .................................................................................................................. 236
Preparation ...................................................................................................................... 236
Setup Procedure.............................................................................................................. 236
Webmoney Configuration .......................................................................................................... 238
1. Set your own purse ..................................................................................................... 238
2. Activate Webmoney payments in your Parallels H-Sphere control panel ................... 238
WorldPay Configuration ............................................................................................................. 239
Setting Up WorldPay ....................................................................................................... 239
Preface 8
Plans 241
Creating and Editing Plans (Plan Wizards) ............................................................................... 242
Starting Plan Creation Wizards ....................................................................................... 242
Starting Plan Edit Wizards ............................................................................................... 242
Simplified Plan Wizards ................................................................................................... 243
A Typical Plan Wizard................................................................................................................ 245
Step 1. Selecting Resources and Configuring Plan Settings .......................................... 246
Subsequent Steps. Setting Prices ................................................................................... 257
MySQL Plan Wizard .................................................................................................................. 258
Windows Plan Wizard ................................................................................................................ 258
Windows RealMedia Plan Wizard ............................................................................................. 259
E-mail Plan Wizard .................................................................................................................... 259
VPS Plan Wizard ....................................................................................................................... 259
Markup Plan Wizard .................................................................................................................. 260
Admin Plans ............................................................................................................................... 261
Creating Admin Plans ...................................................................................................... 261
Editing Admin Plans ........................................................................................................ 262
Demo Plans ............................................................................................................................... 263
Access to Plans ......................................................................................................................... 266
Plan Controls ............................................................................................................................. 267
Show ................................................................................................................................ 268
Copy ................................................................................................................................ 268
Delete .............................................................................................................................. 268
Plan Settings .............................................................................................................................. 269
Controlling RAM And CPU Usage ............................................................................................. 271
Enable RLimit in Plans .................................................................................................... 271
Configure RLimit Values .................................................................................................. 272
Limiting Resource Use For Individual Accounts .............................................................. 272
Placing Plans on Particular Boxes ............................................................................................. 273
Resources 276
Users, Accounts, Domains ........................................................................................................ 277
Users ............................................................................................................................... 277
Accounts .......................................................................................................................... 277
Domains .......................................................................................................................... 280
Traffic ......................................................................................................................................... 281
Traffic Calculation ............................................................................................................ 281
Traffic Limit ...................................................................................................................... 282
Traffic Pricing ................................................................................................................... 282
Restricting Traffic Usage and Traffic Limit ...................................................................... 283
Charging for Traffic .......................................................................................................... 284
Traffic Configuration Changes ......................................................................................... 289
Tracking End User Traffic Consumption ......................................................................... 290
Disk Space ................................................................................................................................. 290
Charging Users for Disk Space ....................................................................................... 291
Enabling/Disabling Summary Disk Usage ....................................................................... 292
Recreating Resources ............................................................................................................... 293
Blacklists in Parallels H-Sphere ................................................................................................. 294
Domains in blacklist ......................................................................................................... 294
Emails in blacklist ............................................................................................................ 295
Uploading and Exporting Black Lists ............................................................................... 296
Billing 297
Plans ................................................................................................................................ 297
Preface 9
Billing Types .................................................................................................................... 297
Trial Hosting .................................................................................................................... 297
Billing Profiles .................................................................................................................. 297
Prices ............................................................................................................................... 298
Limiting Resources .......................................................................................................... 298
Billing Periods .................................................................................................................. 298
Crediting Accounts .......................................................................................................... 298
Debiting Accounts ........................................................................................................... 298
Billing Modes ................................................................................................................... 299
Traffic ............................................................................................................................... 299
Disk Space ...................................................................................................................... 299
E-mailing Invoices ........................................................................................................... 299
Taxes ............................................................................................................................... 299
Promotions ...................................................................................................................... 299
Billing Resellers ............................................................................................................... 300
Managing Debtors ........................................................................................................... 300
Money Returns ................................................................................................................ 300
Billing Statements ............................................................................................................ 300
Billing Types .............................................................................................................................. 302
Billing Profiles ............................................................................................................................ 303
Billing Periods ............................................................................................................................ 303
Creating Billing Periods ................................................................................................... 305
Changing Billing Period Starting Date ............................................................................. 305
Setting Discounts for Billing Periods ............................................................................... 306
Credit Limit ................................................................................................................................. 308
Fees Collected From Customers ............................................................................................... 308
Plan Fees ........................................................................................................................ 308
Free Units .................................................................................................................................. 309
Setting Prices and Free Units .................................................................................................... 311
Comments on Resources ................................................................................................ 311
Discounts ................................................................................................................................... 317
Billing Consequences of Editing Prices and Free Units ............................................................ 318
Taxes ......................................................................................................................................... 318
Tax Exemption ........................................................................................................................... 320
Enabling Tax Exemption ................................................................................................. 321
Setting Tax Exemption Mode at Signup .......................................................................... 321
Activating User Accounts with Tax Exemption Code Entered ........................................ 322
Money Returns .......................................................................................................................... 324
Events that Trigger Refunds ............................................................................................ 324
Refund Formulas ............................................................................................................. 325
Moneyback Period ........................................................................................................... 325
Reducing Quotas and Limits ........................................................................................... 325
Refund Percentage ......................................................................................................... 326
Managing Debtors ..................................................................................................................... 327
Punitive Measures ........................................................................................................... 327
Punitive Measures Automation ........................................................................................ 327
Start Date of Time in Debt ............................................................................................... 328
Promotions ................................................................................................................................. 329
Promotion Types ............................................................................................................. 329
Calculating Promotion Discounts .................................................................................... 329
Creating Promotions ........................................................................................................ 329
Associating Promotions With Plans................................................................................. 331
Extra Packages .......................................................................................................................... 331
Creating Extra Packs ....................................................................................................... 331
Managing Extra Packs .................................................................................................... 332
Anniversary Based Billing .......................................................................................................... 333
Switching Between Billing Modes .............................................................................................. 333
Sending No charge Notifications ............................................................................................. 334
Warning of Immediate Charges in Case of Buying Additional Resources ................................ 334
Preface 10
Dedicated Servers 335
Enabling Dedicated Servers in Globals ..................................................................................... 336
Adding MRTG Logical Servers and Network Switches ............................................................. 336
Adding MRTG Logical Servers ........................................................................................ 337
Adding Network Switches ................................................................................................ 337
Viewing MRTG Server Info .............................................................................................. 339
Creating/Managing Dedicated Server Templates ..................................................................... 340
Custom-built Dedicated Servers ...................................................................................... 341
Dedicated Server Plans ............................................................................................................. 342
User Plans ....................................................................................................................... 342
Users Choosing a Server at Signup ............................................................................... 344
Reseller Plans ................................................................................................................. 344
Managing Dedicated Servers .................................................................................................... 346
Adding Dedicated Servers ............................................................................................... 347
Editing Dedicated Servers ............................................................................................... 348
Deleting Dedicated Servers ............................................................................................. 349
Dedicated Server Status ............................................................................................................ 349
Assigning Additional IP Ranges ................................................................................................ 351
1. Set Prices for Extra IPs in Plans ................................................................................. 351
2. Add IP Subnet ............................................................................................................. 351
3. Split IP Subnet to Smaller IP Ranges ......................................................................... 353
4. Create PTR zone for Reverse DNS Records .............................................................. 354
5. Assign IP Range to Dedicated Server ......................................................................... 355
6. Unassign IP Range ..................................................................................................... 356
Billing Dedicated Servers .......................................................................................................... 356
Bandwidth Billing Types .................................................................................................. 357
Bandwidth Billing Types Options ..................................................................................... 358
Dedicated Servers Maintenance ............................................................................................... 358
Regular Backups ............................................................................................................. 359
Maintenance Requests .................................................................................................... 359
Automatic Cancellation Settings...................................................................................... 361
Resellers 362
Plans ................................................................................................................................ 362
Dual Nature of Resellers ................................................................................................. 362
Private Label .................................................................................................................... 362
Look and Feel and Regional Settings ............................................................................. 362
Merchant Gateways ........................................................................................................ 363
Domain Registration ........................................................................................................ 363
Providing Support ............................................................................................................ 363
Control Panel ................................................................................................................... 363
Web, Mail, and SQL Resources ...................................................................................... 363
Servers ............................................................................................................................ 364
SSL .................................................................................................................................. 364
Billing ............................................................................................................................... 364
Markup plans ................................................................................................................... 364
Reseller DNS ............................................................................................................................. 365
Step 1. Adding Reseller CP Alias Template .................................................................... 365
Step 2. Configuring Reseller DNS Servers ..................................................................... 367
Creating And Editing Reseller Plans ......................................................................................... 367
Step 1. Configuring The Plan .......................................................................................... 368
Step 2 .............................................................................................................................. 371
Billing Resellers ......................................................................................................................... 374
Fees Collected From Resellers ....................................................................................... 374
Fees for services provided with reseller account ............................................................ 374
Fees for services distributed with user accounts ............................................................ 374
Preface 11
Charging Resellers for Traffic .......................................................................................... 375
Reseller Control Panel SSL ....................................................................................................... 376
Enabling Reseller Control Panel SSL Protection ............................................................ 378
Disabling Reseller Control Panel SSL Protection ........................................................... 382
Reseller Shared SSL ................................................................................................................. 382
Resellers Own Wildcard Certificates .............................................................................. 383
Sharing Your Wildcard Certificates with Resellers .......................................................... 384
Placing Resellers on Separate Boxes ....................................................................................... 386
Allocating Physical Servers to Resellers ................................................................................... 389
Supporting Resellers Customers .............................................................................................. 390
Deleting Resellers ...................................................................................................................... 390
Suspending And Resuming Resellers ....................................................................................... 391
Moving Accounts Between Resellers ........................................................................................ 391
Customer Signup 393
Signing Up Users ....................................................................................................................... 393
Signing Up Users from Admin Control Panel .................................................................. 393
Signing Up Users from the Street .................................................................................... 395
Moderating User Signups .......................................................................................................... 395
Moderated Signups ......................................................................................................... 395
Email Notifications ........................................................................................................... 396
Activating Or Rejecting Signups ...................................................................................... 396
Changing Details of Moderated Accounts ....................................................................... 397
Moderated Credit Card Signup ........................................................................................ 398
Signup Guard Settings .............................................................................................................. 399
Creating moderation rules ............................................................................................... 399
Setting Signup Guard Blacklist ........................................................................................ 401
Viewing Signup Info ................................................................................................................... 405
Signup IPs ....................................................................................................................... 405
Signup Statistics .............................................................................................................. 405
Trial Hosting ............................................................................................................................... 407
Introduction to Trial Hosting ............................................................................................ 407
Managing Trial Accounts ................................................................................................. 407
Enabling Trial Registration .............................................................................................. 408
Grouping Trial Plans ........................................................................................................ 409
Managing Trial Accounts ................................................................................................. 410
Enabling Trial Registration .............................................................................................. 411
Grouping Trial Plans ........................................................................................................ 412
Account Management 413
Finding User Accounts............................................................................................................... 414
Generic Search................................................................................................................ 415
Search by Domain Name ................................................................................................ 416
Search by Contact Info .................................................................................................... 416
Search in Resellers ......................................................................................................... 417
Search Suspended Accounts .......................................................................................... 418
Search Deleted Accounts ................................................................................................ 419
Search Dedicated Server Accounts ................................................................................ 419
Search by VPS Hostname ............................................................................................... 420
Search by Account Balance ............................................................................................ 420
Search by Merchant Gateway Transactions ................................................................... 420
Search by Invoice/Balance Entries.................................................................................. 420
Search by Credit Card Charges ...................................................................................... 420
Search by Transfer Traffic ............................................................................................... 421
Search by Disk Usage ..................................................................................................... 422
Search by CC Processing Errors .................................................................................... 422
Search by Logical and Physical Servers ......................................................................... 422
Preface 12
Search by Reseller Traffic ............................................................................................... 423
Search by Resellers Disk Usage ..................................................................................... 423
User Details ............................................................................................................................... 423
Admin Notes .............................................................................................................................. 424
Crediting Accounts ..................................................................................................................... 425
Debiting Accounts ...................................................................................................................... 426
View debits ...................................................................................................................... 429
Deleting Accounts ...................................................................................................................... 429
Suspending and Resuming Accounts........................................................................................ 431
Suspending Accounts ...................................................................................................... 433
Resuming Accounts ........................................................................................................ 434
Restoring Accounts.................................................................................................................... 434
Reports ...................................................................................................................................... 435
Exporting Reports ............................................................................................................ 437
Billing Balance ................................................................................................................. 437
Estimated balance exhaustion date ................................................................................ 439
Daily Report ..................................................................................................................... 440
Web Payments Log ......................................................................................................... 441
Charge Log ...................................................................................................................... 441
Registrar Log ................................................................................................................... 442
Credit Card Charge ......................................................................................................... 443
Billing Entries ................................................................................................................... 444
Signup/Go-away Statistics .............................................................................................. 446
Monthly Revenue ............................................................................................................ 447
Monetary Transactions .................................................................................................... 448
Transfer Traffic Report .................................................................................................... 449
Disk Usage Report .......................................................................................................... 450
Reseller Traffic Report .................................................................................................... 451
In Resellers Disk Usage Report ...................................................................................... 452
IP Addresses Report ....................................................................................................... 453
CC Processing Errors Report .......................................................................................... 454
Account Check ................................................................................................................ 454
Reports Installed in a Package ........................................................................................ 455
Processing Check Payments ..................................................................................................... 462
Setting up the Check Mailing Address ............................................................................ 463
Setting E-mail .................................................................................................................. 463
Moderating Accounts ....................................................................................................... 463
Turning Off Check Payments For the Entire System ...................................................... 464
Splitting Multiple Accounts ......................................................................................................... 465
Granting SSH Access To Users ................................................................................................ 466
Migration 468
Moving Domains Between Accounts ......................................................................................... 468
Domain Move Requirements ........................................................................................... 468
Moving Domains with Domain Mover .............................................................................. 469
Compatibility .................................................................................................................... 470
Manual Domain Move ..................................................................................................... 470
Moving Accounts Between Servers ........................................................................................... 470
Account move implies: .................................................................................................... 470
Cautions .......................................................................................................................... 471
Requirements .................................................................................................................. 471
Procedure ........................................................................................................................ 472
Migrating Individual Cobalt RAQ4 Accounts to Parallels H-Sphere .......................................... 473
Migration Procedure ........................................................................................................ 474
Billing Issues .................................................................................................................... 476
Migrating Individual cPanel Accounts to Parallels H-Sphere .................................................... 477
Preparing for Migration .................................................................................................... 477
Migration Procedure ........................................................................................................ 478
Preface 13
Billing Issues .................................................................................................................... 480
Migrating Individual Ensim Accounts to Parallels H-Sphere ..................................................... 481
Preparing for Migration .................................................................................................... 482
Migration Procedure ........................................................................................................ 483
Migration Notes ............................................................................................................... 486
Billing Issues .................................................................................................................... 487
Migrating Mass Accounts to Parallels H-Sphere ....................................................................... 487
Preparing for Migration .................................................................................................... 487
Migration Procedure ........................................................................................................ 487
Billing Issues .................................................................................................................... 488
Technical Support 490
Client Support Center ................................................................................................................ 492
Configuring Administration Security ................................................................................ 493
Managing Trouble Tickets ............................................................................................... 494
Task System .................................................................................................................... 498
Searching Trouble Tickets ............................................................................................... 499
Exchanging Private Messages ........................................................................................ 500
Managing KnowledgeBase .............................................................................................. 501
Ticket Statistics................................................................................................................ 501
Ticket Queues ................................................................................................................. 502
Supporting Reseller End Users ....................................................................................... 503
Configuring Support Center ....................................................................................................... 504
Knowledge Base ........................................................................................................................ 507
Creating Knowledge Bases ............................................................................................. 508
Editing and Removing Knowledge Bases ....................................................................... 509
Exporting Knowledge Base ............................................................................................. 509
Importing Knowledge Bases ............................................................................................ 510
Spellcheck ....................................................................................................................... 510
Search ............................................................................................................................. 511
Settings ............................................................................................................................ 511
Custom Jobs .............................................................................................................................. 512
Adding Custom Jobs ....................................................................................................... 513
Adding Tasks to Custom Jobs ......................................................................................... 514
Tracking Custom Job Status ........................................................................................... 515
Mass Mail ................................................................................................................................... 516
Crash Report ............................................................................................................................. 518
Installation ....................................................................................................................... 518
Update ............................................................................................................................. 519
Changing E-Mail Address Where Reports Are Sent ....................................................... 519
Sending Crash Reports ................................................................................................... 520
Extended Physical Server Information ............................................................................ 522
Virtual Private Server 523
Providing VPS Hosting .............................................................................................................. 523
Step 1. Add VPS Network Gateway ................................................................................ 524
Step 2. Add IP Range to Logical Server ......................................................................... 524
Step 3. Enable User Signup on Logical Server ............................................................... 524
Step 4. Enable in Globals ................................................................................................ 524
Step 4. Create VPS Plans ............................................................................................... 524
Parallels H-Sphere VPS Templates .......................................................................................... 525
Adding H-Sphere VPS Templates ................................................................................... 526
Third Party Products 528
Urchin ........................................................................................................................................ 529
Preface 14
Miva Kit (intro) ............................................................................................................................ 529
How Does It Work? ......................................................................................................... 530
Adding Miva Merchant Licenses ................................................................................................ 530
Affiliate Programs ...................................................................................................................... 532
How Do Affiliate Programs Work? ................................................................................... 533
How Do I Set Up an Affiliate Program? ........................................................................... 533
Kanoodle™ Support .................................................................................................................. 535
AWStats Support ....................................................................................................................... 536
Setup ............................................................................................................................... 537
Configuration on Unix/Linux ............................................................................................ 537
Configuration on Windows .............................................................................................. 537
SpamAssassin Configuration Manager ..................................................................................... 538
MS Exchange Hosting ............................................................................................................... 542
Prepare Servers for MS Exchange Hosting .................................................................... 543
Enable MS Exchange Hosting in H-Sphere Global Resources ...................................... 543
Configure Microsoft Provisioning Framework ................................................................. 543
Configure MS Exchange Plan ......................................................................................... 544
Comodo SSL Manager .............................................................................................................. 544
Step 1. Register as a Comodo CA Web host reseller ..................................................... 545
Step 2. Configure prices for various certificate types ...................................................... 545
Step 3. Enable SSL Support in plans .............................................................................. 547
Step 4. Manage your customer requests ........................................................................ 547
EasyApp Collection: Providing Third-Party PHP/MySQL Applications ..................................... 548
Installing/Updating the Package ...................................................................................... 549
Disabling/Enabling Applications ...................................................................................... 549
Making Applications Available for Users ......................................................................... 550
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
guides 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 101) and instant access domain
aliases (on page 90), as well as to host the corporate (promotional) website. (on page
98)
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 50).
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 Sysadmin 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 VPS, 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 68). 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 46), configure system
SMTP relays (on page 56), assign mail server roles, assign name server roles (on page
50), 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 463) through the signup
wizard. Depending on the billing type and signup settings, accounts may not be created
until moderated by administrator (on page 395). For instance, an account may not be
immediately created because it was blacklisted by Signup Guard (on page 399) or
because the user doesnt 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 admins 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.
/