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.
   
   

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

3. Add username and click Create.
   
   

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

5. Add password, disable Temporary and click Save.
   
   

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

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.

   
   

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