DAOS Manager Tell commands

You use Tell commands with the Domino® Attachment and Object Service (DAOS) Manager process.

Table 1. DAOS Manager Tell commands

Command

Result
Tell DAOSMgr Quit

Stops DAOS Manager process, cleans up, and exits.

Tell DAOSMgr Help

Lists DAOS Manager options.

Tell DAOSMgr Status

Displays status of various DAOS Manager operations.

Tell DAOSMgr Status database_name

Displays DAOS status of the database with database_name, for example, mymail.nsf.

Tell DAOSMgr Status Catalog

Displays status of the DAOS catalog.

Tell DAOSMgr Dbsummary

Displays status of all DAOS-enabled databases.

The dbsummary command accepts additional optional parameters to filter the output of the command. For details, see Dbsummary and databases command filters at the end of this document.

Tell DAOSMgr Databases

Displays status of all DAOS-enabled databases with additional details, for example, a database's last resynchronization point.

The databases command accepts additional optional parameters to filter the output of the command. For details, see Dbsummary and databases command filters at the end of this document.

Tell DAOSMgr ListNLO

Lists DAOS objects (.NLO files) in the DAOS storage repository, allowing an administrator to identify documents whose objects may be missing after an event such as a server restore or the deletion of a database file through the operating system. You can restore the missing objects from backup sources. Files are missing when they are still referenced by documents in at least one database, but are no longer present in the repository.

You can enter -o to specify the name of an output file, the keyword ALL or MISSING to list all or just missing files, and the name of a database whose objects to list. For example:

tell daosmgr listnlo -o mymailobjects.txt MISSING mymail.nsf

Tell DAOSMgr Prune number of days old

With no argument, displays the current setting for Defer object deletion for n days, also known as the deferred delete interval, specified on the DAOS tab of the Server document.

With the argument 0, immediately deletes all DAOS unreferenced objects.

With the number of days old argument, immediately deletes all DAOS unreferenced objects that are older than the argument, overriding the delete interval specified in the Server document.

CAUTION: Objects that have not been backed up since the specified duration are at risk of being unrecoverable.

Tell DAOSMgr Resync

Resynchronizes DAOS-enabled databases with DAOS objects in the storage repository. Resynchronization is necessary whenever DAOS reference counts need to be recalculated, for example when there has been a database restore, deletion of a database through the operating system, or any other event that can invalidate the count.

Resynchronization corrects mismatches between reference counts in the DAOS catalog (DAOSCAT.NSF) and actual objects found. When a mismatch is detected, DAOS disallows pruning of attachment objects (.NLO files) until DAOS is synchronized using this command.

You can set a time window for resynchronization so that it occurs during quiet hours. For more information, see the related topics.

Tell DAOSMgr Resync Force

Runs the resynchronization command whether or not the DAOS catalog is in a synchronized state.

Tell DAOSMgr Resync Quick

Runs the resynchronization command, but without reference counts on the .NLO files, leaving the catalog in the RESYNCING state, and preventing the nightly prune process from running. A quick resync makes DAOS operational if it is needed during production hours, allowing new .NLO files to be created and all existing ones read.

After a quick resync, the next full resync is needed to complete the process by scanning databases and adjusting reference counts.

For more information on the DAOS catalog states, see Related information.
Tell DAOSMgr Repair Objects Works together with the resynchronization command to identify DAOS objects that are needed on the server but were marked as missing by resync. The repair command will attempt to copy any missing .NLO files from the server's cluster mates and restore them if possible. You can configure repair to run automatically after a resync using the DAOS configuration tab of the server document.

For more information on configuring DAOS repair, see Repairing missing DAOS objects.
Tell DAOSMgr Repair .NLO file name Repairs the specified .NLO file, for example E0B7DEE218E9BCD2392E836AA536E767306B5F0F000010E1.nlo.
Tell DAOSMgr Repair list missing

Lists the DAOS objects that were detected as missing during resync – these are objects which may be recoverable from this server's cluster mates.
Tell DAOSMgr Repair databasename.nsf Makes attempts to repair any missing DAOS attachments that the specified database has references to.
Note: This command is for v14.0 FP1 and later.
Tell DAOSMgr Resyncsnapshot enable Sets a flag which instructs DAOSMgr to build an object. As a result, the database cross references the next time that DAOS resync runs. For more information, see Gathering DAOS data using DAOS resync snapshot.
Tell DAOSMgr Resyncsnapshot enablefull Sets a flag which instructs DAOSMgr to build an object -> database cross reference with additional encryption related information the next time that DAOS resync runs. For more information, see Gathering DAOS data using DAOS resync snapshot.
Tell DAOSMgr Resyncsnapshot disable Unsets the flag set with resyncsnapshot enable or resyncsnapshot enablefull effectively canceling the scheduled snapshot request.
When resyncing, you can now see the progress displayed in the "show task" status output. The typical output from the "show task" command is:
DAOS Manager Resync: Idle
DAOS Manager Prune: Idle
DAOS Manager DbDelete: Idle
DAOS Manager Adopt: Idle
DAOS Manager Idle
After starting a sync through tell daosmgr resync, it will show:
sh tas
DAOS Manager S3Push: Idle
DAOS Manager Resync: Synchronized 28 of 62 databases (45 percent)
DAOS Manager Prune: Idle
DAOS Manager DbDelete: Idle
DAOS Manager Adopt: Idle
DAOS Manager Idle

