<?Pub UDT _bookmark _target?><?Pub UDT __target_1 _target?><?Pub UDT registeredtm trademark?><chapter id="swmgrpkgsgui-1"><?Pub Tag atict:info tracking="off" ref="0"?><?Pub Tag
atict:user user="sk23612" fullname="Juanita Heieck"?><?Pub Tag atict:user
user="jonj" fullname="Juanita Heieck"?><?Pub Tag atict:user user="kathys"
fullname="Kathy Slattery"?><?Pub Tag atict:user user="cathleen" fullname=""?><?Pub Tag
atict:user user="eb151805" fullname="Juanita Heieck"?><?Pub Tag atict:user
user="jh118764" fullname="Juanita Heieck"?><?Pub Tag atict:user user="lh136763"
fullname="Laura Hartman"?><title>Managing Software With Solaris System Administration
Tools (Tasks)</title><highlights><para>This chapter describes how to add, verify, and remove software packages
by using the Solaris installation graphical user interface (GUI) and the Solaris
Product Registry.</para><para>For information about software management features that are new in this
release, see <olink targetptr="gazwe" remap="internal">What's New in Software Management in
the Solaris Operating System?</olink>.</para><itemizedlist><para>For information about the procedures that are associated with performing
software management tasks, see:</para><listitem><para><olink targetptr="swmgrpkgsgui-5" remap="internal">Adding Software With the
Solaris Installation GUI</olink></para>
</listitem><listitem><para><olink targetptr="swmgrpkgsgui-14" remap="internal">Managing Software With
the Solaris Product Registry GUI (Task Map)</olink></para>
</listitem><listitem><para><olink targetptr="swmgrpkgsgui-38" remap="internal">Managing Software With
the Solaris Product Registry Command-Line Interface (Task Map)</olink></para>
</listitem>
</itemizedlist>
</highlights><sect1 id="swmgrpkgsgui-2"><title>Solaris Product Registry and Solaris GUI
Installation Tools for Managing Software</title><para>The following table lists the commands to use for adding, removing,
and checking the installation of software packages the Solaris installation
GUI and Solaris Package Registry tools.</para><table frame="topbot" id="swmgrpkgsgui-tbl-89"><title>System Administration
Tools for Managing Software Packages</title><tgroup cols="3" colsep="0" rowsep="0"><colspec colname="colspec0" colwidth="27.84*"/><colspec colname="colspec2" colwidth="32.37*"/><colspec colname="colspec4" colwidth="38.79*"/><thead><row rowsep="1"><entry><para>Tool</para>
</entry><entry><para>Description</para>
</entry><entry><para>Man Page</para>
</entry>
</row>
</thead><tbody><row><entry><para><command>installer</command></para>
</entry><entry><para>Installs or removes a software package with an installer</para>
</entry><entry><para><olink targetdoc="refman" targetptr="installer-1m" remap="external"><citerefentry><refentrytitle>installer</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink></para>
</entry>
</row><row><entry><para><command>prodreg</command></para>
</entry><entry><para>Enables you to browse, unregister, and uninstall software in the Solaris
Product Registry</para>
</entry><entry><para><olink targetdoc="refman" targetptr="prodreg-1m" remap="external"><citerefentry><refentrytitle>prodreg</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink></para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</sect1><sect1 id="swmgrpkgsgui-5"><title>Adding Software With the Solaris Installation
GUI</title><para>This section describes how to use the Solaris installation GUI to add
software to a system on which you have installed the Solaris Operating System
(Solaris OS). The Solaris installation GUI installs only the components of
the software groups that you skipped when you initially installed the Solaris
OS. You cannot upgrade to another software group after installing or upgrading
the OS. .</para><task id="swmgrpkgsgui-6"><title>How to Install Software With the Solaris
Installation GUI Program</title><tasksummary><note><para>This procedure assumes that the system is running volume management
(<command>vold</command>). If your system is not running volume management,
see <olink targetdoc="sagdfs" targetptr="medaccess-29267" remap="external">Chapter 3, <citetitle remap="chapter">Accessing Removable Media (Tasks),</citetitle> in <citetitle remap="book">System Administration Guide: Devices and File Systems</citetitle></olink>.
This chapter provides information about accessing removable media without
volume management.</para>
</note>
</tasksummary><procedure>&rolestep.sgm;<step id="swmgrpkgsgui-step-8"><para>Decide to install software from a CD,
a DVD, or from the network.</para><itemizedlist><para>Select one of the following:</para><listitem><para>If you are installing from a CD, insert the CD into the CD-ROM
drive.</para><para>If you insert theSolaris Languages CDs ,
the Solaris installation GUI  starts automatically. Proceed to <olink targetptr="swmgrpkgsgui-step-12" remap="internal">Step&nbsp;5</olink>.</para>
</listitem><listitem><para>If you are installing from a DVD, insert the DVD into the
DVD-ROM drive.</para>
</listitem><listitem><para>If you are installing from the network, locate the net image
of the software you want to install.</para>
</listitem>
</itemizedlist>
</step><step id="swmgrpkgsgui-step-9"><para>Change directories to find the Solaris
installation GUI installer.</para><para>Solaris installation GUI installers
are located in various directories on the CDs and on the DVD. </para><itemizedlist><listitem><para>Solaris 11  Software CDs
or DVD.</para>
</listitem><listitem><para>Solaris11  Documentation
DVD.</para>
</listitem><listitem><para>Solaris 11  Languages
CDs.  The Solaris installation GUI starts automatically when the
CD is inserted.</para>
</listitem>
</itemizedlist>
</step><step id="swmgrpkgsgui-step-10"><para>Follow the instructions to install the
software.</para><itemizedlist><listitem><para>From the command line, type the following command:</para><screen> % <userinput>./installer</userinput> [<replaceable>options</replaceable>]</screen><variablelist><varlistentry><term><option>nodisplay</option></term><listitem><para>Runs the installer without a GUI.</para>
</listitem>
</varlistentry><varlistentry><term><option>noconsole</option></term><listitem><para>Runs without any interactive text console device. Use this
option with the <option>nodisplay</option> option when you include the <command>installer</command> command in a UNIX script for installing software.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem><listitem><para>From a file manager, double-click Installer or installer.</para><para>An Installer window is displayed, followed by the Solaris installation
GUI dialog box.</para>
</listitem>
</itemizedlist>
</step><step id="swmgrpkgsgui-step-12"><para>Follow the directions on the screen
to install the software.</para>
</step><step id="swmgrpkgsgui-step-13"><para>When you have finished adding software,
click Exit.</para><para>The Solaris installation GUI exits.</para>
</step>
</procedure>
</task>
</sect1><sect1 id="swmgrpkgsgui-14"><title>Managing Software With the Solaris Product
Registry GUI (Task Map)</title><para>The following task map describes the software management tasks that
you can perform with the Solaris Product Registry.</para><informaltable frame="all"><tgroup cols="3" colsep="1" rowsep="1"><?PubTbl tgroup dispwid="7.25in"?><colspec colwidth="25.03*"/><colspec colwidth="25.03*"/><colspec colwidth="48.93*"/><thead><row><entry><para>Task</para>
</entry><entry><para>Description</para>
</entry><entry><para>For Instructions</para>
</entry>
</row>
</thead><tbody><row><entry><para>View installed or uninstalled software with the Solaris Product Registry.</para>
</entry><entry><para>Used for learning about installed or uninstalled software.</para>
</entry><entry><para><olink targetptr="swmgrpkgsgui-15" remap="internal">How to View Installed or Uninstalled
Software Information With the Solaris Product Registry GUI</olink></para>
</entry>
</row><row><entry><para>Install software with the Solaris Product Registry.</para>
</entry><entry><para>You can use the Solaris Product Registry to find software and launch
the Solaris installation GUI. This program takes you through the installation
of that software.</para>
</entry><entry><para><olink targetptr="swmgrpkgsgui-21" remap="internal">How to Install Software With the
Solaris Product Registry GUI</olink></para>
</entry>
</row><row><entry><para>Uninstall software with the Solaris Product Registry.</para>
</entry><entry><para>Use tor uninstall software with the Solaris Product Registry.</para>
</entry><entry><para><olink targetptr="swmgrpkgsgui-31" remap="internal">How to Uninstall Software With the
Solaris Product Registry GUI</olink></para>
</entry>
</row>
</tbody>
</tgroup>
</informaltable><para>The Solaris Product Registry is a tool to help you manage installed
software. After you have installed the software, Product Registry provides
a list of all the installed software by using the Solaris installation GUI
or the Solaris <command>pkgadd</command> command.</para><para>You can use the Solaris Product Registry in a GUI or with a command-line
interface (CLI). For more information on how to use the Solaris Product Registry
CLI, see <olink targetptr="swmgrpkgsgui-38" remap="internal">Managing Software With the Solaris
Product Registry Command-Line Interface (Task Map)</olink>.</para><itemizedlist><para>The Solaris Product Registry GUI interface enables you to do the following:</para><listitem><para>View a list of installed and registered software and some
software attributes.</para>
</listitem><listitem><para>View all Solaris system products that you installed in their
localized version in the System Software Localizations directory.</para>
</listitem><listitem><para>Find and launch an installer.</para>
</listitem><listitem><para>Install additional software products.</para>
</listitem><listitem><para>Uninstall software and individual software packages.</para>
</listitem>
</itemizedlist><itemizedlist><para>The Solaris Product Registry GUI main window consists of three panes
of information:</para><listitem><para>Installed, registered, and removed software</para>
</listitem><listitem><para>Standard attributes of the currently selected software</para>
</listitem><listitem><para>Attributes that are customized and attributes that are internal
to the registered software</para>
</listitem>
</itemizedlist><figure id="swmgrpkgsgui-fig-91"><title>Solaris Product Registry Main Window</title><mediaobject><imageobject><imagedata entityref="prodreg"/>
</imageobject><textobject><simpara>Simple screen capture titled Solaris Product Registry.
Shows the Registered Software, Summary, and More Information panes.</simpara>
</textobject>
</mediaobject>
</figure><task id="swmgrpkgsgui-15"><title>How to View Installed or Uninstalled Software
Information With the Solaris Product Registry GUI</title><procedure>&rolestep.sgm;<step id="swmgrpkgsgui-step-17"><para>Start the Solaris Product Registry tool.</para><screen># <userinput>prodreg &amp;</userinput></screen><para>The Solaris Product Registry main window is displayed.</para>
</step><step id="swmgrpkgsgui-step-18"><para>Click the turner control to the left
of the System Registry directory in the Registered Software box.</para><para>The
turner control changes from pointing to the right to pointing downward. You
can expand or collapse any item in the registry, except an item that has a
text file icon to its left.</para><itemizedlist><para>The Software Installed in Registered Software box always contains the
following components:</para><listitem><para>The configuration software group that you chose when you installed
the Solaris release. Software groups that can be displayed include Reduced
Network Support, Core, End User System Support, Developer System Support,
Entire Distribution, or Entire Distribution Plus OEM Support.</para>
</listitem><listitem><para>Additional system software, which contains Solaris products
that are not part of the software group you chose.</para>
</listitem><listitem><para>Unclassified software that is not a Solaris product or part
of the software group. This software includes any package that you installed
by using the <command>pkgadd</command> command.</para>
</listitem>
</itemizedlist>
</step><step id="swmgrpkgsgui-step-19"><para>Select directories until you find a
software application to view. </para><para>The list expands as you open directories.</para>
</step><step id="swmgrpkgsgui-step-20"><para>To view the attributes, select a directory
or file.</para><para>The Product Registry displays attribute information in
the System Registry box.</para><itemizedlist><listitem><para>For software products that were installed with the Solaris
 installation GUI, the Solaris Product Registry contains values for at least
