/ -> INSTALL.html
1 <!DOCTYPE HTML PUBLIC "-//W3C/DTD HTML 4.01 TRANSITIONAL//EN"
2 "http://www.w3.org/TR/html4/loose.dtd">
3 <HTML>
4 <HEAD>
5 <TITLE>Installation instructions</TITLE>
6 <LINK rel="STYLESHEET" type="text/css" href="phplabware.css">
7 </HEAD>
8
9 <BODY BGCOLOR="#ffffff">
10 <a name="top"></a>
11 <table border=0 width=100%>
12 <tr bgcolor="333388" align=right>
13 <td align=right>
14 <font color="#ffffff"><i>PhpLabWare
15 </i></font>
16 </td>
17 </tr>
18 </table>
19
20 <table border=0 width=100%>
21 <tr bgcolor='eeeeff' align='right'>
22 <td align='right'><a href='setup.php'>setup.php</a></td></tr>
23 </table>
24
25 <h3 align='center'>Requirements</h3>
26 <ul>
27 <li><a href="http://www.apache.org">Apache Webserver </a>(1.3.19 or higher).</li>
28 <li><a href="http://php.net">php </a>(4.04 or higher).</li>
29 <li>SQL server: <a href="http://postgresql.org">PostgreSQL </a>(7.0 or higher), or <a href="http://www.mysql.com">MySQL</a> (3.23 or higher)</li>
30 </ul>
31 <p>Linux distributions will include these. On MacOSX, download php and MySQL or Postgres from: <a href="http://www.entropy.ch/software/macosx"> Marc Ilianage's page</a>. It also work on Windows (Yes, we tried..). Make sure your webserver, php, and SQL server are well-configured. Make sure you have a valid user account on your SQL server that can create databases.</p>
32 <br>
33 <h3 align='center'>Update Instructions</h3>
34 <ul>
35 <li>Make a backup of your database (for postgres: pg_dump phplabware > backupfile, for mysql mysqldump --opt phplabware > backupfile).</li>
36 <li>Did you make a backup of the database?</li>
37 <li>Unpack and decompress the phplabware folder: <i>tar -zxvf phplabware_x.xxx.tar.gz</i> (where x.xxx indicates the version number), 'over' your existing phplabware folder (replacing all the existing php files).</li>
38 <li>Login as sysadmin and run the script '<a href='setup.php'>setup.php</a>' (untill you do so the scripts and database are outof sync).</li>
39 </ul>
40
41
42 <h3 align='center'>Installation Instructions</h3>
43
44 <ul>
45 <li>Unpack and decompress the phplabware folder: <i>tar -zxvf phplabware_x.xxx.tar.gz</i> (where x.xxx indicates the version number).</li>
46 <li>Place the phplabware folder in a web-accessible folder.</li>
47 <li>Edit the file <i>includes/config_inc.exp</i> and save it as <i>includes/config_inc.php</i>. </li>
48 <li>Create the database with the name you entered during the previous step <br>(in postgres for instance: createdb -U postgresuser phplabware, <br>in mysql; mysql -u mysqluser -p mysql, CREATE DATABASE phplabware;). <br>Consult the documentation to your database server for details.</li>
49 <li>Point your browser to the script <a href='setup.php'>'setup.php'</a>. For security reasons this can only be done from the localhost.</li>
50 <li>Enter a password for the 'sysadmin' and submit the form.</li>
51 <li>login as user 'sysadmin' with the password you just entered.</li>
52 <li>Check the form with system settings. Most defaults should be fine. You can change these later too.</li>
53 <li>To convert uploaded MSWord documents into html you can use the library <a href="http://wvware.sf.net">wvHtml</a>.</li>
54 <li>For security reasons you might want to make sure that 'includes/config_inc.php' can only be read by your webdaemon, and that all files in directory phplabware are owned by root, readable by the webdaemon and not writeable by anyone but root. Make sure, however, that the webdaemon can write to directory <i>files</i>.</li>
55 <li>You can customize the welcome page by adding image files to the directory <i>frontims</i>.</li>
56 </ul>
57
58
59 <h5 align='right'><a href='http://phplabware.sourceforge.net'>phplabware at sourceforge</a></h5>
60
61 <!--********************START OF PRINTFOOTER****************************-->
62 <hr>
63 </BODY>
64 </HTML>