GenDBWiki/DeveloperDocumentation/PersonalWebServer

Here we describe how to set up a personal GenDB Webserver in the CeBiTec environment.

The following documentation relates to the Head version in the CVS

create a CVS direcory in your home directory e.g. 'CVS_HEAD'

cd
mkdir CVS_HEAD
cd CVS_HEAD

check out the following modules from the CVS make sure your CVS_ROOT and CVS_RSH are set

cvs co bioinfo/common
cvs co bioinfo/gendb
cvs co bioinfo/gendb_web
cvs co bioinfo/projectmanagement
cvs co bioinfo/GOPArc
cvs co bioinfo/BRIDGE

create a user_conf.sh file in the CVS_HEAD/bioinfo/gendb_web/share/www/ directory. This file must contain the two following lines

PORT=9000
CVS_SUBDIR=CVS_HEAD 

PORT defines the port your webserver process will wait for requests. Make sure this port is not used yet. The CVS_SUBDIR states the directory relative to your home where the bioinfo subdir can be found. In thia example ist CVS_HEAD

use a remote shell on a host like bane, hook or trillian

rsh bane

change to the gendb_web directory on that host and run the apache2 script with param start

cd ~/CVS_HEAD/bioinfo/gendb_web
./apache2 start

this will start an httpd process on that machine tha listens on the port you provided in the user_conf.sh file.

direct your browser to

http://bane:9000

and hopefully you will see the login dialog of gendb 2.2

cd ~/CVS_HEAD/bioinfo/gendb_web
./apache2 stop

will stop the webserver. Do not forget to restart the webserver if Perl Modules are updated. cgi scripts and templates will get updated automatically

if you made changes to cgi.template file in gendb_web/share/cgi_bin do not forget to process these files with the process_templates script

cd ~/CVS_HEAD/bioinfo/gendb_web/bin
 ./process_templates ../share/cgi-bin/