Parallels H-Sphere 3.1 User guide

Parallels

®

H-Sphere

Legal and Copyright Notice

ISBN: N/A

Parallels

660 SW 39

th

Street

Suite 205

Renton, Washington 98057

USA

Phone: +1 (425) 282 6400

Fax: +1 (425) 282 6444

Parallels, Inc.

Distribution of this work or derivative of this work in any form is prohibited unless prior

written permission is obtained from the copyright holder.

Product and service names mentioned herein are the trademarks of their respective owners.

Contents

Preface 15

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

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

About This Guide 17

Introduction To Parallels H-Sphere 18

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

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

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

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

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

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

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

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

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

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

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

Getting Started 27

Step1. Disable Global Resources ................................................................................................ 28

Step 2. Set up a Domain Registrar .............................................................................................. 29

Step 3. Configure Mail Notification Addresses ............................................................................ 29

Step 4. Set up Payment Settings ................................................................................................. 30

Step 5. Create Plans.................................................................................................................... 31

Step 6. Create Billing Periods ...................................................................................................... 31

Step 7. Configure Support Center ............................................................................................... 32

Step 8. Configure Look and Feel ................................................................................................. 32

Server Configuration 33

Physical Servers .......................................................................................................................... 34

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

Physical Server Controls ................................................................................................... 36

Deleting a Physical Server ................................................................................................ 37

Logical Servers ............................................................................................................................ 37

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

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

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

Setting Logical Server Additional Options ......................................................................... 41

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

DNS Servers ................................................................................................................................ 50

Mail Server Settings..................................................................................................................... 51

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

Enabling SPF and SRS ..................................................................................................... 52

Configuring SPF and SRS ................................................................................................. 53

AntiSpam and AntiVirus ............................................................................................................... 54

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

Preface 4

Configuring AntiSpam and AntiVirus Default Settings ...................................................... 55

System SMTP Relays .................................................................................................................. 56

Advanced Web Server Settings ................................................................................................... 57

Apache Version ................................................................................................................. 57

Apache Modules ................................................................................................................ 58

PHP Modes ....................................................................................................................... 64

PHP Plugins ...................................................................................................................... 67

Server Groups ............................................................................................................................. 68

Load Balanced Server Clusters ................................................................................................... 71

Platform Change .......................................................................................................................... 73

Updating Physical Boxes From CP Interface .............................................................................. 76

Procedure .......................................................................................................................... 76

Physical Server Installation/Update Profiles ................................................................................ 77

Resource Prerequisites ............................................................................................................... 81

System Service Management ...................................................................................................... 85

DNS and Hosting 87

DNS Manager .............................................................................................................................. 88

Adding DNS Zones ...................................................................................................................... 88

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

Adding Instant Alias Templates ......................................................................................... 91

Editing Instant Alias Templates ......................................................................................... 93

DNS Records ............................................................................................................................... 94

Adding custom A records .................................................................................................. 95

Adding custom MX records ............................................................................................... 96

Adding custom CNAME records ........................................................................................ 96

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

Hosting Your Corporate Site ........................................................................................................ 98

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

Step 2. Create a service plan ............................................................................................ 99

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

Step 4. Create a service account .................................................................................... 100

Adding Domains for Third Level Hosting ................................................................................... 101

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

Control Panel Web Interface 102

Regional Settings ....................................................................................................................... 103

Images and Icons ...................................................................................................................... 105

Logo Images .................................................................................................................... 105

Icons And Control Images ............................................................................................... 107

Interface Texts ........................................................................................................................... 109

Login Texts ...................................................................................................................... 109

Signup Texts .................................................................................................................... 109

Miscellaneous Texts ........................................................................................................ 109

Skins and Colors ........................................................................................................................ 110

Disabling CP Skins .................................................................................................................... 112

Disabling CP Skins globally ............................................................................................. 112

Disabling CP Skins for reseller plans .............................................................................. 112

