Getting Started Guide

Getting Started Guide
Release 3.2

ISBN: N/A
SWsoft Inc
13755 Sunrise Valley Drive
Suite 325
Herndon, VA 20171
USA
Tel: +1 (703) 815 5670
Fax: +1 (703) 815 5675

Copyright © 1999-2005 by SWsoft, Inc. All rights reserved
Distribution of this work or derivative of this work in any form is prohibited unless prior written permission is
obtained from the copyright holder.
Virtuozzo, Plesk, HSPcomplete, and corresponding logos are trademarks of SWsoft, Inc.
Intel, Pentium, and Celeron are registered trademarks of Intel Corporation.
IBM DB2 is a registered trademark of International Business Machines Corp.
MegaRAID is a registered trademark of American Megatrends, Inc.
PowerEdge is a trademark of Dell Computer Corporation.

3

Contents

Preface 6
About This Guide .........................................................................................................................................6
Audience............................................................................................................................................6
Typographical Conventions...............................................................................................................6
Feedback............................................................................................................................................7
Meet the HSPcomplete .................................................................................................................................7
HSPcomplete Advantages .................................................................................................................8
HSPcomplete Deployment Scenario................................................................................................10
HSPcomplete Interfrace Features ....................................................................................................10
HSPcomplete Tools .........................................................................................................................12
Browsers Compatible with HSPcomplete........................................................................................13

Starting HSP Business with HSPcomplete 14
Connecting to HSPcomplete Browser-Based Tools ...................................................................................15
Making Initial Settings................................................................................................................................16
Getting Acquainted with Provider Control Center......................................................................................18
Looking into Reseller Control Center.........................................................................................................22
Inspecting Customer Control Panel ............................................................................................................24
How to Register Users and Set Access Permissions...................................................................................27
Configuring Data Center and Connecting Hardware ..................................................................................30
Allocating IP Addresses ..................................................................................................................31
Establishing Connection with Hardware .........................................................................................32
Setting Up DNS...............................................................................................................................33
Setting Up the Billing .................................................................................................................................34
Getting Ready to Sell Hosting Services......................................................................................................35
Basic Notions Used in HSPcomplete Billing ..................................................................................36
Creating Hosting Plans ....................................................................................................................38
Configuring Online Store ................................................................................................................39
Securing HSPcomplete Tools Using SSL........................................................................................40

Contents 4

Going Live 41

What's Next? 43
Managing Receivables................................................................................................................................43
Supervising the Cash Flow .........................................................................................................................44
Monitoring the Data Center Resources Usage ............................................................................................46
Checking the Licenses Usage .....................................................................................................................47
Daily Activities...........................................................................................................................................47

Getting Technical Support 51
An Overview of SWsoft Technical Support ...............................................................................................51
Questions for Technical Support ................................................................................................................51
How to Send Support Questions .................................................................................................................51

Index 52

5

Table of Figures
Figure 1: Provider Control Center. Managing Virtuozzo VPS (screen shown in part). .....11
Figure 2: Provider Control Center screen. ..............................................................................18
Figure 3: Reseller Control Center (screen shown in part). ....................................................22
Figure 4: Control Panel. ............................................................................................................24
Figure 5: My Control Panel. Working with the File Manager (screen shown in part). ......26
Figure 6: Provider Control Center. Setting Access Permissions per user roles. ..................28
Figure 7: Provider Control Center. Assigning User Roles within a given Account. ............28
Figure 8: HSPcomplete security model. ...................................................................................29

6

CHAPTER 1

Preface
HSPcomplete is a comprehensive full business life-cycle hosting automation solution. With
HSPcomplete you can manage hardware, OSs, applications, backups, IP pools, customers,
resellers, e-commerce storefronts and customer payments all from a single system. A billing
system integrated with automated account provisioning, scalable to tens of thousands of
accounts, allows you to fully automate the process of launching new subscriptions, managing
recurring subscriptions, and billing for resource utilization.

In This Chapter
About This Guide.................................................................................................................. 6
Meet the HSPcomplete.......................................................................................................... 7

About This Guide
This Guide describes the most important and frequently-used HSPcomplete working scenarios
including initial settings for the system.

Audience
This guide is addressed to Hosting Service Providers and helps both to evaluate and get
acquainted with HSPcomplete hosting automation solution.

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

Formatting Type of Information Example
convention
Triangular Step-by-step procedures. You can
To create a VPS:
Bullet( ) follow the instructions below to
complete a specific task.
Special Bold Items you must select, such as menu Go to the QoS tab.
options, command buttons, or items in
a list.
Titles of chapters, sections, and Read the Basic Administration chapter.
subsections.

Preface 7

Italics Used to emphasize the importance of a These are the so-called EZ templates.
point, to introduce a term or to
To destroy a VPS, type vzctl destroy
designate a command line placeholder,
which is to be replaced with a real vpsid.
name or value.
Monospace The names of commands, files, and Use vzctl start to start a VPS.
directories.
Preformatted On-screen computer output in your Saved parameters for VPS 101
command-line sessions; source code in
XML, C++, or other programming
languages.
Monospace What you type, contrasted with on- # rpm –V virtuozzo-release
Bold screen computer output.
CAPITALS Names of keys on the keyboard. SHIFT, CTRL, ALT
KEY+KEY Key combinations for which the user CTRL+P, ALT+F4
must press and hold down one key and
then press another.

Feedback
If you spot a typo in this guide, or if you have thought of a way to make this guide better, we
would love to hear from you!

If you have a suggestion for improving the documentation (or any other relevant comments), try
to be as specific as possible when formulating it. If you have found an error, please include the
chapter/section/subsection name and some of the surrounding text so we can find it easily.

Please submit a report by e-mail to userdocs@swsoft.com.

Meet the HSPcomplete
HSPcomplete is an end-to-end solution for hosting service providers (HSPs) and Internet Data
Centers covering full life-cycle of HSP/IDC operations. HSPcomplete allows HSPs to
drastically decrease the cost of operating hosting business while increasing revenues,
developing new reseller channels, and improving usage of hardware and personnel resources.

Preface 8

HSPcomplete Advantages
HSPcomplete includes everything a company needs to run a successful and profitable hosting
business from advanced technology and tools to manage your servers and overall infrastructure
to billing, sales channel management, and e-commerce application:
The full range of services supported:
Domain registration SiteBuilder support
Plesk Domain hosting VPS/Plesk dedicated resellers
Virtuozzo VPS hosting Dedicated or Co-location
Plesk and SiteBuilder licenses Miscellaneous

Complete infrastructure management:
powerful VPS management server-/client-side backups
IPs allocation and DNS integrated trouble ticketing
administration
maintenance automation and
flexible self-provisioning more

Integrated complete billing solution:
customizable online store discounts, promotions, coupon
codes
country-specific accounting
taxation with tax exemption
automated recurring invoicing
automated upgrades/downgrades
private label resellers
customizable notifications and
more

Credit Cards processing through over 30 payment gateways (new added
monthly):

integrated with fraud screening sensitive data is encrypted
flexible manual approval rules delayed capture
refunds, reversals, credits CVV/AVS verification and more

Preface 9

Bank transfer payments for German (DTAUS) and Spanish (Norma 19) standards: flexible
batch management with approval queues.

Domain registrations through over 25 domain registrars (new added monthly):

Wide range of Operating Systems and Applications for VPS hosting:
centralized management Redhat, Fedora, Suse, Debian
automated upgrades open-source and commercial
applications
over 50 applications
game servers and more

Easy customization and integration:
notifications customization application templates creation
guide
customizable menu items
HSPcomplete powerful API
colors, logos, page content
migration from Legacy systems
create your own plug-ins
advanced multi-language support
XML data export/import tools

Everything in one box!

Preface 10

HSPcomplete Deployment Scenario
HSPcomplete can be successfully installed both on the physical server or (if you use the
Virtuozzo technology) in Virtuozzo Virtual Private Server (VPS).

The computer (or virtual server) that runs HSPcomplete is called Management Node in terms of
HSPcomplete. The servers that run software that provides hosting services (run Virtuozzo VPSs,
Plesk Domains, or some other third-party software) are called Hardware Nodes. HSPcomplete
administrator can connect to the Management Node via the Internet and guide the hosting
business using the web-based interface.

HSPcomplete Interfrace Features
Navigation
To use one or another HSPcomplete component or tool, please use the namespace tree located
in the left pane.

Control Centers specific:
You can hide/display the namespace tree by clicking on the slider at the vertical bar that
separates the left and the right parts of the screen.

