geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Geronimo v2.2 > config.xml
Date Wed, 08 Dec 2010 03:22:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1810/9/1/_/styles/combined.css?spaceKey=GMOxDOC22&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/GMOxDOC22/config.xml">config.xml</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~chirunhua@gmail.com">Runhua
Chi</a>
    </h4>
        <br/>
                         <h4>Changes (2)</h4>
                                 
    
<div id="page-diffs">
            <table class="diff" cellpadding="0" cellspacing="0">
            <tr><td class="diff-added-lines" style="background-color: #dfd;">{scrollbar}
<br> <br></td></tr>
            <tr><td class="diff-unchanged" >Although many configuration changes
can be made safely and easily with the [administrative console|Introducing Geronimo Administration
Console], quick configuration changes can be made to your server by stopping the server, editing
*config.xml* and then restarting the server. This file can be found in {{&lt;Geronimo_HOME&gt;/var/config/config.xml}},
where _&lt;Geronimo_HOME&gt;_ is the directory where the server was installed. <br>
<br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >{indent} <br>{indent:1} <br></td></tr>
            <tr><td class="diff-changed-lines" >The module name of the component
that contains the GBeans that have attributes to be configured. The value specified must match
the value specified when the component was deployed. Use the deployer&#39;s [list-modules|deploy#deploy-Listmodulescommandandoptions]
command to obtain the list of module names deployed in your server. <span class="diff-added-words"style="background-color:
#dfd;">Note that you can use *load=&quot;false&quot;* attribute in &lt;module
...&gt; element to prevent the module from starting up.</span> <br></td></tr>
            <tr><td class="diff-unchanged" >{indent} <br>{indent:0} <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
        </table>
</div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <style type='text/css'>/*<![CDATA[*/
table.ScrollbarTable  {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color:
#f0f0f0}
table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}

/*]]>*/</style><div class="Scrollbar"><table class='ScrollbarTable'><tr><td
width='33%' class='ScrollbarPrevName'>&nbsp;</td><td width='33%' class='ScrollbarParent'><sup><a
href="/confluence/display/GMOxDOC22/var+directory"><img border='0' align='middle' src='/confluence/images/icons/up_16.gif'
width='8' height='8'></a></sup><a href="/confluence/display/GMOxDOC22/var+directory">var
directory</a></td><td width='33%' class='ScrollbarNextName'>&nbsp;</td></tr></table></div>

<p>Although many configuration changes can be made safely and easily with the <a
href="/confluence/display/GMOxDOC22/Introducing+Geronimo+Administration+Console" title="Introducing
Geronimo Administration Console">administrative console</a>, quick configuration
changes can be made to your server by stopping the server, editing <b>config.xml</b>
and then restarting the server. This file can be found in <tt>&lt;Geronimo_HOME&gt;/var/config/config.xml</tt>,
where <em>&lt;Geronimo_HOME&gt;</em> is the directory where the server
was installed.</p>

<p>When your server is installed, the initial configuration includes a number of modules
pre-configured to get you started. </p>

<p>If a configuration change is limited to changing an attribute value in an existing
<b>&lt;attribute&gt;</b> element in <b>config.xml</b>, you
can make the change by stopping the server, editing config.xml, and then restarting the server.
Although disruptive, the server only examines config.xml during initialization, so the server
must be restarted to make the changes effective.</p>

<p>Note: You must always stop the server before changing config.xml. Any changes made
to config.xml while the server is running will be lost. When the server stops, it writes a
new copy of config.xml so it contains any configuration changes made while the server was
running.</p>

<h2><a name="config.xml-Makingquickconfigurationchanges"></a>Making quick
configuration changes</h2>

<p>If the configuration changes you need to make are limited to changing attribute values
for a GBean that has already been deployed to your server, follow this procedure.</p>

<ol>
	<li>Stop the server.</li>
	<li>Back up the current <b>config.xml</b> file and open the file in an
editor.</li>
	<li>Review the current <b>config.xml</b> file. You can find <b>&lt;module&gt;</b>
elements with the following form. Each module contains 0, 1, or more <b>&lt;gbean&gt;</b>
elements which, in turn, contain 0, 1, or more <b>&lt;attribute&gt;</b>
elements.
<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml">
<span class="code-tag">&lt;module name=<span class="code-quote">"moduleName"</span>&gt;</span>
    <span class="code-tag">&lt;gbean name=<span class="code-quote">"beanName"</span>&gt;</span>
        <span class="code-tag">&lt;attribute name=<span class="code-quote">"name"</span>&gt;</span>value<span
class="code-tag">&lt;/attribute&gt;</span>
        .
        .
        .
    <span class="code-tag">&lt;/gbean&gt;</span>
    .
    .
    .
<span class="code-tag">&lt;/module&gt;</span>
</pre>
</div></div>
<p>where</p>
<div class="indent0 inline" style="margin-left: 0px;"><style type="text/css">div.inline
p:first-child { display: inline; }</style><p><em>moduleName</em></p></div>
<div class="indent20 inline" style="margin-left: 20px;"><style type="text/css">div.inline
p:first-child { display: inline; }</style><p>The module name of the component
that contains the GBeans that have attributes to be configured. The value specified must match
the value specified when the component was deployed. Use the deployer's <a href="/confluence/display/GMOxDOC22/deploy#deploy-deployListmodulescommandandoptions">list-modules</a>
command to obtain the list of module names deployed in your server. Note that you can use
<b>load="false"</b> attribute in &lt;module ...&gt; element to prevent
the module from starting up.</p></div>
<div class="indent0 inline" style="margin-left: 0px;"><style type="text/css">div.inline
p:first-child { display: inline; }</style><p><em>beanName</em></p></div>
<div class="indent20 inline" style="margin-left: 20px;"><style type="text/css">div.inline
p:first-child { display: inline; }</style><p>The name of the GBean in the current
configuration that contains the attribute to be configured.</p></div>
<div class="indent0 inline" style="margin-left: 0px;"><style type="text/css">div.inline
p:first-child { display: inline; }</style><p><em>name</em></p></div>
<div class="indent20 inline" style="margin-left: 20px;"><style type="text/css">div.inline
p:first-child { display: inline; }</style><p>The name of the attribute with a
value that is to be configured.</p></div>
<div class="indent0 inline" style="margin-left: 0px;"><style type="text/css">div.inline
p:first-child { display: inline; }</style><p><em>value</em></p></div>
<div class="indent20 inline" style="margin-left: 20px;"><style type="text/css">div.inline
p:first-child { display: inline; }</style><p>The current configuration value that
overrides the default attribute value in the current configuration.</p></div></li>
	<li>Change the attribute values as necessary to customize your configuration.</li>
	<li>Save and close <b>config.xml</b>.</li>
	<li>Restart the server and test your configuration changes.</li>
</ol>



<p>Although the Geronimo structure permits you to add additional <b>&lt;attribute&gt;</b>
elements and even additional <b>&lt;gbean&gt;</b> elements for different
modules to <b>config.xml</b> in order to customize your server configuration,
these tasks may require expert knowledge of the Geronimo architecture, the deployment plans
used to build the server, and even the Java source for the GBean itself.  Typical administrators
should not attempt to add elements to <b>config.xml</b> unless instructed by a
service agent or explicit documentation.</p>
    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
        </div>
        <a href="https://cwiki.apache.org/confluence/display/GMOxDOC22/config.xml">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=116392&revisedVersion=3&originalVersion=2">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/GMOxDOC22/config.xml?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message