# Copyright (c) 2002, 2003 Sun Microsystems, Inc. All Rights Reserved
# Version 1.18

		PatchPro 2.2 and Patch Manager Base 1.0.1
		   Installation and Configuration Guide

1.0 Introduction

Patch Manager Base 1.0.1 and PatchPro 2.2 are tools that manage signed
patches on Solaris(TM) systems. Patch Manager Base 1.0.1 runs on
Solaris 2.6, Solaris 7, and Solaris 8 systems. PatchPro 2.2 runs on
Solaris 9 systems. These tools also run on both SPARC(TM) and x86
hardware.

By using the patch management tools, you can do the following:

	- Analyze a Solaris system to determine the recommended patches.
	- Download the recommended patches from Sun to a local system.
	- Apply the recommended patches to a local system.
	- Remove patches from a local system.

These patch management tools are accompanied by documentation, which
includes an administration guide, release notes, and man pages. You can
access this documentation from the Docs directory on the product tar
file, from the docs.sun.com(SM) site, and by using the man command.

2.0 Downloading and Installing the Patch Management Tools

This README provides instructions for managing signed patches by using
patch management tools.

	- How to Download the Patch Management Tools From SunSolve
	  Online
	- How to Install and Configure the Patch Management Tool in
	  Interactive Mode
	- How to Upgrade From PatchPro 2.1 to PatchPro 2.2 in
	  Interactive Mode

For procedures on how to install and upgrade the patch management tools
in non-interactive mode, see the Signed Patches Administration Guide
for PatchPro 2.2.

How to Download the Patch Management Tools From SunSolve Online
---------------------------------------------------------------

The Solaris patch management tools are available for both the SPARC and
x86 platforms.

 1. Go to http://www.sun.com/PatchPro.

 2. To begin the download process, go to the section that describes
    Patch Manager and click the download link.

    The binary code license agreement appears.

 3. Agree to the terms of the binary code license agreement.

    o To accept the license agreement, click Agree.

      The Patch Manager download page appears.

    o To reject the license agreement, click Cancel.

      You are not permitted to download the software.

 4. Identify the Solaris version and platform of your local system to
    get the appropriate patch management tool.

    a. Determine which version of Solaris you need:

       o Solaris 2.6
       o Solaris 7
       o Solaris 8
       o Solaris 9

    b. Click the README link associated with the Solaris version you
       chose to get information about installing the patch management
       tool.

    c. Click the platform link associated with the version of Solaris
       that this tool supports.

       o Click SPARC to download the SPARC version of the patch
	 management tool.

       o Click x86 to download the x86 version of the patch
	 management tool.

 5. Choose a directory on your local system in which to download and
    extract the tool.

    For example, you might create a directory called
    /export/download/patchpro.

    Ensure that this directory can be written by superuser.

 6. Download the software tar file to that directory.

    The software you selected is downloaded.

 7. Become superuser.

 8. Change to the directory in which you downloaded the tar file.

      # cd /export/download/patchpro

 9. Extract the patch management tool from the tar file.

    o If you are downloading the tar file for Solaris 2.6 or Solaris 7,
      the tar file is compressed.

         # zcat pproSunOSsparc5.6jre2.2.tar.Z | tar xvf -

    o If you are downloading the tar file for Solaris 8 or Solaris 9,
      the tar file is in zip format.

         # gunzip -dc pproSunOSx865.9jre2.2.tar.gz | tar xvf -

    The name of the tar file indicates the operating system type,
    platform, and operating system version:

      ppro<OS><platform><OS version>jre2.2.tar

    For example, pproSunOSsparc5.8jre2.2.tar is the tar file that
    contains the patch management tool for the SPARC version of Solaris
    8 (SunOS(TM) 5.8). pproSunOSx865.9jre2.2.tar is the tar file that
    contains the patch management tool for the x86 version of Solaris 9
    (SunOS 5.9).

Now, you can install and configure the tool on your system. See "How to
Install and Configure the Patch Management Tool in Interactive Mode."

How to Install and Configure the Patch Management Tool in Interactive Mode
--------------------------------------------------------------------------

Use the setup command to install and configure the patch management
tool on your system in interactive mode.

