Skip to content

Installation

Untar

Untar Hetman .tar.gz file:

tar -xvf package-name.tar.gz

Installation

Before running installation switch to root (superuser) with the below sudo command:

sudo -i

To install Hetman software, run install.bash script, with the following command:

bash install.bash

Installation process may take up to a few minutes.

Steps for Hetman with Keycloak

Log in to Keycloak GUI

  1. Visit Keycloak GUI at http://${node_ip}:8021/_by_name/hetman-keycloak-microservice.
  2. Log in as initial, already created user, with credentials:
    • Username: admin
    • Password: 0nTe0n
  3. (Optional) Change initial admin's credentials.
    1. Go to Users.
    2. Click on the initial admin user.
    3. Go to Credentials tab.
    4. Click Reset password.
    5. Add new password (remember to turn off temporary option).
  4. (Optional) Create new admin user.
    1. Go to Users.
    2. Click Add user.
    3. Add username and click Create.
    4. Go to Credentials tab.
    5. Click Set password.
    6. Add new password (remember to turn off temporary option).
    7. Go to Role mapping tab.
    8. Click Assign role
    9. Choose admin role and click Assign.

NOTE

If accessing http://${node_ip}:8021/_by_name/hetman-keycloak-microservice returns HTTPS required screen, it means that the Keycloak is yet to be properly configured. It will be automatically configured up to 3 minutes, after the installation is finished.

Create new Hetman user

  1. Switch to hetman realm.

    Create Hetman user - switch realm

  2. Go to Users and click Create new user button.

    Create Hetman user - Users

  3. Add username and click Create.

    Create Hetman user - username

  4. Go to Credentials tab and click Set password button.

    Create Hetman user - credentials

  5. Add password, disable Temporary and click Save.

    Create Hetman user - password

  6. Go to Role mapping tab and click Assign role button.

    Create Hetman user - role mapping

  7. Add one of the roles and click Assign:

    • end-user
    • manager
    • administrator


    NOTE

    Hetman user can be assigned to one role and one role only.


    Create Hetman user - role

Post installation

When the installation is finished, you can access Hetman's GUI at http://${node_ip}:8020/_by_name/hetman-admin-frontend-microservice/.

Removal

Before running removal switch to root (superuser) with the below sudo command:

sudo -i

To remove Hetman software, run remove.bash script, with the following command:

bash remove.bash