Progress Fathom Replication
Installation Guide

> ## Installing Fathom Replication

> You are now ready to install Fathom Replication.

> To install Fathom Replication on each machine where it will run:

> 1. Log in as root. If you do not know the root password for your machine, check with your system administrator.

> 2. Insert the Fathom Replication installation CD into the CD-ROM drive.

> Note: There is an automount daemon on the Solaris platform that mounts the CD within approximately five seconds. If, however, the automount does not occur on your Solaris machine, use the mount command provided in Table 4–1.

> 3. Enter your platform-specific mount command (where `device-name` is the device you are using for the installation and `mount-point` is the mount-point directory).

> Note: You cannot install on Linux over an NFS-mounted device.

> Table 4–1 lists the mount commands for each supported platform.

> Table 4–1: Mount commands
> Operating System | Mount Command
> --- | ---
> HP-UX | `mount -F cdfs -r -o cdcase` `device-name mount-point` For example: `mount -F cdfs -r -o cdcase /dev/dsk/c0t2d0 /cdrom`
> IBM AIX | `mount -v cdrfs -r` `device-name mount-point` For example: `mount -v cdrfs -r /dev/cd0 /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`
> Compaq Tru64 | `mount -t cdfs -o noversion` `device-name mount-point` For example: `mount -t cdfs -o noversion /dev/rz3c /cdrom`
> Linux | `mount -t iso9660 -o lower` `device-name mount-point` For example: `mount -t iso9660 -o lower /dev/cdrom /mnt/cdrom`

> 4. Enter the following install command:

>     mount-point/proinst

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

> - If you have one of the platforms for which Progress Software Corporation does not ship a JVM, the Installation utility searches for a JVM on your system. If the Installation utility does not detect a JVM, the following warning message appears:

> The installation will continue, but you will be able to install only products that do not require a JVM.

> - The Installation utility also checks whether you have the JVM version that is supported by Progress on your system. If the Installation utility does not detect the supported JVM, a warning message appears.

> You can choose to continue with the installation whether or not you have the supported JVM version on your system. However, Progress Software Corporation recommends you install the supported JVM version in order to ensure full functionality.

> If you are performing a batch installation, you can add an entry to the `.ini` file to allow batch installs to override this warning. See Progress Installation and Configuration Guide Version 9 for UNIX for more information.

> - If you have either the supported JVM version on your system or a platform for which Progress Software Corporation ships a JVM, the Welcome dialog box appears:

> 5. Press RETURN. The Product Configuration Data dialog box appears:

> Table 4–2 describes the options available on the Product Configuration Data dialog box.

> Table 4–2: Product Configuration Data dialog box options
> Option | Function
> --- | ---
> ENTER = Additional | Confirms that the product information entered is correct and clears the input fields for additional information for another Progress product you want to install.
> CTRL-E = Done | Confirms that the product information entered is correct and continues to the next step in the installation. The actual key you use to indicate Done varies by terminal type. Refer to the Product Configuration Data dialog box for the appropriate key combination for your terminal.
> CTRL-T = Quit | Quits the Installation Utility. The Quit Confirmation dialog box appears. Type Y to quit or N to continue the installation. Note: When you quit the installation process, the installation utility and all the installation files you copied into your working directory are deleted.
> CTRL-N = Release Notes | Displays the online Release Notes .
> CTRL-V = View | Displays the products for which you entered control numbers.
> TAB = Next Field | Moves to the next field in the dialog box.

> 6. Type your company name (any character string is acceptable), the serial number, and control numbers from your License Addendum for the first product you want to install. Use the TAB key to move to the next field.

> Note: This information is not case sensitive. The installation process automatically converts all letters to uppercase.

> If you enter incorrect product configuration information, the following error message appears indicating that the data is invalid:

> Press RETURN to correct the product information and continue with the installation. The Product Configuration Data dialog box reappears, allowing you to enter the serial number and control numbers for the next product to install.

> 7. When you finish entering the serial number and control numbers for all the products you want to install, press CTRL-E. The Done Configuration Data Confirmation dialog box appears:

> 8. Type Y to continue with the installation.

> Note: If you are installing a database product, Progress® WebSpeed™ components, or the SonicMQ® Adapter in addition to Fathom Replication, you will see appropriate configuration dialogs at this point. For more information about installation of other products and components, see Progress Installation and Configuration Guide Version 9 for UNIX .

> For those UNIX platforms on which the JRE/JDK is not automatically included during the installation, the JavaHome Pathname dialog box appears:

> JavaHome is the Java installation directory. The Java installation directory must be in your search path when you install and subsequently run Progress.

> Note: On these platforms, the installation process searches for the correct version of the JDK residing on the target system before continuing the installation.

> Enter a different version/location than the one specified, and press ENTER to continue. The Type, Device and Destination dialog box appears:

> Table 4–3 describes the menu options on the Type, Device and Destination dialog box that you will be working with once you choose the type of installation you want to perform.

> To select an option, highlight the option using the SPACEBAR key, the TAB key, the CURSOR keys, or the accelerator keys that are highlighted in each selection. Press ENTER to execute the selected option.

