filenet-p8 Archives - iparagons blog

IBM Case Manager (ICM), IBM Case Manager Builder

FNRPA0024E The Content Platform Engine is not Available Error in IBM Case Builder 5.2.1

January 17, 2020

FNRPA0024E The Content Platform Engine is not available or the connection definition is inaccurate error generated in filenet p8 when logon into Case Manager Builder. As described in below screenshot:

Here is the error description in systemout.log file:

[1/12/20 19:40:24:312 PKT] 0000001f handler E com.ibm.casemgmt.intgimpl.messages.CaseMgmtLogger error FNRPA0024E The Content Platform Engine is not available or the connection definition is inaccurate.
com.ibm.casemgmt.api.exception.CaseMgmtException: fnrpa0024 the content platform engine is not available or the connection definition is inaccurate.
at com.ibm.casemgmt.api.exception.CaseMgmtException.createException(CaseMgmtException.java:112)
at com.ibm.casemgmt.api.exception.CaseMgmtException.access$1800(CaseMgmtException.java:62)
at com.ibm.casemgmt.api.exception.CaseMgmtException$ClassBridgeImpl.createException(CaseMgmtException.java:457)
at com.ibm.casemgmt.api.context.BaseVWSessionCache.getVWSession(BaseVWSessionCache.java:80)
at com.ibm.casemgmt.api.admin.ConnectionDefinition.loadIfNecessaryAndGetVWSession(ConnectionDefinition.java:126)
at com.ibm.casemgmt.api.admin.ConnectionDefinition.getTargetObjectStoreReference(ConnectionDefinition.java:139)
at com.ibm.casemgmt.rest.handlers.RetrieveSolutionListHandler.onGet(RetrieveSolutionListHandler.java:121)
at com.ibm.casemgmt.rest.ACMRESTServlet.doMethod(ACMRESTServlet.java:386)
at com.ibm.casemgmt.rest.ACMRESTServlet.doGet(ACMRESTServlet.java:240)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:718)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:831)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.service(ServletWrapper.java:1657)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.service(ServletWrapper.java:1597)
at com.ibm.ws.webcontainer.filter.WebAppFilterChain.doFilter(WebAppFilterChain.java:104)
at com.ibm.ws.webcontainer.filter.WebAppFilterChain._doFilter(WebAppFilterChain.java:77)
at com.ibm.ws.webcontainer.filter.WebAppFilterManager.doFilter(WebAppFilterManager.java:908)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.handleRequest(ServletWrapper.java:934)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.handleRequest(ServletWrapper.java:502)
at com.ibm.ws.webcontainer.servlet.ServletWrapperImpl.handleRequest(ServletWrapperImpl.java:181)
at com.ibm.ws.webcontainer.servlet.CacheServletWrapper.handleRequest(CacheServletWrapper.java:91)
at com.ibm.ws.webcontainer.WebContainer.handleRequest(WebContainer.java:864)
at com.ibm.ws.webcontainer.WSWebContainer.handleRequest(WSWebContainer.java:1592)
at com.ibm.ws.webcontainer.channel.WCChannelLink.ready(WCChannelLink.java:186)
at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.handleDiscrimination(HttpInboundLink.java:452)
at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.handleNewRequest(HttpInboundLink.java:511)
at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.processRequest(HttpInboundLink.java:305)
at com.ibm.ws.http.channel.inbound.impl.HttpICLReadCallback.complete(HttpICLReadCallback.java:83)
at com.ibm.ws.tcp.channel.impl.AioReadCompletionListener.futureCompleted(AioReadCompletionListener.java:165)
at com.ibm.io.async.AbstractAsyncFuture.invokeCallback(AbstractAsyncFuture.java:217)
at com.ibm.io.async.AsyncChannelFuture.fireCompletionActions(AsyncChannelFuture.java:161)
at com.ibm.io.async.AsyncFuture.completed(AsyncFuture.java:138)
at com.ibm.io.async.ResultHandler.complete(ResultHandler.java:204)
at com.ibm.io.async.ResultHandler.runEventProcessingLoop(ResultHandler.java:775)
at com.ibm.io.async.ResultHandler$2.run(ResultHandler.java:905)
at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java:1613)
Caused by: The Web Application id 11 is reserved
at filenet.vw.api.VWSession.setDefaultWebApplication(VWSession.java:3711)
at com.ibm.casemgmt.api.context.BaseVWSessionCache.getVWSession(BaseVWSessionCache.java:69)
… 31 more

I’ve also tried IBM Tech note to resolve the problem, but in my environment it didn’t work. https://www.ibm.com/support/pages/fnrpa0024e-content-platform-engine-not-available-or-connection-definition-inaccurate-error-generated-when-logging-case-manager-case-builder

