Solstice Enterprise Manager 4.1 Installation Guide

Chapter 7

Removing Solstice Enterprise Manager Software

This chapter describes how to remove Solstice Enterprise Manager (Solstice EM) software from a local machine or server.

This chapter describes the following topics:

• Section 7.1 Why Remove the Software?
• Section 7.3 Example Uninstall Session
• Section 7.2 Removing Solstice EM Software With the Uninstall Program
• Section 7.4 Removing Solstice EM Software With the pkgrm Command
• Section 7.5 Removing the License Software

7.1 Why Remove the Software?

You might want to remove Solstice EM software to free disk space on a particular system.

---

Note – In order to remove Solstice EM software, you must be logged in as root. All procedures in this chapter, unless otherwise noted, require that you access the system as root.

---

If you are installing Solstice EM software on a system on which a version prior to 2.0 is already installed, you must remove the existing packages before installing the new version of Solstice EM.

In addition to removing the software, you should remove configuration files that may reside in your home directory, such as $HOME/.em_viewer.cf. These configuration files only exist if you made changes to a tool's default settings. If these configuration files are not removed, then the tools will use the settings in these old configuration files rather than the new configuration files in the
/install directory/SUNWconn/em/config directory.

When you remove Solstice EM software, you might want to keep some Solstice EM files and directories - for example, configuration files that you have edited or files you might use with another application. The Uninstall program asks if you want to remove these files and directories.

The base directory is the directory where you installed Solstice EM (/opt is the default). The runtime directory is /var/install directory/SUNWconn/em for example, if you installed Solstice EM in /opt (base directory) and /var/opt/SUNWconn/em is the runtime directory, the Uninstall program removes the files and directories listed in the following table.

TABLE 7-1   Files and Directories Removed by the Uninstall Program  

If You Choose to Remove...	The Uninstall Program Removes...
The SUNWsnmag package, you can choose to remove the SunNet Manager log files	Files in /var/opt/SUNWconn/snm and the SUNWsnmag package
Java Runtime Environment	/install directory/jre1.1.5 directory
Solstice EM Runtime and Base Directories	/var/opt/SUNWconn/em/conf /var/opt/SUNWconn/em/data /var/opt/SUNWconn/em/usr /var/opt/SUNWconn/em/debug /var/opt/SUNWconn/em /etc/opt/SUNWconn/em/conf/cmipautoreg /etc/opt/SUNWconn/em/conf/compilers /etc/opt/SUNWconn/em/conf /etc/opt/SUNWconn/em /etc/opt/SUNWconn /opt/SUNWconn/em/install/em_platform/init_dbobj /opt/SUNWconn/em/config/em_panel.old /opt/SUNWconn/snm/struct/elements.schema.* /opt/SUNWconn/snm/struct/netware_elements.schema.* /opt/SUNWemrdb/online.log /opt/SUNWemrdb/etc/ixbar.1 /opt/SUNWemrdb/etc/oncfg_rancid_emdb.? /opt/SUNWemrdb/etc/onconfig.em /etc/init.d/init.snmpd
All components	In addition to the above files, the Uninstall program removes itself.

7.2 Removing Solstice EM Software With the Uninstall Program

You can use the Uninstall program to remove most of the Solstice EM software. You must use the pkgrm utility to remove the following:

• STE License Installation Tool (SUNWlit package)
• FlexLM License System (SUNWlicsw package)

See Section 7.4 Removing Solstice EM Software With the pkgrm Command."

To Remove Solstice EM Software With the Uninstall Program

1. Log in as root or become superuser.

For example, type the following command.

% su Password:*********

2. Type the following command to start the Uninstall program.

/install directory/SUNWconn/em_uninstall

The Uninstall program lists all Solstice EM components. The components that are installed on your system are marked with an X.

3. To remove a component, type its number and press Return.

To remove all components, type all and press Return. The Uninstall program again lists Solstice EM components. The component(s) you removed are no longer marked with an X. You can continue removing components.

If you type all, the Uninstall program removes all installed Solstice EM components except the license software, and then removes itself. Instructions for removing the license software can be found in Section7.5 Removing the License Software." You receive a message for each package that is successfully removed.

4. If you chose to remove the SUNWsnmag package, you are asked if you also want to remove the SNM log files in /var/opt/SUNWconn/snm.

