Description
File System Management Service. Specifies the location of file systems in which DICOM objects received from the Store SCP Server are stored. You can also set up rules to delete the most infrequently accessed studies.
Dependencies
Attributes
Name
The class name of the MBean
State
The status of the MBean
StateString
The status of the MBean in text form
FileSystemGroupID
Identifier of the file system group managed by this service, specified by property group of its MBean name.
DefaultRetrieveAETitle
Default Retrieve AE Title, which will be associated with new file systems added by operation addRWFileSystem.
Default Value: DCM4CHEE
DefaultAvailability
Default Availability, which will be associated with new file systems added by operation addRWFileSystem.
Enumerated values: "ONLINE", "NEARLINE","OFFLINE", "UNAVAILABLE".
Default Value: NEARLINE
DefaultUserInformation
Default User Information, which will be associated with new file systems added by operation addRWFileSystem.
DefaultStorageDirectory
Default Storage Directory, used on receive of the first object if no Storage File System was explicit configured byoperation [#addRWFileSystem}. A relative path name is resolved relative to <archive-install-directory>/server/default/.
Use "NONE" to disable auto-configuration to force failure to receive objects, if no Storage File System was explicit configured.
Default Value: NONE
CheckStorageFileSystemStatus
Flag indicating if the RW status of the current storage file system is checked before each file storage of objects received by the Storage SCP.
If the update of the status of the file system is only performed by invoking operations updateFileSystemStatus of this service - in particular, if there are no other running dcm4chee applications on other nodes (dcm4chee cluster), and File System records in the database will NOT be updated by executing SQL statements using some dcm4chee external SQL client application - the check can be deactivated to spare the execution of one additional SQL statement for each stored object.
Default Value: true
MakeStorageDirectory
Create storage directory, if no one exists.
Default Value: false
MountFailedCheckFile
If the specified file exists, this signals a failed mount.
Default Value: NO_MOUNT
MinimumFreeDiskSpace
Minimum free disk space. If the free available disk space on the current storage file system falls below this value, the next configured file system becomes the current storage system.
1MB = 1000000 bytes, 1GB = 1000MB.
NONE = disable check for minimal free available disk space.
Default Value: NONE
FreeDiskSpaceOnCurrentStorageFileSystem
Get free available disk space on the current storage file system in bytes.
FreeDiskSpaceOnCurrentStorageFileSystemString
Get free available disk space on the current storage file system as string.
UsableDiskSpaceOnCurrentStorageFileSystem
Get usable free disk space on the current storage file system, considering the configured value for MinimumFreeDiskSpace, by substracting that value from FreeDiskSpaceOnCurrentStorageFileSystem, in bytes.
UsableDiskSpaceOnCurrentStorageFileSystemString
Get usable free disk space on the current storage file system, considering the configured value for MinimumFreeDiskSpace, by substracting that value from FreeDiskSpaceOnCurrentStorageFileSystem, as string.
FreeDiskSpace
Get free available disk space on writable file systems of the file system group managed my this service.
FreeDiskSpaceString
Get free available disk space on writable file systems of the file system group managed my this service as string.
UsableDiskSpace
Get usable free disk space on writable file systems of the file system group managed my this service, considering the configured value for MinimumFreeDiskSpace, in bytes.
UsableDiskSpaceString
Get usable free disk space on writable file systems of the file system group managed my this service, considering the configured value for MinimumFreeDiskSpace, as string.
CheckFreeDiskSpaceMinimalInterval
Minimal Interval for checking free available disk space on current storage file system against minimum value specified by
MinimumFreeDiskSpace. The current interval (curInterval) is calculated by multiplication of this value (minInterval) with the ratio of the current free available disk space (curFDS) to the configured MinimumFreeDiskSpace (minFDS), but maximal the value specified by CheckFreeDiskSpaceMaximalInterval (maxInterval):
curInterval = min(minInterval * curFDS/minFDS, maxInterval)
Format: ##m (in minutes) | ##s (in seconds).
Default Value: 10s
CheckFreeDiskSpaceMaximalInterval
Maximal Interval for checking free available disk space on current storage file system against minimum value specified by MinimumFreeDiskSpace. Effective as long the current free available disk space is greater than MinimumFreeDiskSpace multiplied by the ratio of this value and the configured CheckFreeDiskSpaceMinimalInterval. Otherwise the interval will be calculated as described above for attribute CheckFreeDiskSpaceMinimalInterval.
Format: ##m (in minutes) | ##s (in seconds).
Default Value: 60s
CheckFreeDiskSpaceRetryInterval
Pause check for free available disk space for the specified time interval after no configured file system was found with sufficent (= more than specified by MinimumFreeDiskSpace) available disk space.
Format: ##m (in minutes) | ##s (in seconds).
Default Value: 60s
DeleterThresholds
Defines thresholds dependent on hour of day, for deleting the most infrequently accessed studies which satisfy the configured set of constraints.
Format: HOUR:##MB or HOUR:##GB or HOUR:##h
Multiple thresholds with different (start) hour separated by ';'.
NONE = disable deletion of studies on file systems of the file system group managed my this service.
Example: 7:1h;19:24h
=> free space for expected data volume received in 24 hours between 7pm and 7am. Between 7am and 7pm only delete studies if the usable free space falls below the expected data volume received in one hour.
Default Value: NONE
ExpectedDataVolumePerDay
Expected data volume per day. Used to transform time based deleter thresholds (s. DeleterThresholds) into disk space size to free.
Default Value: 100MB
AdjustExpectedDataVolumePerDay
Update value of attribute ExpectedDataVolumePerDay at midnight, if data volume received during last 24 hours exceeds its current value.
Default Value: true
CurrentDeleterThreshold
Get current effective deleter threshold in bytes according configured DeleterThreshold and ExpectedDataVolumePerDay. If UsableDiskSpace falls below this value, most infrequently accessed studies which satisfy the configured set of constraints will be deleted on next invocation of operation scheduleStudiesForDeletion.
DeleteStudyIfNotAccessedFor
Defines when a study not accessed for the specified time will be deleted from file systems of the file system group managed by this service, if it satisfies the configured set of constraints.
Format: ##h (in hours) | ##d (in days) | ##w (in weeks) | NEVER
NEVER = deletion of studies is only triggered by running out of disk space.
Example: 52w
=> any studies that have not been accessed for 52 weeks or more can be deleted if they satisfies the configured set of constraints.
Default Value: NEVER
DeleteStudyOnlyIfNotAccessedFor
Defines minimal time a study must not be accessed before it becomes a candidate for deletion.
Format: ##h (in hours) | ##d (in days) | ##w (in weeks)
Default Value: 1d
DeleteStudyOnlyIfStorageNotCommited
Defines if no Storage Commitment request must have been accepted for any instances of a study to become a candidate for deletion from file systems of the file system group managed my this service triggered by running out of disk space or being not accessed longer than configured DeleteStudiesNotAccessedFor. Typically only activated if no other constraint for study deletion is configured.
Default Value: false
DeleteStudyOnlyIfExternalRetrievable
Defines if all instances of a study must be retrievable from an external Application Entity to become a candidate for deletion from file systems of the file system group managed my this service triggered by running out of disk space or being not accessed longer than configured DeleteStudiesNotAccessedFor.
Default Value: false
InstanceAvailabilityOfExternalRetrievable
Defines assumed Instance Availability of only external retrievable Studies.
Enumerated values: ONLINE, NEARLINE, AUTO.
AUTO - query Instance Availability from external Retrieve AE..
Default Value: AUTO
DeleteStudyOnlyIfCopyOnMedia
Defines if all instances of a study must be stored on Media to become a candidate for deletion from file systems of the file system group managed my this service triggered by running out of disk space or being not accessed longer than configured DeleteStudiesNotAccessedFor.
Default Value: false
DeleteStudyOnlyIfCopyOnFileSystemOfFileSystemGroup
Defines if all instances of a study must be stored on a file system of the specified different file system group to become a candidate for deletion from file systems of the file system group managed my this service triggered by running out of disk space or being not accessed longer than configured DeleteStudiesNotAccessedFor.
"NONE" = no such constraint.
Default Value: NEARLINE_STORAGE
DeleteStudyOnlyIfCopyArchived
Defines if all instances of a study must be stored on a file system of a different file system group with file status: ARCHIVED to become a candidate for deletion from file systems of the file system group managed my this service triggered by running out of disk space or being not accessed longer than configured DeleteStudiesNotAccessedFor. Typically the file system group of the file system holding the archived copy is specified by DeleteStudyIfCopyOnFileSystemOfFileSystemGroup.
Default Value: false
DeleteStudyOnlyIfCopyOnReadOnlyFileSystem
Defines if all instances of a study must be stored on a read-only file system of a different file system group to become a candidate for deletion from file systems of the file system group managed my this service triggered by running out of disk space or being not accessed longer than configured DeleteStudiesNotAccessedFor. Typically the file system group of the read-only file systems is specified by DeleteStudyIfCopyOnFileSystemOfFileSystemGroup.
Default Value: false
ScheduleStudiesForDeletionOnSeriesStored
Defines if operation scheduleStudiesForDeletion is invoked to schedule deletion of most infrequently accessed studies after storage of a new Series by the Storage SCP Service.
Default Value: false
ScheduleStudiesForDeletionInterval
Interval in which operation scheduleStudiesForDeletion is invoked to schedule deletion of most infrequently accessed studies which satisfies the configured set of constraints from writable file systems of the file system group managed my this service, if they were not accessed longer than configured DeleteStudiesNotAccessedFor or if UsableDiskSpace falls below CurrentDeleterThreshold.
Format: ##s (in seconds), ##m (in minutes), ##h (in hours).
NEVER = do not invoke operation scheduleStudiesForDeletion by timer thread automatically. => If also ScheduleStudiesForDeletionOnSeriesStored is not activated, no studies will be deleted automatically from file systems of the file system group managed my this service.
Default Value: NEVER
ScheduleStudiesForDeletionBatchSize
Defines maximal number of studies scheduled for deletion in one transaction.
Default Value: 100
DeleteOrphanedPrivateFilesInterval
Interval in which operation deleteOrphanedPrivateFiles is invoked to delete orphaned private files from writable file systems of the file system group managed my this service. Orphaned private files are the result of deleting instances from the web trash folder.
Format: ##s (in seconds), ##m (in minutes), ##h (in hours).
NEVER = do not invoke operation deleteOrphanedPrivateFiles automatically => never delete orphaned private files from the file system group managed my this service automatically.
Default Value: NEVER
DeleteOrphanedPrivateFilesBatchSize
Limit the number of orphaned private files that are deleted by one invocation of operation <i>deleteOrphanedPrivateFiles</i>.
Default Value: 1000
UpdateStudiesBatchSize
Defines maximal number of studies fetched from the data base in one transaction by operation updateFileSystemAvailability and updateFileSystemRetrieveAETitle for update of Availability and RetrieveAETs values in Study, Series and Instance records.
Default Value: 1000
TimerIDScheduleStudiesForDeletion
Used internally. Do NOT modify.
TimerIDDeleteOrphanedPrivateFiles
Used internally. Do NOT modify.
SchedulerServiceName
Used internally. Do NOT modify.
DeleteStudyServiceName
Used internally. Do NOT modify.
StoreScpServiceName
Used internally. Do NOT modify.
Operations
create
Standard MBean lifecycle method
start
The start lifecycle operation
stop
The stop lifecycle operation
destroy
The destroy lifecycle operation
jbossInternalLifecycle
The detyped lifecycle operation (for internal use only)
listAllFileSystems
List all configured file systems.
listFileSystems
List all configured file systems associated with the file system group managed my this service.
listFileSystemDirectories
Return Directory Paths for all configured file systems associated with the file system group managed my this service as array of Files.
addRWFileSystem
Add RW file system to the file system group managed my this service. The file system is also linked to existing other file systems of the group.
removeFileSystem
Remove empty file system from the file system group managed my this service. Will fail, if there are already/still file records associated with the file system.
linkFileSystems
Link or unlink two file systems of the file system group managed my this service.
updateFileSystemStatus
Update RW status of the specified file system. If the new file system status is "RW+", which defines the file system as current storage file system, the status of the previous storage file system is set to "RW", to ensure that there is only one file system in one file system group with status "RW+".
updateFileSystemAvailability
Update file system availability of the specified file system.
updateFileSystemRetrieveAETitle
Update Retrieve AE Title associated to the specified file system.
selectStorageFileSystem
Select Storage File System
selectStorageDirectory
Select Storage File System and return Directory
adjustExpectedDataVolumePerDay
Update value of attribute ExpectedDataVolumePerDay, if data volume received during last 24 hours exceeds its current value.
scheduleStudiesForDeletion
Schedules deletion of most infrequently accessed studies which satisfies the configured set of constraints from writable file systems of the file system group managed my this service, if they were not accessed longer than configured DeleteStudiesNotAccessedFor or if UsableDiskSpace falls below CurrentDeleterThreshold. Returns the number of studies scheduled for deletion.
scheduleStudyForDeletion
Schedule deletion of study with specified Study Instance UID from writable file systems of the file system group managed by this service, without consideration of the configured set of constraints. Returns size of study in bytes scheduled for deletion.
deleteOrphanedPrivateFiles
Delete orphaned private files from writable file systems of the file system group managed my this service. Orphaned file system.
selectStorageFileSystem
Select Storage File System
selectStorageDirectory
Select Storage File System and return Directory
adjustExpectedDataVolumePerDay
Update value of attribute ExpectedDataVolumePerDay, if data volume received during last 24 hours exceeds its current value.
scheduleStudiesForDeletion
Schedules deletion of most infrequently accessed studies which satisfies the configured set of constraints from writable file systems of the file system group managed my this service, if they were not accessed longer than configured DeleteStudiesNotAccessedFor or if UsableDiskSpace falls below CurrentDeleterThreshold.
Returns the number of studies scheduled for deletion.
scheduleStudyForDeletion
Schedule deletion of study with specified Study Instance UID from writable file systems of the file system group managed by this service, without consideration of the configured set of constraints. Returns size of study in bytes scheduled for deletion.
deleteOrphanedPrivateFiles
Delete orphaned private files from writable file systems of the file system group managed my this service. Orphaned private files are the result of deleting instances from the web trash folder. Returns the number of deleted files.