You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@avalon.apache.org by mc...@apache.org on 2004/04/03 07:34:14 UTC
cvs commit: avalon/merlin/platform/xdocs/extensions/servlet index.xml navigation.xml
mcconnell 2004/04/02 21:34:14
Modified: merlin/platform/tutorials/meta .cvsignore
merlin/platform/xdocs/about benefits.xml
merlin/platform/xdocs/extensions index.xml navigation.xml
merlin/platform/xdocs/merlin/embedded servlet.xml
Added: merlin/platform/xdocs/extensions/facilities db.txt
finder.xml http.xml index.xml jmx.txt jndi.txt
navigation.xml
merlin/platform/xdocs/extensions/platform index.xml
navigation.xml nt.xml
merlin/platform/xdocs/reference/deployment index.xml
navigation.xml
Removed: merlin/platform/xdocs/extensions/3rdparty index.xml
navigation.xml
merlin/platform/xdocs/extensions/finder index.xml
navigation.xml
merlin/platform/xdocs/extensions/http index.xml
navigation.xml
merlin/platform/xdocs/extensions/jmx index.xml
navigation.xml
merlin/platform/xdocs/extensions/jndi index.xml
navigation.xml
merlin/platform/xdocs/extensions/persistence index.xml
navigation.xml
merlin/platform/xdocs/extensions/servlet index.xml
navigation.xml
Log:
Reshuffling and improving docs.
Revision Changes Path
1.2 +1 -1 avalon/merlin/platform/tutorials/meta/.cvsignore
Index: .cvsignore
===================================================================
RCS file: /home/cvs/avalon/merlin/platform/tutorials/meta/.cvsignore,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- .cvsignore 24 Sep 2003 09:34:04 -0000 1.1
+++ .cvsignore 3 Apr 2004 05:34:13 -0000 1.2
@@ -1,4 +1,4 @@
target
maven.log
velocity.log
-build.xml
+build.xml
\ No newline at end of file
1.5 +2 -2 avalon/merlin/platform/xdocs/about/benefits.xml
Index: benefits.xml
===================================================================
RCS file: /home/cvs/avalon/merlin/platform/xdocs/about/benefits.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- benefits.xml 3 Apr 2004 04:34:08 -0000 1.4
+++ benefits.xml 3 Apr 2004 05:34:14 -0000 1.5
@@ -22,7 +22,7 @@
<header>
<title>Avalon Assembly - Why?</title>
<authors>
- <person name="Avalon Development Team" email="avalon-dev@jakarta.apache.org"/>
+ <person name="Avalon Development Team" email="dev@avalon.apache.org"/>
</authors>
</header>
1.3 +20 -5 avalon/merlin/platform/xdocs/extensions/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/avalon/merlin/platform/xdocs/extensions/index.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- index.xml 2 Apr 2004 00:10:57 -0000 1.2
+++ index.xml 3 Apr 2004 05:34:14 -0000 1.3
@@ -21,13 +21,28 @@
<properties>
<title>JMX Extension</title>
- <author email="avalon-dev@jakarta.apache.org">Avalon Development Team</author>
+ <author email="dev@avalon.apache.org">Avalon Development Team</author>
</properties>
<body>
- <section name="Extension Facilities">
- <p>
- </p>
+ <section name="Extensions">
+ <subsection name="Index">
+ <table>
+ <tr><th>Topic</th><th>Summary</th></tr>
+ <tr>
+ <td><a href="platform/index.html">Platform Extensions</a></td>
+ <td>
+ Platform specific extensions.
+ </td>
+ </tr>
+ <tr>
+ <td><a href="facilities/index.html">Facilities</a></td>
+ <td>
+ Passive and active facilities enabling system extension.
+ </td>
+ </tr>
+ </table>
+ </subsection>
</section>
</body>
1.6 +2 -8 avalon/merlin/platform/xdocs/extensions/navigation.xml
Index: navigation.xml
===================================================================
RCS file: /home/cvs/avalon/merlin/platform/xdocs/extensions/navigation.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- navigation.xml 2 Apr 2004 00:10:57 -0000 1.5
+++ navigation.xml 3 Apr 2004 05:34:14 -0000 1.6
@@ -37,14 +37,8 @@
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Tools" href="/tools/index.html"/>
<item name="Extensions" href="/extensions/index.html">
- <item name="Finder" href="/extensions/finder/index.html"/>
- <item name="HTTP" href="/extensions/http/index.html"/>
- <item name="Servlet" href="/extensions/servlet/index.html"/>
- <item name="JMX" href="/extensions/jmx/index.html"/>
-<!--
- <item name="Persistence Facility" href="/extensions/persistence/index.html"/>
--->
- <item name="3rd Party" href="/extensions/3rdparty/index.html"/>
+ <item name="Platform" href="/extensions/platform/index.html"/>
+ <item name="Facilities" href="/extensions/facilities/index.html"/>
</item>
</menu>
1.2 +151 -6 avalon/merlin/platform/xdocs/merlin/embedded/servlet.xml
Index: servlet.xml
===================================================================
RCS file: /home/cvs/avalon/merlin/platform/xdocs/merlin/embedded/servlet.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- servlet.xml 3 Apr 2004 04:34:08 -0000 1.1
+++ servlet.xml 3 Apr 2004 05:34:14 -0000 1.2
@@ -20,21 +20,166 @@
<document>
<properties>
- <author email="mcconnell@apache.org">Stephen McConnell</author>
- <title>Specification</title>
+ <title>Merlin Servlet</title>
+ <author email="dev@avalon.apache.org">Avalon Development Team</author>
</properties>
<body>
-
<section name="Merlin Servlet">
-
- <subsection name="Overview">
+ <p>
+ The Merlin Servlet package contains an abstract Servlet implementation
+ that contains an embedded Merlin Kernel.
+ </p>
+
+ <subsection name="Development Notes">
+ <p>
+ This is a minimal implementation of a Servlet that contains an
+ embedded kernel. The behaviour is a function of the block.xml
+ resource resolved via the initialisation parameters. No support
+ is included for configuration of the kernel and as such the kernel
+ is established relative to defaults. This will be enhanced in a
+ later revision.
+ </p>
</subsection>
+ <subsection name="Example web.xml">
+ <p>
+ <i>web.xml</i>
+ </p>
+<source><![CDATA[
+<!DOCTYPE web-app
+ PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
+ "http://java.sun.com/dtd/web-app_2_3.dtd">
+
+<web-app>
+
+ <display-name>Merlin Servlet</display-name>
+
+ <description>
+ Merlin Servlet Test Page.
+ </description>
+
+ <servlet>
+ <servlet-name>merlin</servlet-name>
+ <servlet-class>org.apache.avalon.merlin.servlet.TestServlet</servlet-class>
+ <init-param>
+ <param-name>block</param-name>
+ <param-value>/BLOCK-INF/block.xml</param-value>
+ </init-param>
+ <load-on-startup>1</load-on-startup>
+ </servlet>
+</web-app>
+]]></source>
+ </subsection>
+ <subsection name="Servlet Implementation">
+ <p>
+ <i>MerlinServlet.java</i>
+ </p>
+<source>
+package org.apache.avalon.merlin.servlet;
+
+import java.io.File;
+import java.net.URL;
+import java.io.IOException;
+
+import javax.servlet.ServletException;
+import javax.servlet.ServletRequest;
+import javax.servlet.ServletResponse;
+import javax.servlet.http.HttpServlet;
+
+import org.apache.avalon.assembly.locator.DefaultLocator;
+import org.apache.avalon.merlin.kernel.Kernel;
+import org.apache.avalon.merlin.kernel.impl.DefaultKernel;
+
+/**
+ * Servlet that handles the establishment of a Merlin Kernel
+ * and registration of the kernel base URL under the servlet
+ * context using the key {@link Kernel.BASE_URL_KEY}.
+ *
+ * @author <a href="mailto:dev@avalon.apache.org">Avalon Development Team</a>
+ */
+public class MerlinServlet extends HttpServlet
+{
+ private DefaultKernel m_kernel;
+
+ /**
+ * Initializes Servlet by the web server container.
+ *
+ * @exception ServletException if an error occurs
+ */
+ public void init()
+ throws ServletException
+ {
+ try
+ {
+ ClassLoader loader = Thread.currentThread().getContextClassLoader();
+
+ String homePath = getServletContext().getRealPath( "." );
+ File home = new File( homePath );
+
+ String blockPath = getInitParameter( "block", "BLOCK-INF/block.xml" );
+ URL block = new File( home, blockPath ).toURL();
+
+ DefaultLocator context = new DefaultLocator();
+ context.put( "urn:merlin:home", home );
+ context.put( "urn:merlin:system", home );
+ context.put( "urn:merlin:classloader.common", loader );
+ context.put( "urn:merlin:classloader.system", loader );
+ context.put( "urn:merlin:debug", "WARN" );
+ context.put( "urn:merlin:logging.priority", "INFO" );
+ context.put( "urn:merlin:block.url", block );
+ context.makeReadOnly();
+
+ m_kernel = new DefaultKernel();
+ m_kernel.contextualize( context );
+ m_kernel.initialize();
+
+ getServletContext().setAttribute( Kernel.BASE_URL_KEY, m_kernel.getURL() );
+
+ log( "kernel established" );
+ }
+ catch( Exception e )
+ {
+ throw new ServletException( "Initialization error.", e );
+ }
+ }
+
+ /**
+ * Disposes of container manager and container instance.
+ */
+ public void destroy()
+ {
+ if( m_kernel != null )
+ {
+ m_kernel.shutdown();
+ m_kernel = null;
+ }
+ }
+
+ private String getInitParameter( final String name, final String defaultValue )
+ {
+ final String value = getInitParameter( name );
+ if ( null == value )
+ {
+ return defaultValue;
+ }
+ else
+ {
+ return value;
+ }
+ }
+}
+</source>
+ </subsection>
</section>
-
</body>
+ <footer>
+ <legal>
+ Copyright (c) @year@ The Avalon Apache Project All rights reserved.
+ $Revision$ $Date$
+ </legal>
+ </footer>
</document>
1.1 avalon/merlin/platform/xdocs/extensions/facilities/db.txt
Index: db.txt
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<title>HSQL Server</title>
<author email="dev@avalon.apache.org">Avalon Development Team</author>
</properties>
<body>
<section name="HSQL Server">
<p>
<strong>Status: Under Development</strong>
</p>
<p>
<strong>Since: Merlin 3.4</strong>
</p>
</section>
</body>
<footer>
<legal>
Copyright (c) @year@ The Avalon Apache Project All rights reserved.
$Revision: 1.1 $ $Date: 2004/04/03 05:34:14 $
</legal>
</footer>
</document>
1.1 avalon/merlin/platform/xdocs/extensions/facilities/finder.xml
Index: finder.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<title>Finder Facility</title>
<author email="dev@avalon.apache.org">Avalon Development Team</author>
</properties>
<body>
<section name="Finder Facility">
</section>
</body>
<footer>
<legal>
Copyright (c) @year@ The Avalon Apache Project All rights reserved.
$Revision: 1.1 $ $Date: 2004/04/03 05:34:14 $
</legal>
</footer>
</document>
1.1 avalon/merlin/platform/xdocs/extensions/facilities/http.xml
Index: http.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<title>JMX Extension</title>
<author email="dev@avalon.apache.org">Avalon Development Team</author>
</properties>
<body>
<section name="HTTP Facility">
</section>
</body>
<footer>
<legal>
Copyright (c) @year@ The Avalon Apache Project All rights reserved.
$Revision: 1.1 $ $Date: 2004/04/03 05:34:14 $
</legal>
</footer>
</document>
1.1 avalon/merlin/platform/xdocs/extensions/facilities/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<title>JMX Extension</title>
<author email="dev@avalon.apache.org">Avalon Development Team</author>
</properties>
<body>
<section name="Facilities">
<subsection name="Index">
<table>
<tr><th>Topic</th><th>Summary</th></tr>
<tr>
<td><a href="finder.html">Finder</a></td>
<td>
A facility that provides support for dynamic component
aquisition.
</td>
</tr>
<tr>
<td><a href="http.html">HTTP</a></td>
<td>
A facility that handles redirection of HTTP requests to
components.
</td>
</tr>
</table>
</subsection>
</section>
</body>
<footer>
<legal>
Copyright (c) @year@ The Avalon Apache Project All rights reserved.
$Revision: 1.1 $ $Date: 2004/04/03 05:34:14 $
</legal>
</footer>
</document>
1.1 avalon/merlin/platform/xdocs/extensions/facilities/jmx.txt
Index: jmx.txt
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<title>JMX Extension</title>
<author email="dev@avalon.apache.org">Avalon Development Team</author>
</properties>
<body>
<section name="JMX Extension">
<p>
<strong>Status: Under Development</strong>
</p>
<p>
<strong>Since: Merlin 3.4</strong>
</p>
<p>
The Merlin JMX Extension is an MX4J adapter and contains everything
needed to expose components as MBeans, as well as the JMX Agent and
a couple of connectors, such as the HttpConnector and Remote JMX
connector (JSR-160).
</p>
<p>
To enable JMX, you will need to declare the JMX Facility, as well as
enable the components to be MBeans. See the example below on how to
enable the JMX Facility. To enable the components to become MBeans,
you have a few ways to do so;
</p>
<ul>
<li>
Create a management interface which the component implements and
declare the <code>@avalon.mx interface="com.mydomain.MyMxInterface"</code>
in the component.
</li>
<li>
Create a MBeanInfo class.
</li>
</ul>
</section>
<section name="Example" >
<subsection name="Enabling the JMX Agent" >
<p>
This is done by including the JMX Agent block, typically in your
top level block.xml.
</p>
<source><![CDATA[
]]>
</source>
</subsection>
<subsection name="Making a component an MBean" >
</subsection>
</section>
</body>
<footer>
<legal>
Copyright (c) @year@ The Avalon Apache Project All rights reserved.
$Revision: 1.1 $ $Date: 2004/04/03 05:34:14 $
</legal>
</footer>
</document>
1.1 avalon/merlin/platform/xdocs/extensions/facilities/jndi.txt
Index: jndi.txt
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<title>Merlin JNDI</title>
<author email="dev@avalon.apache.org">Avalon Development Team</author>
</properties>
<body>
<section name="Merlin JNDI Connection">
<p>
<strong>Status: Under Development</strong>
</p>
<p>
<strong>Since: Merlin 3.4</strong>
</p>
<p>
The Merlin JNDI package provides support for the establishment of a
Merlin Kernel via JNDI.
</p>
<subsection name="Development Note">
<p>
This is an initial minimal JNDI connector implementation that enables
the establishment of a Merlin Kernel via JNDI. This allows
establishment and access to a Merlin kernel based on a set of
properties containing the system and home path, the root block and
internal kernel logging priority.
</p>
<p>
Using the JNDI context, a servlet can do something like the following:
</p>
<source>
Context context = new InitialContext();
Context env = (Context) context.lookup("java:comp/env");
Kernel kernel = (Kernel) env.lookup("merlin/ServiceFactory");
// then use the kernel to get the service that you want
</source>
<p>
The current implementation relies on the fact that the server.xml has
the definition of the root block to be loaded. Currently the
connector is returning the kernel, however it should be possible to
return a naming context from which services are access via JNDI
lookups. If the initial lookup returns a context then it should be
possible to eliminate knowledge of the kernel - and keep things
focussed on simply accessing services. This also brings in the
potential for including JNDI url resolution of services (i.e. service
resolution with arguments) which seems to me a desirable direction.
</p>
</subsection>
</section>
</body>
<footer>
<legal>
Copyright (c) @year@ The Avalon Apache Project All rights reserved.
$Revision: 1.1 $ $Date: 2004/04/03 05:34:14 $
</legal>
</footer>
</document>
1.1 avalon/merlin/platform/xdocs/extensions/facilities/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<project>
<title>Merlin</title>
<body>
<links>
<item name="Apache" href="http://apache.org/"/>
<item name="Avalon" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/product/framework/"/>
<item name="Containment" href="http://avalon.apache.org/product/containers/"/>
<item name="Components" href="http://avalon.apache.org/product/components/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Tools" href="/tools/index.html"/>
<item name="Extensions" href="/extensions/index.html">
<item name="Platform" href="/extensions/platform/index.html"/>
<item name="Facilities" href="/extensions/facilities/index.html">
<item name="Facilities" href="/extensions/facilities/finder.html"/>
<item name="HTTP" href="/extensions/facilities/http.html"/>
</item>
</item>
</menu>
<menu name="Resources">
<item name="Javadoc" href="/api/index.html"/>
<item name="Specification" href="/reference/index.html"/>
<item name="Download" href="/resources/download.html"/>
<item name="Roadmap" href="/resources/roadmap/index.html"/>
<item name="DPML" href="/dpml/index.html"/>
</menu>
<menu name="Related Projects">
<item name="Meta" href="http://avalon.apache.org/meta"/>
<item name="Utilities" href="http://avalon.apache.org/util"/>
<item name="Repository" href="http://avalon.apache.org/repository"/>
</menu>
</body>
</project>
1.1 avalon/merlin/platform/xdocs/extensions/platform/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<title>JMX Extension</title>
<author email="dev@avalon.apache.org">Avalon Development Team</author>
</properties>
<body>
<section name="Platform Extensions">
<subsection name="Index">
<table>
<tr><th>Topic</th><th>Summary</th></tr>
<tr>
<td><a href="nt.html">Window NT Service</a></td>
<td>
Description of the Windows NT Service.
</td>
</tr>
</table>
</subsection>
</section>
</body>
<footer>
<legal>
Copyright (c) @year@ The Avalon Apache Project All rights reserved.
$Revision: 1.1 $ $Date: 2004/04/03 05:34:14 $
</legal>
</footer>
</document>
1.1 avalon/merlin/platform/xdocs/extensions/platform/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<project>
<title>Merlin</title>
<body>
<links>
<item name="Apache" href="http://apache.org/"/>
<item name="Avalon" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/product/framework/"/>
<item name="Containment" href="http://avalon.apache.org/product/containers/"/>
<item name="Components" href="http://avalon.apache.org/product/components/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Tools" href="/tools/index.html"/>
<item name="Extensions" href="/extensions/index.html">
<item name="Platform" href="/extensions/platform/index.html">
<item name="NT Service" href="/extensions/platform/nt.html"/>
</item>
<item name="Facilities" href="/extensions/facilities/index.html"/>
</item>
</menu>
<menu name="Resources">
<item name="Javadoc" href="/api/index.html"/>
<item name="Specification" href="/reference/index.html"/>
<item name="Download" href="/resources/download.html"/>
<item name="Roadmap" href="/resources/roadmap/index.html"/>
<item name="DPML" href="/dpml/index.html"/>
</menu>
<menu name="Related Projects">
<item name="Meta" href="http://avalon.apache.org/meta"/>
<item name="Utilities" href="http://avalon.apache.org/util"/>
<item name="Repository" href="http://avalon.apache.org/repository"/>
</menu>
</body>
</project>
1.1 avalon/merlin/platform/xdocs/extensions/platform/nt.xml
Index: nt.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<header>
<title>Merlin NT</title>
<authors>
<person name="Stephen McConnell" email="mcconnell@apache.org"/>
</authors>
</header>
<body>
<section name="Merlin NT Service">
<p>
The Merlin installation includes support for the running of a Merlin Kernel as an Windows(TM) NT4 Service.
</p>
<p>
<img src="../../images/service.gif"/>
</p>
<subsection name="Service Installation">
<p>Installation of the service is achieved using the following
command:</p>
<source>
$ cd %MERLIN_HOME%\bin
$ InstallService-NT.bat
</source>
<p>
After installation please check the service startup parameters
by using the Service manager in the Windows Control Panel.
</p>
<p>
<img src="../../images/service-dialog.gif"/>
</p>
</subsection>
<subsection name="Service Configuration">
<p>Please make sure that the service is correctly assigned with
a user or system account. If you are using Merlin under the system
account you must ensure that the MERLIN_HOME environment variable
is declared in system scope. </p>
<p>
<img src="../../images/merlin-service-dialog.gif"/>
</p>
</subsection>
<subsection name="Service Removal">
<p>Deinstallation of the service is achieved using the following
command:</p>
<source>
$ cd %MERLIN_HOME%\bin
$ UninstallService-NT.bat
</source>
</subsection>
</section>
</body>
</document>
1.5 +28 -5 avalon/merlin/platform/xdocs/reference/deployment/index.xml
1.6 +7 -2 avalon/merlin/platform/xdocs/reference/deployment/navigation.xml
---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@avalon.apache.org
For additional commands, e-mail: cvs-help@avalon.apache.org