This project has retired. For details please refer to its Attic page.
<link rel="stylesheet" type="text/css" href="css/jbossorg.css"/><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"/><link rel="home" href="index.html" title=""/><link rel="next" href="pr01.html" title=""/><link rel="copyright" href="ln-d2e27.html" title=""/><meta xmlns:d="http://docbook.org/ns/docbook" xmlns:rf="java:org.jboss.highlight.XhtmlRendererFactory" http-equiv="Content-Type" content="text/html; charset=UTF-8"/></head><body><p xmlns:d="http://docbook.org/ns/docbook" id="title"><a href="http://www.jboss.org" class="site_href"><strong>JBoss.org</strong></a><a href="http://docs.jboss.org/" class="doc_href"><strong>Community Documentation</strong></a></p><ul xmlns:d="http://docbook.org/ns/docbook" class="docnav"><li class="previous"/><li class="next"><a accesskey="n" href="pr01.html"><strong/></a></li></ul><div xml:lang="en" class="book"><div class="titlepage"><div><div><h1 class="title"><a id="d2e1"/>Apache jUDDI Guide</h1></div><div><div class="authorgroup">   <div class="author"><h3 class="author"><span class="firstname">Kurt</span> <span class="othername">T</span> <span class="surname">Stam</span></h3><div class="affiliation"> <span class="shortaffil">RedHat<br/></span> <span class="jobtitle">Enterprise Integration Magician (EIM)<br/></span> <span class="orgname">Red Hat, Inc.<br/></span> <span class="orgdiv"><a class="ulink" href="http://www.jboss.org/overlord">SOA Governance</a><br/></span> <div class="authorblurb"> <p> Open Source, written by domain experts. </p> </div> </div></div> <div class="author"><h3 class="author"><span class="firstname">Alex</span> <span class="surname">O'Ree</span></h3><div class="affiliation"> <span class="shortaffil">Apache Software Foundation (ASF)<br/></span> <span class="orgname">Apache Software Foundation (ASF), http://juddi.apache.org<br/></span> </div></div> </div></div><div><p class="copyright"> © 2003-2014 The Apache Software Foundation</p></div><div><a href="ln-d2e27.html"/></div></div><hr/></div><div class="dedication"><div class="titlepage"><div><div><h2 class="title"><a id="_dedication"/></h2></div></div></div> <p>We’d like to dedicate this guide to Steve Viens and Andy Cutright who started this project back in 2003.</p> </div><div class="toc"><p><strong/></p><dl><dt><span class="preface"><a href="pr01.html">Preface</a></span></dt><dt><span class="chapter"><a href="ch01.html">1. Universal Description, Discovery and Integration (UDDI)</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#_uddi_protocol_specification">1.1. UDDI Protocol, Specification</a></span></dt><dt><span class="section"><a href="ch01.html#_uddi_registry">1.2. UDDI Registry</a></span></dt><dt><span class="section"><a href="ch01.html#_juddi_project">1.3. jUDDI Project</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch02.html">2. Getting Started</a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#_prerequisites">2.1. Prerequisites</a></span></dt><dt><span class="section"><a href="ch02.html#_what_should_i_download">2.2. What should I Download?</a></span></dt><dt><span class="section"><a href="ch02.html#_running_juddi">2.3. Running jUDDI</a></span></dt><dt><span class="section"><a href="ch02.html#_using_the_juddi_administrative_interface">2.4. Using the jUDDI Administrative Interface</a></span></dt><dt><span class="section"><a href="ch02.html#_using_juddi_web_services">2.5. Using jUDDI Web Services</a></span></dt><dt><span class="section"><a href="ch02.html#_using_juddi_gui_to_create_your_keygenerator_and_business">2.6. Using jUDDI GUI to create your keygenerator and business</a></span></dt><dt><span class="section"><a href="ch02.html#_running_the_demos_in_the_disto">2.7. Running the demos in the disto</a></span></dt><dt><span class="section"><a href="ch02.html#_examples_on_the_juddi_blog">2.8. Examples on the jUDDI blog</a></span></dt><dt><span class="section"><a href="ch02.html#_what_is_new_in_juddi_3_2">2.9. What is new in jUDDI 3.2?</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch03.html">3. jUDDI Architecture</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#_juddi_server">3.1. jUDDI Server</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#_uddi_api_layer_literal_uddi_ws_literal_using_jax_ws">3.1.1. UDDI API layer <code class="literal">uddi-ws</code> using JAX-WS</a></span></dt><dt><span class="section"><a href="ch03.html#_core_uddi_literal_juddi_core_literal_using_jpa">3.1.2. Core UDDI <code class="literal">juddi-core</code> using JPA</a></span></dt><dt><span class="section"><a href="ch03.html#_relational_databases">3.1.3. Relational Databases</a></span></dt><dt><span class="section"><a href="ch03.html#_servlet_containers">3.1.4. Servlet Containers</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#_juddi_gui_literal_juddi_gui_war_literal">3.2. jUDDI GUI <code class="literal">juddi-gui.war</code></a></span></dt></dl></dd><dt><span class="chapter"><a href="ch04.html">4. Administration</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#_changing_the_web_server_listen_port">4.1. Changing the Web Server Listen Port</a></span></dt><dt><span class="section"><a href="ch04.html#_administering_users_and_access_control">4.2. Administering Users and Access Control</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#_administrative_users">4.2.1. Administrative Users</a></span></dt><dt><span class="section"><a href="ch04.html#_end_users">4.2.2. End Users</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#ConfiguringDatabaseConnections">4.3. Configuration Database Connections</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#_derby_out_of_the_box">4.3.1. Derby Out-of-the-Box</a></span></dt><dt><span class="section"><a href="ch04.html#_switching_to_another_database">4.3.2. Switching to another Database</a></span></dt><dt><span class="section"><a href="ch04.html#_switch_to_mysql_on_tomcat_using_openjpa">4.3.3. Switch to MySQL on Tomcat using OpenJPA</a></span></dt><dt><span class="section"><a href="ch04.html#_switch_to_postgres_on_tomcat_using_openjpa">4.3.4. Switch to Postgres on Tomcat using OpenJPA</a></span></dt><dt><span class="section"><a href="ch04.html#_switch_to_postgres_on_jboss_using_hibernate">4.3.5. Switch to Postgres on JBoss using Hibernate</a></span></dt><dt><span class="section"><a href="ch04.html#_switch_to_oracle_on_tomcat_using_hibernate">4.3.6. Switch to Oracle on Tomcat using Hibernate</a></span></dt><dt><span class="section"><a href="ch04.html#_switch_to_hsql_on_tomcat_using_hibernate">4.3.7. Switch to HSQL on Tomcat using Hibernate</a></span></dt><dt><span class="section"><a href="ch04.html#_switch_to_other_db">4.3.8. Switch to other db</a></span></dt><dt><span class="section"><a href="ch04.html#_override_persistence_properties_in_the_juddiv3_xml">4.3.9. Override persistence properties in the juddiv3.xml</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#_logging">4.4. Logging</a></span></dt><dt><span class="section"><a href="ch04.html#_administering_the_gui_juddi_gui_war">4.5. Administering the GUI (juddi-gui.war)</a></span></dt><dt><span class="section"><a href="ch04.html#_task_signing_the_digital_signature_applet_jar_file">4.6. Task: Signing the Digital Signature Applet jar file</a></span></dt><dt><span class="section"><a href="ch04.html#_administrating_your_juddi_instance_using_the_administrative_console">4.7. Administrating your jUDDI Instance using the Administrative Console</a></span></dt><dt><span class="section"><a href="ch04.html#_configure_juddi">4.8. Configure jUDDI</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#_enabling_remote_access">4.8.1. Enabling Remote Access</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#_monitoring_the_status_and_statistics">4.9. Monitoring the Status and Statistics</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#_statistics">4.9.1. Statistics</a></span></dt><dt><span class="section"><a href="ch04.html#_status">4.9.2. Status</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#_accessing_the_juddiv3_api">4.10. Accessing the jUDDIv3 API</a></span></dt><dt><span class="section"><a href="ch04.html#_security_guidance">4.11. Security Guidance</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#_juddi_server_2">4.11.1. jUDDI Server</a></span></dt><dt><span class="section"><a href="ch04.html#_juddi_client_and_developers">4.11.2. jUDDI Client (and developers)</a></span></dt><dt><span class="section"><a href="ch04.html#_juddi_gui_web_user_interface">4.11.3. jUDDI GUI (Web user interface)</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#_backups_upgrading_and_data_migration">4.12. Backups, Upgrading and Data Migration</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#_database_backups">4.12.1. Database Backups</a></span></dt><dt><span class="section"><a href="ch04.html#_config_backup">4.12.2. Config Backup</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#_upgrading_juddi">4.13. Upgrading jUDDI</a></span></dt><dt><span class="section"><a href="ch04.html#_scaling_juddi_and_federation">4.14. Scaling jUDDI and Federation</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#_scaling_the_juddi_services_multiple_servers">4.14.1. Scaling the jUDDI Services (multiple servers)</a></span></dt><dt><span class="section"><a href="ch04.html#_limitations_of_juddi">4.14.2. Limitations of jUDDI</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch05.html">5. jUDDI Server Configuration (<code class="literal">juddiv3.xml</code>)</a></span></dt><dd><dl><dt><span class="section"><a href="ch05.html#_authentication">5.1. Authentication</a></span></dt><dt><span class="section"><a href="ch05.html#_startup">5.2. Startup</a></span></dt><dt><span class="section"><a href="ch05.html#_email">5.3. Email</a></span></dt><dt><span class="section"><a href="ch05.html#_query_properties">5.4. Query Properties</a></span></dt><dt><span class="section"><a href="ch05.html#_rmi_proxy">5.5. RMI Proxy</a></span></dt><dt><span class="section"><a href="ch05.html#_key_generation_and_cryptography">5.6. Key Generation and Cryptography</a></span></dt><dt><span class="section"><a href="ch05.html#_subscription">5.7. Subscription</a></span></dt><dt><span class="section"><a href="ch05.html#_custody_transfer">5.8. Custody Transfer</a></span></dt><dt><span class="section"><a href="ch05.html#_validation">5.9. Validation</a></span></dt><dt><span class="section"><a href="ch05.html#_logging_2">5.10. Logging</a></span></dt><dt><span class="section"><a href="ch05.html#_performance">5.11. Performance</a></span></dt><dt><span class="section"><a href="ch05.html#_replication">5.12. Replication</a></span></dt><dt><span class="section"><a href="ch05.html#_deploying_two_or_more_juddi_server_on_the_same_application_server">5.13. Deploying two or more jUDDI server on the same application server</a></span></dt><dt><span class="section"><a href="ch05.html#_juddi_gui_configuration">5.14. jUDDI GUI Configuration</a></span></dt><dt><span class="section"><a href="ch05.html#_juddi_client_uddi_xml_settings">5.15. jUDDI Client uddi.xml Settings</a></span></dt><dt><span class="section"><a href="ch05.html#_encryption_keys">5.16. Encryption Keys</a></span></dt><dt><span class="section"><a href="ch05.html#_customizing_the_juddi_gui">5.17. Customizing the juddi-gui</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch06.html">6. Replication Services</a></span></dt><dd><dl><dt><span class="section"><a href="ch06.html#_introduction">6.1. Introduction</a></span></dt><dt><span class="section"><a href="ch06.html#_uddiv3_replication_overview">6.2. UDDIv3 Replication Overview</a></span></dt><dd><dl><dt><span class="section"><a href="ch06.html#_uddiv3_replication_topology">6.2.1. UDDIv3 Replication Topology</a></span></dt><dt><span class="section"><a href="ch06.html#_conflict_handling">6.2.2. Conflict handling</a></span></dt></dl></dd><dt><span class="section"><a href="ch06.html#_configuring_your_juddi_node_for_replication">6.3. Configuring your jUDDI Node for replication</a></span></dt><dd><dl><dt><span class="section"><a href="ch06.html#_changing_the_node_id">6.3.1. Changing the Node ID</a></span></dt><dt><span class="section"><a href="ch06.html#_setting_up_client_cert_authentication">6.3.2. Setting up CLIENT-CERT authentication</a></span></dt><dt><span class="section"><a href="ch06.html#_setting_the_replication_configuration">6.3.3. Setting the Replication Configuration</a></span></dt><dt><span class="section"><a href="ch06.html#_performing_custody_transfer_between_nodes">6.3.4. Performing Custody Transfer between nodes</a></span></dt><dt><span class="section"><a href="ch06.html#_what_s_supported_and_what_s_not">6.3.5. What’s Supported and What’s Not</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch07.html">7. UDDI Seed Data</a></span></dt><dd><dl><dt><span class="section"><a href="ch07.html#_seed_data_files">7.1. Seed Data Files</a></span></dt><dt><span class="section"><a href="ch07.html#_tokens_in_the_seed_data">7.2. Tokens in the Seed Data</a></span></dt><dt><span class="section"><a href="ch07.html#_customer_seed_data">7.3. Customer Seed Data</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch08.html">8. How to deploy jUDDI To?</a></span></dt><dd><dl><dt><span class="section"><a href="ch08.html#_tomcat">8.1. Tomcat</a></span></dt><dd><dl><dt><span class="section"><a href="ch08.html#_openjpa_and_cxf">8.1.1. OpenJPA and CXF</a></span></dt><dt><span class="section"><a href="ch08.html#_hibernate_and_cxf">8.1.2. Hibernate and CXF</a></span></dt><dt><span class="section"><a href="ch08.html#_openjpa_and_axis2">8.1.3. OpenJPA and Axis2</a></span></dt></dl></dd><dt><span class="section"><a href="ch08.html#_jboss">8.2. JBoss</a></span></dt><dd><dl><dt><span class="section"><a href="ch08.html#_jbossas_6_0_0_ga">8.2.1. JBossAS 6.0.0.GA</a></span></dt><dt><span class="section"><a href="ch08.html#_jbossas_7_x_jbosseap_6_x">8.2.2. JBossAS 7.x/JBossEAP-6.x</a></span></dt></dl></dd><dt><span class="section"><a href="ch08.html#_deploying_to_glassfish">8.3. Deploying to Glassfish</a></span></dt><dd><dl><dt><span class="section"><a href="ch08.html#_glassfish_jars">8.3.1. Glassfish jars</a></span></dt><dt><span class="section"><a href="ch08.html#_configure_the_juddi_datasource">8.3.2. Configure the JUDDI datasource</a></span></dt><dt><span class="section"><a href="ch08.html#_add_juddiv3_cxf_war">8.3.3. Add juddiv3-cxf.war</a></span></dt><dt><span class="section"><a href="ch08.html#_run_juddi">8.3.4. Run jUDDI</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch09.html">9. Extending UDDI</a></span></dt><dd><dl><dt><span class="section"><a href="ch09.html#_authentication_modules">9.1. Authentication modules</a></span></dt><dt><span class="section"><a href="ch09.html#_subscription_notification_handlers">9.2. Subscription Notification Handlers</a></span></dt><dt><span class="section"><a href="ch09.html#_keyedreference_value_set_validation_services">9.3. KeyedReference Value Set Validation Services</a></span></dt><dt><span class="section"><a href="ch09.html#_cryptographic_providers">9.4. Cryptographic Providers</a></span></dt><dt><span class="section"><a href="ch09.html#_juddi_client_transport">9.5. jUDDI Client Transport</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch10.html">10. Digital Signatures</a></span></dt><dd><dl><dt><span class="section"><a href="ch10.html#_requirements">10.1. Requirements</a></span></dt><dt><span class="section"><a href="ch10.html#_using_digital_signatures_using_the_juddi_gui">10.2. Using Digital Signatures using the jUDDI GUI</a></span></dt><dt><span class="section"><a href="ch10.html#_frequently_asked_questions">10.3. Frequently Asked Questions</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch11.html">11. Troubleshooting jUDDI</a></span></dt><dd><dl><dt><span class="section"><a href="ch11.html#_juddi_web_services_juddiv3_war">11.1. jUDDI Web Services, juddiv3.war</a></span></dt><dd><dl><dt><span class="section"><a href="ch11.html#_enable_debugging_logging">11.1.1. Enable debugging logging</a></span></dt></dl></dd><dt><span class="section"><a href="ch11.html#_juddi_gui_juddi_gui_war">11.2. jUDDI GUI, juddi-gui.war</a></span></dt><dt><span class="section"><a href="ch11.html#_juddi_client_java">11.3. jUDDI Client Java</a></span></dt><dd><dl><dt><span class="section"><a href="ch11.html#_enable_debugging_logging_2">11.3.1. Enable debugging logging</a></span></dt></dl></dd><dt><span class="section"><a href="ch11.html#_juddi_client_net">11.4. jUDDI Client .NET</a></span></dt><dt><span class="section"><a href="ch11.html#_getting_help">11.5. Getting help</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch12.html">12. Contributing to jUDDI</a></span></dt><dd><dl><dt><span class="section"><a href="ch12.html#_license_guidance">12.1. License guidance</a></span></dt><dt><span class="section"><a href="ch12.html#_svn_access">12.2. SVN access</a></span></dt><dt><span class="section"><a href="ch12.html#_project_structure">12.3. Project structure</a></span></dt><dt><span class="section"><a href="ch12.html#_building_and_testing_juddi">12.4. Building and testing jUDDI</a></span></dt><dd><dl><dt><span class="section"><a href="ch12.html#_all_java_components">12.4.1. All Java Components</a></span></dt><dt><span class="section"><a href="ch12.html#__net">12.4.2. .NET</a></span></dt></dl></dd><dt><span class="section"><a href="ch12.html#_other_ways_to_contribute_to_juddi">12.5. Other ways to Contribute to jUDDI</a></span></dt><dd><dl><dt><span class="section"><a href="ch12.html#_bug_reports">12.5.1. Bug Reports</a></span></dt><dt><span class="section"><a href="ch12.html#_internationalization">12.5.2. Internationalization</a></span></dt><dt><span class="section"><a href="ch12.html#_contributing_source_code">12.5.3. Contributing Source code</a></span></dt><dt><span class="section"><a href="ch12.html#_releases">12.5.4. Releases</a></span></dt></dl></dd><dt><span class="section"><a href="ch12.html#_what_the">12.6. What the?</a></span></dt></dl></dd><dt><span class="bibliography"><a href="bi01.html">Bibliography</a></span></dt><dt><span class="index"><a href="ix01.html">Index</a></span></dt></dl></div><div class="list-of-figures"><p><strong/></p><dl><dt>1.1. <a href="ch01.html#figure-UDDIREG-InvocationPattern">Invocation Pattern using the UDDI Registry</a></dt><dt>2.1. <a href="ch02.html#figure-GettingStarted-Welcome">jUDDI welcome page</a></dt><dt>2.2. <a href="ch02.html#figure--GettingStarted-Admin">jUDDI admin</a></dt><dt>2.3. <a href="ch02.html#figure-GettingStarted-HappyjUDDI">Happy jUDDI.</a></dt><dt>2.4. <a href="ch02.html#figure-GettingStarted-FormLogin">Form login</a></dt><dt>2.5. <a href="ch02.html#figure-GettingStarted-AddPublisher">Add Publisher</a></dt><dt>2.6. <a href="ch02.html#figure-GettingStarted-jUDDIServices">jUDDI Services</a></dt><dt>2.7. <a href="ch02.html#figure-GettingStarted-SoapUI">Getting an authToken using SoapUI</a></dt><dt>2.8. <a href="ch02.html#figure-GettingStarted-CreateKeygenerator">Create Key Generator</a></dt><dt>2.9. <a href="ch02.html#figure-GettingStarted-CreateBusiness">Create Business</a></dt><dt>3.1. <a href="ch03.html#figure-jUDDIArchitecture-Architecture">jUDDI Architecture</a></dt><dt>3.2. <a href="ch03.html#figure-jUDDIArchitecture-ClientGui">jUDDI Client and Console Architecture</a></dt><dt>3.3. <a href="ch03.html#figure-jUDDIArchitecture-Gui">jUDDI Console Architecture</a></dt><dt>4.1. <a href="ch04.html#figure-GuideAdministrator-Configure">jUDDI Server Configuration Page.</a></dt><dt>4.2. <a href="ch04.html#figure-GuideAdministrator-Statistics">jUDDI Server Statistics.</a></dt><dt>4.3. <a href="ch04.html#figure-GuideAdministrator-MBeans">jUDDI MBeans.</a></dt><dt>4.4. <a href="ch04.html#figure-GuideAdministrator-Status">jUDDI Server Status.</a></dt><dt>4.5. <a href="ch04.html#figure-GuideAdministrator-API">jUDDI API.</a></dt></dl></div><div class="list-of-tables"><p><strong/></p><dl><dt>1.1. <a href="ch01.html#d2e97">Supported UDDI Interfaces</a></dt><dt>1.2. <a href="ch01.html#d2e230">jUDDI Features</a></dt><dt>1.3. <a href="ch01.html#d2e321">Supported Sort Orders</a></dt><dt>1.4. <a href="ch01.html#d2e413">Supported Find Qualifiers</a></dt><dt>4.1. <a href="ch04.html#d2e1062">Hibernate properties that can be referenced in the <span class="emphasis"><em>juddiv3.xml</em></span> file</a></dt><dt>5.1. <a href="ch05.html#d2e1331">Authentication properties that can be referenced in the juddiv3.xml file</a></dt><dt>5.2. <a href="ch05.html#d2e1413">Startup properties that can be referenced in the <span class="emphasis"><em>juddiv3.xml</em></span> file</a></dt><dt>5.3. <a href="ch05.html#d2e1694">Query properties that can be referenced in the <span class="emphasis"><em>juddiv3.xml</em></span> file</a></dt><dt>5.4. <a href="ch05.html#d2e1853">UDDI Key generation properties that can be referenced in the <code class="literal">juddiv3.xml</code> file.</a></dt><dt>5.5. <a href="ch05.html#d2e1903">Subscription properties that can be referenced in the <span class="emphasis"><em>juddiv3.xml</em></span> file.</a></dt><dt>5.6. <a href="ch05.html#d2e2003">Transfer properties that can be referenced in the <span class="emphasis"><em>juddiv3.xml</em></span> file.</a></dt><dt>5.7. <a href="ch05.html#d2e2031">These settings are for validating the data that users store in jUDDI. They can be referenced in the <span class="emphasis"><em>juddiv3.xml</em></span> file.</a></dt><dt>5.8. <a href="ch05.html#d2e2285">jUDDI GUI Configuration</a></dt></dl></div> </div><ul xmlns:d="http://docbook.org/ns/docbook" class="docnav"><li class="previous"/><li class="next"><a accesskey="n" href="pr01.html"><strong/></a></li></ul></body></html>