Setting Interface Language ....................................................................................................... 113

Setting Default System Language ................................................................................... 113

Setting Admin Interface Language .................................................................................. 113

E-Mail Notifications 114

Setting E-Mail Notification Recipients ........................................................................................ 115

Editing E-Mail Notifications ........................................................................................................ 116

Preface 5

Configuring User Notification Rules ........................................................................................... 121

Online Invoices ................................................................................................................ 122

“No Charge” Notifications ................................................................................................ 123

Control Panel Configuration 124

Entering Company Information .................................................................................................. 125

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

Using Background Job Manager ............................................................................................... 129

Manipulating Cron Jobs ................................................................................................... 129

Cron Job Details .............................................................................................................. 132

Current Jobs .................................................................................................................... 133

Supported TLD‟s ........................................................................................................................ 133

Installing Shared SSL Certificates ............................................................................................. 134

Shared SSL installation wizard ........................................................................................ 136

Managing Mail SSL.................................................................................................................... 138

Enabling Mail SSL ........................................................................................................... 139

Editing Mail SSL .............................................................................................................. 141

Reposting Certificates ..................................................................................................... 142

Disabling Mail SSL .......................................................................................................... 143

Using Credit Card Encryption .................................................................................................... 143

Turning On ....................................................................................................................... 143

Loading Private Key ........................................................................................................ 145

Turning Off ....................................................................................................................... 146

If You Lose Your Private Key .......................................................................................... 146

Adding Credit Card Brands ........................................................................................................ 147

Domain Registrars 148

Domain Registrar Manager ....................................................................................................... 149

Configuring Domain Registration Settings ...................................................................... 149

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

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

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

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

Editing Registrar Connection Settings ............................................................................ 152

Removing TLD Associations ........................................................................................... 152

Deleting Registrar Connections ....................................................................................... 152

Enom Configuration ................................................................................................................... 153

Setting Up Enom Connection .......................................................................................... 153

OpenSRS Configuration ............................................................................................................ 155

Setting Up OpenSRS Connection ................................................................................... 156

Asynchronous Response Management .......................................................................... 158

OnlineNIC Configuration ............................................................................................................ 160

Getting Prepared ............................................................................................................. 160

Setting Up OnlineNIC Connection ................................................................................... 160

RRPproxy Configuration ............................................................................................................ 162

Setting Up RRPproxy Connection ................................................................................... 162

Ascionic Configuration ............................................................................................................... 164

Setting Up Ascionic Connection ...................................................................................... 164

TPPInternet Configuration ......................................................................................................... 166

Setting Up TPPInternet Connection ................................................................................ 166

Email Domain Registration ........................................................................................................ 168

Configuring Email Registrar ............................................................................................ 169

Merchant Gateways 172

Merchant Gateway Manager ..................................................................................................... 173

Preface 6

Setting Up Merchant Gateway ........................................................................................ 174

Editing Merchant Gateway Settings ................................................................................ 174

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

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

Handling CC Charge Request Failures ........................................................................... 176

One Step Gateways ........................................................................................................ 177

AssureBuy Configuration ........................................................................................................... 177

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

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

AuthorizeNet (Sim Protocol) Configuration ............................................................................... 180

Preparation ...................................................................................................................... 180

Configuration ................................................................................................................... 180

Bibit Configuration ..................................................................................................................... 182

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

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

Cardia Services Configuration ................................................................................................... 183

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

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

ECHO Configuration .................................................................................................................. 184

Preparation ...................................................................................................................... 184

Configuration ................................................................................................................... 184

ePDQ Configuration................................................................................................................... 185

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

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

eWay Configuration ................................................................................................................... 187

Preparation ...................................................................................................................... 187

Configuration ................................................................................................................... 187

HSBC Configuration .................................................................................................................. 188

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

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

Innovative Gateway Configuration ............................................................................................. 189

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

Configuration ................................................................................................................... 189

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

Preparation ...................................................................................................................... 190

