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.

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

1. Create an empty installation directory, which is referred to as USER_INSTALL_DIR in these instructions.

   Server	Example directory
   Linux or Linux on IBM Z	/IBM/TextSearch_DB2
   Windows	C:\Program Files\IBM\TextSearch_DB2

2. Download the installation executable from IBM Text Search for Db2 for z/OS downloads 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
   Linux on IBM Z	TS_fixR5L5.12_zlinux.zip	TextSearchServer_setupzlinux.zip
   Linux	TS_fixR5L5.12_linux64.zip	TextSearchServer_setuplinux64.zip
   Windows	TS_fixR5L5.12_win64.zip	TextSearchServer_setupwin64.zip

3. Before you can extract the compressed files for Linux or Linux on IBM Z, you must change the permission of the file.
   For example, you might run the following commands.

   chmod 755 TS_fixR5L5.12_linux64.zip
   unzip TS_fixR5L5.12_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 Linux on IBM Z, 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 64-bit Linux, enter the following command:	TS_fixR5L5.12_linux64.bin -i silent -f ibmts_response.txt
   On Linux on IBM Z, enter the following command:	TS_fixR5L5.12_zlinux.bin -i silent -f ibmts_response.txt
   On 64-bit Windows, enter the following command from a command prompt:	TS_fixR5L5.12_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 Linux on IBM Z, 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 Linux on IBM Z, 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

Configure the text search server and Db2 for z/OS by completing the following tasks:

1. Configure the IBM Text Search for Db2 for z/OS server.
2. Start the text search server.
3. Enable Db2 for z/OS for text search.