Modified:
websites/staging/river/trunk/content/user-guide-basic-river-services.html
==============================================================================
--- websites/staging/river/trunk/content/user-guide-basic-river-services.html
(original)
+++ websites/staging/river/trunk/content/user-guide-basic-river-services.html
Wed Oct 24 12:27:25 2012
@@ -66,7 +66,7 @@
<tr>
<td style="overflow: hidden;" valign="top" width="100%">
<div class="wiki-content">
-<h1 id="getting_started_with_river">Getting Started With River</h1>
+<h1 id="getting-started-with-river">Getting Started With River</h1>
<p>This document is going to explain how you can use the inbuilt "simple"
services that come with River. More specifically;</p>
<ul>
<li>A Lookup Service (the "reggie" implementation)</li>
@@ -75,7 +75,7 @@
</ul>
<p>The instructions assume that you're building from source as checked out
from the SVN trunk. Currently this is necessary because the code snippets
below use methods and classes which, at time of writing, haven't made it into
the latest binary release yet. Having said that, the code you will need in the
binary release isn't to far removed from what you'll see below, so you can
progress with the binary release if you want to and are happy odifying the
code.</p>
<p>If you are going to use the latest release then you will still need to
download (from the SVN trunk) some of the Windows BAT files mentioned below.
*nix sh scripts of those same batch files will appear shortly.</p>
-<h2 id="environment_setup">Environment Setup</h2>
+<h2 id="environment-setup">Environment Setup</h2>
<p>The following instructions all assume that you have checked out River to
some directory which is throughout referred to as <code>$RIVER_HOME</code>.
Further, you have changed directory into
<code>$RIVER_HOME/examples/hello</code>.</p>
<blockquote>
<p><strong>Important</strong>: Run all scripts from the <code>hello</code>
directory</p>
@@ -84,7 +84,7 @@
<li>Change directory to $RIVER_HOME</li>
<li>Use Ant to build River, i.e. <code>ant all.build</code></li>
</ul>
-<h2 id="running_code_which_uses_river_services">Running Code Which Uses River
Services</h2>
+<h2 id="running-code-which-uses-river-services">Running Code Which Uses River
Services</h2>
<p>Since River uses dynamic code downloading, we need to grant various
permissions to our JVM to allow that. In the interest of simplicity, we are
going to grant everything every permission. In the real world, this would
obviously not be recommended.</p>
<p>To grant these permissions we need to create a policy file:</p>
<div class="codehilite"><pre><span class="n">grant</span> <span
class="p">{</span>
@@ -105,8 +105,8 @@
</pre></div>
-<h2 id="starting_the_http_server">Starting the HTTP server</h2>
-<h3 id="what__wait_why_do_i_need_to_do_that">What? Wait, why do I need to do
that?</h3>
+<h2 id="starting-the-http-server">Starting the HTTP server</h2>
+<h3 id="what-wait-why-do-i-need-to-do-that">What? Wait, why do I need to do
that?</h3>
<p>When services get marshalled for sending over the wire, the first part of
their stream is the codebase URL. This URL tells the downloading JVM where to
load the supporting JARs from. Often (although not always) in the River/Jini
world this code base harks back to some HTTP server. There is a simple HTPP
server packaged inside River which can be used for this. That's what we're
going to start.</p>
<p>See <a
href="http://download.oracle.com/javase/1.5.0/docs/guide/rmi/codebase.html";>3.2
How codebase is used in Java RMI</a> for more details.</p>
<h3 id="instructions">Instructions</h3>
@@ -114,13 +114,13 @@
<li>Change to directory to <code>$RIVER_HOME/examples/hello/</code></li>
<li>Execute the script; <code>scripts/httpd.bat</code></li>
</ul>
-<h3 id="testing_it">Testing it</h3>
+<h3 id="testing-it">Testing it</h3>
<p>To test that the HTTP server is running correctly use wget or your web
browser on the following URL</p>
<ul>
<li>http://localhost:8080/reggie-dl.jar</li>
</ul>
-<h2 id="starting_a_service_registrar_lookup_service">Starting a Service
Registrar (Lookup Service)</h2>
-<h3 id="what__wait_why_do_i_need_to_do_that_1">What? Wait, why do I need to
do that?</h3>
+<h2 id="starting-a-service-registrar-lookup-service">Starting a Service
Registrar (Lookup Service)</h2>
+<h3 id="what-wait-why-do-i-need-to-do-that_1">What? Wait, why do I need to do
that?</h3>
<p>Typically, in an environment which uses River/Jini services, a Lookup
Service will be used. This Lookup Service is then used by your code to find
River/Jini services. Lookup Services always know the current state of the
subnet or federated space.</p>
<p>Broadly speaking (although not 100% accurately) you need a Lookup Service
in order to be able to find other services to use.</p>
<h2 id="instructions_1">Instructions</h2>
@@ -128,7 +128,7 @@
<li>Change directory to <code>$RIVER_HOME/examples/hello</code></li>
<li>Execute the script <code>scripts/jrmp-reggie.bat</code></li>
</ul>
-<h3 id="testing_it_1">Testing it</h3>
+<h3 id="testing-it_1">Testing it</h3>
<p>There are two ways to find our Lookup Service. Remember that the interface
which fulfills the role of a Lookup Service is
<code>ServiceRegistrar</code>.</p>
<h4 id="unicast">Unicast</h4>
<p>If we know where our Lookup Service is running, we can use unicast to
connect straight to it.</p>
@@ -162,15 +162,15 @@
<p>This approach is slightly different. It is relying the
<code>ServiceDiscoveryManager</code> to listen to the UDP multicast packets
announcing the presence of a Lookup Service. The same rules apply as for
unicast on deciding whether or not your Lookup Service is running.</p>
<p>This approach can be modified if you know which hosts on the subnet
<em>might</em> be running lookup services. You can define and pass this list
to the <code>LookupDiscovery</code> constructor.</p>
-<h2 id="starting_a_java_space">Starting a Java Space</h2>
-<h3 id="what__wait_why_do_i_need_to_do_that_2">What? Wait, why do I need to
do that?</h3>
+<h2 id="starting-a-java-space">Starting a Java Space</h2>
+<h3 id="what-wait-why-do-i-need-to-do-that_2">What? Wait, why do I need to do
that?</h3>
<p>Finding a Lookup Service is only useful if there are some other services on
the network which you want to use, so now we're going to start a Java Space,
and find that. Using the Java Space is outside the scope of this document,
although the "how" is relativily straight forward.</p>
<h3 id="instructions_2">Instructions</h3>
<ul>
<li>Change directory to <code>$RIVER_HOME/examples/hello</code></li>
<li>Execute the script <code>scripts/jrmp-outrigger-group.bat</code></li>
</ul>
-<h3 id="testing_it_2">Testing it</h3>
+<h3 id="testing-it_2">Testing it</h3>
<p>To find any kind of service we must first create a template.
This is an instance of <code>ServiceTemplate</code> which describes the kind
of thing we're
looking for.
@@ -203,15 +203,15 @@ So the following code is a template whic
</pre></div>
-<h2 id="starting_a_transaction_service">Starting a Transaction Service</h2>
-<h3 id="what__wait_why_do_i_need_to_do_that_3">What? Wait, why do I need to
do that?</h3>
+<h2 id="starting-a-transaction-service">Starting a Transaction Service</h2>
+<h3 id="what-wait-why-do-i-need-to-do-that_3">What? Wait, why do I need to do
that?</h3>
<p>Because you'd like to find something that will give you a nice distributed
transaction.</p>
<h3 id="instructions_3">Instructions</h3>
<ul>
<li>Change directory to <code>$RIVER_HOME/examples/hello</code></li>
<li>Execute the script <code>scripts/jrmp-mahalo-group.bat</code></li>
</ul>
-<h3 id="testing_it_3">Testing it</h3>
+<h3 id="testing-it_3">Testing it</h3>
<p>Testing it is done in the same way as for the Java Space. However, the
constructor of the <code>ServiceTemplate</code> changes.</p>
<div class="codehilite"><pre><span class="n">ServiceTemplate</span> <span
class="n">template</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">ServiceTemplate</span><span class="p">(</span><span
class="n">null</span><span class="p">,</span> <span class="k">new</span> <span
class="n">Class</span><span class="p">[)</span> <span class="p">{</span> <span
class="n">TransactionManager</span><span class="o">.</span><span
class="n">class</span> <span class="p">},</span> <span class="k">new</span>
<span class="n">Entry</span><span class="p">[</span><span
class="mi">0</span><span class="p">](</span><span class="mi">0</span><span
class="o">.</span><span class="n">html</span><span class="p">));</span>
</pre></div>
@@ -222,7 +222,7 @@ So the following code is a template whic
<div class="navigation_top">
<div class="navigation_bottom">
<!-- sidenav -->
-<h3 id="the_foundation">The Foundation</h3>
+<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";>Thanks</a></li>
@@ -230,7 +230,7 @@ So the following code is a template whic
<li><a href="http://www.apache.org/security/";>Security</a></li>
<li><a href="http://www.apache.org/foundation/how-it-works.html";>How it
works</a></li>
</ul>
-<h3 id="apache_river">Apache river</h3>
+<h3 id="apache-river">Apache river</h3>
<ul>
<li><a href="downloads.html">Downloads</a></li>
<li><a href="http://www.apache.org/licenses/";>License</a></li>
@@ -276,15 +276,14 @@ So the following code is a template whic
<li><a href="http://wiki.apache.org/river/";>Wiki</a></li>
</ul>
<h3 id="search">Search</h3>
-<DIV>
+<p><DIV>
<form method="get" action="http://www.google.com/search"; id="search"
name="search" style="font-size: 10px;">
<input type="hidden" name="sitesearch" value="river.apache.org">
<input type="text" id="query" name="q" size="15" maxlength="255" >
<BR/>
<input type="submit" value="Search" id="submit"/>
</form>
-</DIV>
-
+</DIV></p>
<ul>
<li><a href="sitemap.html">Sitemap</a></li>
</ul>
@@ -320,7 +319,7 @@ So the following code is a template whic
<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>
+<p>Copyright © 2010 - 2012 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">
Modified: websites/staging/river/trunk/content/user-guide-glossary.html
==============================================================================
--- websites/staging/river/trunk/content/user-guide-glossary.html (original)
+++ websites/staging/river/trunk/content/user-guide-glossary.html Wed Oct 24
12:27:25 2012
@@ -66,7 +66,7 @@
<tr>
<td style="overflow: hidden;" valign="top" width="100%">
<div class="wiki-content">
-<h1 id="user_guide_-_glossary">User Guide - Glossary</h1>
+<h1 id="user-guide-glossary">User Guide - Glossary</h1>
<ul>
<li>4161<br/>
This is the default Jini port which Lookup Service use</li>
@@ -84,7 +84,7 @@ The formal interface of a Lookup Service
<div class="navigation_top">
<div class="navigation_bottom">
<!-- sidenav -->
-<h3 id="the_foundation">The Foundation</h3>
+<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";>Thanks</a></li>
@@ -92,7 +92,7 @@ The formal interface of a Lookup Service
<li><a href="http://www.apache.org/security/";>Security</a></li>
<li><a href="http://www.apache.org/foundation/how-it-works.html";>How it
works</a></li>
</ul>
-<h3 id="apache_river">Apache river</h3>
+<h3 id="apache-river">Apache river</h3>
<ul>
<li><a href="downloads.html">Downloads</a></li>
<li><a href="http://www.apache.org/licenses/";>License</a></li>
@@ -138,15 +138,14 @@ The formal interface of a Lookup Service
<li><a href="http://wiki.apache.org/river/";>Wiki</a></li>
</ul>
<h3 id="search">Search</h3>
-<DIV>
+<p><DIV>
<form method="get" action="http://www.google.com/search"; id="search"
name="search" style="font-size: 10px;">
<input type="hidden" name="sitesearch" value="river.apache.org">
<input type="text" id="query" name="q" size="15" maxlength="255" >
<BR/>
<input type="submit" value="Search" id="submit"/>
</form>
-</DIV>
-
+</DIV></p>
<ul>
<li><a href="sitemap.html">Sitemap</a></li>
</ul>
@@ -182,7 +181,7 @@ The formal interface of a Lookup Service
<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>
+<p>Copyright © 2010 - 2012 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">
Modified:
websites/staging/river/trunk/content/user-guide-river-jar-artifacts.html
==============================================================================
--- websites/staging/river/trunk/content/user-guide-river-jar-artifacts.html
(original)
+++ websites/staging/river/trunk/content/user-guide-river-jar-artifacts.html
Wed Oct 24 12:27:25 2012
@@ -176,7 +176,7 @@
<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>
+<p>Copyright © 2010 - 2012 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">
Modified: websites/staging/river/trunk/content/user-guide-socketfactories.html
==============================================================================
--- websites/staging/river/trunk/content/user-guide-socketfactories.html
(original)
+++ websites/staging/river/trunk/content/user-guide-socketfactories.html Wed
Oct 24 12:27:25 2012
@@ -66,7 +66,7 @@
<tr>
<td style="overflow: hidden;" valign="top" width="100%">
<div class="wiki-content">
-<h1 id="using_a_socketfactory_with_a_tcpendpoint">Using a SocketFactory with a
TcpEndpoint</h1>
+<h1 id="using-a-socketfactory-with-a-tcpendpoint">Using a SocketFactory with a
TcpEndpoint</h1>
<p>The SocketFactory needs to be Serializable. Make sure the hashcode of the
SocketFactory stays the same during de-serialization. Otherwise you end up with
multiple connections, and a lot of threads on the serverside. This is caused by
the use of the hashcode of the SocketFactory in the hashcode of the endpoint.
When it is not stable, seemingly equal endpoints do not get interned as the
same endpoint.</p>
</div>
</td>
@@ -75,7 +75,7 @@
<div class="navigation_top">
<div class="navigation_bottom">
<!-- sidenav -->
-<h3 id="the_foundation">The Foundation</h3>
+<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";>Thanks</a></li>
@@ -83,7 +83,7 @@
<li><a href="http://www.apache.org/security/";>Security</a></li>
<li><a href="http://www.apache.org/foundation/how-it-works.html";>How it
works</a></li>
</ul>
-<h3 id="apache_river">Apache river</h3>
+<h3 id="apache-river">Apache river</h3>
<ul>
<li><a href="downloads.html">Downloads</a></li>
<li><a href="http://www.apache.org/licenses/";>License</a></li>
@@ -129,15 +129,14 @@
<li><a href="http://wiki.apache.org/river/";>Wiki</a></li>
</ul>
<h3 id="search">Search</h3>
-<DIV>
+<p><DIV>
<form method="get" action="http://www.google.com/search"; id="search"
name="search" style="font-size: 10px;">
<input type="hidden" name="sitesearch" value="river.apache.org">
<input type="text" id="query" name="q" size="15" maxlength="255" >
<BR/>
<input type="submit" value="Search" id="submit"/>
</form>
-</DIV>
-
+</DIV></p>
<ul>
<li><a href="sitemap.html">Sitemap</a></li>
</ul>
@@ -173,7 +172,7 @@
<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>
+<p>Copyright © 2010 - 2012 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">
Modified: websites/staging/river/trunk/content/wot.html
==============================================================================
--- websites/staging/river/trunk/content/wot.html (original)
+++ websites/staging/river/trunk/content/wot.html Wed Oct 24 12:27:25 2012
@@ -66,7 +66,7 @@
<tr>
<td style="overflow: hidden;" valign="top" width="100%">
<div class="wiki-content">
-<h1 id="web_of_trust">Web of trust</h1>
+<h1 id="web-of-trust">Web of trust</h1>
<p><a
href="http://en.wikipedia.org/wiki/Web_of_trust";>http://en.wikipedia.org/wiki/Web_of_trust</a></p>
<p>Gregg: </p>
<p>... Ultimately, Jini needs, in my opinion, to focus authentication above
the network layer, and use signed jars, encrypted paths, and cert based auth,
so that the network path, can not be a part of the exploitation, and instead,
each end of a "communication", is responsible for trusting the other, through
negotiations carried through the network, instead of using information about
the network to guarantee trust. ...</p>
@@ -77,7 +77,7 @@
<div class="navigation_top">
<div class="navigation_bottom">
<!-- sidenav -->
-<h3 id="the_foundation">The Foundation</h3>
+<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";>Thanks</a></li>
@@ -85,7 +85,7 @@
<li><a href="http://www.apache.org/security/";>Security</a></li>
<li><a href="http://www.apache.org/foundation/how-it-works.html";>How it
works</a></li>
</ul>
-<h3 id="apache_river">Apache river</h3>
+<h3 id="apache-river">Apache river</h3>
<ul>
<li><a href="downloads.html">Downloads</a></li>
<li><a href="http://www.apache.org/licenses/";>License</a></li>
@@ -131,15 +131,14 @@
<li><a href="http://wiki.apache.org/river/";>Wiki</a></li>
</ul>
<h3 id="search">Search</h3>
-<DIV>
+<p><DIV>
<form method="get" action="http://www.google.com/search"; id="search"
name="search" style="font-size: 10px;">
<input type="hidden" name="sitesearch" value="river.apache.org">
<input type="text" id="query" name="q" size="15" maxlength="255" >
<BR/>
<input type="submit" value="Search" id="submit"/>
</form>
-</DIV>
-
+</DIV></p>
<ul>
<li><a href="sitemap.html">Sitemap</a></li>
</ul>
@@ -175,7 +174,7 @@
<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>
+<p>Copyright © 2010 - 2012 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">
