Appendix B Adding and Removing Software After Installing Solaris 8

This appendix describes how to customize the Solaris software on your system after you install or upgrade to Solaris 8.

You can add and remove software in the following ways:

System Administration Guide, Volume I contains information about adding and removing software packages on client systems in a variety of computing environments.

Adding Software With Solaris Web Start

This section describes how to use Solaris Web Start to add software to a system on which you've installed the Solaris operating environment.

To Add Software With Solaris Web Start

This procedure assumes that the system is running Volume Manager. If you are not using Volume Manager to manage diskettes and CDs, refer to System Administration Guide, Volume I for detailed information about managing removable media without Volume Manager.

1. Log in to the installed or upgraded system.

2. Locate the net image of the software you want to install or insert the CD that contains the software you want to add into the CD-ROM drive attached to the system.

   If you inserted a CD, Volume Manager automatically mounts the CD.

   ---

   Note –

   If you insert the Solaris 8 Languages CD, Solaris Web Start starts automatically.

   ---

3. Find the directory that contains the software you want to add.

   Table B–1 lists some of the directories on the Solaris 8 CDs that contain the Solaris Web Start Installer and software you can add with it.

   Table B–1 Location of Software You Can Add

   CD	Software	Directory
   Solaris 8 Software 2 of 2	Components of Developer System Support, Entire Distribution, or Entire Distribution Plus OEM Support software groups  Note – The Solaris Web Start installer on the Solaris 8 Software 2 of 2 CD only installs those components in these software groups that you skipped when you initially installed the Solaris 8 operating environment on the system. You cannot upgrade to another software group after installing or upgrading the Solaris 8 operating environment.	Top-level directory (volume identifier) of the CD  Example: sol_8_sparc_2 Example: sol_8_ia_2
   Solaris 8 Software 2 of 2	Unbundled and preliminary evaluation software	Solaris_8/EA in the top-level directory (volume identifier) of the CD Example: sol_8_sparc_2/Solaris_8/EA Example: sol_8_ia_2/Solaris_8/EA
   Solaris 8 Software 2 of 2	Individual Solaris 8 packages that make up the Developer System Support, Entire Distribution, and Entire Distribution Plus OEM Support software groups, which you can install individually with pkgadd(1M)	Solaris_8/Product in the top-level directory (volume identifier) of the CD Example: sol_8_sparc_2/Solaris_8/Product Example: sol_8_ia_2/Solaris_8/Product
   Solaris 8 Software 2 of 2	Source code for some of the third-party public domain software included with Solaris 8	Solaris_8/Tools in the top-level directory (volume identifier) of the CD Example: sol_8_sparc_2/Solaris_8/Tools Example: sol_8_ia_2/Solaris_8/Tools Note – The installer in this directory is named install_source.
   Solaris 8 Languages  Note – Solaris Web Start starts automatically when you insert this CD in a CD-ROM drive.	Localized interface software and documentation, including Simplified and Traditional Chinese, French, German, Italian, Japanese, Korean, Spanish, and Swedish  Note – The Solaris 8 Software CDs contain the interface that enables you to input, display, and print text in a target language, including multibyte locales.	Top-level directory (volume identifier) of the CD  Example: sol_8_lang_sparc Example: sol_8_lang_ia
   Solaris 8 Documentation English SPARC/Intel Platform Edition	Solaris AnswerBook2 Server, Solaris 8 Collections, Release Notes, or other documentation	Top-level directory (volume identifier) of the CD  Example: sol_8_doc

4. Double click Installer or installer.

   An Installer window is displayed, followed by a Solaris Web Start dialog box.

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

6. When you're done, click Exit.

   Solaris Web Start exits.

7. Did you use a CD to install the software?

   • If no, stop, you're done.

   • If yes, are you using the Common Desktop Environment (CDE) or OpenWindows?

     • If CDE, on the File Manager window for the CD, select File and then Eject.

     • If OpenWindows, on the File Manager window for the CD, click Eject Disk.

     The CD is ejected.

Adding and Removing Software With the Product Registry

Purpose

The Solaris Product Registry is a tool to help you manage installed software. Once Solaris is installed, Product Registry provides a list of all the software that was installed using Solaris Web Start 3.0 or the Solaris package management commands (pkgadd, for example).

The Solaris Product Registry enables you to:

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

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

• Find and launch an installer.

• Install additional software products.

• Uninstall software.

• Uninstall individual system packages.

How the Product Registry Works

The Solaris Product Registry main window, shown in Figure B–1, consists of three areas of information:

• Installed, registered, and removed software

• Standard attributes of the currently selected software

• Customized attributes and attributes internal to the registered software

Figure B–1 Solaris Product Registry Window

To view the items in the Product Registry, click the turner control to the left of the folder icon next to “System registry.” Notice that the turner control changes from pointing to the right to pointing down.

You can expand or collapse any item in the Registry except items that have a text file icon to its left.

“Solaris 8” under “Software Installed in Solaris Registry,” as shown in Figure B–2, always contains two items: the configuration software group you chose when installing Solaris and “additional system software.”

