Silent Sybase CEP Server Installation on Unix

This section describes the procedure for creating and running a script that installs Sybase CEP Server on UNIX-like operating systems without the conventional prompts used by the standard installation.

Sybase recommends this installation method for installing multiple identical or almost identical copies of Sybase CEP Server. It does not recommend silent installation for installations that require extensive customizing. Once you modify the installation script, you may run it as many times as necessary to install multiple copies of Sybase CEP Server.

For more installation information, see "Standard Sybase CEP Server Installation".

The Sybase CEP Server installer on UNIX-like operating systems reads and updates a file called config.vars, located in the SybaseC8/server/conf subdirectory of the parent directory under which Sybase CEP Server is installed. This file consists of a series of Bash shell settings that describe the configurable Sybase CEP Server preferences. The settings contained in the config.vars file always reflect the settings of the most recent previous install (if the Sybase CEP Server has already been installed using the same installation files on the same computer) or the default installer settings.

When performing a standard installation, the installer displays the current settings and prompts you to approve or change them. The installation process can be set to execute silently, however, by adding a SILENT=yes variable to the beginning of the config.vars file.

Sybase provides a sample silent configuration file called config.vars.silent with your Sybase CEP Server installation script. This file can be modified, renamed, and repackaged in the installation .tar.gz file to make the install process silent.

Creating a Silent Install Script

To create a silent install script:

Get the appropriate Sybase CEP Server installation file, either from the Sybase Web site, or from the location where it is saved if the file has been previously downloaded. The installer file is an executable (.exe) file beginning with:

c8-studio- x.x.x - operating system...