Configuration ................................................................................................................... 191

Moneris Configuration................................................................................................................ 194

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

Configuration ................................................................................................................... 194

NetBilling Configuration ............................................................................................................. 195

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

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

NTPNow Configuration .............................................................................................................. 197

Preparation ...................................................................................................................... 197

Configuration ................................................................................................................... 197

Paradata Configuration .............................................................................................................. 199

Preparation ...................................................................................................................... 199

Configuration ................................................................................................................... 199

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

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

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

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

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

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

Plug‟n Pay Configuration ........................................................................................................... 204

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

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

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

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

Preface 7

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

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

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

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

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

Preparation ...................................................................................................................... 208

Configuration ................................................................................................................... 208

PSiGate (XML API) Configuration ............................................................................................. 209

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

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

SecurePay Configuration ........................................................................................................... 211

Preparation ...................................................................................................................... 211

Configuration ................................................................................................................... 211

SkipJack Configuration .............................................................................................................. 212

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

Configuration ................................................................................................................... 213

SecurePay.com.au Configuration .............................................................................................. 214

Preparation ...................................................................................................................... 214

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

SecureTrading Configuration ..................................................................................................... 215

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

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

ThePayDesk Configuration ........................................................................................................ 217

Preparation ...................................................................................................................... 217

Configuration ................................................................................................................... 218

Tucows Configuration ................................................................................................................ 219

Preparation ...................................................................................................................... 219

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

VeriSign PayFlow Pro Configuration ......................................................................................... 221

Preparation ...................................................................................................................... 221

Configuration ................................................................................................................... 221

VeriSign PayFlow Pro With SSL Support .................................................................................. 223

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

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

Web-based Payments 226

Web Payment Systems Manager .............................................................................................. 227

Work Principles................................................................................................................ 227

Configuration Procedure ................................................................................................. 227

Setting Web Payment Instant Notification URL ............................................................... 228

2CheckOut Configuration .......................................................................................................... 229

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

Setting Up Authorize.Net ................................................................................................. 230

ChronoPay Configuration .......................................................................................................... 232

Setting Up ChronoPay ..................................................................................................... 232

GestPay Configuration............................................................................................................... 233

PayNova Configuration .............................................................................................................. 234

PayPal Merchant Gateway Configuration ................................................................................. 235

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

Configuration ................................................................................................................... 235

Sentry Configuration .................................................................................................................. 236

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

Setup Procedure.............................................................................................................. 236

Webmoney Configuration .......................................................................................................... 238

1. Set your own purse ..................................................................................................... 238

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

WorldPay Configuration ............................................................................................................. 239

Setting Up WorldPay ....................................................................................................... 239

Preface 8

Plans 241

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

Starting Plan Creation Wizards ....................................................................................... 242

Starting Plan Edit Wizards ............................................................................................... 242

Simplified Plan Wizards ................................................................................................... 243

A Typical Plan Wizard................................................................................................................ 245

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

Subsequent Steps. Setting Prices ................................................................................... 257

MySQL Plan Wizard .................................................................................................................. 258

Windows Plan Wizard ................................................................................................................ 258

Windows RealMedia Plan Wizard ............................................................................................. 259

E-mail Plan Wizard .................................................................................................................... 259

VPS Plan Wizard ....................................................................................................................... 259

Markup Plan Wizard .................................................................................................................. 260

Admin Plans ............................................................................................................................... 261

Creating Admin Plans ...................................................................................................... 261

Editing Admin Plans ........................................................................................................ 262

Demo Plans ............................................................................................................................... 263

Access to Plans ......................................................................................................................... 266

Plan Controls ............................................................................................................................. 267

Show ................................................................................................................................ 268

Copy ................................................................................................................................ 268

Delete .............................................................................................................................. 268

Plan Settings .............................................................................................................................. 269

Controlling RAM And CPU Usage ............................................................................................. 271

Enable RLimit in Plans .................................................................................................... 271

