Installation
Also available as:
PDF

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:

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