PowerScale OneFS 9.2.1.0 CLI Administration Guide

PDF

Email quota notification messages

If email notifications for exceeded quotas are enabled, you can customize PowerScale templates for email notifications or create your own.

There are three email notification templates provided with OneFS. The templates are located in /etc/ifs and are described in the following table:


Template	Description
quota_email_template.txt	A notification that disk quota has been exceeded.
quota_email_grace_template.txt	A notification that disk quota has been exceeded (also includes a parameter to define a grace period in number of days).
quota_email_test_template.txt	A notification test message you can use to verify that a user is receiving email notifications.

If the default email notification templates do not meet your needs, you can configure your own custom email notification templates by using a combination of text and SmartQuotas variables. Whether you choose to create your own templates or modify the existing ones, make sure that the first line of the template file is a Subject: line. For example:

Subject: Disk quota exceeded

If you want to include information about the message sender, include a From: line immediately under the subject line. If you use an email address, include the full domain name for the address. For example:

From:  administrator@abcd.com

In this example of the quota_email_template.txt file, a From: line is included. Additionally, the default text "Contact your system administrator for details" at the end of the template is changed to name the administrator:

Subject: Disk quota exceeded
From: administrator@abcd.com

The <ISI_QUOTA_DOMAIN_TYPE> quota on path <ISI_QUOTA_PATH> owned by 
<ISI_QUOTA_OWNER> has exceeded the <ISI_QUOTA_TYPE> limit.
The quota limit is <ISI_QUOTA_THRESHOLD>, and <ISI_QUOTA_USAGE>
is currently in use. You may be able to free some disk space by
deleting unnecessary files. If your quota includes snapshot usage,
your administrator may be able to free some disk space by deleting
one or more snapshots. Contact Jane Anderson (janderson@abcd.com)
for details.

This is an example of a what a user will see as an emailed notification (note that the SmartQuotas variables are resolved):

Subject: Disk quota exceeded
From: administrator@abcd.com

The advisory disk quota on directory /ifs/data/sales_tools/collateral
owned by jsmith on production-Boris was exceeded.

The quota limit is 10 GB, and 11 GB is in use. You may be able 
to free some disk space by deleting unnecessary files. If your 
quota includes snapshot usage, your administrator may be able 
to free some disk space by deleting one or more snapshots. 
Contact Jane Anderson (janderson@abcd.com) for details.