Domino V11 Compact Options

Today I saw a program document from a customer environment with different compact options and to be honest >> I haven’t seen some of them for a while ( -W, -X, -x ). Those options are not mentioned in the official documentation ( https://bit.ly/39LzSC1 ) but you can get a complete list of the options when using the following command in your Server Console ( the following is from our Domino V11 server ):

lo compact -?

Please note the additional information after this listing !!!

-A Archive and delete documents without compacting.
-a Archive and delete documents, then compact database.
-B Recover space and reduce file size (inplace-style).
-b Recover space without reducing file size (inplace-style).
-C Copy-style compaction.
-D Discard view indexes (copy-style).
-daos on Enable ‘Use Domino Attachment and Object Service’ database
property. (Use with -C to move current objects into DAOS)
-daos off Disable ‘Use Domino Attachment and Object Service’ database
property. (Use with -C to move current objects out of DAOS)
-e No-execute: Show effective arguments only, since some arguments
affect others.
-F Enable ‘Document table bitmap optimization’ database property
(copy-style).
-f Disable ‘Document table bitmap optimization’ database property
(copy-style).
-g Copy-style compact the DB2 group associated with this database
or databases (for directories).  Recovers disk space in DB2.
-G Copy-style compact the DB2 group name passed in as a parameter.
Recovers disk space in DB2.
-H Enable ‘Don’t support specialized response hierarchy’ database
property (copy-style).
-h Disable ‘Don’t support specialized response hierarchy’ database
property (copy-style).
-i Ignore errors (for copy-style only).
-j Just Delete (must specify -a or -A to be valid).
-K Enable large UNK table (>64 KB).
-k Disable large UNK table (>64 KB).
-L Don’t lock users out during compaction (for copy-style only).
-M Set maximum database size to 4 GB.
-N Disable ‘Compress database design’ database property.
(Use -C with -N to uncompress current database design documents)
-n Enable ‘Compress database design’ database property.
(Use -C with -n to compress current database design documents)
-nifnsf on Enable ‘Move views out of database’ database
property. (Use with -C to move current views out of database)
-nifnsf off  Disable ‘Move views out of database’ database
property. (Use with -C to move current views into database)
-o Check for overlapping objects.
-p Convert to an NSFDB2 database.
-pirc on Enable ‘Purge Interval Replication Control’ on database.
-pirc off Disable ‘Purge Interval Replication Control’ on database.
-r Revert to previous ODS format (e.g. on an R8 system,
keep/convert back to R7 format).
-R Revert one ODS based on the current ODS of the database.
(e.g. Converts an R8 (ODS48) database to R7 (ODS43) format)
-S nnnK Compact database if unused space estimate >= nnn KB.
-S nnnM Compact database if unused space estimate >= nnn MB.
-S nn Compact database if unused space estimate >= nn percent.
-T Enable transaction logging.
-t Disable transaction logging.
-U Enable ‘Don’t maintain unread marks’ database property.
-u Disable ‘Don’t maintain unread marks’ database property.
-upgrade Upgrade databases created with older DB classes to the
most recent class.
-V Disable ‘Compress document data’ database property.
(Use -C with -V to uncompress current document data)
-v Enable ‘Compress document data’ database property.
(Use -C with -v to compress current document data)
-W nn Only compact databases which haven’t been compacted successfully
in last nn days. Ordered by last compact time.
-w Exclude system databases (e.g. log.nsf, names.nsf).
-X nn Limit each database compaction to no more than nn minutes.
(applies to in-place compaction only)
-x nn Limit total compaction time to no more than nn minutes.
-Y Recurse through subdirectories (default).
-y Do not recurse through subdirectories.
-ZU Enable ‘Use LZ1 compression for attachments’ database property.
(Use -C with -ZU to compress existing attachments using LZ1.)
-0 Process NSFDB2 databases only.  This will ignore NSF databases
and is to be used with other switches.
-* Include *.ntf and *.box when processing a directory
-# nn Execute up to nn compactions in parallel using different threads.
Up to a maximum of 20 Threads with a default of 1.
-ODS Perform a copy-style compact only if the current ODS is less than
desired default ODS.
-IDS_FULL What percentage full of IDs to create a new replica (optional).
-REN_WAIT Number of minutes to wait for rename (optional).
-RESTART Restart server if rename does not succeed and complete rename
on startup (optional).

I received an information from the HCL Grandmaster Daniel Nashed that

  • there are troubles with the option “-REPLICA” in Domino V10 and also in Domino V11. When using the option “lo compact db.nsf -REPLICA” some profile documents are removed and this bug is reproducable !! Therefore >> DON´T USE THIS OPTION !!!
  • Also don´t use the option “-ZU” at already DAOS enabled databases !!! > In earlier releases -ZU was ignored for DAOS enabled databases. Now it works but gets attachments out of DAOS into the NSF to recompress, which is increasing the physical database size and duplicates data. You should only use -ZU before you enable DAOS. And this needs to be a two step process.

Leave a comment