You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@river.apache.org by bu...@apache.org on 2010/12/08 12:35:43 UTC
svn commit: r780268 [2/28] - in
/websites/staging/river/trunk/content/river/docs: ./ release-notes/ specs/
specs/images/
Added: websites/staging/river/trunk/content/river/docs/build.html
==============================================================================
--- websites/staging/river/trunk/content/river/docs/build.html (added)
+++ websites/staging/river/trunk/content/river/docs/build.html Wed Dec 8 11:35:41 2010
@@ -0,0 +1,382 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+
+ <link href="/river/css/site.css" rel="stylesheet" type="text/css">
+ <link href="/river/css/type-settings.css" rel="stylesheet" type="text/css">
+
+ <title>Apache River - </title>
+
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+</head>
+<body>
+<div class="white_box">
+<div class="header">
+ <div class="header_l">
+ <div class="header_r">
+ </div>
+ </div>
+</div>
+<div class="content">
+ <div class="content_l">
+ <div class="content_r">
+ <div>
+
+<!-- Banner -->
+
+
+ <div id="header_background">
+ <div id="river_logo">
+ <a href="/river"><img src="/river/images/apache_river_v2b_small.png"/></a>
+<img src="/river/images/apache-incubator-logo.png"/>
+
+ </div>
+ </div>
+
+ <table border="0">
+ <tbody>
+ <tr>
+ <td style="overflow: hidden;" valign="top" width="100%">
+ <div class="wiki-content">
+<!--
+ ! Licensed to the Apache Software Foundation (ASF) under one
+ ! or more contributor license agreements. See the NOTICE file
+ ! distributed with this work for additional information
+ ! regarding copyright ownership. The ASF licenses this file
+ ! to you 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.
+ !-->
+<html>
+<body text="#000000" bgcolor="#ffffff" link="#9b37cc"
+ vlink="#cc1877" alink="#ffffff">
+
+<p><title>Building the Apache River Packages</title>
+<a name="TOP">
+<center><h1>Building the Apache River Packages</h1></center></p>
+<p><br>
+The Apache River distribution includes support for
+generating binary (JAR) files and documentation from the provided source code
+using the Apache Ant build tool (available from the Ant project site at
+Apache.org, <a href="http://ant.apache.org">
+ <code>http://ant.apache.org</code></a>).
+<p>
+This page describes how to use <code>ant</code> to build the distribution from
+the source code. This Ant build process was originally based on Geoff Arnold's
+Ant build script, located at <a href="http://user-garnold.jini.org">
+<code>http://user-garnold.jini.org</code> (link dead)</a>, and we thank him for his
+contribution.</p>
+<p>
+It is not necessary to build the JAR files from source code to get started with
+Jini technology. The JAR files are provided for you as part of the starter kit,
+depending on your installation options. The location of the JAR files is
+documented in <a href="info-index.html#examine">info-index.html</a> . In the
+instructions below, <B><VAR>install_dir</VAR></B> is the directory into which
+you installed the Apache River distribution.
+
+<p>
+<b>NOTE</b>:<i> Please do not attempt to build the Apache River JAR files
+without first taking referencing the
+<a href="http://developer.java.sun.com/developer/products/jini/tested.html">
+platforms on which the starter kit has been tested (link dead)</a></i>.
+
+<p>
+<hr>
+<h2>Build instructions</h2>
+
+<p>
+The following prerequisites must be met before a build can be executed:
+<ul>
+ <li>
+ The <b><code>bin</code></b> directory of the Java(TM) 2 SDK, Standard
+ Edition, v 1.4 (or later) must be in your executable search path. You can
+ obtain the Java software at <a href="http://java.sun.com">
+ <code>http://java.sun.com</code></a> .
+ </li>
+ <p>
+ <li>
+ Apache Ant, version 1.6.2 or later, must be installed on your system. You
+ can obtain the Ant software from Ant's project site at
+ <a href="http://ant.apache.org"><code>http://ant.apache.org</code></a> .
+ </li>
+ <p>
+</ul>
+
+<p>
+The following build options are currently available:
+<ul>
+ <li>
+ The <b><code>debug</code></b> parameter can be used to override the
+ default debuglevel values. The possible values are "<code>none</code>",
+ "<code>lines</code>", "<code>source</code>", and "<code>vars</code>".
+ If two or more values are used together, they must be comma-separated
+ (eg, "<code>lines,source,vars</code>"). Refer to the javac documentation
+ or the javac task section of the Ant documentation for further details
+ regarding these debuglevel options.
+ <pre>
+ ant -Ddebug=lines,source,vars <<i>target</i>>
+ </pre
+ </li>
+</ul>
+
+<p>
+To build the starter kit JAR files, you must:
+
+<pre>
+ cd <B><VAR>install_dir</VAR></B>
+
+ant <<i>target</i>>
+</pre>
+
+where the basic targets are:
+<blockquote>
+ <dl>
+ <dt>
+ <b>all.build</b><br>
+ This target is also the default target and can be invoked by simply running
+ <code>ant</code> without specifying any target. This target compiles the
+ class files for all of the distribution source code, generates Java Remote
+ Method Invocation (Java RMI) stub classes, and generates the configentry
+ files. The class files and configentry files will be placed in the following
+ directories, respectively:
+ <br><br>
+ <code><B><VAR>install_dir</VAR></B>/build/classes</code>
+ <br>
+ <code><B><VAR>install_dir</VAR></B>/build/configentry</code>
+ <br><br>
+ Additionally, this target will build all subprojects (currently 'qa' and 'examples/hello').
+ <p>
+ <dt>
+ <b>jars</b><br>
+ Creates the JAR files for the distribution, using the compiled class files.
+ The compiled class files must already have been created. The resulting JAR
+ files will be placed in the following directories:
+ <br><br>
+ <code><B><VAR>install_dir</VAR></B>/lib</code> <br>
+ <code><B><VAR>install_dir</VAR></B>/lib-dl</code> <br>
+ <code><B><VAR>install_dir</VAR></B>/lib-ext</code><br>
+ <br>
+ <b>NOTE</b>:
+ <br>
+ <i>
+ During the jars build, warning messages similar to the following are generated:
+ </i>
+ <br><br>
+ <code>[java] Nested class LogManager$Probe has different preferred state than outer class LogManager</code>
+ <br><br>
+ <i>
+ Messages of this sort are expected and pose no concern to the resulting build.
+ </i>
+
+<p>
+ <dt>
+ <b>clean</b><br>
+ Removes the class files, configentry files, docs, JAR files, and all associated
+ directories generated during the build.
+
+<p>
+ <dt>
+ <b>doc</b>
+ Generates API documentation for the starter kit, using the Javadoc(TM) tool.
+ The documentation will be placed in the following directory:
+ <br><br>
+ <code><B><VAR>install_dir</VAR></B>/doc/api</code>
+
+<p>
+ <dt>
+ <b>spec-doc</b><br>
+ Generates the specification-only documentation for the starter kit, using the Javadoc(TM) tool.
+ The documentation will be placed in the following directory:
+ <br><br>
+ <code><B><VAR>install_dir</VAR></B>/doc/specs/api</code>
+
+<p>
+ <dt>
+ <b>release</b><br>
+ This target will compile everything, generate the jar files, generate the javadoc,
+ and produce the distribution bundles (binary and source) in the top-level "dist"
+ directory.
+
+<p>
+ <dt>
+ <b>install-policy</b> and <b>uninstall-policy</b><br>
+ This target will install/uninstall jsk-policy.jar into the JVM extensions directory.
+
+</dl>
+</blockquote>
+
+<h2>Testing your Build</h2>
+<p>There are three test harnesses:
+<ul>
+ <li><b>Unit Tests:</b> The build target is <b>test</b>. JUnit testing is provided
+ because of the popularity of this Unit test framework, reducing the initial
+ learning curve for developers, enabling more developers
+ to participate.
+ </li>
+ <li><b>Regression Tests:</b> The build target is <b>jtreg</b> from the build.xml
+ file in the qa directory. Jtreg is the Regression Test framework
+ for Jini, also utilised by Sun's JRE, you'll need to download jtreg
+ separately from <a href="http://openjdk.java.net/jtreg/">openjdk.java.net/jtreg</a>
+ and ensure jtreg is available on your execution path.
+ </li>
+ <li><b>Integration and Compliance Tests:</b> The build target is <b>qa.run</b> from
+ the main build.xml file.
+ The Jini QA Test Harness, was developed by Sun, specifically to cater for testing
+ of the Jini Architecture, more information can be found in the qa directory.
+ </li>
+</ul>
+</p>
+
+<p>
+If you make any modifications and/or corrections to this build process and
+want those changes considered for use in our next release, please submit your
+modifications to <code>river-user@incubator.apache.org</code> for consideration.
+
+<p>
+<hr>
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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
+<ul>
+ <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a>
+</ul>
+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.
+
+</body>
+</html>
+ </div>
+ </td>
+ <td valign="top">
+ <div class="navigation">
+ <div class="navigation_top">
+ <div class="navigation_bottom">
+<!-- sidenav -->
+<ul>
+<li><a href="index.html">Home</a></li>
+<li><a href="news.html">News</a></li>
+</ul>
+<h3 id="community">Community</h3>
+<ul>
+<li><a href="supported-platforms.html">Supported platforms</a></li>
+<li><a href="get-involved.html">Get Involved</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0">License</a></li>
+<li><a href="downloads.html">Downloads</a></li>
+<li>Documentation<ul>
+<li><a href="http://people.apache.org/~sijskes/doc/index.html">Original Jini Wiki</a></li>
+<li><a href="user-guide-glossary.html">Glossary</a></li>
+<li><a href="documentation.html">Cookbook</a></li>
+<li><a href="javadoc.html">Javadoc</a></li>
+</ul>
+</li>
+<li><a href="success-stories.html">Success Stories</a></li>
+<li><a href="mailing-lists.html">Mailing Lists</a></li>
+<li><a href="committers.html">Committers</a></li>
+<li><a href="found-a-bug.html">Found a Bug</a>?</li>
+</ul>
+<h3 id="development">Development</h3>
+<ul>
+<li><a href="javadoc.html">Javadoc</a></li>
+<li><a href="source-code.html">Source Code</a></li>
+<li><a href="building-river.html">Building River</a></li>
+<li><a href="roadmap.html">Roadmap</a></li>
+<li><a href="development-process.html">Development Process</a></li>
+<li><a href="https://issues.apache.org/jira/browse/RIVER">Issue Tracker</a></li>
+<li><a href="http://wiki.apache.org/river/">Wiki</a></li>
+</ul>
+<h3 id="search">Search</h3>
+<DIV>
+<FORM action="http://www.google.com/search" method="get" style="font-size: 10px;">
+<INPUT name="ie" type="hidden" value="UTF-8"></INPUT>
+<INPUT name="oe" type="hidden" value="UTF-8"></INPUT>
+ <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT><BR></BR>
+ <INPUT name="btnG" type="submit" value="Search"></INPUT>
+ <INPUT name="domains" type="hidden" value="incubator.apache.org/river"></INPUT>
+ <INPUT name="sitesearch" type="hidden" value="incubator.apache.org/river"></INPUT>
+</FORM>
+</DIV>
+
+<ul>
+<li><a href="sitemap.html">Sitemap</a></li>
+</ul>
+<h3 id="the_foundation">The Foundation</h3>
+<ul>
+<li><a href="http://www.apache.org">Apache</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Sponsors</a></li>
+<li><a href="http://www.apache.org/foundation/how-it-works.html">How it works</a></li>
+<li><a href="http://incubator.apache.org/">Incubator</a></li>
+</ul>
+<!-- sidenav -->
+ </div>
+ </div>
+ </div>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+
+<!--
+ <div class="bottom_red_bar"></div>
+-->
+ </div>
+ </div>
+ </div>
+</div>
+<div class="black_box">
+<div class="footer">
+ <div class="footer_l">
+ <div class="footer_r">
+ <div>
+
+ </div>
+ </div>
+ </div>
+</div>
+</div>
+</div>
+<!--
+<div class="design_attribution">Page Template Design By Marc Prud'hommeaux based on <a href="http://activemq.apache.org/">ActiveMQ template</a></div>
+-->
+<div class="copyright_footer">
+<p>Copyright © 2010 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+</div>
+<script src="skeleton_files/urchin.js" type="text/javascript">
+</script>
+<script type="text/javascript">
+_uacct = "UA-1940143-1";
+urchinTracker();
+</script>
+
+</body></html>
Added: websites/staging/river/trunk/content/river/docs/index.html
==============================================================================
--- websites/staging/river/trunk/content/river/docs/index.html (added)
+++ websites/staging/river/trunk/content/river/docs/index.html Wed Dec 8 11:35:41 2010
@@ -0,0 +1,235 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+
+ <link href="/river/css/site.css" rel="stylesheet" type="text/css">
+ <link href="/river/css/type-settings.css" rel="stylesheet" type="text/css">
+
+ <title>Apache River - </title>
+
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+</head>
+<body>
+<div class="white_box">
+<div class="header">
+ <div class="header_l">
+ <div class="header_r">
+ </div>
+ </div>
+</div>
+<div class="content">
+ <div class="content_l">
+ <div class="content_r">
+ <div>
+
+<!-- Banner -->
+
+
+ <div id="header_background">
+ <div id="river_logo">
+ <a href="/river"><img src="/river/images/apache_river_v2b_small.png"/></a>
+<img src="/river/images/apache-incubator-logo.png"/>
+
+ </div>
+ </div>
+
+ <table border="0">
+ <tbody>
+ <tr>
+ <td style="overflow: hidden;" valign="top" width="100%">
+ <div class="wiki-content">
+<!--
+ ! Licensed to the Apache Software Foundation (ASF) under one
+ ! or more contributor license agreements. See the NOTICE file
+ ! distributed with this work for additional information
+ ! regarding copyright ownership. The ASF licenses this file
+ ! to you 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.
+ !-->
+<body text="#000000" bgcolor="#ffffff" link="#9b37cc"
+ vlink="#cc1877" alink="#ffffff">
+
+<p><title>Apache River Release Kit Index</title></p>
+<p><center><h1>Apache River Release<BR>v2.1.2</h1></center>
+<hr>
+<p>
+The Apache River release is based on the following two major contributions:
+the Jini Technology Starter Kit, and Service UI. In the documentation for this
+release, you may see historical references to those releases.</p>
+<p>
+<UL>
+<LI><B><a href="info-index.html">Getting Started & More</a></B>
+<p>
+<LI><B>Informative reading</B>
+ <ul>
+ <li><i><a href="arch2_0.html">Jini<font size="-1"><sup>TM</sup></font> Architecture Specification Version 2.0 Extensions</a></i>
+ <li><i><a href="specs/html/jini-spec.html">Jini<font size="-1"><sup>TM</sup>
+
+</font> Architecture Specification Version 1.0</a></i>
+
+</ul>
+<p>
+<LI><B><a href="release-notes/index.html">Release Notes</a></B>
+<p>
+<LI><B><a href="manpages-index.html">Manual Pages</a></B> for services, utilities, and tools
+<p>
+<LI><B><a href="spec-index.html">Specifications</a></B>
+<p>
+<LI><B>API documentation</B>
+ <UL>
+ <LI><a href="api/index.html"> Frames version</a>
+ <LI><a href="api/overview-summary.html"> No Frames version</a>
+ </UL>
+
+<p>
+
+</UL>
+<p>
+<p>
+<hr>
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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
+<ul>
+ <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a>
+</ul>
+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.
+
+</body>
+ </div>
+ </td>
+ <td valign="top">
+ <div class="navigation">
+ <div class="navigation_top">
+ <div class="navigation_bottom">
+<!-- sidenav -->
+<ul>
+<li><a href="index.html">Home</a></li>
+<li><a href="news.html">News</a></li>
+</ul>
+<h3 id="community">Community</h3>
+<ul>
+<li><a href="supported-platforms.html">Supported platforms</a></li>
+<li><a href="get-involved.html">Get Involved</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0">License</a></li>
+<li><a href="downloads.html">Downloads</a></li>
+<li>Documentation<ul>
+<li><a href="http://people.apache.org/~sijskes/doc/index.html">Original Jini Wiki</a></li>
+<li><a href="user-guide-glossary.html">Glossary</a></li>
+<li><a href="documentation.html">Cookbook</a></li>
+<li><a href="javadoc.html">Javadoc</a></li>
+</ul>
+</li>
+<li><a href="success-stories.html">Success Stories</a></li>
+<li><a href="mailing-lists.html">Mailing Lists</a></li>
+<li><a href="committers.html">Committers</a></li>
+<li><a href="found-a-bug.html">Found a Bug</a>?</li>
+</ul>
+<h3 id="development">Development</h3>
+<ul>
+<li><a href="javadoc.html">Javadoc</a></li>
+<li><a href="source-code.html">Source Code</a></li>
+<li><a href="building-river.html">Building River</a></li>
+<li><a href="roadmap.html">Roadmap</a></li>
+<li><a href="development-process.html">Development Process</a></li>
+<li><a href="https://issues.apache.org/jira/browse/RIVER">Issue Tracker</a></li>
+<li><a href="http://wiki.apache.org/river/">Wiki</a></li>
+</ul>
+<h3 id="search">Search</h3>
+<DIV>
+<FORM action="http://www.google.com/search" method="get" style="font-size: 10px;">
+<INPUT name="ie" type="hidden" value="UTF-8"></INPUT>
+<INPUT name="oe" type="hidden" value="UTF-8"></INPUT>
+ <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT><BR></BR>
+ <INPUT name="btnG" type="submit" value="Search"></INPUT>
+ <INPUT name="domains" type="hidden" value="incubator.apache.org/river"></INPUT>
+ <INPUT name="sitesearch" type="hidden" value="incubator.apache.org/river"></INPUT>
+</FORM>
+</DIV>
+
+<ul>
+<li><a href="sitemap.html">Sitemap</a></li>
+</ul>
+<h3 id="the_foundation">The Foundation</h3>
+<ul>
+<li><a href="http://www.apache.org">Apache</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Sponsors</a></li>
+<li><a href="http://www.apache.org/foundation/how-it-works.html">How it works</a></li>
+<li><a href="http://incubator.apache.org/">Incubator</a></li>
+</ul>
+<!-- sidenav -->
+ </div>
+ </div>
+ </div>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+
+<!--
+ <div class="bottom_red_bar"></div>
+-->
+ </div>
+ </div>
+ </div>
+</div>
+<div class="black_box">
+<div class="footer">
+ <div class="footer_l">
+ <div class="footer_r">
+ <div>
+
+ </div>
+ </div>
+ </div>
+</div>
+</div>
+</div>
+<!--
+<div class="design_attribution">Page Template Design By Marc Prud'hommeaux based on <a href="http://activemq.apache.org/">ActiveMQ template</a></div>
+-->
+<div class="copyright_footer">
+<p>Copyright © 2010 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+</div>
+<script src="skeleton_files/urchin.js" type="text/javascript">
+</script>
+<script type="text/javascript">
+_uacct = "UA-1940143-1";
+urchinTracker();
+</script>
+
+</body></html>
Added: websites/staging/river/trunk/content/river/docs/info-index.html
==============================================================================
--- websites/staging/river/trunk/content/river/docs/info-index.html (added)
+++ websites/staging/river/trunk/content/river/docs/info-index.html Wed Dec 8 11:35:41 2010
@@ -0,0 +1,348 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+
+ <link href="/river/css/site.css" rel="stylesheet" type="text/css">
+ <link href="/river/css/type-settings.css" rel="stylesheet" type="text/css">
+
+ <title>Apache River - </title>
+
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+</head>
+<body>
+<div class="white_box">
+<div class="header">
+ <div class="header_l">
+ <div class="header_r">
+ </div>
+ </div>
+</div>
+<div class="content">
+ <div class="content_l">
+ <div class="content_r">
+ <div>
+
+<!-- Banner -->
+
+
+ <div id="header_background">
+ <div id="river_logo">
+ <a href="/river"><img src="/river/images/apache_river_v2b_small.png"/></a>
+<img src="/river/images/apache-incubator-logo.png"/>
+
+ </div>
+ </div>
+
+ <table border="0">
+ <tbody>
+ <tr>
+ <td style="overflow: hidden;" valign="top" width="100%">
+ <div class="wiki-content">
+<!--
+ ! Licensed to the Apache Software Foundation (ASF) under one
+ ! or more contributor license agreements. See the NOTICE file
+ ! distributed with this work for additional information
+ ! regarding copyright ownership. The ASF licenses this file
+ ! to you 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.
+ !-->
+<body text="#000000" bgcolor="#ffffff" link="#9b37cc"
+ vlink="#cc1877" alink="#ffffff">
+
+<p><title>Apache River Release Getting Started & More</title></p>
+<p><center><h1>Apache River Release<BR>Getting Started & More with v2.1.2</h1></center>
+<UL><UL>
+ <LI><a href="#examine">Examining the distribution</a>
+ <LI><a href="#install">Installing the <code>jsk-policy.jar</code> file</a>
+ <LI><a href="#example">Example program documentation</a>
+ <LI><a href="#build">Building from the source code</a>
+ <LI><a href="#background">Background Material</a>
+ <LI><a href="#help">Getting Help</a>
+ <LI><a href="#license">Apache River Release License</a><br />
+</UL></UL></p>
+<p><hr>
+<UL>
+<p>
+<a name="examine"><LI><B>Examining the Distribution</B></LI></a>
+<p>
+Once you have unarchived this release, your installation folder
+should contain most if not all of the following items.
+<p>
+<blockquote> <br />
+ <dl>
+ <dt><b>DISCLAIMER</b><dd>
+ The disclaimer regarding the fact that this project is currently under incubation at The Apache Software Foundation.
+ <dt><b>LICENSE</b><dd>
+ The Apache License.
+ <dt><b>NOTICE</b><dd>
+ The file containing contributor acknowledgments.
+ <dt><b>configentry</b><dd>
+ The directory that contains configuration entry description files
+ for all of the River services and utilities
+ <dt><b>doc</b><dd>
+ The directory that contains specifications, API documentation,
+ manual pages, release notes, license information, and other documentation
+ <dt><b>lib</b><dd>
+ The directory where the non-download JAR files are located
+ <dt><b>lib-dl</b><dd>
+ The directory where the download JAR files for the services are located
+ <dt><b>lib-ext</b><dd>
+ The directory where the dynamic security policy provider is located
+ <dt><b>src</b><dd>
+ The directory where source code may be located if installed via the separate source release, which is only available as a separate download.
+ <dt><b>examples/hello</b><dd>
+ The directory where the Hello example is located
+</dl>
+</blockquote></p>
+<!---------------------------------->
+
+<p><a name="install"><LI><B>Installing the <code>jsk-policy.jar</code> file</B></LI></a>
+<p>
+This release includes a security policy provider which supports dynamic
+granting of permissions at run-time. Although use of this policy provider
+is not required, its use is highly recommended when deploying secure
+applications and services. To permit effective use of this policy provider,
+it must first be installed as an extension in the Java 2 SDK (or JRE)
+that you will be using. Note that installing this provider does not
+automatically cause it to be used, and its installation should not alter
+the operation of existing applications.</p>
+<p> To install this policy provider, providing you didn't do so during your initial installation,
+you must copy the <code>jsk-policy.jar</code> file from the <code>lib-ext</code>
+subdirectory of your Apache River release installation to
+the extensions directory of your Java(TM) 2 SDK (or JRE) installation.
+
+<p> An alternative to copying <code>jsk-policy.jar</code> to the extension directory is
+to use the system property <code>java.ext.dirs</code>. This property specifies one or
+more directories to search for extensions, each separated by <code>File.pathSeparatorChar</code>.
+To use <code>jsk-policy.jar</code> in this manner, the system property
+must be set to include both the path to the Java 2 JRE extension directory
+(or directories) and the path to the <code>lib-ext</code> subdirectory of
+your Apache River release installation.
+Note that in Java(TM) 2 Standard Edition (J2SE(TM)) 1.4, only the original extension directory
+is granted permissions via the system policy file, so you will have to explicitly grant
+permissions to <code>jsk-policy.jar</code> in your own policy files. In J2SE 5.0, all the
+directories specified in <code>java.ext.dirs</code> are granted permissions so the explicit
+permission grant is not needed.
+
+<!---------------------------------->
+<p>
+<a name="example"><LI><B>Example program documentation</B></a>
+<p>
+ <ul>
+ <li>The hello example is included in both the source and binary releases.
+ Once the release is downloaded and unarchived,
+ the example documentation will be located:
+ <p>
+ <install_dir>/examples/hello/index.html
+
+<li>Additional examples may be found at
+ <a href="http://starterkit-examples.jini.org">starterkit-examples.jini.org (link dead)</a>.
+ </li>
+ </ul>
+<p>
+<a name="build"><LI><B>Building from the source code</B></a>
+<p>
+ <UL>
+ <LI>The binaries can be build from the source code, which is available as a
+ separate download. If you wish to build the source code, you will need to
+ download the source release, unarchive it, and refer to the build instructions,
+ located:
+ <p>
+ <a href="build.html"><install_dir>/doc/build.html</a>
+ </UL
+<p>
+<a name="background"><LI><B>Background Material</B></a>
+<p>
+ <UL>
+ <LI><a href="release-notes/activation.html">Notes on Java(TM) RMI Activation and
+ How it is Used in the Apache River release</a>
+ <LI><a href="release-notes/execpolicy.html">Security Requirements on Activation
+ Group Descriptors used with <code>phoenix</code> or <code>rmid</code></a>
+ <LI><a href="release-notes/evseqnums.html">Note on JavaSpaces Technology,
+ Persistent Outrigger Services, and Event Sequence Numbers</a>
+ <LI><a href= "specs/html/devicearch-spec.html">Device Architecture</a>
+ </UL>
+<p>
+<a name="help"><LI><B>Getting Help</B></a>
+<p>
+ <UL>
+ <LI>There are a number of additional great resources (besides the
+ <a href="http://incubator.apache.org/river">Apache River project</a>)
+ to get information on River technology. Two places are:
+ <a href="http://www.jini.org">Jini.org</a>, a community site with news
+ and information, and <a href="https://jini.dev.java.net">the Jini Community
+ area on Java.net</a>, where there are projects and information.</LI>
+ <p>
+ <LI>The best place to discuss things about the Apache River project right
+ now is on the developer mail list (river-dev). You can subscribe or view the
+ archives from the project <a href="http://incubator.apache.org/river/mailing.html">
+ mailing lists</a> page. In addition, the river-user mailing
+ list is a resource to find out more about general use of River technology and
+ JavaSpaces technology. <a href="http://incubator.apache.org/river/RIVER/mailing-lists.html">Search
+ or Join</a> those lists to get involved.</LI>
+ <p>
+ <LI>Search the archives<br>
+ If you would like to view past threads on the old Jini/Javaspaces mailing lists, you may go to
+ <a href="http://archives.java.sun.com/archives/jini-users.html">
+ http://archives.java.sun.com/archives/jini-users.html</a>, or
+ <a href="http://archives.java.sun.com/archives/javaspaces-users.html">
+ http://archives.java.sun.com/archives/javaspaces-users.html</a>
+ <p>
+ <LI><a href="https://issues.apache.org/jira/secure/CreateIssue!default.jspa?pid=12310600">Submit<a> a bug or RFE
+ </UL>
+ <p>
+
+<p>
+<a name="license"></a><LI><B>Apache River Release License</B>
+<p>
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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
+<ul>
+ <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a>
+</ul>
+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.
+
+</UL>
+<p>
+<p>
+
+</body>
+</html>
+ </div>
+ </td>
+ <td valign="top">
+ <div class="navigation">
+ <div class="navigation_top">
+ <div class="navigation_bottom">
+<!-- sidenav -->
+<ul>
+<li><a href="index.html">Home</a></li>
+<li><a href="news.html">News</a></li>
+</ul>
+<h3 id="community">Community</h3>
+<ul>
+<li><a href="supported-platforms.html">Supported platforms</a></li>
+<li><a href="get-involved.html">Get Involved</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0">License</a></li>
+<li><a href="downloads.html">Downloads</a></li>
+<li>Documentation<ul>
+<li><a href="http://people.apache.org/~sijskes/doc/index.html">Original Jini Wiki</a></li>
+<li><a href="user-guide-glossary.html">Glossary</a></li>
+<li><a href="documentation.html">Cookbook</a></li>
+<li><a href="javadoc.html">Javadoc</a></li>
+</ul>
+</li>
+<li><a href="success-stories.html">Success Stories</a></li>
+<li><a href="mailing-lists.html">Mailing Lists</a></li>
+<li><a href="committers.html">Committers</a></li>
+<li><a href="found-a-bug.html">Found a Bug</a>?</li>
+</ul>
+<h3 id="development">Development</h3>
+<ul>
+<li><a href="javadoc.html">Javadoc</a></li>
+<li><a href="source-code.html">Source Code</a></li>
+<li><a href="building-river.html">Building River</a></li>
+<li><a href="roadmap.html">Roadmap</a></li>
+<li><a href="development-process.html">Development Process</a></li>
+<li><a href="https://issues.apache.org/jira/browse/RIVER">Issue Tracker</a></li>
+<li><a href="http://wiki.apache.org/river/">Wiki</a></li>
+</ul>
+<h3 id="search">Search</h3>
+<DIV>
+<FORM action="http://www.google.com/search" method="get" style="font-size: 10px;">
+<INPUT name="ie" type="hidden" value="UTF-8"></INPUT>
+<INPUT name="oe" type="hidden" value="UTF-8"></INPUT>
+ <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT><BR></BR>
+ <INPUT name="btnG" type="submit" value="Search"></INPUT>
+ <INPUT name="domains" type="hidden" value="incubator.apache.org/river"></INPUT>
+ <INPUT name="sitesearch" type="hidden" value="incubator.apache.org/river"></INPUT>
+</FORM>
+</DIV>
+
+<ul>
+<li><a href="sitemap.html">Sitemap</a></li>
+</ul>
+<h3 id="the_foundation">The Foundation</h3>
+<ul>
+<li><a href="http://www.apache.org">Apache</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Sponsors</a></li>
+<li><a href="http://www.apache.org/foundation/how-it-works.html">How it works</a></li>
+<li><a href="http://incubator.apache.org/">Incubator</a></li>
+</ul>
+<!-- sidenav -->
+ </div>
+ </div>
+ </div>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+
+<!--
+ <div class="bottom_red_bar"></div>
+-->
+ </div>
+ </div>
+ </div>
+</div>
+<div class="black_box">
+<div class="footer">
+ <div class="footer_l">
+ <div class="footer_r">
+ <div>
+
+ </div>
+ </div>
+ </div>
+</div>
+</div>
+</div>
+<!--
+<div class="design_attribution">Page Template Design By Marc Prud'hommeaux based on <a href="http://activemq.apache.org/">ActiveMQ template</a></div>
+-->
+<div class="copyright_footer">
+<p>Copyright © 2010 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+</div>
+<script src="skeleton_files/urchin.js" type="text/javascript">
+</script>
+<script type="text/javascript">
+_uacct = "UA-1940143-1";
+urchinTracker();
+</script>
+
+</body></html>
Added: websites/staging/river/trunk/content/river/docs/manpages-index.html
==============================================================================
--- websites/staging/river/trunk/content/river/docs/manpages-index.html (added)
+++ websites/staging/river/trunk/content/river/docs/manpages-index.html Wed Dec 8 11:35:41 2010
@@ -0,0 +1,305 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+
+ <link href="/river/css/site.css" rel="stylesheet" type="text/css">
+ <link href="/river/css/type-settings.css" rel="stylesheet" type="text/css">
+
+ <title>Apache River - </title>
+
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+</head>
+<body>
+<div class="white_box">
+<div class="header">
+ <div class="header_l">
+ <div class="header_r">
+ </div>
+ </div>
+</div>
+<div class="content">
+ <div class="content_l">
+ <div class="content_r">
+ <div>
+
+<!-- Banner -->
+
+
+ <div id="header_background">
+ <div id="river_logo">
+ <a href="/river"><img src="/river/images/apache_river_v2b_small.png"/></a>
+<img src="/river/images/apache-incubator-logo.png"/>
+
+ </div>
+ </div>
+
+ <table border="0">
+ <tbody>
+ <tr>
+ <td style="overflow: hidden;" valign="top" width="100%">
+ <div class="wiki-content">
+<!--
+ ! Licensed to the Apache Software Foundation (ASF) under one
+ ! or more contributor license agreements. See the NOTICE file
+ ! distributed with this work for additional information
+ ! regarding copyright ownership. The ASF licenses this file
+ ! to you 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.
+ !-->
+<title>Apache River Release Manual Pages</title>
+
+<body text="#000000" bgcolor="#ffffff" link="#9b37cc"
+ vlink="#cc1877" alink="#ffffff">
+
+<h1><center>Apache River Release
+<br>v2.1.2 Manual Pages</center></h1>
+
+<br>
+
+<p><hr>
+A set of "manual pages" has been written to assist you in executing the
+<a href="#services">services</a>, <a href="#utilities">utilities</a>, and
+<a href="#tools">tools</a> that are part of the Apache River release.
+These package.html or class.html files provide implementation
+specifics for services, utilities, and tools.
+<ul><a name="services"></a>
+<H2>Services</H2>
+<ul>
+ <li><a href="api/com/sun/jini/fiddler/package-summary.html">
+ Fiddler</a> - a River lookup discovery service</p>
+<div class="codehilite"><pre><span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"api/com/sun/jini/mahalo/package-summary.html"</span><span class="nt">></span>
+Mahalo<span class="nt"></a></span> - a River transaction manager service
+
+<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"api/com/sun/jini/mercury/package-summary.html"</span><span class="nt">></span>
+Mercury<span class="nt"></a></span> - a River event mailbox service
+
+<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"api/com/sun/jini/norm/package-summary.html"</span><span class="nt">></span>
+Norm<span class="nt"></a></span> - a River lease renewal service
+
+<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"api/com/sun/jini/outrigger/package-summary.html"</span><span class="nt">></span>
+Outrigger<span class="nt"></a></span> - a JavaSpaces service
+
+<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"api/com/sun/jini/phoenix/package-summary.html"</span><span class="nt">></span>
+Phoenix<span class="nt"></a></span> - a configurable Java RMI activation system daemon
+
+<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"api/com/sun/jini/reggie/package-summary.html"</span><span class="nt">></span>
+Reggie<span class="nt"></a></span> - a River lookup service
+</pre></div>
+
+
+<p>
+</ul><a name="utilities"></a>
+<H2>Utilities</H2>
+<ul>
+ <li><a href="api/net/jini/lookup/JoinManager.html">
+ JoinManager</a> - performs all of the functions related to discovery,
+ joining, service lease renewal, and attribute management required of a
+ well-behaved service
+
+<li><a href="api/net/jini/lease/LeaseRenewalManager.html">
+ LeaseRenewalManager</a> - provides for the systematic renewal and overall
+ management of a set of leases associated with one or more remote entities
+ on behalf of a local entity
+
+<li><a href="api/net/jini/discovery/LookupDiscovery.html">
+ LookupDiscovery</a> - helps make the process of acquiring references
+ to lookup services much simpler for both services and clients
+
+<li><a href="api/net/jini/discovery/LookupDiscoveryManager.html">
+ LookupDiscoveryManager</a> - organizes and manages all discovery-related
+ activities on behalf of a client or service
+
+<li><a href="api/net/jini/discovery/LookupLocatorDiscovery.html">
+ LookupLocatorDiscovery</a> - provides an implementation that makes the
+ process of finding specific lookup services much simpler for both
+ services and clients
+
+<li><a href="api/net/jini/lookup/ServiceDiscoveryManager.html">
+ ServiceDiscoveryManager</a> - "discovers" services registered with any
+ number of lookup services of interest for any client-like entity
+<p>
+</ul><a name="tools"></a>
+<H2>Tools</H2>
+<ul>
+<li><a href="api/com/sun/jini/example/browser/package-summary.html">
+ Browser</a> - discovers lookup services and inspects the various
+ services registered within those lookup services
+
+<li><a href="api/com/sun/jini/tool/CheckConfigurationFile.html">
+ CheckConfigurationFile</a> - checks the format of the source for a <code> ConfigurationFile</code>
+
+<li><a href="api/com/sun/jini/tool/ClassDep.html">
+ ClassDep</a> - analyzes a set of classes and determines on what other classes they directly or indirectly depend
+
+<li><a href="api/com/sun/jini/tool/ClassServer.html">
+ ClassServer</a> - creates an HTTP server from the command line
+
+<li><a href="api/com/sun/jini/tool/ComputeDigest.html">
+ ComputeDigest</a> - prints the message digest for the contents of a URL
+
+<li><a href="api/com/sun/jini/tool/ComputeHttpmdCodebase.html">
+ ComputeHttpmdCodebase</a> - computes the message digests for a codebase with HTTPMD URLs
+
+<li><a href="api/com/sun/jini/tool/envcheck/EnvCheck.html">
+ EnvCheck</a> - examines the run-time environment of a River client or service
+
+<li><a href="api/com/sun/jini/tool/JarWrapper.html">
+ JarWrapper</a> - generates "wrapper" JAR files
+
+<li><a href="api/com/sun/jini/tool/PreferredListGen.html">
+ PreferredListGen</a> - analyzes the contents of a JAR file and generates a preferred list
+
+<li><a href="api/com/sun/jini/start/package-summary.html">
+ ServiceStarter</a> - provides static methods used for starting shared
+ groups, transient services, and activatable services
+
+</ul></ul>
+
+<hr>
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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
+<ul>
+ <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a>
+</ul>
+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.
+
+</body>
+</html>
+ </div>
+ </td>
+ <td valign="top">
+ <div class="navigation">
+ <div class="navigation_top">
+ <div class="navigation_bottom">
+<!-- sidenav -->
+<ul>
+<li><a href="index.html">Home</a></li>
+<li><a href="news.html">News</a></li>
+</ul>
+<h3 id="community">Community</h3>
+<ul>
+<li><a href="supported-platforms.html">Supported platforms</a></li>
+<li><a href="get-involved.html">Get Involved</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0">License</a></li>
+<li><a href="downloads.html">Downloads</a></li>
+<li>Documentation<ul>
+<li><a href="http://people.apache.org/~sijskes/doc/index.html">Original Jini Wiki</a></li>
+<li><a href="user-guide-glossary.html">Glossary</a></li>
+<li><a href="documentation.html">Cookbook</a></li>
+<li><a href="javadoc.html">Javadoc</a></li>
+</ul>
+</li>
+<li><a href="success-stories.html">Success Stories</a></li>
+<li><a href="mailing-lists.html">Mailing Lists</a></li>
+<li><a href="committers.html">Committers</a></li>
+<li><a href="found-a-bug.html">Found a Bug</a>?</li>
+</ul>
+<h3 id="development">Development</h3>
+<ul>
+<li><a href="javadoc.html">Javadoc</a></li>
+<li><a href="source-code.html">Source Code</a></li>
+<li><a href="building-river.html">Building River</a></li>
+<li><a href="roadmap.html">Roadmap</a></li>
+<li><a href="development-process.html">Development Process</a></li>
+<li><a href="https://issues.apache.org/jira/browse/RIVER">Issue Tracker</a></li>
+<li><a href="http://wiki.apache.org/river/">Wiki</a></li>
+</ul>
+<h3 id="search">Search</h3>
+<DIV>
+<FORM action="http://www.google.com/search" method="get" style="font-size: 10px;">
+<INPUT name="ie" type="hidden" value="UTF-8"></INPUT>
+<INPUT name="oe" type="hidden" value="UTF-8"></INPUT>
+ <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT><BR></BR>
+ <INPUT name="btnG" type="submit" value="Search"></INPUT>
+ <INPUT name="domains" type="hidden" value="incubator.apache.org/river"></INPUT>
+ <INPUT name="sitesearch" type="hidden" value="incubator.apache.org/river"></INPUT>
+</FORM>
+</DIV>
+
+<ul>
+<li><a href="sitemap.html">Sitemap</a></li>
+</ul>
+<h3 id="the_foundation">The Foundation</h3>
+<ul>
+<li><a href="http://www.apache.org">Apache</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Sponsors</a></li>
+<li><a href="http://www.apache.org/foundation/how-it-works.html">How it works</a></li>
+<li><a href="http://incubator.apache.org/">Incubator</a></li>
+</ul>
+<!-- sidenav -->
+ </div>
+ </div>
+ </div>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+
+<!--
+ <div class="bottom_red_bar"></div>
+-->
+ </div>
+ </div>
+ </div>
+</div>
+<div class="black_box">
+<div class="footer">
+ <div class="footer_l">
+ <div class="footer_r">
+ <div>
+
+ </div>
+ </div>
+ </div>
+</div>
+</div>
+</div>
+<!--
+<div class="design_attribution">Page Template Design By Marc Prud'hommeaux based on <a href="http://activemq.apache.org/">ActiveMQ template</a></div>
+-->
+<div class="copyright_footer">
+<p>Copyright © 2010 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+</div>
+<script src="skeleton_files/urchin.js" type="text/javascript">
+</script>
+<script type="text/javascript">
+_uacct = "UA-1940143-1";
+urchinTracker();
+</script>
+
+</body></html>
Added: websites/staging/river/trunk/content/river/docs/proxypreparation.pdf
==============================================================================
Files websites/staging/river/trunk/content/river/docs/proxypreparation.pdf (added) and websites/staging/river/trunk/content/river/docs/proxypreparation.pdf Wed Dec 8 11:35:41 2010 differ
Added: websites/staging/river/trunk/content/river/docs/release-notes/activate.html
==============================================================================
--- websites/staging/river/trunk/content/river/docs/release-notes/activate.html (added)
+++ websites/staging/river/trunk/content/river/docs/release-notes/activate.html Wed Dec 8 11:35:41 2010
@@ -0,0 +1,256 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+
+ <link href="/river/css/site.css" rel="stylesheet" type="text/css">
+ <link href="/river/css/type-settings.css" rel="stylesheet" type="text/css">
+
+ <title>Apache River - </title>
+
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+</head>
+<body>
+<div class="white_box">
+<div class="header">
+ <div class="header_l">
+ <div class="header_r">
+ </div>
+ </div>
+</div>
+<div class="content">
+ <div class="content_l">
+ <div class="content_r">
+ <div>
+
+<!-- Banner -->
+
+
+ <div id="header_background">
+ <div id="river_logo">
+ <a href="/river"><img src="/river/images/apache_river_v2b_small.png"/></a>
+<img src="/river/images/apache-incubator-logo.png"/>
+
+ </div>
+ </div>
+
+ <table border="0">
+ <tbody>
+ <tr>
+ <td style="overflow: hidden;" valign="top" width="100%">
+ <div class="wiki-content">
+<!--
+ ! Licensed to the Apache Software Foundation (ASF) under one
+ ! or more contributor license agreements. See the NOTICE file
+ ! distributed with this work for additional information
+ ! regarding copyright ownership. The ASF licenses this file
+ ! to you 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.
+ !-->
+<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
+<html>
+
+<p><body text="#000000" bgcolor="#ffffff" link="#9b37cc"
+ vlink="#cc1877" alink="#ffffff">
+<a name="top">
+<title>Release Notes for net.jini.activation</title></p>
+<p><center>
+<h1><code>net.jini.activation</code><br>
+Apache River v2.1.2 Release Notes</h1>
+</center>
+<HR>
+<UL>
+<H3>Description</H3></p>
+<p>The <a href="../api/net/jini/activation/package-summary.html">
+<code>net.jini.activation</code></a> package provides extensions to the
+Java(TM) Remote Method Invocation (Java RMI) activation framework.
+
+<H3>Changes since the v2.1.1 release</H3>
+
+<dl>
+
+<dt><b>None</b></dt>
+
+</dl>
+
+<H3>Changes since the v2.0.1 release</H3>
+
+<dl>
+
+<dt><b>Disabled permission propagation</b></dt>
+<dd>
+<p><a href="../api/net/jini/activation/ActivatableInvocationHandler.html">
+<code>ActivatableInvocationHandler</code></a> by default no longer attempts
+to propagate dynamic permission grants from the dynamic proxy to the
+underlying activation identifier. If this functionality is required, it can
+be enabled by setting the
+<code>com.sun.jini.activation.enableActivateGrant</code> system property to
+<code>true</code>. If the
+<a href="../api/net/jini/activation/package-summary.html">
+<code>phoenix</code></a> activator has been configured
+to allow anonymous client activation requests, and the invocation
+constraints on the underlying activation identifier have been configured
+to allow anonymous activation calls, it is not necessary to enable this.
+That should be the preferred configuration. However, if the activator has
+been configured to use Kerberos authentication, then anonymous calls are
+not supported, and you will either have to enable the activate grant in
+clients and dynamically grant sufficient
+<a href="../api/net/jini/security/AuthenticationPermission.html">
+<code>AuthenticationPermission</code></a> and
+<a href="../api/net/jini/security/GrantPermission.html">
+<code>GrantPermission</code></a> to the proxy to permit activation calls
+to succeed, or else statically grant sufficient
+<code>AuthenticationPermission</code> to downloaded code in clients
+to permit activation calls to succeed.
+</dd>
+
+</dl>
+
+</ul>
+<hr>
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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
+<ul>
+ <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a>
+</ul>
+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.
+
+</body>
+</html>
+ </div>
+ </td>
+ <td valign="top">
+ <div class="navigation">
+ <div class="navigation_top">
+ <div class="navigation_bottom">
+<!-- sidenav -->
+<ul>
+<li><a href="index.html">Home</a></li>
+<li><a href="news.html">News</a></li>
+</ul>
+<h3 id="community">Community</h3>
+<ul>
+<li><a href="supported-platforms.html">Supported platforms</a></li>
+<li><a href="get-involved.html">Get Involved</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0">License</a></li>
+<li><a href="downloads.html">Downloads</a></li>
+<li>Documentation<ul>
+<li><a href="http://people.apache.org/~sijskes/doc/index.html">Original Jini Wiki</a></li>
+<li><a href="user-guide-glossary.html">Glossary</a></li>
+<li><a href="documentation.html">Cookbook</a></li>
+<li><a href="javadoc.html">Javadoc</a></li>
+</ul>
+</li>
+<li><a href="success-stories.html">Success Stories</a></li>
+<li><a href="mailing-lists.html">Mailing Lists</a></li>
+<li><a href="committers.html">Committers</a></li>
+<li><a href="found-a-bug.html">Found a Bug</a>?</li>
+</ul>
+<h3 id="development">Development</h3>
+<ul>
+<li><a href="javadoc.html">Javadoc</a></li>
+<li><a href="source-code.html">Source Code</a></li>
+<li><a href="building-river.html">Building River</a></li>
+<li><a href="roadmap.html">Roadmap</a></li>
+<li><a href="development-process.html">Development Process</a></li>
+<li><a href="https://issues.apache.org/jira/browse/RIVER">Issue Tracker</a></li>
+<li><a href="http://wiki.apache.org/river/">Wiki</a></li>
+</ul>
+<h3 id="search">Search</h3>
+<DIV>
+<FORM action="http://www.google.com/search" method="get" style="font-size: 10px;">
+<INPUT name="ie" type="hidden" value="UTF-8"></INPUT>
+<INPUT name="oe" type="hidden" value="UTF-8"></INPUT>
+ <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT><BR></BR>
+ <INPUT name="btnG" type="submit" value="Search"></INPUT>
+ <INPUT name="domains" type="hidden" value="incubator.apache.org/river"></INPUT>
+ <INPUT name="sitesearch" type="hidden" value="incubator.apache.org/river"></INPUT>
+</FORM>
+</DIV>
+
+<ul>
+<li><a href="sitemap.html">Sitemap</a></li>
+</ul>
+<h3 id="the_foundation">The Foundation</h3>
+<ul>
+<li><a href="http://www.apache.org">Apache</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Sponsors</a></li>
+<li><a href="http://www.apache.org/foundation/how-it-works.html">How it works</a></li>
+<li><a href="http://incubator.apache.org/">Incubator</a></li>
+</ul>
+<!-- sidenav -->
+ </div>
+ </div>
+ </div>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+
+<!--
+ <div class="bottom_red_bar"></div>
+-->
+ </div>
+ </div>
+ </div>
+</div>
+<div class="black_box">
+<div class="footer">
+ <div class="footer_l">
+ <div class="footer_r">
+ <div>
+
+ </div>
+ </div>
+ </div>
+</div>
+</div>
+</div>
+<!--
+<div class="design_attribution">Page Template Design By Marc Prud'hommeaux based on <a href="http://activemq.apache.org/">ActiveMQ template</a></div>
+-->
+<div class="copyright_footer">
+<p>Copyright © 2010 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+</div>
+<script src="skeleton_files/urchin.js" type="text/javascript">
+</script>
+<script type="text/javascript">
+_uacct = "UA-1940143-1";
+urchinTracker();
+</script>
+
+</body></html>
Added: websites/staging/river/trunk/content/river/docs/release-notes/activation.html
==============================================================================
--- websites/staging/river/trunk/content/river/docs/release-notes/activation.html (added)
+++ websites/staging/river/trunk/content/river/docs/release-notes/activation.html Wed Dec 8 11:35:41 2010
@@ -0,0 +1,486 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+
+ <link href="/river/css/site.css" rel="stylesheet" type="text/css">
+ <link href="/river/css/type-settings.css" rel="stylesheet" type="text/css">
+
+ <title>Apache River - </title>
+
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+</head>
+<body>
+<div class="white_box">
+<div class="header">
+ <div class="header_l">
+ <div class="header_r">
+ </div>
+ </div>
+</div>
+<div class="content">
+ <div class="content_l">
+ <div class="content_r">
+ <div>
+
+<!-- Banner -->
+
+
+ <div id="header_background">
+ <div id="river_logo">
+ <a href="/river"><img src="/river/images/apache_river_v2b_small.png"/></a>
+<img src="/river/images/apache-incubator-logo.png"/>
+
+ </div>
+ </div>
+
+ <table border="0">
+ <tbody>
+ <tr>
+ <td style="overflow: hidden;" valign="top" width="100%">
+ <div class="wiki-content">
+<!--
+ ! Licensed to the Apache Software Foundation (ASF) under one
+ ! or more contributor license agreements. See the NOTICE file
+ ! distributed with this work for additional information
+ ! regarding copyright ownership. The ASF licenses this file
+ ! to you 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.
+ !-->
+<html lang="en-US">
+<body text="#000000" bgcolor="#ffffff" link="#9b37cc"
+ vlink="#cc1877" alink="#ffffff">
+
+<p><title>Notes on Java(TM) RMI Activation and How it is Used in the
+Apache River release</title></p>
+<p><center><h1>Notes on Java(TM) RMI Activation and How it is Used
+<br>in the Apache River Release</h1></center></p>
+<p>All of the contributed River technology-enabled service (<em>River
+service</em>) implementations in the Apache River release
+support three modes of operation: transient,
+persistent/non-activatable, and persistent/activatable. The lifecycle of
+the services in the first two modes is relatively straightforward and is
+similar to the lifecycles of most other network services written in the
+Java(TM) programming language. Running the services in
+persistent/activatable mode is more involved. While there are benefits to
+using activation, the deployment of activatable services is somewhat
+non-intuitive if you do not have previous experience with the Java Remote
+Method Invocation (Java RMI) activation system. In particular, the
+relationship between the tool used to launch our contributed service
+implementations, the <a
+href=../api/com/sun/jini/start/package-summary.html><em>service
+starter</em></a>, and the service launched is a bit different for
+activatable than non-activatable services. This document is intended to
+provide some background on the advantages of using the Java RMI activation
+system and what impact using activation has on the way services
+are started and run.
+<p></p>
+<p>If you are new to the Apache River release or doing day-to-day development, you
+probably don't need to use the activatable mode of the contributed
+implementations. The non-activatable modes are considerably simpler to deal
+with and understand. The activatable mode may be necessary or helpful in
+certain deployment scenarios or when you need to test in an environment
+similar to what you will deploy into and are using the activatable mode
+in deployment.
+<p></p>
+<H3>Why is Activation Useful?</H3>
+
+<p>Activation provides three features :</p>
+<ul>
+<li><em>Persistent References</em> — Persistent references are remote
+references that remain valid after the virtual machine for the Java
+platform (VM) in which the service was originally hosted in has died or
+been terminated.
+
+<li><em>Crash recovery</em> — If an activatable service crashes, the
+activation system will restart it as necessary.
+
+<li><em>Demand driven activation</em> — An activatable service can be
+written in such a way that it only requires a running VM when it is
+servicing a client request. Note that the contributed service
+implementations in the Apache River release do not exploit this feature of
+activation.
+
+</ul>
+
+<p>The first two features are particularly valuable if the service you are
+deploying needs to be available all the time. If a service is activatable
+and it crashes (because of a program error or because the machine on which
+it is running crashes), activation will automatically restart it in a new
+VM. In the case of a hardware crash this will take place after the machine
+recovers and the activation daemon is restarted. Because activation
+provides persistent references, any existing references to the service will
+continue to work, even though the service is now hosted by a different VM.
+<p></p>
+<p><hr>
+<h2>The Java RMI Activation System Daemon</h2></p>
+<p><em>This is a high-level description of how Java RMI activation works.
+If you want even greater detail, check the links at the end of this
+document.</em>
+<p></p>
+<p>A <em>Java RMI activation system daemon</em> (<em>activation daemon</em>)
+is a process that continually runs on a system to ensure that activatable
+services are available when they are needed. Once an activation daemon is
+running, its remote methods can be invoked to register information on how
+to start activatable services. This registration process returns a remote
+reference to the service, but the service itself is not yet running. The
+remote reference to the service can be made available for clients to use
+directly, or via a smart proxy. Whether embedded in a proxy or not, the
+reference is generally made available by means of a River lookup service,
+though any mechanism that allows for the transfer of serializable objects
+can also be used.
+<p></p>
+<p>While the service's reference appears to clients to be a normal remote
+reference, it acts a bit differently. This remote reference contains the
+information necessary to contact <em>both</em> the activation daemon on the
+service's host and the service itself. When a client invokes a
+method on this remote reference object, the reference object first tries to
+contact the service directly; if this attempt fails, it contacts the
+activation daemon. If necessary, the activation daemon (re)starts the
+service in a new VM and passes the contact information for the new VM back
+to the remote reference. The remote reference then tries to contact the
+service using this new contact information. If this second attempt fails,
+or if the remote reference cannot contact the activation daemon, then the
+remote reference throws a <code>RemoteException</code>.
+<p></p>
+<h3>Failure Recovery</h3>
+
+<p>If the service's VM crashes, the activation daemon will restart it as
+necessary. The service can be registered with the activation daemon in such
+a way that the activation daemon will automatically restart a crashed
+service even if there are no active clients. This is in fact how all of the
+activatable services register themselves. The other way to
+register with the activation daemon is demand driven — to have it
+(re)start the service only when a client invokes a remote method of the
+service.
+<p></p>
+<p>When a service is registered with the activation daemon, the registration
+is logged to disk. When the activation daemon is restarted after a crash or
+other outage it will read the log and the service will again be
+available. If, at some point, the service decides it should no longer
+exist, it must explicitly unregister with the activation daemon; simply
+calling <code>System.exit</code> will not keep it from being restarted by
+the activation daemon.
+<p></p>
+<h3>Process Architecture</h3>
+
+<p>An activatable service will always be run in a child process of the
+activation daemon. This design allows the activation daemon to determine if
+the service's VM has crashed and to reliably determine when a new VM should
+be created. This has a few implications.
+<p></p>
+<p><b>VM Independence</b><br></p>
+<p>The service now has an existence that is independent of any particular
+VM. As long as the activation daemon is reachable, the service is reachable
+and exists — even if the service itself is not currently running inside a
+VM. If the activation daemon is not running but its logs are intact,
+restarting the activation daemon will make the service reachable again. In
+a very real sense, the service exists (although it may be inaccessible) as
+long as the activation daemon's logs and the service's logs exist. When you
+kill an activation daemon and delete its logs, you are really destroying
+all the services that have registered with it.
+<p></p>
+<p>The key to this independence is the remote references that activation
+creates for the service. These are persistent references; that is, they
+keep on working after the original VM in which the service was hosted goes
+away. With Java RMI/JRMP (the Java RMI implementation included with the
+Java Development Kit) activation is the only supported way to get
+persistent references. With Jini extensible method invocation (Jini ERI)
+there are two ways to create persistent references. One way is to use
+activation. The second way is to create references with fixed ports and
+object IDs. The package documentation for each of the
+contributed service implementations includes example configurations
+demonstrating how this can be done.
+<p></p>
+<p><b>Multiple Service Dependence</b><br>
+In general, more than one service will be registered with a given
+activation daemon. Thus, while you can destroy a service by killing the
+activation daemon and deleting its logs, you will most likely destroy
+quite a few other services in the process.
+<p></p>
+<p>A better approach is to tell the service that you no longer need it and
+that it should destroy itself. The administration interfaces of all the
+service implementations in the Apache River release support the <a
+href=../api/com/sun/jini/admin/DestroyAdmin.html>
+<code>com.sun.jini.admin.DestroyAdmin</code></a> interface. Invoking the <a
+href=../api/com/sun/jini/admin/DestroyAdmin.html#destroy><code>destroy</code></a>
+method on the admin of an activatable service will cause the service to be
+unregistered with the activation daemon, the service's logs to be
+destroyed, and all the threads the service has started to be stopped (which
+means if there are no other non-daemon threads, the VM will exit). Invoking
+<code>destroy</code> on only a single service will leave the activation
+daemon, and any other services registered with it, intact and
+available. When the <a
+href=../api/com/sun/jini/example/browser/package-summary.html>example
+service browser</a> that ships with the Apache River release is started with the
+<code>folderView</code> configuration entry set to <code>true</code> (which
+is the default), it can be used to destroy services that implement
+<code>DestroyAdmin</code>.
+<p></p>
+<p><b>Service Persistence</b><br></p>
+<p>Another implication of using activatable services is that, in the normal
+course of events, you don't need to individually restart the services after
+restarting the activation daemon; <em>the activation daemon will do it for
+you</em>. If the activation daemon's log is still intact, it will
+automatically restart the services as necessary. Each time you use the
+service starter to start an activatable service, you are not restarting an
+existing service instance, but creating a completely new service instance
+with its own identity and state.
+<p></p>
+<p>For example, if you were to invoke the service starter using "<code>java
+-jar start.jar start-activatable-reggie.config</code>" to start an
+activatable Reggie server, then kill the activation daemon, restart the
+activation daemon, and invoke "<code>java -jar start.jar
+start-activatable-reggie.config</code>" again, you will end up with
+<b>two</b> Reggie services, not one. If you keep on doing this you will end
+up with a very large number of Reggie services, the activation daemon will
+take a long time to restart, and your system will slow to a crawl. Also, if
+you have not given them separate log directories, the Reggie services will
+start interfering with each other. You should only invoke "<code>java -jar
+start.jar start-activatable-reggie.config</code>" more than once if you
+want more than one Reggie running on the machine in question, or if the
+first instance of Reggie has been destroyed (as opposed to having only
+crashed).
+<p></p>
+<p><b>The VM You Start and the Service VM are Separate</b><br></p>
+<p>When you invoke the service starter to create an activatable service
+instance, a VM is created for the service starter to do its work in;
+generally this is done with a command line of the form <code>java -jar
+start.jar ... </code>. We refer to this VM as the <em>setup VM</em>. The
+service starter makes some remote calls to the activation daemon to
+register the new service. This will cause the activation daemon to spawn a
+new VM for the service to run in. We refer to this VM as the <em>server
+VM</em>. This is very different from what happens when the service starter
+is asked to create a non-activatable (transient or persistent) service, in
+which case there is only one VM.
+<p></p>
+<p>Unless the service starter has been asked to host non-activatable services
+in addition to creating new activatable services, the <em>setup VM will
+exit</em> once it has registered the new activatable service(s) with the
+activation daemon. <em>This is normal</em>. If the setup VM exits cleanly
+(e.g. no exceptions are printed out) the new service has been created and
+(if properly configured) is available for use.
+<p></p>
+<p>Because the server VM is a child of the activation daemon, anything sent to
+the service's <code>System.out</code> or <code>System.err</code> will appear
+not in the setup VM's console session, but in the activation daemon's
+console session.
+<p></p>
+<p>Lastly, because the activation daemon is starting the server VM, you have
+less direct control over how it is started than the setup VM. For example
+if you wanted to have the service run in a VM with the <code>-server</code>
+command line switch set, adding <code>-server</code> to the command line
+used for the setup VM will not help. How the service VM is spawned is
+controlled by the <a
+href=../api/com/sun/jini/start/SharedActivationGroupDescriptor.html><code>com.sun.jini.start.SharedActivationGroupDescriptor</code></a>
+that was responsible for creating the <em>activation group</em> to which
+that service has been assigned.
+<p></p>
+<p><b>Service Starter Needs More Information</b><br></p>
+<p>Service starter determines what needs to be done by getting an array of <a
+href=../api/com/sun/jini/start/ServiceDescriptor.html><code>com.sun.jini.start.ServiceDescriptor</code></a>s
+using the <code>serviceDescriptors</code> configuration entry. Creating a
+single non-activatable service requires only a single instance of <a
+href=../api/com/sun/jini/start/NonActivatableServiceDescriptor.html><code>com.sun.jini.start.NonActivatableServiceDescriptor</code></a>,
+while creating instances of activatable services is a bit more involved
+and has more options.
+<p></p>
+<p>Each activatable service needs to be assigned to an activation
+group. Activation groups are created by placing instances of
+<code>SharedActivationGroupDescriptor</code> in the
+<code>serviceDescriptors</code> array. As mentioned above, the
+<code>SharedActivationGroupDescriptor</code> will control the details of
+how the server VM is spawned.<p></p>
+<p>Once you have an activation group, one or more activatable services can be
+assigned to it. Activatable services are created by placing instances of <a
+href=../api/com/sun/jini/start/SharedActivatableServiceDescriptor.html><code>com.sun.jini.start.SharedActivatableServiceDescriptor</code></a>
+in the <code>serviceDescriptors</code> array, one instance per activatable
+service to be created.
+<p></p>
+<p>There is one additional wrinkle to consider. Because of the way
+<code>SharedActivatableServiceDescriptor</code>s are associated with
+activation groups, a group can be created by one service starter
+invocation, and separate service starter invocations can be used to add
+activatable services to that group. For example you could use one service
+starter invocation to create a group and put 30 services in it, or you
+could invoke the service starter to just create a group, and then run the
+service starter again to add one or more services. In either case you could
+come back three weeks later and add more services to an existing group.
+<p></p>
+<h2>Further Reading</h2>
+
+<p>The <a href=http://java.sun.com/j2se/1.4/docs/guide/rmi/spec/rmiTOC.html>
+Java RMI Specification</a> includes a <a
+href=http://java.sun.com/j2se/1.4/docs/guide/rmi/spec/rmi-activation.html#1997>chapter</a>
+on activation.
+<p></p>
+<p><a
+href=http://java.sun.com/j2se/1.4/docs/guide/rmi/activation.html>Tutorials
+on how to write an activatable service</a>.
+<p></p>
+<p>There are two activation daemon implementations available. <code>rmid</code>
+ships with the Java Development Kit:
+<ul>
+<li><a
+href=http://java.sun.com/j2se/1.4/docs/tooldocs/windows/rmid.html>Documentation
+on using <code>rmid</code> on Microsoft Windows </a>
+<li><a href=http://java.sun.com/j2se/1.4/docs/tooldocs/solaris/rmid.html>Documentation
+on using <code>rmid</code> with the Solaris(TM) Operating System
+and/or Linux</a>
+</ul>
+<p></p>
+<p>The second is <a
+href=../api/com/sun/jini/phoenix/package-summary.html>phoenix</a>, which is
+part of the release. Phoenix has better support for Jini ERI, is
+configurable, and supports <code>net.jini.security</code>, making it
+suitable for a much broader range of deployments than <code>rmid</code>.
+<p></p>
+<p>Because activation daemons are capable of spawning arbitrary subprocesses,
+there are some <a href=execpolicy.html>security issues to consider</a>.
+<p></p>
+<p><hr>
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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
+<ul>
+ <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a>
+</ul>
+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.</p>
+<p></body>
+</html></p>
+ </div>
+ </td>
+ <td valign="top">
+ <div class="navigation">
+ <div class="navigation_top">
+ <div class="navigation_bottom">
+<!-- sidenav -->
+<ul>
+<li><a href="index.html">Home</a></li>
+<li><a href="news.html">News</a></li>
+</ul>
+<h3 id="community">Community</h3>
+<ul>
+<li><a href="supported-platforms.html">Supported platforms</a></li>
+<li><a href="get-involved.html">Get Involved</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0">License</a></li>
+<li><a href="downloads.html">Downloads</a></li>
+<li>Documentation<ul>
+<li><a href="http://people.apache.org/~sijskes/doc/index.html">Original Jini Wiki</a></li>
+<li><a href="user-guide-glossary.html">Glossary</a></li>
+<li><a href="documentation.html">Cookbook</a></li>
+<li><a href="javadoc.html">Javadoc</a></li>
+</ul>
+</li>
+<li><a href="success-stories.html">Success Stories</a></li>
+<li><a href="mailing-lists.html">Mailing Lists</a></li>
+<li><a href="committers.html">Committers</a></li>
+<li><a href="found-a-bug.html">Found a Bug</a>?</li>
+</ul>
+<h3 id="development">Development</h3>
+<ul>
+<li><a href="javadoc.html">Javadoc</a></li>
+<li><a href="source-code.html">Source Code</a></li>
+<li><a href="building-river.html">Building River</a></li>
+<li><a href="roadmap.html">Roadmap</a></li>
+<li><a href="development-process.html">Development Process</a></li>
+<li><a href="https://issues.apache.org/jira/browse/RIVER">Issue Tracker</a></li>
+<li><a href="http://wiki.apache.org/river/">Wiki</a></li>
+</ul>
+<h3 id="search">Search</h3>
+<DIV>
+<FORM action="http://www.google.com/search" method="get" style="font-size: 10px;">
+<INPUT name="ie" type="hidden" value="UTF-8"></INPUT>
+<INPUT name="oe" type="hidden" value="UTF-8"></INPUT>
+ <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT><BR></BR>
+ <INPUT name="btnG" type="submit" value="Search"></INPUT>
+ <INPUT name="domains" type="hidden" value="incubator.apache.org/river"></INPUT>
+ <INPUT name="sitesearch" type="hidden" value="incubator.apache.org/river"></INPUT>
+</FORM>
+</DIV>
+
+<ul>
+<li><a href="sitemap.html">Sitemap</a></li>
+</ul>
+<h3 id="the_foundation">The Foundation</h3>
+<ul>
+<li><a href="http://www.apache.org">Apache</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Sponsors</a></li>
+<li><a href="http://www.apache.org/foundation/how-it-works.html">How it works</a></li>
+<li><a href="http://incubator.apache.org/">Incubator</a></li>
+</ul>
+<!-- sidenav -->
+ </div>
+ </div>
+ </div>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+
+<!--
+ <div class="bottom_red_bar"></div>
+-->
+ </div>
+ </div>
+ </div>
+</div>
+<div class="black_box">
+<div class="footer">
+ <div class="footer_l">
+ <div class="footer_r">
+ <div>
+
+ </div>
+ </div>
+ </div>
+</div>
+</div>
+</div>
+<!--
+<div class="design_attribution">Page Template Design By Marc Prud'hommeaux based on <a href="http://activemq.apache.org/">ActiveMQ template</a></div>
+-->
+<div class="copyright_footer">
+<p>Copyright © 2010 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+</div>
+<script src="skeleton_files/urchin.js" type="text/javascript">
+</script>
+<script type="text/javascript">
+_uacct = "UA-1940143-1";
+urchinTracker();
+</script>
+
+</body></html>