Patch-ID# 101794-01
Keywords: iopbmap, obp, panic, 2.12, classic
Synopsis: Trusted Solaris 1.1: booting diskless SPARCclassic with PROM 2.12 causes panic
Date: Nov/18/94

Solaris Release: Trusted_Solaris_1.1

SunOS Release:

Unbundled Product: 

Unbundled Release: 

Relevant Architectures: sparc
    NOTE: sun4m 

BugId's fixed with this patch: 1152592 

Changes incorporated in this version: 

Patches accumulated and obsoleted by this patch: 

Patches which conflict with this patch: 

NOTE: Any patch that requires the kernel to be reconfigured should be
      considered to conflict with this patch.  (To avoid losing any 
      previous changes to the kernel, be sure to use the modified configuration 
      file as your base, as described in the instructions.)

Patches required with this patch: 

Obsoleted by: 

Files included with this patch: 
README
sun4m/OBJ/machdep.o

NOTE: Default file attributes (as released with TS1.1):

     Filename;mode;owner;group;privileges;label
     ------------------------------------------
     README;;;;;
     sun4m/OBJ/machdep.o;00444;root;daemon;;SYSTEM_LOW[SYSTEM_LOW]

Files that may be modified with this patch:

Problem Description: 
 
    SPARCclassics with an Open Boot PROM Revision of 2.12 cannot boot as
    diskless clients under TS1.1.  To correct this, the kernel was
    modified to support the rev. 2.12 PROM.


Patch Installation Instructions: 
-------------------------------
NOTE: This patch does not apply either to SunOS 4.1.1, 4.1.2, 4.1.3,
      or to SunOS CMW 1.0 systems.

1.    Log into the diskless client's NFS server, assume the ISSO role,
      and bring up a SYSTEM_LOW shell.

2.    These instructions assume you will copy the patch files to a
      temporary directory, such as /var/tmp. Because customers obtain
      patches from different sources, these instructions do not attempt
      to cover all possibilities. To give one example, if this patch is
      on a tar tape inserted in st0, you would do this:

          isso# cd /var/tmp
       	  isso# mkdir patch patch/<id>
   	  isso# cd patch/<id>
          isso# tar xvf /dev/rst0

3.    Halt the diskless client's NFS server by selecting:
      Utilities>Shut Down Machine from the Trusted Path menu.
       
NOTE: For more information about reconfiguring the kernel, see the
      SunOS 4.1 System and Network Administration Manual, in Chapter 9,
      "Reconfiguring the System Kernel." 

4.    Boot the server single user, supplying the PROM password
      as requested.

5.    Go to the OBJ directory for the architecture of the diskless client.

          # cd /usr/kvm/sys/sun4m/OBJ                      

6.    Save the existing version of machdep.o. For example:

          # cp machdep.o machdep.o.orig                    
 
7.    Copy the new object module into the OBJ directory from the
      temporary directory.  For example:
 
          # cp /var/tmp/patch/<id>/sun4m/OBJ/machdep.o .
 
8.    Build and install the kernel, carefully following substeps
      8a through 8d.
         
8a.   Choose a name for the new configuration file for the system; for
      example, PATCHED.
 
8b.   Create the configuration file by making a copy of the GENERIC
      file or of the existing customized configuration file, and change
      the mode.  (In the example, MODIFIED is the name of a modified
      configuration file.)

	  # cp MODIFIED PATCHED; chmod +w PATCHED

8c.   Modify the name of the of the kernel in the configuration file,
      changing all occurrences of the filename you started with to
      the changed filename; in our example you would change
      all occurrences of "MODIFIED" to "PATCHED."
 
8d.   Run config on the new file:
 
          # /etc/config PATCHED
 
      (The directory ../PATCHED will be made if it doesn't exist.)

8e.   Make the new system:                                          
 
          # cd ../PATCHED
          # make

9.    Save the original kernel and install the new one in the client's
      root directory (/export/root/<clientname>:
	
	  # cd /export/root/<clientname> 
          # cp vmunix vmunix.orig
	  # cp /usr/kvm/sys/sun4m/PATCHED/vmunix vmunix

10.   If your site security policy requires that you maintain the
      attributes of TCB files as they were shipped, make sure the
      vmunix and the machdep.o files' attributes still match the
      attributes specified under "Default file attributes," and restore  
      attributes as needed.

11.   Boot the server multiuser:

	  <Control><D>

12.   Boot the diskless client:

          ok boot
	   

Special Install Instructions: 
-----------------------------
None.
