« De-Compensating | Main| Lotusphere 2008: Call for abstracts »

What to do when every document in a view appears as a Replication Save Conflict

QuickImage Category Show-n-Tell Thursday

I ran into an interesting issue yesterday after having pushed some design changes to an existing production application database.

It seems that some of the users of the application, when opening some of the views, were seeing nothing but replication conflicts, instead of normal documents. Every single entry in the view appeared as a Replication Save Conflict. The offending views differed from user to user, and the Replication Conflicts View only contained two documents. The only thing that the users who were experiencing these symptoms had in common were:

  1. They were all accessing the database using a Notes Client (web users were unaffected)
  2. Their Notes Client versions were between 6.0 and 6.5.5 (primarily 6.5.3)
Refreshing the views (F9, Shift+F9, or even Ctrl+Shift+F9) at the client did no good, restarting the client (and even the machine) did no good, and even updating all the views from the server console load updall -R target.nsf did no good.

My first instinct was that the issue probably had to do with the version of the Notes Client being used (and in a small way I was correct); however in my haste to solve the problem (this is a really important production application) I failed to notice the most important clue: the offending views differed from user to user. I thought that perhaps the offending views contained some design elements (shared columns) or @Formula in either the selections, column formulas, or view actions that were somehow incompatible with Notes Client versions prior to 6.5.5. Our corporate standard version is R7.0.1, and the changes had been developed, tested, and UAT using this version.

After chasing several dead-ends, and doing a bunch of searching on the web, I realized the culprit was not incompatible design elements, but in fact the client side cache. The technote that helped me figure this out (while not explicitly mentioning the symptoms our users were experiencing) can be found here. It seems that the Notes Client 6 versions (up until 6.5.5) will sometimes refuse to release a cached design element (in this case the view design note), even when the design of a database has been updated. Restarting the Notes client (and even restarting the machine) does not solve the issue.

Once I realized (about the same time that I clued into the differeing views point) that the problem had to do with the Notes Client cache, the solution became obvious.

Steps to correct this issue

  1. Remove the database icon from the Notes Client workspace. (Make note of it's location so you can open it later)
  2. Shut down the Notes Client
  3. Find the cache.ndk file. This can usually be found in the Notes Data directory.
  4. Delete cache.ndk
  5. Start Notes
  6. Open the database

That's it.

-Devin

PS: To those of you may be thinking "That's it!? All this build-up for this simple solution? How anticlimactic!" -well, sometimes things aren't really that big of a deal.

Comments

Gravatar Image1 - Every time I see a user having weird things happening in Notes, I can't see on my machine, I get in the habit of telling them to remove the cache.ndk.<br>It usually helps <br>(removing the database icon is not necessary though)

Gravatar Image2 - Great post. I've seen this before but no in a while. Now I know where to find the fix/workaround. Thanks dude!

Gravatar Image3 - The reason I removed the database icon is because I was thinking it was part of my cache issue.

Now that I think about it (and your point) a bit more, I think you are probably right in that removing the database icon really isn't necessary as long as cache.ndk has been removed.

Thanks.
-Devin.

Gravatar Image4 - I've had a great deal of luck just removing the icon, then adding it back right aftewards. I have not had to delete the cache in years (R5 days)

Search

Wowsers! A Tag Cloud!

Links

MiscLinks