To install IBM® Legacy
Content Search Engine interactively,
you must run an installation program wizard.
Note: If you are installing
IBM Legacy
Content Search Engine in a high availability
environment, you must run the
IBM Legacy
Content Search Engine installer
on each node, selecting a shared cluster directory as the
IBM Legacy
Content Search Engine installation path. Verify
that your cluster is running before starting the installation procedure.
To install IBM Legacy
Content Search Engine interactively:
- Verify that you have performed the required preparation
tasks as shown in the Plan and Prepare Your Environment for IBM FileNet P8 guide.
- Open your completed Installation
and Upgrade Worksheet file.
Tip: In the worksheet
file, verify that the command is enabled. To view only IBM Legacy
Content Search Engine values, filter by CSE
Installer in the Installation or Configuration
Program column.
- Log on to the host machine
as k2_os_user.
Important: Most
processes for the Autonomy K2 software will run as k2_os_user.
However, the vspget process must run as root.
- Set the following environment
variable and place the entry in the .profile file for
k2_os_user.
JAVA_HOME=java_(JDK)_install_path/jdkversion
export JAVA_HOME
- Access the IBM FileNet® P8 IBM Legacy
Content Search Engine installation package
and run the installation program.
Platform |
Command |
AIX® |
5.0.0-P8CSE-AIX.BIN |
HPUX |
5.0.0-P8CSE-HPUX.BIN |
Solaris |
5.0.0-P8CSE-SOL.BIN |
Linux® |
5.0.0-P8CSE-LINUX.BIN |
- Complete the installation program screens by using the
values in your worksheet.

In a highly
available environment, use the following additional information:
- Use the shared binary location as installation location (verity_install_path).
This might either be a local shared cluster disk or a highly available
shared storage location.
- In the Select Autonomy K2 Server Type screen,
select Master Administration Server.
- In the Specify Master Administration Server Information screen,
use the host name of the cluster rather than the host name of the
local cluster node.
- When the installer has finished, K2 will be running. Stop the
application by running the k2adminstop command
before failing to another node.
- Review the following IBM Legacy
Content Search Engine log files for installation
errors. The files are located in the verity directory
of the install path:
- verity_install_path/cse_install_log_5.0.0.log
- verity_install_path/vconfig.log
It is a best practice to review log files even if the IBM Legacy
Content Search Engine installation program
does not indicate any errors. Some errors noted in the log files are
benign. If an error is not benign (that is, you cannot subsequently
index or search for documents), refer to the log file for help in
determining the cause.
- In the .profile file
for k2_os_user, set the PATH , SHLIB_PATH, LIBPATH,
and LD_LIBRARY_PATH environment variables (depending
on your operating system), each on its own line, without line breaks.
Important: If
your
.profile file has a line containing
set
-u that appears before the lines involving
PATH ,
SHLIB_PATH,
LIBPATH,
or
LD_LIBRARY_PATH, you must do one of the following
edits before setting the environment variables:
- Remove the line containing set -u from the .profile file.
- Move the line containing set -u to a point in
the .profile file below the lines involving PATH, SHLIB_PATH, LIBPATH,
or LD_LIBRARY_PATH.
- AIX
PATH=$PATH:verity_install_path/k2/_rs6k43/bin
export PATH
LIBPATH=$LIBPATH:verity_install_path/k2/_rs6k43/bin
export LIBPATH
- HP-UX
PATH=$PATH:verity_install_path/k2/_hpux/bin
export PATH
SHLIB_PATH=$SHLIB_PATH:verity_install_path/k2/_hpux/bin
export SHLIB_PATH
- Linux
PATH=$PATH:verity_install_path/k2/_ilnx21/bin
export PATH
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:verity_install_path/k2/_ilnx21/bin
export LD_LIBRARY_PATH
- Solaris
PATH=$PATH:verity_install_path/k2/_ssol26/bin
export PATH
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:verity_install_path/k2/_ssol26/bin
export LD_LIBRARY_PATH
- Access the host machine
and log on as a user with root privileges.
- Enter the following commands
to set the setuid bit for the vspget program so that the service runs
as root:
chown root verity_install_path/k2/_platform/bin/vspget
chmod u+s verity_install_path/k2/_platform/bin/vspget
Replace
_platform with the following directory:
Platform |
Directory |
AIX |
_rs6k43 |
HPUX |
_hpux |
Solaris |
_ssol26 |
Linux |
_ilnx21 |
If you are installing in a highly available
environment, fail over to another node and repeat the install process
with the same parameters until you have installed IBM Legacy
Content Search Engine on all nodes.