mcconnell 2003/08/23 02:53:03
Modified: merlin/merlin-platform/xdocs/starting/tutorial internal.xml
Log:
Update doc to reflect distinction between -info and -debug.
Revision Changes Path
1.3 +98 -4
avalon-sandbox/merlin/merlin-platform/xdocs/starting/tutorial/internal.xml
Index: internal.xml
===================================================================
RCS file:
/home/cvs/avalon-sandbox/merlin/merlin-platform/xdocs/starting/tutorial/internal.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- internal.xml 23 Aug 2003 02:23:30 -0000 1.2
+++ internal.xml 23 Aug 2003 09:53:03 -0000 1.3
@@ -9,15 +9,15 @@
</header>
<body>
<section name="Using Merlin">
- <subsection name="Behind the Scenes">
+ <subsection name="Behind the Scenes -info">
<p>
To get a better understanding of what is happening we can ask Merlin
to present a summary of the source information and resources used
- in our component deployment scenario using the -debug command line
+ in our component deployment scenario by including the -info command line
modifier.
</p>
<source><![CDATA[
-$ merlin -execute target\classes -debug
+$ merlin -execute target\classes -info
Version: Merlin SMP 3.0
Environment: Windows NT 4.0 Java 1.4.2
@@ -31,8 +31,11 @@
Debug Flag: true
]]></source>
+ </subsection>
+ <subsection name="Targetted debugging using -config">
+
<p>
- We can also overide the logging priority for the component using the
+ We can also override the logging priority for the component using the
a target override directive. The behind the scenes activity is
detailed under the <component-path>.appliance logging category
as shown below.
@@ -61,6 +64,11 @@
]]></source>
<p>
+ Using the debug command line parmeter generates debug level information
+ for internal kernel, containers and components.
+ </p>
+
+ <p>
The following information presents the above listing step by step.
</p>
@@ -167,10 +175,96 @@
</subsection>
+ <subsection name="Deep trace using -debug">
+
+ <p>
+ For a really deep look inside Merlin, you can select the -debug command
+ line switch.
+ </p>
+
+<source><![CDATA[
+$ merlin -execute target\classes -debug
+
+[DEBUG ] (kernel.logging): default priority: DEBUG
+[DEBUG ] (kernel.logging): adding category: kernel, null
+[DEBUG ] (kernel.context): logging system established
+[DEBUG ] (kernel.context): using bootstrap repository
+[DEBUG ] (kernel.logging): adding category: kernel, null
+[DEBUG ] (kernel.context): model factory established
+[DEBUG ] (kernel): creating root containment context
+[DEBUG ] (kernel.classloader): base: ${user.dir}
+[DEBUG ] (kernel.classloader): classpath:
+[DEBUG ] (kernel.classloader.types): type install count: 0
+[DEBUG ] (kernel): construction phase
+[DEBUG ] (kernel): install phase
+[INFO ] (kernel): installing: file:/${user.dir}/target/classes/
+[DEBUG ] (kernel): installing: tutorial
+[DEBUG ] (kernel.tutorial.classloader): base: ${user.dir}
+[DEBUG ] (kernel.tutorial): implicit entries: 1
+[DEBUG ] (kernel.tutorial): repository declarations: 1
+[DEBUG ] (kernel.tutorial): repository 0 contains 1 entries.
+[DEBUG ] (kernel.tutorial.classloader): classpath:
file:/${user.dir}/target/classes/;
+file:/F:/system/maven/repository/avalon-framework/jars/avalon-framework-impl-SNAPSHOT.jar
+[DEBUG ] (kernel.tutorial.classloader.scanner): scanning:
file:/${user.dir}/target/classes/
+[DEBUG ] (kernel.tutorial.classloader.scanner): type: tutorial.HelloComponent
+[DEBUG ] (kernel.tutorial.classloader.scanner): scanning:
+file:/F:/system/maven/repository/avalon-framework/jars/avalon-framework-impl-SNAPSHOT.jar
+[DEBUG ] (kernel.tutorial.classloader.types): type install count: 1
+[DEBUG ] (kernel.tutorial.classloader.types): registered
[type:tutorial.HelloComponent/1].
+[DEBUG ] (kernel.tutorial): installing: hello
+[DEBUG ] (kernel): customization phase
+[DEBUG ] (kernel): composition phase
+[DEBUG ] (kernel.logging): adding category: , null
+[DEBUG ] (): creating block: /tutorial
+[DEBUG ] (kernel.logging): adding category: tutorial, null
+[DEBUG ] (tutorial): creating appliance: /tutorial/hello
+[DEBUG ] (kernel.logging): adding category: tutorial.hello, null
+[DEBUG ] (kernel): assembly phase
+[DEBUG ] (): assembly phase
+[DEBUG ] (tutorial): assembly phase
+[DEBUG ] (tutorial.hello.appliance): assembly phase
+[DEBUG ] (kernel): deployment phase
+[DEBUG ] (): deployment: block:/tutorial
+[DEBUG ] (tutorial): deployment: appliance:/tutorial/hello
+[DEBUG ] (tutorial.hello.appliance): deployment (transient) [true]
+[DEBUG ] (tutorial.hello.appliance): new instance: 19627754
+[DEBUG ] (tutorial.hello.appliance): applying logger to: 19627754
+[INFO ] (tutorial.hello): logging
+[DEBUG ] (tutorial.hello.appliance): applying initialization to: 19627754
+[INFO ] (tutorial.hello): initialization
+[DEBUG ] (tutorial.hello.appliance): executing: 19627754
+[INFO ] (tutorial.hello): execution
+[DEBUG ] (tutorial.hello.appliance): component established: 19627754
+[DEBUG ] (tutorial.hello.appliance): activated instance: 19627754
+[INFO ] (kernel): decommissioning phase
+[DEBUG ] (): decommissioning: block:/tutorial
+[DEBUG ] (tutorial): decommissioning: appliance:/tutorial/hello
+[DEBUG ] (tutorial.hello.appliance): decommissioning phase
+[DEBUG ] (tutorial.hello.appliance): component disposal: 19627754
+[DEBUG ] (tutorial.hello.appliance): disposing of: 19627754
+[INFO ] (tutorial.hello): disposal
+[DEBUG ] (tutorial.hello.appliance): destroyed instance: 19627754
+[INFO ] (kernel): dissassembly phase
+[DEBUG ] (): dissassembly phase
+[DEBUG ] (tutorial): dissassembly phase
+[DEBUG ] (tutorial.hello.appliance): dissassembly phase
+[INFO ] (kernel): disposal phase
+[DEBUG ] (): disposal phase
+[DEBUG ] (tutorial): disposal phase
+[DEBUG ] (tutorial.hello.appliance): disposal
+[INFO ] (kernel): bye (1)
+]]></source>
+
+ </subsection>
+
+ <subsection name="Next Steps">
+
<p>
We are now ready to move onto the next series of tutorials dealing
with <a href="config/index.html">component configuration management</a>.
</p>
+
+ </subsection>
</section>
</body>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