the following: Title, Version, Location, and Installed on. Items in an expanded
list under a product or software group inherit the version information of
the product. </para>
</listitem><listitem><para>If all or part of the product was removed with the <command>pkgrm</command> command, a cautionary icon appears next to the software product's
name.</para>
</listitem>
</itemizedlist>
</step>
</procedure>
</task><task id="swmgrpkgsgui-21"><title>How to Install Software With the Solaris
Product Registry GUI</title><tasksummary><para>You can use Solaris Product Registry to find software and launch the
Solaris installation GUI program. This program takes you through the installation
of that software.</para>
</tasksummary><procedure>&rolestep.sgm;<step id="swmgrpkgsgui-step-23"><para>Start the Solaris Product Registry tool.</para><screen># <userinput>prodreg</userinput></screen><para>The Solaris Product Registry main window is displayed.</para>
</step><step id="swmgrpkgsgui-step-24"><para>Decide if you are installing from a
CD, a DVD, or from the network. Select one of the following: </para><stepalternatives><step><para>If you are installing from a CD, insert the CD into the CD-ROM
drive.</para>
</step><step><para>If you are installing from a DVD, insert the DVD into the DVD-ROM
drive.</para>
</step><step><para>If you are installing from the network, locate the net image of
the software that you want to install.</para>
</step>
</stepalternatives>
</step><step id="swmgrpkgsgui-step-25"><para>To view the list of installed and registered
software, click the turner control.</para>
</step><step id="swmgrpkgsgui-step-26"><para>Click the New Install button at the
bottom of the Solaris Product Registry window.</para><para>The Select Installer
dialog box is displayed. This box initially points to the <filename>/cdrom</filename> directory
or the directory you are in.</para>
</step><step id="swmgrpkgsgui-step-27"><para>Select directories to find the Solaris
 installation GUI installer.</para><itemizedlist><para>Solaris installation GUI installers are located in various directories
