Parallels H-Sphere H-Sphere 3.6.1 User guide

Revision 1.0

Parallels H-Sphere 3.6.1 Administrator

Guide

Parallels H-Sphere 3.6.1

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.1 or higher .............................................................. 27

Upgrading Parallels H-Sphere Accounts ........................................................................... 28

Getting Started 29

Step1. Disable Global Resources ................................................................................................ 30

Step 2. Set up a Domain Registrar .............................................................................................. 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 With SSL Support (SDK v4) .................................................................. 223

Preparation ...................................................................................................................... 223

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

Web-based Payments 225

Web Payment Systems Manager .............................................................................................. 226

Work Principles................................................................................................................ 226

Configuration Procedure ................................................................................................. 226

Setting Web Payment Instant Notification URL ............................................................... 227

2CheckOut Configuration .......................................................................................................... 228

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

Setting Up Authorize.Net ................................................................................................. 229

ChronoPay Configuration .......................................................................................................... 231

Setting Up ChronoPay ..................................................................................................... 231

GestPay Configuration............................................................................................................... 232

PayNova Configuration .............................................................................................................. 233

PayPal Merchant Gateway Configuration ................................................................................. 234

Preparation ...................................................................................................................... 234

Configuration ................................................................................................................... 234

Sentry Configuration .................................................................................................................. 235

Preparation ...................................................................................................................... 235

Setup Procedure.............................................................................................................. 235

Webmoney Configuration .......................................................................................................... 237

1. Set your own purse ..................................................................................................... 237

Preface 8

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

WorldPay Configuration ............................................................................................................. 238

Setting Up WorldPay ....................................................................................................... 238

Plans 241

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

Starting Plan Creation Wizards ....................................................................................... 243

Starting Plan Edit Wizards ............................................................................................... 243

Simplified Plan Wizards ................................................................................................... 244

A Typical Web Hosting Plan Wizard .......................................................................................... 246

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

Subsequent Steps. Setting Prices ................................................................................... 253

MySQL Plan Wizard .................................................................................................................. 254

Windows Plan Wizard ................................................................................................................ 254

Windows RealMedia Plan Wizard ............................................................................................. 255

E-mail Plan Wizard .................................................................................................................... 255

Markup Plan Wizard .................................................................................................................. 255

Admin Plans ............................................................................................................................... 256

Creating Admin Plans ...................................................................................................... 256

Editing Admin Plans ........................................................................................................ 257

Demo Plans ............................................................................................................................... 258

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

Understanding Plan Groups ............................................................................................ 261

Grouping Plans ................................................................................................................ 261

Access to Plans ......................................................................................................................... 263

Plan Controls ............................................................................................................................. 264

Show ................................................................................................................................ 265

Copy ................................................................................................................................ 265

Delete .............................................................................................................................. 265

Plan Settings .............................................................................................................................. 266

Controlling RAM And CPU Usage ............................................................................................. 269

Enable RLimit in Plans .................................................................................................... 269

Configure RLimit Values .................................................................................................. 270

Limiting Resource Use For Individual Accounts .............................................................. 270

Placing Plans on Particular Boxes ............................................................................................. 271

Resources 274

Users, Accounts, Domains ........................................................................................................ 274

Users ............................................................................................................................... 275

Accounts .......................................................................................................................... 275

Domains .......................................................................................................................... 278

Traffic ......................................................................................................................................... 279

Traffic Calculation ............................................................................................................ 280

Traffic Limit ...................................................................................................................... 280

Traffic Pricing ................................................................................................................... 280

Restricting Traffic Usage and Traffic Limit ...................................................................... 281

Charging for Traffic .......................................................................................................... 282

Traffic Configuration Changes ......................................................................................... 288

Tracking End User Traffic Consumption ......................................................................... 289

Disk Space ................................................................................................................................. 289

Charging Users for Disk Space ....................................................................................... 290

Enabling/Disabling Summary Disk Usage ....................................................................... 291

Recreating Resources ............................................................................................................... 292

Blacklists in Parallels H-Sphere ................................................................................................. 292

Domains in blacklist ......................................................................................................... 293

Emails in blacklist ............................................................................................................ 293

Uploading and Exporting Black Lists ............................................................................... 294

Preface 9

Billing 296

Plans ................................................................................................................................ 296

Billing Types .................................................................................................................... 296

Trial Hosting .................................................................................................................... 296

Billing Profiles .................................................................................................................. 296

Prices ............................................................................................................................... 297

Limiting Resources .......................................................................................................... 297

Billing Periods .................................................................................................................. 297

Crediting Accounts .......................................................................................................... 297

Debiting Accounts ........................................................................................................... 297

Billing Modes ................................................................................................................... 298

Traffic ............................................................................................................................... 298

Disk Space ...................................................................................................................... 298

