IBM Support

MustGather: Troubleshooting UCM deliver problems

Troubleshooting


Problem

This technote is designed to assist Support in troubleshooting IBM® Rational® ClearCase® UCM related deliver issues on the UNIX®, Linux® and Windows® platforms.

Resolving The Problem

Troubleshooting information to gather when a Deliver operation fails.

Before any troubleshooting can begin, we need to understand the problem.


Here are some basic questions we need answered before we can proceed:
  1. What is the problem?
  2. What are you trying to do or avoid?
  3. What is the error message (if any)?

Once the problem is determined, we can investigate the issue.
The following information can greatly assist Support in coming to a quicker resolution:



Understanding the scope of the problem:
  • Is the error consistent and or reproducible?
  • Does it fail for all users?
  • Does it fail on all systems?
  • Did this ever work?
    • If so: what has changed?
  • Does it fail for both snapshot and dynamic views?
  • Does it fail for both locally and remotely stored views?


Additional Questions:

  • Is the project replicated (for example: is ClearCase MultiSite® used)?
  • Is the project ClearQuest® enabled?



Information to Collect (from the command line):
  1. cleartool deliver or cleartool deliver -status (if deliver is in progress)
  2. cleartool describe -long stream:<source stream>@<pvob vob tag>
  3. cleartool describe -long stream:<target stream>@<pvob vob tag>
  4. cleartool dump stream:<source stream>@<pvob vob tag>
  5. cleartool dump stream:<target stream>@<pvob vob tag>

These commands require the names of certain UCM objects:

  • Stream
  • PVOB

To obtain the names of these objects, follow the instructions below:


STREAM: To obtain the development and integration stream name, set into the development and integration view and execute 'cleartool lsstream'.

Example:


    M:\development_view>cleartool lsstream
    26-Dec-02.12:12:18  dev_stream  joe_user

    M:\integration_view>cleartool lsstream
    26-Dec-02.12:11:55  int_stream  joe_user


PVOB: To obtain the PVOB tag, execute 'cleartool lsvob'. The list of VOB tags is recorded on the left side, to differentiate the PVOB between other VOBs, the PVOB will be labeled with (ucmvob) on the right side of the output.

Example:


    M:\development_view>cleartool lsvob
    * \wind_comp         \\hostname\sharename\win_comp.vbs public
    * \win_pvob            \\hostname\sharename\win_pvob.vbs private (ucmvob)


It would also be very useful to include the Cleartool Describe and Dump of the Integration Activity.

The name of the integration activity can be found in the output of cleartool deliver or cleartool deliver -status

cleartool describe -long activity:activity_name@\Project_VOB

cleartool dump  activity:activity_name@\Project_VOB activity_name

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"2003.06.00;2003.06.16;7.0;7.0.1;7.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21135292