Tools > Storage Manager > Truncation Exclusions

The Truncation Exclusions option on the Tools menu enables you to specify files you want to exclude from the truncation process. The file path must be included when specifying the exclusion criteria.

Since paths are included in the criteria, this allows you to specify criteria which will affect all files within a directory. This basically allows an exclusion to be specified for a directory.

For example, you may want to exclude directories containing system files or files used during system login. When you create an exclusion for a directory, none of the files in that directory are truncated.

The process involves specifying directory paths as part of the criteria so StorNext knows how to locate and identify the files to exclude. You can create as many exclusion patterns as you like, and as your needs change you can delete unwanted exclusion patterns. These exclusions are stored in a file which StorNext checks when storing but before truncating.

The process involves specifying directory paths as part of the criteria so StorNext knows how to locate and identify the files to exclude. You can create as many exclusion patterns as you like, and as your needs change you can delete unwanted exclusion patterns. These exclusions are stored in a file which StorNext checks when storing but before truncating. If you update the truncation exclusion criteria, it does not effect any files which are already excluded.

A file remains excluded from truncation until you do one of the following:

Note: If you exclude a file and then later rename that file after it has been stored, the renamed file will continue to be excluded from truncation unless the renamed file does not match exclusion criteria and is modified so that it gets stored again, or you execute the command fschfiat –t c to remove the exclusion from the file.

On the Tools menu, click Storage Manager, and then click Truncation Exclusions. The Tools > Storage Manager > Truncation Exclusions page appears. Any previously saved exclusions are displayed.

  1. On the Tools menu, click Storage Manager, and then click Truncation Exclusions. The Tools > Storage Manager > Truncation Exclusions page appears.
  2. Click Add Exclusion.

  3. In the Type list, select one of the following types of exclusions:

    Exclusion Type Description

    Comment

    Displays notes and comments from the exclusion file, which appear anywhere in the file.

    Note: Comment lines can be added, edited, and deleted the same as exclusions.

    Unknown

    This type appears until you select a different type, and remains if you select no type.

    Match

    File paths which match the string in the Pattern field are excluded. Wildcards can be used for this type. To enter an exclusion which includes all files in a directory, the directory name and a wildcard must be specified.

    For example, enter /sn/foodir/* to exclude all files in the directory /sn/foodir.

    Note: The difference between Match and Match Path is that slashes must be explicitly entered for the Match Path type. When using Match Path you cannot substitute a wildcard for a slash.

    Match Path

    File paths which match the string in the Pattern field are excluded. Wildcards can be used for this type.

    Note: The difference between Match and Match Path is that slashes must be explicitly entered for the Match Path type. When using Match Path you cannot substitute a wildcard for a slash.

    Begins With

    File paths beginning with the string in the Pattern field are excluded.

    Ends With

    File paths ending with the string in the Pattern field are excluded.

    Contains

    File paths containing the string in the Pattern field are excluded.

    Exact

    Only file paths that exactly match the string in the Pattern field are excluded.

  4. At the Pattern field, enter the search string for the directory. Depending on the exclusion type you selected, this could be a whole or partial path name for a directory, or a string. If you selected the Match or Match Path type, you can use the following wildcards at the Pattern field:

    Wildcard Description

    ? (question mark)

    Substitute any single character.

    For example, if you enter t?p, it will match “top” “tip” and “tap”.

    * (asterisk)

    Substitute one or more characters.

    For example, if you enter f*l, it will match “ful” “fail” “foil” “fall” and “frail”.

    [ ] (brackets)

    When you use this wildcard, a set of characters are specified.

    For example, if you enter [abc]*, any string beginning with the letters “a” “b” or “c” are matched. When using brackets you can also specify a range by using the - (dash) character.

    For example, if you enter file[1-4], the strings “file1” “file2” “file3” and “file4” are matched. You can also specify a complement of characters to not match.

    For example, if you enter [!abc]*, any string that does not begin with the letters “a”, “b” or “c” are matched.

  5. Once saved, exclusions are applied automatically, and all saved exclusions apply at the same time. To save and apply the exclusion, click Apply.

    Caution: Any changes to the exclusions require a restart to the Storage Manager.

  6. When asked to confirm updating the exclusions, list, click Yes.
  7. When you are finished, click Done to return to the StorNext home page.

To delete an exclusion, click Delete to the right of the exclusion you want to delete.

Note: This particular delete function does not have a confirmation message, so be sure you want to delete an exclusion before you click Delete.

The following are some truncation exclusion examples:

Exclusion Type Pattern Description of Exclusion

Match

*/dir1/tmp*

 Excludes "tmp.file", "tmpstuff", and "/sn/fs1/dir/tmp.file", but not "file.tmp", or "/sn/fs1/dir2/tmp.file".

Match Path

/sn/fs1/dir1/*

 Excludes any file in the "/sn/fs1/dir1/" directory but not any files in subordinate directories such as "/sn/fs1/dir1/dir2/file".

Begins With

/sn/fs1/dir1/tmp

 Excludes "/sn/fs1/dir1/tmp.file", and "/sn/fs1/dir1/tmpstuff", but not "/sn/fs1/dir1/file.tmp", or "/sn/fs1/dir2/tmp.file".

Ends With

/dir1/tmpfile

 Excludes "/sn/fs1/dir1/tmpfile", "/sn/fs2/dir1/tmpfile", but not "/sn/fs1/dir2/tmpfile".

Contains

.man

temp

 Excludes "exclusions.man", "testrun.temp", "temp.logs", "temporary", anything in the "/sn/fs1/temp/" directory, but not "manifest", "sherman" or "/sn/fs1/xman/file".

Exact

/sn/fs1/temp_work.tmp

/sn/fs1/backup.out

 Excludes "/sn/fs1/temp_work.tmp" and "/sn/fs1/backup.out", but not "/sn/fs9/temp_work.tmp".

Note: For Match Path, the full directory path must be specified.