IBM Watson Explorer Analytical Components, Version 11.0.2 Fix Pack 9 Readme

Content

For more information about enhancements in Version 11.0.2 Fix Pack 9, and for information about known issues and workarounds, see the Release Notes for Analytical Components at http://www.ibm.com/support/pages/node/713205.

For complete information about system requirements and supported hardware and software, see http://www.ibm.com/support/docview.wss?uid=swg27048897 .

Installation instructions for Windows

IMPORTANT:

• See the Release Notes for Analytical Components at http://www.ibm.com/support/pages/node/713205 before you install the fix pack.
• If you are upgrading a multiple server system that uses WebSphere Application Server or WebSphere Application Server Network Deployment, additional steps are required before you run the fix pack installation process. Details are in the release notes.
• You must stop the IBM Watson Explorer Content Analytics system completely, including the First Steps program, before starting the fix pack installation process.

Before you install Version 11.0.2 Fix Pack 9:

1. Ensure that Version 11.0.2 is installed on the servers.
   The value of a variable called VRCF in the %ES_INSTALL_ROOT%\nodeinfo\bldinfo.txt file should be 11.0.2.x. (any lower version than 11.0.2.9)
2. Ensure that at least 4 GB of temporary disk space is available on the disk that is hosting the temporary directory for the installation program. This temporary disk space is required to unpack the image before the product is installed. The temporary directory can be determined by checking the value of the TEMP environment variable.
3. Ensure that at least 4 GB of free disk space is available on the disk that hosts the %ES_INSTALL_ROOT% directory.
4. If you use WebSphere Application Server, ensure that at least 100 MB of free disk space is available on the disk that hosts the /wstemp directory.
5. Run the esbackup command to back up the IBM Watson Explorer Content Analytics system before you install the fix pack.
   Installation of the fix pack replaces the following files, including all files in subdirectories of these paths:
   • %ES_INSTALL_ROOT%\nodeinfo
   • %ES_INSTALL_ROOT%\installedApps (if WebSphere Application Server is used)
   • %ES_INSTALL_ROOT%\wlpapps
   • %ES_INSTALL_ROOT%\configurations

Installing Version 11.0.2 Fix Pack 9:

