blog admin

Configuring Logs Size in IBM FileNet

July 14, 2023

By default P8 Server Logs like trace and error file(s) size is 100MB and maximum of 5 backup files are created. The question is how we configuring logs size in IBM FileNet being overwritten when attempting to capture an intermittent problem.

Environment:

IBM Content Platform Engine (CPE) 5.2.x / 5.5.x
IBM WebSphere Application Server (WAS) 7.0.x / 8.5.x / 9.0.x

Solution:

By default the CPE uses a RollingFileAppender which creates a new log file once the current log reaches 100MB and default maximum number of log files is 5. Both the number and size of the log files can be changed by adding JVM arguments to the application server where Content Engine is deployed as follows:

Logon to WebSphere Application Server (WAS) and Add the following JVMs according to the requirement:

1. -DMaxRollingFileBackups=5 (o keep the log file to only 1 you would use the JVM argument to 0)
2. -DMaxRollingFileSize=100MB (You can specify the value with the suffixes “KB”, “MB” or “GB”)

After adding these two parameters in generic JVM arguments apply and save the changes.

Restart the Application Server where CPE is deployed.
Afterwards, you will see p8_server_trace and p8_server_error logs size and number of backup files changed.

For more details, please refer to this IBM Tech Note https://www.ibm.com/support/pages/node/135571.

WebSphere Application Server (WAS)

How to Change Wasadmin Password in WebSphere

December 28, 2022

Sometimes, it happens when WebSphere Application Server Admin forgets the wasadmin password. Question is, How can I change my primary administrator password using wsadmin in File Based Registry? Or, how to change wasadmin password in WebSphere?

Cause:

This can be caused by many reasons like, server will not start when security is enable, forgot administrative password etc.

Environment:

IBM WebSphere Application Server (WAS) 7.0.x / 8.0.5.x / 9.0.x
Content Platform Engine (CPE) 5.2.1.x / 5.5.x
Content Navigator (ICN) 2.0.3.x / 3.0.x

Solution:

First Make sure all the other running services are stopped. Secondly, do the following steps accodingly to accomplish your requirement:

Start wsadmin from your WebSphere_root/profiles/profile_name/bin

wsadmin -conntype NONE
$AdminTask {listRegistryUsers}

$AdminTask changeFileRegistryAccountPassword {-userId primaryadminid -password newpassword}
$AdminConfig save

Stop the application server.
Clear the server cache

Start the application server.
Open WebSphere Application Server admin console and provide your username and password that you mentioned in the command to change. It will work fine.

For JYTHON:

Start wsadmin from your WebSphere_root/profiles/profile_name/bin

wsadmin -lang jython -user primaryadminuser -password password
AdminTask.changeFileRegistryAccountPassword(‘[-userId newAcct -password newPassword -uniqueName]’)
AdminConfig.save()
Restart the application server

To further add a new user or how to change wasadmin password in websphere, please refere to the following tech notes:

AlFresco

AlFresco Your Authentication Details have not Been Recognized

September 14, 2022

AlFresco Your Authentication Details have not Been Recognized problem has been identified while logon to alresco when user is locked in ldap or active directory. This issue is occurred when user attempted to logon to alresco many time may be because of wrong password attempts.

However, this problem is not happening with all of the users but the few ones which are locked in Active Director.

Envirnonment:

AlFresco Couumity Edition 5.1 / 5.2
Tomcat 8.x
Windows Server 2008 / 2012 / 2016 (Enterprise / Express)

Solution:

First of all go to the alfresco server.

Edit the /opt/alfresco-community/tomcat/shared/classes/alfresco-global.properties file.

Add this line right under #start ldap configuration# section.

authentication.protection.enabled=false

Stop the alfresco services (/opt/alfresco-community/alfresco.sh stop).
Start the alrescro services (/opt/alfresco-community/alfresco.sh start).

Finally, you will see there will be no more error occurred of alfresco your authentication details have not been recognized while login. For details, plesae visit: https://docs.alfresco.com/content-services/6.0/config/

IBM Case Manager (ICM), IBM Case Manager Client

How to Make Comments Required on Work Details Page in Case Manager

December 16, 2021

