Tuesday, 11 September 2018

Upgrade ODS Notes Client Local Databases


In response to several questions about yesterday's blog post a short addition for the upgrade of the ODS of the local database in the Notes Client. By default local databases are not updated when the Notes client is upgraded. Using either the Notes Client, Domino Administrator Client or the Domino Designer Client you can force the client to perform ODS upgrades of all local databases. For most non-essential databases the ODS upgrade will take place in a background process and while a database is upgraded, the end user will not be able to use the database. For essential databases that are in use at the point that an upgrade is attempted the ODS upgrade will be done at the next first time open which will typically occur at client restart. The following NOTES.INI setting performs the upgrade: NSF_UpdateODS=1. With this setting the client will do a one time pass to upgrade local databases using the compact task. In addition,the specific ODS level that is desired can be set. If none is set, ODS52 will be forced.
The steps below for the upgrade of the ODS are based on the use of a Desktop Policy.

1. Desktop Policy
A mentioned, for clients we need to set NSF_UpdateODS=1 in combination with CREATE_R9_DATABASES=1 which lets the client convert to the new ODS. These settings can easily be distributed to all users through a Desktop Policy.
Open the Domino Directory on the Domino server (names.nsf).
Click the People & Groups Tab and open the Settings view.
Click Add Settings, open the Desktop Settings dialog and select the Custom Settings Tab or select and open an existing Desktop Policy and select the Custom Settings Tab.
Select NOTES.INI.


 Click Edit List to open the panel that enables you to create a notes.ini variable name and value pair.
Add NSF_UpdateODS=1 and include Enforce.

Next add CREATE_R9_DATABASES=1 and also include Enforce.

Enable the Enforce option to push the value pair to overwrite any other previously set value for the named setting.
Click OK and Save & Exit.

2. Deploy Policy
Users receive updates to the desktop settings the next time users authenticate with the home server in case the policy settings change and the desktop policy settings are enforced.
In the NOTES.INI file (Notes Program Directory) the new Desktop Policy Setting are added.


Next time the Notes Client is started the upgrade of the local databases to the new ODS will be executed. In the log you can see the following message : 11-09-2018 07:56:01 21 databases had an older NSF ODS version. 17 of those databases were successfully upgraded to a later NSF ODS.

Remark: Another possibility is to set the field Enable upgrade of all local NSFs to latest ODS version in the Desktop Policy document on the Mail Tab under Client Settings if you always want to upgrade to the latest ODS version.


For more information see the IBM Technote Local database's ODS is not updated when Notes client is upgraded and Domino On-Disk Structure.

No comments:

Post a Comment