Performing a Typical Installation Using the Installer

Install the Event Stream Processor base adapters, the Server, and the Studio in a single process on a single machine.

Prerequisites

If you are installing on Windows 7 and using a sub-capacity license, set the SYBASE_SAM_CAPACITY environment variable in Control Panel > System > Advanced > Environment Variable. Click New for System Variables and enter SYBASE_SAM_CAPACITY as the variable name and PARTITION as the environment value.

Task
  1. Click the installer file, setup.exe. On the Introduction screen, click Next.
  2. Select an installation folder. Change the default folder by typing the filepath to the desired folder or by clicking Choose and selecting a folder. When finished, click Next.
    If the selected folder does not exist, click Yes when prompted to create the folder. If the folder already exists, you see a warning that any software in the folder will be replaced. Click Next to proceed with the installation in the existing folder.
  3. Choose the Typical install set, which installs the Event Stream Processor Server, base adapters, and the Event Stream Processor Studio. Click Next.
  4. Select to either install a licensed copy or an evaluation version.
    Note: If you install the evaluation version, the software is active for 30 days, after which you are prompted for a valid license key. Proceed to step 8.
  5. If you selected to install a licensed version, select one of these options:
    Specify License Keys, Use Previously Deployed License Server, or Continue Installation Without a License Key.
    License Type Process
    Specify License Keys
    • Enter the license key manually or browse for and load a license key.
    • Click Next.

    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 license key, you receive a warning message but can continue with the installation. The software is active for a 30-day grace period, after which you are prompted to enter a valid key.
    Previously Deployed License Server Enter the host name and port number or IP address.

    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. Reenter the host name and port number. If the installer cannot verify the license server, select a different licensing option to continue with the installation.
    Continue Without a License Key

    The software will be active for a 30-day grace period, after which you are prompted for a valid license key.
  6. From the drop-down list, select the type of product license you want to configure and click Next.
  7. Select Yes or No to indicate whether to configure e-mail alerts about SySAM events that may require an administrator's attention.
    If you select Yes, enter the SMTP server host name, SMTP server port number, sender e-mail address, recipient e-mail address, and message severity, or accept the defaults. Click Next.
    Note: To change the SySAM alert settings after installation, edit these 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 (,).

  8. Use the drop-down list to select your geographic location and view the corresponding End-User License Agreement. Accept the terms and conditions to continue. Click Next.
  9. Configure cluster information. The installation creates a single-node cluster:
    1. Provide a name for the cluster.
    2. Provide a name for the single node in the cluster.
    3. Enter the cache port the cluster will use. The cluster cache is an internal cache for sharing cluster state and configuration information.
    4. Enter the host name of the machine hosting the node, or localhost if the node will run on the local (that is, installation) machine.
    5. Enter the RPC port for the node you are configuring.
    6. 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.
    7. Click Next.
    Note: After installation, you can modify your cluster configuration to add additional nodes and clusters. For information, see the Administrators Guide.
  10. Select Yes or No to indicate whether you want to configure a password for the cluster. If you select No, you are prompted for the cluster password at startup.
  11. Configure security for the cluster, then click Next:
    Authentication Type Description
    None Provides open security, which allows any name and password combination to log in. No additional configuration is required.
    LDAP Provides LDAP authentication. Enter the following information as determined by your LDAP implementation:
    • Server type
    • Provider URL
    • Default search base
    • Authentication scope
    Kerberos Provides Kerberos authentication. Enter the following information as determined by your Kerberos implementation:
    • Realm
    • KDC
    RSA Provides RSA authentication.
  12. Set the keystore properties for the cluster. A keystore is a third-party application that generates encryption keys. These keys encrypt/decrypt data within Event Stream Processor, such as passwords required to read or write to databases:
    1. Indicate the location of the keystore file. Event Stream Processor accesses the keystore for encryption/decryption.
    2. Select Yes or No to indicate whether you want to enter a password to access the keystore file and key. If you select No, you are prompted for the password at startup.
    3. (Optional) Enter and confirm the password for the keystore.
    4. Click Next.
  13. Select a workspace folder where Studio will store projects. Change the default folder by typing the filepath to the desired folder or by clicking Choose and selecting a folder. When finished, click Next.
  14. Review installation information before continuing. Click Previous to go back and make changes. Click Install to proceed with the installation.
  15. A message indicates that the installation was successful. Click Next.
  16. Indicate whether to start Studio immediately. Click Done to finish the installation.
Tip: If Studio does not start, try manually deleting the .metadata folder in the workspace directory.
Parent topic: Performing a Typical Installation