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

Content

List of fixes
Version 11.0.2 Fix Pack 4 provides fixes for the following problems.

For more information about enhancements in Version 11.0.2 Fix Pack 4, and for information about known issues and workarounds, see the Release Notes for Analytical Components at http://www.ibm.com/support/docview.wss?uid=swg27049071 .

For complete information about system requirements and supported hardware and software, see 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/docview.wss?uid=swg27049071 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 4:

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
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.
6. 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 and must be set 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 4:

1. On the master server, log in as the IBM Watson Explorer Content Analytics administrator.
2. At the command prompt, enter "esadmin stop" to stop the system.
3. At the command prompt, enter "stopccl" to stop the Common Communication Layer.
4. At the command prompt, enter "startccl" to restart the Common Communication Layer.
5. Log in as a Windows administrator to install the fix pack.
6. 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 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"

Note: 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.
7. For a multiple server installation, run steps 3 - 6 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.
8. On all servers, log in as the IBM Watson Explorer Content Analytics administrator and enter "startccl" to start the Common Communication Layer.
9. 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 4:

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 stop" to stop the system.
3. At the command prompt, enter "stopccl" to stop the Common Communication Layer.
4. At the command prompt, enter "startccl" to restart the Common Communication Layer.
5. Log in as a Windows administrator to uninstall the fix pack.
6. Change to the %ES_INSTALL_ROOT%\uninstall_11.0.2 directory.
7. Run the command uninstall_11.0.2.exe.
8. The program prompts you to specify what you want to remove:
- Completely delete IBM Watson Explorer Content Analytics
(or)
- Delete program files only. Do not delete the data directory.
Note: 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.
9. The results of the uninstallation program are displayed. Review the information and then click 'Finish'.
10. Restart the server.
11. 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/docview.wss?uid=swg27049071 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 4:

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.
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 and must be set 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 4:

1. On the master server, log in as the IBM Watson Explorer Content Analytics administrator.
2. At the command prompt, enter "esadmin stop" to stop the system.
3. At the command prompt, enter "stopccl.sh" to stop the Common Communication Layer.
4. At the command prompt, enter "startccl.sh" to restart the Common Communication Layer.
5. Log in as the root user to install the fix pack.
6. Enter: ./launchpad.sh. 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 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"

Note: 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.
7. For a multiple server installation, run steps 3 - 6 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.
8. On all servers, log in as the IBM Watson Explorer Content Analytics administrator and enter "startccl.sh" to start the Common Communication Layer.
9. 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 4:

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 stop" to stop the system.
3. At the command prompt, enter "stopccl.sh" to stop the Common Communication Layer.
4. At the command prompt, enter "startccl.sh" to restart the Common Communication Layer.
5. Log in as the root user to uninstall the fix pack.
6. Change to the $ES_INSTALL_ROOT/uninstall_11.0.2 directory.
7. Enter the command ./uninstall_11.0.2.
8. The program prompts you to specify what you want to remove:
- Completely delete IBM Watson Explorer Content Analytics
(or)
- Delete program files only. Do not delete the data directory.
Note: 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.
9. The results of the uninstallation program are displayed. Review the information and then click 'Finish'.
10. Restart the server.
11. 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/docview.wss?uid=swg27049071 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-01.ibm.com/support/docview.wss?uid=swg27049071 before you install the fix pack.

Before you install Version 11.0.2 Fix Pack 4 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.
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 4:

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
(or)
- 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-01.ibm.com/support/docview.wss?uid=swg27049071 for important troubleshooting information. Additional steps are required to avoid crawler errors after you run the uninstallation program.

Watson Explorer Content Analytics Studio

IMPORTANT:
- See the Release Notes for Analytical Components at http://www.ibm.com/support/docview.wss?uid=swg27049071 before you install the fix pack.
- You must install IBM Watson Explorer Content Analytics Studio Version 11.0.2 before you install this fix pack.

Installation instructions for Content Analytics Studio Version 11.0.2 Fix Pack 4:

Watson Explorer Content Analytics Studio 11.0.2 Fix Pack 3 is distributed as an Eclipse update for Watson Explorer Content Analytics Studio 11.0. The update is applied by running the Studio, and using the "Help /Check for updates" menu option.
To install the update, follow the steps below:

1. Start the Studio as described in the options below:
If you installed Watson Explorer Content Analytics Studio 11.0.2 in the "Program Files" or "Program Files (x86)" directory of your computer (this is the default location), then you must run the Studio as Administrator in order to perform the update. Right click the Studio icon on your desktop, and select "Run as administrator".

If you installed Watson Explorer Content Analytics Studio 11.0.2 in any other directory on you computer, then you can start the Studio by opening the Studio icon on your desktop.

2. Enable the update function in the Studio.
Select the "Window / Preferences" menu option.
In the Preferences dialog, select the "General / Capabilities" option in the left hand pane of the dialog. This will display the Capabilities options in the right hand pane.
Select the "Software Updates" checkbox.
Click the OK button.

3. Add the Watson Explorer Content Analytics Studio 11.0.2 Fix Pack 4 zip file to the list of available update sites.
Select the "Window / Preferences" menu option.
In the Preferences dialog, select the "Install/Update / Available Software Sites" option in the left hand pane of the dialog. This will display the Available Software Sites options in the right hand pane.
Click the Add button to add a new site. This displays the Add Site dialog.
Click the Archive button, and use the Repository Archive dialog to locate and select the "11.0.2-WS-WatsonExplorer-AEAnalytical-CAStudio-FP002.zip" file in the computers file system, then click Open.
Click OK on the Add Site dialog.
Click OK in the Preferences dialog.

4. Install the update.
Select the "Help / Check for Updates" menu option.
In the Available Updates dialog, there should be an entry for IBM Watson Explorer Content Analytics Studio Version 11.0.2. Ensure this update is checked, and click Next. If this entry cannot be selected, and an error message is displayed on the dialog, then you should check whether you are running the Studio as Administrator as described in Step 1.
This will display the "Update Details" in the Available Updates dialog. Click Next.
This will display the "Review Licenses" in the Available Updates dialog. Review the terms of the license, and if you agree, click the "I accept the terms of this license agreement", and click Finish.

After processing the files in the update, a Security Warning dialog will be displayed. Click OK.

Once the update has been installed, a "Software Updates" dialog will be displayed asking you to restart the Studio. Click "Yes" to restart the Studio

IMPORTANT:
Once you have installed Watson Explorer Content Analytics Studio 11.0.2 Fix Pack 4, then running the Content Analytics Studio un-installation program will un-install the files installed by the original installation, but will not remove the files installed by the fix pack.