Known problems and solutions
These troubleshooting topics provide descriptions of and
solutions or workarounds for problem situations that you might encounter.
Refer to this troubleshooting information to understand what condition
or event generated your problem situation and to find out what you
need to do to recover from or work around a problem, or to prevent
a recurrence of the problem.
Installation issues when running with xServer technologies
Running an installation under various xServer technologies can cause various issues with the installation process.
Content Platform Engine installation fails: A later version is detected (Cannot downgrade error)
The Content Platform Engine Server/Client/Content Search Services installation fails with the error message that states that a Content Platform Engine downgrade is not possible.
Newer Java versions can cause native out of memory problems in the Content Platform Engine Application server
When running in a WebSphere configuration, the Content Platform Engine uses a Java JRE provided by WebSphere. In newer versions of Java, the IBMJCEPlus security provider is now listed ahead of the IBMJCE security provider in the java.security configuration file. In the JRE versions before 8.0.7.15, this change in the provider list can cause out of memory problems in Content Platform Engine over a duration of time when content encryption is enabled (content encryption is enabled by default).
Removing invalid security IDs
If the access settings for a document or object include an expired or invalid Security ID (SID), you cannot update the access settings until you remove the expired or invalid SID.
Errors when trying to retrieve a document shortly after adding
NFS directory attribute caching can cause errors when you try to access newly added content.
The New Domain wizard freezes and cannot recover
The New Domain wizard in the Administration Console for Content Platform Engine can freeze when an incorrect value is entered for the Configure key management parameters.
Unexpected characters display in installation text files
Unexpected characters are found in installation related response files.
Content Search Services uninstaller fails in silent mode
Running the Content Search Services uninstaller in silent mode throws an exception and the uninstall fails.
The Content Platform Engine administration console does not perform as expected in Internet Explorer
The administration console might not work correctly in Internet Explorer.
Login to the Content Platform Engine administration console fails after upgrade (WebLogic application server)
The administration console login on WebLogic might not work correctly after an upgrade.
Connection exceptions for the HTTPS protocol on IBM Cloud Object Storage
IBM Cloud Object Storage only supports TLS v1.1 or v1.2 HTTPS protocols.
Database connection times out with errors (Oracle database)
The database connection times out with Oracle errors.
Creating a database index on a property fails: Index limit reached (Microsoft SQL Server database)
Attempting to add a database index on a property results in an error indicating that the index limit has been reached.
Creating a database index on a property fails: Transaction timeout (Microsoft SQL Server database)
Attempting to add a database index on a property results in an error indicating that the transaction timeout has occurred.
Adding a property definition to a class definition fails: Database row length limit exceeded (Db2 database)
Attempting to add a property to a class results in an error indicating that the maximum allowable length has been exceeded.
Setting a property value on an object fails: Maximum allowable length exceeded (Microsoft SQL Server database)
Attempting to set a property value on an object results in an error indicating that the maximum allowable length has been exceeded.
CBR queries fail after the creation of the first index area (Oracle database)
Content-based retrieval (CBR) queries can fail when run less than two minutes after the creation of the first index area.
Queries do not find objects as expected (Oracle database)
Queries for objects can return unexpected results.
Timeout occurs when using CBR Query Optimization
When you use the CBR Query Optimization feature, the IBM® Content Search Services (CSS) server throws a timeout exception.
Microsoft JDBC Driver for SQL Server is not found during creation of a JDBC data source
Creation of a JDBC data source fails during configuration of Content Platform Engine .
Deadlock errors on SQL Server
Deadlock errors result with high concurrency on SQL Server .
Intermittent "socket closed" exception with Active Directory
Content Platform Engine might throw a "socket closed" exception when the LDAP provider is Microsoft Active Directory .
Content Platform Engine does not deploy
If Content Platform Engine does not deploy, you must verify that you have set up your system correctly.
JavaScript action handler fails (WebLogic application server)
An action handler implemented as a JavaScript script can fail in some WebLogic configurations.
SearchScope.fetchObjects with the continuable parameter returns an error (WebLogic application server)
When using the Content Engine Java or .NET API, a call to SearchScope.fetchObjects with the continuable parameter returns an error.
Content Engine Web Service clients get Microsoft Web services error WSE839
Client applications that use Content Engine Web Service (CEWS) directly or through the Content Engine .NET API get a misleading exception that references Microsoft Web services error WSE839.
Client application returns connection pool errors
If you receive a data source-related error message from the application server, you might need to increase the size of the data source connection pool.
Content Platform Engine failed to deploy
If Content Platform Engine does not deploy, you should verify your configuration settings and make the appropriate changes.
A FileDoesNotExist error occurs during a thumbnail sweep
If you get a FileDoesNotExist error during a thumbnail sweep, you need to increase the thumbnail generation delay.
Content Platform Engine generates thumbnail images with incorrect fonts or garbled characters
If you convert vector graphics format documents on a UNIX system and the required fonts are not available, thumbnail images might render incorrectly.
Content Cortex automatic upgrade fails during the domain upgrade phase
The domain upgrade phase of the automatic upgrade of a Content Cortex domain that contains dozens or more object stores might last more than a few seconds. This lag time can cause the automatic upgrade to fail if you use the Content Cortex System Health page or log on to the Content Cortex domain from the administration console or other applications during this domain upgrade phase of the automatic upgrade from version 4.5.1 to version 5.2.0 of Content Cortex .
GUI version of Configuration Manager starts and quickly exits
When you start the GUI version of Configuration Manager, the application starts and quickly exits.
Deleting a sweep job fails when there are a large number of sweep result records
Attempts to delete a bulk move content job, a retention update job, a thumbnail generation job, or a custom sweep job fails when the job has a large number of sweep result records associated with it.
Users cannot retrieve content after all replicas are restored
The Content Platform Engine (CPE) is not yet aware that replicas are back online.
Java applets are not run when you use a Chrome browser
Attempting to run Java™ applets with a Chrome browser returns an error that the plug-in is not supported.
Finding additional problem/solution information
If you cannot find a solution to a problem that you encounter when you use Content Platform Engine , use the resources listed in this topic to discover additional solution information.