E-mailing Invoices ........................................................................................................... 298

Taxes ............................................................................................................................... 298

Promotions ...................................................................................................................... 299

Billing Resellers ............................................................................................................... 299

Managing Debtors ........................................................................................................... 299

Money Returns ................................................................................................................ 299

Billing Statements ............................................................................................................ 299

Billing Types .............................................................................................................................. 301

Billing Profiles ............................................................................................................................ 302

Billing Periods and Discounts .................................................................................................... 302

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

Monthly and Billing Period Resources ............................................................................ 303

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

Creating and Configuring Actual Billing Periods ............................................................. 303

Changing Account's Billing Period ............................................................................................. 305

Changing Billing Period Start Date ............................................................................................ 306

Credit Limit ................................................................................................................................. 308

Setting Credit Limit in a Plan ........................................................................................... 309

Increasing Credit Limit for Individual Accounts ............................................................... 309

Resetting Credit Limit For All Users ................................................................................ 310

Fees Collected From Customers ............................................................................................... 311

Plan Fees ........................................................................................................................ 311

Free Units .................................................................................................................................. 312

Setting Prices and Free Units .................................................................................................... 313

Comments on Resources ................................................................................................ 314

Discounts ................................................................................................................................... 319

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

Taxes ......................................................................................................................................... 320

Tax Exemption ........................................................................................................................... 322

Enabling Tax Exemption ................................................................................................. 323

Setting Tax Exemption Mode at Signup .......................................................................... 324

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

Money Returns .......................................................................................................................... 326

Events that Trigger Refunds ............................................................................................ 326

Refund Formulas ............................................................................................................. 327

Moneyback Period ........................................................................................................... 327

Reducing Quotas and Limits ........................................................................................... 328

Refund Percentage ......................................................................................................... 328

Managing Debtors ..................................................................................................................... 329

Punitive Measures ........................................................................................................... 329

Punitive Measures Automation ........................................................................................ 329

Start Date of Time in Debt ............................................................................................... 330

Promotions ................................................................................................................................. 331

Promotion Types ............................................................................................................. 331

Preface 10

Calculating Promotion Discounts .................................................................................... 331

Creating Promotions ........................................................................................................ 331

Calculators shipped with H-Sphere ................................................................................. 333

Validators shipped with H-Sphere ................................................................................... 333

Associating Promotions With Plans................................................................................. 333

Extra Packages .......................................................................................................................... 333

Creating Extra Packs ....................................................................................................... 333

Managing Extra Packs .................................................................................................... 334

Anniversary Based Billing .......................................................................................................... 335

Switching Between Billing Modes .............................................................................................. 336

Sending "No charge" Notifications ............................................................................................. 337

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

Charging Accounts Whose Plans Change ................................................................................ 338

Charging End User Accounts .......................................................................................... 338

Charging Reseller Accounts ............................................................................................ 339

Dedicated Servers 340

Enabling Dedicated Servers in Globals ..................................................................................... 341

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

Adding MRTG Logical Servers ........................................................................................ 342

Adding Network Switches ................................................................................................ 342

Viewing MRTG Server Info .............................................................................................. 343

Creating/Managing Dedicated Server Templates ..................................................................... 344

Custom-built Dedicated Servers ...................................................................................... 345

Dedicated Server Plans ............................................................................................................. 346

User Plans ....................................................................................................................... 346

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

Reseller Plans ................................................................................................................. 348

Managing Dedicated Servers .................................................................................................... 350

Adding Dedicated Servers ............................................................................................... 351

Editing Dedicated Servers ............................................................................................... 352

Deleting Dedicated Servers ............................................................................................. 353

Dedicated Server Status ............................................................................................................ 353

Assigning Additional IP Ranges ................................................................................................ 355

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

2. Add IP Subnet ............................................................................................................. 355

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

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

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

6. Unassign IP Range ..................................................................................................... 359

Billing Dedicated Servers .......................................................................................................... 360

Bandwidth Billing Types .................................................................................................. 361

Bandwidth Billing Types Options ..................................................................................... 362

Dedicated Servers' Maintenance ............................................................................................... 362

Regular Backups ............................................................................................................. 363

Maintenance Requests .................................................................................................... 363

Automatic Cancellation Settings...................................................................................... 364

Resellers 366

Plans ................................................................................................................................ 366

Dual Nature of Resellers ................................................................................................. 366

Private Label .................................................................................................................... 366

Look and Feel and Regional Settings ............................................................................. 367

Merchant Gateways ........................................................................................................ 367

Domain Registration ........................................................................................................ 367

Providing Support ............................................................................................................ 367

Control Panel ................................................................................................................... 367

Preface 11

Web, Mail, and SQL Resources ...................................................................................... 368

Servers ............................................................................................................................ 368

