- 199 Views
- 0 Comments
XA and non-XA
FunMaster
- Post By FunMaster
- 3 months ago
๐น Datasource vs. XA / Non-XA Datasource in FileNet
When you configure FileNet in WebSphere Application Server (WAS), you set up JDBC datasources for:
-
GCD (Global Configuration Database)
-
Object Store Database(s)
The choice between XA vs. non-XA affects how transactions are managed.
1. Non-XA Datasource
-
A simple JDBC datasource, without support for distributed (global) transactions.
-
It participates in local transactions only (within a single database connection).
-
Lower overhead, faster performance.
-
Works fine if FileNet only interacts with one database per transaction.
Use case in FileNet:
-
GCD database (common choice).
-
Object Store database if no distributed transactions are expected.
2. XA Datasource
-
XA (eXtended Architecture) datasource supports two-phase commit (2PC).
-
Required when a single transaction spans multiple resources, e.g.:
-
More than one database (e.g., GCD + Object Store together).
-
Database + JMS (messaging).
-
-
Ensures atomicity across multiple systems (all succeed or all rollback).
-
More overhead than non-XA (slightly slower).
Use case in FileNet:
-
Typically used for Object Store datasource(s), because workflows or CE operations can touch GCD + OS + event queues in the same transaction.
-
Recommended for production if you want full transactional integrity.
3. Datasource in Configuration Manager
In FileNet Configuration Manager, you usually create two datasources for each database:
-
Non-XA datasource โ used by FileNet for schema creation / bootstrap tasks.
-
XA datasource โ used by FileNet Runtime (CE, PE, ICN) for transactional operations.
IBM best practice:
-
Define both XA and non-XA datasources for GCD and each Object Store.
-
CE uses XA at runtime for safe transactions.
-
Some internal tasks or tools fall back to non-XA (e.g., bootstrap, upgrade scripts).
โ๏ธ Summary Table
| Type | Transaction Scope | Overhead | FileNet Usage |
|---|---|---|---|
| Non-XA | Local (single DB only) | Lower | Bootstrap, schema creation, lightweight DB ops |
| XA | Global (multi-DB, multi-resource) | Higher | Runtime CE ops, Object Store + GCD + JMS transactions |
โ Best Practice in FileNet P8 5.2.1
-
Create both XA and Non-XA datasources for GCD and Object Stores in WAS.
-
Point Configuration Manager correctly (bootstrap โ non-XA, runtime โ XA).
what are the log files related to IBM FileNet P8, their names, path
in IBM FileNet P8 the log files you check depend on
the component (CPE, ICN, Workplace, ACCE, Process Engine, etc.) and the
underlying application server (WebSphere, WebLogic, or Tomcat) and database.
Hereโs a breakdown of the common log files, default names, and paths
youโll find in a typical installation:
๐น 1. Content Platform
Engine (CPE) logs
- Application
server logs (WAS/Tomcat):
- WebSphere:
- <WAS_HOME>/profiles/<profile_name>/logs/<server_name>/SystemOut.log
- <WAS_HOME>/profiles/<profile_name>/logs/<server_name>/SystemErr.log
- Tomcat:
- <TOMCAT_HOME>/logs/catalina.out
- CPE-specific
logs (if trace enabled):
- <WAS_HOME>/profiles/<profile_name>/logs/<server_name>/P8_server_trace.log
- Sometimes
configured under <P8_domain>/FileNet/ContentEngine/logs/
๐น 2. Process Engine (PE)
logs
- Located
in the Process Engine Server directory:
- <PE_install_dir>/FileNet/ProcessEngine/logs/pe.log
- Other
log files: vwtool.log, vwagent.log
- Application
server logs also apply (SystemOut/SystemErr for WAS).
๐น 3. IBM Content
Navigator (ICN) / ACCE logs
- Default
log location (WebSphere):
- <WAS_HOME>/profiles/<profile_name>/logs/<server_name>/navigator.log
- <WAS_HOME>/profiles/<profile_name>/logs/<server_name>/acce.log
- For ICN
plug-ins:
- Same
path, plugin-specific logs appear in navigator.log.
๐น 4. Application Engine
(AE / Workplace XT) logs
- Logs
are captured in the app server logs:
- WebSphere:
SystemOut.log, SystemErr.log
- Tomcat:
catalina.out
- Optional
trace logs configured in ae_config.xml.
๐น 5. Database logs
- Depends
on DB:
- DB2:
<DB2_instance>/sqllib/db2dump/db2diag.log
- Oracle:
$ORACLE_BASE/diag/rdbms/<dbname>/<SID>/trace/alert_<SID>.log
- SQL
Server: Found in SQL Server Error Logs (SQL Server Management Studio
โ Management โ SQL Server Logs).
๐น 6. Directory/Authentication
logs
- If
using LDAP/AD via WebSphere:
- <WAS_HOME>/profiles/<profile_name>/logs/<server_name>/SystemOut.log
(SECJ**** messages).
- For
failed LTPA/JAAS authentication issues โ same WebSphere logs.
๐น 7. Installation &
Upgrade logs
- Located
under:
- <FileNet_install_dir>/FileNet/Logs/
- config_trace.log,
config_install.log (from FileNet Configuration Manager).
โ
Quick tip for
troubleshooting:
- CPE/ICN
issues โ navigator.log, acce.log, P8_server_trace.log
- Workflow
issues โ pe.log, vwagent.log
- Auth/SSO
issues โ SystemOut.log / SystemErr.log
- DB/storage
issues โ database error logs, plus SystemOut.log
list the urls required to check if IBM FileNet P8 is running goodd or not,
like Content Engine, Health
๐น Content Engine (CPE)
- Ping
servlet (basic health check):
- http://<host>:<port>/wsi/FNCEWS40MTOM/ping
- Returns
PONG if Content Engine is up.
- WSDL
for Web Services:
- http://<host>:<port>/wsi/FNCEWS40MTOM?wsdl
- If
WSDL loads, CE web services are running.
- CPE
Health page (since 5.2.1+):
- http://<host>:<port>/cpe/Health
- Shows
a JSON/XML-style status of CE components.
๐น Workplace XT (if
installed)
- Landing
page:
- http://<host>:<port>/WorkplaceXT
- Confirms
if Workplace XT is deployed.
๐น Administration Console
for Content Platform Engine (ACCE)
- ACCE
login page:
- http://<host>:<port>/acce
- If
it loads, the app is up and talking to CE.
๐น Process Engine (PE)
- No
direct ping servlet, but you usually confirm via Process Administrator
/ Process Designer:
- http://<host>:<port>/peengine/Health
- (On
some setups, /peengine/Health or /peengine/ping is enabled if PE is
deployed with CE.)
- Otherwise,
test by logging in through ACCE โ Process Engine.
๐น ICN / Content Navigator
(if used)
- Navigator
health check (since 3.0.6+):
- http://<host>:<port>/navigator/Health
- Shows
health of ICN and CE connectivity.
- Navigator
login page:
- http://<host>:<port>/navigator
โ
Typical minimal checks after
FileNet P8 install:
- CPE
ping โ /wsi/FNCEWS40MTOM/ping
- CPE
health โ /cpe/Health
- ACCE
โ /acce
- ICN
health (if installed) โ /navigator/Health
give me CPE, WAS log file names and their path
When you want to verify IBM FileNet P8 Content Platform
Engine (CPE) and WebSphere Application Server (WAS) are running
fine, the log files are your best friend. Hereโs the breakdown:
๐น WebSphere Application
Server (WAS) Logs
These are the container logs โ if WAS isnโt up, CPE
wonโt even start.
- SystemOut.log
โ main server log (runtime messages, including CPE startup).
- SystemErr.log
โ error messages and stack traces.
๐ Typical paths
(Windows/Linux):
<WAS_HOME>/profiles/<profile_name>/logs/<server_name>/SystemOut.log
<WAS_HOME>/profiles/<profile_name>/logs/<server_name>/SystemErr.log
Example (default install):
C:\Program Files
(x86)\IBM\WebSphere\AppServer\profiles\AppSrv01\logs\server1\SystemOut.log
C:\Program Files
(x86)\IBM\WebSphere\AppServer\profiles\AppSrv01\logs\server1\SystemErr.log
๐น Content Platform Engine
(CPE) Logs
CPE itself logs under the WAS profile too (same logs/server1
dir by default).
- p8_server_out.log
โ CPE-specific log (runtime, deployment, CE web service messages).
- p8_server_error.log
โ CPE-specific error log.
- p8_console.log
(sometimes present, depending on config).
๐ Typical paths:
<WAS_HOME>/profiles/<profile_name>/logs/<server_name>/p8_server_out.log
<WAS_HOME>/profiles/<profile_name>/logs/<server_name>/p8_server_error.log
๐น Other Helpful Logs
- trace.log
(if you enable tracing in WAS).
- federated.log
(if LDAP/SSO issues).
- native_stderr.log
/ native_stdout.log โ JVM native errors.
โ
Quick check after CPE
startup:
- Open
SystemOut.log โ search for CPEWS or CPE startup complete messages.
- Check
p8_server_out.log โ should show "Server startup complete" or "Ping
servlet initialized".
- Then
test the /wsi/FNCEWS40MTOM/ping URL.
give me 5 IBM FileNet P8 known issues people face on day-to-day basis
during Managed services?
in FileNet P8 Managed Services, most day-to-day
issues are less about โbugsโ and more about operations, tuning, and
integration pain points.
Here are 5 common, real-world issues that admins and managed services
teams frequently encounter:
๐น 1. Authentication &
LDAP/SSO Problems
- Symptoms:
Users canโt log in to ICN/ACCE, errors like CWWIM4537E No principal is
found or LTPA token expiration.
- Causes:
Password expired in AD/LDAP, sync delays, SSO misconfiguration, clock skew
between servers.
- Impact:
Blocks user access to CPE, ICN, Process Engine.
- Fix:
Reset credentials, resync LDAP, check WAS security config, verify
Kerberos/SSO setup.
๐น 2. Indexing / Search
Failures (CE <-> Index Area / Elasticsearch / SOLR)
- Symptoms:
Documents ingested but not searchable, full-text search returns no
results.
- Causes:
Index dispatcher stopped, IndexArea errors, misconfigured text search
servers.
- Impact:
Business users canโt search documents efficiently.
- Fix:
Restart index dispatcher, clear stuck queue, check FT search logs (p8_server_error.log).
๐น 3. Connection Issues
Between CE, PE, ICN
- Symptoms:
ICN login works but workflows fail, error like โPE server not
availableโ or โUnable to connect to Process Engineโ.
- Causes:
Incorrect PE connection point, network/firewall issues, SSL certs expired,
WAS JVM heap exhaustion.
- Impact:
Workflows stop or queue up.
- Fix:
Validate PE connection points, refresh SSL certs, recycle WAS JVM, tune
connection pool.
๐น 4. Content Retrieval /
File Store Access Errors
- Symptoms:
โYou do not have permissionโ or โFile not foundโ when opening docs.
- Causes:
Storage area misconfig, NTFS/GPFS permissions, filestore path mismatch,
object store mislinked.
- Impact:
Users canโt view critical documents.
- Fix:
Verify storage area paths, OS-level permissions, CE storage policy
mappings.
๐น 5. Performance &
JVM Heap Issues
- Symptoms:
CPE/ICN becomes slow, frequent OutOfMemory in SystemErr.log, WAS threads
stuck.
- Causes:
Large queries, insufficient heap size, unoptimized ICN desktop config, too
many concurrent workflow tasks.
- Impact:
User frustration, outages, SLA breaches.
- Fix:
JVM tuning (heap, GC policy), cache cleanup, query optimization, archiving
old workflow data.
โ
Other โhonorable mentionsโ:
- Stale
LTPA tokens after password change.
- Workflow
roster table growing huge (needs cleanup).
- Content
Navigator plug-in misbehaving after upgrade.
- SSL
certificate expiry (very common in managed services).
how to know which version of IBM FileNet P8 is running on your system
๐น 1. Check via Content
Engine Ping Servlet
- Open
in browser (or curl):
- http://<host>:<port>/wsi/FNCEWS40MTOM/ping
- If
CPE is running, it will return PONG + version info like:
- PONG (5.5.8.0) Build 20231215-1500
โ
Quickest way for admins.
๐น 2. CPE Health Page
(newer versions, 5.2.1+)
- Go
to:
- http://<host>:<port>/cpe/Health
- Shows
JSON/XML including CPE version, build, uptime.
๐น 3. Administration
Console for Content Engine (ACCE)
- Log
in:
- http://<host>:<port>/acce
- On About
(top right corner), youโll see the version/build string.
๐น 4. WebSphere
Application Server (WAS) Logs
- Open
SystemOut.log or p8_server_out.log after startup.
- Look
for messages like:
- CPEWS0017I: Content
Engine version 5.5.8.0 (Build 20231215-1500) started successfully
๐ Typical path:
<WAS_HOME>/profiles/<profile_name>/logs/<server_name>/SystemOut.log
๐น 5. JAR Manifest (if you
have file access)
- Navigate
to deployed EAR in WAS:
- <WAS_HOME>/profiles/<profile_name>/installedApps/<cell_name>/FileNetEngine.ear
- Open
FileNetEngine.war/META-INF/MANIFEST.MF โ contains version string.
โ
In daily Managed Services:
Most admins just hit the ping servlet or check logs after restart
to confirm version/build.
how many maximum rows can be created? What is the capacity of docversion
table in IBM FileNet P8? How many object stores can be created in IBM FileNet
P8?
๐น 1. Maximum rows in a
table (like DocVersion)
- FileNet
P8 stores metadata in a relational database (DB2, Oracle, SQL
Server).
- So
the maximum rows depend on the underlying database limits (not
FileNet itself).
๐ Typical database row
capacity:
- DB2:
up to ~2^64 rows (effectively unlimited for FileNet).
- Oracle:
~1.84 ร 10^19 rows per table.
- SQL
Server: ~2 billion rows per table (2,147,483,647).
โ
In practice, billions of
rows are supported, but performance and storage become the real bottlenecks
long before DB limits are reached.
๐น 2. Capacity of DocVersion
table
- The
DocVersion table stores metadata about document versions in an
object store.
- Each
document version = 1 row.
- Capacity
is therefore limited by DBMS, storage, and hardware โ not by FileNet hard
caps.
- IBM
tested scalability shows tens/hundreds of millions of documents per
object store with stable performance, provided DB indexes, partitions, and
archiving are well managed.
๐ก Best practice:
- Use partitioning
or multiple object stores if expecting >500 million docs
in one OS for manageability.
๐น 3. How many Object
Stores can be created in FileNet P8?
- Technically,
you can create hundreds of Object Stores in a single P8 domain.
- IBM
documentation suggests the limit is governed by environment resources,
not by a fixed number.
- Real-world
deployments:
- Many
enterprises run with 5โ20 object stores (separating apps/business
units).
- Some
managed services run 100+ object stores in a domain.
โ
No hardcoded max โ but
the more object stores, the higher the load on:
- Domain
database
- Directory
configuration
- CPE
startup time
- Administration
(schema upgrades must run on all OS).
๐ธ Summary Table
|
Component |
Limit / Capacity |
|
DocVersion rows |
Depends on DB (billions possible; practically limited by
storage/performance) |
|
DocVersion table size |
Each row = one version; real-world: hundreds of millions
of versions per OS |
|
Object Stores |
No hardcoded max; hundreds possible, but best practice =
< 50 per domain for admin simplicity |
โ ๏ธ Managed Services Best
Practice:
- Plan
archiving strategy (move old docs to CMOD or cheaper storage).
- Use multiple
object stores for isolation if dataset will exceed 500Mโ1B rows.
- Always monitor DB growth and index fragmentation.