====== EPrints ======

===== Installation =====

<code>  $ tar xvzf eprints-2.XXX.tar.gz
 $ cd eprints-2
 $ ./configure --prefix=/home/chi/local/eprints --with-user=chi --with-group=dl
 $ ./install.pl</code> 

Now should edit the configuration file for the copy of Apache.
<code>  $  cd /home/chi/local/apache_1.3.31/conf/httpd.conf
 Add libe: Include /home/chi/local/eprints/cfg/apache.conf
 Change User: chi
        Group: dl</code> 

  * Creating an Eprints Archive

  * Make sure the MySQL is running
<code>  $ cd /home/chi/local/mysql
 $ bin/safe_mysql --user=root --socket=/tmp/mysql.sock &
 $ bin/mysql --user=root (connect to mysql></code> 

<code>  $ cd /home/chi/local/eprints
 $ bin/configure_Archive
 > Archive id:
 > Hostname: toetoe.cs.waikato.ac.nz
 > webserver: 8200
 > email: chi@cs.waikato.ac.nz
 > mySQL host= localhost
 > MySQL port: [[80]]#
 > MySQL socket: /tmp/mysql.sock
 > user= chi
 > password: chi
 > MySQL root password:
 $ bin/create_tables ARCHIVEID
 $ bin/import_subjects ARCHIVEID
 $ bin/generate_static ARCHIVEID
 $ bin/create_user ARCHIVEID <USERID> <EMAIL> admin <PASSWORD>
   (bin/create_user Chi1 chi chi@cs.waikato.ac.nz admin chi
 $ bin/generate_views ARCHIVEID
 $ bin/generate_apacheconf</code> 

After running generate_apacheconf or modifying the configuration you must restart the
webserver for the changes to take effect!

<code> $ cd /home/chi/local/apache_1.3.31
$ bin/apachectl start
 ($bin/apachetl stop)</code> 

Then stop and start your webserver:
Often:
<code>  /etc/rc.d/init.d/httpd stop
 /etc/rc.d/init.d/httpd start
 (or maybe /usr/local/apache/bin/apachectl stop & start)</code> 

ps. EPrints needs to be installed as the same user as the apache webserver runs as.

  * Problems solutions:

When I tried to run bin/create_tables Chi1 an error come out: Can't locate Apache/Cookie.pm

  * Possible solutions:
Try install libapreq I had the same problem, seems this is the one step missing from the installing instructions. libapreq contains the code for manipulating cookies. Greg

     *From Apache * http://httpd.apache.org/apreq/
libapreq is a shared library with associated modules for manipulating client request data via the Apache API. It also includes language bindings for Perl (Apache::Request and Apache::Cookie). Functionality includes:
       * parsing of application/x-www-form-urlencoded data
       * parsing of multipart/form-data
       * parsing of HTTP cookies

  *Download
<code>  * http: * <nowiki>//</nowiki>httpd.apache.org/apreq/docs/libapreq2.
 *software: * http://search.cpan.org/~joesuf/libapreq-1.3/</code> 

  * View Archive from Browser:
Remember to change httpd.conf file.
<code>  http://toetoe.cs.waikato.ac.nz:8200/view</code>