Troubleshooting OSLC

This topic describes common problems that occur with OSLC and presents solutions for those problems.

The TADDM URL configured does not include a port number

Problem
The TADDM URL property that is configured in the collation.properties file, taddmURL, must include a port number.

If the property is not configured with a port number, you must update the TADDM URL to include a port number, clear the information about Registry Services, or specific providers, and clear TADDM timestamps.

Solution
To update the TADDM URL to include a port number, complete the following steps:
  1. In the collation.properties file, set the taddmURL property in the following way:
    taddmURL=http://server.domain:port
  2. On the computer with Registry Services, complete the following steps:
    1. Go to /opt/IBM/JazzSM/registry/etc.
    2. In the CLI.properties file, configure credentials for the following properties:
      • ds.jdbc.user
      • ds.jdbc.password
      • appserver.user
      • appserver.password
    3. Go to /opt/IBM/WebSphere/AppServer/bin.
    4. Run the stopServer.sh script to stop the WebSphere® Application Server.
      ./stopServer.sh server_name -user user_name -p password
      for example,
      ./stopServer.sh server1 -user wasadmin -p passw0rd
    5. Go to /opt/IBM/JazzSM/registry/bin.
    6. Run the frs.sh script with the appropriate parameters:
      ./frs.sh uninstall -type db -properties ../etc/CLI.properties
    7. Check that the database has been dropped. If not, run the following commands:
      db2 drop db db_name
      db2 create db db_name
      where db_name is the name of the Registry Services database.
    8. Go to /opt/IBM/JazzSM/registry/bin.
    9. Run the frs.sh script with the appropriate parameters:
      ./frs.sh install -type db -properties ../etc/CLI.properties
    10. Go to /opt/IBM/WebSphere/AppServer/bin.
    11. Run the startServer.sh script to start the WebSphere Application Server.
      ./startServer.sh server_name -user user_name -p password
      for example,
      ./startServer.sh server1 -user wasadmin -p passw0rd
    12. Run the frs.sh script with the appropriate parameters:
      ./frs.sh uninstall -type container -properties ../etc/CLI.properties
    13. Run the frs.sh script with the appropriate parameters:
      ./frs.sh install -type container -properties ../etc/CLI.properties
    You might be able to remove an item from Registry Services for a specific provider by using the following command:
    ./frs.sh deleteProvider -providerUrl url -properties cli.properties
  3. On the computer with the TADDM database, complete the following steps:
    1. Go to $COLLATION_HOME/support/bin.
    2. Run the runtopobuild script or batch file with the appropriate parameters, for example:
       ./runtopobuild.sh -a OSLCAgent -R