Admin: 1 revision

2011-10-26T06:15:08Z

1 revision

← Older revision	Revision as of 08:15, 26 October 2011
(No difference)

imported>HeikoNeuweger at 08:41, 25 July 2006

2006-07-25T08:41:28Z

New page

__NOTOC__
= Setting up a personal MeltDB Web Server at the [[CeBiTec]] =

Here we describe how to set up a personal MeltDB Webserver within the CeBiTec environment.

The following documentation was written for the head version of the MeltDB CVS repository.

If you have not done so already, create a CVS directory in your home directory (e.g. `CVS_HEAD`) where you will store the current MeltDB sources:

<pre><nowiki>
cd
mkdir CVS_HEAD
cd CVS_HEAD
</nowiki></pre>

Check out the following modules from the CVS repository (make sure your `CVS_ROOT` and `CVS_RSH` environment variables are set, see the [http://intranet/Programming/cvs-local.shtml internal CVS documentation] for further details):

<pre><nowiki>
cvs co bioinfo/common
cvs co bioinfo/MeltDB
cvs co bioinfo/MeltDB_web
cvs co bioinfo/projectmanagement
cvs co bioinfo/GOPArc
cvs co bioinfo/BRIDGE
</nowiki></pre>

Create a `user_conf.sh` file in the `CVS_HEAD/bioinfo/gendb_web/share/www/`
directory. This file must contain the following lines:

<pre><nowiki>
PORT=9000
CVS_SUBDIR=CVS_HEAD
</nowiki></pre>

The `PORT` variable defines the port where your web server process will wait for requests (here `9000` is an example which has to be substituted by a port number on your machine).
Make sure this port is not used yet. The `CVS_SUBDIR` sets the directory relative to your home-directory where the checked out CVS `bioinfo` subdirectory can be found. In this example it is `CVS_HEAD`.

Open a remote shell on a host like bane, hook or trillian:

<pre><nowiki>
rsh bane
</nowiki></pre>

Change to the `MeltDB_web` directory on that host and run the `apache2` script with parameter `start`:

<pre><nowiki>
cd ~/CVS_HEAD/bioinfo/MeltDB_web
./apache2 start
</nowiki></pre>

This will start an httpd process on the current machine that listens on the port you provided in the `user_conf.sh` file.

If you now direct your browser to the corresponding address that you have configured for your web server, e.g.

<pre><nowiki>
http://bane:9000
</nowiki></pre>

you should see the login dialog of MeltDB.

Executing

<pre><nowiki>
cd ~/CVS_HEAD/bioinfo/MeltDB_web
./apache2 stop
</nowiki></pre>

will stop the web server. Do not forget to restart the web server if Perl modules were modified or updated. Changes in CGI scripts and templates will get updated automatically.

In order to read error messages that were produced by your web server, check the error logs in

<pre><nowiki>
~/CVS_HEAD/bioinfo/MeltDB_web/share/logs
</nowiki></pre>

A convenient way to analyze current errors is the use of

<pre><nowiki>
tail -f <logfile>
</nowiki></pre>

Make sure that you execute the `tail` command on the same host that the httpd process is running on (otherwise the results will be displayed with delay):

<pre><nowiki>
rsh bane
cd ~/CVS_HEAD/bioinfo/MeltDB_web/share/logs
tail -f MeltDB.errors
</nowiki></pre>

If you encounter problems, send an email to the gendb mailing list ([[MailTo(meltdb AT cebitec DOT uni DASH bielefeld DOT de)]]) or contact one of the [http://www.cebitec.uni-bielefeld.de/groups/brf/software/MeltDB_info/people.html MeltDB developers] directly.

MeltDBWiki/DeveloperDocumentation/PersonalWebServer - Revision history

Admin: 1 revision

imported>HeikoNeuweger at 08:41, 25 July 2006