on the CDs and on the DVD.</para><listitem><para>Solaris 10 Software CDs or DVD.</para>
</listitem><listitem><para>Solaris 10 Documentation DVD.</para>
</listitem><listitem><para>Solaris 10 Languages CDs. The Solaris installation
GUI automatically starts when the CD is inserted.</para>
</listitem>
</itemizedlist>
</step><step id="swmgrpkgsgui-step-28"><para>When you find the installer you want,
select its name in the Files box.</para>
</step><step id="swmgrpkgsgui-step-29"><para>Click OK.</para><para>The installer
you selected is launched.</para>
</step><step id="swmgrpkgsgui-step-30"><para>Follow the directions that are displayed
by the installer to install the software.</para>
</step>
</procedure>
</task><task id="swmgrpkgsgui-31"><title>How to Uninstall Software With the Solaris
Product Registry GUI</title><procedure>&rolestep.sgm;<step id="swmgrpkgsgui-step-33"><para>Start the Solaris Product Registry tool.</para><screen># <userinput>prodreg</userinput></screen><para>The Solaris Product Registry main window is displayed.</para>
</step><step id="swmgrpkgsgui-step-34"><para>To view the list of installed and registered
software, click the turner control.</para>
</step><step id="swmgrpkgsgui-step-35"><para>Select directories until you find the
name of the software that you want to uninstall.</para>
</step><step id="swmgrpkgsgui-step-36"><para>Read the software attributes to make
sure that this software is the software that you want to uninstall.</para>
</step><step id="swmgrpkgsgui-step-37"><para>Click the Uninstall <replaceable>software-product-name</replaceable> button at the bottom of the Solaris Product Registry window.</para><para>The software product you selected is uninstalled.</para>
</step>
</procedure>
</task>
</sect1><sect1 id="swmgrpkgsgui-38"><title>Managing Software With the Solaris Product
Registry Command-Line Interface (Task Map)</title><para>The following task map describes the software management tasks that
you cab perform with the Solaris Product Registry command-line interface.</para><informaltable frame="all"><tgroup cols="3" colsep="1" rowsep="1"><?PubTbl tgroup dispwid="6.46in"?><colspec colname="colspec0" colwidth="27.64*"/><colspec colname="colspec1" colwidth="35.53*"/><colspec colname="colspec2" colwidth="35.82*"/><thead><row><entry><para>Task</para>
</entry><entry><para>Description</para>
</entry><entry><para>For Instructions</para>
</entry>
</row>
</thead><tbody><row><entry><para>View installed or uninstalled software.</para>
</entry><entry><para>You can view software information by using the <command>browse</command> subcommand.</para>
</entry><entry><para><olink targetptr="swmgrpkgsgui-39" remap="internal">How to View Installed or Uninstalled
Software Information (prodreg)</olink></para>
</entry>
</row><row><entry><para>View software attributes.</para>
</entry><entry><para>You can view specific software attributes by using the <command>info</command> subcommand.</para>
</entry><entry><para><olink targetptr="swmgrpkgsgui-47" remap="internal">How to View Software Attributes (prodreg)</olink></para>
</entry>
</row><row><entry><para>Check dependencies between software components.</para>
</entry><entry><para>You can view the components that depend on a specific software component
by using the <command>info</command> subcommand.</para>
</entry><entry><para><olink targetptr="swmgrpkgsgui-55" remap="internal">How to Check for Software Dependencies
(prodreg)</olink></para>
</entry>
</row><row><entry><para>Identify damaged software products.</para>
</entry><entry><para>If you remove installed software files or packages without using the
appropriate uninstaller, you can damage the software on your system.</para>
</entry><entry><para><olink targetptr="swmgrpkgsgui-60" remap="internal">How to Identify Damaged Software
Products (prodreg)</olink></para>
</entry>
</row><row><entry><para>Uninstall software </para>
</entry><entry><para>You can remove software from your system by using the <command>uninstall</command> subcommand.</para>
</entry><entry><para><olink targetptr="swmgrpkgsgui-66" remap="internal">How to Uninstall Software (prodreg)</olink></para>
</entry>
</row><row><entry><para>Uninstall damaged software.</para>
</entry><entry><para>Uninstalling a damaged software component might fail if the uninstaller
program for the software component has been removed from the system.</para>
</entry><entry><para><olink targetptr="swmgrpkgsgui-74" remap="internal">How to Uninstall Damaged Software
(prodreg)</olink></para>
</entry>
</row><row><entry><para>Reinstall damaged software components.</para>
</entry><entry><para>If other software depends on a damaged software component, you might
want to reinstall the damaged component, rather than uninstall the component
and the other dependent software.</para>
</entry><entry><para><olink targetptr="swmgrpkgsgui-82" remap="internal">How to Reinstall Damaged Software
Components (prodreg)</olink></para>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect1><sect1 id="ewbdh"><title>Managing Software With the Solaris Product Registry
Command-Line Interface</title><para>The <command>prodreg</command> command is the command-line interface
(CLI) to the Solaris Product Registry. The <command>prodreg</command> command
supports several subcommands that enable you to manage the software on your
system.</para><itemizedlist><para>You can use the <command>prodreg</command> command in a terminal window
to perform the following tasks:</para><listitem><para>View a list of installed and registered software and software
attributes.</para>
</listitem><listitem><para>View all Solaris system products that you installed in their
localized version in the System Software Localizations directory.</para>
</listitem><listitem><para>Identify damaged software.</para>
</listitem><listitem><para>Remove software entries from the Solaris Product Registry.</para>
</listitem><listitem><para>Uninstall software and individual software packages.</para>
</listitem>
</itemizedlist><para>For more information on how to manage the Solaris Product Registry by
using the command-line interface, see the <olink targetdoc="refman" targetptr="prodreg-1m" remap="external"><citerefentry><refentrytitle>prodreg</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink> man page.</para><task id="swmgrpkgsgui-39"><title>How to View Installed or Uninstalled Software
Information (<command>prodreg</command>)</title><tasksummary><para>You can view information about software in the Solaris Product Registry
in a terminal window by using the <command>browse</command> subcommand to
the <command>prodreg</command> command.</para>
</tasksummary><procedure><step><para>Open a terminal window.</para>
</step><step id="swmgrpkgsgui-step-41"><para>Browse the Solaris Product Registry.</para><screen>% <userinput>prodreg browse</userinput>
    BROWSE # +/-/.  UUID                                  #  NAME
    ======== =====  ====================================  =  ============
    1        -      root                                  1  System 
                                                             Registry
    2         +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 11 
                                                             System 
                                                             Software
    3         +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified
                                                             Software</screen><para>The <command>browse</command> subcommand to the <command>prodreg</command> command
displays the following information about registered software.</para><variablelist><varlistentry><term><literal>BROWSE #</literal></term><listitem><para>When you use the <command>prodreg browse</command> command,
the Solaris Product Registry generates a <emphasis>browse number</emphasis> for
each registered software component.  This number can be used as an argument
to  either the <command>prodreg browse</command> command or the <command>info</command> subcommand
to descend the hierarchy of specific registered components.</para><note><para>Browse numbers might change when you reboot or reinstall your
system. Do not store browse numbers in scripts or attempt to reuse them between
separate login sessions.</para>
</note>
</listitem>
</varlistentry><varlistentry><term><literal>+/-/.</literal></term><listitem><para>This field indicates if a software component has additional
software component children registered in the Solaris Product Registry. </para><itemizedlist><para>The following characters are displayed in this field:</para><listitem><para><literal>+</literal> indicates that the software component
has additional children components that are not currently displayed.</para>
</listitem><listitem><para><literal>-</literal> indicates that the software component
has additional children components that are currently displayed.</para>
</listitem><listitem><para><literal>.</literal> indicates that the software component
does not have children components.</para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry><varlistentry><term><literal>UUID</literal></term><listitem><para>This field lists the software's unique identifier in the Solaris
Product Registry.</para>
</listitem>
</varlistentry><varlistentry><term><literal>#</literal></term><listitem><para>This field indicates the <emphasis>instance number</emphasis> of
the software component on the system. If the system contains multiple instances
of a software component, the Solaris Product Registry assigns a separate instance
number to each instance of the component.</para>
</listitem>
</varlistentry><varlistentry><term><literal>NAME</literal></term><listitem><para>This field lists the localized name of the software. The name
of the Solaris OS in this sample output is the Solaris 10 system software.</para>
</listitem>
</varlistentry>
</variablelist>
</step><step id="swmgrpkgsgui-step-42"><para>Browse the information for one of the
software components that are listed in the Solaris Product Registry.</para><screen>% <userinput>prodreg browse  -m "<replaceable>name</replaceable>"</userinput></screen><para>The <option>m</option> &ldquo;<replaceable>name</replaceable>&rdquo;
command displays information on the software component with the name <replaceable>name</replaceable>.</para>
</step><step id="swmgrpkgsgui-step-42a"><para>If the system contains multiple instances
of <replaceable>name</replaceable> software, type the following command to
browse the Solaris Product Registry:</para><screen>% <userinput>prodreg browse  -u <replaceable>name-UUID</replaceable> -i <replaceable>instance</replaceable> -n <replaceable>number</replaceable></userinput></screen><variablelist termlength="wide"><varlistentry><term><option>u</option> <replaceable>name-UUID</replaceable></term><listitem><para>Displays information on the <replaceable>name</replaceable> software
component with the unique identifier <replaceable>name-UUID</replaceable>.</para>
</listitem>
</varlistentry><varlistentry><term><option>i</option> <replaceable>instance</replaceable></term><listitem><para>Displays information on the <replaceable>name</replaceable> software
component with the instance number <replaceable>instance</replaceable>.</para>
</listitem>
</varlistentry><varlistentry><term><option>n</option> <replaceable>number</replaceable></term><listitem><para>Displays software information by referencing the component's
browse number <replaceable>number</replaceable>.</para>
</listitem>
</varlistentry>
</variablelist>
</step><step id="swmgrpkgsgui-step-43"><para>Repeat <olink targetptr="swmgrpkgsgui-step-42" remap="internal">Step&nbsp;3</olink> and <olink targetptr="swmgrpkgsgui-step-42a" remap="internal">Step&nbsp;4</olink> for each software component
that you want to browse.</para>
</step>
</procedure><example id="swmgrpkgsgui-44"><title>Viewing Software Information by Component Name (<command>prodreg</command>)</title><para>The following example shows how to view software information by referencing
the component's name.</para><screen>% <userinput>prodreg browse<?Pub _bookmark Command="[Quick Mark]"?></userinput>
    BROWSE # +/-/.  UUID                                  #  NAME
    ======== =====  ====================================  =  ============
    1        -      root                                  1  System 
                                                             Registry
    2         +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10  
                                                             System 
                                                             Software
    3         +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified
                                                             Software