1. On the master server, log in as the IBM Watson Explorer Content Analytics administrator.
2. At the command prompt, enter "esadmin system stop" to stop the system.
3. At the command prompt, enter "stopccl" to stop the Common Communication Layer.
4. Log in as a Windows administrator to install the fix pack.
5. Double-click the launchpad.exe file or enter launchpad.exe in a command window. Click Install Product and then launch the installation program. The installation program prompts you for the "data directory" of the current installation. Be sure to specify the correct value for the %ES_NODE_ROOT% directory.
   As an alternative, you can use one of the following methods to run the installation program:
   • Console installation
     To run the installation program in text mode from a console, change to the Main directory and enter the following command. The screens are rendered in text and prompt you for the same information as the graphical installation:
     install.exe -i console
     Tip: After you enter the command, a process runs in the background for a number of seconds before the console installation program is displayed.
   • Silent installation
     To install the product silently, change to the Main/responseFiles directory and edit the WindowsUpdateInstall.properties template response file to provide information about your environment.
     To run the installation program, change to the Main directory and specify the name of the file that you edited. For example:
     install.exe -i silent -f responseFiles/WindowsUpdateInstall.properties
     
     If you copy a template file to another location to edit, specify the fully qualified path for the file when you run the installation program. If the response file path includes a space, enclose the path in double quotation marks ("). For example:
     install.exe -i silent -f "c:\My Documents\WindowsUpdateInstall.properties"
6. For a multiple server installation, run steps 2 - 5 on all servers.
   Note: If you use WebSphere Application Server and security is enabled on the search servers, the program prompts you for the WebSphere Application Server global security user ID and password.
7. On all servers, log in as the IBM Watson Explorer Content Analytics administrator and enter "startccl" to start the Common Communication Layer.
8. On the master server, enter "esadmin system startall" to start the IBM Watson Explorer Content Analytics system.
   Note: If you use WebSphere Application Server, after the search servers are restarted, ensure that the application servers 'server1' and 'ESSearchServer' are running in WebSphere Application Server.

After you install Version 11.0.2 Fix Pack 9:

Run the crawler setup scripts again to set up crawler-related configuration files. The scripts make required changes on configuration files that are overwritten during installation.

Uninstallation instructions for Windows:

1. On the master server, log in as the IBM Watson Explorer Content Analytics administrator.
2. At the command prompt, enter "esadmin system stop" to stop the system.
3. At the command prompt, enter "stopccl" to stop the Common Communication Layer.
4. Log in as a Windows administrator to uninstall the fix pack.
5. Change to the %ES_INSTALL_ROOT%\uninstall_11.0.2 directory.
6. Run the command uninstall_11.0.2.exe.
7. The program prompts you to specify what you want to remove. If you use WebSphere Application Server and security is enabled on a search server, the program prompts you for the WebSphere Application Server global security user ID and password.
   • Completely delete IBM Watson Explorer Content Analytics
   • Delete program files only. Do not delete the data directory.
8. The results of the uninstallation program are displayed. Review the information and then click 'Finish'.
9. Restart the server.
10. For a multiple server installation, repeat these steps on the other servers.

Installation instructions for AIX and Linux

IMPORTANT:

• See the Release Notes for Analytical Components at http://www.ibm.com/support/pages/node/713205 before you install the fix pack.
• If you are upgrading a multiple server system that uses WebSphere Application Server or WebSphere Application Server Network Deployment, additional steps are required before you run the fix pack installation process. Details are in the release notes.
• You must stop the IBM Watson Explorer Content Analytics system completely, including the First Steps program, before starting the fix pack installation process.

Before you install Version 11.0.2 Fix Pack 9:

1. For graphical installation, ensure the X Windows system is configured and an environment parameter DISPLAY is set. (For example: export DISPLAY=:0.0 )
2. Ensure that Version 11.0.2 is installed on the servers.
   The value of a variable called VRCF in the $ES_INSTALL_ROOT/nodeinfo/bldinfo.txt file should be 11.0.2.x. (any lower version than 11.0.2.9)
3. Ensure that at least 4 GB of temporary disk space is available on the disk where the /tmp directory is mounted. The temporary disk space is required to unpack the image before the product is installed.
4. Ensure that at least 4 GB of free disk space is available on the disk that hosts the $ES_INSTALL_ROOT directory.
5. If you use WebSphere Application Server, ensure that at least 100 MB of free disk space is available on the disk that hosts the /wstemp directory.
6. Run the esbackup command to back up the IBM Watson Explorer Content Analytics system before you install the fix pack.
7. Installation of the fix pack replaces the following files, including all files in subdirectories of these paths:
   • $ES_INSTALL_ROOT/nodeinfo
   • $ES_INSTALL_ROOT/installedApps (if WebSphere Application Server is used)
   • $ES_INSTALL_ROOT/wlpapps
   • $ES_INSTALL_ROOT/configurations

All changes you made to these files will be overwritten so you must set them again.
If you updated any of these files, ensure that you have a backup copy of the files and then apply the same changes to the files after you install this fix pack.

Installing Version 11.0.2 Fix Pack 9:

1. On the master server, log in as the IBM Watson Explorer Content Analytics administrator.
2. At the command prompt, enter "esadmin system stop" to stop the system.
3. At the command prompt, enter "stopccl.sh" to stop the Common Communication Layer.
4. Log in as the root user to install the fix pack.
5. Enter: ./launchpad.sh.
   Click Install Product and then launch the installation program. The installation program prompts you for the "data directory" of the current installation. Be sure to specify the correct value for the $ES_NODE_ROOT directory.
   As an alternative, you can use one of the following methods to run the installation program:
   • Console installation
     To run the installation program in text mode from a console, change to the Main directory and enter the following command. The screens are rendered in text and prompt you for the same information as the graphical installation:
     ./install.bin -i console
     Tip: After you enter the command, a process runs in the background for a number of seconds before the console installation program is displayed.
   • Silent installation
     To install the product silently, change to the Main/responseFiles directory and edit the AIXUpdateInstall.properties or LinuxUpdateInstall.properties template response file to provide information about your environment.
     To run the installation program, change to the Main directory and specify the name of the file that you edited. For example:
     ./install.bin -i silent -f ./responseFiles/AIXUpdateInstall.properties
     or
     ./install.bin -i silent -f ./responseFiles/LinuxUpdateInstall.properties
     
     If you copy a template file to another location to edit, specify the fully qualified path for the file when you run the installation program. If the response file path includes a space, enclose the path in double quotation marks ("). For example:
     ./install.bin -i silent -f "/home/response files/AIXUpdateInstall.properties"
     or
     ./install.bin -i silent -f "/home/response files/LinuxUpdateInstall.properties"
6. For a multiple server installation, run steps 2 - 5 on all servers.
   Note: If you use WebSphere Application Server and security is enabled on the search servers, the program prompts you for the WebSphere Application Server global security user ID and password.
7. On all servers, log in as the IBM Watson Explorer Content Analytics administrator and enter "startccl.sh" to start the Common Communication Layer.
8. On the master server, enter "esadmin system startall" to start the IBM Watson Explorer Content Analytics system.
   Note: If you use WebSphere Application Server, after the search servers are restarted, ensure that the application servers 'server1' and 'ESSearchServer' are running in WebSphere Application Server.

After you install Version 11.0.2 Fix Pack 9:

Run the crawler setup scripts again to set up crawler-related configuration files. The scripts make required changes on configuration files that are overwritten during installation.

Uninstallation instructions for AIX and Linux:

1. On the master server, log in as the IBM Watson Explorer Content Analytics administrator.
2. At the command prompt, enter "esadmin system stop" to stop the system.
3. At the command prompt, enter "stopccl.sh" to stop the Common Communication Layer.
4. Log in as the root user to uninstall the fix pack.
5. Change to the $ES_INSTALL_ROOT/uninstall_11.0.2 directory.
6. Enter the command ./uninstall_11.0.2.
7. The program prompts you to specify what you want to remove.
   If you use WebSphere Application Server and security is enabled on a search server, the program prompts you for the WebSphere Application Server global security user ID and password.
   • Completely delete IBM Watson Explorer Content Analytics
   • Delete program files only. Do not delete the data directory.
8. The results of the uninstallation program are displayed. Review the information and then click 'Finish'.
9. Restart the server.
10. For a multiple server installation, repeat these steps on the other servers.

Troubleshooting uninstallation:
If you uninstall Version 11.0.2, see the Release Notes at http://www.ibm.com/support/pages/node/713205 for important troubleshooting information.

Issues include:

• Steps to remove Version 11.0.2 in a WebSphere Application Server environment.
• The inability to revert to Version 11.0.0.0 in a PowerLinux BE environment.
• Crawler errors if you uninstall the Agent for Windows File Systems Version 11.0.2.
• The need to rename JVM directories after you run the uninstall program.

Installation instructions for the Agent for Windows File Systems

IMPORTANT:

• See the Release Notes for Analytical Components at http://www.ibm.com/support/pages/node/713205 before you install the fix pack.

Before you install Version 11.0.2 Fix Pack 9 for IBM Watson Explorer Content Analytics Agent for Windows File Systems:

1. Ensure that Version 11.0.2 is installed on the servers.
   The value of a variable called VRCF in the %ES_AGENT_INSTALL_ROOT%\bldinfo.txt file should be 11.0.2.x. (any lower version than 11.0.2.9)
2. Ensure that at least 300 MB of temporary disk space is available on the disk that is hosting the temporary directory for the installation program. This temporary disk space is required to unpack the image before the product is installed. The temporary directory can be determined by checking the value of the TEMP environment variable.
3. Ensure that at least 300 MB of free disk space is available on the disk that hosts the %ES_AGENT_INSTALL_ROOT% directory.

Installing Version 11.0.2 Fix Pack 9:

1. Log in as a Windows administrator to install the fix pack.
2. Double-click the launchpad.exe file or enter launchpad.exe in a command window. Click Install Product and then launch the installation program.
   As an alternative, you can use one of the following methods to run the installation program:
   • Console installation
     To run the installation program in text mode from a console, change to the Agent directory and enter the following command. The screens are rendered in text and prompt you for the same information as the graphical installation:
     install.exe -i console
     Tip: After you enter the command, a process runs in the background for a number of seconds before the console installation program is displayed.
   • Silent installation
     To install the product silently, change to the Agent/responseFiles directory and edit the DistributedUpdateInstaller.properties template response file to provide information about your environment.
     To run the installation program, change to the Agent directory and specify the name of the file that you edited. For example:
     install.exe -i silent -f responseFiles/DistributedUpdateInstaller.properties
     
     If you copy a template file to another location to edit, specify the fully qualified path for the file when you run the installation program. If the response file path includes a space, enclose the path in double quotation marks ("). For example:
     install.exe -i silent -f "c:\My Documents\DistributedUpdateInstaller.properties"
3. Enter "esagent start" to start the Agent server.

Uninstallation instructions for Agent for Windows File Systems:

1. On the index server, log in as the IBM Watson Explorer Content Analytics administrator.
2. Change to the %ES_INSTALL_ROOT%\uninstall_11.0.2 directory.
3. Run the command uninstall_11.0.2.exe.
4. The program prompts you to specify what you want to remove:
   • Completely delete Agent for Windows File Systems
   • Delete program files only. Do not delete the data directory.
5. The results of the uninstallation program are displayed. Review the information and then click 'Finish'.
6. Restart the server.

Troubleshooting uninstallation:
If you uninstall Version 11.0.2, see the Release Notes at http://www.ibm.com/support/pages/node/713205 for important troubleshooting information. Additional steps are required to avoid crawler errors after you run the uninstallation program.