Configure RLimit Values .................................................................................................. 272

Limiting Resource Use For Individual Accounts .............................................................. 272

Placing Plans on Particular Boxes ............................................................................................. 273

Resources 276

Users, Accounts, Domains ........................................................................................................ 277

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

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

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

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

Traffic Calculation ............................................................................................................ 281

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

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

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

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

Traffic Configuration Changes ......................................................................................... 289

Tracking End User Traffic Consumption ......................................................................... 290

Disk Space ................................................................................................................................. 290

Charging Users for Disk Space ....................................................................................... 291

Enabling/Disabling Summary Disk Usage ....................................................................... 292

Recreating Resources ............................................................................................................... 293

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

Domains in blacklist ......................................................................................................... 294

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

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

Billing 297

Plans ................................................................................................................................ 297

Preface 9

Billing Types .................................................................................................................... 297

Trial Hosting .................................................................................................................... 297

Billing Profiles .................................................................................................................. 297

Prices ............................................................................................................................... 298

Limiting Resources .......................................................................................................... 298

Billing Periods .................................................................................................................. 298

Crediting Accounts .......................................................................................................... 298

Debiting Accounts ........................................................................................................... 298

Billing Modes ................................................................................................................... 299

Traffic ............................................................................................................................... 299

Disk Space ...................................................................................................................... 299

E-mailing Invoices ........................................................................................................... 299

Taxes ............................................................................................................................... 299

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

Billing Resellers ............................................................................................................... 300

Managing Debtors ........................................................................................................... 300

Money Returns ................................................................................................................ 300

Billing Statements ............................................................................................................ 300

Billing Types .............................................................................................................................. 302

Billing Profiles ............................................................................................................................ 303

Billing Periods ............................................................................................................................ 303

Creating Billing Periods ................................................................................................... 305

Changing Billing Period Starting Date ............................................................................. 305

Setting Discounts for Billing Periods ............................................................................... 306

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

Fees Collected From Customers ............................................................................................... 308

Plan Fees ........................................................................................................................ 308

Free Units .................................................................................................................................. 309

Setting Prices and Free Units .................................................................................................... 311

Comments on Resources ................................................................................................ 311

Discounts ................................................................................................................................... 317

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

Taxes ......................................................................................................................................... 318

Tax Exemption ........................................................................................................................... 320

Enabling Tax Exemption ................................................................................................. 321

Setting Tax Exemption Mode at Signup .......................................................................... 321

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

Money Returns .......................................................................................................................... 324

Events that Trigger Refunds ............................................................................................ 324

Refund Formulas ............................................................................................................. 325

Moneyback Period ........................................................................................................... 325

Reducing Quotas and Limits ........................................................................................... 325

Refund Percentage ......................................................................................................... 326

Managing Debtors ..................................................................................................................... 327

Punitive Measures ........................................................................................................... 327

Punitive Measures Automation ........................................................................................ 327

Start Date of Time in Debt ............................................................................................... 328

Promotions ................................................................................................................................. 329

Promotion Types ............................................................................................................. 329

Calculating Promotion Discounts .................................................................................... 329

Creating Promotions ........................................................................................................ 329

Associating Promotions With Plans................................................................................. 331

Extra Packages .......................................................................................................................... 331

Creating Extra Packs ....................................................................................................... 331

Managing Extra Packs .................................................................................................... 332

Anniversary Based Billing .......................................................................................................... 333

Switching Between Billing Modes .............................................................................................. 333

Sending “No charge” Notifications ............................................................................................. 334

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

Preface 10

Dedicated Servers 335

Enabling Dedicated Servers in Globals ..................................................................................... 336

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

Adding MRTG Logical Servers ........................................................................................ 337

Adding Network Switches ................................................................................................ 337

Viewing MRTG Server Info .............................................................................................. 339

Creating/Managing Dedicated Server Templates ..................................................................... 340

