IBM FileNet Image Services Resource Adapter - ISRA 3.4 Fix pack 7 Readme
© Copyright IBM Corporation 2008, 2013. All Rights Reserved.

Readme file for: IBM FileNet Image Services Resource Adapter

Product/Component Release: 3.4

Update Name: Fixpack 7

Fix ID: 3.4.0.007

Publication Date: 24 July 2013

Last modified date: 10 July 2012  

Online version of the readme file: http://www-933.ibm.com/eserver/support/fixes/fixcentral

Important: The most current version of the readme file can always be found online.

 

Note: You require an IBM ID and password to access the link above.
Important: The most current version of the readme file can always be found online
.

Contents

Download location

Prerequisites and co-requisites

Fix Pack Description

Known Issues

Instructions for using SWG Tags

Installation Information

How to Install the Fix Pack

BEA WebLogic 9.0/9.1/10.3/11g
IBM WebSphere 6.0.2/6.1/7.0/8.0/8.5

Recommendations for WebSphere users

JBoss 4.0.x/4.2.3/5.1/6.1
Oracle Application Server 10g (9.0.4) and 10g Release 3 (10.1.3)
Sun Java System Application Server 8.1/8.2/9.0

How to Deploy ISRA.rar

How to Deploy FileNetImageViewer

How to Check Build of Installed ImageViewer

How to Deploy ISRA Console

 

In this Fixpack

List of fixes

New Features

 

General Information

General Notes

ISRA Support

Contact Customer Support

Copyright and trademark information

Notices and trademarks

Document change history

 

Download location

 

Download ISRA 3.4 Fix pack 7 from the following location: http://www-933.ibm.com/eserver/support/fixes/fixcentral

Prerequisites and co-requisites

 

ISRA 3.4 GA

Fix Pack Description

The fix pack released would contain:

A self extracting executable called ISRA_fixpack_3_4_0_7.exe specific for Microsoft Windows Operating Environment, which extracts to

o        ISRA.jar

o        ISRA.rar

o        ISRAConsole.ear

o        FNImageViewer.ear  

An archive called ISRA_fixpack_3_4_0_7.tar specific for UNIX and LINUX flavors, which extracts to

o        ISRA.jar

o        ISRA.rar

o        ISRAConsole.ear

o        FNImageViewer.ear

Readme.html

ReleaseNotes.html

SWGTag.zip

The description of each file is as follows:

 

ISRA.rar which contains the Image Services Resource Adapter has the following structure:

    RAR file--
                    |
                    |---ISRA.jar
                    |---META-INF--
                                                |---MANIFEST.MF
                                                |---ra.xml

