Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Table of Contents
*******************************************************
I. The utilities: Updall, Compact, Fixup
A. Updall
Updall is similar to Update but it does not run continually or work from a queue. Instead, you run Updall as
needed. You can specify options when you run Updall but without them, Updall updates any view indexes or full-
text search indexes on the server that need updating. To save disk space, Updall also purges deletion stubs from
databases and discards view indexes for views that are unused for 45 days, unless there are different criteria
specified for discarding view indexes. Use the notes.ini file setting, Default_Index_Lifetime_Days, to change when
Updall discards unused view indexes.
Like Update, Updall rebuilds all corrupt view indexes and full-text-search indexes that it encounters.
By default, Updall is included in the notes.ini setting, ServerTasksAt2, so it runs daily at 2 AM. Running Updall
daily helps save disk space by purging deletion stubs and discarding unused view indexes. It also ensures that all
full-text-search indexes set for daily updates are updated.
Index all databases databasepath "Only this database" updates only the specified
database. To update a database in the Domino Data
Index only this database or folder folder, enter the file name, xxxx.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 Updates a specific view in a database. Use with -R to
viewtitle solve corruption problems.
Updall - Update options
Option in Task - Start tool Command line Description
option
Update: All built views Updates built views and does not update full-text
indexes.
-V
Update: Full text indexes Updates full-text indexes and does not update views.
-F
Update: Full text indexes; Only those with Updates full-text indexes assigned "Immediate" as an
frequency set to Immediate update frequency.
-H
Update: Full text indexes; Only those with Updates full-text indexes assigned "Immediate" or
frequency set to Immediate or Hourly "Hourly" as an update frequency.
-M
Update: Full text indexes; Only those with Updates full-text indexes assigned "Immediate,"
frequency set to Immediate, Hourly or "Hourly," or "Daily" as an update frequency.
-L
Daily
Updall - Rebuild options
Rebuild: Full text indexes only Rebuilds full-text indexes and does not rebuild views.
Use to rebuild full-text indexes that are corrupted.
-X
Rebuild: All used views Rebuilds all used views. Using this option is resource-
intensive, so use it as a last resort to solve
-R
corruption problems with a specific database.
Rebuild: Full-text indexes and additionally: Rebuilds unused views and a full-text index in a
All unused views database. Requires you to specify a database.
database -C
Updall - Search Site options
Option in Task - Start tool Command line Description
option
Update database configurations: Rebuilds full-text indexes and does not rebuild views.
Incremental Use to rebuild full-text indexes that are corrupted.
-A
B. Compact
When documents and attachments are deleted from a database, Domino tries to reuse the unused space instead
of immediately reducing the file size. Sometimes Domino cannot reuse the space because of fragmentation until
you compact the database.
When you run Compact without specifying options, Domino uses this style of compacting on all databases enabled
for transaction logging. Domino also uses this style of compacting when you use the -b option (case sensitive)
when compacting any database.
Tip: Use this compacting method most frequently since it is the fastest and causes the least system impact.
When you run Compact without specifying options, Domino uses this style of compacting on databases that are
not enabled for transaction logging. Domino also uses this style of compacting when you use the -B option. To
optimize disk space, it is recommended that you run Compact, using the -B option on all databases once a week
or once a month.
Copy-style compacting
Copy-style compacting creates copies of databases and then deletes the original databases after compacting
completes, so extra disk space is required to make the database copies. This style of compacting essentially
creates a new database with a new database ID. If you use copy-style compacting on logged databases (using the
-c option), compacting assigns new DBIIDs, so when using a certified backup utility, perform full backups of
databases shortly after compacting completes. When you use copy-style compacting, users and servers cannot
edit databases during compacting and they can only read databases if the -L option is used.
Domino uses copy-style compacting by default when you use an option with Compact to enable a database
property that requires a structural change to a database, or when you run Compact on a database that has a
structural change pending that was initiated from the Database Properties box. Enabling or disabling the database
properties, "Document table bitmap optimization" and "Don't support specialized response hierarchy," require
structural database changes.
Compact - Basics
Compact only this database or folder. To database path To compact a database in the Domino Data folder,
specify databases to compact using the Specify any enter the file name, such as sales.nsf. To compact
Files tab, select the databases in the files additional databases in a folder within the Data folder, specify
pane. options after the database path relative to the data folder, i.e., to
the database compact all databases in the folder, Data\Sales,
path. specify Sales.
If you choose "Compact all databases" or don't
specify a database path), Compact compacts all
databases in the Data folder and folders within the
Data folder.
Compact - Options
Compact database only if unused space is Compacts all databases with a specified percent of
greater than x percent unused space. For example, if you specify 10,
-S percent
databases with 10% or more recorded unused space
are compacted. Note that the unused space
calculation is not always a reliable measure of
unused space.
Discard any built view indexes Discards built view indexes. Use this option to
compact databases just before you store them on
-D
tape. Does copy-style compacting.
Keep or revert database to previous format Compacts databases without converting to the
current release file format of the server that stores
-R
the databases or reverts databases to the previous
release file format. For example, on Domino 6
servers, this option compacts Domino 5 databases
without converting them to the Domino 6 file format
and converts Domino 6 databases to the Domino 5
file format. This option uses copy-style compacting.
Compact - Style
Option Command line Description
equivalent
In-place with file size reduction Uses in-place compacting, recovers unused space
and reduces file size unless there's a pending
-B
structural change in which case copy-style
compacting occurs. If you use transaction logging, do
full database backups after compacting completes.
Copy-style: Allow access while compacting Enables users to continue to access databases during
compacting. If a user edits a database during
-L
compacting, compacting is canceled. Useful only
when copy-style compacting is done.
Copy-style: Ignore errors and proceed Enables compacting to continue even if it encounters
errors such as document corruption. Only used for
-i
copy-style compacting.
Compact - Advanced
Note that advanced Compact options are not available through the Compact tool on the Files tab of Domino
Administrator.
Option* Command Description
line
equivalent
Document table bitmap -f Disables "Document table bitmap optimization" database property.
optimization: Off Does copy-style compacting.
Document table bitmap -F Enables "Document table bitmap optimization" database property. Does
optimization: On copy-style compacting.
Don't support specialized -h Disables "Don't support specialized response hierarchy" database
response hierarchy: Off property; in other words, support specialized response hierarchy. Does
copy-style compacting.
Don't support specialized -H Enables "Don't support specialized response hierarchy" database
response hierarchy: On property; in other words, do not support specialized response
hierarchy. Does copy-style compacting.
Enable transaction logging: -t Disables transaction logging.
Off
Enable transaction logging: -T Enables transaction logging.
On
Don't maintain unread -u Disables "Don't maintain unread marks" database property; in other
marks: Off words, maintain unread marks.
Don't maintain unread -U Enables "Don't maintain unread marks" database property; in other
marks: On words, do not maintain unread marks.
NOTE: Select "Set advanced properties" before you enable or disable any of the above properties.
C. Fixup
When you restart a server, the server quickly searches for any unlogged databases that were modified but
improperly closed because of a server failure, power failure, hardware failure, and so on. A few minutes after
server startup is complete, the Fixup task then runs on these databases to attempt to fix any inconsistencies that
resulted from partially written operations caused by a failure. When users attempt to access one of these
databases and Fixup has not yet run on the database, the users see the message "This database cannot be
opened because a consistency check of it is in progress." A similar Fixup process occurs when you restart a Lotus
Notes client.
Multiple Fixup tasks run simultaneously at server startup to reduce the time required to fix databases. The number
of Fixup tasks that Domino runs by default at startup is equal to twice the number of processors available on the
server. Although this default behavior should be adequate in most circumstances, you can edit the NOTES.INI file
to include the Fixup_Tasks setting. The actual number of tasks run is the smaller of the configured number of
tasks that can run and the number of databases that require fixing. For example, if you set Fixup_Tasks to 4, but
only one database requires fixing, then only one Fixup task runs.
Keep in mind that, after you set up transaction logging, Fixup is not needed or used to bring databases back to a
consistent state.
Fixup- Options
Fixup options in Command line Description
Fixup tool and equivalent
Task - Start tool
Fixup all databases databasepath "Fixup only this database or folder" runs Fixup only on a specified database
Fixup only this or all databases in a specified folder. To run Fixup on a database in the
database or folder Domino data folder, enter the file name, for example SALES.NSF. To run
Fixup on a database or databases in folders within the data folder, enter the
path relative to the data folder. For example, to run Fixup on all databases
in the DATA\SALES folder, specify SALES.
"Fixup all databases" or no command line database path runs Fixup on all
databases on the server.
Note To specify databases or folders to run on using the Fixup tool, select
the database(s) or folder(s).
Report all processed -L Reports to the log file every database that Fixup opens and checks for
databases to log file corruption. Without this argument, Fixup logs only actual problems
encountered.
Scan only since last -I When you run Fixup on a specific database, Fixup checks only documents
fixup modified since Fixup last ran. Without this option, Fixup checks all
documents.
Scan all documents -F When you run Fixup on all databases, Fixup checks all documents in the
databases. Without this option, Fixup checks only documents modified since
it last ran.
Note To specify this option using the Fixup tool, deselect "Scan only since
last fixup."
Perform quick fixup -Q Checks documents more quickly but less thoroughly. Without this option,
Fixup checks documents thoroughly.
Exclude views -V Prevents Fixup from running on views. This option reduces the time it takes
(faster) Fixup to run. Use if view corruption isn't a problem.
Don't purge -N Prevents Fixup from purging corrupted documents so that the next time
corrupted Fixup runs or the next time a user opens the database, Fixup must check
documents the database again. Use this option to salvage data in documents if the
corruption is minor or if there are no replicas of the database.
Optimize user -U Reverts ID tables in a database to the previous release format. Don't select
unread lists this option unless Customer Support recommends doing so.
Fixup transaction- -J Runs on databases that are enabled for transaction logging. Without this
logged databases option, Fixup generally doesn't run on logged databases.
If you are using a certified backup utility, it's important that you schedule a
full backup of the database as soon after Fixup finishes as possible.
Fixup open -O If you run Fixup on open databases, Fixup takes the databases offline to
databases perform the fixup.
This is the default if you run Fixup and specify a database name. Without
this option, when you do not specify database names, Fixup does not run
on open databases.
Don't fixup open -Z Applies only to running Fixup on a single database. When a database isn't
databases taken offline and is in use, then Fixup is not run.
This is the default when Fixup is run on multiple databases.
Verify only -C Verifies the integrity of the database and reports errors. Does not modify
the database (for example, does not purge corrupted documents).
Fixup subdirectories -Y Runs Fixup on databases in subfolders (subdirectories).
Don't fixup -y Does not run Fixup on databases in subfolders (subdirectories).
subdirectories
II. Best utilities for weekly maintenance
If you are not running transactional logs, run the following for weekly maintenance, preferably on the weekend
when your server is not under a great work load:
Compact –B –s 10
If you are running transactional logs, run the following for weekly maintenance:
Compact –b –s 10
The above command compacts any database with more than 10% of white space. The "-b" and "-B" means an in-
place compaction. The "–b" is used with transaction logs so that no new dbIIDs are assigned to the databases.
There is no need to run Fixup or Updall as part of a weekly maintenance schedule. Fixup should be run only if
corruption is suspected of a database and Updall is run every night by default. Updall only needs to run with
switches if view corruption is suspected.
Database corruption
Database corruption is caused by something happening outside the ordinary that makes the database unusable
such as user complaints or error messages are reported. For example, when the server generates messages
indicating database corruption (with or without a crash), the following output may occur:
-- "database.nsf is damaged....
-- DbMarkCorrupt(DbFixup: invalid slot found, could not be repaired)...
-- database.nsf is CORRUPT - Now Read-Only!"
These utilities will change the dbIID associated with transaction logging so that if you run archived-style
transaction logging, immediately perform a full database backup.
Another option
If the steps above are unsuccessful, try creating a new replica of the database and replacing the original with the
new replica. Creating a new replica forces a complete rebuild of the database and repairs corruption or removes
items that are irreparable.
1. Run Fixup as follows (without quotes) to check the integrity of the corrupt database and report problems
without making any changes: "fixup database.nsf -L –F -O -C"
2. It is not recommended to use the Fixup utility to perform repairs during business hours. If attempts to repair
the database absolutely cannot wait until non-business hours, then use the following options with the compact
task:
compact database.nsf -c -L -i
NOTE: The best recommendation is to enable transaction logging which provides database integrity. Fixup is not
needed when transaction logging is enabled.
3. After running either of these, run the following to rebuild the views and indexes (if possible, wait until off-
hours).
updall database.nsf –R -X
For further information, refer to Document #1193738, "Managing corruption recovery during the business day."
Before upgrading
1. Before upgrading, it is recommended that you complete database clean-up on the existing server by running
Updall on the views, as follows:
updall –R –X
There are several options that can be run before upgrading. Running Updall -R -X is the most favorable option for
avoiding corruption because it completely rebuilds the view indexes and full text index. Other choices are:
Updall -v (updates the view indexes)
Updall -R (completely rebuilds the view indexes)
Updall -X (completely rebuilds the full text index)
2. Run "compact -c -D -i –K" (copy-style, delete view indexes, ignore errors, set large UNK table bit).
For further information, refer to Document #1201020, "Error: 'Database Is Corrupt; Cannot Allocate Space' when
Opening Database After Server Upgrade."
After upgrading
After an upgrade, it is recommended to upgrade to the latest search engine. Even though Domino is backward
compatible to all previous full text engines, it is a good idea to upgrade to the latest, using "updall –X". This will
rebuild all existing full text indexes using the new engine and enable its new features.
If a crash occurs that does not indicate it was due to a database issue
If the crash stack does not indicate anything related to database access, then database corruption is unlikely
(except for possible inconsistent states mentioned above), so running maintenance is probably not warranted.
How do you run the Domino maintenance utilities from the command line?
The methods and syntax for running maintenance from the command line vary by platform. The following example
shows how to run Fixup on the names.nsf for Windows, iSeries, and Unix/Linux/zSeries. Use these examples as a
guide for also running Compact and Updall from the command line.
NOTE: If corruption occurs in the Domino Directory, the Domino server must be in a stopped state to run Fixup.
For Windows, use "nfixup names.nsf –F". Note that if you are running transaction logging, be sure to add the -J
switch.
If you are running transaction logging, be sure to add the -J switch after -F. Also, it MUST run from QSECOFR or
the equivalent.
For Unix/Linux/zSeries, use "<path>/fixup names.nsf -F". Note that if you are running transaction logging, be
sure to add the -J switch. Also, you MUST be logged in as a Notes user with the Notes Data directory as the
current directory.