Storage configuration

^{since version 1.4}

The default configuration file for the storage purposes can be changed by opening the inspectit-cmr.jar file and editing the config/storage.properties file.

Storage folder

By default the folder where all storage data resisting on one CMR will be saved is path_to_CMR_root_folder/storage. This can be changed by altering the storage configuration file. Please change the value of the following property, if you need to change the default storage folder:

# name of the storage folder
storage.storageDefaultFolder = storage

Note that the path given will be relative to the path_to_CMR_root_folder.

Maximum number of opened channels

CMR uses the FileChannel class to write data to a file. When this channel is open it is reserving one socket connection. Since, some systems can have limited numbers of socket connections that can be open at the single moment, it is possible to change the number of maximum opened file channels at single point of time. Check the following line of the storage.properties file:

# number of max channels that will be opened for write in a single moment
storage.maxWriteChannelsOpened = 256

Note that the higher number of open channels will reduce the overhead needed for channels closing/opening, and if there are no system limitations the default value should not be decreased.

Hard-drive space occupancy

It is possible to define how much hard drive space can be maximally occupied by the storage data on the machine where CMR runs. Note that the default value is -1, and this means that no limit is set. Any positive value will set the limit to the specified amount of bytes. Check the following line of the storage.properties file: 

# Amount of bytes that CMR can occupy on the Hard drive for storing the storage data
# Use negative values for the unlimited space -> space left on hard drive
# Note that if this number is less than available space on the Hard drive, then complete left space will be used
storage.maxHardDriveOccupancy = -1

It is possible to define two other properties:

• warnHardDriveByteLeft - define amount of bytes when user should be warned that space left is low (default: 1GB)

• stopWriteHardDriveBytesLeft - define amount of bytes when no writing will be allowed any more (default: 100MB)

# Amount of bytes left to the maxHardDriveOccupancy or hardDriveSpaceLeft to make CMR warn the user that the space for storage data is on critical level
# 1GB by default
storage.warnHardDriveByteLeft = 1073741824

# Amount of bytes left to the maxHardDriveOccupancy or hardDriveSpaceLeft to make CMR stop writing any data
# 100MB by default
storage.stopWriteHardDriveBytesLeft = 104857600