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.
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
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.
12 Preface
Preformatted
On-screen computer
output in your commandline 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 Reseller guide aims at resellers of hosting services and explains
C H A P T E R 2
About This Guide
how to configure and administer Parallels H-Sphere control panel.
Parallels H-Sphere is a comprehensive hosting automation system that allows you to
In this chapter:
Getting Started .................................................................................................. 15
Step 1. Access Your Reseller Account .............................................................. 15
Step 2. Create a DNS Zone ............................................................................... 16
Step 3. Create an Instant Alias Template .......................................................... 16
Step 4. Add Server Aliases ................................................................................ 17
Step 5. Change Temporary CP Alias to Your Own Reseller CP URL ................ 17
Step 6. Configure Mail Notification Addresses ................................................... 18
Step 7. Set up Payment Settings ....................................................................... 19
Step 9. Create Billing Periods ............................................................................ 21
Step 10. Configure Support Center ................................................................... 21
Step 11. Look and Feel ..................................................................................... 22
C H A P T E R 3
Introduction
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, 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.
Getting Started
To switch to Reseller Billing CP:
To switch to Reseller Admin CP:
This document explains what you need to do in order to set up your hosting system with
minimum required configuration. We presume that your reseller account has been created.
Follow the given instructions step by step to configure your Reseller CP.
Step 1. Access Your Reseller Account
Parallels H-Sphere offers simplified reseller concept which means more convenient way to
work with both the Reseller User account (hereinafter referred to as Reseller Billing) and the
Reseller Master Admin account which is now created automatically once reseller account is
created. Each of the above accounts has its own CP design.
The new approach allows resellers to switch between accounts easily without having to log
out/into accounts as if they worked with one CP. Both Reseller Admin and Reseller Billing
interfaces are provided with respective links (menu items) to switch between reseller billing
account and reseller admin account CP's. They will open in one and the same window.
Second way to access Reseller Admin CP is to log into your Reseller Admin CP from
Reseller Billing interface. In this case, however, Reseller Admin CP will open in the new
window.
There's also a third way to access Reseller Admin Section: via Reseller CP URL which can
contain either Reseller CP alias or registered domain name. Enter URL into the address bar
and when the login page is loaded, enter Reseller User (billing account) login and password.
Parallels H-Sphere will send you to the Reseller Admin CP. However, we don't recommend
doing so for privacy/security reasons. Reseller can have several Admin accounts but only
one Reseller Master Admin Account. According to that, switching between the Reseller Billing
and Reseller Admin is possible only via Reseller Master Admin. Minor Admin accounts can't
find and log into the Master Admin Account, therefore switching panels is security safe.
Step 2. Create a DNS Zone
Now that you have entered the admin account, you need to setup your DNS:
1. Go to DNS Manager -> E. Manager > Add DNS Zone.
2. Enter all necessary information on the page that appears, where:
Name: the name of your domain without the "www" part.
Admin e-mail: your e-mail address with ' .' instead of '@'
Allow third level domain hosting: check this box to let your customers register domains
like customerdomain.yourdomain.com.
Master server and slave 1: Leave as is.
3. Click Submit.
Step 3. Create an Instant Alias Template
The instant alias template is required to generate instant aliases. They provide immediate
access to your customers' sites while DNS servers get updated.
To create an Instant Alias Template in your admin account control panel:
1. Select DNS Manager in the E. Manager menu.
2. Choose DNS zone and click the Edit icon under the Action field.
3. At the top of the page that shows, click the Add instant alias link.
4. In the form that appears, enter "u" or any other letter for prefix and leave the
shared IP tag value as it is. Click Submit.
5. You will now need to go to your domain registrar and create the name
servers that are associated with your domain name. Use the IP numbers that
were assigned to the name servers.
Step 4. Add Server Aliases
If you, as a reseller, don't need your own DNS servers, skip this step.
Server alias is your own name for the parent host. Once you set up the server alias, it will
appear everywhere in place of the real server name. In other words, the parent host will
become totally transparent to the end customers, and you will look to them as a totally
independent hosting provider.
To add server aliases:
1. Select Server Aliases in the E. Manager menu.
2. Set your server aliases for each host in the Reseller`s DNS server aliases section
and click Submit. These server aliases must be registered with your domain
name registrar. Note: Name servers and the corresponding IP's for each of
them will show in Reseller`s DNS server aliases section.
3. Set your server aliases for each host in the Other reseller's server aliases section
and click Submit. These server aliases must be registered with any registrar.
Note: until your name servers are registered by an accredited registrar, they
will never be recognized by servers across the Internet and none of your
reseller domains will work. It usually takes about 2 to 4 days before these
name servers become active across the Internet.
Step 5. Change Temporary CP Alias to Your
Own Reseller CP URL
Once the system configuration is completed, the reseller CP can be accessed by the instant
reseller CP domain alias.
To change this temporary CP alias to your own Rreseller CP URL:
1. Switch to Reseller User panel
2. Go to Info - > Admin Settings and change Reseller CP URL:
Set the protocol: http for regular or https for SSL secured
Enter the new domain name with cp at the beginning. (e.g.: cp.example.com).
Leave the the port number as is - it must be the same as that of the parent hosting
company.
3. Click Change.
As a result, the URL of the control panel will be similar to http://cp.example.com:8080
Step 6. Configure Mail Notification Addresses
To subscribe your staff to receive copies of user e-mail notifications:
1. Go to the Settings menu - > Notifications - > Notification Recipients.
2. On the page that appears add subscribers to mailing lists you choose.
Step 7. Set up Payment Settings
On this step you can configure Parallels H-Sphere to process credit cards, accept check
payments and perform online web payments for the services you provide.
To configure credit card processing through Merchant Gateway Manager:
1. Go to the Settings menu ->Payment Settings -> CC Brands and add necessary CC
brands.
2. Go to the Settings menu ->Payment Settings -> Merchant Gateway and add
necessary merchant gateway from the drop down menu and click Add.
3. In the Set Active drop down box, select this merchant gateway. You can have
only one active merchant gateway at a time.
4. In the Payment Type drop down box, select the CC brand you would like to
process with this merchant gateway.
5. Click the Activate button.
To configure Web Payment Processor, like PayPal or 2CheckOut:
1. Go to the Settings menu ->Payment Settings -> Merchant Gateway.
2. Select the payment system from the drop-down menu and click Edit:
3. Enter your account settings. Once you enter correct settings, the web
payment system will appear in the list as Active
To configure Processing Check Payments:
1. Go to the Settings menu ->Payment Settings -> Merchant Gateway.
2. Enable Accept Checks.
Step 8. Create Plans
Create Hosting Plans
Now that your control panel is configured, you can create hosting plans.
1. Go to Plans -> Create and click Select next to the plan to start the wizard.
2. Enter the name of the plan at the top of the page.
3. Select the resources (features) you would like to include in the plan. Make
sure to leave Service Domain unchecked.
4. In the last section of the wizard, make sure to enter Credit limit, e.g. 10 and
click Next to proceed.
5. Enter prices and free units for each type of resource and click the Create
button at the bottom of the page.
6. Go to Plans -> Manage and turn this plan ON for signups.
Now your control panel is ready for signing up users. Please read all documentation before
using Parallels H-Sphere as a production system.
Create a System Plan and Account For Your Corporate
Domain
This step is required to host your corporate promotion site with your hosting system.
1. Go to Plans -> Create menu and select a Unix or Windows plan wizard
2. On Step 1, set the plan name to System and include resources you want to
use with your site.
3. Make sure to check Service domain and in the Settings section set Billing Type to
Without billing.
4. Submit and complete the wizard.
5. Go to Plans -> Manage and click Access for the System plan and make sure only
Admin is checked.
6. Go to Signup menu and create System account using the Signup Wizard
Note: Your system account is treated as an ordinary end customer account. You'll be
charged for all resources used in this account.
Step 9. Create Billing Periods
Each plan can have several billing periods with different price discounts for each. You can't
delete billing periods, but you can change their duration. For instance, if you create a billing
period for 1 year and you find out you don't need it, you can change it to 3 months.
To create a billing period for a plan:
1. Go to Plans -> Manage and click Settings in the Advanced section.
2. Scroll down to the Payment Intervals and click Add.
3. Specify the duration of the billing period. For instance, to make it 3 months
long, select MONTH and enter 3 in the Size box.
4. Optionally, enter discounts. For instance, if you want to cancel any setup fee
for this billing period, enter 100 in the Setup Discount field.
5. Click Submit. This will add the billing period to the list.
Step 10. Configure Support Center
Support Center is the web-based means of providing customer support.
To configure your Support Center:
1. Go to Plans -> Create menu and choose Administrator Plan Wizard.
2. Enter TechSupport Admin as the name of the plan, check to include TroubleTicket
Admin and Allow assignment of trouble tickets and submit.
3. Go to Plans -> Manage and turn this plan ON for signups.
4. Go to Signup menu, click to sign up for Tech Support Admin and create Tech
Support Admin account using the signup wizard.
5. Go to Settings - > Tech Support and configure your Support Center. It is
required to collect customers' e-mails and convert them into trouble tickets.
Step 11. Look and Feel
Go to Settings -> Look and Feel menu and enter information to all necessary sections. These
settings will affect all your customers' control panels.
Corporate Logos : enter Banner HTML Code for the banner to show up in your users CPs
and the location and sizes of the logos. Click the help [ ? ] icon for details.
Company Info: enter the company info that will show in customer e-mail notifications and
the address will be used by customers to send checks.
Default language: choose CP interface language. It can be overridden by individual
customers.
Regional options: enter preferred currency symbol.The language and the regional settings
will affect all your customers' control panels.
Default CP design: set designs to be available by users and the default design for Users
CPs.
This chapter discusses the configuration steps required for your DNS.
In this chapter:
DNS Manager ................................................................................................... 24
Adding DNS Zones ............................................................................................ 24
Instant Alias Templates ..................................................................................... 26
DNS Records .................................................................................................... 29
Hosting Your Corporate Site .............................................................................. 33
Adding Domains for Third Level Hosting ........................................................... 34
Providing Mail Under Service Domain for Third-Level Hosting ........................... 35
C H A P T E R 4
DNS and Hosting
24 DNS and Hosting
DNS Manager
DNS Manager in the Admin panel is used to create and manage:
service DNS zones - to host your corporate site and provide third level domain
hosting.
instant alias templates - to provide immediate access to users' newly registered
domains until their domain's DNS hasn't been propagated.
DNS records - to manage servers external to Parallels H-Sphere with Parallels H-
Sphere DNS.
It's not intended to work with your user domains' dns.
Adding DNS Zones
You must have at least one DNS zone in your system. Before you start adding a DNS
zone, make sure to have added the DNS servers with Service IPs.
To add a DNS zone:
1. Select DNS Manager in the E.Manager menu:
2. Click the Add DNS Zone link:
DNS and Hosting 25
3. Enter zone name and zone administrator e-mail and choose whether to
allow third level domain hosting in this zone:
Name: the name of the DNS zone you are going to create. If this domain name is
not yet registered, don't forget to register it with a domain registration company.
Admin e-mail: the e-mail address of this DNS zone administrator.
Allow third level domain hosting: allow the creation of lower level domains in this
DNS zone.
Master/slave server: available only for service DNS zones - allows you to choose
and appoint a master and a slave server. The information is backed up every
hour.
4. After you submit the form, the new zone appears in the DNS Manager
table:
26 DNS and Hosting
5. Click the EDIT icon to go to the DNS zone management page. Here you
In this section:
Adding Instant Alias Templates ......................................................................... 27
Editing Instant Alias Templates ......................................................................... 28
can add instant alias templates, custom DNS records and Reseller CP
alias to your DNS zone:
Instant Alias Templates
Instant Alias Templates are used to generate Instant Aliases, temporary addresses
providing immediate access to users' domains from the Internet. They are usually
helpful when the DNS servers worldwide are being refreshed and the site is temporarily
unavailable at the regular domain name.
Creating an instant alias template will automatically add one or more A-DNS records to
your service zone. These records resolve all your logical servers.
DNS and Hosting 27
Adding Instant Alias Templates
To add instant alias:
1. Select DNS Manager in the E.Manager menu.
2. Click the EDIT icon to go to the DNS zone management page. The
following page appears:
28 DNS and Hosting
3. To add an instant alias template, click the Add instant alias link. This will
open the following form to fill out:
Prefix: instant alias prefix that will appear on the left to the domain part in user's
instant domain alias. Different prefixes should be set if you use different shared
IP tags. Other than that, it is recommended to use one and the same prefix (e.g.
u for all instant alias templates).
Shared IP tag: a digital "mark" that helps separate sites within one plan on one
logical server. All sites located on the same logical host under the same plan are
usually assigned to the same shared IP. This feature allows to give a different
shared IP to a group of sites of, say, explicit nature. This may become
necessary as many corporate firewalls filter sites based on their IP, not the
domain name.
Normally, you are expected to have devoted one IP address for each shared IP
tag. To use a shared IP tag, you need to have it defined for every logical host.
Numbers 10 to 99 are acceptable. The default value of 2 is assigned when the
field is submitted being empty.
4. Click Submit. You will be taken back to the list of instant aliases with the
new instant alias template added to the list.
Editing Instant Alias Templates
Once an Instant Alias is created, the system adds all necessary A DNS records to this
DNS zone.
To view these DNS records, cilck the Edit button near the necessary Instant Aliases:
DNS and Hosting 29
The upper part of the table lists the existing DNS A records in the selected DNS zone.
To delete DNS records, click the Trash icon.
The lower part of the table appears only when the DNS zone does not contain A
records for some logical servers. It lists these logical servers with their IP's.
To add a logical server to the DNS zone, click the Add button. You can add all these
servers to the DNS zone by clicking the Add records to all listed logical servers link at the
bottom of the table.
To delete Instant Alias Template, click the Trash icon next to the corresponding alias.
DNS Records
Custom DNS records are required to manage non-HSphere servers with Parallels HSphere DNS zone or to configure new logical servers that are added manually.
Depending on the service, you can add:
A records
MX records
CNAME records
To add new custom DNS records:
1. In your admin control panel go to the E.Manager menu -> DNS Manager.
The following page shows:
30 DNS and Hosting
2. Click the Edit icon near the chosen DNS zone. A page similar to this will
In this section:
Adding custom A records ................................................................................... 30
Adding custom MX records ................................................................................ 31
Adding custom CNAME records ........................................................................ 32
appear:
3. At the bottom of the page that shows, select a DNS record from the
drop-down list and click the Go button.
4. On the form that shows enter all necessary data and click Submit to
save.
You can add one of the following types of DNS records:
A records to map domain names and web server IP's.
MX records to map domain names and their mail server IP's.
5. CNAME records to map aliases with domain names.
Adding custom A records
The Address record (A record) gives you the IP address of a domain. That way, users
that try to go to www.example.com will get to the right IP address.
To add a new DNS A record, you need to provide a set of parameters:
Loading...
+ 341 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.