public static final class Archive.Configuration extends Object
Details for the individual parameters can be found in the Javadoc for the Archive.Context setters.
| Modifier and Type | Field and Description |
|---|---|
static int |
ARCHIVE_CONTROL_SESSIONS_TYPE_ID
The type id of the
Counter used for keeping track of the count of concurrent control sessions. |
static String |
ARCHIVE_DIR_DEFAULT
Default directory for the archive files.
|
static String |
ARCHIVE_DIR_DELETE_ON_START_PROP_NAME
Should the archive delete existing files on start.
|
static String |
ARCHIVE_DIR_PROP_NAME
Directory in which the archive stores it files such as the catalog and recordings.
|
static int |
ARCHIVE_ERROR_COUNT_TYPE_ID
The type id of the
Counter used for keeping track of the number of errors that have occurred. |
static String |
ARCHIVE_ID_PROP_NAME
Property name for the identity of the Archive instance.
|
static String |
ARCHIVE_IDLE_STRATEGY_PROP_NAME
Default
IdleStrategy to be used for the archive Agents when not busy. |
static String |
ARCHIVE_RECORDER_IDLE_STRATEGY_PROP_NAME
The
IdleStrategy to be used for the archive recorder Agent when not busy. |
static String |
ARCHIVE_REPLAYER_IDLE_STRATEGY_PROP_NAME
The
IdleStrategy to be used for the archive replayer Agent when not busy. |
static String |
AUTHENTICATOR_SUPPLIER_DEFAULT
Name of the class to use as a supplier of
Authenticator for the archive. |
static String |
AUTHENTICATOR_SUPPLIER_PROP_NAME
Name of the system property for specifying a supplier of
Authenticator for the archive. |
static String |
AUTHORISATION_SERVICE_SUPPLIER_PROP_NAME
Name of the system property for specifying a supplier of
AuthorisationService for the archive. |
static long |
CATALOG_CAPACITY_DEFAULT
Default capacity in bytes for the
Catalog. |
static String |
CATALOG_CAPACITY_PROP_NAME
Default capacity in bytes of the archive
Catalog. |
static int |
CATALOG_FILE_SYNC_LEVEL_DEFAULT
Default is to use normal file writes which may mean some data loss in the event of a power failure.
|
static String |
CATALOG_FILE_SYNC_LEVEL_PROP_NAME
The level at which catalog updates and directory should be sync'ed to disk.
|
static long |
CONDUCTOR_CYCLE_THRESHOLD_DEFAULT_NS
Default threshold value for the conductor work cycle threshold to track for being exceeded.
|
static String |
CONDUCTOR_CYCLE_THRESHOLD_PROP_NAME
Property name for threshold value for the conductor work cycle threshold to track for being exceeded.
|
static long |
CONNECT_TIMEOUT_DEFAULT_NS
Default timeout for connecting back to a client for a control session or replay.
|
static String |
CONNECT_TIMEOUT_PROP_NAME
Timeout for making a connection back to a client for a control session or replay.
|
static String |
CONTROL_CHANNEL_ENABLED_PROP_NAME
Is network (UDP) control channel enabled.
|
static AuthorisationServiceSupplier |
DEFAULT_AUTHORISATION_SERVICE_SUPPLIER
Default
AuthorisationServiceSupplier that returns AuthorisationService that allows any
command to be executed (i.e. |
static String |
DEFAULT_IDLE_STRATEGY
Default
IdleStrategy to be used for the archive Agents when not busy. |
static int |
ERROR_BUFFER_LENGTH_DEFAULT
Size in bytes of the error buffer for the archive when not eternally provided.
|
static String |
ERROR_BUFFER_LENGTH_PROP_NAME
Size in bytes of the error buffer for the archive when not externally provided.
|
static int |
FILE_IO_MAX_LENGTH_DEFAULT
Default block length of data in a single IO operation during a recording or replay.
|
static String |
FILE_IO_MAX_LENGTH_PROP_NAME
Maximum length of a file IO operation for recording or replay.
|
static int |
FILE_SYNC_LEVEL_DEFAULT
Default is to use normal file writes which may mean some data loss in the event of a power failure.
|
static String |
FILE_SYNC_LEVEL_PROP_NAME
The level at which recording files should be sync'ed to disk.
|
static int |
LOW_STORAGE_SPACE_THRESHOLD_DEFAULT
Default threshold below which the archive will reject new recording requests.
|
static String |
LOW_STORAGE_SPACE_THRESHOLD_PROP_NAME
Threshold below which the archive will reject new recording requests.
|
static String |
MARK_FILE_DIR_PROP_NAME
Alternative directory to store mark file (i.e.
|
static long |
MAX_CATALOG_ENTRIES_DEFAULT
Deprecated.
|
static String |
MAX_CATALOG_ENTRIES_PROP_NAME
Deprecated.
Use
CATALOG_CAPACITY_PROP_NAME instead. |
static int |
MAX_CONCURRENT_RECORDINGS_DEFAULT
Default maximum number of concurrent recordings.
|
static String |
MAX_CONCURRENT_RECORDINGS_PROP_NAME
Maximum number of concurrent recordings which can be active at a time.
|
static int |
MAX_CONCURRENT_REPLAYS_DEFAULT
Default maximum number of concurrent replays.
|
static String |
MAX_CONCURRENT_REPLAYS_PROP_NAME
Maximum number of concurrent replays.
|
static String |
RECORD_CHECKSUM_PROP_NAME
Property that specifies fully qualified class name of the
Checksum
to be used for checksum computation during recording. |
static long |
RECORDER_CYCLE_THRESHOLD_DEFAULT_NS
Default threshold value for the recorder work cycle threshold to track for being exceeded.
|
static String |
RECORDER_CYCLE_THRESHOLD_PROP_NAME
Property name for threshold value for the recorder work cycle threshold to track for being exceeded.
|
static String |
REPLAY_CHECKSUM_PROP_NAME
Property that specifies fully qualified class name of the
Checksum
to be used for checksum validation during replay. |
static long |
REPLAY_LINGER_TIMEOUT_DEFAULT_NS
Default for long to linger a replay connection which defaults to
Configuration.publicationLingerTimeoutNs(). |
static String |
REPLAY_LINGER_TIMEOUT_PROP_NAME
How long a replay publication should linger after all data is sent.
|
static long |
REPLAYER_CYCLE_THRESHOLD_DEFAULT_NS
Default threshold value for the replayer work cycle threshold to track for being exceeded.
|
static String |
REPLAYER_CYCLE_THRESHOLD_PROP_NAME
Property name for threshold value for the replayer work cycle threshold to track for being exceeded.
|
static String |
REPLICATION_CHANNEL_PROP_NAME
Channel for receiving replication streams replayed from another archive.
|
static int |
SEGMENT_FILE_LENGTH_DEFAULT
Default segment file length which is multiple of terms.
|
static String |
SEGMENT_FILE_LENGTH_PROP_NAME
Recordings will be segmented on disk in files limited to the segment length which must be a multiple of
the term length for each stream.
|
static String |
THREADING_MODE_PROP_NAME
What
ArchiveThreadingMode should be used. |
| Constructor and Description |
|---|
Configuration() |
| Modifier and Type | Method and Description |
|---|---|
static String |
archiveDirName()
Get the directory name to be used for storing the archive.
|
static AuthenticatorSupplier |
authenticatorSupplier()
The value
AUTHENTICATOR_SUPPLIER_DEFAULT or system property
AUTHENTICATOR_SUPPLIER_PROP_NAME if set. |
static AuthorisationServiceSupplier |
authorisationServiceSupplier()
The
AuthorisationServiceSupplier specified in the
AUTHORISATION_SERVICE_SUPPLIER_PROP_NAME system property or the
DEFAULT_AUTHORISATION_SERVICE_SUPPLIER. |
static long |
catalogCapacity()
Default capacity (size) in bytes for the catalog file.
|
static int |
catalogFileSyncLevel()
The level at which the catalog file and directory should be sync'ed to disk.
|
static long |
conductorCycleThresholdNs()
Get threshold value for the conductor work cycle threshold to track for being exceeded.
|
static long |
connectTimeoutNs()
The timeout in nanoseconds to wait for a connection.
|
static boolean |
controlChannelEnabled()
Should the network (UDP) control channel be enabled.
|
static boolean |
deleteArchiveOnStart()
Whether to delete directory on start or not.
|
static int |
errorBufferLength()
Size in bytes of the error buffer in the mark file.
|
static int |
fileIoMaxLength()
The maximum length of a file IO operation.
|
static int |
fileSyncLevel()
The level at which files should be sync'ed to disk.
|
static Supplier<IdleStrategy> |
idleStrategySupplier(StatusIndicator controllableStatus)
Create a supplier of
IdleStrategys for the ARCHIVE_IDLE_STRATEGY_PROP_NAME
system property. |
static long |
lowStorageSpaceThreshold()
The low storage space threshold beyond which the archive will reject new requests to record streams.
|
static String |
markFileDir()
Get the alternative directory to be used for storing the archive mark file.
|
static long |
maxCatalogEntries()
Deprecated.
Use
catalogCapacity() instead. |
static int |
maxConcurrentRecordings()
The maximum number of recordings that can operate concurrently after which new requests will be rejected.
|
static int |
maxConcurrentReplays()
The maximum number of replays that can operate concurrently after which new requests will be rejected.
|
static String |
recordChecksum()
Fully qualified class name of the
Checksum implementation to use during
recording to compute checksums. |
static long |
recorderCycleThresholdNs()
Get threshold value for the recorder work cycle threshold to track for being exceeded.
|
static Supplier<IdleStrategy> |
recorderIdleStrategySupplier(StatusIndicator controllableStatus)
Create a supplier of
IdleStrategys for the ARCHIVE_RECORDER_IDLE_STRATEGY_PROP_NAME
system property. |
static String |
replayChecksum()
Fully qualified class name of the
Checksum implementation to use during
replay for the checksum. |
static long |
replayerCycleThresholdNs()
Get threshold value for the replayer work cycle threshold to track for being exceeded.
|
static Supplier<IdleStrategy> |
replayerIdleStrategySupplier(StatusIndicator controllableStatus)
Create a supplier of
IdleStrategys for the ARCHIVE_REPLAYER_IDLE_STRATEGY_PROP_NAME
system property. |
static long |
replayLingerTimeoutNs()
The timeout in nanoseconds to for a replay network publication to linger after draining.
|
static String |
replicationChannel()
The system property
REPLICATION_CHANNEL_PROP_NAME if set, null otherwise. |
static int |
segmentFileLength()
The length of file to be used for storing recording segments that must be a power of 2.
|
static ArchiveThreadingMode |
threadingMode()
The threading mode to be employed by the archive.
|
public static final int FILE_IO_MAX_LENGTH_DEFAULT
public static final String FILE_IO_MAX_LENGTH_PROP_NAME
public static final String ARCHIVE_DIR_PROP_NAME
public static final String ARCHIVE_DIR_DEFAULT
ARCHIVE_DIR_PROP_NAME,
Constant Field Valuespublic static final String MARK_FILE_DIR_PROP_NAME
archive-mark.dat).public static final String SEGMENT_FILE_LENGTH_PROP_NAME
public static final int SEGMENT_FILE_LENGTH_DEFAULT
public static final String LOW_STORAGE_SPACE_THRESHOLD_PROP_NAME
public static final int LOW_STORAGE_SPACE_THRESHOLD_DEFAULT
public static final String FILE_SYNC_LEVEL_PROP_NAME
public static final int FILE_SYNC_LEVEL_DEFAULT
FILE_SYNC_LEVEL_PROP_NAME,
Constant Field Valuespublic static final String CATALOG_FILE_SYNC_LEVEL_PROP_NAME
public static final int CATALOG_FILE_SYNC_LEVEL_DEFAULT
public static final String THREADING_MODE_PROP_NAME
ArchiveThreadingMode should be used.public static final String ARCHIVE_IDLE_STRATEGY_PROP_NAME
IdleStrategy to be used for the archive Agents when not busy.public static final String ARCHIVE_RECORDER_IDLE_STRATEGY_PROP_NAME
IdleStrategy to be used for the archive recorder Agent when not busy.public static final String ARCHIVE_REPLAYER_IDLE_STRATEGY_PROP_NAME
IdleStrategy to be used for the archive replayer Agent when not busy.public static final String DEFAULT_IDLE_STRATEGY
IdleStrategy to be used for the archive Agents when not busy.public static final String MAX_CONCURRENT_RECORDINGS_PROP_NAME
public static final int MAX_CONCURRENT_RECORDINGS_DEFAULT
public static final String MAX_CONCURRENT_REPLAYS_PROP_NAME
public static final int MAX_CONCURRENT_REPLAYS_DEFAULT
@Deprecated public static final String MAX_CATALOG_ENTRIES_PROP_NAME
CATALOG_CAPACITY_PROP_NAME instead.Catalog. Increasing this limit will require use of the
CatalogTool. The number of entries can be reduced by extending existing recordings rather than
creating new ones.@Deprecated public static final long MAX_CATALOG_ENTRIES_DEFAULT
Catalogpublic static final String CATALOG_CAPACITY_PROP_NAME
Catalog. Catalog will resize itself when this
limit is reached.public static final long CATALOG_CAPACITY_DEFAULT
Catalog.CATALOG_CAPACITY_PROP_NAME,
Constant Field Valuespublic static final String CONNECT_TIMEOUT_PROP_NAME
public static final long CONNECT_TIMEOUT_DEFAULT_NS
CONNECT_TIMEOUT_PROP_NAMEpublic static final String REPLAY_LINGER_TIMEOUT_PROP_NAME
public static final long REPLAY_LINGER_TIMEOUT_DEFAULT_NS
Configuration.publicationLingerTimeoutNs().REPLAY_LINGER_TIMEOUT_PROP_NAMEpublic static final String CONDUCTOR_CYCLE_THRESHOLD_PROP_NAME
public static final long CONDUCTOR_CYCLE_THRESHOLD_DEFAULT_NS
public static final String RECORDER_CYCLE_THRESHOLD_PROP_NAME
public static final long RECORDER_CYCLE_THRESHOLD_DEFAULT_NS
public static final String REPLAYER_CYCLE_THRESHOLD_PROP_NAME
public static final long REPLAYER_CYCLE_THRESHOLD_DEFAULT_NS
public static final String ARCHIVE_DIR_DELETE_ON_START_PROP_NAME
public static final String REPLICATION_CHANNEL_PROP_NAME
public static final String AUTHENTICATOR_SUPPLIER_PROP_NAME
Authenticator for the archive.public static final String AUTHENTICATOR_SUPPLIER_DEFAULT
Authenticator for the archive. Default is
a non-authenticating option.public static final String AUTHORISATION_SERVICE_SUPPLIER_PROP_NAME
AuthorisationService for the archive.public static final AuthorisationServiceSupplier DEFAULT_AUTHORISATION_SERVICE_SUPPLIER
AuthorisationServiceSupplier that returns AuthorisationService that allows any
command to be executed (i.e. AuthorisationService.ALLOW_ALL).public static final int ARCHIVE_ERROR_COUNT_TYPE_ID
Counter used for keeping track of the number of errors that have occurred.public static final int ARCHIVE_CONTROL_SESSIONS_TYPE_ID
Counter used for keeping track of the count of concurrent control sessions.public static final String ERROR_BUFFER_LENGTH_PROP_NAME
public static final int ERROR_BUFFER_LENGTH_DEFAULT
public static final String RECORD_CHECKSUM_PROP_NAME
Checksum
to be used for checksum computation during recording.public static final String REPLAY_CHECKSUM_PROP_NAME
Checksum
to be used for checksum validation during replay.public static final String ARCHIVE_ID_PROP_NAME
Aeron.clientId() of the assigned Aeron instance.public static final String CONTROL_CHANNEL_ENABLED_PROP_NAME
true.
If set to anything other than true then control channel is disabled, i.e. the Archive will run in
IPC-only mode.
public static String archiveDirName()
public static String markFileDir()
public static int fileIoMaxLength()
public static int segmentFileLength()
If the Image.termBufferLength() is greater than this will take priority.
public static long lowStorageSpaceThreshold()
public static int fileSyncLevel()
FILE_SYNC_LEVEL_PROP_NAMEpublic static int catalogFileSyncLevel()
CATALOG_FILE_SYNC_LEVEL_PROP_NAMEpublic static ArchiveThreadingMode threadingMode()
public static Supplier<IdleStrategy> idleStrategySupplier(StatusIndicator controllableStatus)
IdleStrategys for the ARCHIVE_IDLE_STRATEGY_PROP_NAME
system property.controllableStatus - if a ControllableIdleStrategy is required.Supplier.public static Supplier<IdleStrategy> recorderIdleStrategySupplier(StatusIndicator controllableStatus)
IdleStrategys for the ARCHIVE_RECORDER_IDLE_STRATEGY_PROP_NAME
system property.controllableStatus - if a ControllableIdleStrategy is required.Supplier.public static Supplier<IdleStrategy> replayerIdleStrategySupplier(StatusIndicator controllableStatus)
IdleStrategys for the ARCHIVE_REPLAYER_IDLE_STRATEGY_PROP_NAME
system property.controllableStatus - if a ControllableIdleStrategy is required.Supplier.public static int maxConcurrentRecordings()
public static int maxConcurrentReplays()
@Deprecated public static long maxCatalogEntries()
catalogCapacity() instead.catalogCapacity()public static long catalogCapacity()
public static long connectTimeoutNs()
CONNECT_TIMEOUT_PROP_NAMEpublic static long replayLingerTimeoutNs()
REPLAY_LINGER_TIMEOUT_PROP_NAME,
Configuration.PUBLICATION_LINGER_PROP_NAMEpublic static long conductorCycleThresholdNs()
public static long recorderCycleThresholdNs()
public static long replayerCycleThresholdNs()
public static boolean deleteArchiveOnStart()
ARCHIVE_DIR_DELETE_ON_START_PROP_NAMEpublic static String replicationChannel()
REPLICATION_CHANNEL_PROP_NAME if set, null otherwise.REPLICATION_CHANNEL_PROP_NAME if set.public static int errorBufferLength()
ERROR_BUFFER_LENGTH_PROP_NAMEpublic static AuthenticatorSupplier authenticatorSupplier()
AUTHENTICATOR_SUPPLIER_DEFAULT or system property
AUTHENTICATOR_SUPPLIER_PROP_NAME if set.AUTHENTICATOR_SUPPLIER_DEFAULT or system property
AUTHENTICATOR_SUPPLIER_PROP_NAME if set.public static AuthorisationServiceSupplier authorisationServiceSupplier()
AuthorisationServiceSupplier specified in the
AUTHORISATION_SERVICE_SUPPLIER_PROP_NAME system property or the
DEFAULT_AUTHORISATION_SERVICE_SUPPLIER.AUTHORISATION_SERVICE_SUPPLIER_PROP_NAME if set or
DEFAULT_AUTHORISATION_SERVICE_SUPPLIER otherwise.public static String recordChecksum()
Checksum implementation to use during
recording to compute checksums. Non-empty value means that checksum is enabled for recording.Checksum interfaceRECORD_CHECKSUM_PROP_NAMEpublic static String replayChecksum()
Checksum implementation to use during
replay for the checksum. Non-empty value means that checksum is enabled for replay.Checksum interfaceREPLAY_CHECKSUM_PROP_NAMEpublic static boolean controlChannelEnabled()
true if the network control channel to be enabled.CONTROL_CHANNEL_ENABLED_PROP_NAMECopyright © 2014-2023 Real Logic Limited. All Rights Reserved.