When managing Domino Datasets you must:
-
Periodically check the Datasets administration interface.
-
Monitor and track storage consumption.
-
Set limits on usage per-Dataset.
-
Handle deletion of Dataset snapshots.
To access the Datasets administration interface, from the navigation pane, click Admin. Then go to Advanced > Datasets.
The Datasets administration page shows important information about Datasets usage in your deployment. The page shows the following information:
-
Total storage size used by all stored Snapshots.
-
The size of all storage used by Snapshots marked for deletion.
-
A table of all Snapshots from the history of the deployment. You can sort the table by Snapshot status, size, and the name of the containing Dataset.
Use the Central Configuration to limit the growth of storage consumption by Datasets.
Namespace: common
Key: com.cerebro.domino.dataset.quota.maxActiveSnapshotsPerDataset
Value: number
Default: 20
This option controls the maximum number of active Snapshots for a Dataset. Snapshots marked for deletion are not active and do not count against this limit.
Namespace: common
Key: com.cerebro.domino.dataset.quota.maxStoredSnapshotsPerDataset
Value: number
Default: 20
This option controls the total number of Snapshots of any status for a Dataset.
Namespace: common
Key: com.cerebro.domino.dataset.graceTimeForDeletion
Value: period
Default: 15 min
This option controls the delay before the delete operation is initiated after a dataset or snapshot is confirmed for deletion by an administrator. This gives you an opportunity to still recover the dataset or snapshot if you confirmed the deletion by mistake.
If a Dataset reaches one of the snapshot limits, attempting to create an additional snapshot will result in the oldest snapshot that is not tagged to be automatically marked for deletion.
If a Dataset reaches one of these limits, attempting to start a run with a Dataset configuration that can output a new Snapshot will result in an error message. Before additional Snapshots can be written, you will have to delete old snapshots or increase the limit.
You can authorize individual projects to ignore these limits with an option in the Hardware & environment tab of the project settings.
You can delete entire Datasets or individual Snapshots at any time using the Delete action at the end of each row. Initiating this action will result in a confirmation message, and if you choose to confirm, the Dataset (and all associated Snapshots) or the individual Snapshot will be permanently deleted. If the action was initiated by mistake, you can still recover a dataset or snapshot before the delete grace period (see above) expires the delete operation is initiated.
When a Dataset or a Snapshot is deleted, it will no longer be available for future executions. Executions that are in progress will also be affected if they attempt to read or write to the dataset that is deleted. To avoid disruptions, Domino recommends the following process for Dataset and Snapshot deletion. First, the user who owns the Dataset marks it for deletion, excluding it from any new executions that start. Then, an administrator then takes the action to delete the Dataset or Snapshot, if appropriate. Non-administrator users can never permanently delete a Dataset or Snapshots on their own.
From the Datasets administration page, you will have the option to Delete all marked datasets or Delete all marked snapshots and perform bulk delete confirmations. Alternatively, you can sort the tables by status to easily find all Datasets ot Snapshots marked for deletion.
Domino system administrators can use a full delete operation to completely remove all instances of a file from the Domino file system. Performing a full delete on a file finds all instances of the file’s contents across all revisions of all projects, erases those contents wherever they appear, and replaces them with a message indicating that the file was subject to a full delete. This affects all files that have identical contents to the target file, even if they have different filenames. It does not affect files with the same filename if they have different contents.
To perform a full delete follow these steps:
-
Open the file to delete and click Full Delete. Full delete can only be performed on one file at a time.
When prompted, enter a commit message and then confirm the full delete. The full delete removes all instances of the file contents from the Domino file system.
NoteNote