Chapter 21 Managing Software With Oracle Solaris System Administration Tools (Tasks)

This chapter describes how to add, verify, and remove software packages by using the Oracle Solaris installation graphical user interface (GUI) and the Oracle Solaris Product Registry.

For information about software management features that are new in this release, see What's New in Software Management in the Oracle Solaris Operating System?.

For information about the procedures that are associated with performing software management tasks, see:

• Adding Software With the Oracle Solaris Installation GUI

• Managing Software With the Oracle Solaris Product Registry GUI (Task Map)

• Managing Software With the Oracle Solaris Product Registry Command-Line Interface (Task Map)

Oracle Solaris Product Registry and Solaris GUI Installation Tools for Managing Software

The following table lists the commands to use for adding, removing, and checking the installation of software packages the Oracle Solaris installation GUI and Oracle Solaris Product Registry tools.

Adding Software With the Oracle Solaris Installation GUI

This section describes how to use the Oracle Solaris installation GUI to add software to a system on which you have installed the Oracle Solaris OS. The installation GUI installs only the components of the software groups that you skipped when you initially installed Oracle Solaris. You cannot upgrade to another software group after installing or upgrading the OS.

How to Install Software With the Oracle Solaris Installation GUI Program

This procedure assumes that the system is running volume management (vold). If your system is not running volume management, see Chapter 3, Accessing Removable Media (Tasks), in System Administration Guide: Devices and File Systems. This chapter provides information about accessing removable media without volume management.

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. Depending on whether you are installing the OS from a CD, DVD, or from the network, do one of the following:

   • If you are running a release that uses CDs, insert the CD into the CD-ROM drive.

     If you insert the Solaris 10 Languages CD, the installation GUI starts automatically. Proceed to Step 5.

     ---

     Note –

     In this Oracle Solaris release, the software is delivered on DVD only.

     ---

   • If you are installing from a DVD, insert the DVD into the DVD-ROM drive.

   • If you are installing from the network, locate the net image of the software that you want to install.

3. Change directories to find the Oracle Solaris installation GUI installer.

   Oracle Solaris installation GUI installers are located in various directories on the CDs and on the DVD.

   • Oracle Solaris 10 Software CDs or DVD.

   • Oracle Solaris 10 Documentation DVD.

   • Oracle Solaris 10 Languages CD. The Solaris installation GUI starts automatically when the CD is inserted.

4. Follow the instructions to install the software.

   • From the command line, type the following command:

     % ./installer [options]

     -nodisplay

     Runs the installer without a GUI.

     -noconsole

     Runs without any interactive text console device. Use this option with the -nodisplay option when you include the installer command in a UNIX script for installing software.

   • From a file manager, double-click Installer or installer.

     An Installer window is displayed, followed by the installation GUI dialog box.

5. Follow the directions on the screen to install the software.

6. When you have finished adding software, click Exit.

   The installation GUI exits.

Managing Software With the Oracle Solaris Product Registry GUI (Task Map)

The following task map describes the software management tasks that you can perform with the Oracle Solaris Product Registry.

The Oracle 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 Oracle Solaris installation GUI or the pkgadd command.

You can use the Oracle Solaris Product Registry in a GUI or with a command-line interface (CLI). For more information on how to use the Oracle Solaris Product Registry CLI, see Managing Software With the Oracle Solaris Product Registry Command-Line Interface (Task Map).

The Oracle Solaris Product Registry GUI interface enables you to do the following:

• View a list of installed and registered software and some software attributes.

• View all Oracle Solaris system products that you installed in their localized version in the System Software Localizations directory.

• Find and launch an installer.

• Install additional software products.

• Uninstall software and individual software packages.

The Oracle Solaris Product Registry GUI main window consists of three panes of information:

• Installed, registered, and removed software

• Standard attributes of the currently selected software

• Attributes that are customized and attributes that are internal to the registered software

How to View Installed or Uninstalled Software Information With the Oracle Solaris Product Registry GUI

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. Start the Oracle Solaris Product Registry tool.

   # prodreg &

   The Oracle Solaris Product Registry main window is displayed.

3. Click the turner control that is located to the left of the System Registry directory in the Registered Software box.

   The turner control changes directions, from pointing 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.

   The Software Installed in Registered Software box always contains the following components:

   • The configuration software group that you chose when you installed the Oracle 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.

   • Additional system software, which contains Oracle Solaris products that are not part of the software group you chose.

   • Unclassified software that is not a Oracle Solaris product or part of the software group. This software includes any package that you installed by using the pkgadd command.

4. Select directories until you find a software application to view.

   The list expands as you open directories.

5. To view the attributes, select a directory or file.

   The Product Registry displays attribute information in the System Registry box.

   • For software products that were installed with the installation GUI, the Oracle 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.

   • If all or part of the product was removed with the pkgrm command, a cautionary icon appears next to the software product's name.

