loading table of contents...

Installing and Starting 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 access this package in the public Ambari 2.2.0 repository, if you are using Ambari 2.2.x, or on the Tools tab of the Hortonworks support portal, for non-Ambari and Ambari 2.1.x installations.

  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:

    • To configure SFTP connectivity from the server between , refer to this Knowledge Base article for the SFTP user name, password, host, and port details: https://support.hortonworks.com/s/article/SmartSense-Gateway-setup.

  3. Start the gateway:

    # hst gateway start

    On startup, the gateway attempts to connect to the configured SFTP 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:

    Integrating with Ambari Managed SmartSense or Integrating with Non-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:

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

In this example, "ambari" is the user the Ambari agent has been configured to run as.