Environment:

WebSphere Application Server 7.0.0.23
Content Platform Engine 5.2.1.7
Workplace XT 1.1.5.2
Content Navigator 2.0.3.7
Case Manager 5.2.1.7

Basically, I was upgrading whole IBM FileNet P8 environment to 5.2.1. All components were successfully upgraded to their updated state but in last step, when tried to upgrade solutions in IBM Case Manager Builder, exception occurred, “FNRPA0024E The Content Platform Engine is not available or the connection definition is inaccurate”.

Solution:

After enabling the classloader trace in WAS as described on https://www.ibm.com/support/pages/mustgather-classloader-problems-websphere-application-server and reproduced the problem again.

Enable and collect Application Server traces with the following trace string:
com.ibm.ws.classloader.*=all
Enable Java™ Virtual Machine (JVM) classloader traces through the Admin console as mentioned:

Select Servers, choose Application servers and select the server you want to configure.
In the Server Infrastructure section, open Java and Process Management and selectProcess Definition.
Under Additional Properties, select Java Virtual Machine.
Check the Verbose class loading checkbox.
Add the following string to the Generic JVM arguments field:
-Dws.ext.debug=true -Dws.osgi.debug
Click OK.
Save the changes. Restart the server.

In trace.log file pointed that jace.jar, pe.jar. pe3pt.jar, and json4j_apache.jar files are mismatched version in WebShpere Application server /lib/ directory from deployed CaseBuilder.war/WEB-INF/lib/ folder.

Stop the WAS JVM where ICM / ICN deployed.
Copy the jace.jar, pe.jar. pe3pt.jar, and json4j_apache.jar following files from deployed Case Builder path: /opt/IBM/WebSphere/AppServer/profiles/AppSrv02/installedApps/acmNode02Cell/CaseBuilder.ear/CaseBuilder.war/WEB-INF/lib/
Paste or replace these files on path: /opt/IBM/WebSphere/AppServer/lib/
Clear the /tmp /wstemp directories under the WAS.
Start the WAS JVM where ICM / ICN deployed.

Hope so, problem will be resolved and user can logging into IBM Case Builder successfully.

IBM Content Platform Engine (CPE)

IBM FileNet Bulk Search and Update in Existing Document Class

December 9, 2019

Sometimes to meet the users requirements, we have to perform bulk operations such as; FileNet P8 bulk search and update existing document class(es) property value(s). Users want to add a new property to particular document class and want to update the existing records to populate this into new property.

There are three mechanisms to achieve this requirements;

FileNet Bulk Search and Update using FileNet vbscript.
Sweep jobs in FileNet or FileNet custom sweep job.
Set document property using JavaScript.

Here we are illustrating FileNet Bulk Search and Update using FileNet vbscript. You can configure as followed to add the new property template to the existing class and documents:

Add a new property template via FileNet Enterprise Manager (FEM) or FileNet ACCE.
Go to your document class – Property Definition tab and add the new property template to it then refresh the object store.
The new property template will be added to the existing document but contains no value.
To update the property value of several objects at the same time for the existing documents, you can use the Content Engine Enterprise Manager’s Search feature. First, using the Enterprise Manager, you will need to determine the Symbolic Name of the property that you want to modify. To do this, select the property under the “Property Templates” node and look for the value for the “Symbolic Name” property on the Properties tab.
Perform the new search and define the criteria for the new search.

Once search completed with results, do the following step by step.

filenet enterprise manager multi select operations

Select all the results values and perform multiselect operations option as mentioned above.

Bulk Operations window will be prompted, go the the script tab and paste the following script in the FileNet vbscript window (Please change the symbolic name of the property value according to yours):

 Public Sub OnCustomProcess (CEObject) 
 CEObject.DHA_Br_Ingestion = "BC" 
 CEObject.Save 
 End Sub

To confirm the FileNet bulk search and update results, try to search again you will see new property value is updated accordingly.

Query:

For further confirmation, you can also query from filenet docversion table. Here is the query:

select COUNT(docversion.u0398_dha_br_ingestion) AS TOTAL, classdefinition.symbolic_name 
 from docversion, classdefinition 
 where docversion.u0398_dha_br_ingestion IN ('BC','Tfr')
 and docversion.object_class_id = classdefinition.object_id
 group by classdefinition.symbolic_name
 UNION ALL
 SELECT SUM(TOTAL), 'SUM of All' from (
 select COUNT(docversion.u0398_dha_br_ingestion) AS TOTAL, classdefinition.symbolic_name 
 from docversion, classdefinition 
 where docversion.u0398_dha_br_ingestion IN ('BC','Tfr')
 and docversion.object_class_id = classdefinition.object_id
 group by classdefinition.symbolic_name
 )
 a

