User Tools

Site Tools


installation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
installation [2014/03/31 16:04]
admin [Installation Guide]
installation [2016/02/01 17:45] (current)
admin [Create Consistent Base URL]
Line 1: Line 1:
 ====== Installation Guide ====== ====== Installation Guide ======
  
-The installation process is a very simple task. There are steps:+The installation process is a very simple task. There are steps:
   - [[installation#​copy_the_files_to_your_server|Copy the files to your server]]   - [[installation#​copy_the_files_to_your_server|Copy the files to your server]]
   - [[installation#​create_your_database_and_database_user_and_password|Create your database and database user and password]]   - [[installation#​create_your_database_and_database_user_and_password|Create your database and database user and password]]
   - [[installation#​point_your_browser_to_your_site_and_follow_the_installation_process|Point your browser to your site and follow the installation process]]   - [[installation#​point_your_browser_to_your_site_and_follow_the_installation_process|Point your browser to your site and follow the installation process]]
 +  - [[installation#​create_consistent_base_url|Create Consistent Base URL]]
   - [[installation#​set_up_the_periodic_maintenance_task|Set up the periodic maintenance task (Cron Jobs)]]   - [[installation#​set_up_the_periodic_maintenance_task|Set up the periodic maintenance task (Cron Jobs)]]
  
Line 10: Line 11:
  
    
- 
- 
  
  
Line 19: Line 18:
 Once you received the package file from us you need to unarchive it. It is compressed with the popular zip format and you need an unarchiving utility like [[http://​www.winzip.com|Winzip]] or the free [[http://​sourceforge.net/​project/​showfiles.php?​group_id=14481|7-Zip]] to unzip it. After unzip you will have a folder '​**etano**'​ on your computer. What you need to transfer to the server are all files inside the '​**etano**'​ folder. Once you received the package file from us you need to unarchive it. It is compressed with the popular zip format and you need an unarchiving utility like [[http://​www.winzip.com|Winzip]] or the free [[http://​sourceforge.net/​project/​showfiles.php?​group_id=14481|7-Zip]] to unzip it. After unzip you will have a folder '​**etano**'​ on your computer. What you need to transfer to the server are all files inside the '​**etano**'​ folder.
  
-{{:​etano-files.jpg|}}+>>{{:​etano-files.jpg|}}
  
 To transfer the files to the server you need a ftp file transfer utility. If you don't know what that is you should try [[http://​sourceforge.net/​project/​showfiles.php?​group_id=21558|Filezilla]]. It's free and easy to use.  To transfer the files to the server you need a ftp file transfer utility. If you don't know what that is you should try [[http://​sourceforge.net/​project/​showfiles.php?​group_id=21558|Filezilla]]. It's free and easy to use. 
Line 63: Line 62:
   In this case please edit the .htaccess file and remove all lines starting with php_value or php_flag. ​   In this case please edit the .htaccess file and remove all lines starting with php_value or php_flag. ​
   These lines set the best environment for Etano but it can run even if you remove these lines.   These lines set the best environment for Etano but it can run even if you remove these lines.
- +  Once you have edited the .htaccess file then return to the install page. 
-Simply ​follow the instructions on screen.+  You may need to enter the full path ... http://​yoursite.com/​install/​ 
 +Then simply continue to follow the instructions on screen.
 The default username and password for the administration panel are:\\ The default username and password for the administration panel are:\\
 Username: admin\\ Username: admin\\
Line 77: Line 77:
  
 ===== Set up the periodic maintenance task ===== ===== Set up the periodic maintenance task =====
 +==== Cron Jobs - Scheduled Maintenance Tasks ====
 The application depends on a single periodic job to do all maintenance tasks like creating cache files for new members or blog posts, sending messages and emails from/to members, removing invalid members (and the ones marked for deletion by the administrator),​ cleaning up and optimizing the database, fetching news from foreign feeds, etc. This periodic job has to run every 5 minutes. Depending on the time of the day and the date, the script will do different tasks. The application depends on a single periodic job to do all maintenance tasks like creating cache files for new members or blog posts, sending messages and emails from/to members, removing invalid members (and the ones marked for deletion by the administrator),​ cleaning up and optimizing the database, fetching news from foreign feeds, etc. This periodic job has to run every 5 minutes. Depending on the time of the day and the date, the script will do different tasks.
 The site will seem non-functional until you activate this periodic job so it is very important that you set it up correctly from the beginning. The site will seem non-functional until you activate this periodic job so it is very important that you set it up correctly from the beginning.
Line 103: Line 103:
 Having tasks run at various times also helps spread the load of resources used so your site runs as smooth and efficent as possible, which becomes especially important as your site grows where you begin to have lots of members online.\\ Having tasks run at various times also helps spread the load of resources used so your site runs as smooth and efficent as possible, which becomes especially important as your site grows where you begin to have lots of members online.\\
  
-**Important Note:** make sure that your host allows crons to be run every 5 minutes, some shared hosting plans do not allow crons to be run under 15 minutes. GoDaddy and HostGator are a couple of examples, they only allow cron jobs under 15 minutes on their VPS and Dedicated server plans.\\ ​+==== Important Note ==== 
 +**Please Read:**\\ 
 +Make sure that your host allows crons to be run every 5 minutes, some shared hosting plans do not allow crons to be run under 10 or even 15 minutes. GoDaddy and HostGator are a couple of examples, they only allow cron jobs under 15 minutes on their VPS and Dedicated server plans. ​Many hosts aren't up-front as to how frequently you can run cron jobs, so you may need to do some digging in their site terms or forums, or ask them directly. Most will allow you to make cron settings of 5 minutes in cPanel, but that doesn'​t necessarily mean it's going to actually work.\\ 
 +\\
  
-Many hosts aren't up-front as to how frequently you can run cron jobs, so you may need to do some digging in their site terms or forums, or ask them directly. Some may also even allow you to make cron settings of 5 minutes, but that doesn'​t necessarily mean it's going to actually work. +==== Setting up the cron job in cPanel: ​====
- +
-**Setting up the cron job in cPanel:**\\+
  
 **1**) Access your cPanel interface and login, then click on the icon located in the Advanced section of your cPanel interface.\\ **1**) Access your cPanel interface and login, then click on the icon located in the Advanced section of your cPanel interface.\\
-{{:​cpanel_cronjobs.jpg|}}\\+>>{{:​cpanel_cronjobs.jpg|}}\\
 You may next be asked to choose your experience level. If so choose '​Standard'​.\\ You may next be asked to choose your experience level. If so choose '​Standard'​.\\
  
 **2**) Select the predefined time periods shown below from the Common Settings drop-down menu.\\ **2**) Select the predefined time periods shown below from the Common Settings drop-down menu.\\
-{{:​cron_settings.jpg|}}\\+>>{{:​cron_settings.jpg|}}\\
 The "​**Command**"​ field is where you enter the "​command to be run by cron" that you received at the end of the installation process, which should look something like this:\\ The "​**Command**"​ field is where you enter the "​command to be run by cron" that you received at the end of the installation process, which should look something like this:\\
 **/​usr/​bin/​php -f /​home/​your_user/​public_html/​tools/​cron/​cron.php**\\ **/​usr/​bin/​php -f /​home/​your_user/​public_html/​tools/​cron/​cron.php**\\
  
-If you failed to make a note of (or copy) the "​command to be run by cron" that you received at the end of the installation process, you will need to either go thru the install process again, or ask your host what the correct command is for your server.\\+If you failed to make a note of (or copy) the "**command to be run by cron**" that you received at the end of the installation process, you will need to either go thru the install process again, or ask your host what the correct command is for your server. ​You can also try getting your correct server path by viewing the **includes/​defines.inc.php** file on your server, and looking at this line:\\ 
 + 
 +>>​define('​_BASEPATH_','​**/​home/​your_user/​public_html**'​);​\\ 
 + 
 +Then you would include the path in the cron command so it's like this:\\ 
 +>>​**/​usr/​bin/​php -f /​home/​your_user/​public_html/​tools/​cron/​cron.php**\\
  
 Make sure that your cron jobs are set at */5 * * * * and not 5 * * * *\\ Make sure that your cron jobs are set at */5 * * * * and not 5 * * * *\\
Line 127: Line 133:
  
 **3**) This step is optional. Enter the email address where you want the cron output sent to. This can be beneficial if you're having issues with your cron jobs as you will be able to tell if the crons are working or failing.\\ **3**) This step is optional. Enter the email address where you want the cron output sent to. This can be beneficial if you're having issues with your cron jobs as you will be able to tell if the crons are working or failing.\\
-{{:​cron-job-email.jpg|}}\\+>>{{:​cron-job-email.jpg|}}\\
  
 **Some common symptoms that you're crons might not be functioning properly:​**\\ **Some common symptoms that you're crons might not be functioning properly:​**\\
Line 133: Line 139:
  
 **Note:** Once you get the cron jobs working properly, it won't show members that were created while the crons weren'​t functioning,​ the only way they will be released and updated is by '​regenerating'​ your skin under the 'Skin Settings'​ in your Etano admin.\\ **Note:** Once you get the cron jobs working properly, it won't show members that were created while the crons weren'​t functioning,​ the only way they will be released and updated is by '​regenerating'​ your skin under the 'Skin Settings'​ in your Etano admin.\\
-{{:​regenerate_skins.jpg|}}\\ +>>{{:​regenerate_skins.jpg|}}\\
  
  
Line 172: Line 177:
  
  
 +===== Create Consistent Base URL =====
 +Some web servers treat URLs with **www** and **non www** as totally separate URLs or domains which can cause potential issues. For example if your BASE URL is defined with the the **www** prefix www.yoursite.com but you type in just **yoursite.com** into the browser'​s URL field, this can potentially cause problems if the URL changes with or without the **WWW** prefix while browsing or navigating to different pages.
 +
 +Most common issues are users being logged out when navigating the site, or during the registration process when a user attempts to select their state it continues to try and load but never actually loads.
  
 +To prevent this from potentially happening it's best to make it always rewrite with the www prefix by including ​ the following code in the top portion of your .htaccess file.
 +<​code>​Options +FollowSymLinks
 +RewriteEngine on
 +RewriteCond %{HTTP_HOST} ^yoursite.com [NC]
 +RewriteRule ^(.*)$ http://​www.yoursite.com/​$1 [R=301,L]
 +</​code>​
 +Then in the **includes/​defines.inc.php** file on your server be sure your Base URL has the **WWW** prefix, which will be in line #7:
  
 +<​code>​define('​_BASEURL_','​http://​www.yoursite.com'​);//​ protocol required (http:// )</​code>​
  
 ==== Helper scripts ==== ==== Helper scripts ====
installation.1396281888.txt.gz · Last modified: 2014/03/31 16:04 by admin