Troubleshooting

11.1 Decimal Field Error

Imaging supports 15 digits of precision independent of the location of the decimal separator. Note the min/max values are not inclusive. Some examples:

Scale of 2:

Value must be less than 10,000,000,000,000.00
Value must be greater than -10,000,000,000,000.00

Scale of 5:

Value must be less than 10,000,000,000.00000
Value must be greater than -10,000,000,000.00000

11.2 Imaging and Windows Server Prerequisites

Imaging uses Oracle Outside In Technology which requires certain libraries to be installed that are not part of Imaging. These libraries must be installed on the Imaging server, Content Server, and client machines using the advanced viewer mode, regardless of the machine platform. For more information on what libraries are required for each platform and how to obtain, install, and configure them, see the Installing and Configuring Oracle WebCenter Content.

11.3 NULL Number Fields

When a search is executed on an application with a number field that returns hits with documents with nothing entered in a number field, either a 0 or a -1 appears in the field. When an application containing documents is modified to have a number field, the search returns -1 for those documents. When a document is uploaded and the number field is left blank, the search returns 0. If a search is executed with the number field as a condition, they are treated as empty fields and when viewed in Content Server, the fields are empty.

The null number field issue is a result of Content Server functionality.

11.4 Full-Text Search Fails On Large Documents

By default, the maximum document size that will be indexed is 10MB. This is changed by setting the MaxIndexableFileSize configuration variable in the Content Server repository. The default is MaxIndexableFileSize=10485760. If larger documents require full-text indexing, the value of MaxIndexableFileSize should be increased.

11.5 Repository Capacity Errors

Each Imaging application that is created increases the structure complexity of the underlying Content Server repository. Imaging monitors multiple factors to estimate when then structure complexity of its Content Server might be hampering its performance. Once that threshold is exceeded, the Imaging system will consider the Content Server to be full and no longer allow the creation of new applications. The factors used to calculate fullness are configurable and are listed below. This fullness is a reflection of structural complexity of the Content Server, not its ability to continue to accept additional documents. To resolve fullness issues the configuration values below can be adjusted, provided the Content Server system continues to perform well, or an additional Content Server installation can be used to contain new Imaging applications.

A Content Server repository is considered full if any of the following are true:

The number of security groups exceeds the value of the environment variable IpmMaxGroupLimit.
The number of roles assigned permission to security groups exceeds the value of the environment variable IpmMaxGroupRoleLimit.
The number of metadata fields exceeds the value of the environment variable IpmMaxMetadataFields.
The Content Server configuration setting IpmRepositoryForceFull=True

Setting IpmRepositoryForceFull equal to True allows you to configure Content Server to identify itself as full to Imaging in order to prevent additional applications from being created. This does not prevent documents from being uploaded.

To get additional space for applications, do one of the following:

Install an additional independent WebCenter Content system and define a new connection to it in Imaging. For information on how to configure an additional Content Server repository, see the Oracle Fusion Middleware Administering Oracle WebCenter Content guide.
Increase the values of the IpmMaxGroupRoleLimit and IpmMaxMetadataFields environment variables by editing the config.cfg file directly or by using the Content Server administrative server. For more information about changing Content Server environment variables, see the Oracle Fusion Middleware Administering Oracle WebCenter Content guide.

You can also change these environment variable values in the config.cfg file for your Content Server Repository. For more information, see the Oracle Fusion Middleware Administering Oracle WebCenter Content guide.

11.6 Font Errors

Documents with text content require the fonts necessary to render the document to be available to the Oracle Outside In rendering engine, which uses TrueType fonts. Fonts are not provided by Oracle. If the font used in a document is not available to Oracle Outside In, then a suitable substitute will be used. Font substitutions can cause a document to be unreadable, create incorrect text formatting, or cause shifting of data or repagination on text documents, including potentially exposing redacted content.

Indicators of font problems are when a document renders properly in the advanced Viewer mode but not the basic Viewer mode, or if TIFF documents display properly but rendered Microsoft Office documents do not.

To ensure that proper fonts are used when rendering documents, the administrator should install them to the client and server system. The server MBean GdFontPath should be set to the directory where the fonts are installed. For more information on setting MBeans, see Configuring MBeans.

