Parallels H-Sphere H-Sphere 3.6 User guide

Revision 1.0

Parallels H-Sphere 3.6.0 Administrator

Guide

Parallels H-Sphere 3.6.0

Legal and Copyright Notice

Parallels IP Holdings GmbH

Vordergasse 59

CH-Schaffhausen

Switzerland

Phone: +41-526320-411

Fax: +41-52672-2010

www.parallels.com

This product is protected by United States and international copyright laws. The product’s

underlying technology, patents, and trademarks are listed at

http://www.parallels.com/trademarks.

Microsoft, Windows, Windows Server, Windows NT, Windows Vista, and MS-DOS are

registered trademarks of Microsoft Corporation.

Linux is a registered trademark of Linus Torvalds.

Mac is a registered trademark of Apple, Inc.

All other marks and names mentioned herein may be trademarks of their respective owners.

Contents

Preface 15

Typographical Conventions ......................................................................................................... 15

Feedback ..................................................................................................................................... 16

About This Guide 17

Introduction To Parallels H-Sphere 18

DNS Management ....................................................................................................................... 19

Server Management .................................................................................................................... 20

User Signup ................................................................................................................................. 20

Billing And Plan Management ..................................................................................................... 21

Merchant Gateway Management ................................................................................................ 21

User/Account/Domain Management ............................................................................................ 22

Resellers ...................................................................................................................................... 23

Domain Management .................................................................................................................. 24

SSL .............................................................................................................................................. 25

Support Center ............................................................................................................................ 26

Look and Feel Management ........................................................................................................ 26

Parallels H-Sphere Licensing 27

Purchasing and Leasing Parallels H-Sphere .................................................................... 27

Upgrading to Parallels H-Sphere 3.6.0 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 ................................................................................................. 32

Step 5. Create Plans.................................................................................................................... 33

Step 6. Create Billing Periods ...................................................................................................... 33

Step 7. Configure Support Center ............................................................................................... 34

Step 8. Configure Look and Feel ................................................................................................. 34

Server Configuration 35

Physical Servers .......................................................................................................................... 35

Adding Physical Servers ................................................................................................... 36

Physical Server Controls ................................................................................................... 37

Deleting a Physical Server ................................................................................................ 38

Logical Servers ............................................................................................................................ 38

Adding Logical Servers ..................................................................................................... 39

Enabling User Signup on Logical Servers ......................................................................... 40

Removing Logical Servers ................................................................................................ 41

Setting Logical Server Additional Options ......................................................................... 42

Preface 4

Adding IPs ................................................................................................................................... 46

DNS Servers ................................................................................................................................ 49

Mail Server Settings..................................................................................................................... 50

SPF and SRS .............................................................................................................................. 51

Enabling SPF and SRS ..................................................................................................... 51

Configuring SPF and SRS ................................................................................................. 52

AntiSpam and AntiVirus ............................................................................................................... 53

Enabling AntiSpam and AntiVirus in Control Panel........................................................... 53

Configuring AntiSpam and AntiVirus Default Settings ...................................................... 54

System SMTP Relays .................................................................................................................. 55

Advanced Web Server Settings ................................................................................................... 56

Apache Version ................................................................................................................. 56

Apache Modules ................................................................................................................ 57

Using Gotroot.com Modsecurity™ Rules With H-Sphere ................................................. 59

PHP Modes ....................................................................................................................... 62

PHP Plugins ...................................................................................................................... 65

PHP Accelerators .............................................................................................................. 66

Server Groups ............................................................................................................................. 67

Load Balanced Server Clusters ................................................................................................... 69

Platform Change .......................................................................................................................... 71

Updating Physical Boxes From CP Interface .............................................................................. 74

Procedure .......................................................................................................................... 74

Physical Server Installation/Update Profiles ................................................................................ 76

Resource Prerequisites ............................................................................................................... 80

System Service Management ...................................................................................................... 84

DNS and Hosting 86

DNS Manager .............................................................................................................................. 87

Adding DNS Zones ...................................................................................................................... 87

Instant Alias Templates ............................................................................................................... 89

Adding Instant Alias Templates ......................................................................................... 90

Editing Instant Alias Templates ......................................................................................... 92

DNS Records ............................................................................................................................... 93