Custom-built Dedicated Servers ...................................................................................... 341

Dedicated Server Plans ............................................................................................................. 342

User Plans ....................................................................................................................... 342

User‟s Choosing a Server at Signup ............................................................................... 344

Reseller Plans ................................................................................................................. 344

Managing Dedicated Servers .................................................................................................... 346

Adding Dedicated Servers ............................................................................................... 347

Editing Dedicated Servers ............................................................................................... 348

Deleting Dedicated Servers ............................................................................................. 349

Dedicated Server Status ............................................................................................................ 349

Assigning Additional IP Ranges ................................................................................................ 351

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

2. Add IP Subnet ............................................................................................................. 351

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

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

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

6. Unassign IP Range ..................................................................................................... 356

Billing Dedicated Servers .......................................................................................................... 356

Bandwidth Billing Types .................................................................................................. 357

Bandwidth Billing Types Options ..................................................................................... 358

Dedicated Servers‟ Maintenance ............................................................................................... 358

Regular Backups ............................................................................................................. 359

Maintenance Requests .................................................................................................... 359

Automatic Cancellation Settings...................................................................................... 361

Resellers 362

Plans ................................................................................................................................ 362

Dual Nature of Resellers ................................................................................................. 362

Private Label .................................................................................................................... 362

Look and Feel and Regional Settings ............................................................................. 362

Merchant Gateways ........................................................................................................ 363

Domain Registration ........................................................................................................ 363

Providing Support ............................................................................................................ 363

Control Panel ................................................................................................................... 363

Web, Mail, and SQL Resources ...................................................................................... 363

Servers ............................................................................................................................ 364

SSL .................................................................................................................................. 364

Billing ............................................................................................................................... 364

Markup plans ................................................................................................................... 364

Reseller DNS ............................................................................................................................. 365

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

Step 2. Configuring Reseller DNS Servers ..................................................................... 367

Creating And Editing Reseller Plans ......................................................................................... 367

Step 1. Configuring The Plan .......................................................................................... 368

Step 2 .............................................................................................................................. 371

Billing Resellers ......................................................................................................................... 374

Fees Collected From Resellers ....................................................................................... 374

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

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

Preface 11

Charging Resellers for Traffic .......................................................................................... 375

Reseller Control Panel SSL ....................................................................................................... 376

Enabling Reseller Control Panel SSL Protection ............................................................ 378

Disabling Reseller Control Panel SSL Protection ........................................................... 382

Reseller Shared SSL ................................................................................................................. 382

Resellers‟ Own Wildcard Certificates .............................................................................. 383

Sharing Your Wildcard Certificates with Resellers .......................................................... 384

Placing Resellers on Separate Boxes ....................................................................................... 386

Allocating Physical Servers to Resellers ................................................................................... 389

Supporting Resellers‟ Customers .............................................................................................. 390

Deleting Resellers ...................................................................................................................... 390

Suspending And Resuming Resellers ....................................................................................... 391

Moving Accounts Between Resellers ........................................................................................ 391

Customer Signup 393

Signing Up Users ....................................................................................................................... 393

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

Signing Up Users from the Street .................................................................................... 395

Moderating User Signups .......................................................................................................... 395

Moderated Signups ......................................................................................................... 395

Email Notifications ........................................................................................................... 396

Activating Or Rejecting Signups ...................................................................................... 396

Changing Details of Moderated Accounts ....................................................................... 397

Moderated Credit Card Signup ........................................................................................ 398

Signup Guard Settings .............................................................................................................. 399

Creating moderation rules ............................................................................................... 399

Setting Signup Guard Blacklist ........................................................................................ 401

Viewing Signup Info ................................................................................................................... 405

Signup IPs ....................................................................................................................... 405

Signup Statistics .............................................................................................................. 405

Trial Hosting ............................................................................................................................... 407

Introduction to Trial Hosting ............................................................................................ 407

Managing Trial Accounts ................................................................................................. 407