% <userinput>prodreg browse -m "Solaris 10 System Software"</userinput></screen>
</example><example id="swmgrpkgsgui-45"><title>Viewing Software Information by Component Browse Number (<command>prodreg</command>)</title><para>The following example shows how to use the <option>n</option> option
with the <command>prodreg browse</command> command to view software information
by referencing the component's browse number.</para><screen>% <userinput>prodreg browse<?Pub _bookmark Command="[Quick Mark]"?></userinput>
    BROWSE # +/-/.  UUID                                  #  NAME
    ======== =====  ====================================  =  ============
    1        -      root                                  1  System 
                                                             Registry
    2         +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10 
                                                             System 
                                                             Software
    3         +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified
                                                             Software

% <userinput>prodreg browse -n 2</userinput></screen>
</example><example id="swmgrpkgsgui-46"><title>Viewing Software Information by Component UUID (<command>prodreg</command>)</title><para>The following example shows how to use the <option>u</option> option
with the <command>prodreg browse</command> command to view software information
by referencing the component's UUID. The UUID is the software's unique identifier
in the Solaris Product Registry.</para><screen>% <userinput>prodreg browse<?Pub _bookmark Command="[Quick Mark]"?></userinput>
    BROWSE # +/-/.  UUID                                  #  NAME
    ======== =====  ====================================  =  ============
    1        -      root                                  1  System 
                                                             Registry
    2         +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10 
                                                             System 
                                                             Software
    3         +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified
                                                             Software

% <userinput>prodreg browse -u a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b</userinput></screen>
</example>
</task><task id="swmgrpkgsgui-47"><title>How to View Software Attributes (<command>prodreg</command>)</title><tasksummary><para>You can view specific software attributes by using the <command>info</command> subcommand
of the <command>prodreg</command> command. </para><itemizedlist><para>The <command>prodreg info</command> command displays a variety of information
about registered software, including the following items:</para><listitem><para>Software component name</para>
</listitem><listitem><para>Software component description</para>
</listitem><listitem><para>Required components of the software</para>
</listitem><listitem><para>Other components that require the software</para>
</listitem><listitem><para>Base directory of the software</para>
</listitem><listitem><para>Path to the software component</para>
</listitem>
</itemizedlist>
</tasksummary><procedure><step><para>Open a terminal window.</para>
</step><step id="swmgrpkgsgui-step-49"><para>Browse the Solaris Product Registry.</para><screen>% <userinput>prodreg browse</userinput>
    BROWSE # +/-/.  UUID                                  #  NAME
    ======== =====  ====================================  =  ============
    1        -      root                                  1  System 
                                                             Registry
    2         +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10
                                                             System 
                                                             Software
    3         +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified
                                                             Software</screen>
</step><step id="swmgrpkgsgui-step-50"><para>View the attributes for one of the listed
software components.</para><screen>% <userinput>prodreg info  -m "<replaceable>name</replaceable>"</userinput></screen><para>The <option>m</option> &ldquo;<replaceable>name<?Pub _bookmark
Command="[Quick Mark]"?></replaceable>&rdquo; command displays the attributes
of the software component with the name <replaceable>name</replaceable>.</para>
</step><step id="swmgrpkgsgui-step-51"><para>Repeat <olink targetptr="swmgrpkgsgui-step-50" remap="internal">Step&nbsp;3</olink> for each software component
you want to view.</para>
</step>
</procedure><example id="swmgrpkgsgui-52"><title>Viewing Software Attributes by Component Name (<command>prodreg</command>)</title><para>The following example shows how to view software attributes by referencing
the component's name.</para><screen>% <userinput>prodreg browse<?Pub _bookmark Command="[Quick Mark]"?></userinput>
    BROWSE # +/-/.  UUID                                  #  NAME
    ======== =====  ====================================  =  ============
    1        -      root                                  1  System 
                                                             Registry
    2         +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10
                                                             System 
                                                             Software
    3         +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified
                                                             Software

% <userinput>prodreg info -m "Solaris 10 System Software"</userinput></screen>
</example><example id="swmgrpkgsgui-53"><title>Viewing Software Attributes by Component Browse Number (<command>prodreg</command>)</title><para>The following example shows how to use the <option>n</option> option
with the <command>prodreg info</command> command to view software attributes
by referencing the component's browse number.</para><screen>% <userinput>prodreg browse</userinput>
    BROWSE # +/-/.  UUID                                  #  NAME
    ======== =====  ====================================  =  ============
    1        -      root                                  1  System 
                                                             Registry
    2         +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10 
                                                             System 
                                                             Software
    3         +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified
                                                             Software

% <userinput>prodreg info -n 2</userinput></screen>
</example><example id="swmgrpkgsgui-54"><title>Viewing Software Attributes by Component UUID (<command>prodreg</command>)</title><para>The following example shows how to use the <option>u</option> option
with the <command>prodreg info</command> command to view software attributes
by referencing the component's UUID. The UUID is the software's unique identifier
in the Solaris Product Registry.</para><screen>% <userinput>prodreg browse<?Pub _bookmark Command="[Quick Mark]"?></userinput>
    BROWSE # +/-/.  UUID                                  #  NAME
    ======== =====  ====================================  =  ============
    1        -      root                                  1  System 
                                                             Registry
    2         +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10 
                                                             System 
                                                             Software
    3         +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified
                                                             Software