Adding custom A records .................................................................................................. 94

Adding custom MX records ............................................................................................... 95

Adding custom CNAME records ........................................................................................ 95

Re-generating System Custom DNS Records .................................................................. 97

Hosting Your Corporate Site ........................................................................................................ 97

Step 1. Make sure you have a service DNS zone ............................................................. 98

Step 2. Create a service plan ............................................................................................ 98

Step 3. Disallow signups from outside your admin account. ............................................. 99

Step 4. Create a service account ...................................................................................... 99

Adding Domains for Third Level Hosting ................................................................................... 100

Providing Mail Under Service Domain for Third-Level Hosting ................................................. 100

Control Panel Web Interface 101

Regional Settings ....................................................................................................................... 102

Images and Icons ...................................................................................................................... 104

Logo Images .................................................................................................................... 104

Icons And Control Images ............................................................................................... 105

Interface Texts ........................................................................................................................... 107

Login Texts ...................................................................................................................... 107

Signup Texts .................................................................................................................... 107

Miscellaneous Texts ........................................................................................................ 107

Skins and Colors ........................................................................................................................ 108

Disabling CP Skins .................................................................................................................... 110

Disabling CP Skins globally ............................................................................................. 110

Preface 5

Disabling CP Skins for reseller plans .............................................................................. 110

Setting Interface Language ....................................................................................................... 111

Setting Default System Language ................................................................................... 111

Setting Admin Interface Language .................................................................................. 111

E-Mail Notifications 113

Setting E-Mail Notification Recipients ........................................................................................ 114

Editing E-Mail Notifications ........................................................................................................ 115

Configuring User Notification Rules ........................................................................................... 120

Online Invoices ................................................................................................................ 121

"No Charge" Notifications ................................................................................................ 121

Control Panel Configuration 123

Entering Company Information .................................................................................................. 124

Disabling Global Resources, Hosting Platforms And Reseller CP SSL .................................... 125

Using Background Job Manager ............................................................................................... 128

Supported TLD's ........................................................................................................................ 132

Installing Shared SSL Certificates ............................................................................................. 133

Shared SSL installation wizard ........................................................................................ 134

Managing Mail SSL.................................................................................................................... 137

Enabling Mail SSL ........................................................................................................... 137

Editing Mail SSL .............................................................................................................. 139

Reposting Certificates ..................................................................................................... 141

Disabling Mail SSL .......................................................................................................... 141

Using Credit Card Encryption .................................................................................................... 141

Turning On ....................................................................................................................... 142

Loading Private Key ........................................................................................................ 143

Turning Off ....................................................................................................................... 144

If You Lose Your Private Key .......................................................................................... 145

Adding Credit Card Brands ........................................................................................................ 146

Domain Registrars 147

Domain Registrar Manager ....................................................................................................... 147

Configuring Domain Registration Settings ...................................................................... 148

Step 1. Creating Connections with Domain Registrars ................................................... 148

Step 2. Associating Top Level Domains with Domain Registrars ................................... 149

Step 3. Setting Default Domain Registration Prices........................................................ 150

Step 4. Configuring Registrar Connections for Resellers ............................................... 150

Editing Registrar Connection Settings ............................................................................ 151

Removing TLD Associations ........................................................................................... 151

Deleting Registrar Connections ....................................................................................... 151

Enom Configuration ................................................................................................................... 152

Setting Up Enom Connection .......................................................................................... 152

OpenSRS Configuration ............................................................................................................ 154

Setting Up OpenSRS Connection ................................................................................... 154

Asynchronous Response Management .......................................................................... 157

OnlineNIC Configuration ............................................................................................................ 158

Getting Prepared ............................................................................................................. 158

Setting Up OnlineNIC Connection ................................................................................... 158

RRPproxy Configuration ............................................................................................................ 160

Setting Up RRPproxy Connection ................................................................................... 160

Ascionic Configuration ............................................................................................................... 162

Setting Up Ascionic Connection ...................................................................................... 162

TPPInternet Configuration ......................................................................................................... 164

Setting Up TPPInternet Connection ................................................................................ 164

Preface 6

Email Domain Registration ........................................................................................................ 166

Configuring Email Registrar ............................................................................................ 167

Merchant Gateways 170

Merchant Gateway Manager ..................................................................................................... 171

