blob: 34666794319ac3005d17c277f4bb4fe2a1198add [file] [log] [blame]
<html><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Starting with a Custom Configuration Directory</title><meta content="DocBook XSL Stylesheets V1.76.0" name="generator"><link rel="home" href="index.html" title="Virgo User Guide"><link rel="up" href="ch07.html" title="Chapter&nbsp;7.&nbsp;Starting and Stopping Virgo Server for Apache Tomcat"><link rel="prev" href="ch07s04.html" title="Starting with JMX Access Modifications"><link rel="next" href="ch07s06.html" title="Stopping Virgo Server for Apache Tomcat"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table summary="Navigation header" width="100%"><tr><td align="left" width="20%"><a accesskey="p" href="ch07s04.html">Prev</a>&nbsp;</td><th align="center" width="60%">&nbsp;</th><td align="right" width="20%">&nbsp;<a accesskey="n" href="ch07s06.html">Next</a></td></tr></table><hr></div><div class="section" title="Starting with a Custom Configuration Directory"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="starting-stopping-configuration-directory"></a>Starting with a Custom Configuration Directory</h2></div></div></div><p>
Use the <code class="literal">-configDir</code> option to specify an alternate <code class="literal">configuration</code> directory, different from the
default <code class="literal">SERVER_HOME/configuration</code> directory. This option allows you to use the same Virgo Server for Apache Tomcat
installation to run multiple instances of VTS. Simply create a configuration directory for each
instance, specify unique port numbers, logging and tracing directories, and so on, and then specify that directory
when starting VTS.
</p><p>
If you specify a relative path for the <code class="literal">-configDir</code> parameter,
the startup script interprets the path as relative to the root of the Virgo Server for Apache Tomcat installation,
and not relative to the directory from which you execute the <code class="literal">startup</code> script.
</p><p>
See <a class="link" href="apbs04.html" title="Alternate serviceability and work Directories">Alternate <code class="literal">serviceability</code> and <code class="literal">work</code>
Directories</a> for a known issue related to specifying an alternate <code class="literal">configuration</code> directory.
</p><div class="section" title="Linux"><div class="titlepage"><div><div><h3 class="title"><a name="N1089F"></a>Linux</h3></div></div></div>
To start Virgo Server for Apache Tomcat using a configuration directory of <code class="literal">/configuration/node1</code>:
<pre class="screen">prompt$ cd $SERVER_HOME
prompt$ bin/startup.sh -configDir /configuration/node1</pre></div><div class="section" title="Windows"><div class="titlepage"><div><div><h3 class="title"><a name="N108AA"></a>Windows</h3></div></div></div>
To start Virgo Server for Apache Tomcat using a configuration directory of <code class="literal">c:\configuration\node1</code>:
<pre class="screen">prompt&gt; cd %SERVER_HOME%
prompt&gt; bin\startup.bat -configDir c:\configuration\node1</pre></div></div><div class="navfooter"><hr><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="ch07s04.html">Prev</a>&nbsp;</td><td align="center" width="20%"><a accesskey="u" href="ch07.html">Up</a></td><td align="right" width="40%">&nbsp;<a accesskey="n" href="ch07s06.html">Next</a></td></tr><tr><td valign="top" align="left" width="40%">&nbsp;</td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td valign="top" align="right" width="40%">&nbsp;</td></tr></table></div></body></html>