User Tools

Site Tools


installation

This is an old revision of the document!


Installation Guide

Copy the files to your server

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 Winzip or the free 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 this 'etano' folder.

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 Filezilla. It's free and easy to use.

You can transfer the files either directly to your web server document root (usually 'public_html' or 'www') in which case you will access the site as http://www.yourserver.com or in a sub-folder inside the document root (e.g public_html/mysite) in which case you will access the site as http://www.yourserver.com/mysite.

Make sure that you transfer all files in binary mode or some scripts might not work. 
Configuring your ftp client to transfer in binary mode depends very much on the used program but you should find this option in the Settings/Options/Preferences section.

Create your database and database user and password

Etano needs a database to store all information about users and other data. The installer creates the necessary structure and inserts the default data but it needs to know into which database to insert this and what user and password to use to connect.

To create the database and the user you need to connect to your server control panel. Details about it should be in the welcome email you received from your host. The most popular control panels are cPanel, Plesk, Webmin.
Here are the detailed instructions for cPanel:

  1. Log in to your cPanel.
  2. Click on the 'MySQL® Databases' link.
  3. Create the Etano database:
    1. Choose a name for your Etano database (for example 'etano'), enter it in the 'New Database' field and click 'Create Database'. Please note that your chosen database name will be prefixed with your cPanel username (e.g if you had chosen 'etano' as your database and the username you use to connect to cPanel is 'myuser' then your full database name will be 'myuser_etano').
  4. Create the database user:
    1. Choose a username for Etano (for example 'etano') and enter it in the Username field.
    2. Choose a password and input it into the Password field.
    3. Click Create user. Please note that your chosen user will be prefixed with your cPanel username (e.g if you had chosen 'etano' as your database user and the username you use to connect to cPanel is 'myuser' then your full database user will be 'myuser_etano').
  5. Assign the user to the database:
    1. Under 'Add Users To Your Database', select your Etano username from the User dropdown list, then select your Etano database from the Database dropdown list. Under 'Privileges' check ALL, then click 'Add User To Database'.
  6. Back to the 'MySQL Account Maintenance' screen you should see a list with current databases. Please note the database name, hostname, username listed in the 'Connection Strings' section of your newly created database. You will need them during the Etano installation process. The php connection string looks like this:
$dbh=mysql_connect ("hostname", "username", "<PASSWORD HERE>") or die ('I cannot connect to the database because: ' . mysql_error());
mysql_select_db ("databasename");

Point your browser to your site and follow the installation process

Note: At this point, depending on your configuration, you might receive an error: **500 Internal Server Error**
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.

Simply follow the instructions on screen. The default username and password for the administration panel are:
Username: admin
Password: demo

You are urged to change the default password the first time you log into your admin panel. Keeping the default password may expose your site to hackers.

At the end of the installation process you will get some information regarding the cron job you need to set. Please save this information until you complete the next step (setting up the periodic jobs). The important bit is the "command to be run by cron".

Set up the periodic maintenance task

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.

In the previous step we told you to save the "command to be run by cron" which you were given at the end of the installation process. You will need to use it below. If the command starts literally with "/path/to/php -f …" then you have a problem. It means that the installer was unable to auto-detect where the php binary is and you cannot continue until you find it. There are alternative ways to run the periodic job but they are less desirable. For alternative ways see the end of this section. But before you try the alternatives you could ask your hosting provider about the "path to php cli binary". CLI stands for 'command line interface' and it means that you need to run a php script from the command line.

Assuming that your php binary path was correctly detected (the command listed in the install process should be like "/usr/bin/php -f ….") then you can continue with this document.

On linux operating systems the periodic jobs are run by the cron utility (and are called "cron jobs"). 
On Windows they are called scheduled tasks and are run by the Windows scheduler.

Setting up the jobs depends a lot on your system. We'll explain below how to set it up in cPanel and then directly from the command line:

Adding a new cron job in cPanel

