Installation guide

From PeopleAggregator

Jump to: navigation, search

See also: http://update.peopleaggregator.org/svn/release/pa/README.txt

See also installation notes for specific environments: Fedora/Amazon EC2, Ubuntu Dapper, GoDaddy.com shared hosting

NOTE: PEOPLEAGGREGATOR REQUIRES A UNIX SERVER. LINUX/FREEBSD DEFINITELY WORK. PA WON'T INSTALL ON WINDOWS AT THIS TIME.

[edit] Installing PeopleAggregator

  • Ensure you are running PHP 5, with short_open_tag=On.
  • 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/files, web/files/*, and web/sb-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 a+w /var/www/pa/web/config
 chmod a+w /var/www/pa/web/files
 chmod a+w /var/www/pa/web/sb-files
  • Now you have another choice: do you want to install PeopleAggregator on a completely new website, and do you have admin access to your Apache setup?

OPTION 1 - IF YOU ARE AN ADMINISTRATOR, AND YOU WANT TO MAKE A NEW WEBSITE:

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>

OPTION 2 - IF YOU AREN'T AN ADMINISTRATOR, OR YOU DON'T WANT TO MAKE A NEW WEBSITE:

  • If you already have a website set up somewhere, e.g. /home/phil/public_html/ (which might be the document root for http://phils-website.com/), you can install PeopleAggregator in a subfolder. In this case, decide what you want to call the subfolder. Let's say you want your PeopleAggregator install to be accessible at http://phils-website.com/pa/. In this case, for the rest of this install guide, substitute /home/phil/public_html/pa for /var/www/pa and http://phils-website.com/pa/ for http://example.com/.

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 ...

  • Click 'Set up PeopleAggregator'
  • With any luck, it should populate the database and initialize everything correctly. Now all you have to do is:
  • Move the created local_config.php file up into the /var/www/pa directory: 
 mv /var/www/pa/web/config/local_config.php /var/www/pa/
  • Click on the 'click here' link.
  • And you should have a working PeopleAggregator!

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:

  • When running PHP5 under CGI/CLI version (has happened on CentOS 4.2), local_config.php is not automatically created.

-- should be fixed now. If you get this, try re-downloading and installing with the latest code.

  • Uploaded wmv videos won't play back - you just get garbage in the browser

Insert this line in your /etc/mime.types file: 

application/x-ms-wmv     wmv

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 4.1 or above.

  • WARNING: Installation failed (Error updating database or installing default module settings: DB Error: unknown error; query=ALTER TABLE user_profile_data DROP KEY user_id, ADD KEY profile_fields (user_id, field_type, field_name)) - undoing operations

This error happens if you attempt to install on MySQL 4.1 or 5.0 on GoDaddy hosting. We're looking into it...

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