How to make comments required to capture a comment when a user chooses to process a work item with a particular response? For example, if a work item is Rejected or approved, you must enter a reason for its approval or rejection that will be part of the case history.

Environment:

Case Manager 5.2.x / 5.3.x
Content Platform Engine 5.2.x / 5.5.x
Content Navigator 2.0.3.x / 3.0.x
WebSphere Application Server 7.0.0.x / 8.5.5.x / 9.0.x

Solution:

Perform the following steps to make comments required on work details page accordingly:

Edit the solution in IBM Case Manager Builder.
Go to the pages section, edit the desired work details page.
Show the hidden widgets section, drag a new script adaptor in this area, and rename it so you can remember the purpose.
Wiring the incoming event to the Work Item Toolbar’s Send Work Item event as mentioned in the below diagram:

Edit the settings of script adaptor and add the following code:

var coord = payload.coordination;
var workitemEdit = payload.workItemEditable;
var solution = this.solution;
var prefix = solution.getPrefix();
require([“icm/base/Constants”,”icm/model/properties/controller/ControllerManager”],
function(Constants, ControllerManager){
require([“dojo/_base/declare”, “dojo/_base/lang”, “icm/base/Constants”,”icm/dialog/addcommentdialog/AddCommentDialog”,”icm/action/case/CaseAction”],
function(declare, lang,Constants, AddCommentDialog, CaseAction) {
console.log(“Prompt add work item comment dialog throughscript adaptor.”);
payload.coordination.participate(‘COMMIT’, lang.hitch(this,function(context, complete, abort) {
var workitemEditable =payload.workItemEditable;
try {
var workFlowName = workitemEditable.getWorkflowName();
//console.log(“workFlowName:” + workFlowName);
var myStepName =workitemEditable.getStepName();
var myCase = workitemEditable.getCase();
var commentAdded = false;
console.log(“myCase: ” + myCase);
console.log(“coord: ” + coord);
/*
if(context[Constants.CoordContext.WKITEMRESPONSE] ===”Process Request”)
*/
// If you use this condition, than it will be prompt at once whatever the response button name on work details page.
if(context[Constants.CoordContext.WKITEMRESPONSE] !==”abc”)
{
var addCommentDialog = new AddCommentDialog({
artifactType : “WorkItem”,
artifactLabel : myStepName,
commentContext :Constants.CommentContext.WORK_ITEM_COMPLETE,
caseModel : myCase,
workItem :workitemEditable.icmWorkItem,
onClickClose : function() {
if (commentAdded) {
complete();
}
else {
alert (“You have to provide your remarks on this case please.”);
abort({silent:true});
}
AddCommentDialog.prototype.onClickClose.apply(this,arguments);
}
});
dojo.connect(addCommentDialog.commentContentPane, “afterAddComment”,lang.hitch(this,function() {
commentAdded = true;
}));
addCommentDialog.show();
}
else
{
complete();
}
//});
//};
}
catch (exception) {
alert(exception);
abort();
}
}))
})
});
return payload;

Close the page, commit, and deploy the solution.
Open the work details page again to test your customization.
When a user clicks on particular response button, a new comments window will be appreard as described here:

If user clicks cancel on the prompt dialog, the event is not passed on and will remain on the page.

If user enters a reason in comments section and click OK, the case will be forwarded and a new comment will be added to the case.

On this tech note you can find the further information about all the payloads and events: https://www.ibm.com/docs/en/case-manager/5.3.0?topic=packages-case-manager-javascript-icmaction-package

IBM Case Manager (ICM), IBM Case Manager Client, IBM Content Navigator (ICN), WebSphere Application Server (WAS)

CDEWG3401 The Following View Definition Cannot be Found

November 29, 2021

CDEWG3401 the following view definition cannot be found error is received as a solution page. When multiple custom views associated with the page, loads in Case Manager client, and after solution deployment.

Error Description:

CDEWG3401 The following view definition cannot be found. Contact your system administrator to ensure that the solution is deployed correctly and that the correct view definition is configured for the Properties widget on this page.

Problem:

In addition, when you logon to IBM Content Navigator desktop and tries to open work item or case from case manager client, you might receive the below mentioned error:

