My favorites | Sign in
Project Home Downloads Wiki Issues
READ-ONLY: This project has been archived. For more information see this post.
Search
for
Installation  
Quick & Simple Install Instructions
Updated Jan 8, 2009 by damian.d...@gmail.com

How Long?

How long will installing HulloHallo take? Depending on your familiarity installing web applications, this process will take 5 - 30 minutes.

Download HulloHallo

The latest release of HulloHallo is available at http://code.google.com/p/hullohallo/downloads/list.

The download package contains two main folders:

  • HulloHallo - This is the core package.
  • CronCron - This is the feed consumption engine. This is the heart of HulloHallo, it is run via a cron command.

Requirments

  • PHP5+
  • MySQL 4.1+
  • Access to Cron
  • & mod_rewrite support

First Thing

Before you attempt to install HulloHallo on your web server you will need to create a new database for HulloHallo. Feel free to name this whatever you want. Remember the name of the database though, you'll need that later.

Editing Configuration Files

There are three separate configuration files that will need to be edited before uploading HulloHallo. Details for each are below.

Config

Location: hullohallo/system/application/config/config.php

Open the config.php file.

  • Change the base url of the site. It should be either http://www.yoursite.com/ or http://subdomain.yoursite.com/. Remeber to add the trailing slash.
  • Update the encryption_key setting. This can be changed to anything you want. Using a phrase is best.
  • If your server supports GZIP and you want to enable it, go to the Output Compression section and change this to equal TRUE.

Database

Location: hullohallo/system/application/config/database.php

Open the database.php file and change the following to match your database connection settings:

  • Hostname - This usually will be fine set to localhost. If this does not work, consult your host's online database documentation.
  • Username - Enter your database username.
  • Password - Enter your database password.
  • Database - Enter the name of the database you created in the first step.

You can ignore all the other settings.

Cron Config

Location: croncron/config.php

Because the cron process is separated from the rest of HulloHallo, you will need to repeat the database configuration instructions for the CronCron config.php file. Open the file and fill in the details exactly as you did in the database.php file.

Upload

Ok. It's time to upload your files.

Upload the contents of the HulloHallo folder to the web server. Make sure to upload these files to your root domain or sub-directory as specified in your config.php file.

Once the contents from the HulloHallo folder have been uploaded, you will need to ensure that the following directories are given write access.

CHMOD the following directories so that they are writable by the server:

  • /system/cache
  • /system/logs
  • /images/icons

Now you will need to upload the contents of the CronCron folder to the web server. It is advisable to upload these files to a portion of your server that is not accessible to the outside world.

Install

Now that you have completed uploading your files, it's time to install HulloHallo. Open up your web browser and go to http://www.yourdomain.com/. Once the page loads, you should see a success message and a form requesting user information. After the requested details are entered and the form submitted you will be brought to HulloHallo's login screen. Login to HulloHallo, go to the feeds section and start adding feeds. See the Admin section for more details.

IMPORTANT - After you are able to login, make sure that you delete the following file to ensure that no one is able to re-install HulloHallo on your server.

  • /system/applications/controllers/install.php

There is no need to delete any other files. Just make sure the install.php file is removed from your server.

You are almost done. Just one thing left. You need to turn on the feed engine. To do this, you will need to set up a cron job. Most web host's provide a section to do this in the host's control panel. Create a new cron job and set it to run the following:

  • hullocore.php - This file will be found in the directory you uploaded the contents of the CronCron folder.

Cron Examples

Update the site every 10 minutes:

*/10 * * * * /usr/bin/php5-cgi /home/user/privatescripts/hullocore.php

Update the site every hour:

1 * * * * /usr/bin/php5-cgi /home/user/privatescripts/hullocore.php

Update the site 3 minutes after midnight each day:

*/3 0 * * * /usr/bin/php5-cgi /home/user/privatescripts/hullocore.php

In each of these examples we have placed the hullocore.php file in a directory called privatescripts. In addition to telling the cron daemon to run this file, we have also referenced the location of PHP.

You can find more information about setting up a cron job at http://www.webmasters-central.com/t/cron.shtml or http://www.unixgeeks.org/security/newbie/unix/cron-1.html.

Powered by Google Project Hosting