DFC_DOCBROKER_EXCLUDED: Primary Docbroker Blacklisted

Ranked #8,979 in Computers & Electronics, #178,549 overall

Problem & Cause

Have you ever come across the error in the log java.io.IOException: DFC_DOCBROKER_EXCLUDED.

This means that some how, your DFC is not able to communicate with your docbroker, specified in dfc.properties. Your docbroker is responsible for communication between the application deployed on application server, and the docbase. Docbroker acts like a bridge between the two layers of architecture. But, due to some reason, this bridge is broken. Their can be multiple reasons behind it.

1. Bad connection or Network failure
2. Docbroker does not start properly
3. Docbroker is not properly added in dfc.properties
4. Patch applied for DFC doesn't get deployed properly
5. Web application doesn't start properly
6. DNS entry not resolved for the docbroker server
7. Any other unidentified reason.

How it works?

The DFC of application maintains the list of docbrokers, which it can communicate. However, if it is not able to communicate with the docbroker, specified in dfc.properties, it will try multiple times to communicate, with the docbroker. If the threshold limit, to communicate with the docbroker exceeds the specified limit, the docbroker is blacklisted. Blacklisted docbroker won't be communicated further in future ever.
If there is only one primary docbroker specified for your repository, to communicate with the docbase, there will be no more docbroker remain. This will result in DFC_DOCBROKER_EXCLUDED error.

Be a documentum certified professional

Loading

CMS and Documentum. Managing content at your finger tips

Check out these interesting articles about Content Management and Documentum
Loading

Solution

To resolve this error, first you have to identify the cause of this error. There can be one or more reason from the list specified above. The resolution can based on one of the following approach -

1. Identify your network settings or take assistance of your network administrator
2. Check for your firewall settings
3. Stop your associated docbases and docbroker and restart your docbroker and docbase in order.
4. Check for any error in docbroker, docbase, server and application logs.
5. Check for your dfc.properties docbroker entries, specially for the port of communication
6. Try to resolve your DNS error with your network admin.
7. Clearing temporary files and caches plus restarting application server may also help.

This can also be handled through configuration, though it cannot be avoided fully. There is setting in the dfc.properties which, however, I didn't find in dfcfull.properties, with the help this configuration, you can increase the number of times the dfc should try to communicate the docbroker. In this way you can reduce the probability of blacklisting of your docbroker, in case their is a temporary outage or connection failure between dfc and docbroker.
The configuration, dfc.docbroker.exclude.failure_threshold can be use to increase this limit. The default value is 3. Docbroker Connection failure configurations can have following specified range of values -

Min value: 1
Max value: 60
Default value: 3

That's right you cannot have more than 60 attempts, before your docbroker is blacklisted. In other words, their is no configuration available, with the help of which this limit can be extended, to unlimited number of times.

EMC says

This feature is introduced in Documentum DFC version 6.5 sp3 onwards, versions prior to this did not support this configuration.

About Me

Loading

The patch work

Although, this configuration is not available to earlier release the 6.5 sp3 of dfc. There is a patch available of webtop 6.5 sp2, which can provide the above configuration. You should be able to get the latest patch release from the download center. The name of the patch release for webtop 6.5sp2 is Webtop_6.5.0.221SP2P0500.

I suppose this will provide you with enough information to resolve this issue. Best of luck!!!

Add your comments, if you want to share your experience.

Help me to improve this article

Was this article helpful? Do let me know. If you want to hear more about any specific topic on Documentum, just let me know..

Loading poll. Please Wait...

Rate thi article....

This module only appears with actual data when viewed on a live lens. The favorite and lensroll options will appear on a live lens if the viewer is a member of Squidoo and logged in.

Add this to your lens »

Waiting for your response.....

was this article helpful. Does it solve your problem.. Feel free to add your valuable comments.

  • spiritualll Aug 30, 2011 @ 9:41 am | delete
    HI!

    I saw your lenses now!

    They are nice!
    I was thinking to show them to others. I hope you keep creating them.

    I didn't hesitate to squidlike some of them!

    GOOD LUCK ON SQUIDOO

    May you earn much Money $$$!

Other documentum article

Loading

Document made easy ...

Some of the best books available for niche topic like Documentum. I am sure you are aware that there is not much content available to guide documentum professionals. Choose one which suits you...
Loading

by

AbhinavB

Hi, I am an IT guy. I like to research on a topic which may be useful to others and save their time. These articles are full of facts and rich in info... more »

Feeling creative? Create a Lens!