Environment:

Case Manager (ICM) 5.3.x
Content Navigator (ICN) 3.0.6.x / 3.0.7.x
Content Platform Engine (CPE) 5.5.x
WebSphere Application Server (WAS) 9.0.5.x

Resolving Problem / Solution:

If you are on ICM 5.3.1.0 release, than please read this apar and make sure to apply fix pack as described here PJ44960.

However, error CDEWG3401 occurs when multiple users access the same IBM Case Manager from IBM Content Navigator using the same browser session. Morever, the security integration option is enabled in the WebSphere Application Server session management. To resolve this problem, just perform the following steps accordingly:

First of all, Logon to WebSphere Application Server admin console.
Secondly, Navigate to Application servers > server1 > Web container > Session management > Security Integration.
Uncheck or disable Security Integration option.
Apply and save these settings.
Restart the server where icn or icm is deployed.
Try to login again, you will see error or exception will not occurred again.

Furthermore, please visit the following tech notes for more details:

IBM Case Manager Client, IBM Content Navigator (ICN), WebSphere Application Server (WAS)

CWWIM4538E Multiple Principals Were Found

November 5, 2021

Multiple principals were found for the ‘xxxxxx’ principal name error has been logged in systemout.log file. This problem happens when ldap user tried to logon to IBM Case Manager or Content Navigator desktop that is, the user ID or password is not valid for the server. Here is the screenshot of the error:

Environment:

Case Manager 5.2.1.x / 5.3.3.x
Content Navigator 2.0.3.x / 3.0.x
Content Platform Engine 5.2.1.x / 5.5.x
WebSphere Application Server 7.0.0.x / 8.5.5.x / 9.0.5.x

Problem Description in System Log File:

Below is the error reported in systemout.log file:

[11/5/21 10:48:22:834 PKT] 0000001b LTPAServerObj E SECJ0369E: Authentication failed when using LTPA. The exception is CWWIM4538E Multiple principals were found for the ‘offr_user’ principal name.
[11/5/21 10:48:22:835 PKT] 0000001b SystemOut O CIWEB Error: [offr_user(unknown) @ 192.168.10.5] [REQUEST 17820] com.ibm.ecm.struts.actions.authentication.ContainerLogonAction.doContainerLogin() CWWIM4538E Multiple principals were found for the ‘offr_user’ principal name.
[11/6/21 10:50:22:836 PKT] CIWEB Error: [offr_user(unknown) @ 192.168.10.5] [REQUEST 17820] com.ibm.ecm.struts.actions.authentication.DesktopLogonAction.executeBaseAction() Failed to authenticate desktop.
com.ibm.websphere.wim.exception.PasswordCheckFailedException: CWWIM4538E Multiple principals were found for the ‘offr_user’ principal name.
at com.ibm.ws.wim.adapter.ldap.LdapAdapter.login(LdapAdapter.java:2760)
at com.ibm.ws.security.auth.ContextManagerImpl.runAs(ContextManagerImpl.java:5353)
sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
java.lang.reflect.Method.invoke(Method.java:600)

Solution:

Try the following steps accordingly:

Logon to WAS admin console.
Go to Security > Global Security > Federated repositories > Configure.
Under Repository Identifier, select the “Your’s”.
In additional properties, select Federated repositories entity types to LDAP object classes mapping.
Under Entity Type, select PersonAccount.
For Search filter, replace the default (ObjectCategory=User) with (&(objectCategory=User)(!(CN=))).
Click on apply and save the change. Below is the screenshot for reference.

Finally, restart the WAS JVM. Try to logon again through icm or icn desktop with the same user logon name, therefore you will see problem is resolved now.

For more details, please visit: https://www.ibm.com/mysupport/s/question/0D50z00005pgjYC/getting-error-when-logging-into-portaladmin-console-cwwim4538e-multiple-principals-were-found-for-the-xxx-principal-name?language=en_US

IBM Case Manager (ICM), IBM Case Manager Client

Dynamic in Basket Filter in IBM Case Manager

November 2, 2021