1. Access your cPanel interface and login. You should have your login details and cPanel address in the welcome email you received from your host. 2. Find the "Cron jobs" menu and click on it (usually under the Advanced category). 3. It should ask you to choose your experience level. Choose 'Standard'. 4. If you already have some other cron jobs you will see those listed first and at the bottom of the page, right above the 'Save Crontab' button there's an empty Entry - that's the one we'll use to add our job. If you don't have any other job set then you will see only an empty "Entry 1" waiting for us to fill in. In the "command to run" field you need to enter the "command to be run by cron" you received at the end of the installation process. It should look like this:
/usr/bin/php -f /home/your_user/public_html/tools/cron/cron.php
Then select "Every Five Minutes" (not just 5 but Every Five Minutes) in the "Minute(s)" box, "Every Hour" in the "Hour(s)" box, "Every Day" in the "Day(s) box, "Every Month" in the "Month(s)" box, "Every Week Day" in the "Weekday(s)" box and click on "Save Crontab". That's all.

Adding a new cron job from the command line

Adding cron jobs from the command line is for advanced members who know their way within the linux environment and it is not recommended for beginner. However, here are the steps: 1. In order to avoid permission conflicts you should run the periodic job as the same user with the one apache runs as for your site. Alternatively you can run the cron job as root. 2. enter crontab -e 3. The default editor of the system (which usually is 'vi') should have been started with the current crontab file. Go to the end of the file and enter this line:
*/5 * * * * /usr/bin/php -f /home/your_user/public_html/tools/cron/cron.php
Of course, you need to change the path to php binary and the path to the cron.php file accordingly. You should have the actual command from the last step of the install process. 4. Save and quit.

The 'vi' editor has its own set of commands for adding a new line or saving and quitting. 
Here is a short list, for more details please consult the vi manual:
- new line: press ESC then press 'o'
- save and quit: press ESC then enter ':wq' and press ENTER
- quit without save: press ESC then enter ':q!' and press ENTER
- delete a character: press ESC then go with the cursor to the character you want to delete and press 'x'
- delete a line: press ESC then go with the cursor to the line you want to delete and press 'd' twice.

Alternative ways to run the periodic task

If your server doesn't have the php cli binary installed or if your host does not allow you to access it, you can simulate a browser accessing the cron script every 5 minutes. For this we created the cron_web.php script. If the path to the cron script you were given at the end of the install process is
/home/your_user/public_html/tools/cron/cron.php
then the path to cron_web.php is
/home/your_user/public_html/tools/cron/cron_web.php

You can use the 'wget' utility to simulate a browser. It is a widely used utility on linux systems so it is likely that you have it installed on your server. Problem is that you need to figure out the path to wget. Ask your host if not sure. The command to be run by cron is:
/path/to/wget -q -O /dev/null http://www.yourserver.com/tools/cron/cron_web.php?lk=«license key»

Replace '/path/to/wget' with the actual path to wget, 'http://www.yourserver.com' with the actual address of your site and '«license key»' with the license number of your Etano. For example: /usr/bin/wget -q -O /dev/null http://www.myserver.com/tools/cron/cron_web.php?lk=1234

If your server doesn't allow you to run cron jobs at all or if you are not allowed to run jobs as often as 5 minutes you can contact us to discuss the possibility of having them run remotely from our server.

Helper scripts

If your cron job didn't run for a while (or not right after you finished the install process), some cache files might not have been generated. The cron job only generates cache files for new members and blog posts (approved in the last 10 minutes). It does not generate the cache for members who joined yesterday for example. In this case yesterday's members will not appear in search results, although nothing is wrong with the site.
To regenerate the cache for ALL blog post caches you can access http://www.yourserver.com/tools/cron/gen_blogs_full.php from your browser.
To regenerate the cache for ALL members go to your admin panel - Skin Settings (in the Site Setup menu category) and click on 'Regenerate all skins' link.

installation.1395163523.txt.gz · Last modified: 2014/03/18 17:25 by admin