Software groups that can be displayed include Core, End User System Support, Developer System Support, Entire Distribution, or Entire Distribution Plus OEM Support.

The “additional system software” item contains Solaris products that are not part of the software group you chose. Additionally, “unclassified software” contains any package that you installed using the pkgadd command that is not a Solaris product or part of the software group.

Figure B–2 Solaris Product Registry Expanded

Product Registry attributes appear above the “More Information” box. For product items installed with Solaris Web Start, the Product Registry contains values for at least Title, Version, Location, and Installed on. Items in an expanded list under a product or software group inherit the version information of the product. You can click an item to view its attribute values.

Sometimes an item appears in the Product Registry window but the corresponding software has been removed with the pkgrm command.

In this case, the message “Missing files in one or more components” is displayed after the “Installed from” attribute (see Figure B–3). You can either re-install the software by using the pkgadd command or you can remove it by using the Product Registry.

Figure B–3 Missing Files Message in the Solaris Product Registry

To List Information About All Installed Products

1. Do you want to list information about all installed software products on your system?

   • If no, stop, you're done.

   • If yes, go to the next step.

2. If the Solaris Product Registry is not already running, type:

   /usr/bin/prodreg

   ---

   Note –

   In most cases, you do not need to specify the path /usr/bin/.

   ---

   The Solaris Product Registry window, which contains the System registry, is displayed.

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

4. Do you want to view software attributes?

   • If no, go to the next step.

   • If yes, select the software you want by clicking its name under “Software installed in Solaris Registry.”

   The Product Registry displays attribute information for the selected software.

To Check the Integrity of an Installed Product

1. Do you want to check the integrity of software products installed on the system?

   • If no, stop, you're done.

   • If yes, go to the next step.

2. If the Solaris Product Registry is not already running, type:

   /usr/bin/prodreg

   ---

   Note –

   In most cases, you do not need to specify the path /usr/bin/.

   ---

   The Solaris Product Registry window, which contains the System registry, is displayed.

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

4. Select the software you want by clicking its name in the window titled “Software installed in Solaris Registry.”

   If all or part of the product was removed with the pkgrm command, the message “Missing files in one or more components” is displayed after the “Installed from” attribute.

To Install Software With the Product Registry

1. Do you want to add an additional software product or products to the Solaris 8 software you already installed?

   • If no, stop, you're done.

   • If yes, go to the next step.

2. Log in to the installed or upgraded system.

3. Locate the net image of the software you want to install or insert the CD that contains the software you want to add to the system into the CD-ROM drive attached to the system.

   If you inserted a CD, Volume Manager automatically mounts the CD.

4. If the Solaris Product Registry is not already running, type:

   /usr/bin/prodreg

   ---

   Note –

   In most cases, you do not need to specify the path /usr/bin/.

   ---

   The Solaris Product Registry window, which contains the System registry, is displayed.

5. To view the list of installed and registered software, click the turner control to the left of the System registry.

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

   The Product Registry displays the Select Installer dialog box, which initially points to the /cdrom directory.

   ---

   Note –

   You can install software from local media or over a network.

   ---

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

   ---

   Note –

   The Solaris Web Start installer is named Installer or installer.

   ---

8. Click OK.

   The installer you selected is launched.

9. Follow the directions displayed by the installer you selected to install the software.

To Uninstall Products

1. Do you want to uninstall a software product or products installed on the system?

   • If no, stop, you're done.

   • If yes, go to the next step.

2. If the Solaris Product Registry is not already running, type:

   /usr/bin/prodreg

   ---

   Note –

   In most cases, you do not need to specify the path /usr/bin/.

   ---

   The Solaris Product Registry window, which contains the System registry, is displayed.

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

4. Select the software you want to uninstall by clicking its name in the window titled “Software installed in Solaris Registry.”

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

6. Click the Uninstall software_product_name button at the bottom of the Solaris Product Registry window.

   The software product you selected is uninstalled.

Adding and Removing Packages With Admintool

This section describes how to add and remove software packages through the Admintool graphical user interface.

To Add Packages With Admintool

Unless you are a member of the UNIX® system administrator group (group 14), you must become superuser on your system to add or remove software packages with Admintool.

1. Log in to the installed or upgraded system and become superuser:

   # su

2. Insert the CD that contains the software you want to add to the system into the CD-ROM drive attached to the system.

   Volume Manager automatically mounts the CD.

3. Note the directory path to the software on the CD you want to add.

4. Start Admintool:

   # admintool &

   The Users window is displayed:

   

5. From the Browse menu, choose Software.

   The Software window is displayed:

   

6. From the Edit menu, choose Add.

7. Did the Set Source Media window appear?

   

   • If no, go to the next step.

   • If yes, and if it isn't already displayed in the CD Path box, specify the directory path to the CD you noted in Step 3 and click OK.

   The Add Software window is displayed:

   

8. In the Software portion of the window, select the software you want to install on the local system:

   

9. Click Add.

   The Add Software terminal window appears, in which a message is displayed as each component of the software is added:

   

   When all the components that make up the software you selected are added, the following message is displayed:

   Installation of <name_of_software> was successful. press <Return> to continue

