Installing Db2 Accessories Suite for Db2 Text Search

The Rich Text Filter (RTF) in theDb2 Accessories Suite enables indexing and search for documents with rich text and proprietary formats with Db2 Text Search. You can start a new install or run the install on top of an existing installation.

Before you begin

Note: To install the stand-alone Db2 text search server, refer to Installing a stand-alone Db2 Text Search server.
To install the Rich Text Filter (RTF) in the Db2 Accessories Suite on Linux® and UNIX, you need to logged on to the Db2 server as a system administrator. On Windows, you must logon as a user with Local Administrator authority.

Download the RTF. For the download link, see: https://www.ibm.com/services/forms/preLogin.do?source=swg-dm-db2accsuite. Install the most up-to-date version of the RTF release or fix pack to ensure proper functioning of the feature.

Ensure the installer file, the license file, and the release info file are in the same directory.

On Windows, please install Visual C++ Redistributable for Visual Studio 2012 available at https://www.microsoft.com/en-us/download/details.aspx?id=30679, or the text extractor in the RTF will fail to run due to lack of the proper version of VC++ runtime support.

Procedure

To install the RTF:

  1. Stop the Db2 Text Search instance service.
    To stop the service, issue the db2ts STOP FOR TEXT command.
  2. Log on to the Db2 database server as a user with the necessary permissions which have writing privilege in Db2 Text Search installation directory, for example, on Linux platform, the directory locates under <DB2PATH>/db2tss directory, where <DB2PATH> represents the Db2 database server installation directory
  3. There are two installation modes. One option is console installation, while the other is silent installation.
    • Option 1 is to complete a console install:
      1. Run the RTF installer.
        • To install on Linux and UNIX, run the richtextfilter<version>.bin installer from the command line. Where <version> denotes the latest version for the platform.
        • To install on Windows, you can do one of the following options:
          • Run the installer richtextfilter<version>.exe from the command window
          • Double click the richtextfilter<version>.exe file.
      2. After accepting the license, enter the location of the db2tss subdirectory in the Db2 instance directory when prompted for the install path.
      3. The db2tss directory must already exist. If it is missing, Db2 Text Search has not been properly installed and configured.
      4. Review the summary and confirm the installation.
    • Option 2 is to complete a silent install:
      1. Create a response file named installer.properties with the following content:
        LICENSE_ACCEPTED=TRUE
        #Choose DB2 Text Search Install Path
        #Notice: Use double backslashes as path separator on Windows
        #--------------------------------------------------------------
        USER_INSTALL_DIR=<DB2PATH>/db2tss

        where <DB2PATH> is the path to the db2tss directory. This directory is commonly the instance directory.

      2. Save the file to the same directory as the installer (.bin or .exe) file.
      3. Run the accessories suite filter installer with silent model.
        • Run the richtextfilter<version>.bin -i silent -f installer.properties command from the command line on Linux and UNIX platforms.
        • Run the richtextfilter<version>.exe -i silent -f installer.properties command from the command window on the Windows platform.

Results

You have successfully installed the RTF.

What to do next

You can now enable rich text document support for Db2 Text Search. See, Enabling Db2 Text Search for rich text document support for more details.