donaldp 2002/09/06 16:31:52
Modified: docs/phoenix changes.html features.html
for-developers-a-future.html
for-developers-alternate-kernel.html
for-developers-project-structure.html
getting-started.html guide-administrator.html
guide-architecture.html guide-deployers.html
guide-example-configuration.html guide-roles.html
index.html install.html
docs/phoenix/assemblers assembly-xml-specification.html
config-xml-specification.html
creating-a-server-application.html
environment-xml-specification.html index.html
what-is-a-server-application.html
docs/phoenix/bdg blockinfo-specification.html
creating-a-block.html index.html
making-phoenix-compatible-comps.html
what-is-a-block-listener.html what-is-a-block.html
what-is-an-application-listener.html
Added: docs/phoenix guide-management.html
docs/phoenix/mx index.html mxinfo.html overview.html
structure.html xdoctags.html
Log:
Update the Phoenix website.
Revision Changes Path
1.11 +1 -484 jakarta-avalon-site/docs/phoenix/changes.html
Index: changes.html
===================================================================
RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/changes.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- changes.html 30 Jun 2002 21:37:39 -0000 1.10
+++ changes.html 6 Sep 2002 23:31:51 -0000 1.11
@@ -1,492 +1,9 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
- <html>
- <head>
- <style type="text/css">
- @import url("./css/tigris.css");
- @import url("./css/site.css");
- </style>
- <meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
-
- <title>Avalon Phoenix - Changes</title>
- </head>
-
- <body marginwidth="0" marginheight="0" class="composite">
-
- <div id="banner">
- <table border="0" cellspacing="0" cellpadding="8" width="100%">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td align="left">
- <a href="http://jakarta.apache.org";><img
src="http://jakarta.apache.org/images/jakarta-logo.gif"; border="0"/></a>
- </td>
- <td align="right">
- <a href="http://jakarta.apache.org/avalon/phoenix";><img
src="./images/header.gif" alt="Avalon Phoenix" border="0"/></a>
- </td>
- </td>
- <td><div align="right" valign="bottom"><b><font size="+3">Avalon
Phoenix</font></b></div></td>
- </tr>
- </table>
- </div>
-
- <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
- <tr valign="top">
- <!-- LEFT SIDE NAVIGATION -->
- <td id="leftcol" width="20%">
- <div id="navcolumn">
- <div>
- <strong>Essentials</strong>
- <div><small> <a href="./index.html">Overview</a>
- </small></div>
- <div><small> <a href="./features.html">Features</a>
- </small></div>
- <div><small> <a href="./getting-started.html">Getting
started</a>
- </small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
- </small></div>
- <div><small> <a href="./install.html">Install</a>
- </small></div>
- </div>
- <div>
- <strong>Guide</strong>
- <div><small> <a
href="./guide-architecture.html">Architectural Overview</a>
- </small></div>
- <div><small> <a href="./guide-roles.html">Development
Roles</a>
- </small></div>
- <div><small> <a href="./guide-administrator.html">for
Administrators</a>
- </small></div>
- <div><small> <a href="./guide-deployers.html">for
Deployers</a>
- </small></div>
- <div><small> <a href="./assemblers/index.html">for
Assemblers</a>
- </small></div>
- <div><small> <a href="./bdg/index.html">for Block
Developers</a>
- </small></div>
- <div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
- </small></div>
- </div>
- <div>
- <strong>Reference</strong>
- <div><small> <a href="./api/index.html">API Docs</a>
- </small></div>
- <div><small> <a
href="./assemblers/config-xml-specification.html">config.xml Specification</a>
- </small></div>
- <div><small> <a
href="./assemblers/assembly-xml-specification.html">assembly.xml
Specification</a>
- </small></div>
- <div><small> <a
href="./assemblers/environment-xml-specification.html">environment.xml
Specification</a>
- </small></div>
- <div><small> <a
href="./bdg/blockinfo-specification.html">BlockInfo Specification</a>
- </small></div>
- </div>
- <div>
- <strong>For Developers</strong>
- <div><small> <a href="./changes.html">Changes</a>
- </small></div>
- <div><small> <a
href="http://jakarta.apache.org/avalon/code-standards.html";>Coding standards</a>
- </small></div>
- <div><small> <a
href="./for-developers-project-structure.html">Project Structure</a>
- </small></div>
- <div><small> <a
href="http://jakarta.apache.org/site/cvsindex.html";>CVS Repositories</a>
- </small></div>
- <div><small> <a
href="http://jakarta.apache.org/site/mail.html";>Mailing Lists</a>
- </small></div>
- <div><small> <a
href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix";>TODO</a>
- </small></div>
- <div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix";>Bug
Database</a>
- </small></div>
- <div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
- </small></div>
- <div><small> <a
href="./for-developers-alternate-kernel.html">Alternate Kernels</a>
- </small></div>
- </div>
- </div>
- </td>
- <td><div id="bodycol"><div class="app">
-
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <strong>ChangeLog</strong>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <table border="0" cellspacing="0" cellpadding="2"
width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <strong>
- Revision 4.0a4 (Unreleased)
- </strong>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <ul>
- <li> <p>
- Update documentation and move to Anakia for document generation.
- (PD)</p>
-</li>
- <li> <p>
-Remove deprecated functionality for deploying old style .sar files or
-deploying from a directory.
- (PD)</p>
-</li>
- <li> <p>
-Remove deprecated Service interface.
- (PD)</p>
-</li>
- <li> <p>
-Remove some deprecated methods from BlockContext.
- (PD)</p>
-</li>
- <li> <p>
-Warn users if their blocks Work interfaces/Services implement
-any lifecycle interfaces.
- (PD)</p>
-</li>
- <li> <p>
- Allow name sub-element in block section of BlockInfo.
- (SM)</p>
-</li>
- <li> <p>
- Add "sar:" URL protocol handling to policy section in environment.xml
- file.
- (PD)</p>
-</li>
- <li> <p>
- Blocks no longre need to implement Block interface. Block interface
- is thus deprecated as is AbstractBlock. This was done to facilitate
- sharing of components between multiple containers.
- (PD)</p>
-</li>
- <li> <p>
- Extrace Blocks to directory based on name deployed with rather than
- .sar name (to support multiple deployments of same .sar). Submitted
- By: Ulrich Mayring ([EMAIL PROTECTED])
- (PD)</p>
-</li>
- <li> <p>
- Rework deployer such that jars are extracted to a temporary work
- directory and then deleted when application is undeployed. This is
- to work around the JVM locking and caching the jars and thus allowing
- users to redeploy applications. Submitted By: Ulrich Mayring
- ([EMAIL PROTECTED])
- (PD)</p>
-</li>
- <li> <p>
- Updated build script so it will work when installed in a directory
- with spaces. Submitted By: [EMAIL PROTECTED] (David Smiley)
- (PD)</p>
-</li>
- <li> <p>
- Use MX4J project to provide the JMX management kernel rather than
- RI.
- (PD)</p>
-</li>
- <li> <p>
- Make phoenix use a temporary located in its hierarchy by setting
- the JVM system property "java.io.tmp". By default this temporary
- location is $PHOENIX_HOME/temp
- (PD)</p>
-</li>
- <li> <p>
- Rework Embeddor so that it instantiates kernel components from a
- by reading the contents of conf/kernel.xml file.
- Submitted By: Joerg Bauer ([EMAIL PROTECTED])
- (PD)</p>
-</li>
- <li> <p>
- Add XDoclet tasks to generate the manifest and BlockInfo files
- based on javadoc tags inserted into Blocks java file. Originally
- Submitted By: vinay nair ([EMAIL PROTECTED])
- (PD)</p>
-</li>
- <li> <p>
- Added javadoc to more classes and added in package.html files
- where appropriate.
- (SM)</p>
-</li>
- <li> <p>
- Added ApplicationListener objects that implement all same
- funcitonality as BlockListener but also provide support
- for Application Starting/Stopping/Failure events and
- provide access to SarMetaData. Consequently deprecated
- BlockListener interface.
- (PH)</p>
-</li>
- <li> <p>
-Enhanced DefaultManager to support authenticated connecitons.
-Submitted By: "Jorg Bauer/Denic" ([EMAIL PROTECTED])
- (PD)</p>
-</li>
- <li> <p>
-Add support for Parameterizable blocks. Submitted by:
-Brian Olsen ([EMAIL PROTECTED])
- (MT)</p>
-</li>
- <li> <p>
-Allow Blocks to declare that they are able to be exported to a Management
-subsystem (ie JMS) by making their blocks declare (Management-access-points/)
- in their BlockInfo. Blocks will be exported to JMX with names like
- "application=Foo,name=MrBlock,role=org.apache.MyManagementInterface"
- (PD)</p>
-</li>
- <li> <p>
- Validate the assembly.xml file and any BlockInfo files if they
- declare the DTD correctly.
- (PD)</p>
-</li>
- <li> <p>
- Add native daemon support by using the daemon created in the
- http://wrapper.sourceforge.net/ project. Submitted By:
- Leif Mortenson ([EMAIL PROTECTED])
- (PD)</p>
-</li>
- <li> <p>
- Fixed bug where application names were inapropriately prefixed
- to log categories. Submitted By Antal Attila ([EMAIL PROTECTED])
- (PD)</p>
-</li>
- <li> <p>
- Fixed bug where application names were inapropriately prefixed
- to log categories.
- (PD)</p>
-</li>
- <li> <p>
- Allow jars contained within the .sar file to declare dependencies
- on libraries using the standard JDK1.2+ Extension mechanism. For
- more information about optional packages, see the document
- Optional Package Versioning in the documentation bundle for your
- Java2 Standard Edition package, in the file
- guide/extensions/versioning.html.
- (PD)</p>
-</li>
- </ul>
- </blockquote>
- </td></tr>
- </table>
- </a>
- <table border="0" cellspacing="0" cellpadding="2"
width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <strong>
- Revision 4.0a3 (November 13, 2001)
- </strong>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <ul>
- <li> <p>
- Add documentation describing BlockListener.
- (PD)</p>
-</li>
- <li> <p>
- Fixed bug that allowed binary distributions to be built without
- copying xerces.jar into correct place.
- (PD)</p>
-</li>
- </ul>
- </blockquote>
- </td></tr>
- </table>
- </a>
- <table border="0" cellspacing="0" cellpadding="2"
width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <strong>
- Revision 4.0a2 (November 12, 2001)
- </strong>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <ul>
- <li> <p>
- Update Phoenix to use the new Avalon Framework Logger interface rather
than
- directly using LogKits Logger class. This required a backwards
incompatible
- change in BlockContext. The getLogger() methods now return the Logger
interface
- rather than LogKits Logger class. If a Block implements Loggable then it
will
- be passed LogKits Logger, this is required for backwards compatability.
If the
- Block implements LogEnabled it will receive the new style Logger.
- (PD)</p>
-</li>
- <li> <p>
- Add support for undeploying and unistalling applications. Add support
for separating
- out install phase from deployment phase and persisting information about
- application installations.
- (MT)</p>
-</li>
- <li> <p>
- Rework the application deployment format (ie .sar format) to be more in
line
- with other specifications. See docs/creating-a-server-application.html
in distribution
- for current format description. The old format is deprecated but will
still work.
- (PD)</p>
-</li>
- <li> <p>
- Created the start of a Phoenix Developers Kit (PDK) that will enable
- developers to rapidly become accustom to developing Phoenix applications.
- (PH)</p>
-</li>
- <li> <p>
- Started to incorporate the JMX code more fully into Phoenix kernel.
Started
- doing this by refactoring the base MBeans and testing using the RIs
agent.
- (PD)</p>
-</li>
- <li> <p>
- Separated code that validated assembly of application into separate
- classes. The validation is now much stricter and requires that
- Blocks conform to established patterns. The validation phase should give
- more reasonable explanations for violations. Extra validation checks
- include verifying that services offered by a Block are actually
interfaces,
- that there is no circular dependencies, that declared Blocks and
BlockListeners
- actually implement Block or BlockListener interface, that the names of
Blocks
- are valid etc.
- (PD)</p>
-</li>
- </ul>
- </blockquote>
- </td></tr>
- </table>
- </a>
- <table border="0" cellspacing="0" cellpadding="2"
width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <strong>
- Revision 4.0a1 (September 25, 2001)
- </strong>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <ul>
- <li> <p>
- Too many things to enumerate here. This is the first public release,
- and the code is still considered alpha. In future releases, we will
- be much more careful to record the changes to Phoenix.
- (BL)</p>
-</li>
- </ul>
- </blockquote>
- </td></tr>
- </table>
- </a>
- <table border="0" cellspacing="0" cellpadding="2"
width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <strong>
- Revision 3.1a2 (Unreleased)
- </strong>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <ul>
- <li> <p>
- Added stylesheet to convert Stylebook markup to DocBook markup.
- (BL)</p>
-</li>
- <li> <p>
- Changed the documentation build process to use Cocoon to build
- the site.
- (BL)</p>
-</li>
- <li> <p>
- Legacy support for nested configuration elements in assembly file
- removed.
- (PD)</p>
-</li>
- <li> <p>
- Simplified Loader and made it set ContextClassLoader before executing
- Main method. It will also use the System property phoenix.home if set
- rather than always trying to dynamically determine home directory.
- (PD)</p>
-</li>
- <li> <p>
- Added SingleAppEmbeddor to launch a kernel to load a single Application.
- Patch supplied by "Eung-ju Park" ([EMAIL PROTECTED]). This is useful if
- you need to reuse the blocks in other contexts (such as in a Servlet).
- (PD)</p>
-</li>
- <li> <p>
- Made default SystemManager a NoopSystemManager. Patch supplied
- by "Eung-ju Park" ([EMAIL PROTECTED]). To re-enable RMI manager a new
- command line switch "--remote-manager" was added.
- (PD)</p>
-</li>
- <li> <p>
- Reworked SecurityManager setup. Instead of starting a security
- Manager inside the code it has been re-architectured so that the
- SecurityManager is set on the command line. This was to avoid a number
- of issues related to creating a URLClassLoader in an unprotected context
- before setting SecurityManager. ie As AccessControllerContext was null it
- is impossible to use ClassLoader.getResource(AsStream)(). This means that
- defining phoenix.insecure will no longer disable the SecurityManager. The
- replacement method is to set the native OS environment variable
- 'PHOENIX_SECURE=false'.
- (PD)</p>
-</li>
- <li> <p>
- Separate Parsing of CLI arguements into separate class (CLISetup).
- This is to facilitate launching Phoenix as a native daemon using
- Tomcats Services API.
- (PD)</p>
-</li>
- <li> <p>
- Started Localizing text strings throughout Phoenix. This is done using
- ResourceManager and Resources from Avalon/Excalibur project.
- (PD)</p>
-</li>
- </ul>
- </blockquote>
- </td></tr>
- </table>
- </a>
- </blockquote>
- </td></tr>
- </table>
- </div>
- <div align="right" id="authors">
- </div>
- </div></td>
- </tr>
- </table>
-
- <!-- FOOTER -->
- <div id="footer">
- <table border="0" cellspacing="0" cellpadding="4">
- <tr>
- <td>Copyright © 1999-2002, Apache Software Foundation</td>
- </tr>
- </table>
- </div>
-
- </body>
- </html>
-
+#changes()
<!-- end the processing -->
-
-
1.13 +3 -21 jakarta-avalon-site/docs/phoenix/features.html
Index: features.html
===================================================================
RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/features.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- features.html 30 Jun 2002 21:37:39 -0000 1.12
+++ features.html 6 Sep 2002 23:31:51 -0000 1.13
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="./mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -226,7 +210,7 @@
<li
- > Configuration management
+ > Configuration management and persistence
</li>
@@ -276,5 +260,3 @@
</body>
</html>
-
-
1.6 +2 -20
jakarta-avalon-site/docs/phoenix/for-developers-a-future.html
Index: for-developers-a-future.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/for-developers-a-future.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- for-developers-a-future.html 30 Jun 2002 21:37:39 -0000 1.5
+++ for-developers-a-future.html 6 Sep 2002 23:31:51 -0000 1.6
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="./mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -196,5 +180,3 @@
</body>
</html>
-
-
1.2 +2 -20
jakarta-avalon-site/docs/phoenix/for-developers-alternate-kernel.html
Index: for-developers-alternate-kernel.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/for-developers-alternate-kernel.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- for-developers-alternate-kernel.html 30 Jun 2002 21:37:39 -0000
1.1
+++ for-developers-alternate-kernel.html 6 Sep 2002 23:31:51 -0000
1.2
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="./mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -190,5 +174,3 @@
</body>
</html>
-
-
1.6 +2 -20
jakarta-avalon-site/docs/phoenix/for-developers-project-structure.html
Index: for-developers-project-structure.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/for-developers-project-structure.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- for-developers-project-structure.html 30 Jun 2002 21:37:39 -0000
1.5
+++ for-developers-project-structure.html 6 Sep 2002 23:31:51 -0000
1.6
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="./mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -209,5 +193,3 @@
</body>
</html>
-
-
1.13 +2 -20 jakarta-avalon-site/docs/phoenix/getting-started.html
Index: getting-started.html
===================================================================
RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/getting-started.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- getting-started.html 30 Jun 2002 21:37:39 -0000 1.12
+++ getting-started.html 6 Sep 2002 23:31:51 -0000 1.13
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -87,6 +69,8 @@
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="./mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -353,5 +337,3 @@
</body>
</html>
-
-
1.6 +2 -20 jakarta-avalon-site/docs/phoenix/guide-administrator.html
Index: guide-administrator.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/guide-administrator.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- guide-administrator.html 30 Jun 2002 21:37:39 -0000 1.5
+++ guide-administrator.html 6 Sep 2002 23:31:51 -0000 1.6
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="./mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -172,5 +156,3 @@
</body>
</html>
-
-
1.7 +2 -20 jakarta-avalon-site/docs/phoenix/guide-architecture.html
Index: guide-architecture.html
===================================================================
RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/guide-architecture.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- guide-architecture.html 4 Sep 2002 21:40:58 -0000 1.6
+++ guide-architecture.html 6 Sep 2002 23:31:51 -0000 1.7
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="./mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -281,5 +265,3 @@
</body>
</html>
-
-
1.7 +4 -22 jakarta-avalon-site/docs/phoenix/guide-deployers.html
Index: guide-deployers.html
===================================================================
RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/guide-deployers.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- guide-deployers.html 6 Aug 2002 11:21:03 -0000 1.6
+++ guide-deployers.html 6 Sep 2002 23:31:51 -0000 1.7
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -28,7 +10,7 @@
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Peter Donald">
- <meta name="email" value="peter @ apache.org">
+ <meta name="email" value="peter at apache.org">
<title>Avalon Phoenix - Guide - for Deployers</title>
</head>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="./mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -150,7 +134,7 @@
</div>
</div>
<div align="right" id="authors">
- by <a href="peter @ apache.org">Peter Donald</a>
+ by <a href="peter at apache.org">Peter Donald</a>
</div>
</div></td>
</tr>
@@ -167,5 +151,3 @@
</body>
</html>
-
-
1.6 +2 -20
jakarta-avalon-site/docs/phoenix/guide-example-configuration.html
Index: guide-example-configuration.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/guide-example-configuration.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- guide-example-configuration.html 30 Jun 2002 21:37:39 -0000 1.5
+++ guide-example-configuration.html 6 Sep 2002 23:31:51 -0000 1.6
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -85,6 +67,8 @@
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="./mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -379,5 +363,3 @@
</body>
</html>
-
-
1.6 +2 -20 jakarta-avalon-site/docs/phoenix/guide-roles.html
Index: guide-roles.html
===================================================================
RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/guide-roles.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- guide-roles.html 30 Jun 2002 21:37:39 -0000 1.5
+++ guide-roles.html 6 Sep 2002 23:31:51 -0000 1.6
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="./mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -212,5 +196,3 @@
</body>
</html>
-
-
1.16 +9 -22 jakarta-avalon-site/docs/phoenix/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/index.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- index.html 4 Sep 2002 21:44:01 -0000 1.15
+++ index.html 6 Sep 2002 23:31:51 -0000 1.16
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -30,7 +12,7 @@
<meta name="author" value="Berin Loritsch">
<meta name="email" value="[EMAIL PROTECTED]">
<meta name="author" value="Peter Donald">
- <meta name="email" value="peter @ apache.org">
+ <meta name="email" value="peter at apache.org">
<meta name="author" value="Paul Hammant">
<meta name="email" value="[EMAIL PROTECTED]">
@@ -87,6 +69,8 @@
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="./mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -232,6 +216,11 @@
<li
+ > <a href="guide-management.html">JMX
Management Guide</a>
+ </li>
+
+
+ <li
> <a
href="assemblers/index.html">Server Application Assembler Guide</a>
</li>
@@ -266,7 +255,7 @@
</div>
<div align="right" id="authors">
by <a href="[EMAIL PROTECTED]">Berin Loritsch</a>
- , <a href="peter @ apache.org">Peter Donald</a>
+ , <a href="peter at apache.org">Peter Donald</a>
, <a href="[EMAIL PROTECTED]">Paul Hammant</a>
</div>
</div></td>
@@ -284,5 +273,3 @@
</body>
</html>
-
-
1.13 +2 -20 jakarta-avalon-site/docs/phoenix/install.html
Index: install.html
===================================================================
RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/install.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- install.html 30 Jun 2002 21:37:39 -0000 1.12
+++ install.html 6 Sep 2002 23:31:51 -0000 1.13
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="./mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -190,5 +174,3 @@
</body>
</html>
-
-
1.1 jakarta-avalon-site/docs/phoenix/guide-management.html
Index: guide-management.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<!-- This is a generated file. Do not edit. -->
<html>
<head>
<style type="text/css">
@import url("./css/tigris.css");
@import url("./css/site.css");
</style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Huw Roberts">
<meta name="email" value="[EMAIL PROTECTED]">
<title>Avalon Phoenix - Guide - JMX Management</title>
</head>
<body marginwidth="0" marginheight="0" class="composite">
<div id="banner">
<table border="0" cellspacing="0" cellpadding="8" width="100%">
<!-- TOP IMAGE -->
<tr>
<td> <td align="left">
<a href="http://jakarta.apache.org";><img
src="http://jakarta.apache.org/images/jakarta-logo.gif"; border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/avalon/phoenix";><img
src="./images/header.gif" alt="Avalon Phoenix" border="0"/></a>
</td>
</td>
<td><div align="right" valign="bottom"><b><font size="+3">Avalon
Phoenix</font></b></div></td>
</tr>
</table>
</div>
<table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
<tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
<td id="leftcol" width="20%">
<div id="navcolumn">
<div>
<strong>Essentials</strong>
<div><small> <a href="./index.html">Overview</a>
</small></div>
<div><small> <a href="./features.html">Features</a>
</small></div>
<div><small> <a href="./getting-started.html">Getting
started</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="./install.html">Install</a>
</small></div>
</div>
<div>
<strong>Guide</strong>
<div><small> <a
href="./guide-architecture.html">Architectural Overview</a>
</small></div>
<div><small> <a href="./guide-roles.html">Development
Roles</a>
</small></div>
<div><small> <a href="./guide-administrator.html">for
Administrators</a>
</small></div>
<div><small> <a href="./guide-deployers.html">for
Deployers</a>
</small></div>
<div><small> <a href="./assemblers/index.html">for
Assemblers</a>
</small></div>
<div><small> <a href="./bdg/index.html">for Block
Developers</a>
</small></div>
<div><small> <a href="./mx/index.html">Management Guide</a>
</small></div>
<div><small> <a
href="./guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
<div>
<strong>Reference</strong>
<div><small> <a href="./api/index.html">API Docs</a>
</small></div>
<div><small> <a
href="./assemblers/config-xml-specification.html">config.xml Specification</a>
</small></div>
<div><small> <a
href="./assemblers/assembly-xml-specification.html">assembly.xml
Specification</a>
</small></div>
<div><small> <a
href="./assemblers/environment-xml-specification.html">environment.xml
Specification</a>
</small></div>
<div><small> <a
href="./bdg/blockinfo-specification.html">BlockInfo Specification</a>
</small></div>
</div>
<div>
<strong>For Developers</strong>
<div><small> <a href="./changes.html">Changes</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/avalon/code-standards.html";>Coding standards</a>
</small></div>
<div><small> <a
href="./for-developers-project-structure.html">Project Structure</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/site/cvsindex.html";>CVS Repositories</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/site/mail.html";>Mailing Lists</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix";>TODO</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix";>Bug
Database</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
<div><small> <a
href="./for-developers-alternate-kernel.html">Alternate Kernels</a>
</small></div>
</div>
</div>
</td>
<td><div id="bodycol"><div class="app">
<div class="h3">
<h3><a name="Table of Contents">Table of Contents</a></h3>
<table cellpadding="3" cellspacing="2" border="1"
width="100%">
<tr class="a">
<td
>
Section
</td>
<td
>
Title
</td>
<td
>
Intended Audience
</td>
</tr>
<tr class="b">
<td
>
1.
</td>
<td
>
<a
href="guide-mx-structure.html">Organizing Structure for Management Data</a>
</td>
<td
>
Everyone
</td>
</tr>
<tr class="a">
<td
>
2.
</td>
<td
>
<a href="guide-mx-overview.html">Step by
Step Overview</a>
</td>
<td
>
Everyone
</td>
</tr>
<tr class="b">
<td
>
3.
</td>
<td
>
<a href="guide-mx-mxinfo.html">MXINFO
files</a>
</td>
<td
>
Component Authors
</td>
</tr>
<tr class="a">
<td
>
4.
</td>
<td
>
<a href="guide-mx-xdoctags.html">XDoclet
Tagging</a>
</td>
<td
>
Component Authors
</td>
</tr>
<tr class="b">
<td
>
5.
</td>
<td
>
[TODO] Container Responsibilities to Support Management
</td>
<td
>
Container Authors
</td>
</tr>
<tr class="a">
<td
>
6.
</td>
<td
>
Link to javadocs
</td>
<td
>
Reference
</td>
</tr>
</table>
</div>
</div>
<div align="right" id="authors">
by <a href="[EMAIL PROTECTED]">Huw Roberts</a>
</div>
</div></td>
</tr>
</table>
<!-- FOOTER -->
<div id="footer">
<table border="0" cellspacing="0" cellpadding="4">
<tr>
<td>Copyright © 1999-2002, Apache Software Foundation</td>
</tr>
</table>
</div>
</body>
</html>
1.5 +7 -23
jakarta-avalon-site/docs/phoenix/assemblers/assembly-xml-specification.html
Index: assembly-xml-specification.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/assemblers/assembly-xml-specification.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- assembly-xml-specification.html 6 Aug 2002 11:21:08 -0000 1.4
+++ assembly-xml-specification.html 6 Sep 2002 23:31:51 -0000 1.5
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -28,7 +10,7 @@
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Peter Donald">
- <meta name="email" value="peter @ apache.org">
+ <meta name="email" value="peter at apache.org">
<title>Avalon Phoenix - Specification of assembly.xml </title>
</head>
@@ -64,7 +46,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -117,6 +101,8 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
@@ -185,7 +171,7 @@
</div>
</div>
<div align="right" id="authors">
- by <a href="peter @ apache.org">Peter Donald</a>
+ by <a href="peter at apache.org">Peter Donald</a>
</div>
</div></td>
</tr>
@@ -202,5 +188,3 @@
</body>
</html>
-
-
1.5 +7 -23
jakarta-avalon-site/docs/phoenix/assemblers/config-xml-specification.html
Index: config-xml-specification.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/assemblers/config-xml-specification.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- config-xml-specification.html 6 Aug 2002 11:21:08 -0000 1.4
+++ config-xml-specification.html 6 Sep 2002 23:31:51 -0000 1.5
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -28,7 +10,7 @@
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Peter Donald">
- <meta name="email" value="peter @ apache.org">
+ <meta name="email" value="peter at apache.org">
<title>Avalon Phoenix - Specification of config.xml </title>
</head>
@@ -64,7 +46,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -117,6 +101,8 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
@@ -160,7 +146,7 @@
</div>
</div>
<div align="right" id="authors">
- by <a href="peter @ apache.org">Peter Donald</a>
+ by <a href="peter at apache.org">Peter Donald</a>
</div>
</div></td>
</tr>
@@ -177,5 +163,3 @@
</body>
</html>
-
-
1.5 +7 -23
jakarta-avalon-site/docs/phoenix/assemblers/creating-a-server-application.html
Index: creating-a-server-application.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/assemblers/creating-a-server-application.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- creating-a-server-application.html 6 Aug 2002 11:21:08 -0000
1.4
+++ creating-a-server-application.html 6 Sep 2002 23:31:51 -0000
1.5
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -28,7 +10,7 @@
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Peter Donald">
- <meta name="email" value="peter @ apache.org">
+ <meta name="email" value="peter at apache.org">
<title>Avalon Phoenix - Guide - Creating a Server Application</title>
</head>
@@ -64,7 +46,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -117,6 +101,8 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
@@ -269,7 +255,7 @@
</div>
</div>
<div align="right" id="authors">
- by <a href="peter @ apache.org">Peter Donald</a>
+ by <a href="peter at apache.org">Peter Donald</a>
</div>
</div></td>
</tr>
@@ -286,5 +272,3 @@
</body>
</html>
-
-
1.5 +31 -45
jakarta-avalon-site/docs/phoenix/assemblers/environment-xml-specification.html
Index: environment-xml-specification.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/assemblers/environment-xml-specification.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- environment-xml-specification.html 6 Aug 2002 11:21:08 -0000
1.4
+++ environment-xml-specification.html 6 Sep 2002 23:31:51 -0000
1.5
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -28,7 +10,7 @@
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Peter Donald">
- <meta name="email" value="peter @ apache.org">
+ <meta name="email" value="peter at apache.org">
<title>Avalon Phoenix - Specification of environment.xml</title>
</head>
@@ -64,7 +46,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -117,6 +101,8 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
@@ -244,33 +230,35 @@
</p>
<div id="source">
- <pre><logger version="1.1">
-<factories>
- <factory type="file"
-
class="org.apache.avalon.excalibur.logger.factory.FileTargetFactory"/>
-</factories>
-
-<categories>
- <category name="" log-level="INFO">
- <log-target id-ref="default"/>
- </category>
-</categories>
-
-<targets>
- <file id="default">
- <filename>{app.home}/logs/default-</filename">
- <append>true</append>
- <rotation type="unique" pattern="yyyyMMdd"
suffix=".log">
- <date>yyyyMMdd</date>
- </rotation>
- </file>
-</targets>
-</logger></pre>
+ <pre><?xml version="1.0"?>
+<environment>
+ <logs version="1.1">
+ <factories>
+ <factory type="file"
class="org.apache.avalon.excalibur.logger.factory.FileTargetFactory"/>
+ </factories>
+
+ <categories>
+ <category name="" log-level="INFO">
+ <log-target id-ref="default"/>
+ </category>
+ </categories>
+
+ <targets>
+ <file id="default">
+ <filename>${app.home}/logs/default-</filename>
+ <append>true</append>
+ <rotation type="unique" pattern="yyyyMMdd"
suffix=".log">
+ <date>yyyyMMdd</date>
+ </rotation>
+ </file>
+ </targets>
+</logs>
+</environment></pre>
</div>
</div>
</div>
<div align="right" id="authors">
- by <a href="peter @ apache.org">Peter Donald</a>
+ by <a href="peter at apache.org">Peter Donald</a>
</div>
</div></td>
</tr>
@@ -287,5 +275,3 @@
</body>
</html>
-
-
1.4 +5 -21 jakarta-avalon-site/docs/phoenix/assemblers/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/assemblers/index.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- index.html 20 Jun 2002 09:48:49 -0000 1.3
+++ index.html 6 Sep 2002 23:31:51 -0000 1.4
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -64,7 +46,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -117,6 +101,8 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
@@ -218,5 +204,3 @@
</body>
</html>
-
-
1.5 +7 -23
jakarta-avalon-site/docs/phoenix/assemblers/what-is-a-server-application.html
Index: what-is-a-server-application.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/assemblers/what-is-a-server-application.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- what-is-a-server-application.html 6 Aug 2002 11:21:08 -0000 1.4
+++ what-is-a-server-application.html 6 Sep 2002 23:31:51 -0000 1.5
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -28,7 +10,7 @@
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Peter Donald">
- <meta name="email" value="peter @ apache.org">
+ <meta name="email" value="peter at apache.org">
<meta name="author" value="Berin Loritsch">
<meta name="email" value="[EMAIL PROTECTED]">
@@ -66,7 +48,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -85,6 +67,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -119,6 +103,8 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
@@ -178,7 +164,7 @@
</div>
</div>
<div align="right" id="authors">
- by <a href="peter @ apache.org">Peter Donald</a>
+ by <a href="peter at apache.org">Peter Donald</a>
, <a href="[EMAIL PROTECTED]">Berin Loritsch</a>
</div>
</div></td>
@@ -196,5 +182,3 @@
</body>
</html>
-
-
1.5 +128 -89
jakarta-avalon-site/docs/phoenix/bdg/blockinfo-specification.html
Index: blockinfo-specification.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/bdg/blockinfo-specification.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- blockinfo-specification.html 6 Aug 2002 11:21:08 -0000 1.4
+++ blockinfo-specification.html 6 Sep 2002 23:31:51 -0000 1.5
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -28,7 +10,7 @@
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Peter Donald">
- <meta name="email" value="peter @ apache.org">
+ <meta name="email" value="peter at apache.org">
<title>Avalon Phoenix - The BlockInfo Specification</title>
</head>
@@ -64,7 +46,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -117,93 +101,151 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
<td><div id="bodycol"><div class="app">
-()
- (<section name="Block Metadata">
- <p>
+ <div class="h3">
+ <h3><a name="Block Metadata">Block Metadata</a></h3>
+ <p
+ >
The meta-data about each block is stored in a BlockInfo file. The
info
- includes details on what version the block is, what
<code>Service</code>s
- it depends upon and which <code>Service</code>s it can offer to
other Blocks.
+ includes details on what version the block is, what
+ <code
+ > Service
+ </code>
+ s
+ it depends upon and which
+ <code
+ > Service
+ </code>
+ s it can offer to other Blocks.
In the future the info will also store such data as the schema for
configuring
the block.
- </p>
-
- <p>
+
+ </p>
+ <p
+ >
The BlockInfo file has the same name as the Block except with the
extention
- <code>.xinfo</code>. Thus if you were looking up the meta info for a
block named
- <code>com.biz.cornerstone.blocks.MyBlock</code> you would look up
the resource
- <code>com/biz/cornerstone/blocks/MyBlock.xinfo</code> in the same
block jar file that
+
+ <code
+ > .xinfo
+ </code>
+ . Thus if you were looking up the meta info for a
block named
+
+ <code
+ > com.biz.cornerstone.blocks.MyBlock
+ </code>
+ you would look up the resource
+
+ <code
+ > com/biz/cornerstone/blocks/MyBlock.xinfo
+ </code>
+ in the same block jar file that
the block was packaged in. The BlockInfo file is a simple XML
format. An
example of such a file follows.
- </p>
-
- <source>
-<![CDATA[
-<?xml version="1.0"?>
-
-<blockinfo>
-
- <block>
- <version>1.2.3</version>
- </block>
-
- <services>
- <service name="com.biz.cornerstone.services.MyService"
- version="2.1.3" />
- </services>
-
- <dependencies>
- <dependency>
- <role>com.biz.cornerstone.services.Authorizer</role>
- <service name="com.biz.cornerstone.service.Authorizer"
- version="1.2"/>
- </dependency>
- <dependency>
- <!-- note that role is not specified and defaults
+
+ </p>
+ <div id="source">
+ <pre><?xml version="1.0"?>
+
+<blockinfo>
+
+ <block>
+ <version>1.2.3</version>
+ </block>
+
+ <services>
+ <service name="com.biz.cornerstone.services.MyService"
+ version="2.1.3" />
+ </services>
+
+ <dependencies>
+ <dependency>
+ <role>com.biz.cornerstone.services.Authorizer</role>
+ <service name="com.biz.cornerstone.service.Authorizer"
+ version="1.2"/>
+ </dependency>
+ <dependency>
+ <!-- note that role is not specified and defaults
to name of service. The service version is not
- specified and it defaults to "1.0" -->
- <service name="com.biz.cornerstone.service.RoleMapper"/>
- </dependency>
- </dependencies>
-
-</blockinfo>
-
-]]>
- </source>
- <p>
+ specified and it defaults to "1.0" -->
+ <service
name="com.biz.cornerstone.service.RoleMapper"/>
+ </dependency>
+ </dependencies>
+
+</blockinfo></pre>
+ </div>
+ <p
+ >
You will notice that the information in the BlockInfo file is
separated into
- three main sections; <code>block</code>, <code>services</code> and
- <code>dependencies</code>.
- </p>
- <subsection name="BlockInfo 'block' Section">
- <p>The block section specifies the version of class. In the future
this
+ three main sections;
+ <code
+ > block
+ </code>
+ ,
+ <code
+ > services
+ </code>
+ and
+
+ <code
+ > dependencies
+ </code>
+ .
+
+ </p>
+ <div class="h4">
+ <h4><a name="BlockInfo 'block' Section">BlockInfo 'block'
Section</a></h4>
+ <p
+ > The block section specifies the version of
class. In the future this
section will also specify the configuration schema if the block is
- <code>Configurable</code>.</p>
- </subsection>
- <subsection name="BlockInfo 'services' Section">
- <p>The services section documents the services that this block can
offer other
+
+ <code
+ > Configurable
+ </code>
+ .
+ </p>
+ </div>
+ <div class="h4">
+ <h4><a name="BlockInfo 'services' Section">BlockInfo 'services'
Section</a></h4>
+ <p
+ > The services section documents the services that this block
can offer other
Blocks. The service instances indicate an interface and optionally a
version
(defaults to version 1.0 if not specified). This section is optional
and a Block
- can choose to not offer any services.</p>
- </subsection>
- <subsection name="BlockInfo 'dependencies' Section">
- <p>The services section documents the services that this block
requires to operate.
+ can choose to not offer any services.
+ </p>
+ </div>
+ <div class="h4">
+ <h4><a name="BlockInfo 'dependencies' Section">BlockInfo
'dependencies' Section</a></h4>
+ <p
+ > The services section documents the services
that this block requires to operate.
Required services are placed in the Blocks ServiceManager under the
name
- specified by the <code>role</code> element of dependency. As is
documented in the
- <a
href="http://jakarta.apache.org/avalon/framework/guide-cop-in-avalon.html";>components</a>
section, the
- concept of Role is more than just a behavioural contract. A
<code>Service</code> is
+ specified by the
+ <code
+ > role
+ </code>
+ element of dependency. As is documented in the
+
+ <a
href="http://jakarta.apache.org/avalon/framework/guide-cop-in-avalon.html";>components</a>
+ section, the
+ concept of Role is more than just a behavioural contract. A
+ <code
+ > Service
+ </code>
+ is
a behavioural contract and thus the necessity to support the role
element. In most
cases however the role element and the name attribute of the service
will be
identical. In these cases it is sufficient to just specify service
element and role
- will default to name of service.</p>
- </subsection>
- </section>)
+ will default to name of service.
+ </p>
+ </div>
+ </div>
</div>
<div align="right" id="authors">
- by <a href="peter @ apache.org">Peter Donald</a>
+ by <a href="peter at apache.org">Peter Donald</a>
</div>
</div></td>
</tr>
@@ -220,6 +262,3 @@
</body>
</html>
-()
-
-
1.5 +7 -23
jakarta-avalon-site/docs/phoenix/bdg/creating-a-block.html
Index: creating-a-block.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/bdg/creating-a-block.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- creating-a-block.html 6 Aug 2002 11:21:08 -0000 1.4
+++ creating-a-block.html 6 Sep 2002 23:31:51 -0000 1.5
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -28,7 +10,7 @@
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Peter Donald">
- <meta name="email" value="peter @ apache.org">
+ <meta name="email" value="peter at apache.org">
<title>Avalon Phoenix - Guide - Creating a Block</title>
</head>
@@ -64,7 +46,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -117,6 +101,8 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
@@ -253,7 +239,7 @@
</div>
</div>
<div align="right" id="authors">
- by <a href="peter @ apache.org">Peter Donald</a>
+ by <a href="peter at apache.org">Peter Donald</a>
</div>
</div></td>
</tr>
@@ -270,5 +256,3 @@
</body>
</html>
-
-
1.4 +5 -21 jakarta-avalon-site/docs/phoenix/bdg/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/bdg/index.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- index.html 20 Jun 2002 09:48:49 -0000 1.3
+++ index.html 6 Sep 2002 23:31:51 -0000 1.4
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -64,7 +46,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -117,6 +101,8 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
@@ -210,5 +196,3 @@
</body>
</html>
-
-
1.4 +5 -21
jakarta-avalon-site/docs/phoenix/bdg/making-phoenix-compatible-comps.html
Index: making-phoenix-compatible-comps.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/bdg/making-phoenix-compatible-comps.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- making-phoenix-compatible-comps.html 20 Jun 2002 09:48:49 -0000
1.3
+++ making-phoenix-compatible-comps.html 6 Sep 2002 23:31:51 -0000
1.4
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -64,7 +46,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -117,6 +101,8 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
@@ -454,5 +440,3 @@
</body>
</html>
-
-
1.5 +7 -23
jakarta-avalon-site/docs/phoenix/bdg/what-is-a-block-listener.html
Index: what-is-a-block-listener.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/bdg/what-is-a-block-listener.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- what-is-a-block-listener.html 6 Aug 2002 11:21:08 -0000 1.4
+++ what-is-a-block-listener.html 6 Sep 2002 23:31:51 -0000 1.5
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -28,7 +10,7 @@
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Peter Donald">
- <meta name="email" value="peter @ apache.org">
+ <meta name="email" value="peter at apache.org">
<meta name="author" value="Paul Hammant">
<meta name="email" value="[EMAIL PROTECTED]">
@@ -66,7 +48,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -85,6 +67,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -119,6 +103,8 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
@@ -236,7 +222,7 @@
</div>
</div>
<div align="right" id="authors">
- by <a href="peter @ apache.org">Peter Donald</a>
+ by <a href="peter at apache.org">Peter Donald</a>
, <a href="[EMAIL PROTECTED]">Paul Hammant</a>
</div>
</div></td>
@@ -254,5 +240,3 @@
</body>
</html>
-
-
1.4 +5 -21 jakarta-avalon-site/docs/phoenix/bdg/what-is-a-block.html
Index: what-is-a-block.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/bdg/what-is-a-block.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- what-is-a-block.html 20 Jun 2002 09:48:49 -0000 1.3
+++ what-is-a-block.html 6 Sep 2002 23:31:51 -0000 1.4
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -64,7 +46,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -117,6 +101,8 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
@@ -224,5 +210,3 @@
</body>
</html>
-
-
1.4 +5 -21
jakarta-avalon-site/docs/phoenix/bdg/what-is-an-application-listener.html
Index: what-is-an-application-listener.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-site/docs/phoenix/bdg/what-is-an-application-listener.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- what-is-an-application-listener.html 20 Jun 2002 09:48:49 -0000
1.3
+++ what-is-an-application-listener.html 6 Sep 2002 23:31:51 -0000
1.4
@@ -1,23 +1,5 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<!-- This is a generated file. Do not edit. -->
<html>
<head>
@@ -64,7 +46,7 @@
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
- <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix";>Download</a>
+ <div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
@@ -83,6 +65,8 @@
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
+ <div><small> <a href="../mx/index.html">Management
Guide</a>
+ </small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
@@ -117,6 +101,8 @@
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
+ <div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
+ </small></div>
</div>
</div>
</td>
@@ -247,5 +233,3 @@
</body>
</html>
-
-
1.1 jakarta-avalon-site/docs/phoenix/mx/index.html
Index: index.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<!-- This is a generated file. Do not edit. -->
<html>
<head>
<style type="text/css">
@import url("../css/tigris.css");
@import url("../css/site.css");
</style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Huw Roberts">
<meta name="email" value="[EMAIL PROTECTED]">
<title>Avalon Phoenix - Management Guide</title>
</head>
<body marginwidth="0" marginheight="0" class="composite">
<div id="banner">
<table border="0" cellspacing="0" cellpadding="8" width="100%">
<!-- TOP IMAGE -->
<tr>
<td> <td align="left">
<a href="http://jakarta.apache.org";><img
src="http://jakarta.apache.org/images/jakarta-logo.gif"; border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/avalon/phoenix";><img
src="../images/header.gif" alt="Avalon Phoenix" border="0"/></a>
</td>
</td>
<td><div align="right" valign="bottom"><b><font size="+3">Avalon
Phoenix</font></b></div></td>
</tr>
</table>
</div>
<table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
<tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
<td id="leftcol" width="20%">
<div id="navcolumn">
<div>
<strong>Essentials</strong>
<div><small> <a href="../index.html">Overview</a>
</small></div>
<div><small> <a href="../features.html">Features</a>
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
</div>
<div>
<strong>Guide</strong>
<div><small> <a
href="../guide-architecture.html">Architectural Overview</a>
</small></div>
<div><small> <a href="../guide-roles.html">Development
Roles</a>
</small></div>
<div><small> <a href="../guide-administrator.html">for
Administrators</a>
</small></div>
<div><small> <a href="../guide-deployers.html">for
Deployers</a>
</small></div>
<div><small> <a href="../assemblers/index.html">for
Assemblers</a>
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
<div><small> <a href="../mx/index.html">Management
Guide</a>
</small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
<div>
<strong>Reference</strong>
<div><small> <a href="../api/index.html">API Docs</a>
</small></div>
<div><small> <a
href="../assemblers/config-xml-specification.html">config.xml Specification</a>
</small></div>
<div><small> <a
href="../assemblers/assembly-xml-specification.html">assembly.xml
Specification</a>
</small></div>
<div><small> <a
href="../assemblers/environment-xml-specification.html">environment.xml
Specification</a>
</small></div>
<div><small> <a
href="../bdg/blockinfo-specification.html">BlockInfo Specification</a>
</small></div>
</div>
<div>
<strong>For Developers</strong>
<div><small> <a href="../changes.html">Changes</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/avalon/code-standards.html";>Coding standards</a>
</small></div>
<div><small> <a
href="../for-developers-project-structure.html">Project Structure</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/site/cvsindex.html";>CVS Repositories</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/site/mail.html";>Mailing Lists</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix";>TODO</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix";>Bug
Database</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
<div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
</small></div>
</div>
</div>
</td>
<td><div id="bodycol"><div class="app">
<div class="h3">
<h3><a name="Who Should Read This Book?">Who Should Read This
Book?</a></h3>
<p
> This guide documents how a developer will go about enabling
JMX Management support for their application or for the kernel.
The text assumes that the reader has a basic understanding of
JMX.
</p>
</div>
<div class="h3">
<h3><a name="Contents">Contents</a></h3>
<ol
>
<li
> <a href="overview.html">Overview</a>
</li>
<li
> <a href="structure.html">The
Structure of Management hierarchy</a>
</li>
<li
> <a href="mxinfo.html">The MXInfo
format</a>
</li>
<li
> <a href="xdoctags.html">Integration
with XDoclet</a>
</li>
</ol>
</div>
</div>
<div align="right" id="authors">
by <a href="[EMAIL PROTECTED]">Huw Roberts</a>
</div>
</div></td>
</tr>
</table>
<!-- FOOTER -->
<div id="footer">
<table border="0" cellspacing="0" cellpadding="4">
<tr>
<td>Copyright © 1999-2002, Apache Software Foundation</td>
</tr>
</table>
</div>
</body>
</html>
1.1 jakarta-avalon-site/docs/phoenix/mx/mxinfo.html
Index: mxinfo.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<!-- This is a generated file. Do not edit. -->
<html>
<head>
<style type="text/css">
@import url("../css/tigris.css");
@import url("../css/site.css");
</style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Huw Roberts">
<meta name="email" value="[EMAIL PROTECTED]">
<title>Avalon Phoenix - Management Guide - MXINFO File Format</title>
</head>
<body marginwidth="0" marginheight="0" class="composite">
<div id="banner">
<table border="0" cellspacing="0" cellpadding="8" width="100%">
<!-- TOP IMAGE -->
<tr>
<td> <td align="left">
<a href="http://jakarta.apache.org";><img
src="http://jakarta.apache.org/images/jakarta-logo.gif"; border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/avalon/phoenix";><img
src="../images/header.gif" alt="Avalon Phoenix" border="0"/></a>
</td>
</td>
<td><div align="right" valign="bottom"><b><font size="+3">Avalon
Phoenix</font></b></div></td>
</tr>
</table>
</div>
<table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
<tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
<td id="leftcol" width="20%">
<div id="navcolumn">
<div>
<strong>Essentials</strong>
<div><small> <a href="../index.html">Overview</a>
</small></div>
<div><small> <a href="../features.html">Features</a>
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
</div>
<div>
<strong>Guide</strong>
<div><small> <a
href="../guide-architecture.html">Architectural Overview</a>
</small></div>
<div><small> <a href="../guide-roles.html">Development
Roles</a>
</small></div>
<div><small> <a href="../guide-administrator.html">for
Administrators</a>
</small></div>
<div><small> <a href="../guide-deployers.html">for
Deployers</a>
</small></div>
<div><small> <a href="../assemblers/index.html">for
Assemblers</a>
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
<div><small> <a href="../mx/index.html">Management
Guide</a>
</small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
<div>
<strong>Reference</strong>
<div><small> <a href="../api/index.html">API Docs</a>
</small></div>
<div><small> <a
href="../assemblers/config-xml-specification.html">config.xml Specification</a>
</small></div>
<div><small> <a
href="../assemblers/assembly-xml-specification.html">assembly.xml
Specification</a>
</small></div>
<div><small> <a
href="../assemblers/environment-xml-specification.html">environment.xml
Specification</a>
</small></div>
<div><small> <a
href="../bdg/blockinfo-specification.html">BlockInfo Specification</a>
</small></div>
</div>
<div>
<strong>For Developers</strong>
<div><small> <a href="../changes.html">Changes</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/avalon/code-standards.html";>Coding standards</a>
</small></div>
<div><small> <a
href="../for-developers-project-structure.html">Project Structure</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/site/cvsindex.html";>CVS Repositories</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/site/mail.html";>Mailing Lists</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix";>TODO</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix";>Bug
Database</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
<div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
</small></div>
</div>
</div>
</td>
<td><div id="bodycol"><div class="app">
<div class="h3">
<h3><a name="Outline">Outline</a></h3>
<ul
>
<li
>
specified in the DTD, available here.[TODO]
</li>
<li
>
explain the various elements
</li>
<li
>
explain runtime requirements
</li>
</ul>
</div>
<div class="h3">
<h3><a name="Overview">Overview</a></h3>
<p
>
The mxinfo file is contains information about how the object it
describes can be managed. It
includes functional information intended for the management
application, and descriptive data
to help guide the user.
</p>
<p
>
An mxinfo file is created at design time, either automatically using
xdoclet tags (TODO described here)
or by hand. At startup the mxinfo file is parsed, and in conjuntion
with class introspection
is used to define the in-memory metadata for the management of the
target object.
</p>
<p
>
A target object is not restricted to having a single mxinfo file,
although the specifics of how that
works is dependant on the container (described [TODO] here).
Similarly it is expected that
at runtime the mxinfo file will be located in the classpath of the
Target class, in the same
package as that class, but this is also under the control of the
Container. Finally, its worth
pointing out that an mxinfo file generated from interface can be
applied to
any class that implements the interface.
</p>
</div>
<div class="h3">
<h3><a name="Example">Example</a></h3>
<p
>
Since mxinfo files are somewhat confusing in the abstract, but
straight forward in practice,
the rest of this section describes an imaginary, yet somewhat
plausible, mxinfo file.
</p>
<div id="source">
<pre><?xml version="1.0"?>
<!DOCTYPE mxinfo PUBLIC "-//PHOENIX/Mx Info DTD Version 1.0//EN"
"http://jakarta.apache.org/phoenix/mxinfo_1_0.dtd">
<mxinfo>
<topic name="ftpServer" >
<!-- attributes -->
<attribute
name="addressString"
description="Address String"
isWriteable="no"
type="java.lang.String"
/>
<attribute
name="serverAddress"
description="Server bind address."
isWriteable="no"
type="java.net.InetAddress"
/>
<!-- operations -->
<operation
name="getDefaultRoot"
description="Gets the default root"
type="java.lang.String"
>
</operation>
<operation
name="getServerPort"
description="Returns port that the server listens on"
type="java.lang.String"
>
<param
name="instance"
description="no description"
type="java.lang.Integer"
/>
</operation>
</topic>
<proxy name="userManager" />
</mxinfo></pre>
</div>
</div>
</div>
<div align="right" id="authors">
by <a href="[EMAIL PROTECTED]">Huw Roberts</a>
</div>
</div></td>
</tr>
</table>
<!-- FOOTER -->
<div id="footer">
<table border="0" cellspacing="0" cellpadding="4">
<tr>
<td>Copyright © 1999-2002, Apache Software Foundation</td>
</tr>
</table>
</div>
</body>
</html>
1.1 jakarta-avalon-site/docs/phoenix/mx/overview.html
Index: overview.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<!-- This is a generated file. Do not edit. -->
<html>
<head>
<style type="text/css">
@import url("../css/tigris.css");
@import url("../css/site.css");
</style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Huw Roberts">
<meta name="email" value="[EMAIL PROTECTED]">
<title>Avalon Phoenix - Guide - Step by Step Overview</title>
</head>
<body marginwidth="0" marginheight="0" class="composite">
<div id="banner">
<table border="0" cellspacing="0" cellpadding="8" width="100%">
<!-- TOP IMAGE -->
<tr>
<td> <td align="left">
<a href="http://jakarta.apache.org";><img
src="http://jakarta.apache.org/images/jakarta-logo.gif"; border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/avalon/phoenix";><img
src="../images/header.gif" alt="Avalon Phoenix" border="0"/></a>
</td>
</td>
<td><div align="right" valign="bottom"><b><font size="+3">Avalon
Phoenix</font></b></div></td>
</tr>
</table>
</div>
<table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
<tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
<td id="leftcol" width="20%">
<div id="navcolumn">
<div>
<strong>Essentials</strong>
<div><small> <a href="../index.html">Overview</a>
</small></div>
<div><small> <a href="../features.html">Features</a>
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
</div>
<div>
<strong>Guide</strong>
<div><small> <a
href="../guide-architecture.html">Architectural Overview</a>
</small></div>
<div><small> <a href="../guide-roles.html">Development
Roles</a>
</small></div>
<div><small> <a href="../guide-administrator.html">for
Administrators</a>
</small></div>
<div><small> <a href="../guide-deployers.html">for
Deployers</a>
</small></div>
<div><small> <a href="../assemblers/index.html">for
Assemblers</a>
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
<div><small> <a href="../mx/index.html">Management
Guide</a>
</small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
<div>
<strong>Reference</strong>
<div><small> <a href="../api/index.html">API Docs</a>
</small></div>
<div><small> <a
href="../assemblers/config-xml-specification.html">config.xml Specification</a>
</small></div>
<div><small> <a
href="../assemblers/assembly-xml-specification.html">assembly.xml
Specification</a>
</small></div>
<div><small> <a
href="../assemblers/environment-xml-specification.html">environment.xml
Specification</a>
</small></div>
<div><small> <a
href="../bdg/blockinfo-specification.html">BlockInfo Specification</a>
</small></div>
</div>
<div>
<strong>For Developers</strong>
<div><small> <a href="../changes.html">Changes</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/avalon/code-standards.html";>Coding standards</a>
</small></div>
<div><small> <a
href="../for-developers-project-structure.html">Project Structure</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/site/cvsindex.html";>CVS Repositories</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/site/mail.html";>Mailing Lists</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix";>TODO</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix";>Bug
Database</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
<div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
</small></div>
</div>
</div>
</td>
<td><div id="bodycol"><div class="app">
<div class="h3">
<h3><a name="Overview">Overview</a></h3>
<p
>
This section gives a quick overview of how to go from a blocks
source code, to a managed object accessible
in a management interface. It does not cover every aspect, nor
is it strictly 'correct'.
</p>
<div class="h4">
<h4><a name="In Development">In Development</a></h4>
<p
>
For a block to be manageable, the developer inserts a
series of XDoclet tags
in the class file. Right now these are:
</p>
<p
>
At the class level:
</p>
<div id="source">
<pre>/**
* Ftp server starting point. Avalon framework will load this
* from the jar file. This is also the starting point of remote
* admin.
*
* @phoenix:block
* @phoenix:mx-topic name="ftpServer"
* @phoenix:service name="org.apache.avalon.ftpserver...
*/
public class FtpServerImpl extends AbstractLogEnabled
...</pre>
</div>
<p
>
where @phoenix:mx-topic marks the block as eligible for
management.
</p>
<p
>
For each attribute:
</p>
<div id="source">
<pre>/**
* @phoenix:mx-attribute
* @phoenix:mx-description Returns the top published directory
* @phoenix:mx-isWriteable false
*/
public String getDefaultRoot() {
...</pre>
</div>
<p
>
and finally for each operation:
</p>
<div id="source">
<pre>/**
* @phoenix:mx-operation
* @phoenix:mx-description Returns port that the server listens on
*/
public String getServerPort(Integer instance) {
...</pre>
</div>
<p
>
When this is compiled the PhoenixDoclet task extracts
this and inserts it
into an mxinfo file. If a method doesn't have a
@pheonix:mx-attribute tag it is not exposed for
management.
</p>
<p
>
Here's what the entry generated from the tags above looks
like:
</p>
<div id="source">
<pre><?xml version="1.0"?>
<!DOCTYPE mxinfo PUBLIC "-//PHOENIX/Mx Info DTD Version 1.0//EN"
"http://jakarta.apache.org/phoenix/mxinfo_1_0.dtd">
<mxinfo>
<topic name="ftpServer" >
<!-- attributes -->
<attribute
name="defaultRoot"
description="Returns the top published directory"
isWriteable="no"
type="java.lang.String"
/>
<!-- operations -->
<operation
name="getServerPort"
description="Returns port that the server listens on"
type="java.lang.String"
>
<param
name="instance"
description="no description"
type="java.lang.Integer"
/>
</operation>
</topic>
</mxinfo></pre>
</div>
<p
>
Alternatively, you could write the mxinfo file directly
(particularly in cases
where you can't/don't want to modify the source code).
The DTD is available [TODO]here.
</p>
</div>
<div class="h4">
<h4><a name="At Startup">At Startup</a></h4>
<p
>
At startup, Phoenix registers each block to a local
SystemManager context. This
context determines where the block fits into the
management hierarchy.
</p>
<div id="source">
<pre>[TODO - code snippet on the register line]</pre>
</div>
<p
>
The system manager uses the mxinfo file in conjunction
with introspection to
generate a ModelMBeanInfo object for each topic. A
RequiredModelMBean is then
created and exposed for management.
</p>
</div>
<div class="h4">
<h4><a name="While Running">While Running</a></h4>
<p
>
In the default configuration, management is provided
through MX4J. The administrator can perform various
tasks such as deploying, starting and stopping
applications and changing the configuration of various
blocks.
</p>
<p
>
The server is accessed on port 8082 of the server. eg.
http://localhost:8082.
</p>
<p
> TODO: Include screenshot?
</p>
</div>
</div>
</div>
<div align="right" id="authors">
by <a href="[EMAIL PROTECTED]">Huw Roberts</a>
</div>
</div></td>
</tr>
</table>
<!-- FOOTER -->
<div id="footer">
<table border="0" cellspacing="0" cellpadding="4">
<tr>
<td>Copyright © 1999-2002, Apache Software Foundation</td>
</tr>
</table>
</div>
</body>
</html>
1.1 jakarta-avalon-site/docs/phoenix/mx/structure.html
Index: structure.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<!-- This is a generated file. Do not edit. -->
<html>
<head>
<style type="text/css">
@import url("../css/tigris.css");
@import url("../css/site.css");
</style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Huw Roberts">
<meta name="email" value="[EMAIL PROTECTED]">
<title>Avalon Phoenix - Management Guide - Organizing Structure</title>
</head>
<body marginwidth="0" marginheight="0" class="composite">
<div id="banner">
<table border="0" cellspacing="0" cellpadding="8" width="100%">
<!-- TOP IMAGE -->
<tr>
<td> <td align="left">
<a href="http://jakarta.apache.org";><img
src="http://jakarta.apache.org/images/jakarta-logo.gif"; border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/avalon/phoenix";><img
src="../images/header.gif" alt="Avalon Phoenix" border="0"/></a>
</td>
</td>
<td><div align="right" valign="bottom"><b><font size="+3">Avalon
Phoenix</font></b></div></td>
</tr>
</table>
</div>
<table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
<tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
<td id="leftcol" width="20%">
<div id="navcolumn">
<div>
<strong>Essentials</strong>
<div><small> <a href="../index.html">Overview</a>
</small></div>
<div><small> <a href="../features.html">Features</a>
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
</div>
<div>
<strong>Guide</strong>
<div><small> <a
href="../guide-architecture.html">Architectural Overview</a>
</small></div>
<div><small> <a href="../guide-roles.html">Development
Roles</a>
</small></div>
<div><small> <a href="../guide-administrator.html">for
Administrators</a>
</small></div>
<div><small> <a href="../guide-deployers.html">for
Deployers</a>
</small></div>
<div><small> <a href="../assemblers/index.html">for
Assemblers</a>
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
<div><small> <a href="../mx/index.html">Management
Guide</a>
</small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
<div>
<strong>Reference</strong>
<div><small> <a href="../api/index.html">API Docs</a>
</small></div>
<div><small> <a
href="../assemblers/config-xml-specification.html">config.xml Specification</a>
</small></div>
<div><small> <a
href="../assemblers/assembly-xml-specification.html">assembly.xml
Specification</a>
</small></div>
<div><small> <a
href="../assemblers/environment-xml-specification.html">environment.xml
Specification</a>
</small></div>
<div><small> <a
href="../bdg/blockinfo-specification.html">BlockInfo Specification</a>
</small></div>
</div>
<div>
<strong>For Developers</strong>
<div><small> <a href="../changes.html">Changes</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/avalon/code-standards.html";>Coding standards</a>
</small></div>
<div><small> <a
href="../for-developers-project-structure.html">Project Structure</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/site/cvsindex.html";>CVS Repositories</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/site/mail.html";>Mailing Lists</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix";>TODO</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix";>Bug
Database</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
<div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
</small></div>
</div>
</div>
</td>
<td><div id="bodycol"><div class="app">
<div class="h3">
<h3><a name="Outline">Outline</a></h3>
<ul
>
<li
>
a conceptual overview for management
</li>
</ul>
</div>
<div class="h3">
<h3><a name="Elements">Elements</a></h3>
<p
>
Management information is stored in a structured format that contains
both a
functional definition of the actions (what can be done) and
descriptive information
about the actions (to help guide the user). It is composed of the
following elements:
</p>
<div class="h4">
<h4><a name="Context">Context</a></h4>
<p
>
The Context contains a list of managed components called Targets,
and a
list of sub-Contexts.
</p>
</div>
<div class="h4">
<h4><a name="Target">Target</a></h4>
<p
>
A target is a manageable object. Examples of Targets in Phoenix
include the
components, the applications and the blocks. Each target has one
or more topics.
</p>
</div>
<div class="h4">
<h4><a name="Topic">Topic</a></h4>
<p
>
A topic is a group of attributes that can be get and/or set on the
Target and a group of operations that can be called on it. It is intended that
Topics group together
a particular aspect of Targets manageability.
</p>
</div>
</div>
<div class="h3">
<h3><a name="Hierarchy">Hierarchy</a></h3>
<p
>
This diagram illustrates how this might be presented in a management
GUI:
</p>
<div id="source">
<pre>Phoenix
|
+--Components
| +-- Kernel
| +-- Deployer
| +-- etc.
|
+--Applications
+--Hello World
| +-- Blocks
| +-- Block 1
| +-- Block 2
|
+-- Ftp Server
+-- Blocks
+-- Block 1
+-- Block 2</pre>
</div>
<p
>
In this example Phoenix, Components and Blocks are Contexts. Kernel,
Deployer, Hello World, Block 1, etc are Targets. Each Target will then have
one or more Topics. Topics might be Logging, Lifecycle, Deployer, etc.
</p>
<p
>
In a jmx environment each topic would most likely be exported as its
own mbean
(so in the above example the jmx name would be
'Instance=Phoenix,Application=Hello_World,Block=Block_2,Topic=Logger'.
</p>
<p
>
In a swing environment each topic might have its own tab.
</p>
<p
>
In a command line environment, the syntax might be:
</p>
<div id="source">
<pre>phoenix-mx.set( "Phoenix/Applications/Hello
World/Logging/LogLevel", "DEBUG" );
phoenix-mx.describe( ""Phoenix/Applications/Hello
World/Logging/LogLevel" );</pre>
</div>
<p
>
The point behind the 'Organizing Structure' is to keep the management
specification
seperated from the management agent, while at the same time
providing enough definition
to keep a shared conceptual view.
</p>
</div>
<div class="h3">
<h3><a name="Management Proxies">Management Proxies</a></h3>
<p
>
There is one remaining concept to cover, the proxy. It is a class
that can be used
to wrap access to the underlying target. Posible uses include the
mapping of data
types to more friendly type, (eg. from Date to String and back),
cleaning up method names, providing backwards
compatibility with older versions, and exposing methods from classes
reFerenced by
the target class.
</p>
</div>
</div>
<div align="right" id="authors">
by <a href="[EMAIL PROTECTED]">Huw Roberts</a>
</div>
</div></td>
</tr>
</table>
<!-- FOOTER -->
<div id="footer">
<table border="0" cellspacing="0" cellpadding="4">
<tr>
<td>Copyright © 1999-2002, Apache Software Foundation</td>
</tr>
</table>
</div>
</body>
</html>
1.1 jakarta-avalon-site/docs/phoenix/mx/xdoctags.html
Index: xdoctags.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<!-- This is a generated file. Do not edit. -->
<html>
<head>
<style type="text/css">
@import url("../css/tigris.css");
@import url("../css/site.css");
</style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
<meta name="author" value="Huw Roberts">
<meta name="email" value="[EMAIL PROTECTED]">
<title>Avalon Phoenix - Management Guide - XDoclet Tagging</title>
</head>
<body marginwidth="0" marginheight="0" class="composite">
<div id="banner">
<table border="0" cellspacing="0" cellpadding="8" width="100%">
<!-- TOP IMAGE -->
<tr>
<td> <td align="left">
<a href="http://jakarta.apache.org";><img
src="http://jakarta.apache.org/images/jakarta-logo.gif"; border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/avalon/phoenix";><img
src="../images/header.gif" alt="Avalon Phoenix" border="0"/></a>
</td>
</td>
<td><div align="right" valign="bottom"><b><font size="+3">Avalon
Phoenix</font></b></div></td>
</tr>
</table>
</div>
<table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
<tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
<td id="leftcol" width="20%">
<div id="navcolumn">
<div>
<strong>Essentials</strong>
<div><small> <a href="../index.html">Overview</a>
</small></div>
<div><small> <a href="../features.html">Features</a>
</small></div>
<div><small> <a href="../getting-started.html">Getting
started</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix";>Download</a>
</small></div>
<div><small> <a href="../install.html">Install</a>
</small></div>
</div>
<div>
<strong>Guide</strong>
<div><small> <a
href="../guide-architecture.html">Architectural Overview</a>
</small></div>
<div><small> <a href="../guide-roles.html">Development
Roles</a>
</small></div>
<div><small> <a href="../guide-administrator.html">for
Administrators</a>
</small></div>
<div><small> <a href="../guide-deployers.html">for
Deployers</a>
</small></div>
<div><small> <a href="../assemblers/index.html">for
Assemblers</a>
</small></div>
<div><small> <a href="../bdg/index.html">for Block
Developers</a>
</small></div>
<div><small> <a href="../mx/index.html">Management
Guide</a>
</small></div>
<div><small> <a
href="../guide-example-configuration.html">Example configuration</a>
</small></div>
</div>
<div>
<strong>Reference</strong>
<div><small> <a href="../api/index.html">API Docs</a>
</small></div>
<div><small> <a
href="../assemblers/config-xml-specification.html">config.xml Specification</a>
</small></div>
<div><small> <a
href="../assemblers/assembly-xml-specification.html">assembly.xml
Specification</a>
</small></div>
<div><small> <a
href="../assemblers/environment-xml-specification.html">environment.xml
Specification</a>
</small></div>
<div><small> <a
href="../bdg/blockinfo-specification.html">BlockInfo Specification</a>
</small></div>
</div>
<div>
<strong>For Developers</strong>
<div><small> <a href="../changes.html">Changes</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/avalon/code-standards.html";>Coding standards</a>
</small></div>
<div><small> <a
href="../for-developers-project-structure.html">Project Structure</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/site/cvsindex.html";>CVS Repositories</a>
</small></div>
<div><small> <a
href="http://jakarta.apache.org/site/mail.html";>Mailing Lists</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix";>TODO</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix";>Bug
Database</a>
</small></div>
<div><small> <a
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement";>Enhancement
Requests</a>
</small></div>
<div><small> <a
href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
</small></div>
</div>
</div>
</td>
<td><div id="bodycol"><div class="app">
<div class="h3">
<h3><a name="Outline">Outline</a></h3>
<ul
>
<li
>
describe the XDoclet tags and how they generate the mxinfo
</li>
<li
>
including how defaults are generated
</li>
<li
>
dependencies and how to set up ant to generate the mxinfo files
</li>
</ul>
</div>
<div class="h3">
<h3><a name="Overview">Overview</a></h3>
<p
>
XDoclet tags can be inserted into source code to automatically
generate the mxinfo file.
There are a number of advantages to doing it this way:
</p>
<ul
>
<li
>
its a lot faster than writing mxinfo files by hand
</li>
<li
>
its harder to make mistakes, since much of the data required for
the mxinfo file is
parsed out of the source code
</li>
<li
>
useful defaults can be used by reading the standard javadoc.
</li>
</ul>
<p
>
Any class or interface can be used to produce mxinfo files. How they
get used is up to
container and its Management subsystem.
</p>
</div>
<div class="h3">
<h3><a name="The Tags">The Tags</a></h3>
<p
>
The following tags are defined:
</p>
<div class="h4">
<h4><a name="phoenix:mx-topic">phoenix:mx-topic</a></h4>
<table cellpadding="3" cellspacing="2" border="1"
width="100%">
<tr class="a">
<td
>
Scope
</td>
<td
>
Applies to a class and interfaces.
</td>
</tr>
<tr class="b">
<td
>
Purpose
</td>
<td
>
Marks the class or interface as eligible for management.
</td>
</tr>
<tr class="a">
<td
>
Parameters
</td>
<td
>
It takes a single attribute, called name, that will be used
to uniquely define the Topic for each Target that includes it.
This name may be presented to the user in the management agent.
</td>
</tr>
<tr class="b">
<td
>
Notes
</td>
<td
>
</td>
</tr>
</table>
<p
>
Example:
</p>
<div id="source">
<pre>/**
* This is the interface via which you can manager
* the root container of Applications.
*
* @phoenix:mx-topic name="Kernel"
*
* @author
*/</pre>
</div>
</div>
<div class="h4">
<h4><a name="phoenix:mx-attribute">phoenix:mx-attribute</a></h4>
<table cellpadding="3" cellspacing="2" border="1"
width="100%">
<tr class="a">
<td
>
Scope
</td>
<td
>
Applies to getter and setter methods.
</td>
</tr>
<tr class="b">
<td
>
Purpose
</td>
<td
>
Marks the method as being a getter or setter and as eligible for
management. If the class defines a getter and setter, then
just
getter should be marked up.
</td>
</tr>
<tr class="a">
<td
>
Parameters
</td>
<td
>
None
</td>
</tr>
<tr class="b">
<td
>
Notes
</td>
<td
>
Often used in conjuntion with the mx-isWriteable tag
</td>
</tr>
</table>
<p
>
Example:
</p>
<div id="source">
<pre>/**
* Gets the list of applications running in the container
*
* @phoenix:mx-attribute
*
* @return applicationNames The array of application names
*/
String[] getApplicationNames();</pre>
</div>
</div>
<div class="h4">
<h4><a name="phoenix:mx-operation">phoenix:mx-operation</a></h4>
<table cellpadding="3" cellspacing="2" border="1"
width="100%">
<tr class="a">
<td
>
Scope
</td>
<td
>
Applies to methods that are not getters or setters.
</td>
</tr>
<tr class="b">
<td
>
Purpose
</td>
<td
>
Marks the method as elible to be a management operation.
</td>
</tr>
<tr class="a">
<td
>
Parameters
</td>
<td
>
None
</td>
</tr>
<tr class="b">
<td
>
Notes
</td>
<td
>
The standard javadoc is used to generate descriptions for any
parameters to the
method.
</td>
</tr>
</table>
<p
>
Example:
</p>
<div id="source">
<pre>/**
* Removes the application from the container
*
* @phoenix:mx-operation
*
* @param name the name of application to remove
*/
void removeApplication( String name )</pre>
</div>
</div>
<div class="h4">
<h4><a
name="phoenix:mx-description">phoenix:mx-description</a></h4>
<table cellpadding="3" cellspacing="2" border="1"
width="100%">
<tr class="a">
<td
>
Scope
</td>
<td
>
Applies to manageable attributes and operations (i.e. to
methods that also
have the mx-operation or mx-attribute tag).
</td>
</tr>
<tr class="b">
<td
>
Purpose
</td>
<td
>
The text following the tag is a description of the method
suitable for presentation
in the management agent.
</td>
</tr>
<tr class="a">
<td
>
Parameters
</td>
<td
>
None
</td>
</tr>
<tr class="b">
<td
>
Notes
</td>
<td
>
Optional. If ommitted the javadoc definition is used.
</td>
</tr>
</table>
<p
>
Example:
</p>
<div id="source">
<pre>/**
* Retrieve a string identifying version of server.
* Usually looks like "v4.0.1a".
*
* @phoenix:mx-attribute
* @phoenix:mx-description Retrieve a string identifying version of
server.
*
* @return version string of server.
*/
String getVersion();</pre>
</div>
</div>
<div class="h4">
<h4><a name="phoenix:mx-proxy">phoenix:mx-proxy</a></h4>
<table cellpadding="3" cellspacing="2" border="1"
width="100%">
<tr class="a">
<td
>
Scope
</td>
<td
>
Applies to classes.
</td>
</tr>
<tr class="b">
<td
>
Purpose
</td>
<td
>
The proxy tag is used to indicate that a proxy class should be
used
to manage some aspect(s) of this object. At runtime, the
management
system will instantiate in instance of the proxy class passing
in
a reference to the managed object in the constructor.
Management
calls are then made on the proxy instead of the managed object.
</td>
</tr>
<tr class="a">
<td
>
Parameters
</td>
<td
>
Takes a single attribute, "name" that must be the full class
name of a class to be used
as proxy for the management of this class.
</td>
</tr>
<tr class="b">
<td
>
Notes
</td>
<td
>
At runtime it is expected the manager will instantiate the
proxy class and use
it in place of the Target object.
</td>
</tr>
</table>
<p
>
Example:
</p>
<div id="source">
<pre>/**
* Ftp server starting point. Avalon framework will load this
* from the jar file. This is also the starting point of remote
* admin.
*
* @phoenix:block
* @phoenix:service
name="org.apache.avalon.ftpserver.interfaces.FtpServerInterface"
*
* @phoenix:mx-proxy
class="org.apache.avalon.ftpserver.FtpServerMxProxy"
*
* @author Rana Bhattacharyya <[EMAIL PROTECTED]>
* @author Paul Hammant <[EMAIL PROTECTED]>
* @version 1.0
*/</pre>
</div>
</div>
</div>
<div class="h3">
<h3><a name="Build Instructions">Build Instructions</a></h3>
<p
>
To have mxinfo files generated as part as your ant build
script, include a task like that this:
</p>
<div id="source">
<pre><!-- Make .mxinfo automatically for blocks -->
<target name="phoenix-xdoclet" depends="compile">
<mkdir dir="${build.xdoclet}"/>
<taskdef name="phoenix-mxinfo"
classname="org.apache.avalon.phoenix.tools.xdoclet.PhoenixXDoclet"
classpathref="project.class.path"/>
<phoenix-mxinfo
destdir="${build.xdoclet}"
classpathref="project.class.path">
<fileset dir="${java.dir}">
<include name="**" />
</fileset>
<mxinfo/>
</phoenix-mxinfo>
</target></pre>
</div>
<p
>
Where build.xdoclet is where the .mxinfo files should be placed, and
java.dir
is the location of the source files.
</p>
<p
>
The xdoclet jars, phoenix-client.jar and log4j.jar need to be in
ant's classpath.
</p>
</div>
</div>
<div align="right" id="authors">
by <a href="[EMAIL PROTECTED]">Huw Roberts</a>
</div>
</div></td>
</tr>
</table>
<!-- FOOTER -->
<div id="footer">
<table border="0" cellspacing="0" cellpadding="4">
<tr>
<td>Copyright © 1999-2002, Apache Software Foundation</td>
</tr>
</table>
</div>
</body>
</html>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
![http://jakarta.apache.org/images/jakarta-logo.gif"](http://jakarta.apache.org/images/jakarta-logo.gif"){kind=link}