Configuration of FileStatusTest

This test reports whether the files that are to be monitored is available or not. In addition, this test also reports the size of all the available files.

This page depicts the default parameters that need to be configured for the FileStatusTest.

• The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

• In the HOST text box, the host name of the server for which the test is to be configured has to be specified.

• In the FILENAME text box, provide a comma-separated list of the full path of the files that are to be monitored. For instance, on a Unix host, your specification can be: opt/usr/alert.log,opt/tmp/error.log. On a Windows host, your specification can be: C:\eGurkha\agent\logs\agentout.log,C:\eGurkha\agent\logs\agenterr.log.

  Also, if you want to monitor files with names that include a date, then your FILENAME specification should indicate the date format used for naming the files. For instance, to monitor all files that are named error, but which end with dates that are of the format DDMMYY, your FILENAME specification should be: C:\logs\errorDDMMYY. As per this specification, files such as error21082015, error22082015, and error24082015 will be monitored.
  Your filename specification can include file names with dates and without dates - for e.g., C:\eGurkha\agent\logs\agentout.log,C:\eGurkha\agent\logs\agenterr.log, C:\logs\errorDDMMYY,C:\errorlogs\MMDDYYYY_error

  Note:

  1. Wildcard characters are not supported while entering the full path of the files in the FILENAME text box. So provide the exact path of the files in the same.
  2. The date pattern should be specified in uppercase only.
  3. The date patterns may be specified in the following formats: YYYYMMDD, YYYYDDMM, DDMMYYYY, DDYYYYMM, MMDDYYYY, MMYYYYDD, YYMMDD, YYDDMM, DDMMYY, DDYYMM, MMDDYY, MMYYDD

• Using this test, you can also monitor all files with names that include a date. If your FILENAME specification above includes files with dates, then set the DATE PATTERN flag to Yes. If this is done, then the test will look for date patterns in your FILENAME specification. If your FILENAME specification does not include data patterns, set this flag to No. If this is done, then the test will not look for date patterns in your FILENAME specification. Say that you include a file name that embeds a date pattern in your FILENAME specification - eg., C:\logs\errorMMDDYYYY - and set the DATE PATTERN flag to No. In this case, the test will disregard the date pattern MMDDYYYY, and will instead search for a file with the name, errorMMDDYYYY.

• In the MAX AGE IN HOURS text box, specify the time duration in hours beyond which this test should report whether/not the file configured against the FILENAME is updated. By default, this parameter is set to none.

• If multiple components of the same component type are awaiting configuration, then an APPLY TO OTHER COMPONENTS check box will appear in this page. Clicking on this check box will allow you to apply the configuration to all/selected components of that type.

• Once the necessary values have been provided, clicking on the UPDATE button will register the changes made.

When changing the configuration for specific servers, a “*” beside the text box corresponding to the parameter signifies that these values have to be manually configured by the user. The parameter values that require to be configured will typically be prefixed with a “$” or contain a series of “*”. A value of "none" in the parameter value indicates that the corresponding parameter value can be changed if required.