SSL .................................................................................................................................. 368

Billing ............................................................................................................................... 368

Markup plans ................................................................................................................... 368

Reseller DNS ............................................................................................................................. 370

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

Step 2. Configuring Reseller DNS Servers ..................................................................... 371

Creating And Editing Reseller Plans ......................................................................................... 372

Step 1. Configuring The Plan .......................................................................................... 372

Step 2 .............................................................................................................................. 375

Billing Resellers ......................................................................................................................... 379

Fees Collected From Resellers ....................................................................................... 379

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

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

Charging Resellers for Traffic .......................................................................................... 380

Reseller Control Panel SSL ....................................................................................................... 381

Enabling Reseller Control Panel SSL Protection ............................................................ 383

Disabling Reseller Control Panel SSL Protection ........................................................... 387

Reseller Shared SSL ................................................................................................................. 387

Resellers' Own Wildcard Certificates .............................................................................. 388

Sharing Your Wildcard Certificates with Resellers .......................................................... 389

Placing Resellers on Separate Boxes ....................................................................................... 390

Allocating Physical Servers to Resellers ................................................................................... 393

Supporting Resellers' Customers .............................................................................................. 394

Deleting Resellers ...................................................................................................................... 395

Suspending And Resuming Resellers ....................................................................................... 396

Moving Accounts Between Resellers ........................................................................................ 396

Account Management 398

Finding User Accounts............................................................................................................... 399

Generic Search................................................................................................................ 400

Search by Domain Name ................................................................................................ 401

Search by Contact Info .................................................................................................... 401

Search in Resellers ......................................................................................................... 402

Search Suspended Accounts .......................................................................................... 403

Search Deleted Accounts ................................................................................................ 404

Search Dedicated Server Accounts ................................................................................ 405

Search by VPS Hostname ............................................................................................... 405

Search by Account Balance ............................................................................................ 405

Search by Merchant Gateway Transactions ................................................................... 405

Search by Invoice/Balance Entries.................................................................................. 405

Search by Credit Card Charges ...................................................................................... 406

Search by Transfer Traffic ............................................................................................... 406

Search by Disk Usage ..................................................................................................... 406

Search by CC Processing Errors .................................................................................... 406

Search by Logical and Physical Servers ......................................................................... 407

Search by Reseller Traffic ............................................................................................... 407

Search by Resellers Disk Usage ..................................................................................... 407

User Details ............................................................................................................................... 408

Admin Notes .............................................................................................................................. 408

Crediting Accounts ..................................................................................................................... 409

Debiting Accounts ...................................................................................................................... 410

View debits ...................................................................................................................... 412

Deleting Accounts ...................................................................................................................... 413

Suspending and Resuming Accounts........................................................................................ 414

Suspending Accounts ...................................................................................................... 416

Resuming Accounts ........................................................................................................ 417

Preface 12

Restoring Accounts.................................................................................................................... 417

Reports ...................................................................................................................................... 418

Exporting Reports ............................................................................................................ 420

Billing Balance ................................................................................................................. 420

Estimated balance exhaustion date ................................................................................ 422

Daily Report ..................................................................................................................... 422

Web Payments Log ......................................................................................................... 424

Charge Log ...................................................................................................................... 424

Registrar Log ................................................................................................................... 425

Credit Card Charge ......................................................................................................... 426

Billing Entries ................................................................................................................... 427

Signup/Go-away Statistics .............................................................................................. 428

Monthly Revenue ............................................................................................................ 429

Monetary Transactions .................................................................................................... 430

Transfer Traffic Report .................................................................................................... 431

Disk Usage Report .......................................................................................................... 432

Reseller Traffic Report .................................................................................................... 433

In Resellers Disk Usage Report ...................................................................................... 434

IP Addresses Report ....................................................................................................... 435

CC Processing Errors Report .......................................................................................... 435

Account Check ................................................................................................................ 437

Reports Installed in a Package ........................................................................................ 437

Processing Check Payments ..................................................................................................... 444

Setting up the Check Mailing Address ............................................................................ 445

Setting E-mail .................................................................................................................. 445

Moderating Accounts ....................................................................................................... 445

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

Splitting Multiple Accounts ......................................................................................................... 447

Granting SSH Access To Users ................................................................................................ 448

Customer Signup 450

Signing Up Users ....................................................................................................................... 450

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

Signing Up Users from the Street .................................................................................... 452

Moderating User Signups .......................................................................................................... 452

Moderated Signups ......................................................................................................... 452

Email Notifications ........................................................................................................... 453

Activating Or Rejecting Signups ...................................................................................... 453

Changing Details of Moderated Accounts ....................................................................... 453

Moderated Credit Card Signup ........................................................................................ 454

Signup Guard Settings .............................................................................................................. 455