Dynamic in basket filter in IBM Case Manager can be achieved using scrip adaptor which is illustrated in this post. However, in-basket widget loads when the dynamic filter is received so that the results that are shown in the in-basket widget already are filtered to the case worker.

Environment:

Case Manager 5.2.1.x / 5.3.3.x
Content Platform Engine 5.2.1.x / 5.5.x
Content Navigator 2.0.3.x / 3.0.x
WebSphere Application Server 8.5.5.x / 9.0.5.x

Solution:

Therefore, perform the following steps:

First of all, In Case Manager Builder, open Page Designer on the Work page.
Secondly, drag the Script Adapter widget from the widget palette area to the main layout area.
Thirdly, wire the Script Adapter widget to the Page Container widget under the Incoming Events section by setting the following values:
- Source widget: Page Container
- Outgoing event: Page Activated
- Incoming event: Receive event payload
Click on add wiring in wiring setting.
Forthly, wire the Script Adapter widget to the Page Container widget under the Outgoing Events section by setting the following values:
- Outgoing Event: Send event payload
- Target widget: In-baskets
- Incoming event: Apply filter
Click on add wiring in wiring setting. As described here:

In addition, click the Edit Settings icon for the Script Adapter widget and paste the following code (Change the property, queue, and inbasket names accordin to your’s):

var myUser = ecm.model.desktop.userDisplayName;
var data = {
“queueName“:”ABC_Offr“,
“inbasketName“:”Offr“,
“hideFilterUI”:false,
“queryFilter“:”(ABC_OffrName = :A)”,
“queryFields”:[
{
“name”:”Offr Name“,
“type”:”xs:string”,
“value”:”*”
}
],
“hideLockedByOther”:”true”
};
data.queryFields[0].value = myUser;
var model = icm.model.InbasketDynamicFilter.fromJSON(data);
console.log(model);
var modelArray = [];
modelArray.push(model);
return {“dynamicFilters”:modelArray};

Importantly, click the Edit Settings icon for the In-baskets widget and select the Do not populate the in-basket until the dynamic filter is received option. Whereas, this ensures that the in-basket widget loads only when the filter is received.

Save and close the changes to the page within Page Designer. Furthermore, ensure that the newly created case property ABC_OffrName is available to the case type and the Offr in-basket.
Logon to icm desktop where you assigned relevant Offr name. However, It will check the logon display name to the property Offr to match and will display the case accordingly. At last, below is the example output:

Alternate Solution:

One more thing, if you want to grant access to particular users for specific case property values besides to match logon name than here is the sample code to achieve this requirement. Let’s say, if Case Property state vaue is ‘A’ than userA can see. Similarly, if value is ‘B’ than userB can view this case. In this scenario, you don’t need to bind the logon name property like AssignedtoUser to match with user display name. However, it will match the case property value to assigned user and display the relevant cases accordingly.

IBM Business Automation Workflow, IBM Case Manager (ICM), IBM Case Manager Builder

Multi Value Property Cannot be Added to In Baskets

November 1, 2021

Multi value property cannot be added / assigned into In-Baskets in IBM Case Manager (ICM) or Business Automation Workflow (BAW).

Problem:

While, developing and designing a solution in Case Builder, following problem has been identified or occurred:

First of all, create a multi value property in properties section of Builder.
Set its datatype either to string, float, integer, or data/time according to your requirement as described:

Similarly, use this property in the workflow as per your requirements.
When you’re going to add this multi value property to particular In-Basket, this property is not available to add because of its cardinality issue as mentioned here:

Environment:

Case Manager 5.3.3.x
Business Automation Workflow 19.0.0.x / 20.0.0.1
Content Platform Engine 5.2.1.x / 5.5.x
WebSphere Application Server 8.5.5.x / 9.0.5.x

Solution:

Multi values properteis cannot be added to in baskets either they are ordered or unordered list. Basically, the argument of this feature working in Case Manager 5.3.3.x is incorrect. Therefore, Case Manager 5.3.x did not have a federated in-basket which displays both FileNet P8 and BAW/BPM processes. However, it only displayed FileNet P8 process work items. Moreover, this is a feature gap that is still trying to address, and the plan is to available in a future release of BAW, potentially in the upcoming 20.0.0.2 release. Whereas, the workaround for this at the moment is:

