Uninstalling Fathom on UNIX

Because Fathom is associated with (or "glued to") an installed OpenEdge product, uninstalling Fathom is a two-step process. First, you disassociate ("unglue") Fathom from OpenEdge, then you remove the Fathom files.

If you want only to change the association between Fathom and a particular OpenEdge product, it is not necessary for you to uninstall Fathom. Instead, you can unglue Fathom from one OpenEdge installation and reglue it to another installation of the same product. For example, you might have Fathom installed with Progress Version 9.1D. If you then install OpenEdge 10.0B, you can simply unglue Fathom from Version 9.1D and reglue to Open Edge 10.0B. See the "Using the Reglue command to change the Fathom association" section for details.

When you run unglue, the FathomTrendDatabase entry is removed from the conmgr.properties file.

Caution: If you want to save trending data, be sure to back up the <fathom-install-dir>/db before removing the Fathom installation.

Note that reports and logs are stored in the Fathom Work directory and will not be removed when you uninstall Fathom.

To uninstall Fathom (unglue and remove the Fathom files):

  1. Stop any databases associated with Fathom.
  2. Log in as root in a terminal window.
  3. If you do not know the root password for your system, consult with your system administrator.

  4. Run the Fathom Management unglue command in a terminal window.
  5. The syntax for the command is:

    /<fathom-install-dir>/bin/unglue 
    

    where fathom-install-dir is the complete pathname of the directory where you installed Fathom. The following prompt appears:

  6. Press Y and then press ENTER to complete the unglue.
  7. Remove the directory where you installed Fathom.
  8. For example:

    rm -r fathom 
    

  9. If you have configured remote monitoring, remove the vpd.properties file:
  10. rm $HOME/vpd.properties 
    

    Caution: If you want to uninstall Fathom and not associate it with a different OpenEdge installation, be sure to uninstall Fathom before you uninstall the OpenEdge product that it is associated with.

    Always run unglue before removing the Fathom directory. If you remove the Fathom directory before running unglue, the associated OpenEdge product will be partially disabled. You will not be able to run it correctly.

    However, you can recover from a failure to run unglue as follows:

    1. Delete the following files:
    2. $DLC/.fathom
      $DLC/bin/fathom_env
      $DLC/bin/fathomcp_env 
      $DLC/properties/AdminServerPlugins.properties/PluginsPolicy.Fathom 
      $DLC/properties/AdminServerPlugins.properties/Plugin.Fathom 
      

      in which $DLC represents the complete pathname of the OpenEdge installation directory.

    3. Open the $DLC/addons file, and remove the fathom_v3.0A line.
    4. Save the addons file.

Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095