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 where your webserver process will wait for requests (here 9000 is an example which is to be substituted by a port-number on your machine). Make sure this port is not used yet. The CVS_SUBDIR states the directory relative to your home-directory where the bioinfo-subdirectory can be found. In this example it is 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 that listens on the port you provided in the user_conf.sh file.

direct your browser to

http://bane:9000

and 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. Chnages in 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/

to see what errors are produced check the error logs in ~/CVS_HEAD/bioinfo/gendb_web/share/logs. A convenient way to analyze current errors is the use of tail -f <logfile>. Make sure you start tail on the same host that the httpd process runs on, otherwise delayed results are to be expected

<nowiki>
rsh bane
cd ~/CVS_HEAD/bioinfo/gendb_web/share/logs
tail -f gendb2.errors