Type y to remove the SunNet Manager log files and remove the SUNWsnmag package. Type n to keep the SunNet Manager log files and remove the SUNWsnmag package.

5. If you have installed licenses for Solstice EM components, the Uninstall program asks if you want to save the licenses. If you type y, the Uninstall program copies the licenses to /etc/opt/licenses. Type n to remove the licenses.

The Uninstall program then asks if you want to remove the runtime and base directories.

6. If you want to remove these directories, type y. If you do not, type n to keep them.

The base directory is the directory where you installed Solstice EM (/opt is the default). The runtime directory is /var/install directory/SUNWconn/em

See TABLE 7-1 for a list of the files and directories that are removed.

7. When you finish removing components, type quit and press Return.

The Uninstall program displays the message Uninstallation complete.

7.3 Example Uninstall Session

The following is a sample session using the em_uninstall command to remove Solstice EM software.

CODE EXAMPLE 7-1   Using the em_uninstall Command to Remove Entire Solstice EM Software 

# ./em_uninstall Solstice Enterprise Manager 4.1 Uninstallation Program -------------------------------------------------------------------- Below is a list of Solstice Enterprise Manager components. An 'X' in the box means that the component is currently installed on this . system 1. [X] Management Services 2. [X] IP Protocol Adapters (SNMP/RPC) 3. [X] CMIP Protocol Adapter and Utilities 4. [X] Java Management Services 5. [X] JDMK Protocol Adapter 6. [X] Client Applications 7. [X] Development tools 8. [X] CORBA Runtime Supplement 9. [X] CORBA Developer Supplement 10. [ ] Documentation 11. [ ] Geographical Map Images 12. [X] Cooperative Consoles To remove a component, type it's number followed by the Enter key. To remove all components, type "all" followed by the Enter key. Type "quit" followed by the Enter key to exit this uninstall program. Selection: all [Return] THIS WILL COMPLETELY REMOVE ENTERPRISE MANAGER FROM THIS SYSTEM! Are you sure you want to do this? [n] y [Return] Removing component: 1 Removing package: SUNWsnmct Removal of <SUNWsnmct> was successful. Removing package: SUNWembc Terminating the Solstice Enterprise Manager processes. Removal of <SUNWembc> was successful. Removing package: SUNWemobj Removal of <SUNWemobj> was successful. Removing package: SUNWemlog Terminating any running em_log2rdb processes. Removal of <SUNWemlog> was successful. Removing package: SUNWemmis Terminating any running MIS processes. Removal of <SUNWemmis> was successful. Removing package: SUNWsnmag Do you want to remove the SNM log files in /var/opt/SUNWconn/snm (y/n) [y]: [Return] Modifying /etc/rpc Modifying /etc/inet/services Modifying /etc/inet/inetd.conf Removal of <SUNWsnmag> was successful. Removing package: SUNWemrdb Terminating any running database processes... Removal of <SUNWemrdb> was successful. Removing package: SUNWemalb Removal of <SUNWemalb> was successful. Removing package: SUNWemrwd Removal of <SUNWemrwd> was successful. Removing package: SUNWemrwt Removal of <SUNWemrwt> was successful. Removing package: SUNWgdmod Removal of <SUNWgdmod> was successful. Removing component: 2 Removing package: SUNWemipa Terminating any running IP Management Protocol Adapter processes. Removal of <SUNWemipa> was successful. Removing package: SUNWemdmn Terminating any running Solstice Enterprise Manager Daemon processes. Removal of <SUNWemdmn> was successful. Removing package: SUNWemalb Removing package: SUNWemrwd Removing package: SUNWemrwt Removing component: 3 Removing package: SUNWomgte Removal of <SUNWomgte> was successful. Removing package: SUNWomgtb Removal of <SUNWomgtbx> was successful. Removing package: SUNWomgtbx License files exist for this product. Do you want them saved [y/n]? y Licesnes copied to /etc/opt/licenses Removal of <SUNWomgtb> was successful. Removing package: SUNWomgta Cleaning MBX directory Removal of <SUNWomgta> was successful. Removing package: SUNWemcpa Terminating any running Solstice Enterprise Manager CMIP MPA processes. Removal of <SUNWemcpa> was successful. Removing package: SUNWrk6 Removing otk6 driver ... Removal of <SUNWrk6> was successful. Removing package: SUNWrk6x Removing package: SUNWemalb Removing package: SUNWemrwd Removing package: SUNWemrwt Removing component: 4 Removing package: SUNWemjme Terminating any running JMA daemons ... Removal of <SUNWemjme> was successful. Removing component: 5 Removing package: SUNWemjmk Removal of <SUNWemjmk> was successful. Removing package: SUNW2jddc Removal of <SUNW2jddc> was successful. Removing package: SUNW2jdex Removal of <SUNW2jdex> was successful. Removing package: SUNW2jdtk Removal of <SUNW2jdtk> was successful. Removing package: SUNW2jdrt Removal of <SUNW2jdrt> was successful. Removing component: 6 Removing package: SUNWemapp Terminating any running Solstice Enterprise Manager Core Application processes. Removal of <SUNWemapp> was successful. Removing package: SUNWemalb Removing package: SUNWemrwd Removing package: SUNWemrwt Removing component: 7 Removing package: SUNWemdev Removal of <SUNWemdev> was successful. Removing component: 8 Removing package: SUNWemcgs Removal of <SUNWemcgs> was successful. Removing component: 9 Removing package: SUNWemcgd Removal of <SUNWemcgd> was successful. Removing component: 12 Removing package: SUNWccrcv Terminating running Cooperative Consoles Receiver Application. Removal of <SUNWccrcv> was successful. Removing package: SUNWcccfg Removal of <SUNWcccfg> was successful. Do you want to remove Enterprise Manager's runtime and base directories? [y] [Return] Uninstallation complete.

