HPEBusiness Intelligence for Human

Information
Software Version: 11.0.0

Installation Guide

Document Release Date: March 2016

Software Release Date: March 2016

Installation Guide

Legal Notices
Warranty
The only warranties for Hewlett Packard Enterprise Development LP products and services are set forth in
the express warranty statements accompanying such products and services. Nothing herein should be
construed as constituting an additional warranty. HPE shall not be liable for technical or editorial errors or
omissions contained herein.
The information contained herein is subject to change without notice.

Restricted Rights Legend

Confidential computer software. Valid license from HPE required for possession, use or copying. Consistent
with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and
Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard
commercial license.

Copyright Notice
Copyright 2016 Hewlett Packard Enterprise Development LP

Trademark Notices
Adobe is a trademark of Adobe Systems Incorporated.
Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation.
UNIX is a registered trademark of The Open Group.
This product includes an interface of the 'zlib' general purpose compression library, which is Copyright
1995-2002 Jean-loup Gailly and Mark Adler.

Documentation Updates
HPEBig Data Support provides prompt and accurate support to help you quickly and effectively resolve any
issue you may encounter while using HPEBigData products. Support services include access to the
Customer Support Site (CSS) for online answers, expertise-based service by HPEBig Data support
engineers, and software maintenance to ensure you have the most up-to-date technology.

To access the Customer Support Site

l

go to https://customers.autonomy.com

The Customer Support Site includes:

l

l
l

Knowledge Base. An extensive library of end user documentation, FAQs, and technical articles that is
easy to navigate and search.
Support Cases. A central location to create, monitor, and manage all your cases that are open with
technical support.
Downloads. A location to download or request products and product updates.
Requests. A place to request products to download or product licenses.

To contact HPE BigData Customer Support by email or phone

l

go to http://www.autonomy.com/work/services/customer-support

Support
The title page of this document contains the following identifying information:

HPE Business Intelligence for Human Information (11.0.0)

Page 2 of 17

Installation Guide

l
l
l

Software Version number, which indicates the software version.

Document Release Date, which changes each time the document is updated.
Software Release Date, which indicates the release date of this version of the software.

To check for recent updates or to verify that you are using the most recent edition of a document, visit the
Knowledge Base on the HPE BigData Customer Support Site. To do so, go
tohttps://customers.autonomy.com, and then click Knowledge Base.
The Knowledge Base contains documents in PDF and HTML format as well as collections of related
documents in ZIP packages. You can view PDF and HTML documents online or download ZIP packages
and open PDF documents to your computer.

About this PDF Version of Online Help

This document is a PDF version of the online help. This PDF file is provided so you can easily print multiple
topics from the help information or read the online help in PDF format. Because this content was originally
created to be viewed as online help in a web browser, some topics may not be formatted properly. Some
interactive topics may not be present in this PDF version. Those topics can be successfully printed from
within the online help.

HPE Business Intelligence for Human Information (11.0.0)

Page 3 of 17

Installation Guide

Contents
Chapter 1: Introduction

Chapter 2: Prerequisites

Supported Operating Systems and Browsers

Required IDOL Components

Optional Software

Third-Party Software

BIFHI Home Directory

Chapter 3: Install BIFHI

Use the Interactive Installer

Chapter 4: Edit Configuration Settings

10
10

11

Configure BIFHI

11

Configure Third-Party Services

Enable Mapping

11
12

Chapter 5: User Roles

13

Chapter 6: Clustering

15

Send Documentation Feedback

17

HPE Business Intelligence for Human Information (11.0.0)

Page 4 of 17

Installation Guide
Chapter 1: Introduction

Chapter 1: Introduction
Business Intelligence for Human Information (BIFHI) is a business intelligence tool for HPE IDOL.
BIFHI supports the following functionality:
l
l

l
l

Advanced search. Refine searches by database, date, or parametric values.