Creating moderation rules ............................................................................................... 455

Setting Signup Guard Blacklist ........................................................................................ 456

Viewing Signup Info ................................................................................................................... 457

Signup IPs ....................................................................................................................... 457

Signup Statistics .............................................................................................................. 458

Trial Hosting ............................................................................................................................... 459

Introduction to Trial Hosting ............................................................................................ 459

Managing Trial Accounts ................................................................................................. 459

Enabling Trial Registration .............................................................................................. 460

Grouping Trial Plans ........................................................................................................ 461

Managing Trial Accounts ................................................................................................. 462

Enabling Trial Registration .............................................................................................. 463

Grouping Trial Plans ........................................................................................................ 464

Migration 465

Moving Domains Between Accounts ......................................................................................... 465

Preface 13

Domain Move Requirements ........................................................................................... 465

Moving Domains with Domain Mover .............................................................................. 466

Compatibility .................................................................................................................... 467

Manual Domain Move ..................................................................................................... 467

Moving Accounts Between Servers ........................................................................................... 467

Account move implies: .................................................................................................... 467

Cautions .......................................................................................................................... 468

Requirements .................................................................................................................. 468

Procedure ........................................................................................................................ 469

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

Migration Procedure ........................................................................................................ 471

Billing Issues .................................................................................................................... 474

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

Preparing for Migration .................................................................................................... 475

Migration Procedure ........................................................................................................ 476

Billing Issues .................................................................................................................... 478

Migrating Individual Ensim Accounts to Parallels H-Sphere ..................................................... 479

Preparing for Migration .................................................................................................... 480

Migration Procedure ........................................................................................................ 481

Migration Notes ............................................................................................................... 484

Billing Issues .................................................................................................................... 485

Migrating Mass Accounts to Parallels H-Sphere ....................................................................... 485

Preparing for Migration .................................................................................................... 485

Migration Procedure ........................................................................................................ 485

Billing Issues .................................................................................................................... 487

Technical Support 488

Client Support Center ................................................................................................................ 490

Configuring Administration Security ................................................................................ 491

Managing Trouble Tickets ............................................................................................... 492

Task System .................................................................................................................... 495

Searching Trouble Tickets ............................................................................................... 496

Exchanging Private Messages ........................................................................................ 497

Managing KnowledgeBase .............................................................................................. 498

Ticket Statistics................................................................................................................ 498

Ticket Queues ................................................................................................................. 498

Supporting Reseller End Users ....................................................................................... 500

Configuring Support Center ....................................................................................................... 501

Knowledge Base ........................................................................................................................ 504

Creating Knowledge Bases ............................................................................................. 505

Editing and Removing Knowledge Bases ....................................................................... 505

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

Importing Knowledge Bases ............................................................................................ 507

Spellcheck ....................................................................................................................... 507

Search ............................................................................................................................. 508

Settings ............................................................................................................................ 509

Custom Jobs .............................................................................................................................. 509

Adding Custom Jobs ....................................................................................................... 510

Adding Tasks to Custom Jobs ......................................................................................... 511

Tracking Custom Job Status ........................................................................................... 511

Mass Mail ................................................................................................................................... 512

Crash Report ............................................................................................................................. 514

Installation ....................................................................................................................... 515

Update ............................................................................................................................. 515

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

Sending Crash Reports ................................................................................................... 516

Extended Physical Server Information ............................................................................ 518

Preface 14

Parallels Virtuozzo Containers 519

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

Creating Virtuozzo Plans ........................................................................................................... 521

Creating Virtuozzo Plan Groups ................................................................................................ 523

Signing Up Users for Virtuozzo Plans ....................................................................................... 523

Parallels Sitebuilder Integration 525

Setting Up Parallels Sitebuilder ................................................................................................. 526

Licensing Parallels Sitebuilder Accounts ................................................................................... 527

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

Migrating from Parallels SiteStudio to Parallels Sitebuilder ...................................................... 529

Third Party Products 530

Urchin ........................................................................................................................................ 531

Miva Kit ...................................................................................................................................... 532

How Does It Work? ......................................................................................................... 532

Adding Miva Merchant Licenses ................................................................................................ 533

Affiliate Programs ...................................................................................................................... 534

How Do Affiliate Programs Work? ................................................................................... 535

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

Kanoodle™ Support .................................................................................................................. 537

AWStats Support ....................................................................................................................... 538

Setup ............................................................................................................................... 538

Configuration on Unix/Linux ............................................................................................ 538

Configuration on Windows .............................................................................................. 539

SpamAssassin Configuration Manager ..................................................................................... 540

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 445) through the signup

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

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

immediately created because it was blacklisted by Signup Guard (on page 455) 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.1 User guide

Parallels H-Sphere H-Sphere 3.6.1 User guide

Related papers

Other documents