Patch Name:  PHKL_4997

Patch Description: s700 9.0[357] Booting 712 through router

Creation Date: 94/11/16

Post Date: 94/11/22

Repost: 95/07/20
        The patch was modified to allow installation on HP-UX 9.07.

Hardware Platforms - OS Releases:
        s700: 9.03 9.05 9.07

Products: N/A

Filesets:
        KERN-BLD

Automatic Reboot?: Yes

Status: General Release

Critical:
        Yes
        PHKL_4997: HANG

Path Name:  /hp-ux_patches/s700/9.X/PHKL_4997

Symptoms:
        PHKL_4997:
        The 712 does not boot through a router(Wellfleet).

Defect Description:
        PHKL_4997:
        The 712 and 715 use a new bootp protocol to boot as a
        diskless client. This change causes the 712 to hang
        during the boot process. This is because the bootp
        uses the IP address instead of link level address
        and thus stores the link level address of the
        router in the boot ROM. So, when the client booted through
        a router it copied the router's link level address into
        the rootlink variable and eventually hang.

        This patch provides a workaround in the kernel. This
        workaround would be effective only if the instructions
        given in the special installation instructions is followed.

SR:
        5003229310

Patch Files:  
        /etc/conf/libdskless.a(dux_config.o)

what(1) Output:
        /etc/conf/libdskless.a(dux_config.o):
                dux_config.c   $Revision: 1.5.61.14 $ $Date: 94/11/1
                        6 16:56:39 $ PATCH_9.03 (PHKL_4997)

sum(1) Output:
        2621 14 /etc/conf/libdskless.a(dux_config.o)

Patch Conflicts: None

Patch Dependencies:  None

Hardware Dependencies:  None

Other Dependencies:  None

Supersedes:  None

Equivalent Patches: None

Patch Package Size:  60 Kbytes

Installation Instructions:  
        Please review all instructions and the Hewlett-Packard
        SupportLine User Guide or your Hewlett-Packard support terms
        and conditions for precautions, scope of license,
        restrictions, and, limitation of liability and warranties,
        before installing this patch.
        ------------------------------------------------------------
        1. Back up your system before installing a patch.

        2. Copy the patch to your /tmp directory and unshar it:

                cd /tmp
                cp patch_source/PHKL_4997 .
                sh PHKL_4997

        3. Become root and run update:

                /etc/update

        4. Use the cursor keys to select "Change Source or
           Destination ->" and press [Return].

        5. Select "From Tape Device to Local System ..."
           in the Change window and

        6. Change "Source: /dev/rmt/0m" to
           "Source: /tmp/PHKL_4997.updt"

        7. Press "Done" (f4).

        8. Follow the standard directions for update.

        Update moves the original software to
        /system/PHKL_4997/orig.  Keep this file to recover from any
        potential problems.  You should move the .text file to
        /system/PHKL_4997 for future reference.

        To put this patch on a magnetic tape and update from the
        tape drive, use dd:

                dd if=PHKL_4997.updt of=/dev/rmt/0m bs=2048

Special Installation Instructions:  
        If the patch PHKL_4997 is needed to boot the diskless client
        you have to do the following before running update:

          1.  Add the following line to /etc/master
              (in the tunables section, say right after the
               tunable "retry_alive_period"):

                  rootlink      ROOTLINK_STR    unused

          2.  The customer should then add a line in their
              client dfile (in the tunable section) like:

                  rootlink      080009-123456
              or
                  rootlink      080009123456
              or
                  rootlink      0x080009123456

              PLEASE NOTE that the address given after the
              "rootlink" should be in HEX format and is the link
              level address of the server. The number of HEX
              digits should be 12 excluding the "-". A "0x" at the
              beginning of the address is optional. Any other
              format is not supported and it will not boot.

              Also do not add this line to the server's dfile.