Author: jruzzi
Date: Tue Jun 21 09:56:19 2005
New Revision: 191684
URL: http://svn.apache.org/viewcvs?rev=191684&view=rev
Log:
new page
Added:
incubator/muse/trunk/src/site/content/xdocs/getting_started.xml
Added: incubator/muse/trunk/src/site/content/xdocs/getting_started.xml
URL:
http://svn.apache.org/viewcvs/incubator/muse/trunk/src/site/content/xdocs/getting_started.xml?rev=191684&view=auto
==============================================================================
--- incubator/muse/trunk/src/site/content/xdocs/getting_started.xml (added)
+++ incubator/muse/trunk/src/site/content/xdocs/getting_started.xml Tue Jun 21
09:56:19 2005
@@ -0,0 +1,60 @@
+<?xml version="1.0"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN"
+ "http://forrest.apache.org/dtd/document-v20.dtd";>
+<document>
+ <header>
+ <title>Getting Started with Apache MUSE</title>
+ </header>
+ <body>
+ <section>
+ <title>Introduction</title>
+ <p>The topics in this section detail how to install
Apache MUSE and use the quick demonstration to verify the installation as well
as exercise some of the features that are included
in the release. It is suggested that you complete these sections before
starting any development work. Once you get a
good feel for the example in the demonstration, you can recreate it by
completing the
+ <a href="site:tut">tutorial</a>.
+ </p>
+ <p>The tutorial takes a step-by-step approach to learning
Apache MUSE. It highlights the most common procedures that are used to create
+ and deploy MUWS-compliant Web services for resources.
+ </p>
+ <p>Lastly, refer to the <a href="site:dev">Developer Guide</a>
for basic and advanced tasks as well as general information about Apache
+ MUSE. Much of the information that is covered in the
demonstration and the tutorial is discussed in more detail in the Developer
Guide.
+ </p>
+ </section>
+ <section id="install">
+ <title>Installation</title>
+ <p> Apache MUSE is packaged as a Web application. In
particular, it is an Apache Axis-based Web application with
+ additional functionality that is required to implement the
MUWS specifications.</p>
+ <p>To run and install Apache MUSE, you must first:</p>
+ <ul>
+ <li>install Apache Tomcat or a similar Web
container. The documentation assumes Tomcat and refers to the Tomcat
+ home directory (e.g.,
<code>c:\jakarta-tomcat-4.1.30</code>) as <code>TOMCAT_HOME</code>. In
addition, it is assumed that Tomcat
+ is configured to listen at the default HTTP
port (8080).</li>
+ <li>install Apache Ant 1.6.X and include its
<code>bin</code> directory in the <code>PATH</code> environment variable.</li>
+ </ul>
+ <p>To install Apache MUSE:</p>
+ <ol>
+ <li>Download the Apache Muse <a
href="site:releases">binary distribution</a>.</li>
+ <li>Unzip the distribution to a location on
your computer. This location is referred to as <code>INSTALL_DIR</code>.</li>
+ <li>From <code>INSTALL_DIR</code>, copy the
<code>webapps/muse</code> directory to <code>TOMCAT_HOME/webapps</code>.</li>
+ <li>Using a browser, go to <a
href="http://localhost:8080/muse";>http://localhost:8080/muse</a>. The
Apache-Axis welcome page
+ displays.</li>
+ <li>From the Apache-Axis page, click <a
href="http://localhost:8080/muse/servlet/AxisServlet";>View</a>. The list of
deployed Web services
+ displays. Five services are deployed:
<code>filesystem</code>, <code>SubscriptionManager</code>,
<code>ResourceAdvertiser</code>,
+ <code>AdminService</code>, and
<code>Version</code>. The <code>AdminService</code> and <code>Version</code>
services are default
+ Apache-Axis services. The
<code>filesystem</code> service is a pre-deployed example and is discussed in
the
+ <a href="site:quick">Quick Demonstration</a>
section below. The <code>SubscriptionManager</code> is used to pause, resume,
destroy, or update
+ subscriptions. Lastly, the
<code>ResourceAdvertiser</code> is used to get resource properties and
subscribe to notifications.</li>
+ <li>Click on the respective WSDL links to view
and ensure that the WSDL for the services are published.</li>
+ </ol>
+ </section>
+ <section id="qd">
+ <title>Quick Demonstration</title>
+ <p>The Quick Demonstration shows some of the features
and implementation details of Apache MUSE. The demo uses an example that is
+ included in the distribution and is automatically
deployed in Apache-Axis. The example represents a UNIX file system resource
whose
+ management capabilities are exposed as a MUWS-compliant
Web service.</p>
+ <note>The <a href="site:tut">tutorial</a> provides a
step-by-step approach for exposing the management capabilities of the file
system resource. In essence, the tutorial
builds and deploys the example that is used in this demo.</note>
+ <p>Complete the following demonstration steps:</p>
+ <ol>
+ <li><strong>Perform
Operations:</strong>TODO</li>
+ </ol>
+ </section>
+ </body>
+</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