% <userinput>prodreg info -u a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b</userinput></screen>
</example>
</task><task id="swmgrpkgsgui-55"><title>How to Check for Software Dependencies (<command>prodreg</command>)</title><tasksummary><para>You can use the <command>prodreg info</command> command to view components
that depend on a specific software component. You might want to check dependencies
between software products before you uninstall specific components.</para>
</tasksummary><procedure><step><para>Open a terminal window.</para>
</step><step id="swmgrpkgsgui-step-57"><para>Browse the Solaris Product Registry.</para><screen>% <userinput>prodreg browse</userinput>
    BROWSE # +/-/.  UUID                                  #  NAME
    ======== =====  ====================================  =  ============
    1        -      root                                  1  System 
                                                             Registry
    2         +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10 
                                                             System 
                                                             Software
    3         +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified
                                                             Software</screen><para>Repeat the <command>prodreg browse</command> command until the software
component you want to check is displayed. See <olink targetptr="swmgrpkgsgui-39" remap="internal">How to View Installed or Uninstalled Software Information (prodreg)</olink> for
more information on browsing the Solaris Product Registry by using the <command>prodreg
browse</command> command.</para>
</step><step id="swmgrpkgsgui-step-58"><para>View the dependencies of a specific
software component.</para><screen>% <userinput>prodreg info -m "<replaceable>name</replaceable>" -a "Dependent Components"</userinput></screen><variablelist termlength="wide"><varlistentry><term><option>m</option> &ldquo;<replaceable>name<?Pub _bookmark
Command="[Quick Mark]"?></replaceable>&rdquo;</term><listitem><para>Displays the attributes of the software component with the
name <replaceable>name</replaceable>.</para>
</listitem>
</varlistentry><varlistentry><term><option>a</option> &ldquo;Dependent Components&rdquo;</term><listitem><para>Displays components that depend on <replaceable>name<?Pub _bookmark
Command="[Quick Mark]"?></replaceable> software by displaying the values of
the Dependent Components attribute.</para>
</listitem>
</varlistentry>
</variablelist><para>This command output lists the software components that depend on <replaceable>name</replaceable> software.</para>
</step>
</procedure><example id="swmgrpkgsgui-59"><title>Viewing Components That Depend on Other Software Products (<command>prodreg</command>)</title><para>The following example shows how to view the components that depend on
the software product that is named <literal>ExampleSoft</literal>.</para><screen>% <userinput>prodreg -m "ExampleSoft" -a "Dependent Components"</userinput>
Dependent Components:
Name                         UUID                                  #
---------------------------  ------------------------------------  -
ExampleSoftA                 7f49ecvb-1ii2-11b2-a3f1-0800119u7e8e  1</screen>
</example>
</task><task id="swmgrpkgsgui-60"><title>How to Identify Damaged Software Products
(<command>prodreg</command>)</title><tasksummary><para>If you remove installed software files or packages without using the
appropriate uninstaller, you can damage the software on your system. If software
is damaged, the software might not function properly. You can use the <command>info</command> subcommand of the <command>prodreg</command> command to help you
determine if a software product is damaged.</para>
</tasksummary><procedure><step><para>View the Solaris Product Registry information on the software
you want to check.</para><screen>% <userinput>prodreg browse -m <replaceable>name</replaceable></userinput>
BROWSE #  +/-/.  UUID                                  #  NAME
========  =====  ====================================  =  ============
1         -      root                                  1  System 
                                                          Registry
2          +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10
                                                          System
                                                          Software
3          +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified 
                                                          Software
4          -     <replaceable>name-UUID</replaceable>                              1  <replaceable>name</replaceable>
233         .    <replaceable>component-a-pkg</replaceable>                           1  <replaceable>component-a</replaceable>
234         .    <replaceable>component-b-pkg</replaceable>                           1</screen><variablelist termlength="wide"><varlistentry><term><option>m</option> &ldquo;<replaceable>name</replaceable>&rdquo;</term><listitem><para>Displays information on the software component with the name <replaceable>name</replaceable>.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>name-UUID</replaceable></term><listitem><para>Specifies the UUID of the <replaceable>name</replaceable> software
component.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>component-a-pkg</replaceable></term><listitem><para>Specifies the package name of the <replaceable>component-a</replaceable> component
that depends on <replaceable>name</replaceable> software.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>component-a</replaceable></term><listitem><para>Specifies the name of a component that depends on <replaceable>name</replaceable> software.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>component-b-pkg</replaceable></term><listitem><para>Specifies the package name of the <replaceable>component-b</replaceable> component
that depends on <replaceable>name</replaceable> software.</para>
</listitem>
</varlistentry>
</variablelist><para>In the previous sample output, the <replaceable>component-b-pkg</replaceable> entry
does not have an associated name in the <literal>Name</literal> field. If
a software component name is not displayed in the Solaris Product Registry,
the component might be damaged.</para>
</step><step id="swmgrpkgsgui-step-62"><para>Verify that the software component is
damaged.</para><screen>% <userinput>prodreg info -u <replaceable>name-UUID</replaceable> -i 1 -d</userinput>
isDamaged=TRUE</screen><variablelist termlength="wide"><varlistentry><term><option>u</option> <replaceable>name-UUID</replaceable></term><listitem><para>Displays information on the <replaceable>name</replaceable> software
component.</para>
</listitem>
</varlistentry><varlistentry><term><option>i</option> 1</term><listitem><para>Displays information on the first instance of the <replaceable>name</replaceable> software component.</para>
</listitem>
</varlistentry><varlistentry><term><option>d</option></term><listitem><para>Displays the value of the <literal>isDamaged</literal> attribute
of the <replaceable>name</replaceable> software component.</para>
</listitem>
</varlistentry>
</variablelist><para>The output <literal>isDamaged=TRUE</literal> indicates that the <replaceable>name</replaceable> software component is damaged.</para>
</step><step id="swmgrpkgsgui-step-63"><para>Identify the packages that form the <replaceable>name-UUID</replaceable> software component.</para><screen>% <userinput>prodreg info -u <replaceable>name-UUID</replaceable> -i 1 -a PKGS</userinput>
pkgs:
<replaceable>component-a-pkg</replaceable> <replaceable>component-b-pkg</replaceable></screen>
</step><step id="swmgrpkgsgui-step-64"><para>Verify that these packages are installed
on the system.</para><screen>% <userinput>pkginfo <replaceable>component-a-pkg</replaceable></userinput>
application <replaceable>component-a-pkg</replaceable> <replaceable>component-a</replaceable>

% <userinput>pkginfo <replaceable>component-b-pkg</replaceable></userinput>
ERROR: information on "<replaceable>component-b-pkg</replaceable>" was not found</screen><para>The error message output of the <command>pkginfo <replaceable>component-b-pkg</replaceable></command> command indicates that the <replaceable>component-b-pkg</replaceable> package
has been removed from the system. The <replaceable>name</replaceable> software
component might not work without the <replaceable>component-b-pkg</replaceable> package.</para>
</step>
</procedure><example id="swmgrpkgsgui-65"><title>Identifying Damaged Software Components (<command>prodreg</command>)</title><para>The following example shows how to determine if the ExampleSoft software
component is damaged.</para><screen>% <userinput>prodreg browse -m Examplesoft</userinput>
BROWSE #  +/-/.  UUID                                  #  NAME
========  =====  ====================================  =  ============
1         -      root                                  1  System 
                                                          Registry
2          +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10
                                                          System
                                                          Software
3          +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified 
                                                          Software
