Connecting to WebSphere Service Registry and Repository

To publish web service assets, you must be connected to IBM® WebSphere® Service Registry and Repository (WSRR). You can connect to WSRR from the IBM Rational® Asset Manager web client.

Before you begin

You must be a community administrator to add a connection.

You must synchronize the connection between WSRR and Rational Asset Manager. If the WSRR server requires access permissions, the WSRR account that you connect with must have "create" permission to publish assets and "retrieve" permission to synchronize assets.

About this task

To publish web service assets of the following types, Rational Asset Manager must be connected to WSRR:

For more information about WebSphere Service Registry and Repository and the Advanced Lifecycle Edition, visit the WebSphere Service Registry and Repository Version 7.0 Information Center.

If you connect a community in Rational Asset Manager with WSRR, you can publish assets that contain web services documents to the WSRR repository. If you configure a mapping file, you can publish assets to WSRR as specific WSRR Business Model Objects. Otherwise, assets that you publish to WSRR are generic concepts in WSRR that link to the asset in Rational Asset Manager.

When the connection between the WSRR repository and a community in Rational Asset Manager is synchronized, Rational Asset Manager creates remote assets in the community for service description objects in WSRR. Remote assets link to objects in a separate repository. Remote assets are created for the following service description objects in WSRR:
  • Physical documents:
    • WSDL
    • XSD
    • WS-Policies
    • SCA modules
    • XML files
    • Other physical documents
  • Concepts:
    • Concepts with artifact relationships
    • Other concept types that you select when you configure the connection to WSRR

Procedure

To create a connection to the WSRR server:

  1. Log on to the Rational Asset Manager web client.
  2. Click Administration, and select the community to edit.
  3. Click the Connections tab.
  4. Under WebSphere Service Registry and Repository Connections, click New Connection.
  5. On the Connection Properties page, specify the details for your WSRR installation.
    1. In the Name field, type a name for the connection. The name can include spaces and special characters.
    2. In the Description field, type a description of the connection. The description can have spaces and special characters.
    3. In the URL field, type the location of the WSRR server. Include the domain and port number. For example: https://server.example.com:9443.
    4. To connect to multiple instances of WSRR that run on the same instance of IBM WebSphere Application Server:
      1. In the .xml mapping file, specify a different context root for each WSRR instance.
      2. For each web module to connect to, add the context root value. For example, to add the ServiceRegistryUI and WSRR63Router web modules in WSRR, add this text in the ALEConfiguration.xml file:
        <!--  Context Roots for WSRR Server.
        Add the context roots for WSRR Web UI and the 6_3 Web Services router -->
        <WSRR>
              <Server> 
                 <ContextRoot>
                     <WebModule name="ServiceRegistryUI" value="ServiceRegistry" /> 
                     <WebModule name="WSRR63Router" value="WSRR6_3" />
                 </ContextRoot>
              </Server>
        </WSRR>
      These values are available from the WSRR installation. You can find the values in the context root value in the WSRR enterprise application service registry. When you install the service registry, if you rename the default values, you must also modify the mapping file to add the modified context roots.
    5. In the Login field, type the user name of a user who is authorized to access WSRR.
    6. In the Password field, type the user's password to access WSRR.
    7. After you enter the host, port, user name, and password, click Test Connection to test that a connection can be established with the server.
    8. From the Type list, select whether to publish, synchronize, or publish and synchronize assets by using this connection. If the connection is used for publishing assets and for retrieving WSRR assets to include in a search, select Publish and Synchronize.
    9. Default asset owner: Select the user who will own assets that are automatically added to the Rational Asset Manager repository during synchronization with the web services registry. The default asset owner is assigned to an asset when the user ID in WSRR is not found in Rational Asset Manager and when a WSRR user ID cannot be created. When you select the default asset owner, ensure that the user has permission to create an asset in Rational Asset Manager.
    10. Next to Synchronization schedule, click Edit to modify how frequently the Rational Asset Manager repository synchronizes with the web services registry. You can choose to synchronize daily or weekly at a specific time or at an interval that is specified in minutes or hours.
    11. Select a mapping (.xml) file that maps categories, asset types, and states in Rational Asset Manager with elements in WSRR.
      • To view the current file, click the name of the mapping file.
      • To select a different mapping file, click Replace and select one of the following options:
        • Do not use the configuration file: This connection does not use a mapping file. Assets that you upload from Rational Asset Manager to WSRR are generic concepts in WSRR.
        • Use default configuration file from SOA library: If you imported the sample SOA library that is included with Rational Asset Manager, the library includes a default mapping file that complies with system-oriented architecture principles.
        • Import: Browse to and select a different mapping file to use.

      For information about how to modify the mapping file to map elements between the two products, see “Configuring the mapping .xml file.”

    12. In the Conditions section, after you establish a connection, you can specify that this connection synchronizes with specific templates, classifications, or both from WSRR.
      • To add a template, click Add Templates and search the registry for a template to add.
      • To add a classification, click Add Classification and search the registry for a classification to add.
      As you add conditions, they are connected by the logical functions AND or OR. If you do not define conditions, only the concepts that are published from Rational Asset Manager or that have artifact relationships are synchronized.
  6. Click OK.

Feedback