10. Press Return.

    The Add Software terminal window is dismissed, and the Software window is displayed so you can continue to add software.

11. When you're done adding software, from the File menu, choose Exit.

To Remove Packages With Admintool

Unless you are a member of the UNIX system administrator group (group 14), you must become superuser on your system to add or remove software packages with Admintool.

1. Log in to the installed or updated system and become superuser:

   # su

2. Start Admintool:

   # admintool &

   The Users window is displayed:

   

3. From the Browse menu, choose Software.

   The Software window is displayed:

   

4. Select the software you want to delete by highlighting it.

5. From the Edit menu, choose Delete.

   The Warning dialog box is displayed, and you are prompted to confirm that you want to delete the software:

   

6. On the Warning dialog box, click Delete.

   The Delete Software terminal window is displayed with messages that are generated as the software is being deleted:

   

   You are prompted to confirm that you want to delete each software package you selected.

7. At each prompt, type y, n, or q.

   A message is displayed as each component of the software is deleted. When all the components that make up the software you selected are deleted, the following message is displayed:

   Removal of <name_of_software> was successful. press <Return> to continue

8. Press Return.

   The Delete Software terminal window is dismissed, and the Software window is displayed so you can select more software to delete.

9. When you're done deleting software, from the File menu, choose Exit.

Adding and Removing Packages With pkgadd and pkgrm

To Add Packages With pkgadd

1. Log in to the installed or updated system and become superuser:

   # su

2. Insert the CD that contains the software you want to add to the system into the CD-ROM drive attached to the system.

   Volume Manager automatically mounts the CD.

3. Note the directory path to the software on the CD you want to add.

4. Add one or more packages to the system:

   # /usr/sbin/pkgadd -d device_name pkgid

   where:

   device_name	Is the directory path to the CD that contains the software you want to add to the installed system.
   pkgid	Is the name of the software package to be added to the installed system. For example, SUNWaudio.

5. When you're done, use the pkgchk(1M) command to verify that the package is installed correctly:

   # /usr/sbin/pkgchk -v pkgid

   If no errors are found, pkgchk returns a list of installed files. If an error is found, pkgchk returns a message that describes the problem.

SPARC: Example: Installing Software From a Mounted CD

The following example shows how to use pkgadd to install the SUNWaudio package from a mounted Solaris 8 Software 1 of 2 CD.

The name of this product is Solaris 8 but code and path or package path names might use Solaris_2.8 or SunOS_5.8. Always follow the code or path as it is written.

# /usr/sbin/pkgadd -d /cdrom/sol_8_sparc/Solaris_8/Product SUNWaudio
.
Installation of <SUNWaudio> was successful. 
# pkgchk -v SUNWaudio
/usr
/usr/bin
/usr/bin/audioconvert
/usr/bin/audioplay
/usr/bin/audiorecord
#

x86: Example: Installing Software From a Mounted CD

The following example shows how to use pkgadd to install the SUNWaudio package from a mounted Solaris 8 Software 1 of 2 CD.

The name of this product is Solaris 8 but code and path or package path names might use Solaris_2.8 or SunOS_5.8. Always follow the code or path as it is written.

# /usr/sbin/pkgadd -d /cdrom/sol_8_ia/Solaris_8/Product SUNWaudio
.
.
Installation of <SUNWaudio> was successful. 
# pkgchk -v SUNWaudio
/usr
/usr/bin
/usr/bin/audioconvert
/usr/bin/audioplay
/usr/bin/audiorecord
#

To Remove Packages With pkgrm

1. Log in to the installed or updated system and become superuser:

   # su

2. Remove one or more packages from the system:

   # /usr/sbin/pkgrm pkgid

   Where pkgid is the name of the software package you want to remove from the installed system. For example, SUNWaudio.

3. At each prompt, type y, n, or q to specify that you want to remove the package, not remove the package, or quit.

4. When you're done, use the pkgchk(1M) command to verify that the package was removed correctly:

   # /usr/sbin/pkgchk -v pkgid

   If the package was not removed correctly, pkgchk returns a warning message.

SPARC: Example: Removing Software From a System

The following example shows how to use pkgrm to remove the SUNWaudio package from a system.

# /usr/sbin/pkgrm SUNWaudio
The following package is currently installed:
   SUNWaudio       Audio applications
                   (SPARC) 3.6.20,REV=1.2000.11.7
Do you want to remove this package? y
.
.
.
Removal of <SUNWaudio> was successful.
# pkgchk -v SUNWaudio
WARNING: no pathnames were associated with <SUNWaudio>
#

x86: Example: Removing Software From a System

The following example shows how to use pkgrm to remove the SUNWaudio package from a system.

# /usr/sbin/pkgrm SUNWaudio
The following package is currently installed:
   SUNWaudio       Audio applications
                   (i386) 3.6.20,REV=1.2000.11.7

Do you want to remove this package? y
.
.
.
Removal of <SUNWaudio> was successful.
# pkgchk -v SUNWaudio
WARNING: no pathnames were associated with <SUNWaudio>
#