dirscan Release Notes All series

Nimsoft® Monitor™

Legal Notices

This online help system (the "System") is for your informational purposes only and is subject to change or withdrawal by CA at any time.

This System may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA. This System is confidential and proprietary information of CA and protected by the copyright laws of the United States and international treaties. This System may not be disclosed by you or used for any purpose other than as may be permitted in a separate agreement between you and CA governing your use of the CA software to which the System relates (the “CA Software”). Such agreement is not modified in any way by the terms of this notice.

Notwithstanding the foregoing, if you are a licensed user of the CA Software you may make one copy of the System for internal use by you and your employees, provided that all CA copyright notices and legends are affixed to the reproduced copy.

The right to make a copy of the System is limited to the period during which the license for the CA Software remains in full force and effect. Should the license terminate for any reason, it shall be your responsibility to certify in writing to CA that all copies and partial copies of the System have been destroyed.

TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS SYSTEM “AS IS” WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS SYSTEM, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE.

The manufacturer of this System is CA.

Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or their successors.

Copyright © 2014 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

Legal information on third-party and public domain software used in the Nimsoft Monitor solution is documented in Nimsoft Monitor Third-Party Licenses and Terms of Use (http://docs.nimsoft.com/prodhelp/en_US/Library/Legal.html).

Contact CA

Contact CA Support

For your convenience, CA Technologies provides one site where you can access the information that you need for your Home Office, Small Business, and Enterprise CA Technologies products. At http://ca.com/support, you can access the following resources:

■ Online and telephone contact information for technical assistance and customer services

■ Information about user communities and forums

■ Product and documentation downloads

■ CA Support policies and guidelines

■ Other helpful resources appropriate for your product

Providing Feedback About Product Documentation

Send comments or questions about CA Technologies Nimsoft product documentation to nimsoft.techpubs@ca.com.

To provide feedback about general CA Technologies product documentation, complete our short customer survey which is available on the CA Support website at http://ca.com/docs.

Contents 5

Contents

Chapter 1: dirscan General Overview 7

dirscan Feature List ...................................................................................................................................................... 7

Chapter 2: Requirements 9

Hardware Requirements .............................................................................................................................................. 9

Software Requirements ............................................................................................................................................... 9

Supported Platforms .................................................................................................................................................... 9

Chapter 3: Considerations 11

Installation Considerations ......................................................................................................................................... 11

Chapter 4: Fixed Defects 13

Revision History .......................................................................................................................................................... 13

Chapter 1: dirscan General Overview 7

Chapter 1: dirscan General Overview

This probe monitors files in specific directories. Alarms can be sent on number of files, age of files, and space used by files.

dirscan Feature List

This probe checks:

■ Existence of directories

■ Shared directories (Windows systems only)

■ Named files or file patterns in a directory (option to include subdirectories)

Alarm conditions for:

■ Number of matching files

■ Age of matching files

■ Space used by files

■ Size of individual file

■ Response time when reading a file

■ File modification

Send QoS data for:

■ Number of matching files

■ Age of oldest/newest matching file

■ Space used by matching files

■ File read response time

■ File integrity

Chapter 2: Requirements 9

Chapter 2: Requirements

This section contains the following topics:

Hardware Requirements (see page 9) Software Requirements (see page 9) Supported Platforms (see page 9)

Hardware Requirements

The dirscan probe is installed on systems with the following minimum resources:

■ Memory: 2-4 GB of RAM. The OOB configuration of the probe requires 256 MB of RAM

■ CPU: 3-GHz dual-core processor 32, or 64 bit

Software Requirements

The dirscan probe requires the following software environment:

■ Nimsoft Monitor Server 5.1.1 or later

■ Nimsoft Robot 3.00 or later

■ Java Virtual Machine 1.6 or later

Supported Platforms

The dirscan probe is supported on the same set of operating systems and databases as the Nimsoft Monitor Server solution. Please refer to the:

■ Nimsoft Compatibility Support Matrix for the latest information on supported platforms.

■ Support Matrix for Nimsoft Probes for additional information on the dirscan probe.

Chapter 3: Considerations 11

Chapter 3: Considerations

This section contains the following topics:

Installation Considerations (see page 11)

Installation Considerations

Version 2.22 implemented a new layout of the message pool. If upgrading from a version prior to 2.22, you need to modify the dirscan.cfx file in the package. The steps to modify the file are as follows:

■ Get the latest version of the probe from the Internet Archive

■ Double-click the dirscan package in the Archive node of the Nimsoft Infrastructure Manager

■ Select the tab for your platform and click on dirscan.cfx

■ Right-click and select Edit file...

■ Locate the <messages> section and add the 'clear' keyword after the closing bracket. Click OK

■ Repeat for each platform you intend to distribute the updated probe to

■ Distribute the update to all systems running v2.22 or older

Note: All custom messages will be cleared and default messages in the new format will be inserted.

The description of the QoS for file age, QOS_DIR_AGE was previosly defined as Age of oldest/newest matching file. In version 2.22, this has been changed to Age of matching file.

Chapter 4: Fixed Defects 13

Chapter 4: Fixed Defects

This section contains the following topics:

Revision History (see page 13)

Revision History

This section describes the history of the revisions for this probe.

Date Description State Version

April 2014 ■ Fixed the defect of scheduler by allowing user to clear specific hours of one particular day of a week. Earlier the probe can select or clear the specific hours for an entire week.

3.09

June 2013 ■ Added Probe Defaults 3.08

May 2013 ■ Directory search with % parameters without directory exist check issue fixed

3.07

April 2013 ■ Directory search test with % parameters issue fixed 3.06

May 2012 ■ Fixed issue with fetch current in GUI.

■ Improved error handling.

■ Removed clear on restart.

■ Fixed alarm message defaults in the configuration tool.

3.05

March 2011 ■ Corrected NISTOKEN string for Used Space Delta Alarm Message.

■ Fixed Directory variable expansion for directory check..

■ Fixed NULL QOS value for age of file when their is no file in the directory..

3.04

Revision History

14 dirscan Release Notes

Date Description State Version

March 2011 ■ Removed dirScan file integrity profile file number limit.

■ Fixed the defect of sending NULL QoS for number of files in a directory, when zero files are found.

■ File Integrity : Added Support for run time pattern matching.

■ Addition of schedular functionality to the dirscan probe on per watcher basis.

■ Monitoring directory/file size change (say x unit) in last number of cycles (say y cyles) and sending appropriate alarms.

■ Added feature to monitor the probe on the basis of current time stamping for windows.

3.03

January 2011 Added fixes to web-based Service Oriented Configuration. 3.02

June 2010 Made changes to libraries with respect to configuration locking. 2.91

March 2010 Added support for extended NIS database information. 2.90

March 2010 Fixed the problem which would sometimes cause the probe to crash when running multiple profiles.

2.81

September 2009

Added support for Linux systems with glibc 2.2. 2.80

July 2009 Changed the behavior for the integrity profiles: If the MD5 signature for a file is not set, it will be generated and stored in the configuration file during the probe startup or restart process.

2.73

Revision History

Chapter 4: Fixed Defects 15

Date Description State Version

June 2009 ■ Fixed directory variable for file age alarms.

■ Fixed clear for file size, file age and file response alarms.

■ Fixed crash situation on stop and restart.

■ Disabled 'Fetch' button in configuration tool for settings not supported by the test command.

■ Fixed token for 'DirAge' alarm message.

■ Cleanup of code for mapping/unmapping shares.

■ Added option for Quality of Service message on directory existance.

■ Reorganized configuration tool, separating directory scan and file integrity profiles.

■ Fixed directory scan problem on shares introduced in version 2.43.

■ Fixed file and directory variables for clear messages so that these are consistent with other alarm situations.

■ Added scan type for file size: largest, smallest or individual file.

■ Added scan type for response time: longest, shortest or individual.

■ Modified browse/doubleclick behaviour.

■ Improved error handling on memory allocation situations.

■ Added support for Windows on Itanium 2 systems (IA64).

2.72

December 2008

Rebuild following NimBUS library fixes. 2.53

Revision History

16 dirscan Release Notes

Date Description State Version

September 2008

■ Problem with generated directory names containing the '/' character as directory separator on Windows is resolved.

■ Configuration tool fixed to disallow empty profile name.

■ Configuration tool crash on profile copy fixed.

■ The default messages in the message pool are no longer overwritten on redistribution of the probe. For upgrade from version 2.22 and earlier, see the installation notes.

■ Added support for 64-bit Windows (x64)

■ Added support for LINUX on 64bit PowerPC (glibc = 2.3)

■ Added support for 64bit platforms on AIX, HP-UX, SOLARIS and LINUX.

Please note that, for version 2.52 and higher of this probe, Robot version 3.00 (or higher) is a prerequisite. You are advised to carefully read the document "Upgrading the NimBUS Robot" before installing/upgrading.

2.52

October 2007 ■ Fixed variable expansion in command strings.

■ Fixed problem with passwords that where corrupted on profile edit.

■ This version turns off profile monitoring if directory does not exist.

■ Clear messages are now sent for file read response.

■ Added cluster probe support.

■ Clear messages are sent on response time within limit and also when the file no longer exists.

■ Modified logic in the directory browser so that the '[..]' entry will not appear at the share level.

■ Fixed handling of more than one directory specified and of directory recursion.

■ Added new alarm message used for alerting when unable to open a file for obtaining a response time.

2.43

Revision History

Chapter 4: Fixed Defects 17

Date Description State Version

25.05.2007 ■ Fixed a number of minor memory leaks.

■ Fixed problem with uninitialized memory causing occasional program failure.

■ Modified algorithm for clearing of age and size alarms, also changed suppression keys and format of dirscan.file.

■ Fixed problem with Recurse into subdirectories.

■ Fixed problem when changing option of Age of file from checking All files to only check Newest file.

UNIX: Added new versions to supported platform list

AIX_5: 64bit

HPUX_11: 64bit (PA-RISC & Itanium)

LINUX: 64bit (Glibc >=2.3)

SOLARIS_8: 64bit (Sparc)

SOLARIS_10: 64bit (x86_64)

SOLARIS_10: 32bit (x86)

GUI changed for Age of file constraint. Added radio button for Age of all files. This replaces checkbox for 'Send alarm for each breaching file'. Choosing Age of all files disables the button for Fetch current values. Fixed clearing of alarms if multiple files recover from breaching Age of file constraint. Breaching files that no longer exist will also send clear with reported age 0 min.

2.42

November 2006

Age constraint alarm can now be sent either for each breaching file, or oldest/newest if only a single alarm is desired.

2.29

August 2006 ■ Alarm messages fix.

■ Added extra log information at loglevel 2 during file scanning.

2.27

July 2006 ■ Remove clear flag for the messages section in the cfx file which would clear out custom messages.

■ The flag was added in v2.22 because of a change in the message format.

■ See Installation Notes below if upgrading from a version prior to 2.22 for information on what to change in the cfx file to upgrade the messages correctly.

2.26

Revision History

18 dirscan Release Notes

Date Description State Version

July 2006 ■ Windows: Fix problem with username/password not being set correctly when testing a connection

■ Age constraint alarm is sent for each file breaching the threshold (not just oldest/newest). QoS data is still for the oldest/newest however.

■ Solaris, AIX and Linux: Added utility (stat64) for reading file sizes over 2GB.

■ GUI: user and password information for shared drives would not show up when editing an existing profile.

2.25

April 2006 ■ New GUI layout.

■ Regenerates MD5 digest from GUI.

■ Fixed problem with the "Fetch current values" button on "Read Reponse Time".

■ Changed description of QoS for file age.

2.22

November 2005

Added support for file integrity check using MD5 digest. Added support for using Date/Time primitives (strftime parameters) when specifying directory names.Support for customizing alarms and "Clear" messages.

2.21

November 2004

Changed QoS definition for file age to use unit "s". Added support for file size alarms on large files on Windows.

2.20