How to Install Software With the Oracle Solaris Product Registry GUI

You can use Oracle Solaris Product Registry to find software and launch the installation GUI program. This program takes you through the installation of that software.

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. Start the Oracle Solaris Product Registry tool.

   # prodreg

   The Oracle Solaris Product Registry main window is displayed.

3. Depending on whether you are installing from a CD, a DVD, or from the network, do one of the following:

   • If you running a release that uses CDs, insert the CD into the CD-ROM drive.

   • If you are installing from a DVD, insert the DVD into the DVD-ROM drive.

   • If you are installing from the network, locate the net image of the software that you want to install.

     ---

     Note –

     In this Oracle Solaris release, the software is delivered on DVD only.

     ---

4. To view the list of installed and registered software, click the turner control.

5. Click the New Install button at the bottom of the Oracle Solaris Product Registry window.

   The Select Installer dialog box is displayed. This box initially points to the /cdrom directory or the directory you are in.

6. Select directories to find the Oracle Solaris installation GUI installer.

   Oracle Solaris installation GUI installers are located in various directories on the CDs and on the DVD.

   • Solaris 10 Software CDs or DVD.

   • Solaris 10 Documentation DVD.

   • Solaris 10 Languages CD. The installation GUI automatically starts when the CD is inserted.

7. When you find the installer you want, select its name in the Files box.

8. Click OK.

   The installer you selected is launched.

9. Follow the directions that are displayed by the installer to install the software.

How to Uninstall Software With the Oracle Solaris Product Registry GUI

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. Start the Oracle Solaris Product Registry tool.

   # prodreg

   The Oracle Solaris Product Registry main window is displayed.

3. To view the list of installed and registered software, click the turner control.

4. Select directories until you find the name of the software that you want to uninstall.

5. Read the software attributes to make sure that this software is the software that you want to uninstall.

6. Click the Uninstall software-product-name button at the bottom of the Oracle Solaris Product Registry window.

   The software product you selected is uninstalled.

Managing Software With the Oracle Solaris Product Registry Command-Line Interface (Task Map)

The following task map describes the software management tasks that you cab perform with the Oracle Solaris Product Registry command-line interface.

Managing Software With the Oracle Solaris Product Registry Command-Line Interface

The prodreg command is the command-line interface (CLI) to the Oracle Solaris Product Registry. The prodreg command supports several subcommands that enable you to manage the software on your system.

You can use the prodreg command in a terminal window to perform the following tasks:

• View a list of installed and registered software and software attributes.

• View all Oracle Solaris system products that you installed in their localized version in the System Software Localizations directory.

• Identify damaged software.

• Remove software entries from the Oracle Solaris Product Registry.

• Uninstall software and individual software packages.

For more information on how to manage the Oracle Solaris Product Registry by using the command-line interface, see the prodreg(1M) man page.

How to View Installed or Uninstalled Software Information (prodreg)

You can view information about software in the Oracle Solaris Product Registry in a terminal window by using the browse subcommand to the prodreg command.

1. Open a terminal window.

2. Browse the Oracle Solaris Product Registry.

   % prodreg browse 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

   The browse subcommand to the prodreg command displays the following information about registered software.

   BROWSE #

   When you use the prodreg browse command, the Oracle Solaris Product Registry generates a browse number for each registered software component. This number can be used as an argument to either the prodreg browse command or the info subcommand to descend the hierarchy of specific registered components.

   ---

   Note –

   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.

   ---

   +/-/.

   This field indicates if a software component has additional software component children registered in the Oracle Solaris Product Registry.

   The following characters are displayed in this field:

   • + indicates that the software component has additional children components that are not currently displayed.

   • - indicates that the software component has additional children components that are currently displayed.

   • . indicates that the software component does not have children components.

   UUID

   This field lists the software's unique identifier in the Oracle Solaris Product Registry.

   #

   This field indicates the instance number of the software component on the system. If the system contains multiple instances of a software component, the Oracle Solaris Product Registry assigns a separate instance number to each instance of the component.

   NAME

   This field lists the localized name of the software. The name of the Oracle Solaris OS in this sample output is the Oracle Solaris 10 system software.

3. Browse the information for one of the software components that are listed in the Oracle Solaris Product Registry.

   % prodreg browse -m "name"

   The -m “name” command displays information on the software component with the name name.

4. If the system contains multiple instances of name software, type the following command to browse the Oracle Solaris Product Registry:

   % prodreg browse -u name-UUID -i instance -n number

   -u name-UUID

   Displays information on the name software component with the unique identifier name-UUID.

   -i instance

   Displays information on the name software component with the instance number instance.

   -n number

   Displays software information by referencing the component's browse number number.

