Installing Fathom for the first time

Be sure to have the serial and control numbers for Fathom and the SNMP Adapter (if applicable) handy before you begin the installation. These numbers are included in your Fathom media kit.

To install Fathom on a UNIX system:

  1. Stop the AdminServer.
  2. Log in as root in a terminal window. If you do not know the root password for your system, consult with your system administrator.
  3. Insert the Fathom installation CD into the CD-ROM drive.
  4. Enter your platform-specific mount command.
  5. Table 3–1 lists the mount commands for each supported platform (where device-name is the device you are using for the installation and mount-point is the mount-point directory).

    Note: On several platforms, there is an automount daemon that mounts the CD within approximately five seconds. If, however, the automount does not occur on your machine, use the mount command provided in Table 3–1.

    Table 3–1: Mount commands 
    Operating system
    Mount command
    HP Tru64 UNIX
    mount -t cdfs -o noversion device-name mount-point
    For example:
    mount -t cdfs -o noversion /dev/rz3c /cdrom
    HP-UX 11, 11i
    mount -F cdfs -r -o cdcase device-name mount-point
    For example:
    mount -F cdfs -r -o cdcase /dev/dsk/c0t2d0 /cdrom
    IBM AIX 5L
    mount -v cdrfs -r device-name mount-point
    For example:
    mount -v cdrfs -r /dev/cd0 /cdrom
    Linux
    mount -t iso9660 device-name mount-point
    For example:
    mount -t iso9660 /dev/cdrom /cdrom
    SUN Solaris 64-bit
    mount -F hsfs -o ro,nrr -r device-name mount-point
    For example:
    mount -F hsfs -o ro,nrr -r /dev/dsk/c0t4d0s0 /cdrom
    Sun Solaris SPARC
    mount -F hsfs -o ro,nrr -r device-name mount-point
    For example:
    mount -F hsfs -o ro,nrr -r /dev/dsk/c0t4d0s0 /cdrom

  6. Enter the following install command:
  7. mount-point/proinst 
    

    Note: You cannot run proinst if you are in the mount-point directory.

    After you enter the install command, the Welcome screen appears:

  8. Press ENTER. The OpenEdge Path screen appears:
  9. Enter the full path to a supported OpenEdge product. If you enter the wrong path or specify an unsupported OpenEdge product, a warning like this appears:
  10. Type Y to enter a different path, or type N to terminate the installation.

    In some cases, you might see a warning that indicates that you have a valid OpenEdge product, but the product does not have database or client support.

    The Fathom installation will end after you press ENTER.

    An OpenEdge database is required for Fathom to install and run successfully. Without client support, you will not be able to run reports. See the "Product support" section for information about OpenEdge and Progress products and their support for Fathom.

    Note: Remember that each instance of Fathom is associated with one particular OpenEdge product upon installation. If you later install a different instance of OpenEdge, you can use the reglue command to change the Fathom-to-OpenEdge product association. Such a need might occur, for example, if you have Progress Version 9.1D associated with an instance of Fathom, and then you install OpenEdge. You can use the reglue command to reassociate the Fathom instance to the OpenEdge product without having to uninstall and then reinstall Fathom. See the "Uninstalling Fathom on UNIX" section for more information.

  11. Enter a company name (which can be any character string), the serial number, and the control numbers for Fathom in the Product Configuration Data screen:
  12. Then press ENTER.

  13. Enter the serial number and the control numbers for Fathom Management. Then press ENTER.
  14. If applicable, enter the serial number and the control numbers for the SNMP Adapter. Then press ENTER.
  15. When you are done with this screen, press CTRL-E. The Done Configuration Data Confirmation screen appears:
  16. Type Y to continue to the Type, Device and Destination screen. The Type, Device and Destination screen appears:
  17. The defaults for the type of install, the destination directory for the Fathom install, and the working directory for Fathom are listed at the bottom of the screen.

  18. Type D if you want to change either the destination or work directory paths. The Select Destination Pathname screen appears:
  19. Enter the full pathnames in the fields that require a change. The Destination Path is where Fathom will be installed. The Work Directory is the area where Fathom puts working files.
  20. Note: If you are installing multiple instances of Fathom (to monitor separate OpenEdge products, for example), make sure that each instance of Fathom has a unique Destination Path and Work Directory Path.

  21. Press ENTER. The Type, Device, and Destination screen reappears.
  22. On the bottom of the screen you can review the type of installation, the destination pathname, and the working directory.

  23. Select Continue with Installation. The Complete Installation screen appears:
  24. Press Y to install Fathom Management. (Press N to terminate the installation and return to the command line of the terminal window.)
  25. After you have completed this step, the actual installation begins. An indicator showing the progress of the installation appears. Then a message appears to inform you that the installation program is tailoring the installed files.

    When tailoring is complete, an informational message appears. The message tells you how you can start Fathom and begin the configuration process:

  26. Press ENTER. The following screen appears:
  27. Restart the AdminServer using the proadsv utility with the following syntax:
  28. proadsv -start 
    

    For more information on proadsv, see OpenEdge Data Management: Database Administration.

    Note: Be sure that you are not root when you restart the AdminServer. If you start the AdminServer as root, root has exclusive ownership and access to the files that you create when running Fathom. You will be unable to access those files when logged in as a user without root permissions.


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