Installing and Upgrading


Supported Platforms

Please see the separate document on supported platforms.

Linux Requirements

Most Linux servers include all further software required by Funnelback, however additional packages may be required for some Linux distributions - please see details on required software.

Note also :

yum install compat-libstdc++-33.i686
yum install libstdc++.i686

Additional: If you are installing on RHEL7+ (Red Hat 7+) then you may need to expose the Optionals and/or regional libraries for Yum with:

>yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional 

before you can run the commands above.

Open File Handle Limits

Funnelback may require more open file handles than the default configuration permits on some Linux systems.

A recommended minimum value is 4096, however this value may need to be further increased if push collections are used under heavy update load.

The following steps can be used to raise the number of file handles permitted on RedHat Enterprise Linux and CentOS distributions.

Edit /etc/sysctl.conf to add the following line:

fs.file-max = 100000

and edit /etc/security/limits.conf to add the following lines:

root soft nofile 4096
root hard nofile 10240
search soft nofile 4096
search hard nofile 10240

and finally, reboot the server to cause the changes to take effect.

Funnelback Installed Components

When Funnelback is installed it will make use of an embedded web server (Jetty) for Funnelback administration and serving search queries. If desired, a different web server such as NGINX may be used to balance requests between multiple Funnelback servers.

On Linux systems Funnelback will create crontab records for scheduling query reporting etc., and init.d scripts are configured to cause Funnelback to start when the server boots.


Before upgrading to versions 14.2 or later you must go to Prepare Funnelback for upgrade in the system menu. For Version 14.0 only first shut-down jetty and then run the installer. Running the installer will extract a script which must be executed before the installer will upgrade funnelback. After executing the extracted script, run the installer a second time.

It is recommended that you backup your Funnelback installation prior to upgrading, including all data and indexes.

Do not attempt to move the previous Funnelback installation to a different directory prior to upgrading to a new version of Funnelback, as this may cause problems reinstalling ActivePerl or other systems required by Funnelback.

Installing / Upgrading

After you have ensured that the prerequisites listed above are installed, follow the instructions below to install Funnelback on your server.

Starting the Funnelback installer


Prior to installing Funnelback on Windows, please ensure that the server's date, time and time-zone have been set.

After downloading or copying the Funnelback installer to your server, it can be launched by double clicking the downloaded file (Windows). Note that Funnelback must be installed by an Administrator user on the server.

1. Double click on the Funnelback installer


2. Specify directory where Funnelback will be installed


3. Specify web port for Funnelback's search interface


4. Specify secure (https) web port for Funnelback's search interface


5. Specify admin ui port for Funnelback's search interface


6. Enter Funnelback License Key - Please contact if you do not have a valid license key.


7. Specify Username and Password for initial Administration Account - Additional accounts can be created from the Administration UI.


8. (Optional) Provide mail server details - This step can be skipped and added at a later stage, providing mail server details will allow Funnelback to send email reports when collections are updated.


9. Provide Windows Account details - A valid Windows Account is required to set up Funnelback's initial scheduled tasks and IS NOT stored.


10. (Optional) Download .NET Framework - This step can be skipped and installed at a later stage, the .NET Framework is required for Funnelback to crawl and access TRIM repositories.


11. Installation Complete - You will now be able to access the Funnelback Administration User Interface using the Administration Account details created in Step 4, which will be opened in a Browser Window.



After downloading or copying the Funnelback installer to your server, it can be started from a command line as follows. Note that the Funnelback installer must be run by the root user and that on 64-bit Linux systems the 32-bit compatibility libraries are required to run the Funnelback installer.

chmod +x funnelback-<version information>.run
./funnelback-<version information>.run

Configuring your installation

Funnelback provides a range of configuration options during installation. The following list provides basic information on each of the details the installer may require prior to installation.

Install location

Funnelback settings

Advanced installations

The installer can be run in either "text" (command-line) or "unattended" modes, for systems with no graphical user interface or for automated installations. To run the installer in one of these modes in Linux, run either:

Linux Text Mode Installation

./funnelback-<version information> --mode text
./funnelback-<version information> --mode unattended

Windows Text Mode Installation

funnelback-<version information>-windows-installer.exe --mode text
funnelback-<version information>-windows-installer.exe --mode unattended

For an unattended install, all options must be specified at the first run time for the installer. To get a list of options that can or must be passed to the installer, run:

Linux Installer Help

./funnelback-<version information> --help

Windows Installer Help

 funnelback-<version information>-windows-installer.exe --help

Post installation

After entering all the above details, Funnelback will be installed at the requested location and perform initial configuration. After completing the installation, Funnelback will provide the option to view the Funnelback README file, and the option to open a web browser to the Funnelback administration page (or to the index upgrade page if upgrading from an earlier version of Funnelback).

Note that index upgrades will be performed on an offline copy of the indexes and should not cause any interruption to the search service.

NB: You must ensure that you have upgraded your indexes before trying to perform an instant update on an existing index after upgrading.

Getting started

Once Funnelback is installed, the administration interface can be accessed via a web browser at the url https://hostname:8443/search/admin. Before beginning administration you will be required to accept the server's SSL certificate and provide the administration username and password given during the installation.

Please see the quickstart guide to start learning about Funnelback administration.


See the troubleshooting initial Funnelback installation guide.

Further setup

When Funnelback is initially installed, an embedded web server is installed and configured to start when the server boots. This web server (Jetty) must be used for the Funnelback administration interface and also for the Modern UI, however some further configuration can be performed.

Handling Large Query Volumes

Funnelback installations with large query volumes may need to increase the amount of memory available for processing and displaying query reports. See Query Reports Hardware Requirements and Adjusting Jetty Web Server Memory Usage.