Changes between Version 28 and Version 29 of install


Ignore:
Timestamp:
2012-02-29T23:08:59Z (12 years ago)
Author:
Pan Luo
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • install

    v28 v29  
    1414* MySQL 4.x or above
    1515
    16 == Windows Installation ==
     16== Prepare the Environment ==
    1717
    18 === Install Apache, PHP and MySQL ===
     18You need to install the Apache, PHP and MySQL to be able to run your iPeer. They are plantform/OS dependent. Please refer to the section related to your plantform/OS below.
     19
     20=== Windows Installation ===
     21
     22==== Install Apache, PHP and MySQL ====
    1923The easiest way to install them is using WAMP (http://www.wampserver.com/) or XAMPP (http://www.apachefriends.org/). Go to the page and download the latest version, double click the downloaded file and following the instruction to do the installation.
    2024
    2125You may want to change your default MySQL username and password. Also you need to create a new database for your iPeer installation. You can use phpMyAdmin, which comes with most of the distribution bundle.
    2226
    23 After installation, you may want to start the services.
     27You may need to enable Apache mod_rewrite (if you got "404 Not Found" error in the installation step). To enable it in WAMP, click on tray icon -> Apache -> Apache Modules -> rewrite_module. Make sure it checked. You need to restart Apache after it. (WAMP will restart it for you automatically).
    2428
    25 === File Installation ===
     29After installation, you may want to start the services. Some of the distribution will start the service for you automatically.
     30
     31==== File Installation ====
    2632* Download the iPeer files from [wiki:download Download Page]
    2733* Unpack the installation archive of iPeer using WinZIP, or WinRAR, etc. to your web directory.
    … …  
    2935 * For other distribution, please refer to their help page.
    3036
    31 === iPeer Installer Wizard ===
    32 Open your favor web browser and type the following URL to start the iPeer installation wizard.
    33 URL: <www.your-host.com>/<your-install-dir>/install. E.g. http://localhost/ipeer-2.2.2.1/install.
    34 
    35  NOTE: You may rename the directory to ipeer for cleanner URL. E.g. http://localhost/ipeer/install
    36 
    37 iPeer should now display a graphical installer for iPeer installation.
    38 
    39 If you got "404 Not Found" error, you may need to enable Apache mod_rewrite. To enable it in WAMP, click on tray icon -> Apache -> Apache Modules -> rewrite_module. Make sure it checked. You need to restart Apache after it. (WAMP will restart it for you automatically).
    40 
    41 __''' Steps for iPeer Installer Wizard '''__
    42 
    43 '' Step 1: System Requirement Check ''
    44 
    45 The step of System Requirement Check checks the system setting in 3 sections:
    46  * 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.
    47  * Optional Requirements: Items in this section are the optional system requirement for iPeer.
    48  * Recommended Settings: Items in this section shows recommended settings for iPeer. See FAQ section for suggestions if there is item appears in red.
    49 
    50 '' Step 2: License Agreement ''
    51 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.
    52 
    53 '' Step 3: Configuration of iPeer ''
    54 The step of Configuration of iPeer enables you to setup the iPeer under your local database configuration and some advance configuration.
    55  * Basic MySQL Setting: Host, the hostname of your machine
    56  * DB Username, the username of your DB server
    57  * DB Password, the password of the username
    58  * DB Database name, the database name that you would use for iPeer installation. You need to create it beforehand, mentioned in section "Install Apache, PHP and MySQL"
    59   * For WAMP, the default username is root, password is empty.
    60  * iPeer Advanced Setting: Session name, the session name for iPeer. It should be unique to your web server.
    61  * Login text, this is the login URL that will appear on the iPeer logon screen. You can change it to your school's URL.
    62  * Debug mode, 0 off; 1 on
    63  * Debug verbosity, 1 - low (low db error reporting), 2 - medium, 3 - high, 4 - highest
    64  * Email Scheduling, true/false
    65  * Absolute URL, this is absolute URL of your iPeer system. It should look like: !http://<www.your-host.com>/<your-install-dir >
    66  * Domain, the domain name of your server
    67  * PHP executable path, the path name of your PHP executable path
    68  * Super administrator username, the username of super administrator
    69 
    70 __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.
    71 Click the button "Install iPeer" to install the iPeer based on the information you entered.
    72 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".
    73 Remember to remove the /install directory for security reason if this is your production machine.
    7437
    7538
    76 == Linux Installation ==
     39=== Linux Installation ===
    7740
    78 === File Installation ===
     41==== File Installation ====
    7942 * Untar the distribution (be sure to unzip the subdirectories):
    8043tar -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.
    … …  
    8649}}}
    8750
    88 === Apache Configuration ===
     51==== Apache Configuration ====
    8952
    9053iPeer can be installed under a directory of host root or install in a virtual host environment.
    … …  
    10871}}}
    10972
    110 === MySQL Configuration ===
     73==== MySQL Configuration ====
    11174 * Create a database for your iPeer instance.
    11275{{{
    … …  
    12386
    12487=== iPeer Installer Wizard ===
     88Open your favor web browser and type the following URL to start the iPeer installation wizard.
     89URL: <www.your-host.com>/<your-install-dir>/install. E.g. http://localhost/ipeer-2.2.2.1/install.
     90
     91 NOTE: You may rename the directory to ipeer for cleanner URL. E.g. http://localhost/ipeer/install
     92
     93iPeer should now display a graphical installer for iPeer installation.
     94
    12595'''NOTE''': ''If you encounter any error message, please check out [wiki:FAQs] page for possible solutions.''
    126 
    127 Open your favor web browser and type the following URL to start the iPeer installation wizard.
    128 URL: <www.your-host.com>/<your-install-dir>/install
    129 iPeer should now display a graphical installer for iPeer installation.
    13096
    13197__''' Steps for iPeer Installer Wizard '''__
    13298
    13399'' Step 1: System Requirement Check ''
     100
    134101The step of System Requirement Check checks the system setting in 3 sections:
    135102 * 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.
    … …  
    138105
    139106'' Step 2: License Agreement ''
    140 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.
     107Select 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.
    141108
    142109'' Step 3: Configuration of iPeer ''
    143110The step of Configuration of iPeer enables you to setup the iPeer under your local database configuration and some advance configuration.
    144111 * Basic MySQL Setting: Host, the hostname of your machine
     112  * For WAMP and most of other distributions, your host name should be localhost
    145113 * DB Username, the username of your DB server
    146114 * DB Password, the password of the username
    147  * DB Database name, the database name that you would use for iPeer installation
     115 * DB Database name, the database name that you would use for iPeer installation. You need to create it beforehand, mentioned in section "[#InstallApachePHPandMySQL Install Apache, PHP and MySQL]"
     116  * For WAMP, the default username is root, password is empty.
    148117 * iPeer Advanced Setting: Session name, the session name for iPeer. It should be unique to your web server.
    149118 * Login text, this is the login URL that will appear on the iPeer logon screen. You can change it to your school's URL.
    150  * Debug mode, 0 off; 1 or 2 on
    151  * Debug verbosity, 1 - Errors and warnings shown, model caches refreshed, flash messages halted, 2 - As in 1, but also with full debug messages and SQL output
     119 * Debug mode, 0 off; 1 on
     120 * Debug verbosity, 1 - low (low db error reporting), 2 - medium, 3 - high, 4 - highest
    152121 * Email Scheduling, true/false
    153122 * Absolute URL, this is absolute URL of your iPeer system. It should look like: !http://<www.your-host.com>/<your-install-dir >
    … …  
    155124 * PHP executable path, the path name of your PHP executable path
    156125 * Super administrator username, the username of super administrator
    157  * 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.
    158  * Click the button "Install iPeer" to install the iPeer based on the information you entered.
    159126
    160 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".
    161 Remember to remove the /install directory for security reason if this is your production machine.
     127__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.
     128Click the button "Install iPeer" to install the iPeer based on the information you entered.
    162129
    163 Configurations for !TeamMaker executable file
     130Congratulation message should be displayed if you install the iPeer successfully.
    164131
    165 iPeer 1.6 uses !TeamMaker as group making automatically. To create a !TeamMaker executable file in Unix/Linux, please use the following steps:
    166  *   under /<your-install-dir>/TeamMakerCPP, type make to make a executable file for !TeamMaker
    167  *   copy the !TeamMaker file to /<your-install-dir>: cp !TeamMaker ../.
    168  *   change the permission to !TeamMaker: chmod 775 !TeamMaker
    169  *   change the permission to /<your-install-dir>: chmod 775 <your-install-dir>:
    170 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.
     132== Post Installation ==
     133You can browse your new iPeer installation by pointing your browser to: http://your.domain/ipeer-directory/, e.g. http://localhost/ipeer/
     134You will be presented a login screen. The default username and password are listed as follow:
     135* Username: root
     136* Password: ipeer
     137
     138You can change the password after login.
    171139
    172140You are done now. Enjoy the iPeer peer evaluation.