File System Management Service
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.