4          -     95842091-725a-8501-ef29-0472985982be  1  ExampleSoft
233         .    90209809-9785-b89e-c821-0472985982be  1  Example Doc
234         .    EXSOzzt                               1
235         .    EXSOblob                              1  Example Data</screen><para>The <literal>ExampleSoft</literal> child component <literal>EXSOzzt</literal> does
not have an entry in the <literal>NAME</literal> field. The <literal>ExampleSoft</literal> software
might be damaged. You would use the <command>prodreg info</command> command
with the <option>u</option>, <option>i</option>, and <option>d</option> options
to determine if the <literal>ExampleSoft</literal> software is damaged.</para><screen>% <userinput>prodreg info -u 95842091-725a-8501-ef29-0472985982be -i 1 -d</userinput> 
isDamaged=TRUE</screen><para>The output <literal>isDamaged=TRUE</literal> indicates that the <literal>ExampleSoft</literal> software is damaged. You would use the <option>a PKGS</option> option
of the <command>prodreg info</command> command to identify the <literal>ExampleSoft</literal> software packages.</para><screen>% <userinput>prodreg info 
     -u 95842091-725a-8501-ef29-0472985982be 
     -i 1 -a PKGS</userinput> 
pkgs: 
EXSOzzt EXSOblob</screen><para>To verify that the <literal>EXSOzzt</literal> and <literal>EXSOblob</literal> packages
are installed on the system, you would use the <command>pkginfo</command> command.</para><screen>% <userinput>pkginfo EXSOzzt</userinput> 
ERROR: information for "EXSOzzt" was not found 

% <userinput>pkginfo EXSOblob</userinput>
application EXSOblob       Example Data</screen><para>The output of the <command>pkginfo</command> command indicates that
the <literal>EXSOzzt</literal> package is not installed on the system. Thus,
the <literal>ExampleSoft</literal> software is damaged.</para>
</example>
</task><task id="swmgrpkgsgui-66"><title>How to Uninstall Software (<command>prodreg</command>)</title><tasksummary><para>You can use the <command>uninstall</command> subcommand of the <command>prodreg</command> command to remove software from your system. When you uninstall
software by using the <command>prodreg uninstall</command> command, you remove
a specified software and all the child components associated with that software.
Before you remove software, verify that other software does not depend on
the software you want to uninstall. See <olink targetptr="swmgrpkgsgui-55" remap="internal">How
to Check for Software Dependencies (prodreg)</olink>.</para><para>After you uninstall software, you can remove that software and all the
child components of that software from the Solaris Product Registry by using
the <command>prodreg unregister <option>r</option></command> command.</para>
</tasksummary><procedure>&rolestep.sgm;<step id="swmgrpkgsgui-step-68"><para>View the information on the software
you want to uninstall.</para><screen># <userinput>prodreg browse -u <replaceable>name-UUID</replaceable></userinput>
BROWSE #  +/-/.  UUID                                  #  NAME
========  =====  ====================================  =  ============
1         -      root                                  1  System 
                                                          Registry
2          +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10
                                                          System
                                                          Software
3          +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified 
                                                          Software
1423       -     <replaceable>name-UUID</replaceable>                              1  <replaceable>name</replaceable>
1436        .    <replaceable>component-a-UUID</replaceable>                          1  <replaceable>component-a</replaceable>
1437        -    <replaceable>component-b-UUID</replaceable>                          1  <replaceable>component-b</replaceable>
1462         .   <replaceable>component-c-UUID</replaceable>                          1  <replaceable>component-c</replaceable></screen><variablelist termlength="wide"><varlistentry><term><option>u</option> <replaceable>name-UUID</replaceable></term><listitem><para>Displays information on the software component with the unique
identifier <replaceable>name-UUID</replaceable>.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>name</replaceable></term><listitem><para>Specifies the name of the software component you want to uninstall
with the unique identifier <replaceable>name-UUID</replaceable>.</para>
</listitem>
</varlistentry><varlistentry><term>. <replaceable>component-a-UUID</replaceable></term><listitem><para>Specifies the unique identifier of the <replaceable>component-a</replaceable> software
component that is required by <replaceable>name</replaceable> software.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>component-a</replaceable></term><listitem><para>Specifies the name of a component that is required by <replaceable>name</replaceable> software.</para>
</listitem>
</varlistentry><varlistentry><term>- <replaceable>component-b-UUID</replaceable></term><listitem><para>Specifies the unique identifier of the <replaceable>component-b</replaceable> component
that is required by <replaceable>name</replaceable> software. The - symbol
indicates that <replaceable>component-b</replaceable> requires an additional
software component.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>component-b</replaceable></term><listitem><para>Specifies the name of a software component that is required
by <replaceable>name</replaceable> software.</para>
</listitem>
</varlistentry><varlistentry><term>. <replaceable>component-c-UUID</replaceable></term><listitem><para>Specifies the unique identifier of the <replaceable>component-b</replaceable> software
component that is required by <replaceable>component-b</replaceable> software.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>component-c</replaceable></term><listitem><para>Specifies the name of a software component that is required
by <replaceable>component-b</replaceable> software.</para>
</listitem>
</varlistentry>
</variablelist>
</step><step id="swmgrpkgsgui-step-69"><para>Uninstall the software.</para><screen># <userinput>prodreg uninstall -u <replaceable>name-UUID</replaceable></userinput> </screen>
</step><step id="swmgrpkgsgui-step-70"><para>Check the dependencies for the software
that you want to uninstall.</para><screen># <userinput>prodreg info -u <replaceable>name-UUID</replaceable></userinput>
Title: <replaceable>name</replaceable>
.
.
.
Child Components:
Name                        UUID                                  #
--------------------------  ------------------------------------  -
<replaceable>component-a</replaceable>                    <replaceable>component-a-UUID</replaceable>                        1
<replaceable>component-b</replaceable>                    <replaceable>component-b-UUID</replaceable>                        1

Required Components:
Name                        UUID                                  #
--------------------------  ------------------------------------  -
<replaceable>component-a</replaceable>                    <replaceable>component-a-UUID</replaceable>                        1
<replaceable>component-b</replaceable>                    <replaceable>component-b-UUID</replaceable>                        1</screen><itemizedlist><para>Check the following information in the output of the <command>prodreg
info</command> command.</para><listitem><para>Child Components &ndash; Lists the software components that
are associated with the <replaceable>name</replaceable> software component.
When you unregister the <replaceable>name</replaceable> software, you also
unregister the child components of <replaceable>name</replaceable> software.
If the output of the previous <command>prodreg info</command> command lists
any child components, verify that you want to unregister these child components.</para>
</listitem><listitem><para>Required Components &ndash; Lists the software components
that are required by the <replaceable>name</replaceable> software component.
Software components might require other components that are not child components.
When you uninstall and unregister a component, only child components are unregistered
and uninstalled.</para>
</listitem><listitem><para>Dependent Components &ndash; Lists the components that require <replaceable>name</replaceable> software to run. When you unregister the <replaceable>name</replaceable> software,
you also unregister the dependent components of <replaceable>name</replaceable> software.
If the output of the <command>prodreg info</command> command lists any dependent
components, verify that you want to unregister these dependent components.</para>
</listitem>
</itemizedlist><para>In the previous sample output, <replaceable>name</replaceable> software
does not have any dependent components.</para>
</step><step id="swmgrpkgsgui-step-71"><para>Check the dependencies of <replaceable>name</replaceable> software's child components.</para><screen># <userinput>prodreg info -u <replaceable>component-a-UUID</replaceable> -i 1 -a "Dependent Components"</userinput>
Dependent Components:
Name                         UUID                                  #
---------------------------  ------------------------------------  -
<replaceable>name</replaceable>                          <replaceable>name-UUID</replaceable>                             1

# <userinput>prodreg info -u <replaceable>component-b-UUID</replaceable> -i 1 -a "Dependent Components"</userinput>
Dependent Components:
Name                         UUID                                  #
---------------------------  ------------------------------------  -
<replaceable>name</replaceable>                          <replaceable>name-UUID</replaceable>                             1

