Patch-ID# 100700-02
Keywords: sunpc 3.0 hangs blank freezes nlbind nladmin sunpc_license
Synopsis: SunPC/3.0: SunPC window hangs on startup, wrong server hostname
Date: 26/Oct/92

SunOS release: 4.1.x

Unbundled Product: SunPC

Unbundled Release: 3.0

Topic: Fixes SunPC hang on startup, correct hostname on license install, SNL license check-in

BugId's fixed with this patch: 1097470, 1091446, 1080212

Changes incorporated in this version: 1091446, 1080212

Architectures for which this patch is available: sun4(all)

Patches which may conflict with this patch: 

Obsoleted by: SunPC Rel 3.1

Files included with this patch: sunpc.dws.xview, sunpc_license

Problem Description: 

BugID #1097470:

    SunPC hangs when the customer tries to bring up session.  It gets
    to the point where the screen goes black, but just hangs there and
    never brings up any of the buttons on the window.  SunPC in demo
    mode works fine.  Sun Net License appears to be configured
    correctly.  nlbind, nladmin all appear to work correctly and
    sunpc_lic_test seems to verify that the sun net License part of the
    code is working correctly.

BugID #1091446:

    If the host designated as the License Server has multiple hostnames
    (such as a gateway machine), it was possible that the wrong
    hostname would be used at license install time (and written to the
    SunPC license diskette).  It is not possible to change the hostname
    once it is written to the diskette.

    This patch now insures that the hostname installed (and placed on
    the diskette) is the same hostname that the host uses when
    validating licenses.

SNL generic problem:

    There was a problem with SNL not correctly "checking-in" licenses
    when SunPC was terminated abruptly (such as via a "kill -9
    sunpc_pid".  When THIS patch is applied in conjunction with the SNL
    server patch (described in "Additional Information" below), SNL
    license tokens will be correctly checked-in (after the 10 minute
    license timeout as expired).

BugID #1080212

    There is an infrequently occurring race condition that may cause
    SEGV faults on SunPC startups.  This seems to occur only on slower
    systems (such as SPARCstation 1's).  This is now fixed.


Install Instructions: 

As user "root" on the system where SunPC software is installed:

 - Back up the originally installed software, via:
 
    # mv /usr/sunpc/bin/sunpc.dws.xview   /usr/sunpc/bin/sunpc.dws.xview.FCS
    # mv /usr/sunpc/bin/sunpc_license /usr/sunpc/bin/sunpc_license.FCS

 - Install the replacement files, via:

    # cp sunpc.dws.xview   /usr/sunpc/bin/sunpc.dws.xview
    # cp sunpc_license /usr/sunpc/bin/sunpc_license

 - Make sure installed files are executable, and not world writable, via:

    # chmod 755 /usr/sunpc/bin/sunpc.dws.xview 
    # chmod 755 /usr/sunpc/bin/sunpc_license

 
    NOTE: If you have installed SunPC in a directory other than
	  "/usr/sunpc", substitute your SunPC installation path in
	  place of "/usr/sunpc" in the above commands.


Additional Information:

    When this patch is installed, the title of the SunPC window will
    change to indicate that it is running a patched binary.  The title
    will display as "SunPC 3.0 (Patch #100700-b)",

    Please note that the "rpc.netlicd" program on the Sun Net License
    SERVER must also be updated to completely eliminate problems with
    license tokens "getting lost" when SunPC is terminated abruptly,
    such as via "kill -9 sunpc_pid" or Exiting Open Windows before
    quitting SunPC.  The rpc.netlicd update is required ONLY on SNL
    SERVER systems.  Systems that are NOT running as SNL servers do NOT
    need this patch applied.

    Patch# 100787 contains the new SNL rpc.netlicd server software.
    If this patch is NOT available yet, patch ID# 100582-02 can ALSO be
    used to get the new rpc.netlicd software.