Page tree
Skip to end of metadata
Go to start of metadata

Installation Prerequisites

Before starting the installation of Jethro, ensure that the conditions specified in the following sections are met:

  • Only the Supported Platforms are being used.
  • Jethro v3.4.6 (or higher) is installed on the same server where you plan to install Jethro Manager.

Installing the Jethro Manager Software

Jethro Manager installation is pretty simple. It runs as root, extracts Jethro Manager software into /opt/jethro/jethromng/, and automatically creates and configures the Jethro OS user (if needed) and Linux services. To install Jethro Manager:

  1. Sign-in as root.
  2. Install openJDK by running:

    yum install -y java-1.8.0-openjdk.x86_64
  3. Download the Jethro RPM to a local directory:

    wget https://jethro.io/latest-jethro-manager
  4. Install the RPM you downloaded, by running:

    rpm -Uvh latest-jethro-manager

Important Notes

  • Jethro Manager uses port 9100 for communicating with your browser. Make sure that the security policy of your server allows that kind of communication, and that the port is open.

    To verify that the port is open, run the following command within the server: curl localhost:9100

    If the port is closed, you'll see the following message: curl: (7) Failed to connect to localhost port 9100: Connection refused

    To have Jethro Manager use a different, see Jethro Manager connections - changing the default port.

    If you're installing Jethro Manager and you have previously configured it to use a custom port, then once installation complete you need to configure the custom port again as described in Jethro Manager connections - changing the default port.

  • Loading data directly from HDFS/Hive/Impala requires installing the client shells for each, on the same machine where the Jethro query node is installed, and having their core-site point to the name node of your cluster. If you're not planning to load directly from one or more of these sources, you can skip installing their client shells.

  • Jethro Instances which were created by using a Jethro versions lower than 3.0, needs to be updated manually with system tables, in order to support the communication with the load manager. To do that, run the following command on the Jethro machine:

    JethroClient {instance_name} localhost:{instance_port} -p jethro -i /opt/jethro/{jethro-version}/bin/system_tables.ddl
  • If the connection between Jethro Manager and a Jethro Instance, is being made based on a user other than 'jethro', a permission must be granted for that user to access Jethro's system tables. To do that, run the following command using JethroClient, as an admin user (The instance admin - typically user 'jethro'):

    grant select insert ON table jethro$_loader_events to role <role-name>;
  • To change the OS user which runs the Jethro Manager services, run the following commands:

    sudo su - # switch to root.
    service jethromng stop
    pkill PM2
    chmod 777 /opt/jethro/jethromng/jethromng.out
    chown -R jethro.jethro /opt/jethro/jethromng/pm2
    chown jethro.jethro /opt/jethro/jethromng/jethromng.config
    su - <the_user_to_run_jethro_manager_with>
    service jethromng start

See also

Setting up Jethro Manager using Docker

  • No labels