Enabling Trial Registration .............................................................................................. 408

Grouping Trial Plans ........................................................................................................ 409

Managing Trial Accounts ................................................................................................. 410

Enabling Trial Registration .............................................................................................. 411

Grouping Trial Plans ........................................................................................................ 412

Account Management 413

Finding User Accounts............................................................................................................... 414

Generic Search................................................................................................................ 415

Search by Domain Name ................................................................................................ 416

Search by Contact Info .................................................................................................... 416

Search in Resellers ......................................................................................................... 417

Search Suspended Accounts .......................................................................................... 418

Search Deleted Accounts ................................................................................................ 419

Search Dedicated Server Accounts ................................................................................ 419

Search by VPS Hostname ............................................................................................... 420

Search by Account Balance ............................................................................................ 420

Search by Merchant Gateway Transactions ................................................................... 420

Search by Invoice/Balance Entries.................................................................................. 420

Search by Credit Card Charges ...................................................................................... 420

Search by Transfer Traffic ............................................................................................... 421

Search by Disk Usage ..................................................................................................... 422

Search by CC Processing Errors .................................................................................... 422

Search by Logical and Physical Servers ......................................................................... 422

Preface 12

Search by Reseller Traffic ............................................................................................... 423

Search by Resellers Disk Usage ..................................................................................... 423

User Details ............................................................................................................................... 423

Admin Notes .............................................................................................................................. 424

Crediting Accounts ..................................................................................................................... 425

Debiting Accounts ...................................................................................................................... 426

View debits ...................................................................................................................... 429

Deleting Accounts ...................................................................................................................... 429

Suspending and Resuming Accounts........................................................................................ 431

Suspending Accounts ...................................................................................................... 433

Resuming Accounts ........................................................................................................ 434

Restoring Accounts.................................................................................................................... 434

Reports ...................................................................................................................................... 435

Exporting Reports ............................................................................................................ 437

Billing Balance ................................................................................................................. 437

Estimated balance exhaustion date ................................................................................ 439

Daily Report ..................................................................................................................... 440

Web Payments Log ......................................................................................................... 441

Charge Log ...................................................................................................................... 441

Registrar Log ................................................................................................................... 442

Credit Card Charge ......................................................................................................... 443

Billing Entries ................................................................................................................... 444

Signup/Go-away Statistics .............................................................................................. 446

Monthly Revenue ............................................................................................................ 447

Monetary Transactions .................................................................................................... 448

Transfer Traffic Report .................................................................................................... 449

Disk Usage Report .......................................................................................................... 450

Reseller Traffic Report .................................................................................................... 451

In Resellers Disk Usage Report ...................................................................................... 452

IP Addresses Report ....................................................................................................... 453

CC Processing Errors Report .......................................................................................... 454

Account Check ................................................................................................................ 454

Reports Installed in a Package ........................................................................................ 455

Processing Check Payments ..................................................................................................... 462

Setting up the Check Mailing Address ............................................................................ 463

Setting E-mail .................................................................................................................. 463

Moderating Accounts ....................................................................................................... 463

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

Splitting Multiple Accounts ......................................................................................................... 465

Granting SSH Access To Users ................................................................................................ 466

Migration 468

Moving Domains Between Accounts ......................................................................................... 468

Domain Move Requirements ........................................................................................... 468

Moving Domains with Domain Mover .............................................................................. 469

Compatibility .................................................................................................................... 470

Manual Domain Move ..................................................................................................... 470

Moving Accounts Between Servers ........................................................................................... 470

Account move implies: .................................................................................................... 470

Cautions .......................................................................................................................... 471

Requirements .................................................................................................................. 471

Procedure ........................................................................................................................ 472

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

Migration Procedure ........................................................................................................ 474

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

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

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

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

Preface 13

Billing Issues .................................................................................................................... 480

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

Preparing for Migration .................................................................................................... 482

Migration Procedure ........................................................................................................ 483

