Connecting to Jethro Manager

To connect to Jethro Manager, open Google Chrome, and browse to the server on which you installed Jethro Manager: http://{Jethro Manager Machine IP/host}:9100/

The syntax above assumes using the default port (9100). If you chose to use a different port, replace 9100 with that port number.

Upon logging in to the system, you will be prompted to provide your user credentials. Provide the default credentials (case sensitive!):

After your first login, you will be able to change the user's password through the User Account screen.

Connecting Jethro Manager to an Exterior Query Machine

Establishing a connection between Jethro Manager and a Jethro query node, which are not installed on the same machine (not local), requires the user to provide the IP and the Jethro SSH private key of the requested query node.
Jethro query node prepares that key for the user during its installation, under a local and hidden directory, accessible only by the OS user jethro.

To acquire the Jethro SSH private key for the user:

  1. Go to the following directory: ~jethro/.JethroKeys/
  2. Copy the content of id_rsa into the Configuration page, into the designated text box.

To work locally again (meaning to have Jethro Manager and Jethro query node reside on the same host), you only need to go to the Configuration page -> IP input line, and enter localhost. No SSH key is required; the system will try to find the SSH key automatically for you.

Changing the Default Port

Jethro Manager's default port is 9100.

To change the default port for Jethro Manager version < 1.5:

  1. Open the following file for editing: /opt/jethro/jethromng/pm2/pm2-production.json
  2. Under section apps/env, change the value of the port variable from 9100 to a value of your choice.

To change the default port for Jethro Manager version >1.5:

  1. Open the following file for editing: /opt/jethro/jethromng/jethromng.config
  2. Change the value of theHTTP_PORT parameter from 9100 to a value of your choice.

For the setting to take effect (both versions), restart the Jethro manager service by running the following command:

service jethromng restart

If you've changed the default port, and later on uninstall/re-install Jethro Manager (for example, during upgrade), you need to repeat the above steps with your desired port number. Otherwise, Jethro Manager will go back to use port 9100.

HTTPS connection

In order to enable HTTPS protocol for Jethro Manager, follow the below procedure:

  1. Stop Jethro Manager by running:

    service jethromng stop
  2. Copy the .key and .crt files to /opt/jethro/jethromng/resources/encryption/ 
  3. Change the owner of the crt and key files by running the 'chown' command, togather with the user and group which were used to install Jethro Manager (by default it's jethro:jethro). For example:

    chown jethro:jethro /opt/jethro/jethromng/resources/encryption/jethro.key
    chown jethro:jethro /opt/jethro/jethromng/resources/encryption/jethro.crt

    If 'jethro' is not the user which was used to install Jethro Manager, you can run 'echo $JETHROMNG_INSTALL_USER' and 'echo $JETHROMNG_INSTALL_GROUP' to find the user and the group required for the chown command.

  4. open /opt/jethro/jethromng/jethromng.config, and change the following parameters:
    "IS_SECURE": "true",
    "SSL_KEY_FILE": "<the file name (without path) of the .key file>",
    "SSL_CRT_FILE": "<the file name (without path) of the .crt file>",
    "HTTPS_PORT": <port to use (default is 443)>
    "HTTP_PORT": <port to use (default is 9100)>
    NOTE: In case of a version earlier than 1.5, please add the parameters manually.
  5. Start Jethro Manager by running:

    service jethromng start