In next post, I’ll share other two options; custom sweep job and set document property using JavaScript. For information about FileNet bulk search and update please refer to following Tech notes:

IBM FileNet Workplace XT

IBM FileNet P8 Workplace XT Login Page Modify & CSS

September 11, 2019

IBM FileNet P8 Workplace XT login page settings using css can be achieved by following tips and tricks:

#CSS

Go to xt deployed directory: /AppServer/profiles/AppSrv01/installedApps//WorkplaceXT.ear/web_client.war/
In css folder, modify main.css, if you want to modify the homepage for IBM FileNet Workplace XT, e.g. change the background image

TD#bannerLogo
{
width: 100px;
background-position: center center;
background-repeat: no-repeat;
background-image: url(‘../images/web/common/IBMLogo.gif’);
padding-left: 9px;
}

TABLE#bannerTable
{
background-image: url(‘../images/web/common/IBMBannerBackground.gif’);
background-repeat: repeat-x;
border-bottom: 1px solid #99afc4;
width: 100%;
}

On css folder, modify application.css, if you want to modify the interface of browse & search page.

Path for main image logo:

/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/ICMServerNode01Cell/WorkplaceXT.ear/web_client.war/images/web/common

Path for Background image banner:

/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/ICMServerNode01Cell/WorkplaceXT.ear/web_client.war/images/web/common/login

Once you will amend these files accordingly, Workplace XT screens will be look like:

Other posts related to Workplace XT can explore here: https://iparagons.com/blog/category/ibm-filenet-workplace-xt/

IBM Content Platform Engine (CPE)

Procedure to Change System User Password in IBM CPE 5.5.1

March 1, 2019

In IBM CPE 5.5.1, users can change the password of the System User via Administration Console for Content Platform Engine (ACCE). The procedure is required if the System User account does NOT change but the password will change. If both the user account and password are changed at the same time, no special process is required in IBM CPE 5.5.1.

Change System User Password IBM CPE 5.5.1

With the CPE running, change the current System User’s password in the LDAP to the desired new value.

Note: In Case Your system user is also admin user and bind in WAS CPE or ICN/ICM JVM profile and you have to perform additional changes in WAS Console.

Procedure to Change Password:

Before Changing password in LDAP, open WAS Console, go to global security settings, federated repositories, AD tab tab like this:

Log onto ACCE using a domain admin account. If the System User is the domain admin, the new password will be used to login.
After successful logon, go to Directory Configuration tab and change the user’s password as described:

administration_console_for content_platform_engine_directory_config_tab

Navigate to the properties tab for the domain.
Edit the System User name, retype the System User name using different case (e.g. all caps, all smalls, just something different).
Edit the password to be that of the desired (e.g. the new password of System User) account and Save.

administration_console_for content_platform_engine_properties_tab

Verify proper system function. For example, navigate to ACCE to the Workflow system down to the configuration of a component queue. If this is possible, the PE service is able to utilize the System User as expected. Furthermore, if same user is used for Component queues than you have to change its password there as demonstrated here:

No special procedure is required further. Even you just don’t need to restart CPE enable WAS JVM. But for safe side, you can restart IBM FileNet P8 services. You also need to verify Content Platform Engine (CPE) Health page.

In case you want to change both user and password following steps will be performed:

Create a new user in LDAP.
Logon to ACCE, with the previous user name and password.
Go to domain properties tab.
Retype New user name in any case (lower, uper or mix letter).
Retype its newly user’s modified password.
Save and close.
Verify system functionalities completely.

Remember:

In IBM CPE 5.5.1, bootstrap user complexity has been removed and its now works as system user instead of bootstrap user. Once you updated to version 5.5.1, it’s no more longer associated to GCD and JNDI bindings.

For more details go to following tech notes:

https://www-01.ibm.com/support/docview.wss?uid=ibm10737163

https://www.ibm.com/support/knowledgecenter/en/SSNW2F_5.5.0/com.ibm.p8.security.doc/p8psh017.htm

IBM Content Navigator (ICN)

IBM Content Navigator Video Streaming 3.0.5

February 4, 2019

In IBM Content Navigator 3.0.5 there is a new feature introduced of video viewing / streaming. IBM ICN now provides a new video viewer support that allows streaming, with the ability to create bookmarks at any point in the video. Note: Administrator must configure IBM Content Navigator for video viewing before you can stream videos.

Configure IBM Content Navigator Video Streaming