Document preview. BIFHI uses the IDOL View component to render near-native views of the
source documents for your search results in a web browser. The Document Preview feature works
with View server and documents in source repositories.
Document security. You can set up document security so that only permitted users can access the
documents, or even see them in search results.
Saved Searches. You can save searches and run them again later, create snapshots of saved
searches, or compare two or more saved searches.
Results visualizers. View your results as topic maps or sunburst charts as well as in list format.
Integration with HPE MMAP. BIFHIis integrated with HPE Media Management and Analysis
Platform (MMAP), a media analytics platform designed for viewing, searching, and analyzing video
and audio data, including object detection, scene analysis, face recognition and audio transcripts.
Document metadata display. You can view the metadata associated with the documents you are
viewing.

HPE Business Intelligence for Human Information (11.0.0)

Page 5 of 17

Installation Guide
Chapter 1: Introduction

HPE Business Intelligence for Human Information (11.0.0)

Page 6 of 17

Installation Guide
Chapter 2: Prerequisites

Chapter 2: Prerequisites
This section describes the operating systems that BIFHI supports, and the required and optional IDOL
components and third-party software needed to run BIFHI. It also specifies how to set up the BIFHI
home directory.

Supported Operating Systems and Browsers

Required IDOL Components

Optional Software

Third-Party Software

BIFHI Home Directory

Supported Operating Systems and Browsers

BIFHI supports the following operating systems:
l

Windows Server 2008, 2008 R2, 2012, or 2012 R2

Ubuntu 14.04 LTS

CentOS6 or 7

BIFHIsupports the following web browsers:

l

Chrome (latest version)

Firefox (latest version)

Internet Explorer 11

Microsoft Edge

Required IDOL Components

Before you install BIFHI, you must install and configure the following IDOL components:
l

IDOL Community 11.0.0 (BIFHI requires access to the ACI and service ports)

IDOL Content 11.0.0 (BIFHI requires access to the ACI and service ports)

IDOL View Server 11.0.0 (BIFHI requires access to the ACI and service ports)

Optional Software
The following software is optional:
l

HPE Media Management and Analytics (MMAP)

HPE Business Intelligence for Human Information (11.0.0)

Page 7 of 17

Installation Guide
Chapter 2: Prerequisites

Third-Party Software
The following third-party software is required:
l

Java 1.8

BIFHI Home Directory

You must specify the BIFHI home directory as a Java system property, either in a startup script or
within the appropriate application server configuration, depending on how the application is being
deployed.
The home directory contains the following files:
l

The BIFHI configuration file (config.json). If this file is not found, BIFHI generates a default
configuration file when the application starts.
You can edit the configuration file either from the Settings page in the application (recommended), or
manually in a text editor. If you manually edit the file, you must restart BIFHI for any configuration
changes to take effect.

The BIFHI logs folder. This directory contains the application log files, which contain details of
application usage and any errors.
The BIFHI data folder. This contains a file-based database that stores the details of saved searches
and snapshots.

If you need to contact support, please include the BIFHI home directory as a zip file when you send
your query.

HPE Business Intelligence for Human Information (11.0.0)

Page 8 of 17

Installation Guide

HPE Business Intelligence for Human Information (11.0.0)

Page 9 of 17

Installation Guide
Chapter 3: Install BIFHI

Chapter 3: Install BIFHI

BIFHI is available as an interactive installer.
Alternatively, you can install BIFHI as an IDOLcomponent by running the IDOL Server installer. For
more information, see the IDOL Server Getting Started Guide.

Use the Interactive Installer

10

Use the Interactive Installer

An interactive installer is available for BIFHI for all supported platforms. Use the following procedure to
install BIFHI by using the interactive installer.

To install BIFHI
l

Run the installer as an Administrator user, and then follow the instructions, supplying the correct
information when prompted. BIFHI will be installed to the location that you specified.

Before you start BIFHI, follow the steps in "Edit Configuration Settings" on page 11 to configure BIFHI.

HPE Business Intelligence for Human Information (11.0.0)

Page 10 of 17

Installation Guide
Chapter 4: Edit Configuration Settings

Chapter 4: Edit Configuration Settings