Setting Up Merchant Gateway ........................................................................................ 172

Editing Merchant Gateway Settings ................................................................................ 172

Associating Merchant Gateways with Credit Card Vendors ........................................... 173

Editing Description for User Credit Card Statements ...................................................... 173

Handling CC Charge Request Failures ........................................................................... 174

One Step Gateways ........................................................................................................ 175

AssureBuy Configuration ........................................................................................................... 175

Preparation ...................................................................................................................... 175

Configuration ................................................................................................................... 175

AuthorizeNet (Sim Protocol) Configuration ............................................................................... 177

Preparation ...................................................................................................................... 177

Configuration ................................................................................................................... 177

Bibit Configuration ..................................................................................................................... 179

Preparation ...................................................................................................................... 179

Configuration ................................................................................................................... 179

Cardia Services Configuration ................................................................................................... 181

Preparation ...................................................................................................................... 181

Configuration ................................................................................................................... 181

ECHO Configuration .................................................................................................................. 182

Preparation ...................................................................................................................... 182

Configuration ................................................................................................................... 182

ePDQ Configuration................................................................................................................... 183

Preparation ...................................................................................................................... 183

Configuration ................................................................................................................... 183

eWay Configuration ................................................................................................................... 185

Preparation ...................................................................................................................... 185

Configuration ................................................................................................................... 185

HSBC Configuration .................................................................................................................. 186

Preparation ...................................................................................................................... 186

Configuration ................................................................................................................... 186

Innovative Gateway Configuration ............................................................................................. 188

Preparation ...................................................................................................................... 188

Configuration ................................................................................................................... 188

LinkPoint (API v3.01) Configuration .......................................................................................... 189

Preparation ...................................................................................................................... 189

Configuration ................................................................................................................... 190

Moneris Configuration................................................................................................................ 193

Preparation ...................................................................................................................... 193

Configuration ................................................................................................................... 193

NetBilling Configuration ............................................................................................................. 194

Preparation ...................................................................................................................... 194

Configuration ................................................................................................................... 195

NTPNow Configuration .............................................................................................................. 195

Preparation ...................................................................................................................... 195

Configuration ................................................................................................................... 196

Paradata Configuration .............................................................................................................. 198

Preparation ...................................................................................................................... 198

Configuration ................................................................................................................... 198

PayGate Configuration .............................................................................................................. 200

Preparation ...................................................................................................................... 200

Configuration ................................................................................................................... 200

PayJunction Configuration ......................................................................................................... 202

Preparation ...................................................................................................................... 202

Preface 7

Configuration ................................................................................................................... 202

Plug'n Pay Configuration ........................................................................................................... 204

Preparation ...................................................................................................................... 204

Configuration ................................................................................................................... 204

Pay-Me-Now Configuration ....................................................................................................... 206

Preparation ...................................................................................................................... 206

Configuration ................................................................................................................... 206

PosNet Configuration................................................................................................................. 207

Preparation ...................................................................................................................... 207

Configuration ................................................................................................................... 207

Protx (VSP Direct Protocol 2.22) Configuration ........................................................................ 209

Preparation ...................................................................................................................... 209

Configuration ................................................................................................................... 209

PSiGate (XML API) Configuration ............................................................................................. 210

Preparation ...................................................................................................................... 210

Configuration ................................................................................................................... 210

SecurePay Configuration ........................................................................................................... 212

Preparation ...................................................................................................................... 212

Configuration ................................................................................................................... 212

SkipJack Configuration .............................................................................................................. 213

Preparation ...................................................................................................................... 213

Configuration ................................................................................................................... 214

SecurePay.com.au Configuration .............................................................................................. 215

Preparation ...................................................................................................................... 215

Configuration ................................................................................................................... 215

SecureTrading Configuration ..................................................................................................... 216

Preparation ...................................................................................................................... 216

Configuration ................................................................................................................... 216

ThePayDesk Configuration ........................................................................................................ 218

Preparation ...................................................................................................................... 218

Configuration ................................................................................................................... 219

Tucows Configuration ................................................................................................................ 220

Preparation ...................................................................................................................... 220

Configuration ................................................................................................................... 220

VeriSign PayFlow Pro Configuration ......................................................................................... 222