Migration Notes ............................................................................................................... 486

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

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

Preparing for Migration .................................................................................................... 487

Migration Procedure ........................................................................................................ 487

Billing Issues .................................................................................................................... 488

Technical Support 490

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

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

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

Task System .................................................................................................................... 498

Searching Trouble Tickets ............................................................................................... 499

Exchanging Private Messages ........................................................................................ 500

Managing KnowledgeBase .............................................................................................. 501

Ticket Statistics................................................................................................................ 501

Ticket Queues ................................................................................................................. 502

Supporting Reseller End Users ....................................................................................... 503

Configuring Support Center ....................................................................................................... 504

Knowledge Base ........................................................................................................................ 507

Creating Knowledge Bases ............................................................................................. 508

Editing and Removing Knowledge Bases ....................................................................... 509

Exporting Knowledge Base ............................................................................................. 509

Importing Knowledge Bases ............................................................................................ 510

Spellcheck ....................................................................................................................... 510

Search ............................................................................................................................. 511

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

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

Adding Custom Jobs ....................................................................................................... 513

Adding Tasks to Custom Jobs ......................................................................................... 514

Tracking Custom Job Status ........................................................................................... 515

Mass Mail ................................................................................................................................... 516

Crash Report ............................................................................................................................. 518

Installation ....................................................................................................................... 518

Update ............................................................................................................................. 519

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

Sending Crash Reports ................................................................................................... 520

Extended Physical Server Information ............................................................................ 522

Virtual Private Server 523

Providing VPS Hosting .............................................................................................................. 523

Step 1. Add VPS Network Gateway ................................................................................ 524

Step 2. Add IP Range to Logical Server ......................................................................... 524

Step 3. Enable User Signup on Logical Server ............................................................... 524

Step 4. Enable in Globals ................................................................................................ 524

Step 4. Create VPS Plans ............................................................................................... 524

Parallels H-Sphere VPS Templates .......................................................................................... 525

Adding H-Sphere VPS Templates ................................................................................... 526

Third Party Products 528

Urchin ........................................................................................................................................ 529

Preface 14

Miva Kit (intro) ............................................................................................................................ 529

How Does It Work? ......................................................................................................... 530

Adding Miva Merchant Licenses ................................................................................................ 530

Affiliate Programs ...................................................................................................................... 532

How Do Affiliate Programs Work? ................................................................................... 533

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

Kanoodle™ Support .................................................................................................................. 535

AWStats Support ....................................................................................................................... 536

Setup ............................................................................................................................... 537

Configuration on Unix/Linux ............................................................................................ 537

Configuration on Windows .............................................................................................. 537

SpamAssassin Configuration Manager ..................................................................................... 538

MS Exchange Hosting ............................................................................................................... 542

Prepare Servers for MS Exchange Hosting .................................................................... 543

Enable MS Exchange Hosting in H-Sphere Global Resources ...................................... 543

Configure Microsoft Provisioning Framework ................................................................. 543

Configure MS Exchange Plan ......................................................................................... 544

Comodo SSL Manager .............................................................................................................. 544

Step 1. Register as a Comodo CA Web host reseller ..................................................... 545

Step 2. Configure prices for various certificate types ...................................................... 545

Step 3. Enable SSL Support in plans .............................................................................. 547

Step 4. Manage your customer requests ........................................................................ 547

EasyApp Collection: Providing Third-Party PHP/MySQL Applications ..................................... 548

Installing/Updating the Package ...................................................................................... 549

Disabling/Enabling Applications ...................................................................................... 549

Making Applications Available for Users ......................................................................... 550

In this chapter:

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

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

Typographical Conventions

Before you start using this guide, it is important to understand the documentation

conventions used in it.

The following kinds of formatting in the text identify special information.

Formatting convention

Type of Information

Example

Special Bold

Items you must select,

such as menu options,

command buttons, or

items in a list.

Go to the System tab.

Titles of chapters,