When using the advanced viewer mode on Linux systems, the fonts can be installed and the environment variable GDFONTPATH set to that directory. If the environment variable is not found, the user will be prompted for that path the first time the advanced viewer mode is used. In cases where an attempt to download a document as a TIFF before the path is set, an error may occur that prevents downloading the TIFF rendition.

11.7 Input Agent and Input File Issues

The following issues involve input agents or input files.

11.7.1 Input Agent Will Not Detect and Process Input Files

If the input agent will not pick up input files, try the following steps to determine a solution.

Check the settings of the following Imaging MBeans:
- CheckInterval: Make sure this is set to a reasonable amount of time for your environment (for example, maybe 1 minute for test systems or 30 minutes for production systems that do not need to get data right away) and ensure that enough time has expired for at least one polling interval to have occurred.
- InputDirectories: Examine the list of directories and ensure that they are the correct directories where the input files are stored.
Ensure that the input file has Read/Write permissions for WebLogic Server.
Check the permissions on the input directory paths and make sure they are accessible to the user that is running the WLS managed server.
Look at the input definition in the user interface and make sure the input that is supposed to be processing is marked online and that the input file mask matches the files that are in the directory.
If the input agent is still not running then examine the log files to see if an error was encountered that is preventing the agent from functioning.

11.7.2 Auto-detect Not Determining Character Set

Auto-detect does not work if the provided sample file is not large enough to get an accurate determination of the character set. If the sample file is too small, disable Auto-detect input file character set and manually select the character set.

11.7.3 Input File Entries Have Errors

For the steps below, refer to the following directory structure:

Input
   - Errors
   – Processed
      — YYYY-MM-DD
   – Samples 
   – Stage

If some or all of the entries in the input file have errors, try the following steps to determine a solution.

Look at the Errors directory in which the input file was placed and see if an error file was created. If an error file exists, then open it and examine the last column of the file to determine the specific error.
Examine the input file and verify that the path to the image file is accessible to the user that is running the Imaging managed server and that the user has permissions to the path and image files.
Copy one of the failing input files to the samples directory and load it into the input definition editor UI. Verify that the mappings are correct and that one of the columns has not shifted.
Finally, look at the Imaging log file and examine the errors that are listed for the individual lines to determine the exact cause of the problems.

Once you have determined the cause of the error and are able to correct it, copy the corrected input file back into the input directory. For additional information, see Checking Results and Error Files.

11.8 Advanced Viewer Transformation Errors

In cases where the advanced viewer applet experiences transformation errors, the first response is to delete temporary files on the user's workstation. Doing so will remove the distribution of Oracle Outside In files which will cause a new deployment next time the applet is used. In a Windows environment, do the following to clear temporary files:

Select Java from the Windows Control Panel options.
Click Settings under Temporary Internet Files.
Click Delete Files.
Close the Java control panel.
In Windows Explorer, navigate to the user's temporary file location. For example, c:\users\<user-id>\AppData\Local\Temp\oracle\imaging\imaging-client
Delete the files in the imaging-client directory.
Use the browser's options to delete its temporary internet files.
Use the Windows Disk Clean Up tool to clean any other temporary files.

11.9 Problems with TIFF Display in Viewer

The Advanced Viewer and Basic Viewer modes render Group 6 and Group 7 TIFFs, however, Group 6 TIFFs are supported only when the viewer cache is enabled. Group 6 TIFFs are not supported on non-cache systems. See Configuring Viewer Cache Options for more information on how to configure the viewer cache options. Group 7 TIFFs must conform to the TIFF standard for JPEG compression. Color images should use YCbCr for photometric interpretation or the image will be treated as a grayscale image. YCbCr is the standard color for JPEG images.

11.10 Logging of ImagingException

By default, not all exceptions caught within Imaging are logged. In the event that all exceptions need to be monitored, the following steps will help identify all exceptions thrown. Imaging exception handlers do not inherit a log level from a parent logger (oracle.imaging.service). To get exceptions from the core Imaging services, you must explicitly set the logger named oracle.imaging.service.exceptions.To enable some degree of flexibility, it uses the following log levels:

