Installation guide

From PeopleAggregator

Jump to: navigation, search

NOTE: PeopleAggregator requires a LAMP setup, which is available on most Unix systems. Windows is NOT officially supported, but a similar setup can be had with Wampserver (http://www.wampserver.com/en/). Also, you need to be able to add VirtualHosts to your Apache setup, or at least be able to specify the DocumentRoot for your web setup.

[edit] Installing PeopleAggregator

  • Ensure you meet the system requirements. (Apache 2, mod_php, PHP 5.2.x, MySQL 5.x, etc)
  • Prepare a domain name for use with PeopleAggregator. If you want to use PeopleAggregator's 'networks' feature, you will need to have wildcard DNS configured, e.g. something like this in your DNS setup: 
 example.org   A 1.2.3.4
 *.example.org A 1.2.3.4

(where 1.2.3.4 is the IP address of your server).

If you can't configure wildcard DNS, don't panic as it's not necessary, but you won't be able to create networks on your PA install.

  • Get the code. You have two choices here:

OPTION 1 - INSTALL FROM TARBALL

  • Unpack the archive onto your web server and rename the main directory into something convenient (e.g. /var/www/pa). Locate the log and web subdirectories (these instructions assume /var/www/pa/log and /var/www/pa/web).

e.g.: 

 tar -vzxf ~/peopleaggregator-0.01-release-1.tar.gz
 mv peopleaggregator-0.01-release-1 /var/www/pa

OPTION 2 - INSTALL FROM SUBVERSION

  • Check out the code from the testing repository into a directory on your web server, e.g. /var/www/pa: 
 svn checkout http://update.peopleaggregator.org/svn/release/pa /var/www/pa

NOW YOU HAVE THE CODE ...

  • Set the mode of the log, networks, web/cache, web/config, web/config/*, web/files, web/files/* directories to allow the web server to write to them.

e.g.: 

 chmod a+w /var/www/pa/log
 chmod a+w /var/www/pa/networks
 chmod a+w /var/www/pa/web/cache
 chmod -R a+w /var/www/pa/web/config
 chmod -R a+w /var/www/pa/web/files


  • Create an Apache virtual host which has the web subdirectory as its DocumentRoot. Make sure "AllowOverride All" is set.

e.g. (in the appropriate file under /etc/httpd): 

 <VirtualHost *:80>
   ServerName example.org
   ServerAlias *.example.org
   DocumentRoot /var/www/pa/web
   <Directory /var/www/pa/web>
      AllowOverride All
   </Directory>
 </VirtualHost>


NOW YOU HAVE YOUR HOST SET UP ...

  • View the root of your new installation in a web browser. 
 http://example.org/
  • Click on the 'Click here to set up PeopleAggregator' link.
  • If any of the prerequisites are not present (e.g. the server is missing PHP's GD or XML extensions), please install them and refresh the config page. If you get a message like 
  Fatal error: require_once() [function.require]: Failed opening required 'HTTP/Client.php'

you'll need to install PEAR.

  • Check the text under 'detecting urls' to make sure all your domains are properly accessible. If you have set up wildcard DNS as specified above, this should say something ending in:
  • If everything looks good, you can now fill in the fields under 'configuration'.
  • First is the admin password. Put in something here that's not easily guessable, but make sure you remember it yourself, as you'll need it for content administration or updating the system. (Note that if you forget it, it's stored in /var/www/pa/local_config.php).
  • Now, the database. You have two choices here:

OPTION 1 - AUTOMATIC DB SETUP

  • PeopleAggregator can create your database and DB user for you if you give it MySQL's administrator (root) login and password.
  • Enter your MySQL server, and pick a database name and username and password. The database must not already exist.
  • Enter your MySQL administrator (root) username and password.

OPTION 2 - MANUAL DB SETUP

  • If you prefer to create your database manually, that's fine too. Create a database and a user, and give it all privileges on the database. e.g.: 
 mysql -u root -p
 (enter your password)
 CREATE DATABASE peopleaggregator;
 GRANT ALL ON peopleaggregator.* TO peopleaggregator@localhost IDENTIFIED BY 'a987234kjhadsf';
 FLUSH PRIVILEGES;
  • Now enter the database name, username and password in the fields in your browser, and leave the administrator password blank.

AFTER THE DB IS READY ...

  • you will be asked for User details for your first Pa account, which is the SUPER_USER (admin user) and has special administrtive right in the PA site.
  • With any luck, it should populate the database and initialize everything correctly. Now all you have to do is:
  • Click on the 'click here' link.
  • And you should have a working PeopleAggregator!
  • Please login with the user credentials you supplied for your admin user account above.

To find out more about what you can do with your new PeopleAggregator install, check out the User Guide For Network Operators!

[edit] Errors

Some errors you may come across:

Then it is mysql version problem. For trouble shooting you can refer the link http://dev.mysql.com/doc/refman/5.0/en/old-client.html

  • WARNING: Installation failed (Error updating database or installing default module settings: DB Error: syntax error; query=UPDATE networks N SET N.member_count=(SELECT COUNT(NU.user_id) FROM networks_users NU where NU.network_id=N.network_id)) - undoing operations

This error will appear if you attempt to install on MySQL 4.0. Please upgrade to MySQL 5 or above.

Retrieved from "http://wiki.peopleaggregator.org/Installation_guide"
Personal tools