https://wiki.cebitec.uni-bielefeld.de/brf-software/index.php?action=history&feed=atom&title=IGetDBWiki%2FGettingStarted%2FWebServerIGetDBWiki/GettingStarted/WebServer - Revision history2026-04-09T22:10:52ZRevision history for this page on the wikiMediaWiki 1.39.7https://wiki.cebitec.uni-bielefeld.de/brf-software/index.php?title=IGetDBWiki/GettingStarted/WebServer&diff=2329&oldid=prevAdmin: 1 revision2011-10-26T06:17:27Z<p>1 revision</p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<tr class="diff-title" lang="en">
<td colspan="1" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td>
<td colspan="1" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 08:17, 26 October 2011</td>
</tr><tr><td colspan="2" class="diff-notice" lang="en"><div class="mw-diff-empty">(No difference)</div>
</td></tr></table>Adminhttps://wiki.cebitec.uni-bielefeld.de/brf-software/index.php?title=IGetDBWiki/GettingStarted/WebServer&diff=2328&oldid=previmported>KaiRunte at 13:04, 10 May 20072007-05-10T13:04:39Z<p></p>
<p><b>New page</b></p><div>__NOTOC__<br />
== Web-Server ==<br />
<br />
IGetDB should be able to run in any servlet-container, although it has been tested with Tomcat 5.5 only.<br />
<br />
=== Compilation and Creation of .war File ===<br />
<br />
Simply run:<br />
<br />
<pre><nowiki><br />
ant war<br />
</nowiki></pre><br />
<br />
<br />
This creates the <code><nowiki>igetdb.war</nowiki></code> file in <code><nowiki>share/webserver/webapps/</nowiki></code>. The target "war" has a dependency on the target "build": If any classes need to be compiled, this happens automatically.<br />
<br />
=== Changing the Server-Port ===<br />
<br />
To avoid clashes with other IGetDB instances running on the same machine all ports used by Tomcat are defined in the <code><nowiki>ant.properties</nowiki></code> file. When you have a fresh checkout, the file should look like this:<br />
<br />
<pre><nowiki><br />
CATALINA_HOME /vol/bioinfo/share/apache-tomcat-5.5.15<br />
#SERVER_PORT 8005<br />
#HTTP_PORT 8080<br />
#AJP_PORT 8009<br />
#REDIRECT_PORT 8443<br />
#SHUTDOWN_COMMAND SHUTDOWN<br />
</nowiki></pre><br />
<br />
If you would run the command <code><nowiki>ant web.start</nowiki></code>, ant would fail with a message such as this:<br />
<br />
<pre><nowiki><br />
web.conf.check:<br />
<br />
BUILD FAILED<br />
CVS/bioinfo/igetdb/build.xml:74: Please define the Tomcat ports in the ant.properties file.<br />
</nowiki></pre><br />
<br />
All you need to do is uncomment the four properties definitions <code><nowiki>SERVER_PORT</nowiki></code>, <code><nowiki>HTTP_PORT</nowiki></code>, <code><nowiki>AJP_PORT</nowiki></code>, and <code><nowiki>REDIRECT_PORT</nowiki></code> and '''change''' the numbers to your favourite port numbers. The property <code><nowiki>SHUTDOWN_COMMAND</nowiki></code> must be uncommented as well. Changing the shutdown command is not compulsory, but advisable.<br />
<br />
=== Start/Stop the Web-Server ===<br />
<br />
Depending on where you want to develop you might need to change the file <code><nowiki>ant.properties</nowiki></code>. It defines the base directory of the Tomcat server, also called <code><nowiki>CATALINA_HOME</nowiki></code>. The checked in version defines <code><nowiki>CATALINA_HOME</nowiki></code> for our Solaris environment.<br />
<br />
Important: you need to define the <code><nowiki>JAVA_HOME</nowiki></code> environment variable in your shell. It should point to the base directory of your Java installation (n.b. our rcinfo packages do '''not''' define this variable). The variable is needed by the Tomcat start script.<br />
<br />
* Starting the webserver: <code><nowiki>ant web.start</nowiki></code><br />
* Stopping the webserver: <code><nowiki>ant web.stop</nowiki></code></div>imported>KaiRunte