# <userinput>prodreg info -u <replaceable>component-c-UUID</replaceable> -i 1 -a "Dependent Components"</userinput>
Dependent Components:
Name                         UUID                                  #
---------------------------  ------------------------------------  -
<replaceable>component-b</replaceable>                     <replaceable>component-b-UUID</replaceable>                        1</screen><para>The sample output shows that no other software depends on the child
components of <replaceable>name</replaceable> software.</para>
</step><step id="swmgrpkgsgui-step-72"><para>Unregister the software and its child
components.</para><screen># <userinput>prodreg unregister -r -u <replaceable>name-UUID</replaceable> -i 1</userinput></screen><variablelist termlength="wide"><varlistentry><term><option>r</option></term><listitem><para>Recursively unregisters software with the unique identifier <replaceable>name-UUID</replaceable> and all the child components of this software.</para>
</listitem>
</varlistentry><varlistentry><term><option>u</option> <replaceable>name-UUID</replaceable></term><listitem><para>Specifies the unique identifier of the software you want to
unregister.</para>
</listitem>
</varlistentry><varlistentry><term><option>i</option> 1</term><listitem><para>Specifies the instance of the software you want to unregister.</para>
</listitem>
</varlistentry>
</variablelist>
</step>
</procedure><example id="swmgrpkgsgui-73"><title>Uninstalling Software Components (<command>prodreg</command>)</title><para>The following example shows how to uninstall ExampleSoft software and
all the child components of ExampleSoft software.</para><screen># <userinput>prodreg browse -m "ExampleSoft"</userinput>
BROWSE #  +/-/.  UUID                                  #  NAME
========  =====  ====================================  =  ============
1         -      root                                  1  System 
                                                          Registry
2          +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10
                                                          System
                                                          Software
3          +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified 
                                                          Software
1423       -     95842091-725a-8501-ef29-0472985982be  1  ExampleSoft
1436        .    90209809-9785-b89e-c821-0472985982be  1  Example Doc
1437        -    EXSOzzt                               1  Example Data
1462         .   EXSOblob                              1  Example Data

# <userinput>prodreg uninstall -u 95842091-725a-8501-ef29-0472985982be -i 1</userinput>

# <userinput>prodreg info -u 95842091-725a-8501-ef29-0472985982be</userinput>
Title: ExampleSoft Software
.
.
.
Child Components:
Name                        UUID                                  #
--------------------------  ------------------------------------  -
Example Doc                 90209809-9785-b89e-c821-0472985982be  1
Example Data                EXSOzzt                               1

Required Components:
Name                        UUID                                  #
--------------------------  ------------------------------------  -
Example Doc                 90209809-9785-b89e-c821-0472985982be  1
Example Data                EXSOzzt                               1

# <userinput>prodreg info -u 90209809-9785-b89e-c821-0472985982be -i 1 
    -a "Dependent Components"</userinput>
Dependent Components:
Name                         UUID                                  #
---------------------------  ------------------------------------  -
ExampleSoft                  95842091-725a-8501-ef29-0472985982be  1

# <userinput>prodreg info -u EXSOzzt -i 1 -a "Dependent Components"</userinput>
Dependent Components:
Name                         UUID                                  #
---------------------------  ------------------------------------  -
ExampleSoft                  95842091-725a-8501-ef29-0472985982be  1

# <userinput>prodreg info -u EXSOblob -i 1 -a "Dependent Components"</userinput>
Dependent Components:
Name                         UUID                                  #
---------------------------  ------------------------------------  -
Example Data                 EXSOzzt                               1

# <userinput>prodreg unregister -r -u 95842091-725a-8501-ef29-0472985982be -i 1</userinput></screen>
</example>
</task><task id="swmgrpkgsgui-74"><title>How to Uninstall Damaged Software (<command>prodreg</command>)</title><tasksummary><para>If you try to uninstall a damaged software component by using the <command>prodreg uninstall</command> command, the command might fail. This failure
can occur if the uninstaller program for the software component has been removed
from the system.</para><para>Follow these steps to uninstall a software component with no associated
uninstaller program on the system.</para>
</tasksummary><procedure>&rolestep.sgm;<step id="swmgrpkgsgui-step-76"><para>View the information on the software
you want to uninstall.</para><screen># <userinput>prodreg browse -m "<replaceable>name</replaceable>"</userinput>
BROWSE #  +/-/.  UUID                                  #  NAME
========  =====  ====================================  =  ============
1         -      root                                  1  System 
                                                          Registry
2          +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10 
                                                          System
                                                          Software
3          +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified 
                                                          Software
4           -    <replaceable>UUID</replaceable>                                  1  <replaceable>name</replaceable>
1436        .    <replaceable>component-a-UUID</replaceable>                         1  <replaceable>component-a</replaceable>
1437        .    <replaceable>component-b-UUID</replaceable>                         1  </screen><variablelist termlength="wide"><varlistentry><term><option>m</option> &ldquo;<replaceable>name</replaceable>&rdquo;</term><listitem><para>Displays information on the <replaceable>name</replaceable> software
component you want to uninstall.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>UUID</replaceable></term><listitem><para>Specifies the UUID of the software component you want to uninstall.</para>
</listitem>
</varlistentry><varlistentry><term>. <replaceable>component-a-UUID</replaceable></term><listitem><para>Specifies the UUID of the <replaceable>component-a</replaceable> software
component.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>component-a</replaceable></term><listitem><para>Specifies the name of a child software component of <replaceable>name</replaceable> software.</para>
</listitem>
</varlistentry><varlistentry><term>. <replaceable>component-b-UUID</replaceable></term><listitem><para>Specifies the UUID of a child software component of <replaceable>name</replaceable> software.</para>
</listitem>
</varlistentry>
</variablelist><para>The <replaceable>component-b-UUID</replaceable> entry does not have
an associated component name. The missing name value might indicate that this
component is damaged.</para>
</step><step id="swmgrpkgsgui-step-77"><para>Uninstall the software.</para><screen># <userinput>prodreg uninstall -u <replaceable>UUID</replaceable> -i 1</userinput>
The install program requested could not be found</screen><variablelist termlength="wide"><varlistentry><term><option>u</option> <replaceable>UUID</replaceable></term><listitem><para>Specifies the UUID of the software component you want to uninstall.</para>
</listitem>
</varlistentry><varlistentry><term><option>i</option> 1</term><listitem><para>Specifies the instance of the software you want to uninstall.</para>
</listitem>
</varlistentry>
</variablelist><para>The error message indicates that the uninstaller program is not on the
system.</para>
</step><step id="swmgrpkgsgui-step-78"><para>Identify the uninstaller program for
the software component.</para><screen># <userinput>prodreg info -m "<replaceable>name</replaceable>" -a uninstallprogram</userinput>
uninstallprogram: /usr/bin/java -mx64m -classpath 
<replaceable>uninstaller-location</replaceable> uninstall_<replaceable>name</replaceable></screen><variablelist termlength="wide"><varlistentry><term><option>m</option> &ldquo;<replaceable>name</replaceable>&rdquo;</term><listitem><para>Displays information on the <replaceable>name</replaceable> software
component.</para>
</listitem>
</varlistentry><varlistentry><term><option>a</option> <command>uninstallprogram</command></term><listitem><para>Displays information on the uninstaller program that is associated
with the <replaceable>name</replaceable> software component.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>uninstaller-location</replaceable></term><listitem><para>Specifies the registered location of the uninstaller program
for the <replaceable>name</replaceable> software component.</para>
</listitem>
</varlistentry>
</variablelist>
</step><step id="swmgrpkgsgui-step-79"><para>Determine if the uninstaller is in the
registered location.</para><screen># <userinput>ls <replaceable>uninstaller-location</replaceable></userinput>
<replaceable>uninstaller-location</replaceable>:
No such file or directory</screen><para>The output of the <command>ls</command> command indicates that the uninstaller
program is not in the registered location.</para>
</step><step id="swmgrpkgsgui-step-80"><para>Remove the software from the system
in one of the following ways:</para><stepalternatives><step><para>If you have a system backup available, follow these steps:</para><substeps><step><para>Load the uninstaller program from the backup.</para>
</step><step><para>Run the uninstaller program from a shell command-line interface
such as a terminal window.</para>
</step>
</substeps>
</step><step><para>If you do not have access to the uninstaller program on a backup,
follow these steps:</para><substeps><step><para>Unregister the software component.</para><screen># <userinput>prodreg unregister -u <replaceable>UUID</replaceable> -i 1</userinput></screen>
</step><step><para>Remove any remaining registered components that are required by
the software you want to remove.</para><screen># <userinput>pkgrm <replaceable>component-a-UUID</replaceable></userinput></screen>
</step>
</substeps>
</step>
</stepalternatives>
</step>
</procedure><example id="swmgrpkgsgui-81"><title>Uninstalling Damaged Software (<command>prodreg</command>)</title><para>The following example shows how to uninstall the damaged ExampleSoft
software. In this example, the uninstaller program is not readily available
on a system backup.</para><screen># <userinput>prodreg browse -m Examplesoft</userinput>
BROWSE #  +/-/.  UUID                                  #  NAME
========  =====  ====================================  =  ============
1         -      root                                  1  System 
                                                          Registry