ERROR 1(SEVERE): Logs SYSTEM and DATABASE ImagingExceptions
NOTIFICATION(INFO): Logs SYSTEM, DATABASE, and SECURITY ImagingExceptions
TRACE(FINE): Logs SYSTEM, DATABASE, SECURITY, and USAGE ImagingExceptions

For example, all ImagingExceptions would be logged at throw time by setting oracle.imaging.service.exceptions to TRACE:32.

11.11 Tracking Events in the Imaging and Content Server Log Files

When investigating events in Imaging, start with the Imaging log files. In cases where the event occurs in Content Server, reviewing the Content Server log files may provide additional information. Both Imaging and Content Server logs can be viewed in Oracle Enterprise Manager. The Content Server logs can also be viewed from the Content Server administrative links.

Tracing sections can be enabled in Content Server for more or less detail in the logging information. The IpmRepository component installed into Content Server does not generate its own logging, but includes entries into the standard Content Server logs. Turn on tracing for the section named ipmrepos in Content Server for detailed logging information of the IpmRepository component. For more information about Content Server logging, see Monitoring Content Server Status in Administering Oracle WebCenter Content.

11.12 Using Oracle Dynamic Monitoring System with Imaging

Oracle Dynamic Monitoring Service (DMS) can display statistics of your system using the Oracle DMS Spy application to aid in troubleshooting and diagnostics. The Oracle DMS Spy application is launched by entering http://machine_name:port/dms/ into your browser URL address field. The following metric tables are available:

Metric Table	Description
IPM_API	Records timing statistics on imaging API operations. Statistics are recorded on a per service operation basis.
IPM_Activity	Records general system activity. Counts of system activity occurrences are recorded including: API Operations Documents Created Documents Retrieved Input Agent Documents Input Agent Errors Input Files Processed Login Logout Render Annotation Cache Retrieval Render Transformed Document Cache Retrieval Render Transformed Document Generation Search Executions Workflow Instances
IPM_BPEL_Agent	Records workflow process instance injection statistics on a per imaging application basis.
IPM_Input_Agent	Records input process instance statistics on a per imaging input basis
IPM_Rendering	Records detailed metrics on the rendering subsystem including details on:
IPM_Repository	Records detailed metrics on repository calls.
IPM_Search	Records Imaging search execution timings. Statistics are recorded on a per search definition basis.
IPM_UCMRequest	Records detailed metrics on requests to Universal Content Server.
AXF_API	Records timing for AXF (Oracle Application Adapters for ECM) operations in the system infrastructure, commands, and user interface.
AXF_BPEL_API	Records timing for AXF (Oracle Application Adapters for ECM) operations which communicate to the workflow server.

11.13 Reviewing Audit History of Deleted Documents

If documents are deleted from Imaging, administrators can view the entry for the delete action in the Content Server DocumentHistory table. This is the only place for administrators to view audit entries for deleted documents.

11.14 Deciphering Nested Stack Errors

A nested stack error, also called a nested exception, is basically an error that has been wrapped by another error, which is standard with Java and other languages to help provide more context to the issue. You can usually find the nested exception by locating the caused by string in the stack trace as shown in bold in the following example. If there is not enough information provided by the Imaging error, look deeper into the error message to see if other components are involved. Imaging uses nested stack errors to display repository related problems, workflow issues, or problems caused by other components. After you locate the possible initial error, check the diagnostic logs for more troubleshooting information.

In the following example, the TCM-00787 error is occurring because the default provider within the Content Server repository was not available.