5. Repeat Step 3 and Step 4 for each software component that you want to browse.

Example 21–1 Viewing Software Information by Component Name (prodreg)

The following example shows how to view software information by referencing the component's name.

% prodreg browse
    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

% prodreg browse -m "Solaris 10 System Software"

Example 21–2 Viewing Software Information by Component Browse Number (prodreg)

The following example shows how to use the -n option with the prodreg browse command to view software information by referencing the component's browse number.

% prodreg browse
    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

% prodreg browse -n 2

Example 21–3 Viewing Software Information by Component UUID (prodreg)

The following example shows how to use the -u option with the prodreg browse command to view software information by referencing the component's UUID. The UUID is the software's unique identifier in the Oracle Solaris Product Registry.

% prodreg browse
    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

% prodreg browse -u a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b

How to View Software Attributes (prodreg )

You can view specific software attributes by using the info subcommand of the prodreg command.

The prodreg info command displays a variety of information about registered software, including the following items:

• Software component name

• Software component description

• Required components of the software

• Other components that require the software

• Base directory of the software

• Path to the software component

1. Open a terminal window.

2. Browse the Oracle Solaris Product Registry.

   % prodreg browse 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

3. View the attributes for one of the listed software components.

   % prodreg info -m "name"

   The -m “name” command displays the attributes of the software component with the name name.

4. Repeat Step 3 for each software component you want to view.

Example 21–4 Viewing Software Attributes by Component Name (prodreg)

The following example shows how to view software attributes by referencing the component's name.

% prodreg browse
    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

% prodreg info -m "Solaris 10 System Software"

Example 21–5 Viewing Software Attributes by Component Browse Number (prodreg)

The following example shows how to use the -n option with the prodreg info command to view software attributes by referencing the component's browse number.

% prodreg browse
    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

% prodreg info -n 2

Example 21–6 Viewing Software Attributes by Component UUID (prodreg)

The following example shows how to use the -u option with the prodreg info command to view software attributes by referencing the component's UUID. The UUID is the software's unique identifier in the Oracle Solaris Product Registry.

% prodreg browse
    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

% prodreg info -u a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b

How to Check for Software Dependencies ( prodreg)

You can use the prodreg info 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.

1. Open a terminal window.

2. Browse the Oracle Solaris Product Registry.

   % prodreg browse 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

   Repeat the prodreg browse command until the software component you want to check is displayed. See How to View Installed or Uninstalled Software Information (prodreg) for more information on browsing the Oracle Solaris Product Registry by using the prodreg browse command.

3. View the dependencies of a specific software component.

   % prodreg info -m "name" -a "Dependent Components"

   -m “name”

   Displays the attributes of the software component with the name name.

   -a “Dependent Components”

   Displays components that depend on name software by displaying the values of the Dependent Components attribute.

   This command output lists the software components that depend on name software.

Example 21–7 Viewing Components That Depend on Other Software Products (prodreg )

The following example shows how to view the components that depend on the software product that is named ExampleSoft.

% prodreg -m "ExampleSoft" -a "Dependent Components"
Dependent Components:
Name                         UUID                                  #
---------------------------  ------------------------------------  -
ExampleSoftA                 7f49ecvb-1ii2-11b2-a3f1-0800119u7e8e  1

How to Identify Damaged Software Products (prodreg)

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 info subcommand of the prodreg command to help you determine if a software product is damaged.

1. View the Oracle Solaris Product Registry information on the software you want to check.

   % prodreg browse -m name

2. Verify that the software component is damaged.

   % prodreg info -u name-UUID -i 1 -d

3. Identify the packages that form the name-UUID software component.

   % prodreg info -u name-UUID -i 1 -a PKGS

   The output of this command might list more than one package.

4. Verify that the packages displayed in the previous step are installed on the system by running the pkginfo command for each package.

   % pkginfo component-a-pkg % pkginfo component-b-pkg . . .

Example 21–8 Identifying Damaged Software Components (prodreg)

The following example shows how to determine if the ExampleSoft software component is damaged.

% prodreg browse -m Examplesoft
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

The ExampleSoft child component EXSOzzt does not have an entry in the NAME field. The ExampleSoft software might be damaged. You would use the prodreg info command with the -u, -i, and -d options to determine if the ExampleSoft software is damaged.

% prodreg info -u 95842091-725a-8501-ef29-0472985982be -i 1 -d
 
isDamaged=TRUE

The output isDamaged=TRUE indicates that the ExampleSoft software is damaged. You would use the -a PKGS option of the prodreg info command to identify the ExampleSoft software packages.

% prodreg info 
     -u 95842091-725a-8501-ef29-0472985982be 
     -i 1 -a PKGS 
pkgs: 
EXSOzzt EXSOblob

To verify that the EXSOzzt and EXSOblob packages are installed on the system, you would use the pkginfo command.

