Difference between revisions of "Easy Plesk Install"

From AWBS Wiki
Jump to: navigation, search
m (Protected "Easy Plesk Install" [edit=sysop:move=sysop])
(Configure your cron jobs)
Line 157: Line 157:
 
===Configure your cron jobs===
 
===Configure your cron jobs===
 
----
 
----
Coming soon...
+
# From your cPanel home page, click on the cron jobs icon.<br>[[Image:CPanel-CronJobs.png]]
 +
# Enter an email address you will be able to check in the Please enter an email address where the cron output will be sent field.<br>[[Image:CPanel-CronEmail.png]]
 +
# Edit the Minute and Hour fields so that you have scheduled for once per day at a low traffic time on your server. Example: If you enter 0 for Minute and 5 for Hour, this will run the updtransfers.php cron at 5:00 AM each day.
 +
# Enter ''php -f /home/userdir/public_html/tools/updtransfers.php'' in the Command field. (Substitute your cPanel username in place of 'userdir' and do not paste the quotes)<br>[[Image:CPanel-Updtransfers.png]]
 +
# Click the '''Add New Cron Job''' button.
 +
# Configure the ''updateexp.php'' and ''invoice_cron.php'' files also for once per day, but at a different time than the ''updtransfers.php'' cron. You can copy the command field from the original, then just edit the file name ''updtransfers.php'' to ''updateexp.php'' and change the Hour, then save.
 +
# Repeat for ''invoice_cron.php''.<br>NOTE: It is advised to run the ''invoice_cron.php'' after the ''updateexp.php'' and ''updtransfers.php'' files each day.
 +
# Repeat for ''master_cron.php'', however change the Minute field to */10 and the Hour field to *. This will run the ''master_cron.php'' every 10 minutes.<br>[[Image:CPanel-MasterCron.png]]
  
 
Once you are satisfied your crons are functioning properly (after configuring and testing your AWBS install), you can remove your email address to minimize your incoming emails.
 
Once you are satisfied your crons are functioning properly (after configuring and testing your AWBS install), you can remove your email address to minimize your incoming emails.
  
 
Installation is complete, now you can login as super admin and start configuring, customizing and testing.
 
Installation is complete, now you can login as super admin and start configuring, customizing and testing.

Revision as of 00:34, June 24, 2011

Easy Plesk Install

(Note: this page is based on Plesk 10. Icons and links may have different but similar names/icons if you are using a different version of Plesk)

Login to Plesk


Create Database


  1. Click Websites & Domains tab in the top menu:
    Plesk-TopMenu.png
  2. Click the Databases Icon.
    Plesk-Databases.png
  3. Click the Add New Database on the Databases page: PleskAddNewDatabaseIcon.png
  4. Enter the desired database name in the Database Name field, and Type is set to mySQL
    PleskAddNewDatabase.png
  5. Click the Ok button.
  6. On the next page click on the Add New Database User icon.
    Plesk-AddDBUserIcon.png
  7. Enter the Database username you would like to use, as well as a password.
    Plesk-AddDBUser.png
  8. Click the Ok button.
  9. Document your db name, username and password for future reference.

Upload files


  1. Click back to the Websites & Domains tab in the top menu:
    Plesk-TopMenu.png
  2. Click on the File Manager icon.
    Plesk-FileManagerIcon.png
  3. In the directory listing click on the httpdocs link. (This tutorial assumes you are installing in the root of your site.)
    Plesk-httpdocs.png
  4. Click on the Add New File icon:
    Plesk-AddNewFile.png
  5. Make sure the Upload a File option is selected, Then click the Choose File button to browse for and select the AWBS Full install Zip you have downloaded from AWBS.
    Plesk-UploadFile.png
  6. In the Line Breaks option make sure do not modify is selected. Then click the Ok Button.
  7. Once that is completed click the Add New File icon again and choose the license.dat file you got when you purchased AWBS.
  8. In the Line Breaks option make sure do not modify is selected. Then click the Ok Button.
  9. When the uploads are complete, click on the checkbox beside the AWBS full install zip.
    Plesk-AWBSCheckboxFile.png
  10. Then in the top options above the directory listing click the Extract Files link
    Plesk-ExtractFilesIcon.png