Preparation ...................................................................................................................... 222

Configuration ................................................................................................................... 223

VeriSign PayFlow Pro With SSL Support .................................................................................. 225

Preparation ...................................................................................................................... 225

Configuration ................................................................................................................... 225

Web-based Payments 227

Web Payment Systems Manager .............................................................................................. 228

Work Principles................................................................................................................ 228

Configuration Procedure ................................................................................................. 228

Setting Web Payment Instant Notification URL ............................................................... 229

2CheckOut Configuration .......................................................................................................... 230

Authorize.Net (Sim Protocol) Configuration .............................................................................. 231

Setting Up Authorize.Net ................................................................................................. 231

ChronoPay Configuration .......................................................................................................... 233

Setting Up ChronoPay ..................................................................................................... 233

GestPay Configuration............................................................................................................... 234

PayNova Configuration .............................................................................................................. 235

PayPal Merchant Gateway Configuration ................................................................................. 236

Preparation ...................................................................................................................... 236

Configuration ................................................................................................................... 236

Sentry Configuration .................................................................................................................. 237

Preparation ...................................................................................................................... 237

Preface 8

Setup Procedure.............................................................................................................. 237

Webmoney Configuration .......................................................................................................... 239

1. Set your own purse ..................................................................................................... 239

2. Activate Webmoney payments in your Parallels H-Sphere control panel ................... 239

WorldPay Configuration ............................................................................................................. 240

Setting Up WorldPay ....................................................................................................... 240

Plans 243

Creating and Editing Plans (Plan Wizards) ............................................................................... 244

Starting Plan Creation Wizards ....................................................................................... 245

Starting Plan Edit Wizards ............................................................................................... 245

Simplified Plan Wizards ................................................................................................... 246

A Typical Web Hosting Plan Wizard .......................................................................................... 248

Step 1. Selecting Resources and Configuring Plan Settings .......................................... 249

Subsequent Steps. Setting Prices ................................................................................... 255

MySQL Plan Wizard .................................................................................................................. 256

Windows Plan Wizard ................................................................................................................ 256

Windows RealMedia Plan Wizard ............................................................................................. 257

E-mail Plan Wizard .................................................................................................................... 257

Markup Plan Wizard .................................................................................................................. 257

Admin Plans ............................................................................................................................... 258

Creating Admin Plans ...................................................................................................... 258

Editing Admin Plans ........................................................................................................ 259

Demo Plans ............................................................................................................................... 260

Changing Account's Plan (Plan Groups) ................................................................................... 262

Understanding Plan Groups ............................................................................................ 263

Grouping Plans ................................................................................................................ 263

Access to Plans ......................................................................................................................... 265

Plan Controls ............................................................................................................................. 266

Show ................................................................................................................................ 267

Copy ................................................................................................................................ 267

Delete .............................................................................................................................. 267

Plan Settings .............................................................................................................................. 268

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 ........................................................................................................ 276

Users ............................................................................................................................... 277

Accounts .......................................................................................................................... 277

Domains .......................................................................................................................... 280

Traffic ......................................................................................................................................... 281

Traffic Calculation ............................................................................................................ 282

Traffic Limit ...................................................................................................................... 282

Traffic Pricing ................................................................................................................... 282

Restricting Traffic Usage and Traffic Limit ...................................................................... 283

Charging for Traffic .......................................................................................................... 284

Traffic Configuration Changes ......................................................................................... 290

Tracking End User Traffic Consumption ......................................................................... 291

Disk Space ................................................................................................................................. 291

Charging Users for Disk Space ....................................................................................... 292

Enabling/Disabling Summary Disk Usage ....................................................................... 293

Recreating Resources ............................................................................................................... 294

Blacklists in Parallels H-Sphere ................................................................................................. 294

Preface 9

Domains in blacklist ......................................................................................................... 295

Emails in blacklist ............................................................................................................ 295

Uploading and Exporting Black Lists ............................................................................... 296

Billing 298

Plans ................................................................................................................................ 298

Billing Types .................................................................................................................... 298

Trial Hosting .................................................................................................................... 298

Billing Profiles .................................................................................................................. 298

Prices ............................................................................................................................... 299

Limiting Resources .......................................................................................................... 299

Billing Periods .................................................................................................................. 299

