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:
- Log in as root. If you do not know the root password for your machine, check with your system administrator.
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.- Insert the Fathom Replication installation CD into the CD-ROM drive.
Note: You cannot install on Linux over an NFS-mounted device.- Enter your platform-specific mount command (where
device-name
is the device you are using for the installation andmount-point
is the mount-point directory).Table 4–1 lists the mount commands for each supported platform.
- Enter the following install command:
Note: You cannot run
proinst
if you are in themount-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:
![]()
- Press RETURN. The Product Configuration Data dialog box appears:
![]()
Table 4–2 describes the options available on the Product Configuration Data dialog box.
Note: This information is not case sensitive. The installation process automatically converts all letters to uppercase.- 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.
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.
- 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:
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 .- Type Y to continue with the installation.
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.
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
oremacs
editor when you choose View Release Notes.- 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 .
- 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.
Caution: Do not make your working directory a subdirectory under the destination path.- 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
).- 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.
- Choose one of the options and make the necessary changes.
- 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 .
- If you are installing Fathom Replication alone, or with additional products that do not have WebSpeed components, the Language Selection dialog box appears:
![]()
- 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.
- 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.
- 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 .- 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.- 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:
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 .- Press RETURN.
- 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:
![]()
- 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.
- Choose one of the following:
Caution: Answering Y might cause theFathom Replication install to overwrite existing scripts in this directory.- 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.Note: If you are maintaining two versions of Progress on the same machine, answer N to this question.- Type N to instruct the Installation utility to place scripts only in the destination pathname you specified earlier.
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 .
- Press RETURN. When the installation is complete, the following dialog box appears:
![]()
- Choose End the Progress Installation to exit. The UNIX system prompt appears.
- You can now unmount the CD by entering the following command:
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |