iPeer v1.0 Installation Docs

Date: August 2004
Authors: Ken Pratt, Luke Hutton

Quick Links:

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:

Download the Source:

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 located in ./ipeer/sql folder):

  shell> /usr/bin/mysql -u root -p ipeer < ./ipeer/sql/ipeer.sql

  Create a user to access the ipeer 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 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