FNImageViewer.ear, which contains the latest build (Build# 4.0.38) of IBM FileNet ImageViewer for ISRA has the following structure:

    EAR file--
                    |
                    |---FNImageViewer.war
                    |---META-INF--
                                                |---MANIFEST.MF
                                                |---application.xml

ISRAConsole.ear contains the ISRA Sample Application 3.4 Fix pack 7 (with Annot.xsl Version: 400002) and ISRAConsole :

    EAR file--
                    |---ISRAConsole.war
                    |---ISRASampleWEB.war
                    |---META-INF--
                                                |---MANIFEST.MF
                                                |---application.xml

 

ISRA.jar contains updated ISRA class files

 

SWGTag.zip contains a folder called  "version" contiaining two files in the following order and name:

   

SWGTag.zip--

                           |--properties--   

                                                 |--version--

                                                                  |--IBM_FileNet_Image_Services_Resource_Adaptor.3.4.0.swtag

                                                                  |--ISRA-3.4.0.07-3.4.0.07.fxtag

Known Issues

Changing Password in a clustered environment

If ISRA is running in a clustered environment, it is necessary to restart the cluster if any updates to the user’s password are made.

FileNet ImageViewer related issues: Annotations Support

ISRA supports only those annotations that are supported by FileNet Image Services. Please read the FileNet Image Services documentation for a list of annotations supported by the Image Services.  

Instructions for using SWG Tags

 

Extract or Unzip the file SWGTag.zip file to the ISRA home location such that you shall find the properties directory with in the ISRA home location, with the two tag files as shown below -
For Windows
            C:\ISRA\properties\version\IBM_FileNet_Image_Services_Resource_Adaptor.3.4.0.swtag
            and
            C:\ISRA\properties\version\ISRA-3.4.0.07-3.4.0.07.fxtag
For UNIX / LINUX
            /fnsw/ISRA/properties/version/IBM_FileNet_Image_Services_Resource_Adaptor.3.4.0.swtag
            and
            /fnsw/ISRA/properties/version/ISRA-3.4.0.07-3.4.0.07.fxtag

How to Install the Fix Pack

Before proceeding with the installation process, view the online version of the readme file to check if information has changed since the readme file download:

http://www-933.ibm.com/eserver/support/fixes/fixcentral

Note: Please follow the instructions below if you have deployed ISRA 3.4 Fix pack 2 1F1 or above. Otherwise, please refer How to deploy ISRA.rar.

On BEA WebLogic 9.0/9.1/10.3/11g

 

For IBM AIX, Sun Solaris, HP-UX, Red Hat Linux AS 4.0/5.0/6.0

 

Fix Pack Layout

 

This fix pack file consists of a tar file named 'ISRA_fixpack_3_4_0_7.tar'.The layout of this fix pack is as follows:

 

FileName

Description

/ISRA.rar

    ISRA.rar with updated ISRA.jar and ra.xml

/ISRA.jar

    ISRA jar with updated class files

/FNImageViewer.ear

    FileNetImageViewer with build 4.0.38 (contains an updated VeriSign certificate)

/ISRASample.ear

    ISRA Sample Application containing modified Annot.xsl

Installation Instructions

 

Extract tar file using "tar -xvf ISRA_fixpack_3_4_0_7.tar" command in /fnsw/ISRA/fixpack7 directory.

 

Single Resource Adapter:

 

BEA Weblogic 9.0/9.1/10.3/11g

Stop the BEA WebLogic server before applying this fix pack. To apply this fix pack, the ISRA must be deployed on BEA WebLogic.

Open startWebLogic.sh file located in /{weblogicInstallationDirectory}/user_projects/{domain_name}directory in your preferred text editor.

Locate the CLASSPATH variable in this file and add the full path of the ISRA.jar file at the start. For example,

 

If CLASSPATH variable looks like:
CLASSPATH="${JAVA_HOME}/lib/tools.jar${CLASSPATHSEP}${WL_HOME}/server${CLASSPATHSEP}
${WL_HOME}/server/lib/weblogic_sp.jar${CLASSPATHSEP}${WL_HOME}/server
/lib/weblogic.jar${CLASSPATHSEP}${CLASSPATH}"


Then, enter the path "/fnsw/ISRA/fixpack34FP7/ISRA.jar" as:
CLASSPATH="/fnsw/ISRA/fixpack34FP7/ISRA.jar:${JAVA_HOME}/lib/tools.jar${CLASSPATHSEP}${WL_HOME}/server$
{CLASSPATHSEP}${WL_HOME}/server/lib/weblogic_sp.jar${CLASSPATHSEP}${WL_HOME}/server
/lib/weblogic.jar${CLASSPATHSEP}${CLASSPATH}:"

Save the file and start the server.

Go to How to Deploy FileNetImageViewer section before completing fix pack installation and restarting the Server. For known software problems and restrictions, go through the Release Notes 3.4 FP7.

To Install using ISRA 3.4 Fix Pack 7 using the ISRA.rar, please refer to IBM - Product Documentation for FileNet Image Services Resource Adapter

 

Multiple Resource Adapters:

 

The steps described above will use the same instance of ISRA.jar file for all ISRA deployments.

 

For Windows 2003 SP1/2003 R2\2008

 

Fix Pack Layout

 

For Weblogic 9.0/9.1/10.3/11g, the fix pack consists of a self extracting zip file named 'ISRA_fixpack_3_4_0_7.exe'. The layout of this fix pack is as follows: 

 

FileName

Description

/ISRA.rar

    ISRA.rar with updated ISRA.jar and ra.xml

/ISRA.jar

    ISRA jar with updated class files

/FNImageViewer.ear

    FileNetImageViewer with build 4.0.38 (contains an updated VeriSign certificate)

/ISRASample.ear

    ISRA Sample Application containing modified Annot.xsl

Installation Instructions

 

Extract zip file in C:\fixpack34FP7 directory.             

 

Single Resource Adapter:

 

BEA Weblogic 9.0/9.1/10.3/11g

Stop the BEA WebLogic server before applying this fix pack. To apply this fix pack, the ISRA must be deployed on BEA WebLogic.

Open startWebLogic.cmd file located in (installationDrive}\{weblogicInstallationDirectory}\user_projects\{domain_name}
directory in your preferred text editor.

Locate the CLASSPATH variable in this file and add the full path of the ISRA.jar file at the start.

For example, If CLASSPATH variable looks like:
CLASSPATH=%JAVA_HOME%\lib\tools.jar;%WL_HOME%\server\lib\weblogic_sp.jar;
%WL_HOME%\server\lib\weblogic.jar;%CLASSPATH%
then enter the path "C:\fixpack34FP7\ISRA.jar" as:
CLASSPATH=C:\fixpack34FP7\ISRA.jar;%JAVA_HOME%\lib\tools.jar;%WL_HOME%\server\lib\weblogic_sp.jar;
%WL_HOME%\server\lib\weblogic.jar;%CLASSPATH%;

Save the file and start the server.

 

Go to How to Deploy FileNetImageViewer section before completing fix pack installation and restarting the Server. For known software problems and restrictions, go through the Release Notes 3.4 FP7.

To install using ISRA 3.4 Fix Pack 7 using the ISRA.rar, please refer to IBM - Product Documentation for FileNet Image Services Resource Adapter

 

Multiple Resource Adapters:

 

The steps described above will use the same instance of ISRA.jar file for all ISRA deployments.

On IBM WebSphere 6.0.2/6.1/7.0/8.0/8.5

 

For IBM AIX, Sun Solaris, HP-UX, Red Hat Linux AS 4.0/5.0/6.0

 

Fix Pack Layout

 

This fix pack file consists of a tar file named 'ISRA_fixpack_3_4_0_7.tar'. The layout of this fix pack is as follows:

 

FileName

Description

/ISRA.rar

    ISRA.rar with updated ISRA.jar and ra.xml

/ISRA.jar

    ISRA jar with updated class files

/FNImageViewer.ear

    FileNetImageViewer with build 4.0.38 (contains an updated VeriSign certificate)

/ISRASample.ear

    ISRA Sample Application containing modified Annot.xsl

Installation Instructions

Extract tar file using "tar -xvf ISRA_fixpack_3_4_0_7.tar" command.

 

Single Resource Adapter:

Stop WebSphere Application Server.

Replace the ISRA.jar file (in /<was_installation_home_directory>/installedConnectors/ISRA.rar directory) with the ISRA.jar file provided with the fix pack.

Restart the Server.

 

Go to How to Deploy FileNetImageViewer section before completing fix pack installation and restarting the Server. For known software problems and restrictions, go through the Release Notes 3.4 FP7.

Multiple Resource Adapters:

 

To apply the fix pack to multiple ISRA deployed on Application Server, repeat the above steps (1-3) for each deployed ISRA.

 

For Windows 2003 SP1/2003 R2\2008

 

Fix Pack Layout

 

For WebSphere, the fix pack file consists of a self extracting zip file named 'ISRA_fixpack_3_4_0_7.exe'. The layout of this fix pack is as follows:

 

FileName

Description

/ISRA.rar

    ISRA.rar with updated ISRA.jar and ra.xml

/ISRA.jar

    ISRA jar with updated class files

/FNImageViewer.ear

    FileNetImageViewer with build 4.0.38 (contains an updated VeriSign certificate)

/ISRASample.ear

    ISRA Sample Application containing modified Annot.xsl

Installation Instructions

 

Extract zip file in C:\fixpack34FP7 directory.

 

Single Resource Adapter:

Stop WebSphere Application Server.

Replace the ISRA.jar file (in <was_installation_home_directory>\InstalledConnectors\ISRA.rar directory) with the ISRA.jar file provided with the fix pack.

Restart the Server.

 

Go to How to Deploy FileNetImageViewer section before completing fix pack installation and restarting the Server. For known software problems and restrictions, go through the Release Notes 3.4 FP7.

Multiple Resource Adapters:

 

To apply the fix pack to multiple ISRA deployed on Application Server, repeat the above steps (1-3) for each deployed ISRA.

Recommendations for WebSphere users

 

Customers who have web based applications including web services applications running on WebSphere Application Server have a risk for an attacker having the ability to display application specific files contained within a war file, including files under the web-inf and meta-inf directories. In addition, there is a potential risk for customers who are using the WebSphere administrative console with administrative security disabled. Hence customers are advised to check on the details of the APAR PK81387 in the following link http://www-01.ibm.com/support/docview.wss?rs=180&uid=swg24022456 for more information about which versions are affected and update WAS accordingly.

On JBoss 4.0.x/4.2.3/5.1/6.1

 

For Sun Solaris 9/10, Red Hat Linux AS 4.0/5.0/6.0, IBM AIX

 

Fix Pack Layout

 

This fix pack file consists of a tar file named 'ISRA_fixpack_3_4_0_7.tar'. The layout of this fix pack is as follows:

 

FileName

Description

/ISRA.rar

    ISRA.rar with updated ISRA.jar and ra.xml

/ISRA.jar

    ISRA jar with updated class files

/FNImageViewer.ear

    FileNetImageViewer with build 4.0.38 (contains an updated VeriSign certificate)

/ISRASample.ear

    ISRA Sample Application containing modified Annot.xsl

Installation Instructions

 

Extract tar file using "tar -xvf ISRA_fixpack_3_4_0_7.tar" command in /fnsw/ISRA/fixpack34FP7

 

Single Resource Adapter:

Stop JBoss Application Server.

Copy ISRA.rar file in /temp/fixpack34FP7 directory from/{JBossInstallationDirectory}/server/default/deploy directory.
cp /{jbossInstallationDirectory}/server/default/deploy/ISRA.rar /temp/fixpack34FP7.

Change directory to /temp/fixpack34FP7 and extract ISRA.rar.
cd /temp/fixpack34FP7
jar -xvf ISRA.rar

Replace the extracted ISRA.jar file (in /temp/fixpack34FP7 directory) with the ISRA.jar file provided with the Fix pack.

Delete the ISRA.rar file in /temp/fixpack34FP7 directory. Create the archive file ISRA.rar, which includes the updated ISRA.jar file.
rm ISRA.rar
jar -cvf ISRA.rar *

Copy the rar file under /{JBossInstallationDirectory}/server/default/deploy directory.
cp /temp/fixpack34FP7/ISRA.rar /{jbossInstallationDirectory}/server/default/deploy

 

Go to How to Deploy FileNetImageViewer section before completing fix pack installation and restarting the Server. For known software problems and restrictions, go through the Release Notes 3.4 FP7.

Multiple Resource Adapters:

 

To apply the fix pack to multiple ISRA deployed on Application Server, repeat the above steps (1-5) for each deployed ISRA.

 

For Windows 2003 SP1/2003 R2\2008

 

Fix Pack Layout

 

For JBoss 4.0.x/4.2.3/5.1/6.1, the fix pack file consists of a self extracting zip file named 'ISRA_fixpack_3_4_0_7.exe'. The layout of this fix pack is as follows:

 

FileName

Description

/ISRA.rar

    ISRA.rar with updated ISRA.jar and ra.xml

/ISRA.jar

    ISRA jar with updated class files

/FNImageViewer.ear

    FileNetImageViewer with build 4.0.38 (contains an updated VeriSign certificate)

/ISRASample.ear

    ISRA Sample Application containing modified Annot.xsl

Installation Instructions

 

Extract zip file in C:\fixpack34FP7 directory.

 

Single Resource Adapter:

Stop JBoss Application Server.

Copy ISRA.rar file in C:\temp\fixpack34FP7 directory from C:\{JBossInstallationDirectory}\server\default\deploy directory.

c:\>copy {jbossInstallationDirectory}\server\default\deploy\ISRA.rar c:\temp\fixpack34FP7

Change directory to C:\temp\fixpack34FP7 and extract ISRA.rar.
c:\> cd c:\temp\fixpack34FP7
c:\temp\fixpack34FP7> jar -xvf ISRA.rar

Replace the extracted ISRA.jar file (in C:\temp\fixpack34FP7 directory) with the ISRA.jar file provided with the Fix Pack (from C:\fixpack34FP7 directory).

Delete the ISRA.rar file in C:\temp\fixpack34FP7 directory. Create the archive file ISRA.rar, which includes the updated ISRA.jar file.
c:\temp\fixpack34FP7> del ISRA.rar
c:\temp\fixpack34FP7> jar -cvf ISRA.rar *

Copy the rar file under C:\{JBossInstallationDirectory}\server\default\deploy directory.
c:\>copy C:\temp\fixpack34FP7\ISRA.rar \{jbossInstallationDirectory}\server\default\deploy

 

Go to How to Deploy FileNetImageViewer section before completing fix pack installation and restarting the Server. For known software problems and restrictions, go through the Release Notes 3.4 FP7.

Multiple Resource Adapters:

 

To apply the fixpack to multiple ISRA deployed on Application Server, repeat the above steps (1-5) for each deployed ISRA.

On Oracle Application Server 10g (9.0.4) and 10g Release 3 (10.1.3)

 

For Sun Solaris 9/10, Red Hat Linux AS 4.0/5.0/6.0, HP-UX, IBM AIX

 

Fix Pack Layout

 

This fix pack file consists of a tar file named 'ISRA_fixpack_3_4_0_7.tar'. The layout of this fix pack is as follows: 

 

FileName

Description

/ISRA.rar

    ISRA.rar with updated ISRA.jar and ra.xml

/ISRA.jar

    ISRA jar with updated class files

/FNImageViewer.ear

    FileNetImageViewer with build 4.0.38 (contains an updated VeriSign certificate)

/ISRASample.ear

    ISRA Sample Application containing modified Annot.xsl

Installation Instructions

 

Extract tar file using "tar -xvf ISRA_fixpack_3_4_0_7.tar" command in /fnsw/ISRA/fixpack34FP7.

 

Single Resource Adapter:

Stop Oracle Application Server.

Replace the ISRA.jar file in /{OracleInstallationDirectory}/j2ee/home/connectors/ISRA/ISRA directory with the new ISRA.jar present in /fnsw/ISRA/fixpack34FP7.

cp /fnsw/ISRA/fixpack34FP7/ISRA.jar /{OracleInstallationDirectory}/j2ee/home/connectors/ISRA/ISRA

Start the Application Server.

Go to How to Deploy FileNetImageViewer section before completing fix pack installation and restarting the Server. For known software problems and restrictions, go through the Release Notes 3.4 FP7.

Multiple Resource Adapters:

 

To apply the fixpack to multiple ISRA deployed on Application Server, repeat the above steps (1-3) for each deployed ISRA.

 

For Windows 2003 SP1/2003 R2

 

Fix Pack Layout

 

For Oracle, the fix pack file consists of a self extracting zip file named 'ISRA_fixpack_3_4_0_7.exe'. The layout of this fix pack is as follows:

 

FileName

Description

/ISRA.rar

    ISRA.rar with updated ISRA.jar and ra.xml

/ISRA.jar

    ISRA jar with updated class files

/FNImageViewer.ear

    FileNetImageViewer with build 4.0.38 (contains an updated VeriSign certificate)

/ISRASample.ear

    ISRA Sample Application containing modified Annot.xsl

Installation Instructions

 

Extract zip file in C:\fixpack34FP7 directory.

 

Single Resource Adapter:

Stop the Oracle Application Server.

Replace the ISRA.jar file in C:\{OracleInstallationDirectory}\j2ee\home\connectors\ISRA\ISRA directory with the new ISRA.jar present in C:\fixpack34FP7.

c:\>copy fixpack34FP7\ISRA.jar C:\{OracleInstallationDirectory}\j2ee\home\connectors\ISRA\ISRA

Start the Application Server.

 

Go to How to Deploy FileNetImageViewer section before completing fix pack installation and restarting the Server. For known software problems and restrictions, go through the Release Notes 3.4 FP7.

Multiple Resource Adapters:

 

To apply the fixpack to multiple ISRA deployed on Application Server, repeat the above steps (1-3) for each deployed ISRA.

On Sun Java System Application Server 8.1/8.2/9.0

 

For IBM AIX, Sun Solaris, HP-UX, Red Hat Linux AS 4.0/5.0/6.0

 

Fix Pack Layout

 

This fix pack file consists of a tar file named 'ISRA_fixpack_3_4_0_7.tar'. The layout of this fix pack is as follows:

 

FileName

Description

/ISRA.rar

    ISRA.rar with updated ISRA.jar and ra.xml

/ISRA.jar

    ISRA jar with updated class files

/FNImageViewer.ear

    FileNetImageViewer with build 4.0.38 (contains an updated VeriSign certificate)

/ISRASample.ear

    ISRA Sample Application containing modified Annot.xsl

Installation Instructions

Extract tar file using "tar -xvf ISRA_fixpack_3_4_0_7.tar" command.

 

Single Resource Adapter:

Bundle the ISRA.jar file with the existing ra.xml file and create the ISRA.rar file and deploy it again.

Restart the Server.

 

Go to How to Deploy FileNetImageViewer section before completing fix pack installation and restarting the Server. For known software problems and restrictions, go through the Release Notes 3.4 FP7.

Multiple Resource Adapters:

 

To apply the fix pack to multiple ISRA deployed on Application Server, repeat the above steps (1-2) for each deployed ISRA.

 

For Windows 2003 SP1/2003 R2

 

Fix Pack Layout

 

For Sun Java System Application Server, the fix pack file consists of a self extracting zip file named 'ISRA_fixpack_3_4_0_7.exe'. The layout of this
fix pack is as follows:

 

FileName

Description

/ISRA.rar

    ISRA.rar with updated ISRA.jar and ra.xml

/ISRA.jar

    ISRA jar with updated class files

/FNImageViewer.ear

    FileNetImageViewer with build 4.0.38 (contains an updated VeriSign certificate)

/ISRASample.ear

    ISRA Sample Application containing modified Annot.xsl

Installation Instructions

 

Extract zip file in C:\fixpack34FP7 directory.

 

Single Resource Adapter:

Bundle the ISRA.jar file with the existing ra.xml file and create the ISRA.rar file and deploy it again.

Restart the Server.

 

Go to How to Deploy FileNetImageViewer section before completing fix pack installation and restarting the Server. For known software problems and restrictions, go through the Release Notes 3.4 FP7.

Multiple Resource Adapters:

 

To apply the fix pack to multiple ISRA deployed on Application Server, repeat the above steps (1-2) for each deployed ISRA.

How to Deploy ISRA.rar

 

To deploy ISRA.rar please refer "ISRA Deployment" chapter in ISRA deployment guides (Application Server specific) from IBM - Product Documentation for FileNet Image Services Resource Adapter for detailed steps for deployment instructions.

How to Deploy FileNetImageViewer

 

To deploy FNImageViewer.ear please refer "Deploying IBM FileNet Image Viewer" section in ISRA deployment guides (Application Server specific) from IBM - Product Documentation for FileNet Image Services Resource Adapter for detailed steps for deployment instructions.

How to Check the Build of Installed FNImageViewer

Open any document through FNImageViewer.

Press F1 key on your keyboard or right-click your mouse on any area within the Viewer Applet and select Help > About FileNet JavaView.

The topmost line on the About FileNet JavaView screen will display the build number of the installed FNImageViewer.

How to Deploy ISRA Console

 

To deploy ISRAConsole.ear please refer "Deploying ISRA Console and Sample Application" section in ISRA deployment guides (Application Server specific) from IBM - Product Documentation for FileNet Image Services Resource Adapter for detailed steps for deployment instructions.

List of fixes

 

ISRA 3.4 Fix Pack 7

ecmdb #

APAR

Affected Component

Updated Component

Description

1158650 PJ41300 FNImageViewer.ear FNImageViewer.ear FNImageViewer with Oracle JRE 1.7-21 on 32-bit causes security pop-ups in ISRA 3.4 Fix pack 6.

1158354

PJ41292

FNImageViewer.ear

FNImageViewer.ear

File \FNJavaV1Files\res2s1.v1 (ViewOne 4.x) is missing in FNImageViewer.
1153792 PJ41185 FNImageViewer.ear FNImageViewer.ear The characters on annotation security dialog are not recognizable when operating system format is set to traditional Chinese.

1136725

-

ISRA - Documentation

ISRA - Documentation

ISRA deployment guides were required to be updated with the technote - "Usage of log4j and listner jars with ISRA connector" link.
1128551 - ISRA - Documentation ISRA - Documentation Incorrect query results returned from FindDocuments interaction, which to be updated in ISRA Programmer's guide.
961860 - ISRA - Documentation ISRA - Documentation Complete instructions to deploy in a clustered environment to be updated in ISRA WAS 7 deployment guide.

ISRA 3.4 Fix Pack 6

ecmdb #

APAR

Affected Component

Updated Component

Description

897263

PJ37799

FNImageViewer.ear

FNImageViewer.ear

"Draw transparent text" are not properly rotated .

918030

PJ38791

ISRA.jar

ISRA.jar

Java 1.5 changed BigDecimal, which is causing problems with FP_NUM.

957422

PJ38988

ISRA.jar

ISRA.jar

ISRA caching does not retrieve all users/groups.

962629

-

ISRA.jar

ISRA.jar

Queue's F_ENTRYTIME is not a queryable field .

967978

PJ39346

ISRA.jar

ISRA.jar

ISRA 3.4 latest patch INX performance problem.

971166

PJ39733

ISRA.jar

ISRA.jar

ISRA should use F_INDEXTYPE to determine if an index is a MENU type rather than F_MENUNAME .

973239

PJ39534

ISRA.jar

ISRA.jar

ISRA does not clean up security session handles in the Hashmap.

973962

PJ39572  

ISRA,jar

ISRA.jar

ISRA Lock file is not incremented in clustered WAS7 / AIX environment.

978700

PJ39734  

ISRA.jar

ISRA.jar

ISRA exception No capability (lock) caused documents not to be updated.

987446

-

FNImageViewer.ear

FNImageViewer.ear

With Daeja 188, when adding annotations, the text is rotated 45-degree counter-clockwise by default.

990794

PJ40175

ISRA.jar

ISRA.jar

Vector creating a memory leak in Annotations flow.

  ISRA 3.4 Fix Pack 5

ecmdb #

APAR

Affected Component

Updated Component

Description

846594

PJ37905

FNImageViewer.ear

FNImageViewer.ear

Transparent text annotation in ISRA 3.4 FP3 IF1 (Daeja 3.1.154) does not behave the same as 3.0.506

857183

PJ37824

FNImageViewer.ear

FNImageViewer.ear

ISRA Viewer hangs when 650 (or more) characters are entered as a Text Annotation.

862113

PJ37833

FNImageViewer.ear

FNImageViewer.ear

Sticky notes icon is varying in size, in relation to the enhance level (EL) setting.

862182

PJ37798

FNImageViewer.ear

FNImageViewer.ear

Viewer label donot print.

863535

PJ37797

FNImageViewer.ear

FNImageViewer.ear

Daeja Viewer cannot display certain tiff image with G3 compression.

865753

 

ISRA,jar

ISRA.jar

Enhancement request to resolve issues with ISRALock folder in 3.4 FP3 and above.

892004

 

ISRA.jar

ISRA.jar

ISRA 3.4 FP3 IF1 throws NegativeArraySizeException.

894949

PJ37706

ISRA.jar

ISRA.jar

Cannot retrieve queue items that are in delay state.

903847

PJ37809

ISRA Documentation

ISRA Documentation

Missing notes entry in the documentation for deletedocs interaction.

  ISRA 3.4 Fix Pack 4

ecmdb #

APAR

Affected Component

Updated Component

Description

799762

PJ36954

FNImageViewer.ear

FNImageViewer.ear

ISRA 3.4 does not give a warning to the user when an annotation has not been saved while closing the ISRA windows

814223

PJ36231

ISRA.jar

ISRA.jar

ISRA does not save previous logs, once it reaches maximum size. 

821344

 

ISRA.jar

ISRA.jar

GetSecurityInfo interaction fails to retrieve a new IS user if the user is not in ISRA cache

823320

 

ISRA.jar

ISRA.jar

LDAP Anonymous Login from ISRA doesn’t work with SUN JDS

823346

PJ36651

ISRAConsole.ear /

FNImageViewer.ear

ISRAConsole.ear /

FNImageViewer.ear

Document Icons with annotations are not being changed correctly.

837152

PJ36596

FNImageViewer.ear

FNImageViewer.ear

Annotations are not being saved once “New Window” option is closed.

837157

PJ36595

ISRA,jar

ISRA.jar

ISRA is creating anomalous Security devices and spiking findendpoint2.

837807

 

ISRASample.war

ISRASample.war

ISRA 3.4 FP5 Displays wrong version information.

837946

 

ISRA.jar

ISRA.jar

When specifying the log file name in ra.xml, if the .log file extension is not specified, ISRA fails to generate the log file name properly.

837926

 

ISRA.jar

ISRA.jar

Queue creation failed in ISRA

838319

PJ36652

FNImageViewer.ear

FNImageViewer.ear

Event launched from Daeja Viewer applet stop responding for a while.

838325

PJ36649

FNImageViewer.ear

FNImageViewer.ear

Daeja applet does not cache icon file to local cache.

838384

 

ISRA.jar

ISRA.jar

Non-existent LDAP and IS users can login without providing password using Novell e-Directory Server

839203

PJ36650

FNImageViewer.ear

FNImageViewer.ear

COLD Documents not displayed correctly in ISRA 3.4 HFP3

  ISRA 3.4 Fix Pack 3

ecmdb #

APAR

Affected Component

Updated Component

Description

785805

 

-

ISRA.jar

 

ISRA.jar

 

IS did not throw an exception when Date input did not match the Date mask at IS.

788751

 

-

ISRA.jar

 

ISRA.jar

 

The following error was received in the ISRA Sample application on ISRA 3.3 FP6:

“Array Index out of bounds while writing to an array.: 204 ISRA Fehlercode : FN_IS_RA_20353”.

789850

 

-

ISRA.jar, ISRAConsole.ear

ISRA.jar, ISRAConsole.ear

The GetDocProperties returned -1 day off for F_ENTRYDATE properties.

789906 

 

PJ36076

ISRA.jar, ISRAConsole.ear

 

ISRA.jar, ISRAConsole.ear

User was able to logon successfully with an expired or locked account.

790295

 

PJ36081

FNImageviewer.ear

 

FNImageviewer.ear

 

The message that was displayed by FNImageViewer 3.1.132 while getting an image with annotation was different on Japanese version compared with English version.

790739

 

PJ36077 

FNImageviewer.ear

 

FNImageviewer.ear

 

Images with annotation were not displayed correctly, sometimes after the browser was resized.

790937

 

 PJ35754 

ISRA.jar

 

ISRA.jar

 

AddDoc was getting “adding document error FN_IS_RA_10416”.

791056

 

PJ35557

ISRA.jar, ISRAConsole.ear

ISRA.jar, ISRAConsole.ear

ISRA 3.3 Patch 6 broke custom application and Date Entries went one day behind.

792453 

 

PJ35650

ISRA.jar, ISRAConsole.ear

ISRA.jar, ISRAConsole.ear

After upgrading to ISRA 3.4.0 (then 3.4.0 hfp1), custom application was displaying all the dates as one day behind.

792695

 

PJ35651

ISRA.jar, ISRAConsole.ear

ISRA.jar, ISRAConsole.ear

Date was displaying incorrectly after upgrade to ISRA 3.4 patch 2.

793125

 

-

ISRA.jar, ISRAConsole.ear

ISRA.jar, ISRAConsole.ear

F_ENTRYDATE and DATE INDEX returned by Edit Document Properties in ISRA were less by one day.

795475

 

PJ36082

ISRA.jar

 

ISRA.jar

 

NullPointerException on a GetDocContent2 search in ISRA 3.4 was obtained instead of the expected FN_IS_RA_10363 error.

795932

 

-

ISRA.jar

 

ISRA.jar

 

ISRA was throwing a null pointer exception when JVM id in ISRAlock exceeded 35.

797629

 

-

ISRA.jar

 

ISRA.jar

 

ISRA account was expiring while performing a search document interaction.

800958

 

PJ36080

ISRA.jar, ISRAConsole.ear

ISRA.jar, ISRAConsole.ear

On running the sample for SetCLOSEDProperty interaction, the following errors were obtained:

FN_IS_CciInteraction.java:5509

FN_IS_CciInteraction.java:1155

FN_IS_CciInteraction.java:484.

 

ISRA 3.4 Fix Pack 2

 

ecmdb #

APAR

Affected Component

Updated Component

Description

757004

-

Daeja Viewer

FNImageViewer.ear

Resolved issue where a particular COLD document using the laser/Mono.200 font with no "lines per inch" p-code (CTRL-S) was not displaying correctly.

779746

PJ34708

Interface  Layer of ISRA

ISRA.jar

ISRA wrongly handles the Query with filter condition involving F_DOCTYPE.

783445

-

RPC Layer of ISRA

ISRA.jar

Globalization changes in ISRA to read the Client Character Set from IS. 

785061

-

RPC Layer of ISRA

ISRA.jar

ISRA generates an incorrect terminal ID in 2 node vertical cluster in WebSphere Application Server. 

785801

-

Presentation layer of ISRA Sample Application

ISRA Sample Application

Incorrect time shown when show queue entries is selected.

785905

-

RPC Layer of ISRA

ISRA.jar

Wrong status message when trying to add document.

  

ISRA 3.4 Fix pack 1  

 

ecmdb #

APAR  

Affected Component

Updated Component

Description

741392

PJ34277

RPC Layer of ISRA

ISRA.jar

Invalid security handle passed error occurs when clustered.

752123

PJ33282

Interface Layer of ISRA

ISRA.jar

Security for annotation does not get populated correctly.

752539

-

ISRA Documentation

 

15 issues found in ISRA_WAS6_DeployGuide_340.pdf.

754837

PJ34166

ISRA Documentation

 

Description for Deployment Instance is misleading.

756140

PJ33798

Daeja Viewer

FNImageViewer.ear

Images Intermittently display unclear.

757917

PJ33935

ISRA Console / Sample

ISRAConsole.ear

Cannot open the Daeja Viewer via HTTPS.

758323

PJ33951

RPC Layer of ISRA

ISRA.jar

Document Index handles becoming zero.

759730

-

Interface Layer updated for Query Parsing of ISRA

ISRA.jar

ISRA query implementation incorrect for F_Doctype and wildcard character “?” usage.

759993

PJ34322

CCI Layer of ISRA

ISRA.jar

Request for Explanation of “FN_IS_CciConnection:close:Not an active Connection” messages in ISRA.

760157

PJ33978

Presentation Layer of ISRA Console / Sample

ISRAConsole.ear

NULL properties get replaced by empty space.

767199

PJ34115

Interface Layer of ISRA

ISRA.jar

F_ENTRYDATE or index with Date Type returned by ISRA are off by one day(1 day less).

768085

-

Interface Layer of ISRA

ISRA.jar

The Output Mask returned by IS is displayed incorrectly.

770921 

-

Interface Layer of ISRA

ISRA.jar

The ISRA Admin Console is displaying the ISRA Log File Name incorrectly.

771294

-

ISRA Bundling

ISRA.rar

Changes to be made to ra.xml For the deployment instance parameter. 

771821

-

Interface Layer of ISRA

ISRA.jar, ISRAConsole.ear

Improper message displayed in ISRA when print services are disabled at IS.

771869 

-

Interface Layer of ISRA

ISRA.jar, ISRAConsole.ear

RPC logging is disabled when tried to disable ISRA logging. 

773624 

-

Presentation Layer of ISRA Console / Sample

ISRAConsole.ear

With jboss appserver4.0.4 the sample application fails to display f_docformat,f_pages.

773627 

-

Presentation Layer of ISRA Console / Sample

ISRAConsole.ear

ISRA sample login.jsp throws an exception.

773371

-

Presentation Layer of ISRA Console / Sample

ISRAConsole.ear

Errorcode shown as null when displaying error message for printservices not available. 

  ISRA 3.4.0 GA  

ecmdb #

APAR  

Affected Component

Updated Component

Description

745723

PJ33934

Originally deployed ISRA.rar (ISRA 3.4.0), ISRA.jar

ISRA.jar

Unable to view annotations that was created by a deleted IS user: After upgrading from ISRA 3.3 FP2 to FP5 (to fix a mem-leak issue on their WAS server), annotations that were created by a deleted IS user cannot be viewed by other users. The following error appeared: "Annotation Exception: Annotations failed to load".

New Features

IPv6 Support

ISRA 3.4 FP3 and above support IPv6 networks.

GMTEnabled Flag

This interim fix includes a new deployment descriptor property– “GMTEnabled” which is of type Boolean. It accepts two values “true” and “false”. The default value has been set to “false”.

This property is used to fix the issue where ISRA client applications reported the dates being returned by ISRA were off by one day..

The following explains the use of this new property:

Setting “GMTEnabled” to false

When the flag is set to false, it is assumed that the ISRA client application is not “GMT Enabled” i.e. Client applications will not do any timezone conversion.  ISRA returns the date committed on the IS to client applications after adjusting the difference between the Application Server timezone and the GMT Timezone. As a result, the dates displayed in applications will be in accordance with the dates committed on the IS.

Sample Code for Client Applications while displaying dates, when the GMTEnabled flag is set to false

/*dateObject is an instance of java.lang.Object assumed to contain the date returned by ISRA */

Date dateProperty = (Date) dateObject;

System.out.println(“The Date is:”+dateProperty);

Setting “GMTEnabled” to true

When the flag is set to true, it is assumed that the client application is “GMT Enabled” i.e. client applications will display the dates in GMT. In this case, ISRA returns the date committed on the IS in the GMT timezone, without any adjustment.

A note for application developers

Java displays any date object by default in the local application server timezone. Therefore, for displaying the date in GMT, applications should set the date format to GMT as shown in the sample code below. 

 Sample Code to be included in Client Applications while displaying dates, when the GMTEnabled flag is set to true

/*dateObject is an instance of java.lang.Object assumed to contain the date returned by ISRA */

Date dateProperty = (Date) dateObject;

/* Set the Date Format */

DateFormat dateformat = DateFormat.getDateInstance(DateFormat.FULL,USLocale);

/* Set TimeZone to GMT */

dateformat.setTimeZone(TimeZone.getTimeZone("GMT"));

SimpleDateFormat simpledateformat = new SimpleDateFormat();

simpledateformat = (SimpleDateFormat) dateformat;

/* Parse date according to the date format set and store in String data type.*/

String dateString = dateformat.format(dateProperty);

System.out.println(“The Date is:”+dateString);

Note: If you have made changes to display dates, as described above, in your ISRA client application, after an upgrade to ISRA 3.4 FP2, please set the GMTEnabled flag to true while deploying the Interim fix.

If you have not made any changes to display dates, in your ISRA Client application and find that the dates being shown in your applications are off by one day as a result of an upgrade to ISRA 3.4.0, please set the GMTEnabled flag to false while deploying the interim fix.

If you are a first time user of this interim fixpack, please use the default value for GMTEnabled, i.e. false.

General Notes

It is advisable to take a backup of existing ISRA.rar file.

Best Practices

  1. It is strongly recommended to restart the application server running ISRA, every time FileNet Image Services is restarted.
  2. To avoid errors such as “User not logged into Sec service”, in ISRA please configure your ISRA connection factory connection pool properties based on the guidelines below:

Aged connection time out set to a value less than the duration of IS recycle/restart time.

Purge policy set to entire pool.

Reap time to be 1/2 or 1/3 of Aged time out.

ISRA Support

 

If you experience any difficulties with the product media or ISRA, please contact your IBM FileNet Customer Support personnel for assistance.

Contact Customer Support

 

For information about contacting customer support:

Navigate to the Information Management support page here.www.ibm.com/software/data/support

Select the appropriate IBM FileNet product from the "Select a category" list.

From the Product Support page, click Flash 8 Oct. 2007: How to get support for IBM FileNet products.

Copyright and trademark information

http://www.ibm.com/legal/copytrade.shtml

Notices and trademarks

IBM is a registered trademark of International Business Machines Corporation in the United States, other countries, or both.

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office.

IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency, which is now part of the Office of Government Commerce.

Other company, product, or service names may be trademarks or service marks of others.

Document change history

Date

Description of change  

10 July 2013

Updated initial version of ISRA 340 fix pack 7.