Skip to main content

How to Upgrade or Replace Design on a Domino Mail File Using Load Convert -u

So why would you do this anyway?
Initially, it seems like there is no real reason to use a command line utility when you can do everything using File, Database (or application in Notes 8) Replace Design.

I used to think that the only reason I would ever want to do this would be if I have a large number of mail files to upgrade. Then I discovered a curious thing, a simple design replace on a single database can often causes issues with the design of folders. The answer to this problem is load convert.

How to use it

PART 1: Getting to the Server Console via Administrator
  1. Open the Domino administrator
  2. Open your server, it probably will be already open
  3. Click on the tab marked server
  4. Click on the tab marked status
  5. Into the left-hand navigator, click server console
  6. If the server console isn't already live, you might want to click the Green Triangle
  7. Position your cursor in the space marked Domino command. This is where you will type the load convert command.

PART 2: Load Convert
The syntax of the load convert command is pretty complicated if you look it up in the help.
You won't need most of the syntax for a simple mail file upgrade

the syntax for a mail file upgrade is as follows;

Load Convert -u folder\mailfile.nsf * mail7.ntf

Where:
  • the -u switch Enables the upgrade of folders to the same design as the $inbox design.
  • folder\mailfile.nsf is the location and name of the mail file eg: mail\jsmith.nsf
  • * means - I don't care what template it was originally using
  • mail7.ntf is the name of the new template (it will be different depending on the version of Notes or your customizations).

Wildcards
You could replace mail\jsmith.nsf with mail\* to do all mail files but I'd strongly advise against doing this as you may find that you have special mail-in databases which need to be on a particular design. If you have a lot of mail files to process, consider getting a list and using the -f switch to process a text file.

A Safety Net
You can also specify a "before template" in the part where I have used an asterisk (*) in the example. For example, if you put mail6.ntf into this field;

Load Convert -u mail\*.nsf mail6.ntf mail7.ntf

It would upgrade only those mail files used in the standard R6 mail template to R7. This is often a good way to avoid problems with different types of databases in the same folder when using wildcards.

The -u Switch
One final warning: Although you can use load convert on the other databases, don't use the -u switch when doing them. It will do awful things to your folders.

Comments

I think the "before template" is the "old template name", and not the "old template filename".

So "old" is the template name, while the new parameter is the physical template filename.

Seems a bit strange, but in the long term, this makes a bit sense.
Unknown said…
Thanks, I did:

load convert -u mail\*.nsf * mail85.ntf

Worked a treat.
Anonymous said…
Very Useful if you cannot setup OutOfOffice Feature!

Well Done

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 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

How to Do a Mail Merge to Email using Lotus Notes

Why do one? In today's "green" world, it makes much better sense to send out emails than letters but you still want to personalize them. Sadly, by itself Lotus Notes doesn't support mail merge to email. Of course, we know that outlook does (but then it lets anyone and anything send emails for you - even when you don't want them to). So, how to do it in Notes? OpenNTF The first port of call is OpenNTF ( http://www.openntf.org/ ). This place is full of great things but most of them are really badly documented. Still, these guys give things away for free and they develop in their spare time, so we should be grateful for what we get. There's a great little project there called MailMerge Excel to Notes . Go there, click on releases and download the ZIP file. Getting to the Code The installation is tricky though I've noted that since I asked the author about the install, it's been updated (so maybe these steps are less necessary). Unzip the files to somewher