Crediting Accounts .......................................................................................................... 299

Debiting Accounts ........................................................................................................... 299

Billing Modes ................................................................................................................... 300

Traffic ............................................................................................................................... 300

Disk Space ...................................................................................................................... 300

E-mailing Invoices ........................................................................................................... 300

Taxes ............................................................................................................................... 300

Promotions ...................................................................................................................... 301

Billing Resellers ............................................................................................................... 301

Managing Debtors ........................................................................................................... 301

Money Returns ................................................................................................................ 301

Billing Statements ............................................................................................................ 301

Billing Types .............................................................................................................................. 303

Billing Profiles ............................................................................................................................ 304

Billing Periods and Discounts .................................................................................................... 304

Default and Actual Billing Periods. Base Prices .............................................................. 304

Monthly and Billing Period Resources ............................................................................ 305

Opening a New Billing Period/Month............................................................................... 305

Creating and Configuring Actual Billing Periods ............................................................. 305

Changing Account's Billing Period ............................................................................................. 307

Changing Billing Period Start Date ............................................................................................ 308

Credit Limit ................................................................................................................................. 310

Setting Credit Limit in a Plan ........................................................................................... 311

Increasing Credit Limit for Individual Accounts ............................................................... 311

Resetting Credit Limit For All Users ................................................................................ 312

Fees Collected From Customers ............................................................................................... 313

Plan Fees ........................................................................................................................ 313

Free Units .................................................................................................................................. 314

Setting Prices and Free Units .................................................................................................... 315

Comments on Resources ................................................................................................ 316

Discounts ................................................................................................................................... 321

Billing Consequences of Editing Prices and Free Units ............................................................ 322

Taxes ......................................................................................................................................... 322

Tax Exemption ........................................................................................................................... 324

Enabling Tax Exemption ................................................................................................. 325

Setting Tax Exemption Mode at Signup .......................................................................... 326

Activating User Accounts with Tax Exemption Code Entered ........................................ 326

Money Returns .......................................................................................................................... 328

Events that Trigger Refunds ............................................................................................ 328

Refund Formulas ............................................................................................................. 329

Moneyback Period ........................................................................................................... 329

Reducing Quotas and Limits ........................................................................................... 330

Refund Percentage ......................................................................................................... 330

Managing Debtors ..................................................................................................................... 331

Punitive Measures ........................................................................................................... 331

Punitive Measures Automation ........................................................................................ 331

Preface 10

Start Date of Time in Debt ............................................................................................... 332

Promotions ................................................................................................................................. 333

Promotion Types ............................................................................................................. 333

Calculating Promotion Discounts .................................................................................... 333

Creating Promotions ........................................................................................................ 333

Calculators shipped with H-Sphere ................................................................................. 335

Validators shipped with H-Sphere ................................................................................... 335

Associating Promotions With Plans................................................................................. 335

Extra Packages .......................................................................................................................... 335

Creating Extra Packs ....................................................................................................... 335

Managing Extra Packs .................................................................................................... 336

Anniversary Based Billing .......................................................................................................... 337

Switching Between Billing Modes .............................................................................................. 338

Sending "No charge" Notifications ............................................................................................. 339

Warning of Immediate Charges in Case of Buying Additional Resources ................................ 339

Charging Accounts Whose Plans Change ................................................................................ 340

Charging End User Accounts .......................................................................................... 340

Charging Reseller Accounts ............................................................................................ 341

Dedicated Servers 342

Enabling Dedicated Servers in Globals ..................................................................................... 343

Adding MRTG Logical Servers and Network Switches ............................................................. 343

Adding MRTG Logical Servers ........................................................................................ 344

Adding Network Switches ................................................................................................ 344

Viewing MRTG Server Info .............................................................................................. 345

Creating/Managing Dedicated Server Templates ..................................................................... 346

Custom-built Dedicated Servers ...................................................................................... 347

Dedicated Server Plans ............................................................................................................. 348

User Plans ....................................................................................................................... 348

User's Choosing a Server at Signup ............................................................................... 350

Reseller Plans ................................................................................................................. 350

Managing Dedicated Servers .................................................................................................... 352

Adding Dedicated Servers ............................................................................................... 353

Editing Dedicated Servers ............................................................................................... 354

