Please find inside a short guide to help you prepare your infrastructure for Mindbreeze InSpire.
Please provide us with the desired fully qualified host names for Mindbreeze InSpire (e.g. search.companyname.com), the technical contact for the implementation and suitable dates for the on-site support via our Mindbreeze InSpire contact form: . Please also provide us with all data sources that you would like to link to the search. If necessary, also provide us with the authentication mechanism to be used for the search (e.g. Kerberos, SAML, etc.).
For Kerberos-based authentication with Active Directory you must set up a service user in Active Directory, e.g. mindbreeze.service. Please ensure that the following requirements are met:
Please note that the following network connections are activated for the Mindbreeze InSpire server:
Electrical and Other Technical Requirements for installing your Mindbreeze InSpire Appliance
Your Mindbreeze InSpire Appliance must be installed in a location meeting the temperature, electrical, refrigeration, and other requirements shown in the following tables.
Typical Thermal Dissipation
Operating Temperature Range
Storage Temperature Range
10°C to 35°C (50°F to 95°F) with a maximum temperature gradient of 20°C/h (36°F/h).
–40°C to 65°C (–40°F to 149°F) with a maximum temperature gradient of 20°C/h (36°F/h).
Note: Maximum temperature is reduced by 1°C/300 m (1°F/547 ft) above 950 m (3,117 ft).
Operating Relative Humidity Range
Storage Relative Humidity Range
10% to 80% Relative Humidity with 29°C (84.2°F) maximum dew point.
Maximum Operating vibration
Maximum Storage vibration
0.26 G rms at 5 Hz to 350 Hz (all operation orientations).
Maximum Operating shock
Maximum Storage shock
Six consecutively executed shock pulses in the positive and negative x, y, and z axes of 40 G for up to 2.3 ms.
Maximum Operating altitude
Maximum Storage altitude
3048 - 2000m (10,000 - 6560 ft)
12,000 m (39,370 ft)
Maximum System Power Consumption
Input Voltage (AC)
100 - 240 V AC, autoranging
31.5 kg (69.45 lb) at maximum configuration
Width: 48.2 cm (18.98 inch)
Depth: 75.58 cm (29.75 inch)
Height: 8.73 cm (3.44 inch)
Industry Rack Height
The Mindbreeze InSpire Management Center is the interface where administration and management tasks can be performed on a Mindbreeze InSpire Search Appliance.
For accessing the Mindbreeze InSpire Management Center make sure that the following network ports are accessible on the connected Mindbreeze InSpire server network interfaces.
Admin and Management Ports:
General Mindbreeze Ports:
For using the iDRAC interface of the Mindbreeze InSpire Server the following Ports have to be accessible on the Mindbreeze InSpire Server’s iDRAC network interface:
Make sure that the Mindbreeze InSpire Appliance network interface cards (NICs) are connected by wire. At least the iDRAC interface as well as one of the host NICs. Per default the Mindbreeze InSpire NICs are set to DHCP. See below on how to use iDRAC to obtain the host MAC address for reserving a DHCP lease.
The IP address of the iDRAC interface after successful connection can be viewed locally on the front panel LCD by accessing the following menu:
A short introduction about the Front Panel LCD is available at:
With this information, you can retrieve from the DHCP server which IP address was leased for the network interfaces.
If DHCP is not available for the iDRAC network interface the IP Address can be set manually via the Front Panel LCD, as follows:
On the Front Panel LCD of the server also the MAC addresses of the host interfaces are listed. For viewing the MAC addresses, please follow this path:
If DHCP is available the MAC addresses of the host interfaces (either obtained in the previous step) or obtained via the iDRAC Admin portal (https://<iDRAC_IP>:443) can be used to identify/or reserve the respective DHCP leases and therefore the obtained IP addreses.
Login for the iDRAC Admin Portal:
If DHCP is not available to automatically assign network settings to the host network interfaces, the network configuration for these interfaces can be accomplished by connecting to the Virtual Console using the iDRAC Web Interface (https://<iDRAC_IP>:443).
In the Virtual Console, log in with the following credentials:
After a successful login the Network Configuration Interface is shown. Here the DNS Server and the static addresses of the network interface (bond0) can be configured. It is recommended to configure the DNS server only via “DNS configuration”.
If access to iDRAC is not available log in using the config user can also performed physically. See above for the steps to set the Device and DNS configuration.
After a successful network configuration the Mindbreeze InSpire Management Center is accessible via the following Secure HTTP Link: https://<ip_address>:8443 . Here the <ip_address> tag is the IP address of one of the connected network interfaces.
For accessing the Mindbreeze InSpire Management Center login credentials are required. By default, the management center can be accessed with “admin” user and “Appliance123” password.
Below is the short description of the main sections in the Mindbreeze InSpire Management Center.
Mindbreeze InSpire uses the software component Keycloak to manage backend-crendtials. This section covers the most important use-cases (change password, create new users …). Please find additional documentation here :
You will be promted to change the admin password at first login in the management center. If you want to change the password later please navigate to the menu entry “Credentials“ in the “Setup“ section. The password change option is available at “Manage“ - “Users“ and the Credential tab of the user you want to change the password for. The option “Temporary” forces the user to change the passwort at the next login. Apply your changes with “Reset Password“.
You can create users in the same menu section. Select “Mange“ – “Users“ – “Add user“. Supply an username and click on “Save”. Switch to the “Credentials“ tab to set a password. You also need to assign Roles to the user according to the following section. To be able to use the feature “forgot Password”, you should provide a valid E-Mail address for every user.
Access to the sections of the management center (for example “Reporting“ or “Configuration“) is managed using predefined roles. You can access a list of all roles in the “Credentials” section of the management center at “Configure” – “Roles”. The user “admin” has already be assigned all roles. To assing roles to a user or remove them, please navigate to “Manage” – “Users”. Search for and select the user you want to manage. Select “Edit” – “Role Mapping” to assign or remove roles.
In this section a preconfigured Mindbreeze Client Service and a Search App Editor can be accessed.
Here you can explore reports, telemetry data and statistics related to the Mindbreeze services.
In this section different operations related to the Mindbreeze services can be performed, such as starting and stopping the services or resetting the indices (reindexing).
Operating system patches are provided as part of the Mindbreeze InSpire update package.
After applying the update a restart of the Appliance is required.
New versions of Mindbreeze InSpire can be installed via the Management Center. You need the (G7-)Image-File and a webbrowser with access to the Management Center. You can aquire the Image-File at the following link on the Mindbreeze website:
Open the Management Center and navigate to the section „Update“ „Upload“.
Select the image file via „Choose File“ and click on „Upload File“. A progress bar is displayed during the upload process.
The next step shows important information about the update.
You can choose if the appliance should reboot automatically if needed. A password is only required if the update does not start (please contact Mindbreeze support if that happens).
If you agree to the General Terms and Conditions, click on „Perform Update“ to start the update process. Notice: Services are not available during the update. The update step shows detailed information about the update process. The message „Success“ is displayed after the update is done successfully.
During the update you may be have to enter your credentials for the management center again.
If you do not want to start the update immediately after the upload your can always come back to the section “Update”->”Perform Update”.
This document describes the key facts that should be regarded for backups of Mindbreeze InSpire configuration files and index data.
The backup strategy should include the following type of data and should especially be performed before installing product updates:
The last 10 revisions of the Mindbreeze configuration data files are kept in the configuration directory. Nevertheless, you should take an external backup of those files:
Important configuration files:
Furthermore, please execute export_managerconfig.sh including a path (e.g. export_managerconfig.sh /data/export) and make a backup of the folder export.
If you have deployed your own Search Apps, you should take a backup of these changes:
Fabasoft Mindbreeze uses a file based index. These index files can be backed up completely in a consistent state.
To save index data, perform the following steps:
Just take a copy of the main app.telemetry configuration file (infra.xml) located at following location:
The user database is exported daily into the following location within the keycloak container:
This location is also accessible in the host under the location:
Add this location to your backup.
Mindbreeze InSpire is delivered to customers as a preconfigured appliance. The pre-installed software components were coordinated with one another and tested for possible side effects.
It is not foreseen that customers make changes to the software status on their own, except for security updates, for which the recommended procedure is explained in the brief guide entitled:
“Brief Instruction - Continuous Updating of the Operating System Patches”.
Possible examples of adverse changes to the software status include:
Depending on the type of third-party software components, the effects this may have on Mindbreeze can vary.
The possible effects of third-party software include:
The most common problems are to be expected through the use of antivirus software and can be minimized as described in the following chapter.
To minimize any negative impact on Mindbreeze performance and stability, the following directories should be specifically excluded from virus scanning runs:
However, any type of virus scan run can have a potential negative effect on the system performance and consequently the response time behaviour of Mindbreeze. If regular system scans are unavoidable, we recommend that they be performed in maintenance windows or outside the core time in which the search is offered.