Datasets administration

Overview


Domino administrators have four important responsibilities when managing Domino Datasets:

  1. periodically check the Datasets administration interface
  2. monitor and track storage consumption
  3. set limits on usage per-Dataset
  4. handle deletion of Dataset snapshots

 

 

Prerequisites

  • Domino 3.3+ on AWS in an EFS-enabled region

    If you're running Domino on-premises and want to use Datasets, contact your Customer Success Manager for more information.

 

 

 

Accessing the Datasets administration interface


To access the Datasets administration interface, click Admin from the Domino main menu to open the Admin home, then click Advanced > Datasets.

 

Screen_Shot_2019-02-05_at_12.24.03_PM.png

 

  

 

Monitoring Datasets usage


The Datasets administration page shows important information about Datasets usage in your deployment. At the top of the interface is a display that shows:

  • total storage size used by all stored Snapshots
  • the size of all storage used by Snapshots marked for deletion

Below that display is a table of all Snapshots from the history of the deployment. This table can be sorted by Snapshot status, size, and the name of the containing Dataset.

 

Screen_Shot_2019-02-05_at_8.46.30_PM.png

 

 

  

Setting limits on Datasets usage


There are two important central configuration options administrators can use to limit the growth of storage consumption by Datasets.

Namespace: common
Keycom.cerebro.domino.dataset.quota.maxActiveSnapshotsPerDataSet
Value: number
Default: 20

This option controls the maximum number of active Snapshots that may be stored in a Dataset. Snapshots marked for deletion are not active and do not count against this limit.
Namespace: common
Keycom.cerebro.domino.dataset.quota.maxStoredSnapshotsPerDataSet
Value: number
Default: 20

This option controls the total number of Snapshots of any status that may be stored in a Dataset.

If a Dataset reaches one of these limits, attempting to start a run with a Dataset configuration that could output a new Snapshot will result in an error message. Before additional Snapshots can be written, you will need to delete old snapshots or increase the limit.

Administrators can authorize individual projects to ignore these limits with an option in the Hardware & environment tab of the project settings.

 

Screen_Shot_2019-02-05_at_9.10.09_PM.png

 

 

 

Deleting Snapshots from Datasets


Administrators can delete individual Snapshots at any time with the Delete button at the end of the row representing the Snapshot in the Datasets administration UI. Clicking this button will open a confirmation dialog, and if you choose to confirm, the Snapshot will be permanently deleted.

 

Screen_Shot_2019-02-05_at_9.17.37_PM.png

 

To avoid losing user data, Domino recommends following a two-step process for Snapshot deletion, where the user who owns the Dataset marks a Snapshot for deletion, and then an administrator takes action to delete the Snapshot if reasonable. Non-administrator users can never permanently delete Snapshots on their own.

From the Datasets administration UI, you'll find a button you can click to Delete all marked snapshots, and you can also sort the table of Snapshots by status to find and examine all Snapshots that have been marked for deletion.

Was this article helpful?
0 out of 0 found this helpful