FileNet P8 Content Search Engine, Version 5.0.+            Operating systems:  AIX, HP-UX, Linux, Solaris

Installing IBM Legacy Content Search Engine interactively (UNIX®)

To install IBM® Legacy Content Search Engine interactively, you must run an installation program wizard.

High availability 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:

  1. Verify that you have performed the required preparation tasks as shown in the Plan and Prepare Your Environment for IBM FileNet P8 guide.
  2. Open your completed Installation and Upgrade Worksheet file.
    Tip: In the worksheet file, verify that the Data > Filter > AutoFilter command is enabled. To view only IBM Legacy Content Search Engine values, filter by CSE Installer in the Installation or Configuration Program column.
  3. 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.
  4. 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
  5. 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
  6. Complete the installation program screens by using the values in your worksheet.
    High availability 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.
  7. 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.

  8. 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
  9. Access the host machine and log on as a user with root privileges.
  10. 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
  11. High availability 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.


Feedback

Last updated: November 2010


© Copyright IBM Corporation 2010.
This information center is powered by Eclipse technology. (http://www.eclipse.org)