SmartHub with Amazon Kendra Prerequisites
NOTE! Be sure to install all of the prerequisites listed for your SmartHub and backend The search engine your SmartHub instance uses to perform queries. SmartHub can be configured to use more than one search engine. instance.
Any issues experienced by BA Insight clients during installation are typically traced to a failure to meet the required prerequisites.
Installation Prerequisite Checklist
| Component | Requirement | Description | Completed |
|---|---|---|---|
| SmartHub Server: OS | Operating System | Microsoft Windows Server
|
|
| SmartHub Server: Windows Roles/Features | Windows Roles and Features | Must have Web Server (IIS) role enabled with the following Roles 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).
Java: The SmartHub Analytics component requires Elasticsearch Java JDK. Elasticsearch v7.x and later bundles Java with the software (OpenJDK). A separate Java download/install is NOT required. For more information see Elasticsearch documentation.
|
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.
|
Amazon Kendra |
Limitations
For details see the Limitations section from Connect SmartHub to the Amazon Kendra Backend. |
Kendra index name: Kendra access key: Kendra secret key: Kendra region: Click here for more details |
| 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: Pass-phrase (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:
|