wiki:install

Version 23 (modified by Pan Luo, 14 years ago) ( diff )

--

4. Installation

Windows Installation

File Installation

  • Unpack the installation archive of iPeer using WinZIP, or WinRAR, etc. to your web directory or check out the code from SVN.

iPeer Installer Wizard

Open your favor web browser and type the following URL to start the iPeer installation wizard. URL: <www.your-host.com>/<your-install-dir>/install iPeer should now display a graphical installer for iPeer installation.

Steps for iPeer Installer Wizard

Step 1: System Requirement Check

The step of System Requirement Check checks the system setting in 3 sections:

  • System Requirements: Items in this section are the mandatory system settings for iPeer. All items in this section must be green. See FAQ section for suggestions if there is item appears in red.
  • Optional Requirements: Items in this section are the optional system requirement for iPeer.
  • Recommended Settings: Items in this section shows recommended settings for iPeer. See FAQ section for suggestions if there is item appears in red.

Step 2: License Agreement Select the check box "I Accept the GPL License to agree your acceptance of the iPeer License Agreement". Click the next button to continue to the next step.

Step 3: Configuration of iPeer The step of Configuration of iPeer enables you to setup the iPeer under your local database configuration and some advance configuration.

  • Basic MySQL Setting: Host, the hostname of your machine
  • DB Username, the username of your DB server
  • DB Password, the password of the username
  • DB Database name, the database name that you would use for iPeer installation
  • iPeer Advanced Setting: Session name, the session name for iPeer. It should be unique to your web server.
  • Login text, this is the login URL that will appear on the iPeer logon screen. You can change it to your school's URL.
  • Debug mode, 0 off; 1 on
  • Debug verbosity, 1 - low (low db error reporting), 2 - medium, 3 - high, 4 - highest
  • Email Scheduling, true/false
  • Absolute URL, this is absolute URL of your iPeer system. It should look like: http://<www.your-host.com>/<your-install-dir >
  • Domain, the domain name of your server
  • PHP executable path, the path name of your PHP executable path
  • Super administrator username, the username of super administrator

Manual Configuration: You can try the manual configuration if this installer did not work on you. The link of Manual Configuration shows the detail steps of how to setup the iPeer manually. Click the button "Install iPeer" to install the iPeer based on the information you entered. Congratulation message should be displayed if you install the iPeer successfully. You can then test the iPeer based on the link provided in this page. For first time login as root, the password is "ipeer". Remember to remove the /install directory for security reason if this is your production machine.

Linux Installation

File Installation

  • Untar the distribution (be sure to unzip the subdirectories):

tar -xzvf ipeer_x.tar.gz in your webserver's document root. If you don't have direct access to your document root, put the files in a directory on your local machine, and, after step 3, transfer the directory on your web server using, for example, ftp.

or check out the code from SVN

  • Ensure that all the scripts have the appropriate owner (if PHP is running in safe mode, having some scripts with an owner different from the owner of other scripts will be a problem). See FAQ section for suggestions.
  • Change the tmp directory permission:
     chmod -R 777 app/tmp
    

Apache Configuration

iPeer can be installed under a directory of host root or install in a virtual host environment.

  • mod_rewrite has to be enabled on apache instance (enabled by default)
  • Allow override for the iPeer directory: "AllowOverride All"
  • Add index.php in DirectoryIndex

Sample configuration segment:

LoadModule rewrite_module modules/mod_rewrite.so
DirectoryIndex index.html index.html.var index.php
DocumentRoot "/var/www/html"

<Directory "/var/www/html">
        Options Indexes FollowSymLinks
        AllowOverride All
        Order allow,deny
        Allow from all
</Directory>

MySQL Configuration

  • Create a database for your iPeer instance.
    CREATE DATABASE ipeer;
    
  • Create a user and grant permissions
    CREATE USER 'ipeer'@'localhost' IDENTIFIED BY 'PASSWORD';
    GRANT ALL PRIVILEGES ON ipeer.* TO 'ipeer'@'localhost';
    FLUSH PRIVILEGES;
    

iPeer Installer Wizard

NOTE: If you encounter any error message, please check out FAQs page for possible solutions.

Open your favor web browser and type the following URL to start the iPeer installation wizard. URL: <www.your-host.com>/<your-install-dir>/install iPeer should now display a graphical installer for iPeer installation.

Steps for iPeer Installer Wizard

Step 1: System Requirement Check The step of System Requirement Check checks the system setting in 3 sections:

  • System Requirements: Items in this section are the mandatory system settings for iPeer. All items in this section must be green. See FAQ section for suggestions if there is item appears in red.
  • Optional Requirements: Items in this section are the optional system requirement for iPeer.
  • Recommended Settings: Items in this section shows recommended settings for iPeer. See FAQ section for suggestions if there is item appears in red.

Step 2: License Agreement Select the check box "I Accept the GPL License to agree your acceptance of the iPeer License Agreement." Click the next button to continue to the next step.

Step 3: Configuration of iPeer The step of Configuration of iPeer enables you to setup the iPeer under your local database configuration and some advance configuration.

  • Basic MySQL Setting: Host, the hostname of your machine
  • DB Username, the username of your DB server
  • DB Password, the password of the username
  • DB Database name, the database name that you would use for iPeer installation
  • iPeer Advanced Setting: Session name, the session name for iPeer. It should be unique to your web server.
  • Login text, this is the login URL that will appear on the iPeer logon screen. You can change it to your school's URL.
  • Debug mode, 0 off; 1 on
  • Debug verbosity, 1 - low (low db error reporting), 2 - medium, 3 - high, 4 - highest
  • Email Scheduling, true/false
  • Absolute URL, this is absolute URL of your iPeer system. It should look like: http://<www.your-host.com>/<your-install-dir >
  • Domain, the domain name of your server
  • PHP executable path, the path name of your PHP executable path
  • Super administrator username, the username of super administrator
  • Manual Configuration: You can try the manual configuration if this installer did not work on you. The link of Manual Configuration shows the detail steps of how to setup the iPeer manually.
  • Click the button "Install iPeer" to install the iPeer based on the information you entered.

Congratulation message should be displayed if you install the iPeer successfully. You can then test the iPeer based on the link provided in this page. For first time login as root, the password is "ipeer". Remember to remove the /install directory for security reason if this is your production machine.

Configurations for TeamMaker executable file

iPeer 1.6 uses TeamMaker as group making automatically. To create a TeamMaker executable file in Unix/Linux, please use the following steps:

  • under /<your-install-dir>/TeamMakerCPP, type make to make a executable file for TeamMaker
  • copy the TeamMaker file to /<your-install-dir>: cp TeamMaker ../.
  • change the permission to TeamMaker: chmod 775 TeamMaker
  • change the permission to /<your-install-dir>: chmod 775 <your-install-dir>:

The reason for permission changing on TeamMaker and /<your-install-dir>, is to grant the right permission for your Apache user to execute and create temporary files for group making.

You are done now. Enjoy the iPeer peer evaluation.


< 3. Download | Main Page | 5. Configuration >

Attachments (1)

Download all attachments as: .zip

Note: See TracWiki for help on using the wiki.