A repository error occurred.[[
oracle.imaging.ImagingException: TCM-00787: A repository error occurred.
              stackTraceId: 1-1495706154774
              faultType: SYSTEM
              faultDetails:
                ErrorCode = oracle.stellent.ridc.protocol.ServiceException, ErrorMessage = File 'provider.hda' does not exist.
              at oracle.imaging.repository.ucm.UcmErrors.convertRepositoryError(UcmErrors.java:125)
              at oracle.imaging.repository.ucm.UcmLifecycleOperationImpl.getStorageRules(UcmLifecycleOperationImpl.java:60)
              <...snip...>
              at weblogic.work.ExecuteThread.execute(ExecuteThread.java:406)
              at weblogic.work.ExecuteThread.run(ExecuteThread.java:346)
Caused by: oracle.stellent.ridc.protocol.ServiceException: File 'provider.hda' does not exist.
              at oracle.stellent.ridc.protocol.ServiceResponse.getResponseAsBinder(ServiceResponse.java:142)
              at oracle.stellent.ridc.protocol.ServiceResponse.getResponseAsBinder(ServiceResponse.java:108)
              at oracle.imaging.repository.ucm.UcmResponse.<init>(UcmResponse.java:69)
              at oracle.imaging.repository.ucm.UcmRequest.makeOneServiceCall(UcmRequest.java:561)
              at oracle.imaging.repository.ucm.UcmRequest.makeServiceCall(UcmRequest.java:276)
              at oracle.imaging.repository.ucm.UcmLifecycleOperationImpl.getStorageRules(UcmLifecycleOperationImpl.java:55)

11.15 Imaging Session Time Out When Using OSSO Requires Browser Refresh

When using Oracle Single Sign On, POST requests to WebLogic Server will return an internal server error when the Imaging session has expired. Refreshing the page returns to the Imaging log in page for reauthentication to start a new session.

11.16 Doc URL Returned With Invalid IP Address

Users that are getting a host name or IP address that they don't expect for the document URL probably need to configure the Listener Address in their WLS server. This can be done either by setting listen-address in config.xml for the WLS server, or by using the WLS console. To use the console, expand Environment and click Servers in the Domain Structure window. In the Servers Configuration tab, click on the desired server name. Set Listen Address on this page. Restart WLS. For more information about WLS configuration, see Administering Oracle Fusion Middleware.

11.17 Required Fields Added to Content Server Must Have Default Value Specified

Adding a metadata field to a Content Server instance using Configuration Manager can cause problems if the field is set as required but no default value is specified. Any metadata fields set as required in Content Server that do not have default values specified in Content Server prevents Imaging from creating documents on the Content Server instance. Administrators can prevent issues within Imaging by either setting a default value for the metadata field or by using Content Server profiles to address the field.

11.18 Imaging Viewer Fails On UNIX, AIX, and Solaris SPARC

To view documents on a UNIX operating system, you must ensure that library path and display environment variables are properly set. For more information, see the section on setting a library path in an environment variable on a UNIX platform in the Installing and Configuring Oracle WebCenter Content.

11.19 Viewer Displays Blank Page Instead of Document

In some situations, Content Server may return a document in a search result that the user does not have View rights to in the application. If the user tries to view the document in the Viewer, a blank page is presented instead. This occurs when a user is mapped to the admin group in Oracle Internet Directory, which is then mapped to the admin role in Content Server. Users having the admin role in Content Server have rights to all security groups in Content Server. When a user having the admin role in Content Server uses an Imaging search, all documents matching the search criteria are returned in the search result, even if the user does not have View rights to the documents. Attempting to view a document to which the user does not have the Imaging View right defined in the associated Imaging application presents a blank page.

11.20 HTML Login Form Displayed Instead of Document in Advanced Viewer Mode

The Imaging advanced viewer is a Java applet that needs to submit cookies in its requests to authenticate a session and properly display documents. If a system is configured to limit cookies to HTTP only requests, the Viewer cannot authenticate and so the HTML login form is displayed instead of the requested document. To allow the advanced viewer applet to authenticate properly, cookies cannot be limited to HTTP only requests.

11.21 Viewer Reports Magic Number Error

If Imaging is integrated with Oracle Access Manager and the /imaging directory is incorrectly configured as protected, a magic number error is reported by the Viewer in advanced mode. To correct this, ensure that Oracle Access Manager is properly configured to protect the /imaging/faces directory. For more information, see Integrating Imaging With Oracle Access Manager.

11.22 Invalid Skin Preference Displays Generic User Interface

If an invalid value is set in the DefaultColorSet MBean, or if a user has specified a UI skin in their preferences that has been deprecated when Imaging is upgraded, then a generic user interface is displayed when the user logs in. The generic interface has a larger font and does not display a logo. Correcting the invalid value of the DefaultColorSet MBean or applying a current skin from the User Preference page corrects the problem.

11.23 Configuring Viewer for Use in UNIX Exalogic Environment with Solaris 11g

When running Imaging in an Exalogic environment with Solaris 11g, you must set the display environment variable in order for the Imaging Viewer to work properly in basic mode. To set the display variable, do the following:

Open a new terminal and run the command xhost +.
In the IPM_server terminal, set the DISPLAY environment variable.
Restart the Imaging server.

11.24 Problems with Sticky Note Properties When Using JRE Version 1.6.0_26

Sticky note properties do not display properly when using Java Runtime Environment (JRE) 1.6.0_26. Ensure that all clients needing access to sticky notes when using the advanced viewing mode are using JRE 1.6.0_27 or higher.

11.25 Cache Exception Loading Large Documents

When loading large documents (documents approaching or exceeding 1000 pages, or documents set to a resolution of 192 DPI or above), a cache exception may be thrown in the Imaging Viewer. In such cases, the transaction timeout of the RenderAgent EJB should be set to 300 seconds in the WLS Administration Console. If the exception occurs even after increasing the transaction timeout to 300 seconds, it should be increased further in steps of 120 seconds.

To set the transaction timeout of the RenderAgent EJB:

Open the WebLogic Server Administration Console and click Deployments.
Select the Imaging deployment to open the details for Imaging.
Under Modules and Components, select the RenderAgent EJB.
Click the Configuration tab.
Set the Transaction Timeout to 300 seconds.
Click Save to save the configuration settings.

11.26 Deleting Business Rules Package Does Not Delete Files in Custom Payload Schema

When a business rules package created and uploaded with a new payload schema is deleted, associated files that were generated in the custom payload directory are not deleted. These files need to be deleted manually by the system administrator when the business rules package associated with these files is deleted.

11.27 Java Exception or Blank Page Displayed When Loading the Imaging Viewer

There is a known limitation with the Imaging viewer when loading documents rendered with a high cache resolution setting (typically 300 DPI or above) and a high viewer zoom level (typically 175% or more) on a system with or without the viewer cache enabled. When using the advanced viewer mode, a java heap error may be generated. If you are using the basic viewer to view the document, a blank page may be displayed. As a workaround, it is recommended to use the download option to open the document locally.

11.28 Issue Opening Documents in Advanced Viewer If JRE Version Older Than 1.6.0_24

There is a known issue with opening documents in the advanced viewer mode when using Internet Explorer 9 and a Java Runtime Environment version older than 1.6.0_24. As a workaround, it is recommended to install the latest version of Java or Java Runtime Environment version 1.6.0_24 or higher.

11.29 Copying/Pasting Text To/From the Clipboard

When using a Java Runtime Environment version 1.6.0_24 or higher, copying or pasting text to/from the clipboard is security sensitive and depends on how the security policy is defined on the client machine.

To enable copying or pasting text to/from the clipboard into text and sticky note annotations in the Imaging viewer, follow these steps:

Navigate to the jre\lib\security directory under the Java installation directory on the client machine. For example, C:\Java\jre\lib\security.
Edit the java.policy file by adding the following text to "standard" properties that can be read by anyone:
```
permission java.awt.AWTPermission "accessClipboard";
```
Restart the browser for the changes to take effect.

11.30 Advanced Viewer Does Not Work After Upgrading Or Patching

In some situations, the Imaging viewer may not work in the advanced mode after upgrading from one Imaging patch set to another or after applying an Imaging patch. To resolve this problem, clear the Coherence cache and browser history on the client machine. See Clearing Caches and the Note (on what happens if the WHERE clause is absent) in Deleting Entries in the Cache in Developing Applications with Oracle Coherence for more information on how to clear the Coherence cache. Note that the Coherence cache is an independent cache from the browser's cache.

11.31 Resolve Linux Image Conversion and Rendering Issues

This section discusses the symptoms, cause, troubleshooting steps, and solutions to the problem to fix the Linux image conversion and rendering issues in Imaging.

The following errors are resolved:

Image export failed with Code 3
XOpenDisplay failed
Unable to fully render document
Failed image conversion and cannot be stored in cache at this time
A cache exception occurred
Transformation process returned error code 135
A failure occurred while encrypting the document
Failed to launch CaptureOITExport
Error launching the external transformation process

To resolve the above errors, perform the following troubleshooting steps:

Check DISPLAY and GDFONTPATH environment variables:
There are two image conversion subsystems available, X server and the GD subsystem. If there is no X server running, the DISPLAY environment variable must not be set. If DISPLAY is set, an X server must be running. If both DISPLAY and GDFONTPATH variables are set for Imaging, the DISPLAY variable takes precedence and X server processing will occur.

If DISPLAY is not set, the GDFONTPATH environment variable and GDFontPath Mbean must be set. Both the GDFONTPATH environment variable and the GDFontPath Mbean must be set to the same value. That value is the full filesystem path to the directory that contains the TrueType fonts (.TTF files) on the system.

If Capture and Imaging are running on the same server, the DISPLAY variable will be set for both processes, because they both rely on the file setDomainEnv.sh for this setting. In this environment, Imaging will also use the X server for image conversion.
To check if the running process has the DISPLAY and/or GDFONTPATH environment variables set:
```
$ ps –ef | grep <capture_server1 or IPM_server1>
```
For example, to find the process ID (PID), enter the following command:

Sample output:
```
[example@linuxtest2 ~]$ ps -ef | grep capture_server1 example 1184 802 9 Sep24 ? 2-13:25:39 /usr/java/jdk1.8.0_171-amd64/bin/java -server -Xms256m
      -Xmx1024m -cp /oracle2/Middleware12c/wlserver/server/lib/weblogic-launcher.jar
      -Dlaunch.use.env.classpath=true -Dweblogic.Name=capture_server1<actual output truncated>
```
1184 is the PID of the Capture server. It’s usually a 4 or 5 digit decimal number.

To query the running process for the DISPLAY and GDFONTPATH environment variable values:

On Linux:
```
$ ps ewww <capture_server1 PID> | tr ' ' '\n' | grep \= | grep DISPLAY
$ ps ewww <capture_server1 PID> | tr ' ' '\n' | grep \= | grep GDFONTPATH
```
On Solaris:
```
$ pargs –e <capture_server1 PID> | grep DISPLAY
$ pargs –e <capture_server1 PID> | grep GDFONTPATH
```
Example:
```
$ ps ewww 1184 | tr ' ' '\n' | grep \= | grep DISPLAY
```
Output:
```
DISPLAY=10.148.51.219:0
```
```
$ ps ewww 1184 | tr ' ' '\n' | grep \= | grep GDFONTPATH
```
Output:
```
GDFONTPATH=/usr/share/fonts/liberation
```
Sample bad output:
```
$ ps ewww 1184 | tr ' ' '\n' | grep \= | grep DISPLAY
```
<no output displayed>
```
$ ps ewww 1184 | tr ' ' '\n' | grep \= | grep GDFONTPATH
```
<no output displayed>

Problem resolution:

The following environment variables should be set as needed in the file setDomainEnv.sh ($DOMAIN_HOME/bin/):
```
1 DISPLAY=<machine name or IP>:<display>:<port>
export DISPLAY
GDFONTPATH=<path to .ttf font files>
export GDFONTPATH
```
If one or both variables are defined, they may be set in the setDomainEnv.sh file ($DOMAIN_HOME/bin/setDomainEnv.sh), but they also can be set at many other places on the system. The DISPLAY and GDFONTPATH variables can be set in other process startup scripts such as .profile, .bash_profile and so on. If the DISPLAY variable is not required, add the following command in the setDomainEnv.sh file to remove the variable from the process:
```
unset DISPLAY
```
Note:
The GDFONTPATH environment variable must always be set.
If there is no DISPLAY or GDFONTPATH variable defined, the reason is that the file setDomainEnv.sh ($DOMAIN_HOME/bin/) does not include the definitions of these variables. If they are defined, but not created or set in the setDomainEnv.sh file, defining them in the setDomainEnv.sh file will overwrite the preset values.

The value of the DISPLAY variable will often be set to localhost:n.0. That refers to the server, display n, port 0 which is fine as long as an X server is running on the local server. The GDFONTPATH variable must also be set in the file setSOADomainEnv.sh ($DOMAIN_HOME/bin/) if SOA is running on the same server.

After making the necessary changes to the setDomainEnv.sh file, restart the entire domain and then retest.

If the problem is still not solved, continue troubleshooting.
Verify that X server is running:
For an Imaging issue, an X server must only be running if the DISPLAY environment variable is set in Step 1. The running X server must be configured to allow the user of Capture or Imaging (often oracle) to access configured display and port.
Verify X server configuration and permissions (Optional):
If using VNC, add the following line in the VNC configuration file /etc/sysconfig/vncservers.
```
VNCSERVERS="0:root 1:oracle"
```
where oracle is the user account of the Imaging server. To have more detailed description about this configuration, see Configuring VNC Server on Linux. If this line is changed, stop and restart the VNC server for display 1. The above two steps are often the source of the problem. If those are fine, follow the next steps.

Check OIT libraries’ location and consistency:

The OIT libraries are located at $ECM_HOME/oit/<platform>/lib/contentaccess. For Solaris, navigate to the solaris/lib location, and not to the solaris-x86/lib location.

Navigate to the location:

$ cd $ECM_HOME/oit/<platform>/lib/contentaccess

Check that all the required components are installed.

On Linux and Solaris:

$ ldd libos_gd.so
$ ldd libos_xwin.so

On AIX, enter the command:

$ dump –H libos_gd.so
$ dump –H libos_xwin.so

Sample Output:

$ cd /oracle/Middleware/Oracle_ECM1/oit/linux/lib/contentaccess
$ ldd libos_gd.so
linux-gate.so.1 => (0xf777b000)
libwv_gdlib.so => /oracle/Middleware/Oracle_ECM1/oit/linux/lib/contentaccess/./libwv_gdlib.so (0xf7753000)
libwv_core.so => /oracle/Middleware/Oracle_ECM1/oit/linux/lib/contentaccess/./libwv_core.so (0xf737d000)
libm.so.6 => /lib/libm.so.6 (0xf7353000)
libpthread.so.0 => /lib/libpthread.so.0 (0xf7337000)
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0xf724c000)
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0xf722e000)
libc.so.6 => /lib/libc.so.6 (0xf7097000)
libfreetype.so.6 => /oracle/Middleware/Oracle_ECM1/oit/linux/lib/contentaccess/./libfreetype.so.6 (0xf702c000)
libdl.so.2 => /lib/libdl.so.2 (0xf7026000)
/lib/ld-linux.so.2 (0xf777c000)
libz.so.1 => /lib/libz.so.1 (0xf7012000)