where x.x.x is a three-part version number, separated by dots, which indicates the version of Sybase CEP Engine, and operating_system is the name of the Windows operating system on which Sybase CEP Engine is being installed.
Obtain a copy of the config.vars.silent file. To do this, either copy the file from the SybaseC8/server/conf directory of a previously installed Sybase CEP Server copy, or use these steps to extract the file from the Sybase CEP Server installation file:
1. Type this command to expand the .tar.gz file:
```
tar zxf 
server-installation-fil
e.tar.gz
```
2. Copy the config.vars.silent file to the desired location:
```
cp SybaseC8/server/conf/config.vars.silent 
new-file-location-and-name
```
Modify the config.vars.silent file to your requirements. The example config.vars.silent file looks like this:
```
# Sybase CEP Server Configuration
	SILENT=yes
	CONFIG_HOST=`hostname`
	CONFIG_PORT=6789                       #CONFIG_SERVER_CONFIG=c8-server.rc     #CONFIG_SERVER_SCRIPT=c8-server.rc        #CONFIG_SERVER_LOG=c8-server.log   
	#CONFIG_SERVER_PID=c8-server.pid
	#CONFIG_ENABLE_MANAGER=true
	CONFIG_ENABLE_CONTAINER=true
	CONFIG_MANAGER_URI=http://$CONFIG_HOST:$CONFIG_PORT
	CONFIG_ENABLE_SSL=false
	CONFIG_DESKTOP_SHORTCUT=no
	CONFIG_COPY_EXAMPLES=yes
	CONFIG_START_SERVER=yes
	CONFIG_ADAPTERS_BASE=$CONFIG_INSTALL_FOLDER/SybaseC8Repository
	CONFIG_STORAGE_BASE=$CONFIG_INSTALL_FOLDER/storage
```
Here is an explanation of these settings:
- SILENT=yes: Is a required line at the beginning of the file. It specifies that the installation should be performed silently.
- CONFIG_HOST='hostname': Specifies the host name. Replace hostname either with the local host name or the fully qualified host name of the machine where Sybase CEP Server is installed. Make sure to use the full host name if Sybase CEP Server needs to accept connections from other machines.
  
  You can use the back quote characters (`) to execute the command with a subshell or use this alternative setting for the host: CONFIG_HOST=$( hostname. See "Server Identification Warning" for more information about properly setting the host name.
- CONFIG_PORT=6789: Shows the number of the port used by Sybase CEP Server. The default port is 6789. Change this number, as needed. If you are installing multiple copies of Sybase CEP Server on a single computer, indicate a unique port number for each copy.
- CONFIG_SERVER_SCRIPT=c8-server.rc: Specifies the configuration file for Sybase CEP Server. Do not change this file name.
- CONFIG_SERVER_LOG=c8-server.log: Specifies the log file for Sybase CEP Server. Do not change this file name.
- CONFIG_SERVER_PID=c8-server.pid: Specifies the file that contains the Server Process Identifier. This file only exists when Sybase CEP Server is running. Do not change this file name.
- CONFIG_ENABLE_MANAGER=true and CONFIG_ENABLE_CONTAINER=true: Enable or disable Manager and/or Container processes for Sybase CEP Server. To enable the Manager and/or Container, leave the appropriate settings at true. To disable the Manager or Container, change the appropriate setting to false.
  
  Containers processes run queries and C/C++ input and output adapters. Managers monitor Container processes and manage their workload. On stand-alone Sybase CEP Server installations, enable both the Manager and the Container process. If the installation is part of a Sybase CEP Servercluster, you may enable it as a Container only, Manager only, or both. Every Sybase CEP Server cluster should include one or more Manager process (an active, or primary manager, and, optionally, one or more backup Managers) and one or more Container processes. For instructions on how to create a Sybase CEP Server cluster, see High Availability.
- CONFIG_MANAGER_URI=http://$CONFIG_HOST:$CONFIG_PORT: Specifies the URI for the primary Manager in a Sybase CEP Server cluster. If you are installing a stand-alone installation of Sybase CEP Server, or are installing this copy of Sybase CEP Server as a Manager, the default setting for the Manager URI does not need to be changed. If you are installing the current Sybase CEP Server copy as a Container that is part of a Sybase CEP Server cluster, however, set the Manager URI to the full host name. For more information about the Manager URI in Sybase CEP Server clusters see High Availability .
- CONFIG_ENABLE_SSL=false: Enables or disables the Secure Socket Layer (SSL) features. To leave SSL disabled, leave this setting at false. To enable SSL, change this setting to true. For more information about configuring SSL, see Configuring SSL Support.
- CONFIG_DESKTOP_SHORTCUT=no: Indicates whether or not to create a shortcut for Sybase CEP Server on your desktop during installation. Leave this setting at no, if you don't want to create a shortcut. Otherwise change it to yes.
- CONFIG_COPY_EXAMPLES=yes: Indicates whether or not to install a fresh copy of Sybase CEP application examples during installation. To install examples, leave this setting at yes. Otherwise, change the setting to no. Examples are valuable when learning to use Sybase CEP Engine, but are not useful on production installations.
- CONFIG_START_SERVER=yes: Indicates whether or not to start Sybase CEP Server immediately after installation. To start Sybase CEP Server as soon as it is installed, leave this setting at yes. Otherwise, change the setting to no.
- CONFIG_ADAPTERS_BASE=$CONFIG_INSTALL_FOLDER/SybaseC8Repository: Specifies the Sybase CEP Server directory used to store various Sybase CEP Serverdata files. By default, this is called SybaseC8Repository. If you want to change the path and/or name of this directory, change this setting as needed.
  
  If you are installing a Sybase CEP Server cluster, set all Containers in the cluster to the same adapters base folder. See High Availability for more information.
- CONFIG_STORAGE_BASE=$CONFIG_INSTALL_FOLDER/storage: Specifies the storage directory for Sybase CEP Server state files. By default, this is called storage. If you want to change the path and/or name of this directory, change this setting as needed.
  
  If you are installing a Sybase CEP Server cluster, set the storage folder for all the Containers and Managers in the cluster to the same directory to avoid data loss. See High Availability for more information.
Note: Since the entries in this file are executed as Bash script, any valid Bash script entry may be used in specifying the settings. However, be sure to check the settings of any environment variables you use in the script on any machines where you plan to install Sybase CEP Server to avoid unexpected results during installation. This is particularly true for production installations.
Save the edited file under the name config.vars (omitting the final .silent ending of the original name).
Make the new silent install config.vars file a part of the installation by following these steps:
1. If you have not already expanded the .tar.gz installation file (or have repacked it since expanding) issue this command:
```
tar zxf 
server-installation-file
.tar.gz
```
2. Include the new config.vars file in the distribution:
```
cp 
full-file-path
/config.vars SybaseC8/server/conf
```
3. Repackage the distribution. To avoid confusing the standard installation file with the installation that performs a silent install, repackage the file under a different name:
```
tar zcf 
new-server-installation-fil
e.tar.gz
```

Silent Sybase CEP Server Installation on Unix

Creating a Silent Install Script

Using a Silent Install Script