Skip to main content

Domino Recovery Tricks - and the Problem with 8.0.2

Installing Domino 8.0.2
Yesterday, we did some tests on Domino 8.0.2. I wasn't expecting any real problems given the ease of the last few Domino upgrades - up to 7.0.2. I guess I was wrong.

First of all, the initial attempt at installation failed with one of those non-specific error messages. I rebooted the server and tried again - no problems. I've seen this problem a few times though - it's something to do with the JVM being held open on Windows Server 2003 even though Domino itself has been closed.

Upon starting Domino, I chose not to upgrade the designs of the databases. Ideally you should not upgrade the designs until your last production server is on at least the same "major" version - in this case, 8.x.

I then did a bit of testing. As usual, I found no problems. Domino is one of the few systems I know which can be upgraded and tested (albeit roughly) in 15 minutes.

The Problem
Then I found the problem. Our most critical database refused to render web pages. This was shown in Microsoft Internet Explorer as a general "dummy spit" message which told me nothing.

Luckily, I use Mozilla Firefox most of the time. I was only using IE for testing because;

a. Most of our clients use it
b. It had no passwords cached

Mozilla gave me a very different story - a proper error message.

Error 500
HTTP Web Server: Application Exception - Duplicate Subform found. A given
subform cannot be used on the same form more than one time.

I'd read about this problem - and I thought that we'd checked that specific database for the problem - apparently not.

Anyway - I wasn't going to compound the problem by attempting a last-minute fix. Time to rollback.

DRP Tricks
I decided to try a couple of tricks first.

First I tried re-installing 7.0.2 over 8. In the first instance the install
failed completely but a retry after a reboot worked wonders.

I didn't really expect a simple re-install to fix the problem though I
would have been pretty impressed if it had.

The next step was to move (copy and delete) the entire

D:\Lotus\Domino

Directory - except for the data directory of course.

I then used ArcServe (r12) to restore this folder from tape - but not
directly to the original location - just in case I stuffed up and overwrote data or something. I restored to a different drive.

After restore, I copied the files to the right location and rebooted.

Everything came up normally - problem solved.

I guess we won't be moving to Domino 8 until we resolve the subform issue on that database.

Comments

Nate said…
"Ideally you should not upgrade the designs until your last production server is on at least the same "major" version - in this case, 8.x."


HUH!??!?! Where did you get that idea? The system templates are designed to be BACKWARDS compatible, not FORWARDS. You should upgrade things like the directory template from the very first server you install.
Gavin Bollard said…
I got that idea from years ago when I was working in a company with lots of R4.5 servers replicating with each other - and using a giant shared address book.

One of our IT people decided to upgrade their test server and a laptop to R5 and then accidentally replicated the upgraded address books around the network.

The servers kept upgrading their designs then had trouble reading the address books.

It was a very messy problem to fix.
Nate said…
That particular upgrade was a troublesome one, primarily due to the "Allow more fields in this database" flag. The use of the extended UNK table unfortunately broke backwards compatibility between 4.x and 5. (Well, there was a version, I think 4.6.2, that was ok with it.)

Since then, IBM has maintained an almost religious adherence to backwards compatibility in templates. Whether you're talking about mail templates or directories, you should be able to apply any FORWARD version to an older server release, and have it perform flawlessly. This is particularly so with the directory template, since unless you upgrade it, you frequently WILL encounter problems on later releases.

In fact, I'd kinda like to get some other server folks in on this discussion to corroborate or correct me on this matter. So watch for some additional comments. :-)
Miguel Calvo said…
Gavin,
did you find a solution for the subform issue ?
We've found the same problem in a 8.5.1 deployment.
Gavin Bollard said…
Miguel,

As it turns out, the only solution to the subform problem is to go through each of the forms in your database looking for embedded and computed subforms.

You need to make sure that there's no condition in which the same subform could be used twice.

If it is, for example ours was in the header and the footer, then you need to copy the subform and rename it Footer...

It probably makes sense to rename (or copy) your top one to header too.

So if your subform is called DocumentMenu, you need to have two;

HeaderDocumentMenu
and
FooterDocumentMenu

Then adjust the code on the form to call the appropriate subform.

It's a simple fix, but still a DESIGN fix - and IBM isn't going to change it back.

Also, if you're considering the 8.5.1 client, you should look at all databases which have attachments rendered on the web. There's a much worse design change required there.

Popular posts from this blog

How to Change Your Notification Options for New Lotus Notes Mail in version 8.x

Don't worry, I'm not patronizing you (my readers), I just decided to re-document this for one of our internal users and thought you might want to be able to use it in your own user documentation. WHAT IS THIS DOCUMENT ABOUT? Some people who don't get a lot of mail, like to be notified when such an event occurs. Notification can be; via a sound via a pop-up box via the system tray (where the computer clock is) The pop up box looks like this; Other people, who like myself, get too much mail would rather not be notified. The aim of this document is to tell you how (and where) to turn these options on and off. CHANGING YOUR SETTINGS To change your settings from the Notes 8.x client; On the Menu, click File , then Preferences... On the left hand side , click on the little plus sign to the left of Mail to expand the options. Click on the option marked Sending and Receiving . In the middle section, under receiving, you can control your notifications. If you untick the box mark...

How to Create a Bootable DVD Using Nero Burning ROM 9

I often need to create bootable CDs and DVDs but it's weird because I frequently end up buring myself a new coaster instead. It's not that the process is difficult, just that nero has a few too many options and I forget which ones to choose and end up picking the wrong one. I figured that the best way to avoid this mistake in future would be to write the steps down. Procedure Insert CD or DVD into your DVD Burner. Start Nero Burning ROM 9 Choose DVD-ROM (Boot) or CD-ROM (Boot) depending on what you're creating You'll be prompted for a disk image source. Choose a Nero Source - you'll usually find them somewhere like this... C:\Program Files\Nero\Nero9\Nero Burning Rom\DOSBootImage.ima Leave the Boot Locale as English - unless you really need a different keyboard layout Tick the box marked [X] Enable Expert Settings Choose Hard Drive Emulation and leave any other settings as they are. Click the button marked New Add any files you want but don't try to add operati...

How to Create an Auto-Response Mail Message in Lotus Notes 8.5.3+

Why would you do this? Suppose that you have an externally accessible generic email address for your company; support@mycompany.com or info@mycompany.com. You might expose this to the web and allow people to send messages to you. Setting up an auto-response email will tell the senders that their message reached its destination and that it will be dealt with accordingly.  It's also good practice to include links to FAQs or other useful information. Why 8.5.3 The techniques we'll be using here work in older versions of Notes but some of the options seem to have moved around in 8.5.3.  I figured it was a good time to show you where they've moved to. The Procedure Start Domino Designer and open the Mail file to be modified.  A really quick way to do this is to right-click on the application tab and choose "Open in Designer". In the Left hand panel of designer, expand Code and then double-click Agents.  A new window should appear. Click the action ...