sections, and

subsections.

Read the Basic

Administration chapter.

Italics

Used to emphasize the

importance of a point, to

introduce a term or to

designate a command

line placeholder, which is

to be replaced with a real

name or value.

The system supports the

so called wildcard

character search.

Monospace

The names of

commands, files,

directories, and domain

names.

The license file is located

in the

http://docs/common/

licenses directory.

C H A P T E R 1

Preface

16 Preface

Preformatted

On-screen computer

output in your command-

line sessions; source

code in XML, C++, or

other programming

languages.

# ls –al /files

total 14470

Preformatted

Bold

What you type,

contrasted with on-screen

computer output.

# cd /root/rpms/php

CAPITALS

Names of keys on the

keyboard.

SHIFT, CTRL, ALT

KEY+KEY

Key combinations for

which the user must

press and hold down one

key and then press

another.

CTRL+P, ALT+F4

Feedback

If you have found a mistake in this guide, or if you have suggestions or ideas on how to

improve this guide, please send your feedback using the online form at

http://www.parallels.com/en/support/usersdoc/. Please include in your report the

guide‟s title, chapter and section titles, and the fragment of text in which you have found

an error.

Parallels H-Sphere Administrator guide aims at hosting providers and explains how to

configure and administer Parallels H-Sphere control panel.

C H A P T E R 2

About This Guide

Parallels H-Sphere is a comprehensive hosting automation system that allows you to

provide a heterogeneous operating system environment to your customers across

multiple servers. It can manage hosting servers located in various data centers.

Parallels H-Sphere can have a multiple server layout, called a cluster. The main server

in the cluster is the actual Parallels H-Sphere Control Panel, a web application with

graphical interface, which centralizes all hosting management tasks, controls all hosting

servers and services, manages users, domains, events, and processes. Through

Parallels H-Sphere web interface, you can configure and manage these and other

subsystems, other servers (on page 18), user accounts and domains, etc. All system

data, such as billing, domain, and other info, is stored in the Postgres system database.

The Control panel consists of many subsystems, the major of them described below.

In this chapter:

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

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

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

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

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

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

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

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

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

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

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

C H A P T E R 3

Introduction To Parallels H-Sphere

Introduction To Parallels H-Sphere 19

DNS Management

All DNS is managed by Parallels H-Sphere.

A typical Parallels H-Sphere setup requires one service domain name (example.com)

which is used as:

 the control panel domain (cp.example.com:8080 or cp.example.com:8443),

 web server domain (web1.example.com, web2.example.com),

 name server domain (ns1.example.com, ns2.example.com), etc.

It can also be used for third level hosting (on page 101) and instant access domain

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

98)

The most typical configuration is to have two DNS servers, each on a separate box. In

case of one-server installations, you can put two DNS servers on one box (on page 50).

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

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

roles to DNS logical servers.

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

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

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

Configuration documentation in Sysadmin Guide.

20 Introduction To Parallels H-Sphere

Server Management

We differentiate between physical and logical servers.

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

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

with VPS, VMWare or other software packages.

Logical servers (on page 37) are programs that run on physical servers and process

client requests. For instance when we talk about web, mail, DNS, mysql and other

servers, we mean logical servers. A physical server can have one or more logical

servers running.

Logical servers of the same nature and purpose make a server group (on page 68). In

case of multiserver installations, logical servers of the same group are located on

different physical servers, and Parallels H-Sphere randomly chooses from them to

create user accounts, which evens server load and disk space usage.

In most instances, Parallels H-Sphere operates with logical servers, not physical

servers. We work with logical servers when we add IPs (on page 46), configure system

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

50), etc.

User Signup

To use hosting services, users (site owners and resellers) need to sign up for a hosting

plan.

Parallels H-Sphere offers fully automated user signup (on page 463) through the signup

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

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

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

because the user 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 3.1 User guide

Parallels H-Sphere 3.1 User guide

Related papers

Other documents