IBM Support

About multisiteinfo.pl perl script

Question & Answer


Question

What is the IBM® Rational® ClearCase MultiSite® diagnostic script multisiteinfo.pl, how does it work and what is its purpose?

Answer



    ABOUT THE TOOL

    The multisiteinfo.pl script is used to collect MultiSite related information to assist in diagnosing MultiSite issues.



    USAGE

    perl multisiteinfo.pl -site=<site designation> -vobtag=<vob tag>
    [-showdeleted] [-help] [-force_os={win32,unix}]

    Note: This is the usage for the most current version of multisiteinfo.pl





    WHAT IS COLLECTED

    This perl script is intended to be given to customers by Rational support. It collects general information that we need for all MultiSite support calls. It will print a banner containing the site string followed by output from the following commands.
    1. cleartool -verall
    2. multitool -verall
    3. cleartool lsvob <vob_tag>
    4. cleartool describe <vob_tag>
    5. cleartool dump <vob_tag>
    6. cleartool lsreplica -long
    7. multitool lsepoch
    8. For each replica found in step 6
      1. cleartool describe -long replica:<replica_name>
      2. cleartool dump -long replica:<replica_name>
    9. uname on UNIX & ver on Windows
    10. Will also include information about the Sync Manager such as a multitool syncserver -inquire -vob $vob_tag if running the script on a host with ClearCase 2003.06.14 (Service Release 4 on Windows or MultiSite patch 6 on UNIX) or later.
    11. You must supply a string identifying the "site".
      Note: You may choose any string name. The script expects to be run in a view in the VOB tag for the replica at the site given as an argument.

      Example:
      perl multisiteinfo.pl -site=<site designation> -vobtag=<vob tag>

      Where:
    • site = The site from which you are running the script
    • vobtag = The local VOB tag for the replica family



    EXAMPLES

    Windows Example:

    Z:\Testvob>ccperl "c:\program files\rational\clearcase\etc\utils\multisiteinfo.pl" -site=Boston_Hub -vobtag=\Testvob >Boston_Hub_Testvob_msinfo.txt

    UNIX/Linux Example:

    /view/vobs/Testvob>Perl /usr/atria/etc/utils/multisiteinfo.pl -site=Boston_Hub -vobtag=/Testvob >Boston_Hub_Testvob_msinfo.txt




    WHERE TO GET THE TOOL
    • The script is automatically shipped with ClearCase MultiSite 2003.06.00 or later in the %CCHOME%\etc\utils directory on Microsoft Windows, Linux and UNIX.
    • Attached to this technote
    • Use multisiteinfo.pl if you wish to run the script without the requirement for a view/vob context
    • Use multisiteinfo_old.pl if you are running the script on a ClearCase MultiSite version prior to 2003.06.00 to collect the data.
multisiteinfo.pl
multisiteinfo_old.pl

Note: If using multisiteinfo_old.pl, the usage of the script is slightly different as follows:

perl <path-to-multisiteinfo_old.pl> <site name> <vob tag> <redirect output>

You must be in a view/VOB context to run this version.




INSTRUCTIONS
  1. Choose which version of the script to use (installed or attached version).

    Note: Copy the attached script to the %CCHOME%\etc\utils directory and rename the original copy if it exists.
  2. Use ccperl on Windows and Perl on UNIX and Linux.
  3. Run the script at all the sites of the replicated VOB for a given family and send the output Rational Customer Support.
Note: If an error, sh: cleartool: command not found, is reported when running the script, refer to technote 1585596 for further assistance.

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

Document Information

Modified date:
16 June 2018

UID

swg21125539