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.
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:
-
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.
-
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 |
-
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
- 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.
- Copy the license directory to the same directory where
you copied the installation executable file.
-
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 , enter ‘cmd', and click OK. The command
prompt window opens. Change the directory to USER_INSTALL_DIR.
-
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
- 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 |
- 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.