Deleting Dedicated Servers ............................................................................................. 355

Dedicated Server Status ............................................................................................................ 355

Assigning Additional IP Ranges ................................................................................................ 357

1. Set Prices for Extra IPs in Plans ................................................................................. 357

2. Add IP Subnet ............................................................................................................. 357

3. Split IP Subnet to Smaller IP Ranges ......................................................................... 358

4. Create PTR zone for Reverse DNS Records .............................................................. 359

5. Assign IP Range to Dedicated Server ......................................................................... 360

6. Unassign IP Range ..................................................................................................... 361

Billing Dedicated Servers .......................................................................................................... 362

Bandwidth Billing Types .................................................................................................. 363

Bandwidth Billing Types Options ..................................................................................... 364

Dedicated Servers' Maintenance ............................................................................................... 364

Regular Backups ............................................................................................................. 365

Maintenance Requests .................................................................................................... 365

Automatic Cancellation Settings...................................................................................... 366

Resellers 368

Plans ................................................................................................................................ 368

Dual Nature of Resellers ................................................................................................. 368

Private Label .................................................................................................................... 368

Look and Feel and Regional Settings ............................................................................. 369

Merchant Gateways ........................................................................................................ 369

Preface 11

Domain Registration ........................................................................................................ 369

Providing Support ............................................................................................................ 369

Control Panel ................................................................................................................... 369

Web, Mail, and SQL Resources ...................................................................................... 370

Servers ............................................................................................................................ 370

SSL .................................................................................................................................. 370

Billing ............................................................................................................................... 370

Markup plans ................................................................................................................... 370

Reseller DNS ............................................................................................................................. 372

Step 1. Adding Reseller CP Alias Template .................................................................... 372

Step 2. Configuring Reseller DNS Servers ..................................................................... 373

Creating And Editing Reseller Plans ......................................................................................... 374

Step 1. Configuring The Plan .......................................................................................... 374

Step 2 .............................................................................................................................. 377

Billing Resellers ......................................................................................................................... 381

Fees Collected From Resellers ....................................................................................... 381

Fees for services provided with reseller account ............................................................ 381

Fees for services distributed with user accounts ............................................................ 381

Charging Resellers for Traffic .......................................................................................... 382

Reseller Control Panel SSL ....................................................................................................... 383

Enabling Reseller Control Panel SSL Protection ............................................................ 385

Disabling Reseller Control Panel SSL Protection ........................................................... 389

Reseller Shared SSL ................................................................................................................. 389

Resellers' Own Wildcard Certificates .............................................................................. 390

Sharing Your Wildcard Certificates with Resellers .......................................................... 391

Placing Resellers on Separate Boxes ....................................................................................... 392

Allocating Physical Servers to Resellers ................................................................................... 395

Supporting Resellers' Customers .............................................................................................. 396

Deleting Resellers ...................................................................................................................... 397

Suspending And Resuming Resellers ....................................................................................... 398

Moving Accounts Between Resellers ........................................................................................ 398

Account Management 400

Finding User Accounts............................................................................................................... 401

Generic Search................................................................................................................ 402

Search by Domain Name ................................................................................................ 403

Search by Contact Info .................................................................................................... 403

Search in Resellers ......................................................................................................... 404

Search Suspended Accounts .......................................................................................... 405

Search Deleted Accounts ................................................................................................ 406

Search Dedicated Server Accounts ................................................................................ 407

Search by VPS Hostname ............................................................................................... 407

Search by Account Balance ............................................................................................ 407

Search by Merchant Gateway Transactions ................................................................... 407

Search by Invoice/Balance Entries.................................................................................. 407

Search by Credit Card Charges ...................................................................................... 408

Search by Transfer Traffic ............................................................................................... 408

Search by Disk Usage ..................................................................................................... 408

Search by CC Processing Errors .................................................................................... 408

Search by Logical and Physical Servers ......................................................................... 409

Search by Reseller Traffic ............................................................................................... 409

Search by Resellers Disk Usage ..................................................................................... 409

User Details ............................................................................................................................... 410

Admin Notes .............................................................................................................................. 410

Crediting Accounts ..................................................................................................................... 411

Debiting Accounts ...................................................................................................................... 412

View debits ...................................................................................................................... 414

