Getting a file statistics summary

You can display a summary of file statistics within a volume on a storage system by reading file information from a Snapshot copy that you specify. File statistics help you determine when to schedule creation of Snapshot copies by enabling you to see when most file activity takes place on a volume. The information also helps you determine Snapshot copy disk consumption.

Step

1. Enter the following command: filestats [-g] [-u] [async] [ages ages] [timetype {a,m,c,cr}] [sizes sizes] snapshot snapshot_name [volume volume_name] [style style] [file output_file]
   • The snapshot argument is required. If the volume name is not specified, vol0 is assumed.
   • snapshot_name is the name of the Snapshot copy.
   • volume_name is the name of the volume.
   • The -g option enables you to generate separate file usage summaries for each group ID. For each group ID, a separate table containing information about file sizes and ages is listed.
   • The -u option enables you to generate separate file usage summaries for each user ID. For each user ID, a separate table containing information about file sizes and ages is listed.
   • The ages option enables you to see when files have been accessed. You can specify file ages in seconds, hours, and days, using a comma to separate each value. By default, file ages are broken down by days, in 30-day increments.
   • The timetype option enables you to specify the time types that you want to list in the age comparison. The following table describes the valid values you can use with the timetype option.

     Value	Definition
     a	Access time
     m	Modification time
     c	File change time (last size/status change)
     cr	File creation time

   • The sizes option enables you to specify the breakdown of sizes, using a comma to separate each value. Default values are in bytes, but you can also use the following suffixes at the end of a number you specify:
     • K (kilobytes).
     • M (megabytes).
     • G (gigabytes).
     • * (a special value for listing all unique file sizes, one line per unique size). Using the * suffix can result in output of several thousands of lines.
   • The style option controls the output style. The valid arguments are as follows:
     • readable—The default. This is what you see when you use the filestats command with no style option.
     • table—Use this argument when the filestats output will be used by processing programs.
     • html—Use this argument for output that will be read by a Web browser.
   • The file option prints the results of the filestats command to the specified output file, rather than the console. The output file is created in the /etc/log directory.
   • The async option causes the filestats command to run independently of the console. This option is designed for use with the file option.
     Note: Running more than one asynchronous filestats command simultaneously can adversely affect system performance.

• Example of the filestats command with no options specified
  You can use the filestats command without any options to display information about a Snapshot copy, including a breakdown of files by size, age, user ID, and group ID, and the cumulative number of inodes for each value.
• Examples of the filestats command with ages option specified
  You can use the filestats command with the ages option to display a daily breakdown of file changes in a volume.
• Example of the filestats command with sizes option specified
  You can use the filestats command with the sizes option to specify the breakdown of sizes.
• Example of using the filestats command to determine volume capacity
  You can use the filestats command to determine when the most activity occurs on a volume during a given day so that you can effectively schedule creation of hourly Snapshot copies.