Understanding the installation directory structure

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, such as 15_5.

Replication Server 15.5 includes a new version of Replication Server and many of its supporting components. Other Sybase products may contain earlier versions of the same components. Installing Replication Server 15.5 into the same directory containing these existing products, will not impact the products.

However, if you are using other Sybase products, installing Replication Server 15.5 may cause some environment variables to change. You will have to reset the environment variables in order to make the individual products work.

NoteReplication Server 15.5 can be installed in the same directory as Adaptive Server Enterprise and Open Client and Open Server versions 12.5.1 or later.

However, if you have installed Replication Server 15.5 and other Sybase products versions earlier than 15.5 in the same directory, Sybase recommends that you do not uninstall any of these products from this common directory. Otherwise, these products can no longer be used after uninstallation.

You can install Replication Server 15.5 on top of Replication Server 12.6 and later, in the same $SYBASE directory. Installing 15.5 on top of Replication Server 12.6 and later versions will create a duplicate entry in the interfaces file for SAMPLE_RS, which is the sample Replication Server. rs_init will warn you about the duplicate entry and will use the first instance of SAMPLE_RS found in the interfaces file.

Constraints

Do not install Replication Server version 15.5 on top of these Sybase products:

Doing so incapacitates older versions of these products, and can 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.5. For this reason, Sybase recommends that you back up your current directory before installing Replication Server version 15.5.

NoteIf you are installing Replication Server 15.5 in an existing Sybase installation directory that contains Adaptive Server version 15.0.x, you may be asked if you wish 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 (SA), which is installed in $SYBASE/REP-15_5/ASA11, 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.

NoteIf your earlier installation includes custom applications or scripts that refer to $SYBASE, 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.

NoteThe directory structure listed in this section is a partial directory structure. Your actual directory structure may differ, depending on the components you choose to install.