Deleting Accounts ...................................................................................................................... 415

Preface 12

Suspending and Resuming Accounts........................................................................................ 416

Suspending Accounts ...................................................................................................... 418

Resuming Accounts ........................................................................................................ 419

Restoring Accounts.................................................................................................................... 419

Reports ...................................................................................................................................... 420

Exporting Reports ............................................................................................................ 422

Billing Balance ................................................................................................................. 422

Estimated balance exhaustion date ................................................................................ 424

Daily Report ..................................................................................................................... 424

Web Payments Log ......................................................................................................... 426

Charge Log ...................................................................................................................... 426

Registrar Log ................................................................................................................... 427

Credit Card Charge ......................................................................................................... 428

Billing Entries ................................................................................................................... 429

Signup/Go-away Statistics .............................................................................................. 430

Monthly Revenue ............................................................................................................ 431

Monetary Transactions .................................................................................................... 432

Transfer Traffic Report .................................................................................................... 433

Disk Usage Report .......................................................................................................... 434

Reseller Traffic Report .................................................................................................... 435

In Resellers Disk Usage Report ...................................................................................... 436

IP Addresses Report ....................................................................................................... 437

CC Processing Errors Report .......................................................................................... 437

Account Check ................................................................................................................ 439

Reports Installed in a Package ........................................................................................ 439

Processing Check Payments ..................................................................................................... 446

Setting up the Check Mailing Address ............................................................................ 447

Setting E-mail .................................................................................................................. 447

Moderating Accounts ....................................................................................................... 447

Turning Off Check Payments For the Entire System ...................................................... 448

Splitting Multiple Accounts ......................................................................................................... 449

Granting SSH Access To Users ................................................................................................ 450

Customer Signup 452

Signing Up Users ....................................................................................................................... 452

Signing Up Users from Admin Control Panel .................................................................. 453

Signing Up Users from the Street .................................................................................... 454

Moderating User Signups .......................................................................................................... 454

Moderated Signups ......................................................................................................... 454

Email Notifications ........................................................................................................... 455

Activating Or Rejecting Signups ...................................................................................... 455

Changing Details of Moderated Accounts ....................................................................... 455

Moderated Credit Card Signup ........................................................................................ 456

Signup Guard Settings .............................................................................................................. 457

Creating moderation rules ............................................................................................... 457

Setting Signup Guard Blacklist ........................................................................................ 458

Viewing Signup Info ................................................................................................................... 459

Signup IPs ....................................................................................................................... 459

Signup Statistics .............................................................................................................. 460

Trial Hosting ............................................................................................................................... 461

Introduction to Trial Hosting ............................................................................................ 461

Managing Trial Accounts ................................................................................................. 461

Enabling Trial Registration .............................................................................................. 462

Grouping Trial Plans ........................................................................................................ 463

Managing Trial Accounts ................................................................................................. 464

Enabling Trial Registration .............................................................................................. 465

Grouping Trial Plans ........................................................................................................ 466

Preface 13

Migration 467

Moving Domains Between Accounts ......................................................................................... 467

Domain Move Requirements ........................................................................................... 467

Moving Domains with Domain Mover .............................................................................. 468

Compatibility .................................................................................................................... 469

Manual Domain Move ..................................................................................................... 469

Moving Accounts Between Servers ........................................................................................... 469

Account move implies: .................................................................................................... 469

Cautions .......................................................................................................................... 470

Requirements .................................................................................................................. 470

Procedure ........................................................................................................................ 471

Migrating Individual Cobalt RAQ4 Accounts to Parallels H-Sphere .......................................... 472

Migration Procedure ........................................................................................................ 473

Billing Issues .................................................................................................................... 476

Migrating Individual cPanel Accounts to Parallels H-Sphere .................................................... 477

Preparing for Migration .................................................................................................... 477

Migration Procedure ........................................................................................................ 478

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 .................................................................................................................... 489

Technical Support 490

Client Support Center ................................................................................................................ 492

Configuring Administration Security ................................................................................ 493

Managing Trouble Tickets ............................................................................................... 494

Task System .................................................................................................................... 497

Searching Trouble Tickets ............................................................................................... 498

Exchanging Private Messages ........................................................................................ 499

Managing KnowledgeBase .............................................................................................. 500

