IBM Content Analytics with Enterprise Search, Version 3.0.0                  

Starting and stopping the information center

The information center must be available before you can use the online help.

The information center contains the documentation for IBM® Content Analytics with Enterprise Search.

Typically, the information center is started when the IBM Content Analytics with Enterprise Search system is started. The esadmin system startall command starts the Web server and the information center when it starts the server components. Use the commands in this procedure if you need to stop and start the information center without stopping and restarting other system components. For example:
  • If the information center does not start when you start the system or when you attempt to start it from the First Steps application, determine whether there is a conflict with the default information center port, 8889. If port 8889 is used by another process, you must edit the information center startup script to specify a different port and then start the information center.
  • If you click Help in the administration console or an application, and no help is displayed, you might need to remove unnecessary configuration files and restart the information center.

For a multiple server installation, the information center is installed on all search servers, so you must stop and start the information center on all search servers.

The commands in this procedure use ES_INSTALL_ROOT to represent the product installation directory. The default installation paths are:
  • AIX®: /usr/IBM/es
  • Linux: opt/IBM/es
  • Windows: C:\Program Files\IBM\es

Complete the following steps to stop and restart the information center. In a multiple server installation, do these steps on all search servers:

  1. If the information center does not start when you start the IBM Content Analytics with Enterprise Search system or when you attempt to start it from the First Steps application, ensure that the port that is used by the information center is not used by another process.
    1. Edit the following file:
      AIX or Linux,
      $ES_INSTALL_ROOT/ibm_help/IC_start.sh
      Windows
      %ES_INSTALL_ROOT%\ibm_help\IC_start.bat
    2. Change the -port parameter from 8889 to a port that is not in use, such as 9889.
    3. Edit the following line in the ES_INSTALL_ROOT/nodeinfo/es.cfg file to specify the same port number. For example:
      DB2ICDocs4ES=http\://host_name\:9889/help/topic
    4. Go to step 3 to start the information center.
  2. If help is not displayed when you click Help, you might need to do the following steps:
    1. Enter the following commands to stop the information center:
      AIX or Linux,

      cd $ES_INSTALL_ROOT/ibm_help
      ./IC_end.sh

      Windows

      cd %ES_INSTALL_ROOT%\ibm_help
      IC_end.bat

    2. Remove all the files from the ES_INSTALL_ROOT/ibm_help/eclipse/configuration directory except for the config.ini file.
    3. Go to step 3 to start the information center.
  3. Enter the following command to start the information center. You do not see a confirmation message after the information center is started.
    AIX or Linux
    You can start the information center so that it runs in the background:

    cd $ES_INSTALL_ROOT/ibm_help
    /bin/nohup ./IC_start.sh &

    Windows

    cd %ES_INSTALL_ROOT%\ibm_help
    IC_start.bat

  4. To test that the information center is started, open a Web browser and go to the following URL, where port is the port specified in the startup script for the information center:

    http://localhost:port

Troubleshooting:
On Windows, you might see the following errors when you attempt to start the system with the First Steps program:
FFQC5387W The information center on the search server cannot be accessed. 
The information center on {search_server} is not running. 
FFQC5395E One or more of the required system services are not running.
Review the error and warning messages to see which services are not started and to learn more about the problem. For additional information, see the log file %ES_NODE_ROOT%\logs\trace\startstatus.log. In most cases, you must follow the preceding procedure to start the information center from the command line.

Feedback

Last updated: May 2012

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