# Installation and Upgrade Guide

# Troubleshooting

This section describes how to diagnose and correct problems you might encounter when you install and deploy the Documentum Portlets application. It includes the following topics:

- Reviewing Log Files.
- Modifying Configuration Files
- Diagnosing Unexpected Results

## Reviewing Log Files

The Documentum Portlets logs its communication with the portal. These logs are contained on the Documentum Portlets host in <PT_HOME\ptdctmportlets\4.1\settings\logs.

## Modifying Configuration Files

If you encounter configuration problems, Customer Support might direct you to modify the Documentum Portlets configuration files. These files are located on the Documentum Portlets host in <PT_HOME\ ptdctmportlets\4.1\settings\config. Typically, you do not need to modify these files.

## Diagnosing Unexpected Results

The following table summarizes how to diagnose and correct unexpected results.

Table 6-1 Diagnose Unexpected Results
Symptom | Solution
--- | ---
Deployment verification tool returns test failures for DFC settings. | The DFC runtime environment libraries might be misconfigured in the Web application server startup script. Ensure the location of the dfc.properties file (typically in C:\Documentum\config or in the DFC Install folder) and dctm.jar (typically in C:\Program Files\Documentum\dctm.jar or in the DFC install folder) have been set properly in the Web application server classpath configuration.