Preface 11

When you start your HSPcomplete session, the path (chain of links) appears at the top of the
screen. These links provide the "breadcrumb navigation" and show you the path to your actual
location within the HSPcomplete. By clicking on these links, you can be one or more
(depending on your location) levels up.

Figure 1: Provider Control Center. Managing Virtuozzo VPS (screen shown in part).

Main Screen
The right pane of HSPcomplete screen serves for operating HSPcomplete components selected
from the namespace tree. The main screen shows the HSPcomplete Directors' or Managers'
dashboards, lists of objects, single object's properties, or other related data.

Each HSPcomplete component (Director or Manager) has its own dashboard. Moreover, the
HSPcomplete system has its dashboard that may be considered as 30,000-foot view of tools and
operations. So, a dashboard is the HSPcomplete component 'front-page' that provides you with
the most important statistics and a place to start including:
Shortcuts to the lists of objects.
Information about the number of objects with separate counters for the objects in different
states like Active Accounts, Accounts on Hold, Running Virtual Private Servers, etc.
Shortcuts for the creation of new objects that fall into the functionality of HSPcomplete
component selected.
Control Centers specific:
a The Status Bar at the bottom of the main screen allows tracking execution of tasks within
HSPcomplete system. You can hide or show the status bar.

Preface 12

b The Action Bar allows managing Virtual Private Servers. If you are working with
Infrastructure Manager (or other Managers that bound to Infrastructure Manager
functionality in respect to VPS stop, start, destroy, repair, creation, and migration), the
Action Bar appears at the bottom of the main screen, over the Status Bar. The Action bar
allows performing the group operations.
To facilitate operating the lists of objects in the HSPcomplete, you can use:
Search particular item within the list. The Search bar is located at the top of each list.
Filter the items by a particular property. The Filter bar is located at the top of each list, next
the Search bar.
Change Sorting Order. To this effect, click on the column-heading you want to sort by. In
this case, the special pointer (small triangle) appears at the top of each column. This triangle
indicates current sorting order: peak-up or peak-down for ascending and descending order
respectively. Repeating click on the same link in column-heading changes sorting order
from ascending to descending (and conversely) within single property.
Change List Size. It is possible to set the listing to 20, 40, or 80 items per page. Appropriate
links are above the list, to the right. Special links for viewing pages (page numbers,
next,last) are also provided and you can find them both at the beginning and the end of the
list.
In order to immediately bring the screen content in correspondence with actual state of affairs,
you can Refresh the screen using the button located at the upper right corner of the screen.

The Help button located at the upper right corner of each screen shows the context HTML help.

Screen ID is located at the upper-right corner of each screen. Screen ID allows to refer to a
screen for customization purposes or in the problem report.

Adding a Comment to the HSPcomplete Object
You can add a free-form comment to almost any of HSPcomplete object. To this effect click on
the Add comment link at the upper-right corner of an object view form.

HSPcomplete Tools
HSPcomplete modular design consists of four main subsystems each with web-based tools to
manage a part of hosting service provider business:
Provider Control Center (HSP GUI). Browser-based tool for the Hosting Service
Provider. Includes the customizable online store and front-end website. Provider Control
Center allows managing all the HSPcomplete tools and supervising Resellers' online stores.
In addition a Provider can log in to any Reseller Control Center or any of Provider's
customers' Control Panels.
Reseller Control Center (Reseller GUI). Browser-based tool for the reseller. Provides
access to the functionality of HSPcomplete components (directors and managers) available
for the reseller plus customizable online store and front-end website.
Note: Each Control Center allows hosting services provisioning with access to the
HSPcomplete Control Panel.

Preface 13

Customer Control Panel. HSPcomplete Control Panel is a browser-based tool that allows a
customer to manage his (or her) account and buy services using the Control Panel Upgrade
Center. Without respect to existence of subscriptions and services purchased, the Control
Panel is available by default for all persons that have HSPcomplete Accounts of "customer"
type.
In addition there are three task-oriented sets of tools that alow a customer to build a
website, or perform system administration tasks (manage Virtuozzo VPS or Plesk
domain), or create end-users with ability for such a user to manage both a mailbox and
home directory via the special browser-based tool. These sets of tools are also called
Control Panels and sold as applications included in hosting plans:
Workgroup Administrator Control Panel (WACP). An application that includes tools
for small company administrator or workgroup administrator (or workgroup users
without the dedicated administrator). It hides from the user the complexity of server
administration and allows users without deep system administration knowledge to
perform simple tasks like mail management and website deployment.
System Administrator Control Panel (SACP). An application for the system
administrator that allows managing VPS. Users should have the basic system
administration knowledge. SACP allows a customer to configure VPS services and
users, configure mail, manage databases.
My Control Panel (MyCP). My Control Panel is sold as an application within a hosting
plan and provides access for VPS or Plesk domain users to the browser-based end-user
tool that allows managing user personal information, configuring e-mail autoresponders,
configuring mail forwarding to an external address, both uploading and managing files
in user home directory.

Note: It is possible to integrate the custom e-commerce solutions with HSPcomplete using the
API provided. For more details on customization, please refer to the HSPcomplete Integration
Guide.

Browsers Compatible with HSPcomplete
The following browsers are fully compatible with HSPcomplete web-based tools:

For IBM PC compatible computers:
Microsoft Internet Explorer 5.5, 6.0 and above,
Netscape Navigator 7.0 and above,
Opera 7.5.3 and above,
Mozilla 1.5 and above,
Firefox 1.0 and above.
For Macintosh:
Safari 1.3 and above,
Microsoft Internet Explorer for Mac 5.2,
Opera 8.5
Mozilla/Firefox 1.07.

14

CHAPTER 2

Starting HSP Business with
HSPcomplete
Using the HSPcomplete tools you can compose hosting services offerings called Hosting Plans
and publish these offerings in your e-commerce store. Services are provided automatically in
accordance with orders processing.

The HSPcomplete allows providing a wide range of hosting services:
Dedicated (physical server):
Virtuozzo - physical server with Virtuozzo installed and ability to create virtual private
servers and sell them to customers. Virtuozzo dedicated hosting can be provided both to
Enterprise Customers and Resellers. Provider can manage a Hardware Node on the
system level plus fully automated billing is provided.
Plesk - physical server with Plesk Server Administrator software installed.
Plesk server in VPS that behaves exactly as a stand-alone physical Plesk server.
Physical server with an arbitrary software installed. In this case, a Provider can bill the
customer that have bought the server and manage the dedicated subscription, but it is not
possible to manage this server on the system level using the Provider Control Center
tools.
VPS (virtual private server):
Virtuozzo Virtual Private Server (with root access or without root access) that behaves
just like a standalone physical server.
Name-based Virtuozzo Virtual Private Server. Virtuozzo name-based hosting is a VPS-
related implementation of a well-known technique of name-based web hosting,
implemented, for example, in the Apache web server. Virtuozzo name-based hosting
enables the Hardware Node administrator to provide a single external IP address for all
or a number of VPSs hosted on that Node.
Shared:
Plesk Shared (Plesk Domain) with ability to create website, upload files and images,
manage mail and database.
Plesk Multi Domain:
Plesk Client account with ability to create and manage Plesk Domains.


Domain Registration
Miscellaneous (custom and non-hosting services). Note that you can add custom services
that can be billed or not (for example, support) to any of hosting plans.
More information about HSPcomplete and its many features is available in the HSPcomplete
Provider's Guide.

In This Chapter
Connecting to HSPcomplete Browser-Based Tools.............................................................. 15
Making Initial Settings.......................................................................................................... 16
Getting Acquainted with Provider Control Center................................................................ 18
Looking into Reseller Control Center ................................................................................... 22
Inspecting Customer Control Panel ...................................................................................... 24
How to Register Users and Set Access Permissions ............................................................. 27
Configuring Data Center and Connecting Hardware ............................................................ 30
Setting Up the Billing ........................................................................................................... 34
Getting Ready to Sell Hosting Services ................................................................................ 35

