Instructions for IBM OmniFind Analytics Edition, Version 8.4.1 Hot Fix 1
----------------------------------------------------------------------------------

Version 8.4.1 Hot Fix 1 addresses the following defects: 
---------------------------------------------------------------

d28394: Handling of text which consists of only upper case words
A POS (Part Of Speech) tag is not assigned correctly when a word is composed of only upper case characters.

d28474: Report function fails when Security Role is used on WebSphere Application Server.

d28395: Long space sequence causes stack overflow in Java regex matcher

d28426: Index creation in parallel
This fix improves the processing time to create an OmniFind Analytics Edition (OAE) index by running the process in parallel. 

d28396: Fix of handling of OmniFind Enterprise Edition (OEE) Metadata
This fix improves mapping capability between OEE metadata and OAE metadata. In addition to the fixed set of metadata, you can map any OEE fields to OAE categories. It also allows you to choose the mapping target category for each OEE metadata or field.
Refer to metadata_mapping.html

Installation instructions for Windows(R):
-----------------------------------------
IMPORTANT: You must stop the application server completely before starting the installation process.

Before you install Version 8.4.1 Hot Fix 1:

1. Ensure that Version 8.4.1 has been installed.

2. Reserve the backup files.
  2.1 Create a new directory, e.g. %TAKMI_HOME%\backup, to store the files which are to be replaced with this fix for their backups.
  2.2 Copy the following directories to this backup directory
      - %TAKMI_HOME%\lib
      - %TAKMI_HOME%\resource
      - %TAKMI_HOME%\ear
      - %TAKMI_HOME%\pear
      - %TAKMI_HOME%\uima\lib 
      - %TAKMI_HOME%\uima\components\talent\lib
      - %TAKMI_HOME%\uima\components\jsa
      - %TAKMI_HOME%\uima\components\TAKMI_NLP


Installing Version 8.4.1 Hot Fix 1:
1. Ensure the backup files mentioned above have been copied.
2. Unzip OAE_8_4_1_HotFix1.zip to an appropriate directory, e.g. %TAKMI_HOME%HotFix1.
3. Copy all files under lib directory of the HotFix1 directory to %TAKMI_HOME%\lib directory.
4. Copy all files under resource directory of the HotFix1 directory to %TAKMI_HOME%\resource directory.
5. Copy all files under ear directory of the HotFix1 directory to %TAKMI_HOME%\ear directory.
6. Copy NLP_PACK_en.pear and <platform>\NLP_PACK_ja.pear under pear directory of the HotFix1 directory to %TAKMI_HOME%\pear directory. <platform> is either aix, win or linux.
7. Copy all files under uima\lib directory of the HotFix1 directory to %TAKMI_HOME%\uima\lib directory.
8. Copy uima\components\talent\lib\Tagger20.jar of the HotFix1 directory to %TAKMI_HOME%\uima\components\talent\lib directory.
9. Copy all directories under uima\components\jsa\<platform> directory of the HotFix1 directory to %TAKMI_HOME%\uima\components\jsa directory.  <platform> is either aix, win, or linux.
10. Copy all directories under uima\components\TAKMI_NLP directory of the HotFix1 directory to %TAKMI_HOME%\uima\components\TAKMI_NLP directory.
11. Update the database_config.xml file of all databases.
  11.1. Add index_file_merger_entry tag which has "com.ibm.takmi.impl.std.idx.keyid.KeyIdIndexFileMerger" as the name attribute to the 1st element of the index_file_merger_entries tag as follows.

    <index_file_merger_entries>
      <index_file_merger_entry name="com.ibm.takmi.impl.std.idx.keyid.KeyIdIndexFileMerger"/>
      <index_file_merger_entry name="com.ibm.takmi.impl.std.idx.cattodoc.CatToDocIndexFileMerger"/>
      ....
    </index_file_merger_entries>

  11.2. Add index_group_merger_entry tag which has "com.ibm.takmi.impl.std.idx.keyid.KeyIdIndexGroupMerger" as the name attribute to the 1st element of the index_group_merger_entries tag as follows.

    <index_group_merger_entries>
      <index_group_merger_entry name="com.ibm.takmi.impl.std.idx.keyid.KeyIdIndexGroupMerger"/>
      <index_group_merger_entry name="com.ibm.takmi.impl.std.idx.cattodoc.CatToDocIndexGroupMerger"/>
      ....
    </index_group_merger_entries>

12. Recreate the index of all databases.
13. Start the application server
14. In %TAKMI_HOME%\ear directory, run the command appropriate for your operating environment:
    Windows: 
       C:\Program Files\IBM\WebSphere\AppServer\bin\wsadmin.bat -f .\TAKMI.jacl
    AIX or Linux
       /usr/IBM/WebSphere/AppServer/bin/wsadmin.sh -f ./TAKMI.jacl
15. Restart the application server