For all video formats (.mov, .avi, .h264 etc.), it is recommended that you trans-code the video file to an MP4 file before uploading in IBM ICN. This will enable instant playback because MP4 is natively supported by all browsers. Note: MP4 files do not need trans-coding. If video is already in .mp4 format than you don’t need to trans-code video it is only required if its format is other than .mp4.

First of all, you must be on latest version of IBM ICN 3.0.5.
Create a new ICN desktop (not ICM) with all plugins disabled.
If your video is .mp4 format already than just upload in newly created desktop and if not you need to convert it properly by using the
FFMPEG tool and use the following settings for the MP4 video file:

ffmpeg.exe -i Testing_Video.avi -acodec aac -c:v libx264 -x264opts keyint=24:min-keyint=24:no-scenecut -b:v 2400k -maxrate 2400k -bufsize 1200k -vf scale=-1:720 -movflags +faststart Testing_Video.mp4

It will convert the .avi file format to .mp4. Once done, just upload this converted file in newly created icn desktop.
You must need to configure viewer mapping using ICN admin desktop as described below:

Right click on the video and select open option, video will be played in IBM Daeja ViewOne Virtual with video support:

For Details please go to follow IBM Knowledge Center notes:

IBM Case Manager (ICM), IBM Case Manager Builder, ICM Business Rules

After upgrading to IBM Case Manager 5.3.3-IF001 Deployment of Rules Fails During Solution Deployment

September 27, 2018

After upgrading or applying IBM Case Manager V5.3.3-IF001 (5.3.3.0.1), rule(s) deployment fails when you deploy your case management solution. When you deploy your case management solution that contains rules, the deployment will fail, and you might see an error similar to the following logged:

[9/26/18 12:37:14:086 GMT] 000001c5 api E com.ibm.casemgmt.api error FNRPA0624E The rules could not be deployed because of the following error: An exception occurred in the event handler.
Message was: FNRPE0029E: [RULE_DEPLOYMENT_RULE_DEFINITION]: For case type SOL_Type1, exception occurred while converting following rule definition(s): TableRule1
com.ibm.casemgmt.intgimpl.deploy.handlers.ContinuableStepException: FNRPA0624E The rules could not be deployed because of the following error: An exception occurred in the event handler.
Message was: FNRPE0029E: [RULE_DEPLOYMENT_RULE_DEFINITION]: For case type SOL_Type1, exception occurred while converting following rule definition(s): TableRule1
at com.ibm.casemgmt.intgimpl.deploy.handlers.ContinuableStepException.createContinuableStepException

(ContinuableStepException….

Environment:

ICM 5.3.3.1
CPE 5.2.1.7
WAS 8.5.5.x

Cause:

IBM Case Manager 5.3.3 Interim Fix 001 updated the embedded IBM Operational Decision Manager SDK to 8.8.1.3-IF083. The updated version introduces classloader issues which now require the ODMMessages.jar file to be placed into the application server classpath on IBM FileNet Content Platform Engine server where the Rules_Operation component runs.

Solution:

Complete the following steps to copy the required file on your system before you reattempt solution deployment:

Copy the ODMMessages.jar file from the Case Manager installed home directory (/opt/IBM/CaseManagment/configure/AddOns/ODMMessages.jar) to the following directory where Content Platform Engine is deployed:
- WebSphere – <application server-home>/lib/ext. Where <application server-home> is where WebSphere is installed, e.g. /opt/IBM/WebSphere/AppServer/lib/ext.
- Weblogic – <java-home>/lib/ext. Where <java-home> is the JRE folder for the JDK that Weblogic is using, e.g. /opt/app/oracle/product/JAVA/jdk/jre/lib/ext.
Restart the WAS where IBM FileNet Content Platform Engine (CPE) is deployed.
Redeploy solution again from IBM Case Manager Builder. It will be succeed.

For further details, please visit: https://www-01.ibm.com/support/docview.wss?uid=ibm10719975

filenet-p8

FNRPA0024E The Content Platform Engine is not Available Error in IBM Case Builder 5.2.1

Environment:

Solution:

IBM FileNet Bulk Search and Update in Existing Document Class

Query:

IBM FileNet P8 Workplace XT Login Page Modify & CSS

Procedure to Change System User Password in IBM CPE 5.5.1

Change System User Password IBM CPE 5.5.1

Procedure to Change Password:

Remember:

IBM Content Navigator Video Streaming 3.0.5

Configure IBM Content Navigator Video Streaming

After upgrading to IBM Case Manager 5.3.3-IF001 Deployment of Rules Fails During Solution Deployment

Environment:

Cause:

Solution:

Subscribe