Connecting to HSPcomplete
Browser-Based Tools
To connect to the HSPcomplete tools, enter into your browser the Management Node hostname
and append the tool index (http://hostname/index):

Tool Tool index
Public Site site
Online Store store
Provider Control Center pcc
Reseller Control Center rcc
Customer Control Panel cp

The SSL protocol can be enabled from Provider Control Center, separately for each of
HSPcomplete web-based tools. The SSL configuration is available both in Provider and Reseller
Control Centers.

Your first HSPcomplete session starts from the Provider Control Center. After you make some
initial settings to HSPcomplete, you can log in to any of the other tools.

After you connect to the HSPcomplete Provider Control Center, you will be prompted for login
and password. Enter the default login and password generated by the HSPcomplete installer.
The default is an e-mail like root@your_management_node_hostname (in actual login
your_management_node_hostname must be replaced with an actual hostname of the computer
that runs HSPcomplete, i.e., the Management Node) and the password is generated in a random
way by the HSPcomplete installer.


Making Initial Settings
When you log in to HSPcomplete Control Center for the first time, the Initial Setup Wizard will
help you to make the settings required for HSPcomplete initial configuration.

The Wizard starts with the User Agreement approval and then step-by-step helps you to make
the basic initial settings that form the working background for the HSPcomplete Control Center.

We shortly describe the basic steps of Initial Setup to help you understand how the settings
made by you will be used, why they are important and how you can adjust these settings later.

Adjusting your Hosting Company Requisites and Making System-Wide Regional Settings

After you accept the User Agreement, you will be offered to adjust your Administrative
Account (i.e., your hosting company) profile and make some other system-wide settings.

The correct and fully specified administrative account contacts are important for successful
domains registration requested for your own using the HSPcomplete domain registration plug-
ins since this information is usually passed to domain registrars via plug-in interface. Later you
can adjust your administrative account profile by clicking the topmost menu item in the left
frame of Provider Control Center and selecting the Company Profile or Contacts tab.

The default language is used by default is your online store. Default time zone is applied to new
accounts created in store by your customers. The first day of week used in billing reports. Later
you can change these settings in Configuration Director - Miscellaneous Settings - Regional
Settings.

Installing HSPcomplete License

The HSPcomplete Licence defines:
The number of users registered in your administrative account (your staff members) that can
concurrently log in to the Provider Control Center.
The maximal number of reseller accounts you can register.
The maximal number of customer accounts you can register.
HSPcomplete trial license is shipped together with HSPcomplete distribution. You can install
the real license during Initial Setup or later, using the Configuration Director - License Manager.

Setting Up Domains Registration

This step of Initial Setup allows you to configure the testing environment for domains
registration and allocate IP addresses. More IP addresses (IP pools) can be registered in Service
Director - IP Manager.

The default domain is allowed for subdomains registration in your online store.

HSPcomplete offers more than 25 domain registration plug-ins and you can configure them later
in Service Director - Domain Manager.


Finally, you can set the secondary name server. More name servers cane be registered later in
Service Director - Domain Manager.

Setting Up Billing System

The initial billing settings include:
Setting the default settlement conditions for customers. Settlement conditions are defined by
credit terms. Credit terms are set per account. The default credit terms are assigned by
default to accounts created by your customers from your online store. Later you can add
more credit terms using the Account Director - Subscription Manager - Credit Terms.
Settlement conditions for resellers are defined by a special complex setting called partner
level. Partner level define both credit terms and reseller discount. Partner levels are assigned
per reseller account and can be added using the Billing Director - Discount Manager - Partner
Levels.
Setting the default tax rates and enabling taxation system-wide. Tax rates in HSPcomplete
can be assigned either by a customer country or an account. Tax rates (one or more) are
grouped by tax zones. Tax zone holds the information about a customer country (specified
in a customer account profile) or account(s) to apply tax rates specified for this tax zone.
The default tax zone matches all accounts/countries that do not have any special tax zone
defined. Please note that for the fresh installation the default tax zone is already created and
the initial setup offers you to set up to two tax rates for the default tax zone. Later you can
add more tax rates and create more tax zones as well as set up tax exemption using the
Billing Director - Taxation Manager.
Setting up credit cards and bank accounts processing. To process delayed online payments,
use recurring payments, and store bank accounts data (to generate batches) you must
configure encryption, i.e., upload a key pair. The Initial setup allows generating a self-
signed key pair, which is enough for testing. Later you can upload the signed keys using the
Commerce Director - Payment Processing - Secure Storage.
Warning: If you are planning to use the self-signed keys for some time, it is strongly
recommended to save the keys so you could upload them in case the keys will be
unintentionally wiped out or corrupted. You can do this on the next step of Initial Setup.
Creating sample hosting plans of the basic types. Sample hosting plans creation allows you
to save time and start system testing immediately after completing the initial setup. You can
view and add new hosting plans in the Billing Director - Product Manager - Hosting Plans.
Making Basic Website Settings
The Initial Setup offers you to upload your website logotype. Later you can upload more
images and files you would like to publish at your website using the Marketing Director - Site
Manager. In addition, the standard set of images used in the HSPcomplete interface can be
updated using the Marketing Director - Brand Manager - Skins. Files and images can be
uploaded using the Images and Files option under the Brand Manager.
Select the default skin that will pre-fill the relevant field in the New user forms (a skins is a
personal setting and is assigned per registered user) and will be applied to your online store
and other website pages.
Open he online store. Check the Store is open box to open your online store. Later you can
enter the User Agreement, select payment systems, adjust hosting plans listing, and make
many other additional settings to your store using the Commerce Director - Store Manager.


Getting Acquainted with Provider
Control Center
The Provider Control Center offers the wide set of tools, which are grouped into seven main
sets, called Directors each of them includes the specific subset of tools called Managers.
Managers, in their turn, include one or more specific options in their submenus. You can move
from one Director or Manager to another using the namespace tree in the left frame.

Figure 2: Provider Control Center screen.

Below we describe all directors more in details.

Account Director

Account Director provides functionality for customer accounts management, partner/reseller
enrollment and management, subscriptions overview, credit terms setup, customer care:


Service Director

Service Director allows allocating IP addresses for HSPs data center, supervising resources
usage, and managing all types of services a HSP can sell using the HSPcomplete solution:
Virtuozzo VPSs, Plesk, SiteBuilder add-ons, physical servers, domains, both Plesk and
SiteBuilder Licenses:

Billing Director

Billing Director provides a complete accounting system for HSPs business: actual HSPs balance
and customers/resellers accounts balance, receivables management, pricing tools including
promotions, discounts, and taxation, default prices for service offerings, hosing plans
management, revenue reports, country-specific accounting:


Commerce Director

Commerce Director allows configuring online store and serves for everything connected with
payments: credit card payment plug-ins and tools for online payments approval, bank transfer
plug-ins and batch processing, transaction log, payments processing setup and encryption for
credit cards/bank accounts private data, recurring billing, fraud protection and customer
subscriptions upgrades setup:

Marketing Director

Marketing Director provides tools for HSPs website configuration and branding, partners
management tools including the ability of both manual and automated online marketing
campaigns creation and viewing campaigns revenue reports plus mass mail sending tool:

Configuration Director

Configuration Director serves for HSPcomplete system-wide configuration: access permissions
for HSP staff and other registered users, internal licensing, events setup, miscellaneous settings
(SSL setup, data retention cycle, messenger, language/currency, etc.), check for available
updates, HSPcomplete vital services monitor:


Migration Director

Migration Director provides tools for data migration into HSPcomplete, including XML
export/import and direct migration from remote servers. In addition a special tool for data
conflicts resolving is provided:


Looking into Reseller Control
Center
In this paragraph we describe just several peculiarities of RCC as an example that can help you
to understand how Provider and Reseller cooperate. For more information, please refer to the
HSPcomplete documentation.

If you would like to take a look on HSPcomplete from reseller point if view, you should log in
to the Provider Control Center and create a reseller account using the Account Director - Reseller
Manager - Resellers. Then the simplest way to log in to the Reseller Control Center on behalf of
this account is to click on the newly created reseller account name, make sure that the General
Settings tab is selected and click the Login to RCC button. The existing login/password will be
accepted without the need for you to enter them and the RCC will open in a new browser
window.

For the first logging in the Reseller Control Center you will have to pass the Initial Setup
Wizard, similarly to how it was when you have logged in to the Provider Control Center. After
the initial setup is finished, the Reseller Control Center appears.

Figure 3: Reseller Control Center (screen shown in part).

At the first sight, Reseller Control Center looks like Provider one.


However, reseller has less tools then Provider (less tools in Managers under HSPcomplete
Directors). For example, domain plug-ins configuration is Provider's business only. You can
check this in Service Director - Domain Manager.

Actually, the availability of different tools for Reseller is subject to the access permissions set in
the Provider Control Center for resellers (on page 27). To see how it works, you can get back to
the browser window with Provider Control Center, go to the Configuration Director - Security
Manager - Setup select the Reseller Permissions tab and clear some boxes under the Reseller
Operations Administrator permissions. Save settings, get back to the RCC and refresh the screen.
You will see that the set of tools available for reseller has changed.

In addition, there some differences in billing. Open the Billing Director submenu. Provider
manages receivables only. And in RCC there are two links - Receivable and Payable. Receivable
is for settlements with reseller customers. And Payable is for settlements between reseller and
provider. When reseller accepts payment from a customer, the corresponding automatically-
issued Provider's invoice falls into the Payables.


Inspecting Customer Control Panel
To take a look at the customer Control Panel (hereinafter, CP), you should first log into the
Provider Control Center and create a customer account using the Account Director - Customer
Manager - Customers. Then select the newly created account from the list, click either the
General Settings or Users tab and then click the Login to CP button. The existing login/password
will be accepted without the need for you to enter them and the CP will open in the new browser
window.

The figure below shows the Control Panel for an account with Virtuozzo VPS subscription to
demonstrate all the Control Panel options. For Plesk subscriptions the HSPcomplete Control
Panel shows the Plesk native panel in the right frame.

For the 'empty' customer account without any subscriptions on it you will see less tabs, and we
describe this below.

Figure 4: Control Panel.

The CP screen is roughly divided into two panes: the menu to the left and the dashboard to the
right. In general, the set of icons (or links) at the Control Panel dashboard duplicates the main
menu functionality. However, the main menu shall be considered as the main navigation tool
since it always shows the full set of control tools that correspond to the tab selected, without
respect to what is going on at the dashboard. And Control Panel dashboard serves as operating
tool.

The CP interface is task oriented: you do not need to have all the links and icons displayed all
the time. Please, click the tabs at the top of the screen to switch to the needed set of tools (zone).


The CP interface corresponds to the services included in the subscription on a customer account.
If there are no subscriptions, then CP allows managing account, buying more services, and
reading user documentation.

Thus, for the fresh installation and without any subscription on your account, you will see the
following CP tabs:
My Account. Everything connected with managing your HSPcomplete account and
subscriptions: here a customer can check his (or her) account balance, manage financial
documents (view invoices, pay orders, etc.), and edit the personal user settings (like
password, account contacts, etc.).
Upgrade Center. Here a customer can upgrade the current Hosting Plan, or buy a new one;
Help. Useful information for a customer about FTP, SSH, or e-mail settings and access to
user documentation. In addition, here a customer can port problem reports if the Trouble
Ticker System in enabled by Provider from PCC.
Other tabs appear if a subscription is registered for an account:
Site. Create and configure websites, manage mail (for VPS subscriptions).
System. For VPS and Plesk domains. Manage users and groups, configure services, manage
databases, manage domains, and add/remove applications.
To look inside the HSPcomplete end-user tool designed for Virtuozzo VPS users, you need to
register at least one Virtuozzo server and create a Virtuozzo VPS subscription for your testing
account.

If you want to log in to the My Control Panel:
1 In the Control Panel, go to the System tab, click the Users icon and create a user. Do not
forget to set password (you will use this password to log in to MyCP). Another way to add a
user (if the Workgroup Administrator Control Panel is installed) is go to the Site tab and
create a mailbox.
2 Loging in to the My Control Panel as this described earlier in this guide.
3 When the Sign In form appears:
a Into the E-mail field Key in the e-mail of a user created before, in the Control Panel. The
e-mail should be the following user-login@system-hostname where user-
login should be replaced with the user name and system-hostname is the
hostname of the Virtuozzo VPS or Plesk domain.
b Into the Password field type the user password.


c Click the Sign In button.

Figure 5: My Control Panel. Working with the File Manager (screen shown in part).

The My Control Panel screen is organized similarly to the Control Panel. The menu in the left
frame, main screen to the right. However there are less tools, only the necessary things:
Personal Profile editor with ability for a user to enter the full name (just to personalize the
interface, without reference to login credentials) and change personal password.
File Manager to manage the user home directory.
Mail Manager with ability to set mail forwarding.


How to Register Users and Set
Access Permissions
Account is the basic HSPcomplete billing notion. A user, i.e., a person registered within an
Account can gain the certain user access permissions to HSPcomplete tools, depending on the
type of Account. A user can be registered in several different accounts and have different access
permissions in each account.

Generally, a user is a record in the database containing the name of person that has the right to
log in to the HSPcomplete on behalf of a certain account using the given login/password plus
some user-specific regional settings (interface language and time zone used both for system
events registration and in system notifications). Users registered within your Provider Account
are called staff members and can be managed separately in the Provider Control Center.

Accounts can be created both manually, from the Control Center and by customers, when they
register in your online store.

Four Account types exist within HSPcomplete system:
Provider Account (only one Account of such type can exist within your HSPcomplete
system). This Account is being registered during the installation procedure. All persons
associated with Provider Account are considered as Provider staff members with particular
access permissions to HSPcomplete Provider Control Center. The number of Provider staff
members that can concurrently log in to the Provider Control Center is defined by the
HSPcomplete license. Provider staff members are managed separately using the
Configuration Director Security Manager - Staff Members.
Reseller Account. Reseller Accounts are managed using the Account Director - Reseller
Manager. The number of Reseller Accounts is defined in the HSPcomplete License. All
persons associated with Reseller Account are considered as Reseller staff members with
particular access permissions to HSPcomplete Reseller Control Center.
Customer Account. Customer Accounts are managed using the Account Director - Customer
Manager. Customer Accounts can be of two types: personal or business. All persons
associated with Customer Account have access to HSPcomplete Control Panels.
Access permissions per user role can be set in the Configuration Director - Security Manager -
Setup.


Figure 6: Provider Control Center. Setting Access Permissions per user roles.

Roles per customer account user can be set in the Account Director - Customer Manager -
Customers - select account and click the Users tab. In addition, you can select any user
(Configuration Director - Security Manager - All Users) register a user within any account and
assign roles within each account.

Figure 7: Provider Control Center. Assigning User Roles within a given Account.

Users


Users (staff members, customers, and resellers) are identified by Accounts. Each person may be
associated with several Accounts and may have different sets of access permissions within
different Accounts. Staff members are users registered within the Provider Account.

User Roles
Roles are being assigned to a User within Accounts. A Role defines the set of tools accessible
by one or another login/password pair. A Role includes a set of access permissions to the
HSPcomplete tools. In the HSPcomplete there are four customizable roles for Provider staff
members and three for Reseller staff members. The set of permissions in each Role is defined
by Provider. Persons registered in customer account get the default and non-customizable role
of Control Panel Administrator.

Permissions
Permissions are assigned per Role, not per individual user. Permissions are assigned separately
to Roles available for HSP staff members and Resellers.

Figure 8: HSPcomplete security model.

Note: Only Provider can edit access permissions from the HSPcomplete Provider control Canter.
And the Reseller Control Center allows Resellers to view permissions set for Reseller staff
members roles (Operations Administrator, Sales and Marketing, and Accountant) by the
Provider. Resellers can read this section to get acquainted with the HSPcomplete security model
and the mechanism of roles assignment.


Configuring Data Center and
Connecting Hardware
The tools for your Data Center management are collected under the Service Director.

In spite of the fact that HSPcomplete operates the virtual-server farm, a Data Center should be
understood in common sense, i.e., as a centralized storage facility to retain database information
related to decision-making processes.

In general, HSPcomplete Data Center activity includes the following:
Servers (Nodes) management;
DNS and IP addresses management;
Service level management.
The hardware configuration to run HSPcomplete includes one computer for Management Node
and two or more computers for Hardware Nodes.

A Management Node is a computer (or a specially configured virtual private server) used for
management. It runs services for web-based management interface (HSPcomplete) and the
database containing information about customers and services. The Management Node also
establishes connection with domain registrars and payment gates.

A Hardware Node is a computer that runs the software (Virtuozzo, Plesk, etc.) that provides
services for customers or a third-party software (server lease, collocation or dedicated hosting).

Dedicated third-party servers can be grouped into racks. A rack in HSPcomplete is a logical
container, it is just a record in the HSPcomplete database. Logical racks can follow the actual
servers grouping at your Data Center.

The HSPcomplete Data Center management tools allow managing the following servers:
Servers that run Virtuozzo that can be used for Virtuozzo VPSs provisioning for customers
and sold as dedicated servers.
Servers that run Plesk that can be used for Plesk Domains or Clients provisioning for
customers and sold as dedicated servers. Plesk servers can also be installed inside Virtuozzo
VPSs.
Servers that run SiteBuilder allowing a HSP to sell Sitebuilder services.
Third-party servers (server lease, collocation, dedicated servers). These servers cannot be
managed directly from the HSPcomplete web-based interface, but in this case, the
HSPcomplete takes care of all the billing matters including creation of dedicated
subscription, charging a customer, issuing the renewal order, sending notifications, etc.
In HSPcomplete, the Virtuozzo, Plesk, or SiteBuilder servers are called Nodes. And third-party
servers are called Servers.

Nodes and third-party servers can be registered and managed using the Service Director and,
depending on a server designation, using the Plesk Manager, Virtuozzo Manager, SiteBuilder
Manager, or Servers Manager for Plesk, Virtuozzo, SiteBuilder, or third-party servers
respectively.


Virtual Plesk Nodes (Plesk installed inside a Viruozzo VPS) are registered automatically as the
Plesk nodes, after the Plesk Server in VPS subscription is activated.

Allocating IP Addresses
The IP addresses assets assigned to the HSPcomplete cluster are managed by groups (IP pools).

Provider can add IP pools using the Service Director - IP Manager - IP Pools. The IP Manager
allows you to automate the configuration of IP address properties such as addresses of the DNS
servers and default gateways for VPSs.

You can allocate only static IP addresses. Static IP addresses are allocated permanently and can
be released only manually.

IP pools can be assigned to specific resellers or hardware nodes or types of hosting:
Assigning an IP pool to a specific type of hosting means that IP addresses from this IP pool
will be used for of particular type of services. This assignment is exclusive, i.e., it is not
possible to assign an IP pool to several types of hosting. You can allocate an IP pool for:
Virtuozzo VPSs and define whether dynamic or static IP addresses allocation is allowed.
Name-based Virtuozzo VPSs and define whether dynamic or static IP addresses
allocation is allowed.
Plesk shared hosting.
Assigning an IP pool to a reseller means that customers of this reseller will use IP addresses
from the IP pool assigned.
Assigning an IP pool to a Hardware Node means that IP addresses from the IP pool
assigned will be allocated to VPSs hosted on this Hardware Node only.This is extremely
useful if you have different network segments in your infrastructure. In this case, you can
assign particular IP pools to corresponding Hardware Nodes in segment. In case VPSs will
be migrated from one Hardware Node to another, IP addresses will be reassigned
automatically.


Establishing Connection with Hardware
To establish connection with servers (in terms of HSPcomplete, Nodes) that host Virtuozzo
VPSs and Plesk domains or run the third-party software, it is necessary to register them in
HSPcomplete.

In your Data Center you can register Nodes that run:
Virtuozzo. Either used for VPS hosting provisioning or dedicated Hardware Nodes owned
by your customers or resellers.
Plesk. Either used for Plesk domains provisioning or dedicated Plesk servers owned by your
customers or resellers.
SiteBuilder. Used for SiteBuilder services provisioning in the frame of hosting plans you
sell.
Dedicated servers that run the third-party software. These servers cannot be managed on the
system level from the Provider Control Center web-based interface. However, in this case,
the HSPcomplete will take care of all the billing matters including creation of dedicated
subscription, charging a customer, issuing the renewal order, sending notifications, etc.
Hardware Nodes can be registered and managed using the Service Director. Select the needed
manager from the Service Director submenu and register a node.

Note: To establish connection with Nodes you need some specific data. In case of problems or
doubts, please contact your network administrator and/or the person who performed Hardware
Nodes installation to make sure that the data necessary for Hardware Nodes registration is full
and correct.


Setting Up DNS
HSPcomplete allows establishing connection with more than 25 Internet Registrars (eNom,
OpenSRS, BulkRegister, MelbourneIT, etc.) via the built-in domain plug-ins (available
connections for obtaining top level domains like .com, .net, .org, etc.).

For the fresh installation, you can use the so-called Dummy domain-registration plug-in.The
Dummy domain plug-in is designed to facilitate manual domain registration process and/or
domain registration procedures testing. You can set up the Dummy domain registration plug-in
to be responsible for particular top level domains (TLDs) which require manual registration, so
that your customers will order such domains and you then will register these domains manually
and after this mark these domains as "registered" in the HSPcomplete.

To configure domain registration plug-ins, please register your reseller account with
corresponding Registrars and obtain all the necessary pre-requisites. After this, you can go to
the Service Director - Domain Manager - Plug-Ins and configure domain plug-ins.

After you configure plug-ins, you can select which registrars will be used for domains
registration in particular top-level domains. To this effect, go to the Service Director - Domain
Manager - TLDs, select a top level domain and assign a Registrar.

It is possible to install and configure name servers directly from the Provider Control Center
web-based interface. You can specify the name server sets for domains registration (both for
domains registered for VPSs and for domain-only hosting). For domains registered in the frame
of VPS or Plesk subscriptions, the default name servers set can be selected in the Service
Director - Domain Manager - Name Servers. For domains registered in the frame of domain-only
subscriptions, the name servers set can be defined per Domain-Registration Hosting Plan.

To register a domain manually, from the Provider Control Center select Service Director -
Domain Manager - Domains and click the New Domain button.

You can assign both the default domain and the domain used for trial subscriptions (for
customers to create subdomains). To this effect, register a domain for your Provider account and
then click on a domain name and edit a domain policy settings.

Advanced domain settings (name servers management, whois servers assignment, etc.) are
described in details in the HSPcomplete Provider's Guide.


Setting Up the Billing
The HSPcomplete provides the powerful and flexible billing system that allows:
System-wide currency in the Configuration Director - Miscellaneous Settings - Regional
Settings.
Re-defining the starting numerical identifiers (IDs) for accounts, financial documents
(orders, invoices, payments, and adjustments), statements, subscriptions, and Virtual Private
Servers (VPSs) in the Configuration Director - Miscellaneous Settings - Objects Start ID.
Default prices for sellable resources in the Billing Director - Product Manager - Default Prices.
Setting default prices is important for correct recalculations in case of hosting plans
upgrade.
Different discount categories (to be assigned to customer accounts) and partner levels (to be
assigned to resellers) in the Billing Director - Discount Manager.
Different credit terms that can be assigned per account and define the order of settlements in
the Account Director - Subscription Manager.
Flexible taxation with ability to use the EU Tax Exemption Code in the Billing Director -
Taxation Manager.
Ability to automatically apply unused customer payments. This setting can be allowed as a
system-wide one in the Commerce Director - Payment Processing - General Configuration
and later enabled or disabled for each particular offline payment.
More than 40 credit card payment plug-ins in Commerce Director 0 Online Payments.
Bank accounts management and batch processing in Commerce Manager - Bank Transfers.
Two bank plug-ins used for batches generation for the German (DTAUS) and Spanish
(Norma 19) batch format.
Configuring and enabling the fraud screening filters in the Commerce Director - Anti-Fraud
Manager.
Configuring the recurring billing in the Commerce Director - Payment Processing and
Commerce Director - Online Payments - Setup with the fine-grained transactions approval
tools.


Getting Ready to Sell Hosting
Services
Using HSPcomplete you can sell hosting services grouped by templates called hosting plans. A
hosting plan defines the set of included and additional paid services provided, and subscription
fees. Usually hosting plan upgrades are allowed. In this case, a hosting plan also carries the
information about services available for upgrade (for example, additional IP addresses, new
domains, etc.), prices for each additional unit, and the upgrade ceiling (maximal allowed
number of units to upgrade).

When you create a hosting plan, you select one or more subscription periods that are offered to a
customer for this hosting plan. Subscription periods are pre-defined:
one month
a quarter
half a year
one year
two years
When a customer subscribes for a hosting plan and pays the corresponding order, services
provisioning starts automatically in accordance with hosting plan template and subscription
period selected by a customer.

As services provisioning starts the special record called subscription is added to the
HSPcomplete database. When the subscription period is about to expire, the renewal order can
be issued. To facilitate renewing of subscriptions and avoid undesired services termination the
flexible (both automated and manual) subscription renewing mechanism is provided in
HSPcomplete. Please, refer to the HSPcomplete Provider's guide for more details.


Basic Notions Used in HSPcomplete Billing
HSPcomplete billing system is supported by the Billing Director that provides financial
management of the following customer’s categories: Resellers and Customers. For settlement
purposes, Accounts are created for each customer category. HSPcomplete billing provides a
single-currency settlement and accounting system. A system-wide currency can be selected per
Control Center (one currency for Provider and another currencies for Resellers, the exchange
rate can be set per Reseller). In order to change the system-wide currency, select Configuration
Director - Regional Settings.

Hosting Plan is the basic account unit that used for calculation of money equivalent of services
provided. A subscription period can be selected by customers from offered by Hosting Service
Provider (one month, three months, six months, and year). Services provided in accordance with
a Hosting Plan are paid in advance, in accordance with resource-specific quotes. Resources
overusage is paid either in advance or at the end of subscription period.

Note: In HSPcomplete billing, the billing cycle equals to one month by default. This means that
statements and resource overusage invoices are generated for each subscription each month.
There are no mentions about billing cycles in HSPcomplete web-based interface.

Invoices are being generated in accordance with Subscription terms. Account balance is
calculated on the basis of actual resource usage and payment(s) received. Account balance is
calculated every hour (by default).

Current Account balance is regularly compared with customer credit limit. Depending on
Billing Manager settings and Account balance, the following operations can be performed:
Notification about negative Account balance can be generated and sent to a customer;
Negative balance and credit limit control, generating reports on Accounts in debt;
Suspending subscriptions associated with Accounts in debt in the case of credit limit
overrun;
For Virtuozzo VPS subscriptions, changing a VPS parameters (available resources
limitation) in the case of resource overusage.
Basic Notions

Subscriptions

A Subscription holds terms of contract between Hosting Service Provider and a customer.
Changes in Provider prices do not affect terms of Subscription. This means that prices for the
Hosting Plan purchased remain changeless up to the end of subscription period.

However, if additional Applications or VPSs were purchased, or a Subscription was upgraded to
a higher version of the same hosting plan, then Subscription terms may change.

Documents

In respect to the HSPcomplete Billing Director, this notion means all financial documents that
exist within the system. The documents may be created by a customer or may be generated
automatically. The following documents’ types exist:


Orders - the documents that include information about Hosting Plans or additional services
ordered by customers. Orders are generated automatically, after a subscriber orders one or
another service;
Payments - off-line and online payments for hosting services. An Order can be paid by
several payments;
Invoices - invoices are generated automatically after placing Orders or can be added
manually. Invoices can be paid by parts;
Credit Invoices - documents that add a certain amount to an account balance and include the
itemization of services or other goods refunded or paid to an account owner.
Adjustments - adjustments are used for Accounts’ balance adjustment. For example, Credit
Adjustment is applied if a customer was overcharged (to increase the Account balance), and
Debit Adjustment is applied if a customer ordered additional services (increase the billed
sum and decrease Account balance).
Payment Requests - financial documents generated after a customer requests an arbitrary
payment to increase his/her account balance.
Each financial document has its total sum and a balance, which allows both applying several
payments to one Invoice, and applying single payment to several Invoices.

Balance

Your hosting company balance is the sum of all your customers and resellers account balances.
A customer or a reseller account balance is calculated as a total sum of all payments and credit
adjustments with a total amount of Invoices, Orders, and Debit Adjustments deducted.

Positive account balance means that an account owner has a certain overpayment, so Provider
owes money to a customer. Negative account balance means that a customer or a reseller owes
money to Provider. Zero account balance means that neither Provider, nor a customer do not
owe money to each other.

Your hosting company balance does not reflect your earnings. It just shows whether your
customers owe money to you or you owe money to your customers.

Reports

Billing Manager reports (Collected Cash, Revenue Report, Aged Account/Receivable, etc.).

Notifications

E-mail notifications generated automatically in connection with certain events within
HSPcomplete system.


Creating Hosting Plans
When HSP creates hosting plans, they can make a hosting plan available for Resellers. In this
case, Resellers can copy such hosting plans and set own prices. In addition, Resellers can create
own hosting plans.

The types of services you are going to provide (Virtuozzo VPS, Plesk domain, miscellaneous,
etc.), can be agreed with your vendor. Hosting services types can be added by installing the
relevant update obtained from the vendor.

The set of hosting plan types is read-only in respect to its composition, but HSP can rename the
hosting type in a way that, for example, seems more descriptive. To rename or view the hosting
plan types available, go to the Billing Director - Product Manager - Setup - Hosting Plan Types
tab. Then select the type and edit its name.

Note: It is possible to create the trial-only hosting plans (for the types of hosting the trial period
is allowed for).

You can optionally group hosting plans into Hosting Plan Categories.Hosting Plan Categories
are the groups of Hosting Plans of one or the same purpose (for example, Shared Webhosting,
Corporate Hosting and Mail, etc.). For the initial HSPcomplete configuration you can create
several Hosting Plans Categories and in future group actual Hosting Plans by these
categories.To create Hosting Plan Categories (or, add a new one), go to the Billing Director -
Product Manager - Setup.

Hosting plans creation in HSPcomplete is rather simple: select the hosting type and follow the
corresponding wizard.

To create a hosting plan, go to the Billing Director -Product Manager - Hosting Plans and click the
New Hosting Plan button. Select a hosting plan type and follow the wizard. For more details on
hosting plans creation. please refer to the HSPcomplete Provider's guide.


Configuring Online Store
The built-in online store is part of the HSPcomplete website management tool. On one hand, the
store is one of the built-in pages of your website in respect to some common things like site
logotype and footer shown on every page of your website. You can upload logo and footer using
the Marketing Director - Site Manager - Settings. On the other hand, the store is part of the
HSPcomplete e-commerce application - the Commerce Manager. That is because all the store-
specific settings are up to the Commerce Manager. And the store page does not exist in the list
of pre-defined site page templates available in the Site Manager.

So, after you upload your logotype and website footer using the Site Manager, you can go into
the online store configuration using the Commerce Director - Store Manager.

Below we describe the most general store configuration. The full description of online store
features and advanced store configuration is described in the HSPcomplete Provider's guide.

Entering User Agreement and other Texts

To enter the User agreement and both the header and footer of offline payment systems
description go to the Commerce Director - Store Manager- Configure Store and select the Texts
tab.

To enter the banners for available offline payment systems, go to the Payment Systems tab.

Description of online payment systems are entered per payment plug-in, in the Commerce
Manager - Online Payments or Bank Transfers.

Publishing Hosting Plans

After you create Hosting Plans, you can configure the Hosting Plans presentation at your
HSPstore (listing, description, comparison options, etc.).

How the Hosting Plan Listing is organized? When your customers visit your HSPstore the first
thing they can see is the Hosting Plans price list. The most general information about each
Hosting Plan can be shown here: the price (or the pro-rated price), the short description, etc. In
addition, your customers can select several Hosting Plans (of the single type) and compare
them. When your customer selects one of the Hosting Plans, on the next step he (or she) selects
the subscription period. In this case, you can show the full description of the selected Hosting
Plan. Summarizing, you can adjust the Hosting Plans price list appearance, Hosting Plans'
details to compare, and the Hosting Plan description to be shown during subscription period
selection.

You can configure the special listing for each of the hosting plan types.

To configure the hosting plans price list, go to the Commerce Director - Store Manager-
Configure Store and select the Plan LIsting tab. Click Edit next to the desired hosting type and
configure listing.

To publish a hosting plan in the store, go to the Billing Director - Product Manager - Hosting
Plans, select the hosting plan then click the General Settings tab:
Check the Active box.


In the section of the form entitled Who can Sell Services based on this Hosting Plan, check
the Provider box.

Securing HSPcomplete Tools Using SSL
Secure Sockets Layer (SSL) provides a level of security and privacy for those wishing to
conduct secure transactions over the Internet.

SSL provides visitors of your website with the confidence to communicate securely via an
encrypted session. For companies wishing to conduct secure e-commerce, such as receiving
credit card numbers or other sensitive information online, SSL is essential.

For SSL to work a valid signed SSL certificate is required.

Using the HSPcomplete tools, you can generate a self-signed certificate and use it for some time
until the certificate “signed” by a trusted external authority: VeriSign (http://www.verisign.com)
or Thawte (http://www.thawte.com) will be ready. After this you can install the signed
certificate again via the Provider Control Center.

To obtain the SSL certificate:
1 Generate Certificate Request in the - Configuration Director - Miscellaneous Settings - SSL
Setup - and select the Certificate Request tab.
2 After the Certificate request is generated, you can do one of the following:
Copy the Certificate Request and send it to the Certificate Authority to obtain the signed
Certificate and import it later;
Generate self-signed Certificate and use it for some time.
3 Restart Apache on your Management Node. Please note that in this case your Management
Node will be not available for some time. So if you already have customers by the moment
of importing the SSL Certificate, your customer's VPSs will also become offline till Apache
on your Management Node restarts.
Please refer to the HSPcomplete Provider's guide for more details on managing SSL.

41

CHAPTER 3

Going Live
After you have got ready to accept online payments and configured the hosting plans price list,
you can select the active online payment systems and open your store. As you go live, you can
also publish the online partner application form to invite resellers.

Selecting Payment Systems Used in Store

The number of payment methods you can use in your online store is limited only by the number
of plug-ins you configure.

To enable one or another payment method do the following:
1 Open the Commerce Director submenu.
2 Select the plug-in:
To activate a credit card plug-in, click Payment Plugins on the Online Payments submenu.
Select a plug-in you want to activate.
To activate a bank account plug-in, click Payment Plugins on the Bank Transfers submenu.
Select a plug-in you want to activate.
1 After the properties of the selected payment plug-in will be displayed, click the Mark as
Active button.

Going Live 42

To select the online payment system:
Go to the Business Director - Billing Manager - Setup - Plugins, select a payment plug-in and
set it as active.
Go to the Business Director - Commerce Manager - Configure Store, select the General
Settings tab and check the Online Payments Allowed box.
Offline payments:

To select the offline payments to offer in the store, go to the Commerce Director - Store Manager
- Configure Store, select the General Settings tab and check the boxes next to the offline
payments types to show the payment type on the Payment page of the store.

Enabling SSL for HSPcomplete

You can enable the SSL protocol separately for the Provider Control Center, Reseller Control
Canter, Enterprise Control Center, Control Panels, website, and your online store.

Please, enable SSL for your online store before going live.

To enable the SSL protocol, go to the Configuration Director - Miscellaneous Settings - SSL
Setup. Select the the Enable SSL tab. You can enable the SSL protocol by checking the Enable
SSL in HSPcomplete Web Tools boxes next to the name(s) of the web tools (Control Centers,
Control Panels, store, etc.).

Opening Online Store

To make your store available over the Web, go to the Commerce Director - Store Manager -
Configure Store, select the General Settings tab. Click the Edit button and check the Store Is
Open box. Save settings.

Inviting Resellers

Resellers are companies that resell HSP services and in general, act as HSP Companies
themselves. However, a Reseller does not have own Data Center and hardware that runs
HSPcomplete software. Resellers get access to the special set of HSPcomplete tools (Reseller
Control Center) and provide services using Internet connection with HSP Management Node.

To enter the Reseller Agreement, to be read by all Resellers before submitting Partner
Application, go to the Account Director - Reseller Manager - Terms and Conditions.

If you want to receive Partner Applications from prospect Resellers online, add the Partners
page to your website. There is a pre-configured template for the Partners page in the Marketing
Director - Site Manager - Pages. Do not forget to set the Partners page as "Active" so that the
link will be shown on your website.

43

CHAPTER 4

What's Next?
After your store is opened and hosting plans are published, you can proceed to the normal
course of work: making money using the HSPcomplete hosting automation solution.

In This Chapter
Managing Receivables .......................................................................................................... 43
Supervising the Cash Flow.................................................................................................... 44
Monitoring the Data Center Resources Usage ...................................................................... 46
Checking the Licenses Usage................................................................................................ 47
Daily Activities ..................................................................................................................... 47

Managing Receivables
To view receivables, go to the Billing Director - Receivable - Documents. At your convenience,
documents are grouped into separate lists, by types:
Orders - the documents that include information about Hosting Plans or additional services
ordered by customers. Orders are generated automatically, either when a subscription
renewal is needed (for automated renewal the special settings can be made to a subscription)
or after a customer places order in online store or in the Control Panel Upgrade Center.
Invoices - invoices are generated automatically after paying the corresponding Orders, or
manually. Manual creation of invoices is possible in two cases:
When a Provider creates an Abstract Invoice that is not bound to any order, for example
to charge a customer for some additional services.
When a Provider creates a so-called Credit Invoice that allows increasing a customer
account balance by refunding a customer previous payments with explicit specification
of services that were refunded or discounted. Credit invoices work in the same way as
credit adjustments, but are accounted in billing reports and have the same numeration
(IDs) as all the other invoices.

What's Next? 44

Payments - off-line and online payments for hosting services. An Order can be paid by
several payments;
Adjustments - adjustments are used for Accounts’ balance adjustment. For example, Credit
Adjustment is applied if a customer was overcharged (to increase the Account balance), and
Debit Adjustment is applied if a customer ordered additional services (increase the billed
sum and decrease Account balance).
Payment Requests - requests from customers that want to put some amount on their account
balance, without respect to existence of any unpaid documents. Payment Requests allow
customers to enter a credit card or a bank account payment that can be used in future. For a
payment to be added, a Payment Request must be manually approved by Provider. Having
been approved, a credit card payment request originates a new online payment and a bank
account payment request originates an offline payment.
Orders and Invoices can be paid both offline and online, both manually from the Provider
Control Center and by a customer (by a credit card or a bank account) from the Control Panel.

The documents intended to be paid by credit cards or bank accounts call for specific processing
and thus, they are not only enlisted in the list of all receivables, but also grouped separately,
under the Commerce Director -Online Payments or Bank Transfers.

Supervising the Cash Flow
Your hosting company balance is the sum of all your customers and resellers account balances.
A customer or a reseller account balance is calculated as a total sum of all payments and credit
adjustments with a total amount of Invoices, Orders, and Debit Adjustments deducted.

Positive account balance means that an account owner has a certain overpayment, so Provider
owes money to a customer. Negative account balance means that a customer or a reseller owes
money to Provider. Zero account balance means that neither Provider, nor a customer do not
owe money to each other.

To view the total balance, select Receivable from the Billing Director submenu and then click
Balance on the Receivable submenu.

The balance information is grouped under the three tabs:
Total Receivable shows the following:
Total Balance. The sum of all your customers and resellers account balances
Accounts total balance. The sum of all customer accounts balances.
Resellers total balance. The sum of all reseller accounts balances

What's Next? 45

Balance per Account. All customer accounts listing with balance shown for each account.
Balance per Reseller. All reseller accounts listing with balance shown for each account.
When you are browsing an account profile, you can view balance under the Financial Info tab.
You can adjust accounts balance by entering credit adjustments or credit invoices (increase) or
debit adjustments (decrease).

Your hosting company balance does not reflect your earnings. It just shows whether your
customers owe money to you or you owe money to your customers. Your actual revenue is
shown in Billing Reports under Billing Director - Report Manager.

You can view the detailed revenue reports grouped by your customers accounts. These reports
enlist invoices issued for particular day, week, month, or year:
The Revenue report provides all the revenue information.
The Collected Amount report provides information about the amount collected.
The Aging Account/Receivable report groups all the invoices issued for your customers'
accounts and sorts these invoices by their age (both non-overdue and overdue).
All reports can be presented in two ways:
Paginated view (web layout; 20, 40, or 80 records per page) and
Single page view (text layout, all records are listed on a single page in the printer-friendly
form).

What's Next? 46

Monitoring the Data Center
Resources Usage
The Service Level Manager provides a mechanism for checking the current resource utilization
throughout Virtual Private Servers and Hardware Nodes. Using the Service Director - Service
Level Manager, you can:
View the both the current resources consumption and the resources usage history for every
VPS or every Hardware Node. Go to the Service Director - Service Level Manager. Select
Virtuozzo VPS or Hardware Nodes. For every VPS or Hardware Node you an view the
current resources usage (the Current Values tab) or resource usage history (Statistics tab).
This feature is very useful if, for example your customer believes that some resource was
under-delivered. In this case you can settle a customer's doubts by checking the total
resource usage during a particular period and daily or hourly consumption for a given period
of time.
View traffic usage statistics for third-party dedicated servers.
Set the thresholds in percents for disk space and traffic that when exceeded are reported into
the list of VPSs that are approaching limits. To this effect, go to the Service Level Manager -
Setup. To view the list of VPSs that have exceeded the threshold percentage of promised
disk space and traffic, select VPS approaching limit.

Note: When traffic or disk space usage for a VPS approaches the limits set in the Service Level
Manager, the corresponding event is registered by the HSPcomplete Event Manager (namely,
Traffic is nearly used up and Disk space is nearly used up, to find these events, filter the list by
the Subscription object type). Thus, you can attach an action to such events, for example, e-mail
notification or SMS message to your staff member.

Finally, you can configure traffic accounting by classes in the Service Director - Service Level
Manager - Traffic Classes.

What's Next? 47

Checking the Licenses Usage
The HSPcomplete License defines the overall number of accounts (Reseller and Customer ones)
a Provider can create.

If the Licence capacity is used up, this can result in impossibility for Provider to create a new
account. Thus, it is important to check the HSPcomplete License capacity and if needed order
and install new License Certificates.

License certificate is issued by SWsoft. It can be installed via HSPcomplete web-based interface
using the Configuration Director - License Manager.

You can check the current usage and unused capacity of HSPcomplete License in the
Configuration Director - License Manager - HSPcomplete License.

If you are planning to sell Plesk domains in your HSPstore, please install the Plesk licences on
each of Plesk Hardware Nodes. And to register Plesk Hardware Node in HSPcomplete you need
to install the special agent software (Plesk agent) on each of Plesk nodes. The Plesk agent needs
to establish connection between HSPcomplete Management Node and Plesk Hardware Node.

Please, refer to the HSPcomplete Provider's Guide for detailed instructions on how to order and
install License certificates.

Note: If you are installing HSPcomplete inside Virtuozzo VPS, you will need to install
Virtuozzo License on Hardware Node that hosts this VPS using the command line control tools.

Daily Activities
HSPcomplete facilitates and automates many day-to-day tasks in Hosting Service Provider
company. Please refer to the HSPcomplete Provider's guide for detailed description of tasks
outlined below.

Billing:
Flexible Subscription Renewal settings. You can:
Enable the automated generation of a renewal order. In this case, the renewal order will
be generated before the subscription expiration date, in accordance with the renewal
order period defined in the credit terms and for the subscription period defined by you in
the subscription renewal settings. Go to the Account Director - Subscription Manager -
Subscriptions. Select a subscription and click the Renewal Settings button. Check the
Create renewal order automatically box.
Generate the renewal order manually. In this case, you also can generate the renewal
order for the custom subscription period. To create renewal order for the same period as
it was before, go to the Account Director - Subscription Manager - Subscriptions.. Select
a subscription and click the Generate Renewal Order button.

What's Next? 48

Renewing the delegated domains registration. For domains delegated into HSPcomplete
(domain parking) you can either manually create a separate domain subscription and
after this transfer a domain under your account at Internet Registrar or (for Registrars
that support automated transfer) send the transfer request by filing the simple form in
HSPcomplete.

What's Next? 49

Transaction log includes the detailed data about absolutely all online transactions
(successful or failed) performed within HSPcomplete. To view transaction log, go to the
Commerce Director - Online Payments or Bank Transfers - Transaction Log.
Adding credit cards types to accept. Most payment plug-ins support selection of credit cards
types (including the debit cards like Solo and Switch). Go to the Commerce Director - Online
Payments - Payment Plugins, select a plug-in and edit the credit cards set to be accepted.
Manage affiliate programs, check statistics. Marketing Director provides means for creating
online marketing campaigns that result in visits to your site/store. HSPcomplete will track
the hits as well as orders received as a result of your different campaigns. To add a
marketing campaign, go to the Marketing Director Campaign Manager - Campaigns.
Create and publish promotions.Promotions are discount periods for sale of one or a several
Hosting Plans which are periodically announced by Hosting Service Provider or Reseller.
You can also create promotions being activated by a coupon code. A promotion can give
different discount for different subscription periods. To create a promotion, go to the Billing
Director - Discount Manager - Promotions.
Channel Sales

Check partner applications in the Account Director - Reseller Manager, manage resellers (check
resellers IP Pools allocation in the IP Manager, create hosting plans available for copying by
resellers, check Resellers balance, manage Resellers stores, hide Resellers store URL).

Administration
Service Monitor. Allows tracking in a real time the status of all the services that are critical
for HSPcomplete viability (support database, process orders, etc.) The service monitor
controls the status of these services and if one of them stops, tries to immediately start them
automatically. If the Service Monitor fails to start one of these services, it issues the system
warning visible at any screen of HSPcomplete Control Center, so that the Control Center
administrator could know about the outage and fix it. To view the status of HSPcomplete
vital services in real time, go to the Configuration Director - Up2date Manager - Service
Monitor. Click Check Now.
Up2Date Manager is a useful and simple tool that allows you to check whether your
HSPcomplete version is up-to-date and receive information about the available
HSPcomplete updates and hotfixes.
Messenger. Set the Provider Account contact e-mail addresses and check mail sent by
HSPcomplete messenger.
Create more users allowed to log in to Provider Control Center. You can adjust the access
permissions for roles available for users registered in Provider account (staff members) in
the Configuration Director - Security Manager - Permissions, register users in Provider
account and assign these roles to your staff members.
Manage the users password strength. You can set up the length and other strengthening
features for passwords used to log in to HSPcomplete Control Centers and Control Panels.
The password enhancement also sets the rules for VPS users passwords.The idea is simple:
try to prevent users from choosing passwords that could be guessed by "Crack" by filtering
them out. To set the passwords strength, go to the Configuration Director - Security Manager
- Setup
Customer Care

What's Next? 50

Trouble Ticket System. HSPcomplete provides an integrated trouble ticketing system that
allows reporting and answering customers' problems directly through the interface. To set
up the Trouble Ticket System, please go to the Account Director - Support Manager - Ticket
System Setup.
Manage Events and notifications. HSPcomplete provides an opportunity of tracking
particular events that happen within the system and configure e-mail notifications and other
actions (including scripts execution) in connection with each event. E-mail notifications and
scripts can be configured using Configuration Director - Event Manager - Events.
Mass mailer. Using the Mass Mailer you can send the massive e-mail notifications to your
resellers and customers. If needed, you can re-send the mass mail. To send a mass mail, go
to the Marketing Director - Announcement Manager.

51

APPENDIX A

Getting Technical Support
SWsoft provides installation assistance for HSPcomplete. Assistance with installation is offered
via e-mail. The full information about HSPcomplete support and HSPcomplete documentation
in HTML format is available at our website (http://www.swsoft.com/en/support/hspcomplete/).

An Overview of SWsoft Technical
Support
SWsoft Support will attempt to answer any relevant questions you may have before the
installation process is initiated. This includes the following:
Pre-requisites list;
Hardware compatibility;
Software compatibility.

Questions for Technical Support
In most cases, support team must rely on customer observations and communications with the
customer in order to diagnose and solve the problem. Therefore, the detailed problem report is
extremely important. Please, do mention the following:
Symptoms of the problem;
When the problem began including the circumstances of the failure;
Any changes you made to your system;
Other information that may be relevant to your situation, such as the installation method;
Specific hardware devices that may be relevant to your problem.

How to Send Support Questions
Please, send your questions to support team by e-mail: hsvz-support@swsoft.com.

If you need to contact us - just call us or visit one of our offices. Information about phone
numbers, contact persons and office addresses is available on the contact page at
http://www.swsoft.com/en/contact/.

52

Index

A I
About This Guide • 6 Inspecting Customer Control Panel • 24
Allocating IP Addresses • 32
An Overview of SWsoft Technical Support •
L
52 Looking into Reseller Control Center • 22
Audience • 6
M
B
Making Initial Settings • 16
Basic Notions Used in HSPcomplete Billing • Managing Receivables • 44
37 Meet the HSPcomplete • 7
Browsers Compatible with HSPcomplete • 13 Monitoring the Data Center Resources Usage •
47
C
Checking the Licenses Usage • 48
P
Configuring Data Center and Connecting Preface • 6
Hardware • 31
Configuring Online Store • 40 Q
Connecting to HSPcomplete Browser-Based Questions for Technical Support • 52
Tools • 15
Creating Hosting Plans • 39 S
Securing HSPcomplete Tools Using SSL • 41
D
Setting Up DNS • 34
Daily Activities • 48 Setting Up the Billing • 35
Starting HSP Business with HSPcomplete • 14
E
Supervising the Cash Flow • 45
Establishing Connection with Hardware • 33
T
F
Typographical Conventions • 6
Feedback • 7
W
G
What's Next? • 44
Getting Acquainted with Provider Control
Center • 18
Getting Ready to Sell Hosting Services • 36
Getting Technical Support • 52
Going Live • 42
H
How to Register Users and Set Access
Permissions • 27
How to Send Support Questions • 52
HSPcomplete Advantages • 8
HSPcomplete Deployment Scenario • 10
HSPcomplete Interfrace Features • 10
HSPcomplete Tools • 12

Getting Started Guide

More Related Content

What's hot (20)

Viewers also liked (7)

Similar to Getting Started Guide (20)

More from webhostingguy (20)

Getting Started Guide