JBoss.orgCommunity Documentation

Apache jUDDI Guide

 

Alex O'Ree

Apache Software Foundation (ASF)
Apache Software Foundation (ASF), http://juddi.apache.org
Legal Notice

We’d like to dedicate this guide to Steve Viens and Andy Cutright who started this project back in 2003.

Table of Contents

Preface
1. Universal Description, Discovery and Integration (UDDI)
1.1. UDDI Protocol, Specification
1.2. UDDI Registry
1.3. jUDDI Project
2. Getting Started
2.1. Prerequisites
2.2. What should I Download?
2.3. Running jUDDI
2.4. Using the jUDDI Administrative Interface
2.5. Using jUDDI Web Services
2.6. Using jUDDI GUI to create your keygenerator and business
2.7. Running the demos in the disto
2.8. Examples on the jUDDI blog
2.9. What is new in jUDDI 3.2?
3. jUDDI Architecture
3.1. jUDDI Server
3.1.1. UDDI API layer uddi-ws using JAX-WS
3.1.2. Core UDDI juddi-core using JPA
3.1.3. Relational Databases
3.1.4. Servlet Containers
3.2. jUDDI GUI juddi-gui.war
4. Administration
4.1. Changing the Web Server Listen Port
4.2. Administering Users and Access Control
4.2.1. Administrative Users
4.2.2. End Users
4.3. Configuration Database Connections
4.3.1. Derby Out-of-the-Box
4.3.2. Switching to another Database
4.3.3. Switch to MySQL on Tomcat using OpenJPA
4.3.4. Switch to Postgres on Tomcat using OpenJPA
4.3.5. Switch to Postgres on JBoss using Hibernate
4.3.6. Switch to Oracle on Tomcat using Hibernate
4.3.7. Switch to HSQL on Tomcat using Hibernate
4.3.8. Switch to other db
4.3.9. Override persistence properties in the juddiv3.xml
4.4. Logging
4.5. Administering the GUI (juddi-gui.war)
4.6. Task: Signing the Digital Signature Applet jar file
4.7. Administrating your jUDDI Instance using the Administrative Console
4.8. Configure jUDDI
4.8.1. Enabling Remote Access
4.9. Monitoring the Status and Statistics
4.9.1. Statistics
4.9.2. Status
4.10. Accessing the jUDDIv3 API
4.11. Security Guidance
4.11.1. jUDDI Server
4.11.2. jUDDI Client (and developers)
4.11.3. jUDDI GUI (Web user interface)
4.12. Backups, Upgrading and Data Migration
4.12.1. Database Backups
4.12.2. Config Backup
4.13. Upgrading jUDDI
4.14. Scaling jUDDI and Federation
4.14.1. Scaling the jUDDI Services (multiple servers)
4.14.2. Limitations of jUDDI
5. jUDDI Server Configuration (juddiv3.xml)
5.1. Authentication
5.2. Startup
5.3. Email
5.4. Query Properties
5.5. RMI Proxy
5.6. Key Generation and Cryptography
5.7. Subscription
5.8. Custody Transfer
5.9. Validation
5.10. Logging
5.11. Performance
5.12. Replication
5.13. Deploying two or more jUDDI server on the same application server
5.14. jUDDI GUI Configuration
5.15. jUDDI Client uddi.xml Settings
5.16. Encryption Keys
5.17. Customizing the juddi-gui
6. Replication Services
6.1. Introduction
6.2. UDDIv3 Replication Overview
6.2.1. UDDIv3 Replication Topology
6.2.2. Conflict handling
6.3. Configuring your jUDDI Node for replication
6.3.1. Changing the Node ID
6.3.2. Setting up CLIENT-CERT authentication
6.3.3. Setting the Replication Configuration
6.3.4. Performing Custody Transfer between nodes
6.3.5. What’s Supported and What’s Not
7. UDDI Seed Data
7.1. Seed Data Files
7.2. Tokens in the Seed Data
7.3. Customer Seed Data
8. How to deploy jUDDI To?
8.1. Tomcat
8.1.1. OpenJPA and CXF
8.1.2. Hibernate and CXF
8.1.3. OpenJPA and Axis2
8.2. JBoss
8.2.1. JBossAS 6.0.0.GA
8.2.2. JBossAS 7.x/JBossEAP-6.x
8.3. Deploying to Glassfish
8.3.1. Glassfish jars
8.3.2. Configure the JUDDI datasource
8.3.3. Add juddiv3-cxf.war
8.3.4. Run jUDDI
9. Extending UDDI
9.1. Authentication modules
9.2. Subscription Notification Handlers
9.3. KeyedReference Value Set Validation Services
9.4. Cryptographic Providers
9.5. jUDDI Client Transport
10. Digital Signatures
10.1. Requirements
10.2. Using Digital Signatures using the jUDDI GUI
10.3. Frequently Asked Questions
11. Troubleshooting jUDDI
11.1. jUDDI Web Services, juddiv3.war
11.1.1. Enable debugging logging
11.2. jUDDI GUI, juddi-gui.war
11.3. jUDDI Client Java
11.3.1. Enable debugging logging
11.4. jUDDI Client .NET
11.5. Getting help
12. Contributing to jUDDI
12.1. License guidance
12.2. SVN access
12.3. Project structure
12.4. Building and testing jUDDI
12.4.1. All Java Components
12.4.2. .NET
12.5. Other ways to Contribute to jUDDI
12.5.1. Bug Reports
12.5.2. Internationalization
12.5.3. Contributing Source code
12.5.4. Releases
12.6. What the?
Bibliography
Index

List of Figures

1.1. Invocation Pattern using the UDDI Registry
2.1. jUDDI welcome page
2.2. jUDDI admin
2.3. Happy jUDDI.
2.4. Form login
2.5. Add Publisher
2.6. jUDDI Services
2.7. Getting an authToken using SoapUI
2.8. Create Key Generator
2.9. Create Business
3.1. jUDDI Architecture
3.2. jUDDI Client and Console Architecture
3.3. jUDDI Console Architecture
4.1. jUDDI Server Configuration Page.
4.2. jUDDI Server Statistics.
4.3. jUDDI MBeans.
4.4. jUDDI Server Status.
4.5. jUDDI API.

List of Tables

1.1. Supported UDDI Interfaces
1.2. jUDDI Features
1.3. Supported Sort Orders
1.4. Supported Find Qualifiers
4.1. Hibernate properties that can be referenced in the juddiv3.xml file
5.1. Authentication properties that can be referenced in the juddiv3.xml file
5.2. Startup properties that can be referenced in the juddiv3.xml file
5.3. Query properties that can be referenced in the juddiv3.xml file
5.4. UDDI Key generation properties that can be referenced in the juddiv3.xml file.
5.5. Subscription properties that can be referenced in the juddiv3.xml file.
5.6. Transfer properties that can be referenced in the juddiv3.xml file.
5.7. These settings are for validating the data that users store in jUDDI. They can be referenced in the juddiv3.xml file.
5.8. jUDDI GUI Configuration