Installation
Also available as:
PDF
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 can access this package in your Ambari repository; additionally, it is available or on the Tools tab of the Hortonworks support portal.

  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 from the server between , refer to this Knowledge Base article for the HTTPS 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 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:

    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 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