If something is missing, the line clearly states that it’s missing. For example:

libcsfml-window.so.2.2 => not found
libcsfml-graphics.so.2.2 => not found

Problem detection and resolution:

If there are missing libraries, the system administrators must be engaged to install the missing package(s) prior to continuing. The installation of the required packages is beyond the scope of Oracle support.

Double check Imaging OIT location:
To check where the Imaging configuration is looking for the OIT libraries as defined in the command line parameter ipm.oracle.com:
```
$ cd $DOMAIN_HOME/bin
$ grep -r ipm.oracle.home
setDomainEnv.sh:EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES} -Dipm.oracle.home=/oracle2/Middleware12c/wccontent"
```
Problem detection and resolution:

The directory listed in the output is the root of the directory location in which Imaging looks for the OIT libraries. The directory location in the setDomainEnv.sh file is populated by the installation procedures.

Imaging appends the string oit/<platform>/lib/contentaccess to the root directory. This string should be equivalent to $ECM_HOME/oit/<platform>/lib/contentaccess. If it is not, the setDomainEnv.sh file must be edited to add or change the string to equal $ECM_HOME/oit/<platform>/lib/contentaccess. All WebLogic Managed Servers should be restarted after this change.
Check OIT libraries’ version:
Check version manually, where platform can be linux, solaris,etc.
```
$ cd $ECM_HOME/oit/<platform>/lib/contentaccess 
$ for i in *; do echo 
$i; strings 
$i | grep _VER; done
```