File upload is now complete.


Edit dbconfig.php file


  1. From the same File Manager window used in the previous step navigate to the includes folder by clicking on the folder name.
    Plesk-SelectIncludes.png
  2. Scroll down in the listing until you find dbconfig.php. You will most likely need to go ahead a few pages, or use the display all link.
    Click on the edit icon beside the file when you find it:
    Plesk-EditIcon.png
  3. Find and Remove the $needs_edit=1; line:
    Plesk-NeedsEdit.png
  4. Find the Database information lines. This is where you will need the Database Name, Username, and Password as previously noted in the Create Database section.
    Plesk-DBinfoPreedit.png
  5. Edit these lines with your database information:
    Plesk-DBinfoPostedit.png
    (Enter your information between the quotes in each line, overwriting the sample data that is there)
  6. Find the Workdir information line:
    Plesk-WorkdirPreedit.png
  7. Edit this line with your correct path to your files:
    Plesk-WorkdirPostedit.png
    Most Plesk servers paths would be like this:/var/www/vhosts/domain.com/httpdocs Substitute 'domain.com' with your AWBS Domain.
  8. Find the Cookie Domain information line:
    Plesk-CookieDomainPreedit.png
  9. Edit this line with your domain name preceded by a dot:
    Plesk-CookieDomainPostedit.png
  10. In the Save Settings section make sure US-ASCII is selected in the Save in the following encoding: box.
    Plesk-SavingSettings.png
  11. Line break type should be set to do not modify.
  12. Click the Save button.

Run the install script


Open a new browser window. Surf to http://[your_AWBS_domain]/install/install.php (Substitute your domain name for [your_AWBS_domain])
Note: You must have read the AWBS license agreement and agree to abide by the terms to continue with the install.
AWBS-Agreement.png
Once you have read the license agreement, Check the box and click Begin Install

Welcome: (License Check)

The next step is to verify your license. You should see something like the following:

AWBS-LicenseStatus.png

Once the license has been verified click the box at the bottom of the page labelled Continue With Install

Note: Error 5 indicates the license.dat file is missing. Be sure you have uploaded the license.dat file to the same directory that you uploaded the AWBS files.
Error 3 indicates your server cannot reach our license database via port 80. Ensure your server has internet access via port 80.

Step 1:

The next step is to check your php.ini configuration settings and make sure everything is ready to go. You should see something like the following:
AWBS-SystemChecks.png
Once the above information has been tested, click the box at the bottom of the page labelled Continue to step 2

Step 2:

The next step is to check your database settings and make sure everything is ready to go. You should see something like the following:
AWBS-DBCheck.png
Once the above information has been tested, click the box at the bottom of the page labelled Continue to step 3

Step 3:

The next step is to check your database structure and make sure the database is ready to go. You should see something like the following:
AWBS-DBStructureCreate.png
Once the above information has been tested, click the box at the bottom of the page labelled Continue to step 4

Step 4:

The next step is to populate the database with your company's information. Fill in the following info and then continue. You will need to fill out the information shown below:
AWBS-CompanyInfo.png
Server Settings

Edit the licensed urls if necessary. Add/Remove the www. as needed/desired, edit http and https as needed, and add any subdirectory information to the url. Do NOT add a trailing slash. If you don't have a secure site, use the same URL in both fields.

Do NOT enter a URL that does not contain your AWBS files! The URL must point to where you have uploaded the files. If you alter the licensed domain name or subdomain, it will not match your license and you will have license errors.
AWBS-ServerSettings.png
Non-Secure URL: examples: http://[your_licensed_domain_name]/directory or http://[your_licensed_domain_name] or http://[your_licensed_subdomain]