In 14.5 the resync status is enhanced to display more detailed information. Every 30 seconds the task status is updated to display the progress of the resync so that the Domino administrator can see that the resync is progressing. It marks progress for the following stages of resync:

Table 2. Resync status values
Value Description
Purging ticket lists DAOS catalog cleanup
Recycling DIT entries Determining which databases are using DAOS
Scanning DAOS objects Updating progress every 30 seconds
Tier 1 Scan Progress T1 Scan Completed - Found: 90115 (Elapsed seconds= 5 Average Rate= 18023/second)
Tier 2 Scan Progress T2 Scanning namespace ref/A42B6C188D1D8A0DC9E52B40072437DB4A18A92E for server D18B4C0FF663D5064AB02031F3618994A1270001
Resync: T2 Scan Completed - Examined: 258150 Found: 258150 [Shared: 258150 Private:0] (Elapsed seconds=35 Average Rate=7292/second)
Completed scanning DAOS objects Resync: Scanning DAOS objects...complete. 348265 Total objects [T1:90115, T2 Shared: 258150 , T2 Private: 0]
Scanning DAOS enabled databases Begin scan of DAOS enabled databases to update object reference counts
Database scanning progress Resync: Synchronized 35 of 70 databases (50 percent)
Completed scanning databases Resync: Completed scan of 70 DAOS enabled databases in 100 seconds
Resync completed

If you run a resync with the Domino server running, the task status will be updated. You can use the "show task" command to see the status. If you run a resync from the command line, all of the status updates will be displayed on the command console.

Resync statistics list

In addition to the logging resync progress, you will now also collect DAOS resync statistics.

  • SH STAT DAOS.Resync.*
  • DAOS.Resync.Databases.Active = 30
  • DAOS.Resync.Databases.Processed = 70
  • DAOS.Resync.Objects.Found = 348265
  • DAOS.Resync.Objects.Found.T1 = 90115
  • DAOS.Resync.Objects.Found.T2 = 258150
  • DAOS.Resync.Objects.Found.T2.Private = 0
  • DAOS.Resync.Objects.Found.T2.Shared = 258150
  • DAOS.Resync.Purged.TicketLists = 0
  • DAOS.Resync.Subcontainers.Active = 5
  • DAOS.Resync.Subcontainers.Scanned = 11
  • DAOS.Resync.Summary.DbCount = 70
  • DAOS.Resync.Summary.References = 665385
  • DAOS.Resync.Summary.References.AvgPerDb = 9371
  • DAOS.Resync.Summary.References.AvgPerObject = 7.38
  • DAOS.Resync.Summary.ScanSeconds.Database = 100
  • DAOS.Resync.Summary.ScanSeconds.T2 = 35
  • DAOS.Resync.Summary.Scan.T2.Examined = 348265
  • 18 statistics found

Dbsummary and databases command filters

The dbsummary and databases commands both accept additional parameters that filter the command output.
Parameter Meaning
-nz No zero, do not display information for databases that have zero active DAOS references (show only databases with active DAOS references).
-filter (or -f) Only show DAOS-enabled databases that contain this filter string.

For example:

  • tell daosmgr dbsummary -f autoupdate

    Matches autoupdate.nsf, autoupdateserver.nsf and autoupdate.ntf

  • tell daosmgr dbsummary -f autoupdatese

    Matches autoupdateserver.nsf, but excludes autoupdate.nsf and autoupdate.ntf

  • tell daosmgr dbsummary -f mail3\

    Matches all DAOS-enabled databases in the mail3 directory
-state (or -s) [Resync | Synch | Deleted | Adopt] Only show DAOS-enabled databases that have the specified state. A typical use for this filter is to see which DAOS-enabled databases have gone out of sync.

For example:

  • tell daosmgr dbsummary -s Resync

    Matches databases in states "Resync: Needed", "Resync: Scanning", "Resync: Pending", or "Resync: Updating Refs"

  • tell daosmgr dbsummary -s Deleted

    Matches databases in states "Deleted" or "Deleted: Updating Refs"
Note: These parameters can be used in any combination, such as:
  • dbsummary -f mail3\ -state Resync

    Shows information for DAOS-enabled databases in mail3\ which need to be resynchronized

  • dbsummary -f mail3\ -nz

    Shows information for DAOS-enabled databases in mail3\ which have at least one DAOS reference