JBoss.orgCommunity Documentation

Chapter 11. Using the UDDI Technology Compatibility Kit

Table of Contents

11.1. Using the TCK Runner
11.1.1. Configuration
11.1.2. Running the TCK Runner
11.2. Analyzing the Results

Since UDDI is a specification with many complex rules in it, we (the jUDDI team) have had to write test cases to exercise each of the rules and restrictions in UDDI. Knowing that there are a number of open source and commercial UDDI v3 implementations, the jUDDI team took this as an opportunity to create a reusable benchmark for testing the compatibility of UDDI v3 implementations.


Although the TCK covers a large number of test cases, the UDDI specification is long and complex. It’s more than possible that we missed a few scenarios or test cases. If you run across any, please let us know.

The TCK Runner requires a few files to operate:

  1. juddi-tck-runner-version.jar - This is the executable
  2. uddi.xml - This file sets the location of the UDDI services
  3. tck.properties - This file controls what tests are ran.
  4. truststore and keystore.jks - These files are for digital signature tests
  • Edit the uddi.xml file and update all of the UDDI endpoint locations for all supported endpoints of UDDI server being tested. Ignore all credentials and other settings
  • Edit tck.properties and update the usernames and passwords of the test users. Enable or disable tests based on the whether or not the UDDI server supports the optional listed capabilities.


Do not use usernames and passwords that already have data associated with it.

A few of the test cases, such as RMI transport, are not identified by the UDDI specification, therefore the results may be skewed if unsupported tests are attempted. In addition, the UDDI specification identifies a number of APIs and features that are considered optional.

Although it is possible to run the TCK against a UDDIv2 registry using the UDDIv2 transport adapters, this is not supported. The TCK’s test cases and rules apply to the business rules defined in UDDIv3. Unsupported and unmapped functions defined in UDDIv3 that are not supported in UDDIv2 fail ultimately fail.

There are two ways to identify the result of the tests.

  • Analyze the console output
  • Review the test results in uddi-tck-results-[DateTime].txt

The results are summarized in the uddi-tck-results file along with the specific error conditions and stack traces that will enable you to find out the root cause of the failure. It may be necessary to obtain UDDI server logs to help with root cause identification.