loading table of contents...
HST Server Placement

One node in the cluster must be designated as the HST server, as this component consolidates all of the HST agents' collected data together into a single downloadable file, referred to as a "bundle". For this functionality, the HST Server must be set up on a node in the HDP cluster where inbound access to the preferred HTTP(S) server port is accessible. The HST Server will listen on the configured HTTP(S) port chosen during setup. For a full list of ports and a data flow diagram, refer to this section: SmartSense Ports & Traffic Flow.

It is preferred, but not required, that when installed outside of Ambari the HST Server node has passwordless root access via SSH to all HST Agent nodes in the cluster. This access will allow for single-click capture through the HST Server Web UI. However, if not available, captures can be performed from the CLI.

Administrators and each HST Agent in the cluster must have network access to the HST Server. This connectivity is required for agents to consolidate their data, and for Hadoop administrators to download completed bundles. To set up the HST Server instance, run the following command and follow the instructions below. The entries that need to be supplied based on the specific environment are referenced in italics. Initiate the HST setup wizard with the following command:

# hst setup

Welcome to Hortonworks SmartSense Tool
Enter Account Name: Enter your Account Name from Hortonworks Support Portal
Enter SmartSense ID: Enter Your SmartSense ID from Support Portal
Enter notification email
: Email address where the SmartSense notifications should to be sent
Enter storage directory (minimum: 1.00 GB, default: /var/lib/smartsense/hst-server/data): Preferred local storage directory to store collected bundles
Web UI Port (default:9000): Preferred port number
Enable Web UI SSL (Enabling requires a certificate)? [y/n] (default: n): n
Looking for available JDKs at /usr/jdk64
Enter java home directory: Path to java home
Enter Cluster Name: HDP Cluster Name
Is "{Cluster Name}" cluster secured? [y/n] (default: n): Enter y if Kerberos is enabled
# hst start

This setup command can be run any number of times. Each invocation will automatically restart the HST Server to allow the new changes to take effect.

The HST server uses a storage directory (default: /var/lib/smartsense/hst-server/data) to store all collected bundles. The minimum recommended size of that directory is 1GB. In order to change that restriction, change the configuration property min_required_storage in the /etc/hst/conf/hst-server.ini file.