Domino on Linux/Unix, Troubleshooting, Best Practices, Tips and more ...

Upgrading ODS for databases with old DB class in Domino 9

Daniel Nashed  9 April 2013 15:36:39

When you create a database for example with the extenson .ns7 the ODS will be ODS43 instead of ODS51.
This kind of trick was used in earlier days and was to ensure that an older ODS was used when really needed.
What this causes is that the DB class of the database instance is set to that version.
And you cannot use a copy style compact to change this database to the new ODS -- even you rename the extension back to ".nsf".

The only way to change the database class and ODS was to create a new replica.

In Domino 9 there is a new compact switch "-upgrade".

"-upgrade Upgrade databases created with older DB classes to the most recent class."

This switch upgrades the DB class to a general DB (DBCLASS_NOTEFILE)

#define        DBCLASS_NOTEFILE                        0xff01
#define        DBCLASS_V6NOTEFILE                        0xff10
#define        DBCLASS_V8NOTEFILE                        0xff11
#define        DBCLASS_V85NOTEFILE                        0xff12

Some C-API based applications have created databases with specific DB classes and run into the same issue.

With this new compact switch you can change the ODS for those databases quite easy.
This even works when you don't change the extension of the file. But for best practices you should rename the file anyway.

So a compact -C -upgrade help/ will upgrade all your help databases to the new ODS.
Some of the help databases have an old DB classe and a normal compact will not bring them to the new ODS.

you can verify this via the "show dir" command:

sh dir help

DbName                                Version Log  DAOS  PIRC  ---Modified Time----
/local/notesdata/help/lsxlc.nsf        V5     Yes   No    Off  05.04.2013 22:38:45
/local/notesdata/help/lccon.nsf        V5     Yes   No    Off  05.04.2013 22:38:54
/local/notesdata/help/help9_designer.nsf V8     Yes   No    Off  05.04.2013 22:39:10
/local/notesdata/help/help9_client.nsf V8     Yes   No    Off  05.04.2013 22:39:11
/local/notesdata/help/help9_admin.nsf  V8     Yes   No    Off  05.04.2013 22:39:11
/local/notesdata/help/decsdoc.nsf      V5     Yes   No    Off  05.04.2013 22:38:43

This can be quite helpful. I know that also an anti-virus vendor hat issues with databases created with the wrong DB class.


1Henry Newberry  09.04.2013 23:07:33  Upgrading ODS for databases with old DB class in Domino 9

Very useful.. Of course you also need the notes.ini parameter Create_R85_Databases=1 set.

Is there a new ODS for R9? Is tehre a new Notes INI setting?


2Daniel Nashed  10.04.2013 9:24:21  Upgrading ODS for databases with old DB class in Domino 9

@Henry, there is no new ODS in ND9. Sure Create_R85_Databases=1 still needs to be set and there is nothing new.

Only the compact option is new and it was really complicated before to change the DB class.

I have not found the switch in the normal documentation -- just in the help for the compact task.

-- Daniel

3Michael Kobrowski  12.04.2013 17:00:23  Upgrading ODS for databases with old DB class in Domino 9

Having problems with getting the ODS version updated from 43 to 51.

Had the Create_R85_Databases=1 set and didn't seem to do it. Tried the new notes.ini setting of NSF_UpdateODS=1 but didn't want to do it either.


4Tom  20.06.2013 14:45:43  Upgrading ODS for databases with old DB class in Domino 9

@Michael. After you make that notes.ini setting you still need to run a copy compact "compact -c" on the database you want the ODS upgraded for. Or according to Daniel, if you had every changed the extension to .ns5, .ns6, .ns7 or the like then you can use the new 'upgrade' command he discusses (if you're on R9 server).

5Stephen Bailey  29.01.2014 11:55:47  Upgrading ODS for databases with old DB class in Domino 9

Domino 9 ODS (ODS 52) exists, and you can upgrade databases hosted on a Domino 9 server using the following:

Notes.ini parameter: Create_R9_Databases=1

Console command: load compact -C

Databases upgraded to ODS52 can still be accessed using a Notes 8.5 client.


6Jérôme Deniau  31.01.2014 14:47:25  Upgrading ODS for databases with old DB class in Domino 9

Replace create_Rx_Databases=1 with NSF_UpdateODS=1 if you do want to keep upgrading to next ODS

- compact -c still ok


prefer compact -upgrade now

  • [IBM Lotus Domino]
  • [Domino on Linux]
  • [Nash!Com]
  • [Daniel Nashed]