eG Monitoring
 

Measures reported by IBMDPFileSystemTest

The IBM DataPower Gateway's file system is split primarily into 4 sections; Encrypted space, Unencrypted space, Temporary space, and Internal space. The encrypted space is the internal persistent storage on the device. The following is included in the encrypted space:

  • Local, store, logstore, cert, pubcert, sharedcert, chkpoints, config, and tasktemplate directories

  • Audit logs

  • Persisted internal firmware files.

  • Rollback Firmware Image

The “temporary” and “internal” spaces are not persisted storage. If the device reboots or powers down, the files in the spaces are lost. If the “Reload” option is used, the files will not be cleared.

  • The temporary space includes these user accessible directories: temporary, image, export, and logtemp.

  • The internal space is not accessible by the user.

Both the “temporary” and “internal” space is also used for various processing actions during operation.

DataPower constantly monitors system resources, including memory and temporary file space. When free file space falls below the throttle-threshold, the DataPower Gateway refuses to accept new connections. If the amount of free file space does not rise above the threshold in the defined duration, the DataPower Gateway restarts. Therefore, administrators will have to closely track how each space in the file system is utilized and proactively detect any potential space shortage. This can be performed using the IBMDPFileSystemTest. This test auto-dicovers the file systems of IBM Datapower and reports the space usage on each file system and the exact file system that may run out of space very soon.

Outputs of the test : One set of results for the target device being monitored.

The measures made by this test are as follows:

Measurement Description Measurement Unit Interpretation
Total_encrypt_space Indicates the total amount of encrypted storage space on the device. MB All files placed in encrypted storage are automatically encrypted for security by the device.
Used_encrypt_space Indicates the total amount of encrypted space that is currently being used by this device. MB Ideally, the value of this measure should be low.
Free_encrypt_space Indicates the amount of encrypted space that is currently available for use on this device. MB Ideally, the value of this measure should be high.
Encrypt_space_usage Indicates the percentage of encrypted space that is currently being used by this device. Percent A value close to 100% is indicative of excessive usage of file system space. This can significantly degrade the performance of the device.
Total_unencrypt_space Indicates the total amount of unencrypted storage space on the device. MB All files placed in encrypted storage are not encrypted for security by the device.
Used_unencrypt_space Indicates the total amount of unencrypted space that is currently being used by this device. MB Ideally, the value of this measure should be low.
Free_unencrypt_space Indicates the amount of unencrypted space that is currently available for use on this device. MB Ideally, the value of this measure should be high.
Unencrypt_space_usage Indicates the percentage of unencrypted space that is currently being used by this device. Percent A value close to 100% is indicative of excessive usage of file system space. This can significantly degrade the performance of the device.
Total_temp_space Indicates the total amount of temporary storage space on the device. MB The device uses temporary storage for processing, logging, and debugging.
Used_temp_space Indicates the total amount of temporary space that is currently being used by this device. MB Ideally, the value of this measure should be low.
Free_temp_space Indicates the amount of temporary space that is currently available for use on this device. MB Ideally, the value of this measure should be high.
Temp_space_usage Indicates the percentage of temporary space that is currently being used by this device. Percent A value close to 100% is indicative of excessive usage of file system space. This can significantly degrade the performance of the device.
Total_internal_space Indicates the total amount of internal storage space on the device. MB The device uses internal storage for import, export, firmware upgrades and debug captures.
Used_internal_space Indicates the total amount of internal space that is currently being used by this device. MB Ideally, the value of this measure should be low.
Free_internal_space Indicates the amount of internal space that is currently available for use on this device. MB Ideally, the value of this measure should be high.
Internal_space_usage Indicates the percentage of internal space that is currently being used by this device. Percent A value close to 100% is indicative of excessive usage of file system space. This can significantly degrade the performance of the device.