> Table 4–3: Type, Device and Destination dialog box options
> Option | Function
> --- | ---
> Select type of Installation | Allows you to select the type of installation you want to perform.
> Select Destination Pathname | Allows you to change the default destination pathname (`/usr/dlc`) and work directory (`/usr/wrk`) pathname.
> Continue with Installation | Confirms your selections (or accepts the defaults listed in the status box) and continues with the installation.
> View Release Notes | Views the latest release notes using the `vi` or `emacs` editor. When you choose this option, the Installation Utility launches the editor. To exit `vi` after reading the Release Notes , type :q!. To exit `emacs`, press CTRL-X and then CTRL-C.
> Cancel | Cancels the previous selection.
> Quit Installation | Quits the Installation Utility. The Quit Confirmation dialog box appears. Type Y to quit or N to continue the installation. Note: When you quit the installation process, the installation utility and all the installation files you copied into your working directory are deleted.

> You should read the online Progress Fathom Replication Release Notes before continuing with the installation. The Progress Fathom Replication Release Notes might replace or supplement the installation instructions in this guide. The Progress Fathom Replication Release Notes appears in the `vi` or `emacs` editor when you choose View Release Notes.

> 9. Choose Select Type of Installation if you are doing a custom installation of products other than Fathom Replication.

> Fathom Replication does not contain any selectable components, so you must do a complete installation. For more about complete or custom installations, see Progress Installation and Configuration Guide Version 9 for UNIX .

> 10. Choose Select Destination Pathname and press RETURN. The following dialog box appears:

> Note: The actual key you use to accept the default varies by terminal type. The Select Destination Pathname dialog box shows the appropriate key combination for your terminal.

> 11. Type your Fathom Replication destination path or accept the default directory (`/usr/dlc`). Then type the work directory path or accept the default provided (`/usr/wrk`).

> Caution: Do not make your working directory a subdirectory under the destination path.

> 12. Press RETURN. If the directory already exists, the following dialog box appears:

> Table 4–4 lists the options in the Destination Pathname Exists dialog box.

> Table 4–4: Destination Pathname Exists dialog box options
> Option | Action
> --- | ---
> Select an alternate destination path | Allows you to select another destination path. This returns you to the Select Destination Pathname dialog box.
> Erase the current destination path | Deletes the contents and subdirectories of the named directory and reinstalls in the same directory.
> Install the Progress products in the pre-existing destination path | Installs Progress products in the named directory. If the name of a file being installed matches the name of an existing file, the installation utility overwrites the existing file. The installation utility does not, however, overwrite the `progress.cfg` file.

> 13. Choose one of the options and make the necessary changes.

> 14. From the Type, Device and Destination dialog box, choose Continue with Installation. Then press RETURN.

> If you are installing any products with WebSpeed components, the installation program will ask for information about your Web server at this point. For more information, see Progress Installation and Configuration Guide Version 9 for UNIX .

> 15. If you are installing Fathom Replication alone, or with additional products that do not have WebSpeed components, the Language Selection dialog box appears:

> 16. Select the language you want to use for error and informational messages. To select a language, use your arrow keys to highlight the language and press RETURN. An asterisk (*) appears next to the selected language.

> 17. Press M to choose a language as the default language. The symbol (d) appears to the right side of the default language. If you do not select a default language, a warning message appears.

> 18. When you finish selecting the languages, choose Continue with Installation. The International Settings dialog box appears:

> The International Settings dialog box allows you to tailor the default Progress Startup Parameter (`startup.pf`) file to select international conventions for your locale, such as Character Set, Collation, Case, Date Format, and Number Format preferences. For more information on international conventions, see Progress Internationalization Guide .

> 19. From each drop-down list, select the international Character Set, Collation, and Case; Date Format; and Number Format to tailor the default Progress `startup.pf` file.

> 20. Choose Continue with Installation. If you have not completed a required International Setting, a warning appears. For example, the following warning appears if you have not chosen the Date Format:

> 21. Press RETURN.

> Note: If you are installing any products that contain Web services, the installation program will ask for information about your Web Services Adapter at this point. For more information, see Progress Installation and Configuration Guide Version 9 for UNIX .

> 22. Choose Continue with Installation, and press RETURN.

> Once you provide all required settings, the installation performs a check of available disk space. Provided your destination path choice has enough disk space, the Complete Installation dialog box appears, displaying a summary of the installation options you selected:

> 23. Type Y to continue. The Copy Scripts dialog box appears:

> Fathom Replication consists of several scripts and program modules. When you install the product, the scripts are placed in the installation directory you specify.

> 24. Choose one of the following:

> - To allow all users on your system to run the product, you could answer Yes when prompted to copy the scripts to `/usr/bin`. Type Y to instruct the Installation utility to place Fathom Replication scripts in `/usr/bin` and the destination pathname you specified earlier.
> Caution: Answering Y might cause theFathom Replication install to overwrite existing scripts in this directory.

> - Type N to instruct the Installation utility to place scripts only in the destination pathname you specified earlier.
> Note: If you are maintaining two versions of Progress on the same machine, answer N to this question.

> The Progress installation displays status messages while it is decompressing and tailoring files. You will also see a WebSpeed configuration message if you are installing any products with WebSpeed components. For more information, see Progress Installation and Configuration Guide Version 9 for UNIX .

> 25. Press RETURN. When the installation is complete, the following dialog box appears:

> 26. Choose End the Progress Installation to exit. The UNIX system prompt appears.

> 27. You can now unmount the CD by entering the following command:

>     umount device-name mount-point

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