Installation Guide for panta and janta

Installation Guidelines for Janta

• install tomcat and  eclipse EE
• to get familiar with the project, first implement a prototype (e.g. ticket:474), the example files are available at  js-tests-jdjolonga/janta
• study  jersey,  jsr311-api 1.1 API,  hibernate
• install  mysql, make sure it allows network connections (comment "skip-networking")
• install mysql administration tool, e.g.,  phpmyadmin
  • using synaptic package managing allows to configure phpmyadmin in a wizard
  • create a link in /var/www to the phpmyadmin directory (e.g., /user/share/phpmyadmin)
• for the further development configure your eclipse so you can work efficiently (e.g. setting preferences, debugging, and sources)
• see  README
  • hibernate.cfg.xml: make sure you get the port for mysql right (use netstat -ta to see the local port for mysql, by default that is 3306)
• for testing purposes you can initialise the database with the dump  demo.sql

Installation Guidelines for Panta

• install apache and php (make sure you have php-pear, php5-xmlrpc php5-xsl php5-curl)
• install PhPDocumentor
• install  eclipse php or eclipse classic with PhPClipse (and configure eclipse)
• to get familiar with the project, first implement a prototype (e.g. ticket:474), the example files are available at  js-tests-jdjolonga/php
• study  CodeIgniter
  •  http://codeigniter.com/tutorials/ (do the tutorials yourself to gain some first practice)
  •  http://codeigniter.com/user_guide (study the user guide for details)
  • there are several tutorials and discussion on the web (e.g., see also  here and  here,  here and  here and  here)
• see  .htaccess (understand how to configure Apache)
•  README

• study  jquery and see the  available plugins

Installation Guidelines for old pantarhei system

• Set up your web server and all the necessary libraries as described in ServerConfiguration

• Create a MySQL database
  • Login as root into the database

    $ mysql -u root -p 
    

  • Create database

    mysql> CREATE DATABASE {database-name}; 
    

  • Create user and respective rights

    mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER
           ON {database-name}.* TO '{username}'@'localhost' IDENTIFIED BY '{password}';
    mysql> exit 
    

  • Initialize the database

    $ mysql -u{username} -p{password} {database-name} < src/sql/init/panta-DBModel.sql 
    

  • Enter SetUp-Data

    $ mysql -u{username} -p{password} {database-name} < src/sql/init/*-data.sql
    

• Download last panta rhei release (pantarhei-v*) from  here. You may copy-paste the commands below into a terminal.

  $ cd /tmp
  $ wget -r https://svn.kwarc.info/repos/pantarhei/src/pantarhei/tags/pantarhei-v*
  $ cd /var/www
  $ sudo cp -r /tmp/svn.kwarc.info/repos/pantarhei/src/pantarhei/tags/pantarhei-v* /var/www
  $ mv pantarhei-v* panta-rhei
  

Voila! You can now access the panta rhei system at  http://localhost/panta-rhei/src/htdocs/

• You now have to tell pantarhei the the database username and password. If you are running different versions of pantarhei you also need to modify

  preg_match('/^panta-rhei\.kwarc\.info/', $_SERVER['SERVER_NAME']) 
  

in Database.php according to your server name. Now modify this part of the same file:

$dbName = "{database}";
$dbHost = "localhost";
$dbUser = "{username}";

Now, create a .panta file in src/htdocs. Enter your {database}, {username} and {password} (multiple datbases are seperated by a comma ",")

 {database}={password},{database}={password} 

Do not forget to instruct svn to ignore this file (svn propedit svn:ignore)

• Default configuration:

  username : admin 
  password : init01
  

For further information see ServerConfiguration