Installation

The FIX Adapter is an out-of-process adapter. It can be installed in either standalone or dependent mode.

As with all Sybase CEP out-of-process adapters, the FIX Adapter does not need to be on the same platform as the Sybase CEP Server it is communicating with.

The FIX Adapter installer uses the CEP Adapter Installer framework, a graphical installer that includes SySAM install and supports silent installation. The FIX Adapter is available for all platforms supported by Sybase CEP Server.

Version information for upgrades or reinstallations can be retrieved from the command line utilities, such as c8_server -version.

Standalone Mode

A standalone mode installation will install all of the files required by the FIX Adapter, including the CEP common libraries. This mode should be used on a system that does not already have Sybase CEP Server or Sybase CEP Studio installed.

If you are installing the adapter and specify a directory that contains a previous installation, a pop-up message indicates that the adapter is already installed. You will then have the option to either uninstall the previous installation, or to upgrade without uninstalling.

Dependent Mode

A dependent mode installation can be used if the system already has Sybase CEP Server or Studio installed. The installer will only install files that are specific to the FIX adapter. By default, the FIX Adapter will use the CEP common libraries already present from the Sybase CEP Server and Sybase CEP Studio installation.

If you are upgrading or reinstalling the adapter and specify a directory that contains a previous installation, a pop-up message indicates that the adapter is already installed. You will then have the option to either uninstall the previous installation, or to upgrade without uninstalling.

Note: Dependent mode installation should only be used if the Sybase CEP Server and Sybase CEP Studio are of the same version as the FIX Adapter. If the versions are not the same, a standalone mode installation should be performed. Note that for dependent mode installations, the Sybase CEP Server should be at the same ESD level or newer.

Post-Installation Tasks

If you performed a licensed installation, it is recommended that you copy the license file from the FIX adapter's directory to the default location for all other Sybase CEP licenses, typically:

cp /software/SybaseC8/server/enterprise-adapters/fix/ SYSAM-2_0/licenses/SYBASE.lic $SYBASE_C8/server/SYSAM-2_0/ licenses/SYBASE_FIX.lic

Note: Do not overwrite any existing licenses. Copy the license to a new name, such as "SYBASE_FIX.lic".

Prior to running the FIX Adapter, you must define the LD_LIBRARY_PATH such that the FIX libraries and the Sybase CEP common libraries can be found:

setenv LD_LIBRARY_PATH $SYBASE_C8/server/bin:$SYBASE_C8/server/enterprise-adapters/fix/bin

Known Issues

644323

FIX Adapter installation silently modifies the user's login scripts (.cshrc, .kshrc, etc.).

It silently appends it's installation directory to the LD_LIBRARY_PATH.

644330

Files are left in user's home directory after uninstalling the FIX adapter.

After each installation, the FIX adapter creates a file similar to *.cshrcxxxxxx, where "xxxxxx" is a random number.

644362

FIX Adapter's installer copies the license file to $SYBASE_C8/server/enterprise-adapters/SYSAM-2_0/licenses but all of the sample configuration files refer to $SYBASE_C8/server/SYSAM-2_0/licenses. All other licenses normally go into $SYBASE_C8/server/SYSAM-2_0/licenses. Additionally, the installer copies the license file to two different directories: /software/SybaseC8/server/enterprise-adapters/fix/SYSAM-2_0/licenses/SYBASE.lic and /software/SybaseC8/server/enterprise-adapters/SYSAM-2_0/licenses/SYBASE.lic

An administrator who is unaware of this risks their adapter going into grace mode and shutting down while in production.