If you want to install the patch management tool in a hands-off
manner, such as a custom JumpStart(TM) installation, see "How to
Install the Patch Management Tool in Non-Interactive Mode" in the
Signed Patches Administration Guide for PatchPro 2.2.

 1. Become superuser.

 2. Change to the directory in which you downloaded the tar file.

      # cd /export/download/patchpro

 3. Run the setup command to install and configure the tool.

    For example, install and configure the Solaris 9 (SPARC Platform
    Edition) version of the patch management tool:

      # cd pproSunOSsparc5.9jre2.2
      # ./setup

 4. Specify the mechanism your system uses to connect to the Internet
    to retrieve Sun patches.

    The patch management tool requires that your system be connected to
    the Internet, either directly or indirectly through a web proxy.

    o If your system is connected directly to the Internet, type 1.

      o If your system runs Solaris 2.6, Solaris 7, or Solaris 8
	software, go to Step 6.

      o If your system runs Solaris 9 software, go to Step 5.

    o If your system is connected to the Internet through a web
      proxy, type 2.

    a. Specify the host name or IP address of the web proxy.

    b. Specify the port number of the web proxy.

    c. Specify whether the web proxy requires authentication.

       o If the web proxy does not require authentication, type n.

	 o If your system runs Solaris 2.6, Solaris 7, or Solaris
	   8 software, go to Step 6.

         o If your system runs Solaris 9 software, go to Step 5.

       o If the web proxy requires authentication, type y.

    d. Specify the name of a user for the web proxy.

    e. Specify the password of the user for the web proxy.

 5. Solaris 9 only - Indicate whether to automatically restart the
    Solaris WBEM services after you install the patch management tool.

    Restarting the Solaris WBEM services on an active system can cause
    unexpected problems, so ensure that your system is in a quiet state
    before restarting these services.

    o If you can restart the services now, type y.

      The services are automatically restarted after the patch
      management tool is installed.

    o If you cannot restart the services now, type n.

      After you install the patch management tool, bring your system
      to a quiet state, then manually restart the services.

         # /etc/init.d/init.wbem stop
         # /etc/init.d/init.wbem start

 6. Verify that the data you specified is correct.

    The setup program shows the configuration information that you
    supplied.

    o If the configuration data is correct, type y.

    o If the configuration data is incorrect and you want to change
      some of the values, type n.

    The patch management tool is installed.

 7. Add patch management tool directories to your path.

    o For Bourne shell or Korn shell:

         # PATH=/usr/sadm/bin:/opt/SUNWppro/bin:${PATH}
         # export PATH

    o For C shell:

         machine_name# setenv PATH /usr/sadm/bin:/opt/SUNWppro/bin:${PATH}

 8. Add the patch man page directory to your man page path.

    o For Bourne shell or Korn shell:

         # MANPATH=/opt/SUNWppro/man:${MANPATH}
         # export MANPATH

    o For C shell:

         machine_name# setenv MANPATH /opt/SUNWppro/man:${MANPATH}

How to Upgrade From PatchPro 2.1 to PatchPro 2.2 in Interactive Mode
--------------------------------------------------------------------

Use the setup command to manually upgrade your system that runs
PatchPro 2.1 to PatchPro 2.2. You do not need to uninstall PatchPro 2.1
before you upgrade the tool. The setup command also enables you to
configure the patch management tool on your system.

If you want to upgrade the patch management tool in a hands-off manner,
such as a custom JumpStart installation, see "How to Upgrade From
PatchPro 2.1 to PatchPro 2.2 in Non-Interactive Mode" in the Signed
Patches Administration Guide for PatchPro 2.2.

 1. Become superuser.

 2. Change to the directory in which you downloaded the PatchPro 2.2
    tar file.

      # cd /export/download/patchpro

 3. Run the setup command to upgrade and configure the tool.

    For example, upgrade and configure the Solaris 9 (SPARC Platform
    Edition) version of the patch management tool:

      # cd pproSunOSsparc5.9jre2.2
      # ./setup

 4. Indicate whether you want to continue with the upgrade of the
    patch management tool.

    o If yes, type y.

    o If you want to exit the setup program, type q.

 5. Specify the mechanism your system uses to connect to the Internet
    to retrieve Sun patches.

    The patch management tool requires that your system be connected to
    the Internet, either directly or indirectly through a web proxy.

    o If your system is connected directly to the Internet, type 1.

      o If your system runs Solaris 2.6, Solaris 7, or Solaris 8
        software, go to Step 7.

      o If your system runs Solaris 9 software, go to Step 6.

    o If your system is connected to the Internet through a web proxy,
      type 2.

    a. Specify the host name or IP address of the web proxy.

    b. Specify the port number of the web proxy.

    c. Specify whether the web proxy requires authentication.

       o If the web proxy does not require authentication, type n.

	 o If your system runs Solaris 2.6, Solaris 7, or Solaris 8
	   software, go to Step 7.

         o If your system runs Solaris 9 software, go to Step 6.

       o If the web proxy requires authentication, type y.

    d. Specify the name of a user for the web proxy.

    e. Specify the password of the user for the web proxy.

 6. Solaris 9 only - Indicate whether to automatically restart the
    Solaris WBEM services after you upgrade the patch management tool.

    Restarting the Solaris WBEM services on an active system can cause
    unexpected problems, so ensure that your system is in a quiet state
    before restarting these services.

    o If you can restart the services now, type y.

      The services are automatically restarted after the patch
      management tool is upgraded.

    o If you cannot restart the services now, type n.

      After you upgrade the patch management tool, bring your system to
      a quiet state, then manually restart the services.

         # /etc/init.d/init.wbem stop
         # /etc/init.d/init.wbem start

 7. Verify that the data you specified is correct.

    The setup program shows the configuration information that you
    supplied.

    o If the configuration data is correct, type y.

    o If the configuration data is incorrect and you want to change
      some of the values, type n.

 8. Indicate whether you want to upgrade your current installation.

    You are asked to specify whether to upgrade software on a
    per-package basis.

    o If you want to upgrade to the new version of the specified
      package, type y.

    o If you want to use the current version of the specified package,
      type n.

    o If you want to exit the setup program, type q.

 9. Indicate whether to continue with the upgrade of the patch
    management tool.

    o If you want to continue, type y.

      The patch management tool is upgraded on your system. The old
      version is removed, and the tool is configured based on your
      answers to the configuration questions.

      The PatchPro configuration settings you specified are displayed.

    o If you want to exit the setup program, type q.

10. Add patch management tool directories to your path.

    o For Bourne shell or Korn shell:

         # PATH=/usr/sadm/bin:/opt/SUNWppro/bin:${PATH}
         # export PATH

    o For C shell:

         machine_name# setenv PATH /usr/sadm/bin:/opt/SUNWppro/bin:${PATH}

11. Add the patch man page directory to your man page path.

    o For Bourne shell or Korn shell:

         # MANPATH=/opt/SUNWppro/man:${MANPATH}
         # export MANPATH

    o For C shell:

         machine_name# setenv MANPATH /opt/SUNWppro/man:${MANPATH}
