This installation procedure describes the steps of Eventstore installation in the Graphical Interface. One server can support only one instance of Eventstore installation.

Prerequisites

  • Ensure that you have a login with root privileges to run the installer.
  • Download the installation file from support page and place it in a temporary location on the server.

Procedure

  1. Log in to the server as root.
    Logged in with root privileges.
  2. Type bash eventstore-install.bin –i gui to run the installer in the graphical installer mode, and press Enter.
    Installer introduction appears.
  3. Click Next.
    Installer introduction continues.
  4. Installer prompts to choose an install folder, click Next to continue with the Default folder.

    Default is /opt/eventstore.

  5. If the install folder already contains eventstore folder you can choose appropriate options from any of the following:
    • Click Yes to override the already installed folder.

      or

    • Click No to choose a new installation directory.

      or

    • Click Cancel to cancel the installation.
  6. Click Next to continue when installer prompts to enter the eventstore port .
    This is the port in which eventstore service starts. Port number must be between 1 to 65535. If wrong port number is entered, installer will throw a validation error and redirect to re-enter the Port details. Default port is 8080.
  7. The Installer prompts you to choose any of the below protocol for communication.
    • Click “https” radio button for https communication and click Next to continue.

      or

    • Click “http” radio button for http communication and click Next to continue.
      Note: 1. For “https” communication ensure that “esdb.crt” file is available in “/opt/ssl”. (For configuring https in elastic search refer, Enabling HTTPS in Elastic Search).
      Note: 2. The certificate file esdb.crt should contain certificates from all elastic search instances in a cluster.
  8. Installer prompts for Elastic Search Configurations:
    1. Enter the Elastic search IP or FQDN or Hostname in the format <IP-ADDRESS/FQDN/HOSTNAME>:<PORT>. In case of cluster enter the comma separated IP or FQDN or Hostname address.
    2. Type the Elastic Search Username and click Next to continue.
  9. Enter the Elastic Search Password when installer prompted and click Next to continue.
    Password confirmation prompt appears.
  10. Enter Elastic Search Password again when prompts for confirmation and click Next to continue.
    Installer throws a validation error and redirects to the beginning of step 9 if the password mismatches. Verify if any fields are blank to avoid the installer validation error and redirects to step 8.

    Also verify if the first IP/fqdn/hostname address of Elastic Search entered, is reachable from Installation server. Otherwise, installer will throw a connectivity error, and redirects to the beginning of step 8.

  11. Enter Redis IP address when installer prompts for Redis configurations and click Next to continue.
    For Redis cluster enter the Comma separated IP in the format <IP-ADDRESS>:<PORT> Default is 127.0.0.1:6379 (For redis authentication refer Redis Authentication).
    Note: 1. Eventstore supports only Redis Cluster with 3 Redis primary instance. A single non-cluster redis instance is not supported.
    Note: 2. Verify if you have entered the IP address in a correct format. Otherwise, installer throws a validation error and redirects to this step again.
  12. Enter the Redis Password when installer prompts and click Next to continue.
    Installer prompts for password confirmation.
  13. Enter Redis Password when prompts for confirmation and click Next to continue.
    Installer throws a validation error and redirects to the beginning of step 12 if the passwords are mismatched.
  14. Installer prompts to enter Kafka SASL Configuration. You can choose SASL_PLAINTEXT or SASL_SSL for Kafka communication.

    SASL_PLAINTEXT: User name and Password authentication without encryption of data.

    SASL_SSL: User name and Password authentication with SSL encryption.

    For SSL encrypted communication ensure that " kafka.crt " file is available in "/opt/ssl". Default is SASL_SSL.
    1. Click SASL_PLAINTEXT radio button for SASL_PLAINTEXT, click Next to continue.

      (For Enabling Kafka authentication using SASL/PLAINTEXT, refer Kafka SASL_PLAIN Authentication Configuration).

      or

    2. Click SASL_SSL radio button for SASL_SSL, click Next to continue.
  15. Installer prompts to enter the kafka configuration.
    1. Enter KAKFA ADDRESS. Kafka IP/fqdn/hostname address must be in the format <IP-ADDRESS/FQDN/HOSTNAME>:<PORT>. For Kafka cluster enter the comma separated address.
    2. Enter KAKFA TOPIC. Default is sam_notification.
      Note: The topic must be already created with 1 partition only.
    3. Enter KAFKA Username, click Next to continue.
      Note: Installer throws a validation error if any input fields are empty and redirects to the beginning of this step 15.
  16. Enter the KAFKA Password when installer prompts and click Next to continue.
    Installer prompts for password confirmation.
  17. Enter KAFKA Password again when prompts for confirmation and click Next to continue.
    Installer throws a validation error and redirects to the beginning of step 12 if the passwords are mismatched.
  18. Installer prompts to choose the communication protocol for presentation SAM. Default is http.
    • Click https radio button for https communication and Click Next to continue.

      For https, ensure that “sam.crt” is available in /opt/ssl. To import the SAM certificate refer Enabling HTTPS in SAM.

      or

    • Click http radio button for http communication and Click Next to continue.
  19. Enter the presentation SAM configuration details when Installer prompts. Enter the IP/fqdn/hostname address for SAM in the format <IP-ADDRESS/FQDN/HOSTNAME>:<PORT>). Click Next to continue.
    Installer throws a validation error if any input fields are empty and redirects to the beginning of this step 19.
    Note: In SAM Port 8080 is enabled in http mode and Port 8443 is enabled in https mode.
  20. Click Next to continue when Pre install summary is displayed.
    installation continues.
  21. Click Done to exit the Installer.
    Install Completed message is displayed.

What to do next

After successful EventStore installation, install 3 elastic search plugins on all elastic search instances in the cluster by following these steps:

  1. Copy the plugins directory containing "ChainingSupport-6.4.2.zip, elasticsearch-arrayformat-6.4.2.zip and elasticsearch-userprofile-6.4.2.zip" from "<EventStore_INSTALL_DIR>/evenstore/plugins/" to < PLUGIN-DIRECTORY > where Elastic Search is running.

    Here <PLUGIN-DIRECTORY> can be any directory.

  2. After copying Run the following command to install each plugin: 
    1. /path/to/elasticsearch/bin/elasticsearch-plugin install file:///<PLUGIN
DIRECTORY>/
plugins/ChainingSupport-6.4.2.zip
2. /path/to/elasticsearch/bin/elasticsearch-plugin install file:///<PLUGIN
DIRECTORY>/
plugins/elasticsearch-arrayformat-6.4.2.zip
3. /path/to/elasticsearch/bin/elasticsearch-plugin install file:///<PLUGIN
DIRECTORY>/
plugins/elasticsearch-userprofile-6.4.2.zip
  3. After installing all the plugins Restart the Elastic Search Service on all cluster nodes.