Installation Directory Structure

Provides an overview of the installation directory, subdirectory hierarchy, and the naming convention used for the installed components.

Most components of Replication Server are installed in their own subdirectories, with the executable program, installation and configuration tools, and display-related files needed by the component. The naming convention for subdirectories includes a component identifier, such as REP (for Replication Server) or OCS (for Open Client™ and Open Server™), and the software release version.

Replication Server 15.7 includes a new version of Replication Server and many of its supporting components. Other Sybase products may contain earlier versions of the same components. You can install Replication Server 15.7 into the same directory containing these existing products.

However, if you are using other Sybase products, installing Replication Server 15.7 may cause some environment variables to change. Reset the environment variables to make individual products work.

Note: You can install Replication Server 15.7 in the same directory as Adaptive Server Enterprise and Open Client and Open Server versions 15.5 or later.

Sybase recommends that you do not uninstall Replication Server 15.7 if it has been installed in the same directory as older Sybase products that are installed using InstallShield installer, otherwise, these products may not work correctly.

You can install Replication Server 15.7 on top of Replication Server 12.6 and later, in the same $SYBASE directory. Doing so creates a duplicate entry in the interfaces file for SAMPLE_RS, which is the sample Replication Server. rs_init warns you about the duplicate entry and uses the first instance of SAMPLE_RS found in the interfaces file.

Constraints

Do not install Replication Server version 15.7 on top of these Sybase products:
  • Replication Server version 12.5 or earlier
  • Adaptive Server version 12.5.0.x or earlier
  • Adaptive Server version 12.x (64-bit)
  • Open Client and Open Server version 12.5.0 or earlier
  • OpenSwitch™ version 12.5 or earlier
  • DirectConnect™ version 12.5 or earlier

Doing so incapacitates older versions of these products, and may also adversely affect other Sybase products. If you perform one of these installations, you cannot reverse it with an uninstallation, as uninstalling might remove required components of the older Sybase products updated by Replication Server version 15.7. For this reason, Sybase recommends that you back up your current directory before installing Replication Server version 15.7.

If you are installing Replication Server 15.7 in an existing Sybase installation directory that contains Adaptive Server version 15.0.x, you may be asked if you want to install older locales or charset files on top of newer files. To ensure that you have the latest version of these files, select “No to all.”

Shared components are installed in subdirectories that are separate from component subdirectories. For example, the Replication Server subdirectory is $SYBASE/REP-15_5. However, Open Client is installed in $SYBASE/OCS-15_0. The exception is SQL Anywhere, which is installed in $SYBASE/REP-15_5/ASA12, because it is used only for Replication Server. As a result, the directory structure enables you to install into an existing $SYBASE directory structure, as well as to install and use multiple versions of some components.

Tip: If your earlier installation includes custom applications or scripts that refer to $SYBASE subdirectories, change them to reflect the new installation directory structure.

A diagnostic server (REP-15_5/bin/repserver.diag) is installed to capture and display information about internal processes. Do not delete this program as you may need to use it at the direction of Sybase Technical Support, to diagnose and resolve Replication Server problems.

Note: Your actual directory structure may differ from what is documented, depending on the components you install.