Solaris 7 Maintenance Update 1 Release Notes (SPARC Platform Edition)

Backing Out

The patches in the Solaris 7 MU1 software have been tested together as a set and, for the greatest stability, should be used that way. If you need to remove one of the patches, you may do so provided that you did not use the -d option of install_mu during the installation of the Solaris 7 MU1 software.

Instructions for backing out individual patches are located in each patch directory. Patch directories are located in $rootdir/var/sadm/patch/.


Note -

Backing out the entire MU is not possible if you selected the -d option of install_mu.


It is best to reboot your system in single-user mode before backing out the MU1. MU1 patches system libraries. On a multi-user system, your system will be unstable if any processes have mapped to a patched version of a library and later attempt to map to different sections of the old library.

In single-user mode, network services are not available. If the MU1 image is on the network rather than on a CD, you must copy the MU1 image from the network to your local system before booting your system in single-user mode.

If it is not possible to reboot the system in single-user mode or if you do not have enough disk space to make a local copy of the MU1 image, you will need to back out MU1 using NFS in multi-user mode. In this case, you should have the system in as quiet a state as possible without users logged on or running jobs.

The backout_mu script provided by MU1 enables you to back out an entire MU. To back out the Solaris 7 MU1 software:

  1. Make sure that no important user or system processes are running.

  2. Exit the current session.

    The CDE login screen appears.

  3. Click the Options button and select Command Line Login.

    The system prompts you to login.

  4. Type your login name as root and enter the root password:


    login: root
    password: root password
    
  5. Reboot in single-user mode. From the root shell prompt, type:


    # reboot -- -s
    

    Note -

    Changing the run level from multi-user mode to single-user mode with the shutdown or init command might leave the vold process running. This may cause problems mounting the MU1 CD in single-user mode.


  6. Enter the root password.

    Check that the system displays the following message and is now in system maintenance mode.


    Entering System Maintenance Mode
     
    Sun Microsystems Inc. SunOS 5.7 Generic October 1998
    # 
    • If you are running backout_mu from the CD, go to Step 7.

    • If you are running backout_mu from a local copy of the MU1 image, go to Step 8.

  7. To mount the MU1 CD, place the CD in the drive and from the root shell prompt, type:


    # mount -o ro -F hsfs /dev/dsk/c0t6d0s0 /cdrom
    

    Note -

    In some cases, the CD-ROM drive may be on a different controller than c0 or a different target than t6, which would require a different path to the CD-ROM device. Check with your system administrator if you have questions about mounting the CD-ROM drive.


  8. Run backout_mu.

    • From a local copy of the MU1 image, type:


      # cd local_directory
      # ./backout_mu any desired options
      
    • From the MU1 CD, type:


      # cd /cdrom
      # ./backout_mu any desired options
      
    Table 2-2 Command Line Options for backout_mu

    Option 

    Description 

    -T tooldir

    Specifies the location of the patch tools directory. 

    -q

    Disables the display of dots that indicate install_mu activity.

    -B backoutdir

    Specifies an alternate directory in which patches have been saved. 

    -R rootdir

    Specifies an alternate root directory. 

    -S servicedir

    Specifies an alternate service directory. 

    When the back out is complete, the following message is displayed:


    backout_mu completed successfully.
    • If you see this message, go to Steps 9 and 10 to complete the back out.

    • If you encounter any errors, go to Step 11.

  9. Reboot the system by typing:


    # sync ; reboot
    

    You are then prompted for a login.


    Note -

    It is very important that you reboot your system after backing out MU1 to prevent the library conflict problem.


  10. Type your login name and password:


    login: login
    password: password
    
  11. If you encounter errors, check the detail log file for error information.

    Errors encountered during patch back out are displayed after back out has been completed. Check the detail log file for additional information about any patches or packages that were not backed out.


    # more \
    $rootdir/var/sadm/install_data/MU_Backout_log.mu_version_name.date_time
    

    where:

    • $rootdir is the root directory of the system that you have just updated; for example, / for the local system and /export/root/clientname for a diskless client.

    • mu_version_name is the name of the MU ( it is Solaris_7MU1 for MU1).

    • date_time is the designated date and time copied from date +%y%m%d%H%M%S (i.e., yyyymmddHHMMSS or year-month-day-hour-minute-second).


    Note -

    $rootdir/var/sadm/install_data/Maintenance_Backout_log is a symbolic link to the most recent MU log file.


    For explanations and recommended actions for error codes, see Appendix A.