Installing IBM Text Search for Db2 for z/OS by running silent installation

The text search server administrator installs one or more text search servers. IBM Text Search for Db2 for z/OS uses a silent installation that takes input values from a response file.

Before you begin

Before running the silent installation, verify that the values in the response file are correct.
Tip: As an alternative to this procedure, you can deploy a text search server as a Docker image on certain platforms. For details and instructions, see Deploying IBM Text Search for Db2 for z/OS as Docker images.

About this task

You can install a text search server on a Linux, Windows, or zLinux server. For detailed requirements, see System requirements for installing a text search server.

You can also install fixes without previously installing a text search server from the product DVD or product website. Fixes provide a complete installation of the product.

Tip: Ensure that the text search server automatically starts each time that the operating system reboots by installing the text search server as a service. In service mode, the silent installation includes the scripts for starting and stopping the text search server as part of the operating system's start up and shutdown processes. To install a text search server as a service, the user ID installing the product must be a root user on the Linux or zLinux server, or an administrator on the Windows server. If a user ID without the correct access installs a text search server, you can use the start and stop scripts each time that you want to start or stop the server.

Procedure

To install a text search server, complete the following steps:

  1. Create an installation directory, which is referred to as USER_INSTALL_DIR in these instructions.
    The directory must be empty.
    For example, specify /IBM/TextSearch_DB2 Linux or zLinux systems, or specify C:\Program Files\IBM\TextSearch_DB2 For Windows servers. The USER_INSTALL_DIR directory must be empty.
  2. Download the installation executable from the free download site to a directory other than the USER_INSTALL_DIR directory.
    The following table shows the names of the files for IBM Text Search for Db2 for z/OS. The compressed files contain an installation file, a response file, and the license directory.
    Table 1. File names for IBM Text Search for Db2 for z/OS installation files packages
    Server Fix <version>1 for the latest version Product DVD
    zLinux TS_fixR1L5_.1zlinux.zip TextSearchServer_setupzlinux.zip
    64-bit Linux TS_fixR1L5_linux64.zip TextSearchServer_setuplinux64.zip
    32-bit Linux TS_fixR1L5_linux32.zip TextSearchServer_setuplinux32.zip
    64-bit Windows TS_fixR1L5_win64.zip TextSearchServer_setupwin64.zip
    32-bit Windows TS_fixR1L5_win32.zip TextSearchServer_setupwin32.zip
  3. Before you can extract the compressed files for Linux or zLinux, you must change the permission of the file.
    For example, you might run the following commands.
    chmod 755 TS_fixR1L5.1_linux64.zip
    unzip TS_fixR1L5.1_linux64.zip
  4. Prepare an installation response file named ibmts_response.txt in the same directory where you copied the executable files. Edit the response file by using a text editor, such as VI for Linux and zLinux, or Microsoft Notepad for Windows.
    Example of a partial response file:
    # Specify the following parameters when installing
    # IBM Text Search for DB2 for z/OS for the first time:
    # 
    # LICENSE_ACCEPTED=true
    # USER_INSTALL_DIR
    # IA_ECMTS_SERVER_PORT
    # IA_TOKEN

    If the USER_INSTALL_DIR directory that you specify does not exist, the installation program creates the directory.

    For the IA_ECMTS_SERVER_PORT value, specify a port number that is not already used by other programs on this system or on the z/OS system. A suggested value is “9000”.

    Attention: If you supply a port number that is used by another process, the installation aborts.
  5. Copy the license directory to the same directory where you copied the installation executable file.
  6. Start the installation by entering one of the following commands when positioned on the USER_INSTALL_DIR directory.
    Option Description
    On 32-bit Linux, enter the following command:
    TS_fixR1L5_linux32.bin
    -i silent -f ibmts_response.txt
    On 64-bit Linux, enter the following command:
    TS_fixR1L5_linux64.bin
    -i silent -f ibmts_response.txt
    On zLinux, enter the following command:
    TS_fixR1L5_zlinux.bin
    -i silent -f ibmts_response.txt
    On 32-bit Windows, enter the following command from a command prompt:
    TS_fixR1L5_win32.exe
    -i silent -f ibmts_response.txt
    On 64-bit Windows, enter the following command from a command prompt:
    TS_fixR1L5_win64.exe
    -i silent -f ibmts_response.txt
    To open a command prompt window, click Start > Run, enter ‘cmd', and click OK. The command prompt window opens. Change the directory to USER_INSTALL_DIR.
  7. Verify that the installation was successful by looking at the folders that were created in the USER_INSTALL_DIR directory.
    For example, you should see at least the following folders:
    bin
    config
    InstallerJVM
    Java60
    lib
    license
    log
    MSRedist
    plugins
    resource
    Uninstall_IBMTextSearch
  8. Start the text search server by running the startup script from the USER_INSTALL_DIR directory.
    Option Description
    On Linux or zLinux, enter the following command: bin/startup.sh
    On Windows, enter the following command: bin\startup
  9. Print the authentication token by entering one of the following commands.
    Option Description
    On Linux or zLinux, enter the following command:
    bin/configTool.sh printToken 
    -configPath USER_INSTALL_DIR/config 
    On Windows, enter the following command:
    bin\configTool printToken 
    -configPath USER_INSTALL_DIR\config
    Note: If the value for -configPath contains blanks, you must enclose the value in quotation marks.

    You must insert the case-sensitive information that is collected during the installation into a Db2 administration table later. This information is the authentication token, the encryption key, the port number, and the IP name or address of the text search server.

What to do next

Next, you can configure and customize the server properties by using the Configuration Tool.