Updall options

The Updall task manages database full-text indexes.

Note: You can run the Updall task on a server, or you can use the dbmt tool that now includes the Updall task as well as other options instead of running Updall alone. See the related topics for more information.
You can use several methods of running the Updall task on a server.
  • From Task > Start tool in the Domino® Administrator -- Use this method if you don't want to use command-line options.
  • Using the Load Updall console command -- Use this method if you are comfortable using command-line options or if you want to run Updall directly at the server console when there is no Domino® Administrator running on the server machine.
  • Program document that runs Updall -- Use this method to schedule Updall to run at particular times.
  • Run Updall on a Win32 platform -- Use this method if you are unable to run Updall at the server console. This method requires that you use the "n" prefix -- for example, nupdall - R.

When you use these methods, you can include options that control what Updall updates. For example, you can update all views and not update any full-text search indexes.

The following tables describe the options you can use with Updall Task > Start tool. The second column lists the equivalent command-line options that you use when you use a console command to run Updall and when you schedule Updall to run in a Program document.

Note: For information on using Updall to enable inline view indexing in databases, see Enabling and managing inline view indexing.

Use this syntax when you use the Load updall console command:

Load updall databasepath options

For example:

Load updall SALES.NSF -F

You can specify multiple options -- for example:

Load updall -F -M
Table 1. Updall - Basic options

Option in Task - Start tool

Command-line option

Description

  • Index all databases
  • Index only this database or folder

databasepath

This option is used when running Updall as a console command.

"Only this database" updates only the specified database. To update a database in the Domino® data folder, enter the file name, for example, SALES.NSF. To update databases in a folder within the data folder, specify the database path relative to the data folder, for example, DOC\README.NSF.

"Index all databases" (or no database path) updates all databases on the server.

Update this view only

database -T viewtitle

Updates a specific view in a database. Use, for example, with -R to solve corruption problems.

Note: -T cannot be used with .IND (indirect) files.
Table 2. Updall - Basic options - more

Option in Task - Start tool

Command-line option

Description

Update: All built views

-V

Updates built views and does not update full-text indexes.

Update: Full text indexes

-F

Updates full-text indexes and does not update views.

Update: Full text indexes: Only those with frequency set to: Immediate or Hourly

-H

Updates full-text indexes assigned "Immediate" or "Hourly" as an update frequency.

Update: Full text indexes: Only those with frequency set to: Immediate, Hourly, or Scheduled

-M or -S

Updates full-text indexes assigned "Immediate," "Hourly," or "Scheduled" as an update frequency.

Update: Full text indexes: Those with frequency set to: Immediate, Hourly, Daily, or Scheduled

-L

Updates full-text indexes assigned "Immediate," "Hourly," "Daily" or "Scheduled" as an update frequency.

Table 3. Updall - Rebuild options

Option in Task - Start tool

Command-line option

Description

Rebuild: Full-text indexes only

-X

Rebuilds full-text indexes and does not rebuild views. Use to rebuild full-text indexes that are corrupted.

Rebuild: All used views

-R

Rebuilds all used views. Using this option is resource-intensive, so use it as a last resort to solve corruption problems with a specific database.

Rebuild: Full-text indexes and additionally: All unused views

database -C

Rebuilds unused views and a full-text index in a database. Requires you to specify a database.

Table 4. Updall - Search Site options

Option in Task - Start tool

Command-line option

Description

Update database configurations: Incremental

-A

Incrementally updates search-site database configurations for search site databases.

Update database configurations: Full

-B

Does a full update of search-site database configurations for search site databases.

Option for running Updall as part of dbmt

Updall performs the following tasks by default. These are also tasks that the database maintenance tools performs:
  • purges deletion stubs
  • expires soft deleted entries
  • updates unread lists
Because the database maintenance tool is meant to replace (and improve upon) running updall nightly, you can use the following new option for updall to skip the tasks above, making updall faster when you run it for any one-time purpose.
-nodbmt
When you run updall as part of dbmt, Domino® also ensures that the following views are built for databases with a template name of StdR7Mail, StdR8Mail, StdR85Mail and StdR9Mail:
  • $Inbox
  • $Drafts
  • $All
  • ($RepeatLookup)
  • ($ToDo)
  • ($Calendar)
  • ($Haiku_TOC)
  • ($Alarms)
  • ($iNotes)
  • ($Users)
  • ($iNotes_Contacts)
  • ($ThreadsEmbed)
After these views are built, they will not be discarded due to non-use.