7.4 Removing Solstice EM Software With the pkgrm Command

This section provides instructions for removing the Solstice EM software from your machine using the pkgrm command.

7.4.1 Finding Installed Packages

To remove the Solstice EM software from your machine using pkgrm, you must know which packages are installed. To determine which Solstice EM packages are installed on your machine, type:

pkginfo | grep Manager

---

Note – You do not need to be root to use the pkginfo command.

---

The preceding command locates the existence of all Solstice EM packages, as well as the SunNet Manager packages SUNWsnmag and SUNWsnmpd, which are included with the Solstice EM product.

The Cooperative Consoles packages SUNWcccrv and SUNWcccfg are also included with the Solstice EM product. To see if these packages are installed, type:

pkginfo | grep Cooperative

7.4.2 Removing the Packages

To remove Cooperative Consoles packages using the pkgrm command, type the pkgrm command followed by the packages you want to remove. For example:

# pkgrm SUNWccrcv SUNWcccfg

---

Note – The packages should be removed in the reverse order in which they were installed, due to package dependencies.

---

The packages are removed one-by-one. Before each package is removed, you are asked to confirm the removal of the package. During the removal of the packages, you might be asked if you want to continue because of one of the following reasons:

• The package contains scripts that will be executed with superuser permission.
• Another package depends on the one you are trying to remove.

For any of these questions, type y at the prompt to continue with package removal, n to skip this package and remove the next package, or q to quit and not remove any more packages.

The removal of the SUNWsnmag package produces one extra question:

Do you want to remove the SNM log files in /var/opt/SUNWconn/snm (y/n) [y]

Press Return or type y to this question if you want to remove the SunNet Manager log files, or type n if you do not. Regardless of your answer to this question, the removal of the SUNWsnmag package continues. Only the SNM log files are affected by your answer to this question.

A given machine might have a subset of all the product packages. You must specify only those packages that are installed. If you specify uninstalled packages, the pkgrm command fails.

7.5 Removing the License Software

By default, the Uninstall program does not remove the Solstice EM license software because it can be shared by multiple products. To remove the STE License Installation Tool (SUNWlit package) and the FlexLM License System (SUNWlicsw package), type the following command:

pkgrm SUNWlicsw SUNWlit

---

Note – The pkgrm command does not remove all of the licensing data on the machine. In addition to removing the two licensing packages, you also need to remove the data in /etc/opt/licenses. As root, type the following command:
rm -r /etc/opt/licenses

---

Before each package is removed, you are asked to confirm the removal of the package. During the removal of the packages, you might be asked if you want to continue because of one of the following reasons:

• The package contains scripts that will be executed with superuser permission.
• Another package depends on the one you are trying to remove.

For any of these questions, type y at the prompt to continue with package removal, type n to skip this package and remove the next package, or type q to quit and not remove any more packages.