First of all, use Process Portal to work with BAW processes (/ProcessPortal).
Secondly, in ICN use the Work Dashboard feature.

In addition, useful technote here which describes workarounds:

IBM Case Manager (ICM), IBM Content Platform Engine (CPE), IBM FileNet Workplace XT

DBExecute System Function Limitations in IBM FileNet P8

November 1, 2021

DBExecute system function basically a step or a parameter that can be used to run a stored procedure in a specific database. Before you run the workflow with the DbExecute system function, use Process Configuration Console to define the DbExecute connection in the workflow system properties first.

Obeviously, any database stored procedure that will be called by a system step must have all of its parameters declared as follows:

out – SQL Server
in out – Oracle
inout – DB2

Whereas. you can specify this step to insert or update values into the database table. However, stored procedure will return all the parameters defined in it accordingly. Moreover, database parameters types can be following:

String
Integer
Boolean
Float
Time

Remeber, parameters for a stored procedure cannot be arrays. For example, you can pass in multiple separate string parameters but you cannot pass in an array of separate strings as a single parameter. You can use a single element in an array by specifying its index. E.g. the syntax for specifying the first element in an array is fieldname[1] which is described in below image:

Handling parameters returned as null from stored procedures If:

String parameter is set to null by a stored procedure, the work object data item will receive an empty string.
Date/Time, integer, or float parameter is set to null by a stored procedure, an exception will be thrown. In addition, an explanatory message will be logged.
Boolean parameter is set to null, an exception will be thrown. Furthermore, an explanatory message will be logged.

Above all, please visit IBM documentation centre for further information about the dbexecute system function limitations: https://www.ibm.com/docs/en/filenet-p8-platform/5.2.0?topic=functions-dbexecute-system-function

IBM Case Manager (ICM), IBM Case Manager Client

Auto Populate Date and Time on Case Page

September 30, 2021

Auto populate date and time on a Case page is sometimes required. It is helpfulf to reduce time constraints for end users and make the system more effiecent.

Environment:

Case Manager 5.2.x / 5.3.x
Content Navigator 2.0.3.x / 3.0.x
Content Platform Engine 5.2.x / 5.5.x
WebSphere Application Server 8.5.x / 9.0.x

Solution:

Performing the following steps:

First of all, You must have Datetime property in Case Manager solution.

Place a script adapter on the add case or work details page.

Wire the Send New Case Info incoming event to script adapter as described below.

Use the sample script code to load the default date in the property control.
require([“icm/model/properties/controller/ControllerManager”],
function(ControllerManager) {

var collectionController = ControllerManager.bind(payload.caseEditable);
var invDateController= collectionController.getPropertyController(“ICMFieldDate”);
currentDate = new Date();

invDateController.set(“value”,currentDate);
pstate.set(“value”,pstatevalue);
});
return payload;

Save and close the page.

Commit and deploy the solution.

Test the case by adding a new case type where you implement changes for auto populate date and time. After the page load, you will see datetime field is populated with current date/time.

More details: https://www.ibm.com/support/pages/case-manager-how-auto-populate-datetime-field-case-page

Older Posts

Archives

Configuring Logs Size in IBM FileNet

Environment:

Solution:

How to Change Wasadmin Password in WebSphere

Cause:

Environment:

Solution:

For JYTHON:

AlFresco Your Authentication Details have not Been Recognized

Envirnonment:

Solution:

How to Make Comments Required on Work Details Page in Case Manager

Environment:

Solution:

CDEWG3401 The Following View Definition Cannot be Found

Error Description:

Problem:

Environment:

Resolving Problem / Solution:

CWWIM4538E Multiple Principals Were Found

Environment:

Problem Description in System Log File:

Solution:

Dynamic in Basket Filter in IBM Case Manager

Environment:

Solution:

Alternate Solution:

Multi Value Property Cannot be Added to In Baskets

Problem:

Environment:

Solution:

DBExecute System Function Limitations in IBM FileNet P8

Handling parameters returned as null from stored procedures If:

Auto Populate Date and Time on Case Page

Environment:

Solution:

Subscribe