FINAL UPDATE: Technical Bulletin #28

To: All Sites Running ClearCase 3.2 on HP-UX 11
From: Customer Support
Date: 1 September 1998
Subject: FINAL UPDATE: Technical Bulletin #28

Final Update: New ClearCase Patch plus Fixed HP Patch Bundle Provide Support for ClearCase on HP-UX 11

Rational Software has fixed the problem preventing ClearCase from running on HP-UX 11.0 systems. Installing patch clearcase_p3.2-30, together with the appropriate HP patch bundles, will now allow you to run ClearCase on both 32-bit and 64-bit HP-UX 11 systems.

Description of Patch

Patch clearcase_p3.2-30 contains a fix for the following defect:

On some HP-UX 11.0 systems, any process accessing an MVFS filesystem would hang, typically when attempting to cd into a VOB directory. The processes were hung in the RPC handle initialization code. This hang was caused by an incorrectly initialized knetconfig data structure used by the MVFS. The code assumed a particular device number for UDP, which is not correct on all systems, depending on the hardware and driver configuration. The MVFS has been fixed to obtain the device major and minor numbers for UDP after the system is booted.

Special Requirements

In order for ClearCase to run on the HP-UX 11 operating system, it requires patch PHNE_14620 from HP. PHNE_14620 contains a fix to XDR. Unfortunately, HP had a defective bundle of patches in June (see attached note from HP) which contained only a portion of the required fix from PHNE_14620. Thus, users who are running the June patch bundle from HP cannot use this ClearCase patch. Furthermore, if you have installed the June HP patch bundle, and then try to install a later [good] version of the fix for PHNE_14620, the later version doesn't install. The installation process detects the June bundle and assumes that there's a correct version installed and no update is needed.

In order to find out if you have the defective bundle, type

swlist

If the defective bundle is installed, the command displays the following:

XSWGR1100 B.11.00.IB2 HP-UX Extension Pack, June 1998

To list individual patches, add the -l fileset option to swlist.

HP sent a letter describing the problem to HP-UX 11 customers. The letter is reproduced at the end of this bulletin, and we ask that you read it carefully. If you have the defective bundle installed you'll have to do the following in order to get ClearCase up and running on your HP-UX 11 system.

1.
Uninstall ClearCase (if it's installed)
2.
Follow HP's instructions to uninstall the bad HP patch (i.e. reinstall the OS)
3.
Reinstall a current version of the PHNE_14620 patch family
4.
Reinstall ClearCase

Note that patch clearcase_p3.2-30 is a mandatory patch. Therefore, it should be installed even if you were able to successfully run ClearCase 3.2 on an HP-UX 11 system. This is because the particular configuration that allowed you to do so could change in the future.

Any Questions?

Please contact Rational Support

Text of Letter from HP

Following is the text of the letter HP sent to HP-UX 11 customers regarding the problems in the June HP patch bundle.

Hewlett-Packard Company
3000 Hanover Street
Palo Alto, California 94304 USA

June 19, 1998

URGENT: Defective HP-UX Extension Software Bundle Information

Dear Hewlett-Packard Customer,

Thank you for choosing Hewlett-Packard as your systems supplier. Because Hewlett-Packard is committed to delivering quality products to our customers, we must make you aware of a problem that we have identified that could affect the integrity of your system.

We recently discovered a defective HP-UX 11.00 software bundle on the latest version of the HP-UX Extension Software CD-ROM media, Part Number B3782-10320. Installation of software from this CD-ROM may disable HP-UX 11.00 systems.

Please note that HP-UX 10.x Extension Software bundles are unaffected.

You have received this letter because:

1.
You have received the defective HP-UX Extension Software CD ROM Media, or
2.
You did not get any HP-UX Extension Software CD ROM Media in your HP-UX 11.00 Media kit.

Please determine whether you belong in Group 1 or 2 as described above. Please refer to the next sections according to your group classification.

If you have received a copy, please immediately discard the HP-UX Extension Software CD-ROM media, Part Number B3872-10320. Please replace with the enclosed replacement CD ROM part number B3782-10346.

Group 1:

If you have NOT installed HP-UX 11.00 software yet from the HP-UX Extension Software CD ROM media, Part Number B3872-10320, please use the enclosed replacement CD-ROM part number B3782-10346.

If you have already installed HP-UX 11.00 software from HP-UX Extension Software CD-ROM media, Part Number B3872-10320, here are the instructions to remove the software prior to using the enclosed replacement CD ROM part number B3782-10346.

The next steps will return the system back to a known state. Hewlett-Packard recommends the installation of the HP-UX 11.00 Extension Pack 9806 bundle on the enclosed replacement CD ROM part number B3782-10346.

There are three steps to take for corrective action.

1.
While other versions of HP-UX are unaffected, it is strongly recommended that you discard the HP-UX Extension Software CD-ROM media Part Number B3872-10320. Discarding the defective CD-ROM ensures that no inadvertent future use of the media for HP-UX 11.00 occurs.
2.
Locate or set up a SD depot that contains the Core OS for HP-UX 11.00 and any desired patches, or the location of the "HP-UX 11.00 Install and Core OS" media.
3.
The following command is used to remove the patch bundles and return the system to a known state.

The currently supplied HP-UX media listed below is suitable for use with this operation:

HP-UX 11.00 Install/Core CD ROM part numbers (Original release)

HP-UX 11.00 Install/Core CD ROM part numbers (Extension Pack 9804)

HP-UX 11.00 Install/Core CD ROM part numbers (Extension Pack 9806)

Group 2:

Your media did not contain an Extension Software CD-ROM. Enclosed is the replacement CD ROM part number B3782-10346 that replaces the CD-ROM omitted from the kit.

Any Questions?

Please contact Rational Support

FINAL UPDATE: Technical Bulletin #28 - 1 Sep 1998