Run Fixup, Updall, and Compact maintenance tasks for IBM Lotus Domino database

Article ID: KB02207

Type: Support Content

Last Modified: 05-23-2012

 

Product(s) Affected:

  • BlackBerry Enterprise Server for IBM Lotus Domino
CollapseEnvironment
  • BlackBerry® Enterprise Server for IBM® Lotus® Domino®
CollapseOverview

The BlackBerry® Enterprise Server depends on existing databases, such as the mail files and the IBM® Lotus® Domino® directory, for its operation. Corruption of a database design, form, document, view, or index can cause a number of issues with the BlackBerry Enterprise Server. To help correct these problems, an administrator can run maintenance tasks, such as Fixup, Updall, and Compact.

Some issues that the maintenance tasks may correct are the following:

  • Unable to add a BlackBerry smartphone user account to the BlackBerry Enterprise Server
  • Unable to scan a mail file
  • Cannot redirect messages to a smartphone
  • Unable to open a redirection folder
  • BlackBerry profiles database is not updated with user information when changes are made in the BlackBerry® Desktop Redirector settings or when a new encryption key is generated
  • The BlackBerry smartphone user name is not found in the Lotus Domino directory
 
Procedure

The BlackBerry Enterprise Server creates Lotus Domino-designed databases, such as BlackBerryProfiles.nsf, BBTempMailBox.nsf and a uniquely named BlackBerry state database for each user.

Note: These maintenance tasks can be performed either online or offline, as desired. Refer to the appropriate procedure below.
 
Procedure for Offline Maintenance
 
Complete the following steps to perform Lotus Domino offline maintenance tasks on specific databases:
 
  1. Stop the Lotus Domino Server.
  2. Open a command prompt window.
  3. At the command prompt, browse to the Lotus Domino directory and run the following command(s) on the problem database(s) in the following order:
    Note: See the Additional Information section for examples of the command syntax.
  • The following corrects corrupted views and documents:

   nfixup

 

  • The following rebuilds all used views and fixes corrupted views and full-text indices. This task is resource intensive:

   nupdall -r

 

  • The following can fix database corruption:

   ncompact -c

 

4. Start the Lotus Domino Server

 

Procedure for Online Maintenance

For online maintenance, the same set of commands can be run, except the "n" in front of the command is dropped, and the command Load is needed. The command is run from the Lotus Domino console. Caution should be taken when running online maintenance as this can affect the performance of the server.

Note: Commands are run against the BlackBerry Enterprise Server folder located within C:\Lotus\Domino\Data\ directory.

Run the following command(s) on the problem database(s) in the following order:

  • The following corrects corrupted views and documents in databases that are unopened, skipping the open databases. Add the -o switch to take the databases offline and correct any corrupt views and documents:

   load fixup BES

  • The following rebuilds all used views and fixes corrupted views and full-text indices. This task is resource intensive:

   load updall -r BES

  • The following can fix database corruption:

   load compact -c BES

Note: See the Additional Information section for examples of the command syntax.

CollapseAdditional Information

At the command prompt, use the following syntaxes to issue the commands described in this document:

 

For offline maintenance:

  n <task_name><database_file_name>

For online maintenance:

  Load <task_name><database_file_name>

 

Some usage examples are the following:

  • ncompact -c BlackBerryProfiles.nsf
  • nfixup names.nsf
  • nupdall -R BES\BlackBerryProfiles.nsf
  • Load fixup BES\BlackBerryProfiles.nsf
  • Load Compact -c BES\BlackBerryProfiles.nsf
  • Load Updall -R BES\BlackBerryProfiles.nsf

Important: When maintaining a template, specify the extension .ntf after the template name.

Note: Refer to IBM Lotus Domino Administrator Help files for more information on troubleshooting databases.




The following are keyboard shortcuts you can use to update or rebuild views while the Lotus Domino Server is running:

  • F9 to update the current view.
  • SHIFT + F9 to rebuild the current view.
  • CTRL + SHIFT + F9 to rebuild all views in the database that are not built and update all other views. This is similar to running updall on a database.

Disclaimer

By downloading, accessing or otherwise using the Knowledge Base documents you agree:

   (a) that the terms of use for the documents found at www.blackberry.com/legal/knowledgebase apply to your use or reference to these documents; and

   (b) not to copy, distribute, disclose or reproduce, in full or in part any of the documents without the express written consent of RIM.


Visit the BlackBerry Technical Solution Center at www.blackberry.com/btsc.