Install the ESP
Server and SAP Sybase Event Stream Processor
Studio with Sybase Control Center for SAP Sybase Event Stream Processor, PowerDesigner Extensions, and any combination of external and enterprise adapters on
various machines within your network.
Prerequisites
Ensure that you have administator privileges. Before running
the installer, create a distinct user for
ESP. Then, run
the command prompt as administrator.
If you are installing on Windows 7 and using a
sub-capacity license, set the SYBASE_SAM_CAPACITY
environment variable in . Click New for System Variables and enter
SYBASE_SAM_CAPACITY as
the variable name and PARTITION as the environment value.
To install the SAP Sybase
ESP Plugin for SAP HANA
Studio, you must have installed SAP HANA Studio, version
1.0.60, build id 201306271550 379371, or later.
Task
The following instructions provide a basic work flow based on selecting most of the
available options, including the ESP Server. Therefore,
some of the steps outlined here may not be applicable to your custom installation.
- From the command line, navigate to the directory where the installation file (setupConsole.exe) resides.
- Type setupConsole.exe -i console and press Enter.
- When prompted, press Enter to continue.
- Select the installation location. To accept the default location, press Enter. To specify a custom location:
- Enter an absolute path to the location. Select a file path that does not contain any spaces.
- Press Enter.
- Type Y or N to indicate whether the location is correct.
Note: The console accepts both Y and Yes as affirmative, and everything else as a negative response.
- If the directory you specified does not exist, the installer asks if you want to create it. Press Y. If the directory already exists, the installer warns you that any software in the folder will be replaced.
In either case, press Enter to continue.
- Enter 3 to select the Custom install set. Press Enter.
- Enter the numbers corresponding to the features you want to select
or deselect for installation, separated by a comma with no space. If you select the SAP Sybase Event Stream Processor Studio for installation, also select the
Server.
The installer selects specific components by default. Selected
components are indicated by an X, deselected components are indicated by a blank.
Enter the number of a component to toggle the current selection. When finished, press
Enter.
Note: If the target installation machine hosts other SAP products, you may have already
installed the SySAM License Utilities. You need not install them again.
- If, in step 6, you selected
external adapters only (no enterprise adapters, ESP Studio, or
ESP Server), the installer summarizes your
installation preferences and prompts you to install. Click Enter to continue, then Enter again to complete the installation. Otherwise, continue to step
8.
- If you have a previous version installed to the selected location,
a message indicates that you can uninstall the previous version, or overwrite it.
Enter your selection and press Enter.
- Indicate whether you want to install a licensed version or an
evaluation version and press Enter.
Note: If you install the evaluation version, the software
will be active for a 30-day grace period, after which you are prompted for a valid
license key. During this grace period, there is no restriction on the number of cores
ESP can use. Proceed to step
13.
- If you are installing a licensed version, select one of these options:
License Type |
Process |
Specify License Keys |
- Type 1 and press Enter.
- Enter the license key.
- Press Enter.
- Once your license key is validated successfully, press Enter to continue installation.
If you are using a served license and receive an error that the installer detects a SySAM server already
running on your machine, click Previous to return to the SySAM License Entry panel
and select the Previously Deployed License Server option.
If you enter an invalid key, you are prompted by a warning message. You cannot proceed until you provide a valid key or select a different licensing option.
|
Previously Deployed License Server |
- Type 2 and press Enter.
- Press Enter to accept the default host name, or enter the Host Name and
Port Number.
If the license server file is not found, you receive a warning message indicating
that the installer cannot verify a license server running on the selected
host. When prompted, enter Y to
reenter the license server or N to select a different
licensing option.
|
Continue Without a License Key |
Type 3 and press Enter. At the prompt asking if you want to continue, press
Enter.
If you continue without a license, the software
will be active for a 30-day grace period, after which you are prompted for a valid
license key. During this grace period, there is no restriction on the number of cores
ESP can use.
|
- Indicate the product license type you want to configure and press Enter.
- Indicate whether you want to configure SySAM e-mail alerts. To configure alerts:
- Enter the SMTP server host that handles your e-mail.
- Enter the SMTP server port.
- Enter the e-mail address of the person or group from which e-mail messages are sent.
- Enter the e-mail addresses of the default recipients.
- Enter the default severity level (informational, warning, or error) for e-mail messages.
Note: To change the SySAM alert settings after installation, edit the lines in the
ESP_HOME/sysam/esp_license.prop file:
- email.smtp.host=smtp
- email.smtp.port=25
- email.sender=sender@domain.com
- email.recipients=user@domain.com
- email.severity=INFORMATIONAL
Setting email.severity to NONE disables e-mail alerts, causing all other lines to be ignored. To enable e-mail alerts, set email.severity with ERROR, WARNING, or INFORMATIONAL. Replace SMTP with your SMTP host name, 25 with the port number of your SMTP mail server, sender@domain.com with your e-mail address, and user@domain.com with e-mail recipients. Separate multiple e-mail recipients with a comma (,).
- Enter the number corresponding to your geographic location and
press Enter.
- Read through the license agreement. Press Enter as necessary to move through the text. Stop reading the text at any point by typing back and pressing Enter.
- Indicate that you agree to the license terms and press Enter.
Note: If you are installing enterprise adapters only, repeat steps
9 through
15 for each enterprise adapter you are
installing. Then proceed to step
20.
- Configure cluster information:
- Create a name for the new node. If the node will be part of
an existing multi-node cluster, all nodes names in the cluster must be
unique.
- By default, the installer sets the actual host name of the
machine hosting this cluster node. If it cannot determine the actual host name,
it sets "localhost" as the default value. Use the default "localhost" name only
if this is a single node cluster that will only be accessed from within the
machine you are installing on.
- Enter the RPC port for the cluster node. The Studio, SDKs, and various other product
tools, use this port to access the cluster.
- (Optional) If you want to specify a separate Admin port, change the port
number from the default. Doing so allows you to distinguish between
administrative and non-administrative users, and limit network access to
specific administrative actions, which may be advantageous when you have
firewalls in place.
- Indicate whether the RPC port supports connections through
Secure Sockets Layer (SSL) or not. When you enable SSL, connections to the
cluster use HTTPS rather than HTTP. If you are creating a new cluster, you can
decide whether you want to use SSL or not. If you are connecting to an existing
cluster, ensure this selection matches the configuration of the existing
cluster.
Note: If you disable SSL
during installation, the installer disables SSL at the cluster level, but
not at the project level. As a result, only certain
ESP client utilities, such as
esp_cluster_admin and ESP Studio, are able
to connect to the server until you disable SSL at the project level. To do
this, comment out all of the lines containing references to either
"ssl-key-file" or
"ssl-key-file-encrypted" in the
node1.xmlcluster configuration file. Then, restart
the cluster. Note that this issue does not apply to Studio's
localnode.xml file.
- Enter the cache port for the node. The cluster cache is an
internal cache for sharing cluster state and configuration information. It is
for internal use only.
- Create a name for your new cluster, or enter the name of an
existing cluster.
- Indicate whether you want to provide a password for
accessing the cluster now. All nodes within the cluster use the same password.
If you select No, you are prompted to
provide a password when you start the cluster node.
If you select Yes, enter a password for the cluster and press Enter. Your password must be at least six
characters long. If you are connecting to an existing cluster, use the password
defined for that cluster.
- Enter the number corresponding to the security type to apply
to your cluster. If you are connecting to an existing cluster, select the
security type the existing cluster uses, and provide credentials for that
cluster:
Authentication Type |
Description |
Native OS |
Provides authentication based on your operating system. Choose this
authentication type if you wish to use the same credentials that you use to log
in to your machine. |
SAP BI |
Provides SAP BI authentication. Choose this authentication type if you wish
your SAP BI instance to handle authentication. |
LDAP |
Provides LDAP authentication. Enter the following information as indicated
by your LDAP implementation:- Server type
- Provider URL
- Default search base
- Authentication scope
|
Kerberos |
Provides Kerberos authentication. Enter the following information as
indicated by your Kerberos implementation:- Realm
- KDC
- Service Principal Name
- Keytab Location
Note: If you do not set these values during installation, you can set them
post-installation. See Configuration and Administration Guide >
Get Started with a Cluster > Configuring Security > Authentication
> Configuring Kerberos Authentication.
|
RSA |
Provides RSA authentication. |
Note: After installation, you can modify your Event Stream Processor
environment to add nodes and clusters, change authentication types, and so on. For
information, see the Configuration and Administration
Guide.
- Indicate the location of the keystore file or press Enter to accept the default.
These keys encrypt/decrypt data within
Event Stream Processor, such as passwords required to read or
write to databases. By default, the keystore type is set to JKS and the algorithm is
RSA.
- Indicate whether you want to provide a password to access the keystore file
and key. If you select No, you are prompted
for one at startup. If you select Yes, enter
a password for the keystore. The password must be at least six characters long. If
you are connecting to an existing cluster, use the keystore password already defined
for that cluster.
- If you are installing the Web Services adapter, select Yes
or No to indicate whether you want to enable the
ESP Web Services Provider. If you select
Yes, configure the ESP Web
Services Provider:
- Specify a value for the SOAP Port of the SOAP server to which the provider
connects, or press Enter to accept the default
value.
- Specify values for the HTTP Port and HTTPS Port, or press
Enter to accept the default values and to
continue.
If you select No, the default values are accepted and
the ESP Web Services Provider server does not
start.
- Enter an absolute path to the workspace location for SAP Sybase Event Stream Processor Studio projects, or press Enter to accept the default location.
- If you are installing the SAP Sybase Event Stream Processor Plug-in for
SAP HANA Studio, specify the parent folder of the
SAP HANA Studio directory
(hdbstudio). For example, if your installation path is
C:\Program Files\SAP\hdbstudio, specify C:\Program Files\SAP. Click Next.
- If you are installing PowerDesigner Extensions, enter an absolute
path to the location of your PowerDesigner installation or press Enter to accept the suggested location.
- If you are installing enterprise adapters, repeat steps 9 through 15 for each adapter. Otherwise, continue to
step 24.
- At the pre-installation summary, confirm that you have enough disk
space for the installation. Press Enter to
continue.
- Press Enter to install the files.
- If you are installing Sybase Control Center for
Event Stream Processor:
- If you did not install the ESP Server during
this installation, specify the number for the authentication type
ESP is using and press
Enter. If you did install the server with this
installation, you have already provided this information and the console does
not prompt you to provide it again.
- Specify a value for the HTTP Port for
Sybase Control Center that does not conflict with ports used
by other applications and services on the system, or press Enter to accept the default values.
- Specify a value for the HTTPS Port for
Sybase Control Center that does not conflict with ports used
by other applications and services on the system, or press Enter to accept the default values.
- Specify a value for the RMI Port for the RMI Service that is not used by
other applications and services on the system, or press
Enter to accept the default value.
- Enter and confirm a password for the
SCC administrator. Minimum length is six
characters.
This password is encrypted and written to the
SCC
csi.properties file.
- Enter and confirm a password for the
SCC agent administrator.
- Select Yes or
No to indicate whether you want to
set up Sybase Control Center as a Windows service.
- Select Yes or No to indicate whether you want to start the
Sybase Control Center service.
- When prompted, press Enter to finish
the installation process.