Ticket Statistics................................................................................................................ 500

Ticket Queues ................................................................................................................. 500

Supporting Reseller End Users ....................................................................................... 502

Configuring Support Center ....................................................................................................... 503

Knowledge Base ........................................................................................................................ 506

Creating Knowledge Bases ............................................................................................. 507

Editing and Removing Knowledge Bases ....................................................................... 507

Exporting Knowledge Base ............................................................................................. 508

Importing Knowledge Bases ............................................................................................ 509

Spellcheck ....................................................................................................................... 509

Search ............................................................................................................................. 510

Settings ............................................................................................................................ 511

Custom Jobs .............................................................................................................................. 511

Adding Custom Jobs ....................................................................................................... 512

Adding Tasks to Custom Jobs ......................................................................................... 513

Tracking Custom Job Status ........................................................................................... 513

Mass Mail ................................................................................................................................... 514

Crash Report ............................................................................................................................. 516

Installation ....................................................................................................................... 517

Update ............................................................................................................................. 517

Preface 14

Changing E-Mail Address Where Reports Are Sent ....................................................... 518

Sending Crash Reports ................................................................................................... 518

Extended Physical Server Information ............................................................................ 520

Parallels Virtuozzo Containers 521

Setting Up Parallels Virtuozzo Containers Node Server ........................................................... 522

Creating Virtuozzo Plans ........................................................................................................... 523

Creating Virtuozzo Plan Groups ................................................................................................ 525

Signing Up Users for Virtuozzo Plans ....................................................................................... 525

Parallels Sitebuilder Integration 527

Setting Up Parallels Sitebuilder ................................................................................................. 528

Licensing Parallels Sitebuilder Accounts ................................................................................... 529

Configuring Access to Parallels Sitebuilder Plans from Parallels H-Sphere Plans ................... 530

Migrating from Parallels SiteStudio to Parallels Sitebuilder ...................................................... 531

Third Party Products 532

Urchin ........................................................................................................................................ 533

Miva Kit ...................................................................................................................................... 534

How Does It Work? ......................................................................................................... 534

Adding Miva Merchant Licenses ................................................................................................ 535

Affiliate Programs ...................................................................................................................... 536

How Do Affiliate Programs Work? ................................................................................... 537

How Do I Set Up an Affiliate Program? ........................................................................... 537

Kanoodle™ Support .................................................................................................................. 539

AWStats Support ....................................................................................................................... 540

Setup ............................................................................................................................... 540

Configuration on Unix/Linux ............................................................................................ 540

Configuration on Windows .............................................................................................. 541

SpamAssassin Configuration Manager ..................................................................................... 542

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 100) and instant access domain

aliases (on page 89), as well as to host the corporate (promotional) website. (on page

97)

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 49).

By default, Parallels H-Sphere randomly assigns primary and secondary DNS servers

for each domain to balance server load. If you want, you can assign master and slave

roles to DNS logical servers.

Parallels H-Sphere creates a zone file for each domain name on both name servers,

and allows end users to create custom DNS records through a web interface.

You can find more info on DNS Server Configuration in Understanding DNS Server

Configuration documentation in System Administrator Guide.

20 Introduction To Parallels H-Sphere

Server Management

We differentiate between physical and logical servers.

Physical servers (on page 35) are actually or virtually separate computers with their

own operating systems (Linux, FreeBSD Unix, or Windows). They can be emulated

with VMWare or other software packages.

Logical servers (on page 38) 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 67). 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 45), configure system

SMTP relays (on page 55), assign mail server roles, assign name server roles (on page

49), 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 447) through the signup

wizard. Depending on the billing type and signup settings, accounts may not be created

until moderated by administrator (on page 454). For instance, an account may not be

immediately created because it was blacklisted by Signup Guard (on page 457) or

because the user doesn't pay with a credit card.

Depending on the plan, access to the signup wizard can be unrestricted (available

"from the street") or allowed only from the admin control panel. Registration "from the

street" can be performed by anybody without admin's interaction. Registration from the

admin control panel goes through exactly the same steps, but can be performed only

by the administrator. The latter is the only way to sign users up for publicly unavailable

plans.

Page is loading ...

Parallels H-Sphere H-Sphere 3.6 User guide

Related papers

Other documents