Note: The URL above should reflect the URL you surf to to get to your AWBS site.  

If making use of Portal Mode, select that option and enter the URL for your Front End site.

Server Admin

This is where you will establish the 'super admin' account and login. The password can be changed later.

Remember this login!
AWBS-SuperAdminInfo.png
Once you have the above information filled out as needed, click the box at the bottom of the page labelled Continue to step 5

Step 5:

AWBS installation is complete!

At this point, the basic install is complete.

AWBS-Complete.png

Click the box labeled "Finish Install"


Delete the install directory


  1. Click back to the Websites & Domains tab in the top menu:
    Plesk-TopMenu.png
  2. Click on the File Manager icon.
    Plesk-FileManagerIcon.png
  3. In the directory listing click on the httpdocs link. (This tutorial assumes you are installing in the root of your site.)
    Plesk-httpdocs.png
  4. Click on the checkbox beside the install directory name.
    Plesk-InstallFolder.png
  5. In the options at the top of the directory listing click the Remove option.
    Plesk-RemoveIcon.png
  6. On the following screen, check the Confirm removal box.
    Plesk-ConfirmRemoval.png
  7. Click on the Ok button.

Secure the admin, includes and tools directories


  1. Click back to the Websites & Domains tab in the top menu:
    Plesk-TopMenu.png
  2. Click on the Show Advanced Operations link.
    Plesk-AdvancedOptions.png
  3. In the new options box that opens, select the Password-protected Directories link.
    Plesk-PasswordProtect.png
  4. Click on the Add Protected Directory icon. Plesk-AddProtectedDirectoryIcon.png
  5. In the Directory Name box enter /admin for the admin directory.
    Plesk-ProtectedFolderSettings.png
  6. Make sure the Document Root box is checked.
  7. Enter some text as desired in the Title of the Protected area box. (This will display in browser's password mask)
  8. Click the Ok button.
  9. If successful you should see the following:
    Plesk-AdminFolderAddUser.png
  10. Click on the /admin folder link as shown above.
  11. You will then need to click on the Add New User icon.
    Plesk-ProtectedFolderUserAddIcon.png
  12. Enter the desired Username and Password for accessing this folder.
    Plesk-CreateUserForProtectFolder.png
  13. Click the Ok button.

Remember these logins will be needed by all who enter the protected directory. This will include any AWBS users who you give any admin rights to.

Repeat above for the /includes and /tools directories.


Configure your cron jobs


  1. From your cPanel home page, click on the cron jobs icon.
    CPanel-CronJobs.png
  2. Enter an email address you will be able to check in the Please enter an email address where the cron output will be sent field.
    CPanel-CronEmail.png
  3. Edit the Minute and Hour fields so that you have scheduled for once per day at a low traffic time on your server. Example: If you enter 0 for Minute and 5 for Hour, this will run the updtransfers.php cron at 5:00 AM each day.
  4. Enter php -f /home/userdir/public_html/tools/updtransfers.php in the Command field. (Substitute your cPanel username in place of 'userdir' and do not paste the quotes)
    CPanel-Updtransfers.png
  5. Click the Add New Cron Job button.
  6. Configure the updateexp.php and invoice_cron.php files also for once per day, but at a different time than the updtransfers.php cron. You can copy the command field from the original, then just edit the file name updtransfers.php to updateexp.php and change the Hour, then save.
  7. Repeat for invoice_cron.php.
    NOTE: It is advised to run the invoice_cron.php after the updateexp.php and updtransfers.php files each day.
  8. Repeat for master_cron.php, however change the Minute field to */10 and the Hour field to *. This will run the master_cron.php every 10 minutes.
    CPanel-MasterCron.png

Once you are satisfied your crons are functioning properly (after configuring and testing your AWBS install), you can remove your email address to minimize your incoming emails.

Installation is complete, now you can login as super admin and start configuring, customizing and testing.