% pkginfo EXSOzzt 
ERROR: information for "EXSOzzt" was not found 

% pkginfo EXSOblob
application EXSOblob       Example Data

The output of the pkginfo command indicates that the EXSOzzt package is not installed on the system. Thus, the ExampleSoft software is damaged.

How to Uninstall Software (prodreg)

You can use the uninstall subcommand of the prodreg command to remove software from your system. When you uninstall software by using the prodreg uninstall 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 How to Check for Software Dependencies ( prodreg).

After you uninstall software, you can remove that software and all the child components of that software from the Oracle Solaris Product Registry by using the prodreg unregister -r command.

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. View the information on the software you want to uninstall.

   # prodreg browse -u name-UUID

3. Uninstall the software.

   # prodreg uninstall -u name-UUID

4. Check the dependencies for the software that you want to uninstall.

   # prodreg info -u name-UUID

   Check the following information in the output of the prodreg info command.

   • Child Components – Lists the software components that are associated with the name software component. When you unregister the name software, you also unregister the child components of name software. If the output of the previous prodreg info command lists any child components, verify that you want to unregister these child components.

   • Required Components – Lists the software components that are required by the name 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.

   • Dependent Components – Lists the components that require name software to run. When you unregister the name software, you also unregister the dependent components of name software. If the output of the prodreg info command lists any dependent components, verify that you want to unregister these dependent components.

   In the previous sample output, name software does not have any dependent components.

5. Check the dependencies of name software's child components.

   # prodreg info -u component-a-UUID -i l -a "Dependent Components"

   The sample output shows that no other software depends on the child components of name software.

6. Unregister the software and its child components.

   # prodreg unregister -r -u name-UUID -i 1

   -r

   Recursively unregisters software with the unique identifier name-UUID and all the child components of this software.

   -u name-UUID

   Specifies the unique identifier of the software you want to unregister.

   -i 1

   Specifies the instance of the software you want to unregister.

Example 21–9 Uninstalling Software Components (prodreg)

The following example shows how to uninstall ExampleSoft software and all the child components of ExampleSoft software.

# prodreg browse -m "ExampleSoft"
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

# prodreg uninstall -u 95842091-725a-8501-ef29-0472985982be -i 1

# prodreg info -u 95842091-725a-8501-ef29-0472985982be
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

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

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

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

# prodreg unregister -r -u 95842091-725a-8501-ef29-0472985982be -i 1

How to Uninstall Damaged Software (prodreg )

If you try to uninstall a damaged software component by using the prodreg uninstall command, the command might fail. This failure can occur if the uninstaller program for the software component has been removed from the system.

Follow these steps to uninstall a software component with no associated uninstaller program on the system.

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. View the information on the software you want to uninstall.

   # prodreg browse -m "name"

3. Uninstall the software.

   # prodreg uninstall -u UUID -i 1

4. Identify the uninstaller program for the software component.

   # prodreg info -m "name" -a uninstallprogram

5. Determine if the uninstaller is in the registered location.

   # ls uninstaller-location uninstaller-location

6. Remove the software from the system in one of the following ways:

   • If you have a system backup available, follow these steps:

     1. Load the uninstaller program from the backup.

     2. Run the uninstaller program from a shell command-line interface such as a terminal window.

   • If you do not have access to the uninstaller program on a backup, follow these steps:

     1. Unregister the software component.

        # prodreg unregister -u UUID -i 1

     2. Remove any remaining registered components that are required by the software you want to remove.

        # pkgrm component-a-UUID

Example 21–10 Uninstalling Damaged Software (prodreg)

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.

# prodreg browse -m Examplesoft
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

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

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

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

# prodreg unregister -u 95842091-725a-8501-ef29-0472985982be -i 1

# pkgrm EXSOblob

How to Reinstall Damaged Software Components (prodreg)

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 -f option with the prodreg unregister command to forcibly the unregister the damaged component. Then, you can reinstall the component.

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. View the information on the software you want to reinstall.

   # prodreg browse -m "name"

3. Identify the software that depends on the software you want to reinstall.

   # prodreg info -m "name" -a "Dependent Components"

4. Unregister the software component you want to reinstall.

   # prodreg unregister -f -u UUID

5. Reinstall the software component.

   # /usr/bin/java -cp /usr/installers/installer

   The installer option specifies the name of the installer program for name software.

Example 21–11 Reinstalling Damaged Software Components (prodreg)

The following example shows how to reinstall the damaged software component ComponentSoft without unregistering or uninstalling the dependent component ExampleSoft.

# prodreg browse -m "ComponentSoft"
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

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

# prodreg unregister -f -u 86758449-554a-6531-fe90-4352678362fe -i 1

# /usr/bin/java -cp /usr/installers/org.example.componentsoft