Performing a Custom Installation in Console Mode

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.

1. From the command line, navigate to the directory where the installation file (setupConsole.exe) resides.
2. Type setupConsole.exe -i console and press Enter.
3. When prompted, press Enter to continue.
4. Select the installation location. To accept the default location, press Enter. To specify a custom location:
   1. Enter an absolute path to the location. Select a file path that does not contain any spaces.
   2. Press Enter.
   3. 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.
   4. 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.
5. Enter 3 to select the Custom install set. Press Enter.
6. 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.
7. If, in step 6, you selected external adapters only (no enterprise adapters, Studio, or 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.
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.
9. 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.
10. 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.

11. Indicate the product license type you want to configure and press Enter.
12. Indicate whether you want to configure SySAM e-mail alerts. To configure alerts:
    1. Enter the SMTP server host that handles your e-mail.
    2. Enter the SMTP server port.
    3. Enter the e-mail address of the person or group from which e-mail messages are sent.
    4. Enter the e-mail addresses of the default recipients.
    5. 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 (,).

13. Enter the number corresponding to your geographic location and press Enter.
14. 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.
15. 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.
16. Configure cluster information:
    1. 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.
    2. 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.
    3. Enter the RPC port for the cluster node. The Studio, SDKs, and various other product tools, use this port to access the cluster.
    4. 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.
    5. 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.
    6. Create a name for your new cluster, or enter the name of an existing cluster.
    7. 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.
    8. 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.
17. 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.
18. 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.
19. 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:
    1. Specify a value for the SOAP Port of the SOAP server to which the provider connects, or press Enter to accept the default value.
    2. 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.
20. Enter an absolute path to the workspace location for SAP Sybase Event Stream Processor Studio projects, or press Enter to accept the default location.
21. 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.
22. If you are installing enterprise adapters, repeat steps 9 through 15 for each adapter. Otherwise, continue to step 22.
23. At the pre-installation summary, confirm that you have enough disk space for the installation. Press Enter to continue.
24. Press Enter to install the files.
25. If you are installing Sybase Control Center for Event Stream Processor:
    1. 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.
    2. 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.
    3. 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.
    4. 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.
    5. 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.
    6. Enter and confirm a password for the SCC agent administrator.
    7. Select Yes or No to indicate whether you want to set up Sybase Control Center as a Windows service.
    8. Select Yes or No to indicate whether you want to start the Sybase Control Center service.
26. When prompted, press Enter to finish the installation process.