iPeer v1.0 Installation Instructions
Date: August 2004
Authors: Ken Pratt, Luke Hutton


NOTE: before installing iPeer, you must have both an SQL database server and PHP installed and configured on your system.
This guide assumes you are using MySQL. If you are using a different database system, you will have to consult the respective
documentation for instructions on creating a database.


REQUIREMENTS:

* PHP 4.0+ (tested on PHP 4.3.7)
* MySQL 4.0+ (code is database independent using PEAR DB, however, only tested on MySQL 4.0.20)
* Outgoing SMTP Mail Server or Local SMTP Mail Server
* phpMyAdmin (optional but recommended if using MySQL, available at http://www.phpmyadmin.net)

DOWNLOAD THE SOURCE:

* Visit http://sourceforge.net/projects/ipeer to download the latest installation archive of iPeer



The following describes installation procedures for POSIX and WINDOWS machines:



UNIX/LINUX INSTALLATION:

1. File Installation

 Unpack the installation archive of iPeer to a local directory (./):
 shell> tar -zxvf ipeer.tar.gz

 Decide where you want to put iPeer (web root, subfolder, etc), and create the directory: 
 shell> mkdir /path/to/ipeer/app/dir

 Copy the contents of the app folder to the desired directory:
 shell> cp -R ipeer/app/* /path/to/ipeer/app/dir/


2. Database Installation Using MySQL's Command Line Interface (NOTE: skip to step 3 if you have phpMyAdmin installed)

 Create a database instance:
 shell> /usr/bin/mysqladmin create ipeer -u root -p

 Populate the database with neccessary tables (ipeer.sql location in ./ipeer/sql folder):
 shell> /usr/bin/mysql -u root -p ipeer < ./ipeer/sql/ipeer.sql

 Create a user to access the database:
 shell> echo "GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP ON ipeer.* TO 'ipeer'@'localhost' IDENTIFIED BY 'passwd' WITH GRANT OPTION;" | mysql -u root -p

 Move to the ipeer application directory:
 shell> cd /path/to/ipeer/app/dir/

 Edit database information in the configuration file located at ./inc/config.inc.php:
 shell> nano -w ./inc/config.inc.php
 define('DB_VENDOR', 'mysql');
 define('DB_USER', 'ipeer');
 define('DB_PASS', 'passwd');
 define('DB_HOST', 'localhost');
 define('DB_NAME', 'ipeer');

  Go to step 4


3. Database Installation Using phpMyAdmin (version 2.5.7-pl1)
 
 Create a database instance called ipeer

 Select the SQL tab

 Select file "ipeer.sql" with the "Browse" button and select "Go" button to create the neccessary iPeer tables

 Create a user to access the ipeer database in phpMyAdmin or create a user using mysql from a terminal:
 shell> echo "GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP ON ipeer.* TO 'ipeer'@'localhost' IDENTIFIED BY 'passwd' WITH GRANT OPTION;" | mysql -u root -p

 Move to the ipeer application directory:
 shell> cd /path/to/ipeer/app/dir/

 Edit database information in the configuration file located at ./inc/config.inc.php:
 shell> nano -w ./inc/config.inc.php
 define('DB_VENDOR', 'mysql');
 define('DB_USER', 'ipeer');
 define('DB_PASS', 'passwd');
 define('DB_HOST', 'localhost');
 define('DB_NAME', 'ipeer');

 
4. Finish editing the configuration file ./inc/config.inc.php
 
 Follow the instructions provided in the file


5. Set path to php at top of file in ./scheduler.php

 Edit # !/usr/bin/php to the path of the PHP installation


6. Test the install

 Go to http://www.myserver.com/ipeer/
 
 The default administrator login is username: root, and password: tra1n1ing



WINDOWS INSTALLATION:

1. File Installation

 Unpack the installation archive of iPeer using WinZIP, or WinRAR, etc. to anywhere

 Decide where you want to put iPeer (web root, subfolder, etc), and create the directory

 Copy the contents of the app folder to the directory you just created


2. Database Installation Using MySQL's Command Line Interface (NOTE: skip to step 3 if you have phpMyAdmin installed)

 Create a database instance using Window's command line terminal (cmd.exe):
 C:\> C:\mysql\bin\mysqladmin create ipeer -u root -p

 Populate the database with neccessary tables (ipeer.sql is located in sql folder where you unpacked the installation):
 C:\> C:\mysql\bin\mysql -u root -p ipeer < ipeer\sql\ipeer.sql

 Create a user to access the ipeer database:
 C:\> C:\mysql\bin\mysql -u root -p
 mysql> GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP ON ipeer.* TO 'ipeer'@'localhost' IDENTIFIED BY 'passwd' WITH GRANT OPTION;

 Move to the directory in which you copied the app folder

 Edit database information in the configuration file located at inc\config.inc.php:
 define('DB_VENDOR', 'mysql');
 define('DB_USER', 'ipeer');
 define('DB_PASS', 'passwd');
 define('DB_HOST', 'localhost');
 define('DB_NAME', 'ipeer');

  Go to step 4
  

3. Database Installation Using phpMyAdmin (version 2.5.7-pl1)
 
 Create a database instance called ipeer

 Select the SQL tab

 Select file "ipeer.sql" with the "Browse" button and select "Go" button to create the neccessary iPeer tables

 Create a user to access the ipeer database in phpMyAdmin or create a user using mysql in Window's command line terminal (cmd.exe):
 C:\> C:\mysql\bin\mysql -u root -p
 mysql> GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP ON ipeer.* TO 'ipeer'@'localhost' IDENTIFIED BY 'passwd' WITH GRANT OPTION;

 Move to the directory in which you copied the app folder

 Edit database information in the configuration file located at inc\config.inc.php:
 define('DB_VENDOR', 'mysql');
 define('DB_USER', 'ipeer');
 define('DB_PASS', 'passwd');
 define('DB_HOST', 'localhost');
 define('DB_NAME', 'ipeer');
 
4. Finish editing the configuration file inc\config.inc.php
 
 Follow the instructions provided in the file


5. Set path to php at top of file in scheduler.php located under the directory in which you copied the app folder

 Edit # !C:\PHP\bin\php to the path of the PHP installation


6. Set-up Email. Set the SMTP variable in php.ini (configuration file that came with PHP installation) to your SMTP host 

 ; For Win32 only.
 SMTP = smtp.myserver.com
 smtp_port = 25


7. Test the install

 Go to http://www.myserver.com/ipeer/
 
 The default administrator login is username: root, and password: tra1n1ing