Installation Verification Program (IVP)

Before you begin

There are some samples available on the WebSphere Developer Domain (WSDD) web site (at http://www7b.software.ibm.com/wsdd/library/samples/AppServer.html) that are intended to provide an optional Installation Verification test, or IVP, for the UDDI Registry component.

This topic describes how to run these installation verification programs (IVPs) to verify that the IBM UDDI Registry has been installed correctly.

There are two IVP SOAP samples: SOAPSampleIVPa and SOAPSampleIVPb. They are intended to verify the successful installation of the product, and should be used in conjunction with the UDDI Users Console (GUI). SOAPSampleIVPa saves some data to the registry which you can then find using the GUI. Finally you can delete the data by running SOAPSampleIVPb.

The IVP samples are installed into the same target directory as the other SOAP samples and they use the same XML files as the basic Java SOAP samples.

SOAPSampleIVPa saves three businesses, six services (2 per business) and three tModels. The data structures are very basic and consist only of a name. The keys returned by the save_* UDDI API calls are then written to a file, SOAPSampleIVPa.out. SOAPSampleIVPb then reads in these keys from the file to delete the saved data from the UDDI registry.

Note: Each time you run SOAPSampleIVPa, it overwrites the output file SOAPSampleIVPa.out so, if you wish to use SOAPSampleIVPb to delete the data, you must run this before you next run SOAPSampleIVPa.

Note: As supplied, the IVP programs are written to work on a system without authentication. It is possible to configure the IVPs to work with authentication (see http://www7b.software.ibm.com/wsdd/library/samples/AppServer.html), however, if possible it is recommended you run them on a non-authenticated system.

Steps for this task

Perform the following steps on the same system as the UDDI Registry:

  1. Ensure that DB2 and the WebSphere Administrative Server are started.
  2. Start the WebSphere Administrator's Console and ensure the default server is started and the UDDI Registry Application is started.
  3. Ensure that you are using the correct level of Java. The samples require the IBM Developer Kit for Java, which is installed as part of the WebSphere Application Server installation. To ensure that you are using this version of Java, make sure that <WebSphere-install-dir>/java/bin is present in the PATH statement before any other versions of Java.

    Alternatively, this can be accomplished just for the shell where you plan to run the samples by modifying the path within the shell:

    export PATH=<WebSphere-install-dir>/java/bin:$PATH

  4. Copy the samples and *.xml files to a directory
  5. Compile both SOAPSampleIVPa and SOAPSampleIVPb by entering (from a command prompt):
    'javac SOAPSampleIVPa.java'
    and
    'javac SOAPSampleIVPb'
  6. Run SOAPSampleIVPa by entering 'java SOAPSampleIVPa'. This should publish a number of businesses and services and technical models into the registry.
  7. Start your Web browser on the same system as the UDDI Registry.
  8. To display the UDDI GUI home page, enter the following URL:
    • http://localhost:9080/uddigui
  9. On the find page, complete the following steps:
    1. Select the business radio button
    2. In the data entry field, enter % (the wild card symbol)
    3. Click Find

      You should get a results page returned with three businesses (mybusiness1, mybusiness2, and mybusiness3). This demonstrates that the API and the UDDI user console are working correctly.

  10. To see the services that are available for a business, click the "Show Services" option next to the business.
  11. To delete all of the IVP data, run SOAPSampleIVPb (from the command prompt as before - by entering 'java SOAPSampleIVPb')
  12. On the find page, complete the following steps:
    1. Select the business radio button
    2. In the data entry field, enter % (the wild card symbol)
    3. Click Find

      You should get an empty results page returned.


Related reference
Enabling Universal Description, Discovery and Integration (UDDI)



Searchable topic ID:   twsu_ivp
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/twsu_ivp.html

Library | Support | Terms of Use | Feedback