Installing SmartSense on HDF
Also available as:
PDF

Install and start SmartSense gateway

The SmartSense gateway is not managed by Ambari and must be installed manually. It is included in the same smartsense-hst-$HST_VERSION package used for the HST server and HST agent. You can access this package in your Ambari repository; Additionally, it is available or on the Tools tab of the Hortonworks support portal. Once you have the package, perform these steps:

  1. Install the SmartSense package on the chosen gateway host:
    • RHEL, CentOS, or SLES:
      # rpm -ivh smartsense-hst-$HST_VERSION.rpm 
    • Ubuntu or Debian:
      # dpkg -i smartsense-hst_$HST_VERSION.deb 
  2. Configure the gateway by editing the /etc/hst/conf/hst-gateway.ini file:
    • Specify the path to the JDK to be used by the gateway in the [java] section:
      [java]
      home={$path_to_your_JAVA_HOME}
    • To configure HTTPS connectivity, refer to SmartSense gateway setup for the HTTPS user name, password, host, and port details. To view this article, you need a valid Hortonworks support account.
  3. Start the gateway:
    # hst gateway start

    On startup, the gateway attempts to connect to the configured HTTPS host, and if the connection fails, the gateway does not start and logs the reason for connectivity failure to the /var/log/hst/hst-gateway.log file.

  4. Integrate the gateway with the HST server by following the instructions for integrating the gateway with Ambari-managed SmartSense .

If you deploy the gateway on a server that is also hosting an HST agent, and that HST agent has been deployed through Ambari, and Ambari is configured for nonroot operation, you should run the SmartSense gateway as the same user that the Ambari agent is configured to run as.

Additionally in this specific scenario, you must modify the following permissions using the commands below. In this example "ambari" is the user the Ambari agent has been configured to run as:

chown -R ambari:hadoop /var/lib/smartsense/hst-gateway
chown -R ambari:hadoop /var/log/hst
chown -R ambari:hadoop /var/run/hst