SmartHub with Elasticsearch Prerequisites
Elasticsearch and SmartHub Versions
SmartHub v5.6+ supports Elasticsearch v7-8.x as a search backend The search engine your SmartHub instance uses to perform queries. SmartHub can be configured to use more than one search engine..
SmartHub Analytics is a separate component with separate requirements.
SmartHub v5.6+ Analytics specifically requires Elasticsearch v7.10.
For Connectivity Hub users of Elasticsearch, Connectivity Hub v3.0+ supports Elasticsearch v7-8.x, (Connectivity Hub also supports other search engines).
If you upgrade your Elasticsearch instance(s) from v7 to v8, you must upgrade your BA Insight products accordingly.
Installation Prerequisite Checklist
|
Component |
Requirement | Description | Completed |
|---|---|---|---|
| SmartHub Server: OS |
Operating System | Microsoft Windows Server
|
|
| SmartHub Server: OS Roles and Features | Windows Roles and Features | The following Web Server (IIS) roles must be enabled with the following options and features selected:
|
|
| SmartHub Server: .NET Framework | .NET Framework |
|
|
| Accounts: Service | Service Account |
Local or network service account Local account used by the service control manager. Not recognized by the security subsystem, so you cannot specify its name in a call to the LookupAccountName function. Has minimum privileges on the local computer and acts as the computer on the network. used to run the SmartHub Application pool in IIS
|
Account credentials: (domain\user) |
| Accounts: Install | Installation Account |
Account used to install SmartHub
|
Account credentials: (domain\user) |
| Supported Web Browsers |
|
*Unsupported Web Browsers Other web browsers may work with SmartHub, but are not officially supported by BA Insight, such as:
Browsers that are in incognito mode are not supported. |
|
| Analytics: Elasticsearch Index |
Elasticsearch v7.10 |
Note: The Elasticsearch index used for the SmartHub data does not have to be the same instance use for the search index (backend).
|
Elasticsearch URL: Elasticsearch Username: Elasticsearch Password: |
| Analytics: Kibana A source-available data visualization dashboard for Elasticsearch | Kibana v7.10 |
|
Kibana URL: Kibana Username: Kibana Password: |
| NLQ Enables users to find information by making requests as if they were speaking to a person. Services (Optional) |
|
Only one NLQ service should be configured. Supported NLQ/AI Engines: For more information see: |
Service Endpoint:
Service Key (LUIS only): |
| Search Engine The search engine your SmartHub instance uses to perform queries. SmartHub can be configured to use more than one search engine.
|
Elasticsearch v7-8.x |
Note: The same Elasticsearch instance used for the Analytics Index above can be used for the Search index.
|
Elasticsearch URL: Elasticsearch Username: Elasticsearch Password: |
|
Network Requirements: DNS The system that converts website domain names (hostnames) into numerical values (IP address) so they can be found and loaded into your web browser. |
DNS entry for SmartHub site |
|
DNS name / URL for SmartHub: |
| Network Requirements: SSL | SSL Certificate SSL certificates use a key pair: a public and a private key. These keys work together to establish an encrypted connection. The certificate also contains what is called the “subject,” which is the identity of the certificate/website owner. | If running SmartHub over SSL (recommended), a signed SSL certificate for that DNS name (or appropriate wildcard cert) is required. |
Certificate name: Passphrase (if required): |
| Network Requirements: Internal |
Internal Network Connectivity |
The SmartHub server must have network connectivity to the following:
|
Verified:
|
| Network Requirements: External | External Network Connectivity | Network connectivity from the SmartHub server to the following Microsoft Azure services is required if you use the service(s):
|
Verified:
|