|
|
|
 |
|
| |
| Installation |
Welcome to The Host Manager installation guide. After purchase you will be given a link to download the software. You may also download the newest version of the software at any time by logging in through the customer login page (using the password sent to you during purchase). In these instructions, www.example.com will refer to your domain name.
The Host Manager is provided as an electronic download with the filename thehostmanager.zip. Unzip the file using a program such as WinZip on Windows or a command line decompressor on Linux. Upload all of the files to your web server.
For security most files in The Host Manager are encrypted for protection. You will need to download a "loader" to decrypt the files. This encryption also optimizes the files so that they run faster than would regular files. Visit http://www.ioncube.com/loaders.php and download the Loaders that correspond to your OS and PHP version.
IF YOU HAVE ACCESS TO PHP.INI (RECOMMENDED FOR PERFORMANCE):
Upload ioncube-loader-helper.php onto your web server and execute it through a web browser.
Click on php.ini installation instructions.
Follow the instructions.
Delete ioncube-loader-helper.php.
IF YOU DO NOT HAVE ACCESS TO PHP.INI:
Upload ioncube-loader-helper.php onto your web server and execute it through a web browser. Click on run-time loading installation instructions.
Note the loader file it is looking for, and upload it to /hosting/ioncube/ directory (you will have to create the ioncube directory).
Delete ioncube-loader-helper.php.
Using the MySQL command line, phpMyAdmin, Plesk, or your MySQL administration tool, create a database for The Host Manager. Then using a text editor (such as Notepad or Vi), open config.php. Edit the variables to look like this, using your connection settings:
$db_username = "joe123"; // Enter your database username here
$db_password = "j123456"; // Enter your database password here
$db_name = "thehostmanager"; // Enter the database name here
$db_host = "localhost"; // Enter database host here (most likely localhost)
Save the file and upload it to your web server. Then load install.php through a web browser (ie www.example.com/hosting/install.php) and follow the wizard to install The Host Manager.
Lastly, you will need to configure your server to tell autorun.php to be run daily. You can do this through Plesk by selecting Crontab from the Server menu. An example Chrontab entry to run autorun.php daily would be:
Min: 30
H: 2
DM: *
M: *
DW: *
Command: /usr/local/psa/admin/bin/php /var/www/vhosts/example.com/httpdocs/hosting/autorun.php |
| |
|
| |
| Configuration |
After installation you need to customize The Host Manager software for your business. Log in to the admin panel at www.example.com/hosting/admin. The username is admin, and the default password is admin. You should change the password as soon as installation is finished.
Settings
Edit the basic such as company name, email, location of site, currency, tax, etc. If you use a currency not listed on this page, see the FAQ on how to configure it.
Payment Processors
Set whether or not to use PayPal, select a credit card processor (if applicable), or put payment into test mode. Each payment processor requires different information to be entered in the Extra 1 and Extra 2 boxes - simply select a payment processor and relevant information will appear beside the boxes. You can also enable credit card storage. This will give customers an option to save their credit card details, and enable auto-renew (if you choose a supported payment processor [marked with (On-site*)]). The credit card key box is used to help encrypt credit card information for storage in the database. You should change this at least once per month, or as instructed by your processing company.
Renewals
Set option as to when to send customers renewal emails, deactivate their hosting, and delete their hosting. Text for renewal emails can be edited via the text.php file (located in the admin directory).
License Management
Enter your license key here and click update. It lists the license status, any limits, the current number of domains, and the license expiry (if applicable).
Coupons
Add, edit, and delete coupons for your users. You can override coupons and disable them by editing the $couponenable variable in text.php.
Servers
The Host Manager supports an unlimited number of servers. Add each server you will use for hosting here (include the same server running the software if you are using it). Notes:
Total MB should be about 75% of the space available on the server. This is to accommodate for possible hosting plan upgrades.
The API address most likely looks like this: https://12.12.12.12:8443/enterprise/control/agent.php
Priority tells the software which servers to use first. Setting them all to 0 uses load balancing. -1 is disabled. Otherwise, the servers are used in order (starting at 1) until they have met the domain or MB limit.
Maximum domains can be used to set the maximum number of hosting plans on the server. This is helpful if you have Plesk license restrictions. Set to -1 for unlimited.
Plesk Client ID identifies under which client the accounts are created. To find the client ID put your mouse over the link to the client from the Client page. In the status bar of your browser you will see the link location, with the last digit(s) being the client ID. For example, cl_id=2 would be client ID 2. Feel free to contact support if you need any help locating this.
After installation you need to customize The Host Manager software for your business. Log in to the admin panel at www.example.com/hosting/admin. The username is admin, and the default password is admin. You should change the password as soon as installation is finished.
Settings
Edit the basic such as company name, email, location of site, currency, tax, etc. If you use a currency not listed on this page, see the FAQ on how to configure it.
Payment Processors
Set whether or not to use PayPal, select a credit card processor (if applicable), or put payment into test mode. Each payment processor requires different information to be entered in the Extra 1 and Extra 2 boxes - simply select a payment processor and relevant information will appear beside the boxes. You can also enable credit card storage. This will give customers an option to save their credit card details, and enable auto-renew (if you choose a supported payment processor [marked with (On-site*)]). The credit card key box is used to help encrypt credit card information for storage in the database. You should change this at least once per month, or as instructed by your processing company.
Renewals
Set option as to when to send customers renewal emails, deactivate their hosting, and delete their hosting. Text for renewal emails can be edited via the text.php file (located in the admin directory).
License Management
Enter your license key here and click update. It lists the license status, any limits, the current number of domains, and the license expiry (if applicable).
Coupons
Add, edit, and delete coupons for your users. You can override coupons and disable them by editing the $couponenable variable in text.php.
Servers
The Host Manager supports an unlimited number of servers. Add each server you will use for hosting here (include the same server running the software if you are using it). Notes:
Total MB should be about 75% of the space available on the server. This is to accommodate for possible hosting plan upgrades.
The API address most likely looks like this: https://12.12.12.12:8443/enterprise/control/agent.php
Priority tells the software which servers to use first. Setting them all to 0 uses load balancing. -1 is disabled. Otherwise, the servers are used in order (starting at 1) until they have met the domain or MB limit.
Maximum domains can be used to set the maximum number of hosting plans on the server. This is helpful if you have Plesk license restrictions. Set to -1 for unlimited.
Plesk Client ID identifies under which client the accounts are created. To find the client ID put your mouse over the link to the client from the Client page. In the status bar of your browser you will see the link location, with the last digit(s) being the client ID. For example, cl_id=2 would be client ID 2. Feel free to contact support if you need any help locating this.
Hosting Plans
The Host Manager supports unlimited plans. Each plan can be configured with a unique set of options, as well as monthly price, yearly price, and prices for extras. "Extras" are unique to The Host Manager in that you can allow customers to buy databases and email address in excess of plan limits for a specified price, without the need for them to upgrade their whole plan. Set the cost for the extras to 0.00 to disable them. Please note that the Apache ASP support is not supported for versions lower than Plesk 7.5.4.
Client Listing
Get a list of all your clients and domains. By clicking on a user, you can edit contact information, domains, databases, and email addresses. This page also allows you to download a backup of the whole The Host Manager database. You can disable this by setting $enablebackup to 0 in text.php if needed (ie you have employees who will be using the admin, but you don't want them to be able to download the database containing your Plesk password).
Order Records
A list of all the orders placed through The Host Manager, including auto-renewals. You can click on the order number to display details, or the username to bring up information about that client.
Send Newsletter
Send out a newsletter to all of your clients, or just to the ones subscribed to the mailing list. Both text and HTML formats are supported.
The Host Manager supports unlimited plans. Each plan can be configured with a unique set of options, as well as monthly price, yearly price, and prices for extras. "Extras" are unique to The Host Manager in that you can allow customers to buy databases and email address in excess of plan limits for a specified price, without the need for them to upgrade their whole plan. Set the cost for the extras to 0.00 to disable them. Please note that the Apache ASP support is not supported for versions lower than Plesk 7.5.4.
Client Listing
Get a list of all your clients and domains. By clicking on a user, you can edit contact information, domains, databases, and email addresses. This page also allows you to download a backup of the whole The Host Manager database. You can disable this by setting $enablebackup to 0 in text.php if needed (ie you have employees who will be using the admin, but you don't want them to be able to download the database containing your Plesk password).
Order Records
A list of all the orders placed through The Host Manager, including auto-renewals. You can click on the order number to display details, or the username to bring up information about that client.
Send Newsletter
Send out a newsletter to all of your clients, or just to the ones subscribed to the mailing list. Both text and HTML formats are supported. |
| |
|
| |
Note on using alternate payment processors (other than the included supported processors).
If you are integrating using an API, see the file otheronsite.php in the payreturn directory. Otherwise, see the files othersend.php and otherreturn.php in the payreturn directory.
Footnote: If you would like to display domain status information on the main account.php page to customers, set $statusenabled to 1 in text.php. Note that this will increase the load time of the page by a few seconds.
Footnote: If using PayPal, disable echecks, as these are not guaranteed to clear (alternatively, you could manually add/renew hosting when payment clears). Your PayPal account must have the IPN enabled and set to http://www.yourdomain.com/hosting/payreturn/paypalreturn.php |
| |
|
|
|
|
