SmartSense Configuration Guidelines
Also available as:
PDF

SmartSense gateway

The following configuration properties are available for the SmartSense gateway:

Table 1. SmartSense Gateway Configuration Properties
Property Name Description Where to Configure Guidelines

security.openssl.digest.algorithms

A comma separated list of supported algorithms for SSL.

Type: string

Default Value: sha256,sha384,sha512,sha,sha1,md5

Ambari Config: N/A

Config File:

/etc/hst/conf/hst-gateway.ini

Typically it there is no need to modify this as sha256,sha512 are available and provide strong encryption. Change this only if you have a very specific requirement.
security.gateway.cert.name

Use this property if you have to use a custom root certificate authority for SmartSense gateway operations. This file must exist at /var/lib/hst-gateway/keys before gateway is started.

Type: string

Default Value: ca.crt

Ambari Config: N/A

Config File:

/etc/hst/conf/hst-gateway.ini

You can set up your own CA to sign certificates for two-way SSL communication between HST server and SmartSense gateway. Modify this property to customize the root CA.

gateway.thread.pool.size

Thread pool for the gateway server's API endpoint. Default is automatically calculated based on CPU cores.

Type: int

Default Value: (Automatically calculated)

Ambari Config: N/A

Config File:

/etc/hst/conf/hst-gateway.ini

Since the count is already dynamic, it is usually not required to change it.
gateway.start.validation.enabled

Enables the outbound connectivity check that SmartSense gateway performs during startup. By default, the connectivity check in enabled.

Type: boolean

Default Value: true

Ambari Config: N/A

Config File:

/etc/hst/conf/hst-gateway.ini

Set to false if you use an HTTP proxy for gateway and gateway start command fails with "unable to connect" error. There is bug in SmartSense gateway versions earlier than 1.3.2 where the socket connectivity test does not use the intended proxy.

gateway.cache.expiry.hours

The frequency with which the SmartSense gateway cache is refreshed.

Gateway caches the outbound connectivity status to report to HST server. By default, this cache is refreshed every two hours and upon gateway startup.

Type: int

Default Value: 2

Ambari Config: N/A

Config File:

/etc/hst/conf/hst-gateway.ini

Tweak this property to refresh the outbound connectivity status.

gateway.data.transfer.buffer.size

Buffer size for data transfer via SmartSense gateway. Gateway uses chunked buffers to transfer encrypted data between SmartSense and Hortonworks Datalake.

Type: int

Default Value: 4096

Ambari Config: N/A

Config File:

/etc/hst/conf/hst-gateway.ini

Tune this property to effectively use the network bandwidth for communication between HST server and Hortonworks.