Post installation Tasks

External JRE

For JVM microagents: If you have specified external JRE when installing TIBCO Hawk, tools.jar in the .hma file must point to a JDK installation location.

If you plan to use a JRE version other than the one supplied with TIBCO Hawk, make sure that the correct values are set for JVM_LIB_PATH, JVM_LIB_DIR, JVM_LIB_SERVER_DIR, JAVA_HOME, JRE_HOME, JRE_ROOT in the .cfg and .tra files in CONFIG_FOLDER\bin.

Setting Permissions for Executing HMA on UNIX/Linux

TIBCO Hawk MicroAgent (HMA) process must execute under “root” privileges, on UNIX/Linux platforms.

This process internally gathers various system level information through different system artifacts such as, files, folders, scripts and so on. Access failure to such system-guarded items results in incorrect results of some of the microagent methods.

If the installation is done using root user, then the installation process, accordingly creates “setuid” permissions with root ownership for the TIBCO HMA executable.

If the installation is done using a non-root user, then after installation is complete, the root user must change the ownership of the following files to root and set the setuid permission as follows:

chown root tibhawkhma
chown root starthma
chmod u+s tibhawkhma
chmow u+s starthma

Add the following to the /etc/ld.so.conf:

/<TIBCO_HOME>/tibrv/<VERSION>/lib
/<TIBCO_HOME>/hawk/<VERSION>/lib
/<TIBCO_HOME>/hawk/<VERSION>/ami_api/lib
/<TIBCO_HOME>/as/<VERSION>/lib

Run ldconfig command in the terminal.

Then, a normal user with executable permissions can execute HMA with effective "root" permissions.

Note: You can start the HMA by using the sudo ./starthma command if you are a root user.