Editing Sybase CEP Engine Configuration Files

Many sections of this guide refer to configuration files which are used to set various Sybase CEP Engine preferences. This section includes descriptions of where to find configuration files based on the operating system you use, and how to set preferences within the configuration files.

In the case of Sybase CEP Server configuration, the two commonly-used configuration files are called c8-server.conf and c8-services.xml. These files are located in the conf subdirectory of the Server directory, in your c8 installation directory.

For example, if you install Sybase CEP Engine on a UNIX-like operating system, in the /usr/ user-name /sybasec8 directory, then the configuration files reside in the /usr/ user-name /sybasec8/server/conf directory.

If you install Sybase CEP Engine on Microsoft Windows, in the C:\Program Files\SybaseC8 directory, then the configuration files reside in the C:\Program Files\SybaseC8\Server\conf directory.

Sybase CEP Server reads the relevant configuration files only at the time it starts. If something in a configuration file is changed, the Sybase CEP Servershould be stopped and restarted for the change to take effect.

Sybase CEP Engine configuration files use XML format to store lists of preferences and the values to which these preferences are set, as shown in the following example. This example sets the "Hostname" preference to the value of myhostlike this:

<preference name="Hostname">myhost</preference>
  1. Preferences in configuration files are often grouped together in sections and subsections.

    Each section controls related Sybase CEP Engine settings. When this guide mentions one of these preferences, it often also mentions the section in which the preference is located. For example, a configuration instruction in this guide may tell you to set the 'ConfigurationPath' property, in the 'ManagerCluster' subsection.

  2. When preferences are contained in a section that is nested inside other sections, this guide lists the "path" to the preference, like this: set the 'ConfigurationPath' preference in the 'SybaseC8/Server/Manager/HighAvailability/ManagerCluster' section'.

    This means that the "ConfigurationPath" preference is located in the "ManagerCluster" section which is located in the "HighAvailability" section, and so on.

  3. When you change the values of preferences, do not change the preference name or any other information inside the angle brackets (<>) except the value.
  4. Some configuration file preferences appear enclosed in comment markings, which makes them inactive.

    Here is an example with the comment markings shown in bold face:

    <!-- <preference name="MinActiveContainersNative" value="0"/> -->
    

    If you are setting a value for a preference that is contained inside comments, be sure to remove the comment markings to activate the preference. The previous example would now look like this:

    <preference name="MinActiveContainersNative" value="1"/>