2          +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10 
                                                          System
                                                          Software
3          +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified 
                                                          Software
4          -     95842091-725a-8501-ef29-0472985982be  1  ExampleSoft
233         .    90209809-9785-b89e-c821-0472985982be  1  Example Doc
234         .    EXSOzzt                               1
235         .    EXSOblob                              1  Example Data

# <userinput>prodreg uninstall -u 95842091-725a-8501-ef29-0472985982be -i 1</userinput>
The install program requested could not be found

# <userinput>prodreg info -m "ExampleSoft" -a uninstallprogram</userinput>
uninstallprogram: /usr/bin/java -mx64m -classpath 
/var/sadm/prod/org.example.ExampleSoft/987573587 uninstall_ExampleSoft

# <userinput>ls /var/sadm/prod/org.example.ExampleSoft/987573587</userinput>
/var/sadm/prod/org.example.ExampleSoft/987573587:
No such file or directory

# <userinput>prodreg unregister -u 95842091-725a-8501-ef29-0472985982be -i 1</userinput>

# <userinput>pkgrm EXSOblob</userinput></screen>
</example>
</task><task id="swmgrpkgsgui-82"><title>How to Reinstall Damaged Software Components
(<command>prodreg</command>)</title><tasksummary><para>If other software depends on a damaged software component, you might
want to reinstall the damaged component, rather than uninstall the component
and the other dependent software. You can use the <option>f</option> option
with the <command>prodreg unregister</command> command to forcibly the unregister
the damaged component. Then, you can reinstall the component.</para>
</tasksummary><procedure>&rolestep.sgm;<step id="swmgrpkgsgui-step-84"><para>View the information on the software
you want to reinstall.</para><screen># <userinput>prodreg browse -m "<replaceable>name</replaceable>"</userinput>
BROWSE #  +/-/.  UUID                                  #  NAME
========  =====  ====================================  =  ============
1         -      root                                  1  System 
                                                          Registry
2          +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10 
                                                          System
                                                          Software
3          +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified 
                                                          Software
4           .    <replaceable>UUID</replaceable>                                  1  <replaceable>name</replaceable></screen><variablelist termlength="wide"><varlistentry><term><option>m</option> &ldquo;<replaceable>name</replaceable>&rdquo;</term><listitem><para>Displays information on the <replaceable>name</replaceable> software
component you want to reinstall.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>UUID</replaceable></term><listitem><para>Specifies the UUID of the software component you want to reinstall.</para>
</listitem>
</varlistentry>
</variablelist>
</step><step id="swmgrpkgsgui-step-85"><para>Identify the software that depends on
the software you want to reinstall.</para><screen># <userinput>prodreg info -m "<replaceable>name</replaceable>" -a "Dependent Components"</userinput>
Dependent Components:
Name                         UUID                                  #
---------------------------  ------------------------------------  -
<replaceable>component-a</replaceable>                     <replaceable>component-a-UUID</replaceable> 1</screen><variablelist termlength="wide"><varlistentry><term><option>m</option> &ldquo;<replaceable>name</replaceable>&rdquo;</term><listitem><para>Specifies the name of the software component you want to reinstall.</para>
</listitem>
</varlistentry><varlistentry><term><option>a</option> &ldquo;<literal>Dependent Components</literal>&rdquo;</term><listitem><para>Displays the components that depend on <replaceable>name</replaceable> software.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>component-a</replaceable></term><listitem><para>Specifies the name of a software component that depends on <replaceable>name</replaceable> software.</para>
</listitem>
</varlistentry><varlistentry><term><replaceable>component-a-UUID</replaceable></term><listitem><para>Specifies the UUID of the <replaceable>component-a</replaceable> software
component.</para>
</listitem>
</varlistentry>
</variablelist><para>The <replaceable>component-a</replaceable> software component depends
on the software you want to reinstall. To reinstall <replaceable>name</replaceable> software
and not unregister <replaceable>component-a</replaceable>, you must forcibly
unregister the <replaceable>name</replaceable> software, then reinstall <replaceable>name</replaceable> software.</para>
</step><step id="swmgrpkgsgui-step-86"><para>Unregister the software component you
want to reinstall.</para><screen># <userinput>prodreg unregister -f -u <replaceable>UUID</replaceable></userinput>
 </screen>
</step><step id="swmgrpkgsgui-step-87"><para>Reinstall the software component.</para><screen># <userinput>/usr/bin/java -cp /usr/installers/<replaceable>installer</replaceable></userinput></screen><para>The <replaceable>installer</replaceable> option specifies the name of
the installer program for <replaceable>name</replaceable> software.</para>
</step>
</procedure><example id="swmgrpkgsgui-88"><title>Reinstalling Damaged Software Components (<command>prodreg</command>)</title><para>The following example shows how to reinstall the damaged software component <literal>ComponentSoft</literal> without unregistering or uninstalling the dependent
component ExampleSoft.</para><screen># <userinput>prodreg browse -m "ComponentSoft"</userinput>
BROWSE #  +/-/.  UUID                                  #  NAME
========  =====  ====================================  =  ============
1         -      root                                  1  System 
                                                          Registry
2          +     a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b  1  Solaris 10
                                                          System
                                                          Software
3          +     8f64eabf-1dd2-11b2-a3f1-0800209a5b6b  1  Unclassified 
                                                          Software
4           .    86758449-554a-6531-fe90-4352678362fe  1  ComponentSoft

# <userinput>prodreg info -m "ComponentSoft" -a "Dependent Components"</userinput>
Dependent Components:
Name                         UUID                                  #
---------------------------  ------------------------------------  -
ExampleSoft                  95842091-725a-8501-ef29-0472985982be  1

# <userinput>prodreg unregister -f -u 86758449-554a-6531-fe90-4352678362fe -i 1</userinput>

# <userinput>/usr/bin/java -cp /usr/installers/org.example.componentsoft</userinput></screen>
</example>
</task>
</sect1>
</chapter><?Pub *0000074652 0?>