acutright 2004/04/07 10:58:25
Modified: targets/juddi bugs.html contact.html cvs.html devguide.html
faq.html index.html install.html install.pdf
interim.html legal.html library.html lists.html
news.html news.pdf participate.html participate.pdf
releases.html site.html site.pdf usersguide.html
who.html
Log:
updating jUDDI website
Revision Changes Path
1.4 +3 -3 ws-site/targets/juddi/bugs.html
Index: bugs.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/bugs.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- bugs.html 31 Mar 2004 16:15:21 -0000 1.3
+++ bugs.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
1.4 +3 -3 ws-site/targets/juddi/contact.html
Index: contact.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/contact.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- contact.html 31 Mar 2004 16:15:21 -0000 1.3
+++ contact.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
1.7 +3 -3 ws-site/targets/juddi/cvs.html
Index: cvs.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/cvs.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- cvs.html 31 Mar 2004 16:15:21 -0000 1.6
+++ cvs.html 7 Apr 2004 17:58:25 -0000 1.7
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
1.4 +3 -3 ws-site/targets/juddi/devguide.html
Index: devguide.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/devguide.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- devguide.html 31 Mar 2004 16:15:21 -0000 1.3
+++ devguide.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
1.8 +3 -3 ws-site/targets/juddi/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/faq.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- faq.html 31 Mar 2004 16:15:21 -0000 1.7
+++ faq.html 7 Apr 2004 17:58:25 -0000 1.8
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<span class="menuSelected">FAQ/Wiki</span>
+<span class="menuSelected">FAQ</span>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
1.7 +3 -3 ws-site/targets/juddi/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/index.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- index.html 31 Mar 2004 16:15:21 -0000 1.6
+++ index.html 7 Apr 2004 17:58:25 -0000 1.7
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
1.4 +179 -5 ws-site/targets/juddi/install.html
Index: install.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/install.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- install.html 31 Mar 2004 16:15:21 -0000 1.3
+++ install.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
@@ -217,14 +217,188 @@
<div class="h3">
-<h3>Installation Guide</h3>
+<h3>Requirements</h3>
</div>
+<p>jUDDI is a pure Java web application and as such can be deployed to
+ any application server or servlet engine that supports version 2.1 or
+ later of the servlet API. If you need an application server, we
+ recommend <a href="http://jakarta.apache.org/tomcat/";>Jakarta
+ Tomcat</a>. Note also that jUDDI requires Java 1.3 or later. As
+ with any Java web application, deployment to your application server
+ or servlet engine will vary on a product-by-product basis.
+ </p>
+
+<p>Instructions for deploying jUDDI to several application servers have
+ been donated and are available in the <a
href="http://wiki.apache.org/ws/jUDDI";>HOWTO</a>
+ section of the jUDDI wiki.
+ </p>
+
+<p>jUDDI also requires an external datastore in which to save and search
+ for published web services data. Database schemas for several
+ different relational database are included with the jUDDI release.
+ Again, instructions describing how to create a jUDDI datastore using
+ several different database servers are available in the
+ <a href="http://wiki.apache.org/ws/jUDDI";>HOWTO</a> section of the jUDDI
wiki.
+ </p>
+
+
+
+<div class="h3">
+<h3>Configuration</h3>
+</div>
+
+
+<p>To properly configure and deploy jUDDI it will be helpful to understand
+ a bit about it's architecture. jUDDI consist of a core request processor
+ that unmarshalls incoming UDDI requests, invoking the appropriate UDDI
+ function and marshalling UDDI responses (marshalling and unmarshalling
+ is the process of converting XML data to/from Java objects).
+ </p>
+
+<p>To invoke a UDDI function jUDDI employs the services of three
+ configurable sub-components or modules that handle persistence (the
+ DataStore), authentication (the Authenticator) and the generation of
+ UUID's (the UUIDGen). jUDDI is bundled and pre-configured to use
+ default implementations of each of these modules to help you get
+ jUDDI up and running quickly. The module categories and a
+ description of the default implementations are described below.
+ </p>
+
+<p>Several public Java interfaces for creating your own DataStore,
+ Authenticator and UUIDGen module implementations are available. Please
+ see the <a href="/devguide.html">jUDDI Developer's Guide</a> for
+ more information regarding jUDDI module development.
+ </p>
+
+
+
+<div class="h3">
+<h3>Persistence (jUDDI DataStore)</h3>
+</div>
+
+
+<p>The default jUDDI DataStore is implemented using JDBC and the process
+ of setting this up is fairly straight forward. Start by creating a new
+ jUDDI database using one of the following database schemas.
+ </p>
+
<p>
+
+<a href="dbscripts/juddi_mysql.ddl">MySQL</a>
+ <a href="dbscripts/juddi_db2.ddl">DB2</a>
+ <a href="dbscripts/juddi_hsql.ddl">HSQL</a>
+ <a href="dbscripts/juddi_ase.ddl">Sybase</a>
+ <a href="dbscripts/juddi_postresql.ddl">PostreSQL</a>
+ <a href="dbscripts/juddi_oracle.ddl">Oracle</a>
+ <a href="dbscripts/juddi_totalxml.ddl">TotalXML</a>
+ <a href="dbscripts/juddi_jds.ddl">JDataStore</a> (Borland)
+ </p>
+
+<p>If a schema for your DBMS is not listed, one simply hasn't been
+ created yet. You can use the available schemas as a guide for
+ creating one (and if you're feeling generous please consider
+ contributing it).
+ </p>
+
+<p>To complete the DataStore set up you'll need to configure a JNDI
+ Datasource named 'jdbc/juddiDB' in the application server or servlet
+ engine that you're deploying to. Datasource setup varies on an
+ product-by-product basis so review documentation for your application
+ server. If you're deploying jUDDI to Jakarta Tomcat, take a look at
+ the JNDI Datasource HOW-TO for assistance.
+ </p>
+
+
+
+<div class="h3">
+<h3>Authentication (jUDDI Authenticator)</h3>
+</div>
+
+
+<p>Authenticating a jUDDI publisher is a two-step process. The first step
+ confirms that the ID/password combination provided by the user is valid.
+ It is expected that a typical jUDDI deployment will use an external
+ authentication mechanism. The default authentication module simply
+ approves any authentication attempt. It is our hope that additional
+ jUDDI authentication implementations will be developed by jUDDI users
+ as they determine how they would like authentication to take place in
+ their particular environment. See the jUDDI Developers Guide for more
+ information on developing a custom jUDDI authentication module.
+ </p>
+
+<p>The second step confirms that the publisher has been defined to
+ jUDDI. A publisher is said to be defined when a row identifying the
+ publisher exists in the PUBLISHER table of the jUDDI datastore. At the
+ moment the only way to do this is via SQL. An example of defining a
+ new publisher named John Doe would look like this:
+ </p>
+
+<p>
+ INSERT INTO PUBLISHER (PUBLISHER_ID,PUBLISHER_NAME,ADMIN,ENABLED)
+ VALUES ('jdoe','John Doe','false','true');
+ </p>
+
+<p>The PUBLISHER table consists of several columns but only four of them
+ are required and they are defined as follows:
+ </p>
+
+<p>
+ Column Name Description
+ PUBLISHER_ID The user ID the publisher uses when authenticating.
IMPORTANT: This should be the same value used to authenticate with the external
authentication service.
+ PUBLISHER_NAME The publisher's name (or in UDDI speak the Authorized Name).
+ ADMIN Indicate if the publisher has administrative privileges. Valid
values for this column are 'true' or 'false'. The ADMIN value is currently not used.
+ ENABLED Indicate if the publishers account is enabled and eligible for use.
+ </p>
+
+<p>The jUDDI web application will (eventually) be extended to facilitate
+ the Publisher creation process. The value of the ADMIN column in the
+ PUBLISHER table above will be used to determine who has the privilege
+ to create new jUDDI publishers.
+ </p>
+
+
+
+<div class="h3">
+<h3>UUID Generation (jUDDI UUIDGen)</h3>
+</div>
+
+
+<p>There's nothing for you to do here but I thought I'd offer a little
+ information about how, why and where jUDDI makes use of UUID generation.
+ </p>
+
+<p>The UDDI specification indicates that each Business, Service, Binding
+ and TModel (Technical Model) is to be uniquely identified by a
+ Universally Unique ID (UUID). Additionally, jUDDI also uses the UUID
+ generator to create AuthTokens.
+ </p>
+
+<p>Generation of UUID's typically requires access to hardware level
+ information that (unfortunately) is not accessible from Java.
+ Fortunately, the UUID specification offers an alternative method for
+ generating these ID's when this hardware information is not present.
+ By default the jUDDI implements this alternative method.
+ </p>
+
+
+
+<div class="h3">
+<h3>Logging</h3>
+</div>
+
-</p>
+<p>When deploying jUDDI you may wish to make changes to the
+ juddi.properties and log4j.properties files. These files are located in
+ the juddi webapp's WEB-INF/classes directory. They're here because
+ they need to be in the classpath for jUDDI to locate and load them at
+ runtime. One Log4j property value that you'll most likely want to set
+ is log4j.appender.LOGFILE.File which specifies the name and location of
+ the jUDDI log file.
+ </p>
+
<div id="pdf" align="right">
1.2 +315 -33 ws-site/targets/juddi/install.pdf
<<Binary file>>
1.4 +3 -3 ws-site/targets/juddi/interim.html
Index: interim.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/interim.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- interim.html 31 Mar 2004 16:15:21 -0000 1.3
+++ interim.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
1.4 +3 -3 ws-site/targets/juddi/legal.html
Index: legal.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/legal.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- legal.html 31 Mar 2004 16:15:21 -0000 1.3
+++ legal.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
1.4 +3 -3 ws-site/targets/juddi/library.html
Index: library.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/library.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- library.html 31 Mar 2004 16:15:21 -0000 1.3
+++ library.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
1.8 +3 -3 ws-site/targets/juddi/lists.html
Index: lists.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/lists.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- lists.html 31 Mar 2004 16:15:21 -0000 1.7
+++ lists.html 7 Apr 2004 17:58:25 -0000 1.8
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
1.4 +35 -4 ws-site/targets/juddi/news.html
Index: news.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/news.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- news.html 31 Mar 2004 16:15:21 -0000 1.3
+++ news.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
@@ -220,10 +220,41 @@
<h3>News</h3>
</div>
+
<p>
+<b>March 24, 2004</b>
+ jUDDI graduates from the Apache Incubator into Apache Web
+ Services Project.</p>
+
-</p>
+<p>
+<b>Oct 08, 2003</b>
+ The Apache Software Foundation's Web
Services PMC (http://ws.apache.org/)
+ voted to accept jUDDI into the Apache
Incubator. The move is expected
+ to be complete in early December.</p>
+
+
+<p>
+<b>July 22, 2003</b>
+ A proposal to contribute jUDDI to the
Apache Software Foundation's
+ Web Services Project is being
considered.</p>
+
+
+<p>
+<b>July 22, 2003</b>
+ Version 0.8.0 is now available.</p>
+
+
+<p>
+<b>June 27, 2003</b>
+ Version 0.7.1 is now available.</p>
+
+
+<p>
+<b>April 22, 2003</b>
+ Version 0.7.0 is now available.</p>
+
1.2 +15 -15 ws-site/targets/juddi/news.pdf
<<Binary file>>
1.4 +23 -3 ws-site/targets/juddi/participate.html
Index: participate.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/participate.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- participate.html 31 Mar 2004 16:15:21 -0000 1.3
+++ participate.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<span class="menuSelected">Participation</span>
+<span class="menuSelected">Participation/Wiki</span>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
@@ -318,6 +318,26 @@
at Eric S. Raymond's and Rick Moen's explanation of
<a href="http://www.catb.org/~esr/faqs/smart-questions.html";>"How to Ask
Questions The Smart Way</a>.
</p>
+
+
+<div class="h3">
+<h3>jUDDI Wiki</h3>
+</div>
+
+
+<p>Like other Apache projects, jUDDI maintains a wiki, a sort of virtual
+ meeting place for the jUDDI community. This is a resource available
+ to everyone, and you are encouraged to contribute. This is a good resource
+ for 'HowTos' for common configuration issues.
+ <ul>
+
+<li>
+<a href="http://wiki.apache.org/ws/jUDDI";>http://wiki.apache.org/ws/jUDDI</a>
+</li>
+
+</ul>
+
+</p>
1.3 +79 -50 ws-site/targets/juddi/participate.pdf
<<Binary file>>
1.4 +3 -3 ws-site/targets/juddi/releases.html
Index: releases.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/releases.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- releases.html 31 Mar 2004 16:15:21 -0000 1.3
+++ releases.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
1.4 +231 -20 ws-site/targets/juddi/site.html
Index: site.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/site.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- site.html 31 Mar 2004 16:15:21 -0000 1.3
+++ site.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
@@ -286,10 +286,41 @@
<h2>News</h2>
</div>
+
<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+<b>March 24, 2004</b>
+ jUDDI graduates from the Apache Incubator into Apache Web
+ Services Project.</p>
+
-</p>
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+<b>Oct 08, 2003</b>
+ The Apache Software Foundation's Web
Services PMC (http://ws.apache.org/)
+ voted to accept jUDDI into the Apache
Incubator. The move is expected
+ to be complete in early December.</p>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+<b>July 22, 2003</b>
+ A proposal to contribute jUDDI to the
Apache Software Foundation's
+ Web Services Project is being
considered.</p>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+<b>July 22, 2003</b>
+ Version 0.8.0 is now available.</p>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+<b>June 27, 2003</b>
+ Version 0.7.1 is now available.</p>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+<b>April 22, 2003</b>
+ Version 0.7.0 is now available.</p>
+
@@ -947,6 +978,26 @@
<a href="#http://www.catb.org/~esr/faqs/smart-questions.html";>"How to Ask
Questions The Smart Way</a>.
</p>
+
+<div class="h2">
+<h2>jUDDI Wiki</h2>
+</div>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>Like other Apache
projects, jUDDI maintains a wiki, a sort of virtual
+ meeting place for the jUDDI community. This is a resource available
+ to everyone, and you are encouraged to contribute. This is a good resource
+ for 'HowTos' for common configuration issues.
+ <ul>
+
+<li>
+<a href="http://wiki.apache.org/ws/jUDDI";>http://wiki.apache.org/ws/jUDDI</a>
+</li>
+
+</ul>
+
+</p>
+
@@ -1095,14 +1146,188 @@
</div>
<div class="h2">
-<h2>Installation Guide</h2>
+<h2>Requirements</h2>
+</div>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>jUDDI is a pure Java web
application and as such can be deployed to
+ any application server or servlet engine that supports version 2.1 or
+ later of the servlet API. If you need an application server, we
+ recommend <a href="http://jakarta.apache.org/tomcat/";>Jakarta
+ Tomcat</a>. Note also that jUDDI requires Java 1.3 or later. As
+ with any Java web application, deployment to your application server
+ or servlet engine will vary on a product-by-product basis.
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>Instructions for deploying
jUDDI to several application servers have
+ been donated and are available in the <a
href="http://wiki.apache.org/ws/jUDDI";>HOWTO</a>
+ section of the jUDDI wiki.
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>jUDDI also requires an
external datastore in which to save and search
+ for published web services data. Database schemas for several
+ different relational database are included with the jUDDI release.
+ Again, instructions describing how to create a jUDDI datastore using
+ several different database servers are available in the
+ <a href="http://wiki.apache.org/ws/jUDDI";>HOWTO</a> section of the jUDDI
wiki.
+ </p>
+
+
+
+<div class="h2">
+<h2>Configuration</h2>
+</div>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>To properly configure and
deploy jUDDI it will be helpful to understand
+ a bit about it's architecture. jUDDI consist of a core request processor
+ that unmarshalls incoming UDDI requests, invoking the appropriate UDDI
+ function and marshalling UDDI responses (marshalling and unmarshalling
+ is the process of converting XML data to/from Java objects).
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>To invoke a UDDI function
jUDDI employs the services of three
+ configurable sub-components or modules that handle persistence (the
+ DataStore), authentication (the Authenticator) and the generation of
+ UUID's (the UUIDGen). jUDDI is bundled and pre-configured to use
+ default implementations of each of these modules to help you get
+ jUDDI up and running quickly. The module categories and a
+ description of the default implementations are described below.
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>Several public Java
interfaces for creating your own DataStore,
+ Authenticator and UUIDGen module implementations are available. Please
+ see the <a href="#/devguide.html">jUDDI Developer's Guide</a> for
+ more information regarding jUDDI module development.
+ </p>
+
+
+
+<div class="h2">
+<h2>Persistence (jUDDI DataStore)</h2>
</div>
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>The default jUDDI
DataStore is implemented using JDBC and the process
+ of setting this up is fairly straight forward. Start by creating a new
+ jUDDI database using one of the following database schemas.
+ </p>
+
<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+
+<a href="dbscripts/juddi_mysql.ddl">MySQL</a>
+ <a href="dbscripts/juddi_db2.ddl">DB2</a>
+ <a href="dbscripts/juddi_hsql.ddl">HSQL</a>
+ <a href="dbscripts/juddi_ase.ddl">Sybase</a>
+ <a href="dbscripts/juddi_postresql.ddl">PostreSQL</a>
+ <a href="dbscripts/juddi_oracle.ddl">Oracle</a>
+ <a href="dbscripts/juddi_totalxml.ddl">TotalXML</a>
+ <a href="dbscripts/juddi_jds.ddl">JDataStore</a> (Borland)
+ </p>
-</p>
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>If a schema for your DBMS
is not listed, one simply hasn't been
+ created yet. You can use the available schemas as a guide for
+ creating one (and if you're feeling generous please consider
+ contributing it).
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>To complete the DataStore
set up you'll need to configure a JNDI
+ Datasource named 'jdbc/juddiDB' in the application server or servlet
+ engine that you're deploying to. Datasource setup varies on an
+ product-by-product basis so review documentation for your application
+ server. If you're deploying jUDDI to Jakarta Tomcat, take a look at
+ the JNDI Datasource HOW-TO for assistance.
+ </p>
+
+
+
+<div class="h2">
+<h2>Authentication (jUDDI Authenticator)</h2>
+</div>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>Authenticating a jUDDI
publisher is a two-step process. The first step
+ confirms that the ID/password combination provided by the user is valid.
+ It is expected that a typical jUDDI deployment will use an external
+ authentication mechanism. The default authentication module simply
+ approves any authentication attempt. It is our hope that additional
+ jUDDI authentication implementations will be developed by jUDDI users
+ as they determine how they would like authentication to take place in
+ their particular environment. See the jUDDI Developers Guide for more
+ information on developing a custom jUDDI authentication module.
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>The second step confirms
that the publisher has been defined to
+ jUDDI. A publisher is said to be defined when a row identifying the
+ publisher exists in the PUBLISHER table of the jUDDI datastore. At the
+ moment the only way to do this is via SQL. An example of defining a
+ new publisher named John Doe would look like this:
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+ INSERT INTO PUBLISHER (PUBLISHER_ID,PUBLISHER_NAME,ADMIN,ENABLED)
+ VALUES ('jdoe','John Doe','false','true');
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>The PUBLISHER table
consists of several columns but only four of them
+ are required and they are defined as follows:
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+ Column Name Description
+ PUBLISHER_ID The user ID the publisher uses when authenticating.
IMPORTANT: This should be the same value used to authenticate with the external
authentication service.
+ PUBLISHER_NAME The publisher's name (or in UDDI speak the Authorized Name).
+ ADMIN Indicate if the publisher has administrative privileges. Valid
values for this column are 'true' or 'false'. The ADMIN value is currently not used.
+ ENABLED Indicate if the publishers account is enabled and eligible for use.
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>The jUDDI web application
will (eventually) be extended to facilitate
+ the Publisher creation process. The value of the ADMIN column in the
+ PUBLISHER table above will be used to determine who has the privilege
+ to create new jUDDI publishers.
+ </p>
+
+
+
+<div class="h2">
+<h2>UUID Generation (jUDDI UUIDGen)</h2>
+</div>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>There's nothing for you to
do here but I thought I'd offer a little
+ information about how, why and where jUDDI makes use of UUID generation.
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>The UDDI specification
indicates that each Business, Service, Binding
+ and TModel (Technical Model) is to be uniquely identified by a
+ Universally Unique ID (UUID). Additionally, jUDDI also uses the UUID
+ generator to create AuthTokens.
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>Generation of UUID's
typically requires access to hardware level
+ information that (unfortunately) is not accessible from Java.
+ Fortunately, the UUID specification offers an alternative method for
+ generating these ID's when this hardware information is not present.
+ By default the jUDDI implements this alternative method.
+ </p>
+
+
+
+<div class="h2">
+<h2>Logging</h2>
+</div>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>When deploying jUDDI you
may wish to make changes to the
+ juddi.properties and log4j.properties files. These files are located in
+ the juddi webapp's WEB-INF/classes directory. They're here because
+ they need to be in the classpath for jUDDI to locate and load them at
+ runtime. One Log4j property value that you'll most likely want to set
+ is log4j.appender.LOGFILE.File which specifies the name and location of
+ the jUDDI log file.
+ </p>
+
<div class="h4">
@@ -1164,20 +1389,6 @@
-<div class="h4">
-<h4>jUDDI Architecture Guide</h4>
-</div>
-
-<div class="h2">
-<h2>Architecture Guide</h2>
-</div>
-
-
-<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
-
-</p>
-
-
<div class="h3">
<h3>Downloads</h3>
1.4 +1392 -1097ws-site/targets/juddi/site.pdf
<<Binary file>>
1.4 +3 -3 ws-site/targets/juddi/usersguide.html
Index: usersguide.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/usersguide.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- usersguide.html 31 Mar 2004 16:15:21 -0000 1.3
+++ usersguide.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
1.4 +3 -3 ws-site/targets/juddi/who.html
Index: who.html
===================================================================
RCS file: /home/cvs/ws-site/targets/juddi/who.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- who.html 31 Mar 2004 16:15:21 -0000 1.3
+++ who.html 7 Apr 2004 17:58:25 -0000 1.4
@@ -110,7 +110,7 @@
</div>
<div class="menuItem">
-<a href="faq.html" title="FAQ">FAQ/Wiki</a>
+<a href="faq.html" title="FAQ">FAQ</a>
</div>
<div class="menuItem">
@@ -122,7 +122,7 @@
</div>
<div class="menuItem">
-<a href="participate.html" title="Participation">Participation</a>
+<a href="participate.html" title="Participation">Participation/Wiki</a>
</div>
<div class="menuItem">
@@ -150,7 +150,7 @@
</div>
<div class="menuItem">
-<a href="archguide.html" title="Architecture Guide">Architecture Guide</a>
+<a href="http://wiki.apache.org/ws/jUDDI"; title="How-Tos">How-Tos</a>
</div>
</div>