This section describes the structure of the BIFHI configuration file, and explains how to configure
BIFHI.

Configure BIFHI

11

Configure Third-Party Services

11

12

Enable Mapping

Configure BIFHI
Use the following procedure to configure BIFHI.
1. Run BIFHI once without a config.json file in your BIFHI home directory, so that a default file is
generated.
2. Open the generated config.json file in a text editor and find the generated default user name and
password at the top of the file (login.defaultLogin.username and
login.defaultLogin.password).
3. Go to http://BifhiHost:BifhiPort, where BifhiHost is the IP address or name of the
machine on which BIFHI is installed, and BifhiPort is the port that you have installed BIFHI on
(for example, 8080).
4. Log in using the default user name and password from the configuration file.
The Settings page opens.
5. Fill in the details of your backend IDOLservers. Click Test Connection for each server to confirm
that a connection can be established from the BIFHI server.
6. Click Save Changes.
BIFHI is now ready for use.
Note: To get back to the Settings page in future, go to
http://BifhiHost:BifhiPort/private/#Find/settings (where BifhiHost is the IP address
or name of the machine on which BIFHI is installed, and BifhiPort is the port that you have
installed BIFHI on). This page is available to any user with the BifhiAdmin role in IDOL
Community.

Configure Third-Party Services

BIFHI can optionally connect to an OpenStreetMap tile server to present geolocational data associated
with search results. Administrators can enable mapping in BIFHIfrom the Settings page.

HPE Business Intelligence for Human Information (11.0.0)

Page 11 of 17

Installation Guide
Chapter 4: Edit Configuration Settings

Enable Mapping
Use the following procedure to enable mapping in BIFHI.

To enable mapping
1. Go to the Settings page.
2. In the Mapping section, specify the following settings:
l

Tile Server Url Template. The full Slippy Map Tilenames (XYZ) URL for requesting a tile from
an accessible tile server, with the x, y and z coordinates replaced with curly brace variables.
For example, https://maps.example.com/tiles/{z}/{x}/{y}.png.
Attribution. An optional string to display in the bottom right corner of the map (for example, a
copyright statement).

You can use any image file type that is supported by the browser.
There are many compatible tile servers available as a service over the internet, including Mapbox
(https://www.mapbox.com), MapQuest (http://www.mapquest.com/), and most OpenStreetMap
servers.
Note: Ensure that you check the terms of use before you use these services.

HPE Business Intelligence for Human Information (11.0.0)

Page 12 of 17

Installation Guide
Chapter 5: User Roles

Chapter 5: User Roles

BIFHI requires the creation of two roles in IDOL Community:
l

FindUser. The search end-user role.

FindAdmin. The BIFHI administrator role.

A user must be a member of one of these roles to log into BIFHI.

The FindAdmin role is used for controlling access to administrative sections of BIFHI. HPE does not
recommend that you grant the FindAdmin role to end users who do not have system administrator
responsibilities.
Note: These roles are shared with the HPE Find end-user search interface for HPE IDOL.

HPE Business Intelligence for Human Information (11.0.0)

Page 13 of 17

Installation Guide
Chapter 5: User Roles

HPE Business Intelligence for Human Information (11.0.0)

Page 14 of 17

Installation Guide
Chapter 6: Clustering

Chapter 6: Clustering
BIFHI does not currently support clustering of the web application.

HPE Business Intelligence for Human Information (11.0.0)

Page 15 of 17

Installation Guide
Chapter 6: Clustering

HPE Business Intelligence for Human Information (11.0.0)

Page 16 of 17

Send Documentation Feedback

If you have comments about this document, you can contact the documentation team by email. If an email
client is configured on this system, click the link above and an email window opens with the following
information in the subject line:
Feedback on Installation Guide (Business Intelligence for Human Information 11.0.0)
Just add your feedback to the email and click send.
If no email client is available, copy the information above to a new message in a web mail client, and send
your feedback to AutonomyTPFeedback@hpe.com.
We appreciate your feedback!

HPE Business Intelligence for Human Information (11.0.0)

Page 17 of 17