Package org.elasticsearch.repositories.fs

Class FsRepository

java.lang.Object

org.elasticsearch.common.component.AbstractLifecycleComponent

org.elasticsearch.repositories.blobstore.BlobStoreRepository

org.elasticsearch.repositories.fs.FsRepository

All Implemented Interfaces:

Closeable, AutoCloseable, LifecycleComponent, Releasable, Repository

public class FsRepository
extends BlobStoreRepository

Shared file system implementation of the BlobStoreRepository

Shared file system repository supports the following settings

location

Path to the root of repository. This is mandatory parameter.

concurrent_streams

Number of concurrent read/write stream (per repository on each node). Defaults to 5.

chunk_size

Large file can be divided into chunks. This parameter specifies the chunk size. Defaults to not chucked.

compress

If set to true metadata files will be stored compressed. Defaults to false.

Nested Class Summary

Nested classes/interfaces inherited from interface org.elasticsearch.repositories.Repository

Repository.Factory

Field Summary

Fields

Modifier and Type	Field	Description
static final Setting<ByteSizeValue>	CHUNK_SIZE_SETTING
static final Setting<Boolean>	COMPRESS_SETTING
static final Setting<String>	LOCATION_SETTING
static final Setting<ByteSizeValue>	REPOSITORIES_CHUNK_SIZE_SETTING
static final Setting<Boolean>	REPOSITORIES_COMPRESS_SETTING
static final Setting<String>	REPOSITORIES_LOCATION_SETTING
static final String	TYPE

Fields inherited from class org.elasticsearch.repositories.blobstore.BlobStoreRepository

ALLOW_CONCURRENT_MODIFICATION, bigArrays, BUFFER_SIZE_SETTING, bufferSize, CACHE_REPOSITORY_DATA, GLOBAL_METADATA_FORMAT, INDEX_FILE_PREFIX, INDEX_LATEST_BLOB, INDEX_METADATA_FORMAT, INDEX_SHARD_SNAPSHOT_FORMAT, INDEX_SHARD_SNAPSHOTS_FORMAT, MAX_RESTORE_BYTES_PER_SEC, MAX_SNAPSHOT_BYTES_PER_SEC, MAX_SNAPSHOTS_SETTING, metadata, METADATA_NAME_FORMAT, METADATA_PREFIX, READONLY_SETTING_KEY, SNAPSHOT_FORMAT, SNAPSHOT_NAME_FORMAT, SNAPSHOT_PREFIX, SUPPORT_URL_REPO, supportURLRepo, threadPool, UPLOADED_DATA_BLOB_PREFIX, URL_REPOSITORY_TYPE, USE_FOR_PEER_RECOVERY_SETTING

Fields inherited from class org.elasticsearch.common.component.AbstractLifecycleComponent

lifecycle

Constructor Summary

Constructors

Constructor	Description
FsRepository(RepositoryMetadata metadata, Environment environment, NamedXContentRegistry namedXContentRegistry, ClusterService clusterService, BigArrays bigArrays, RecoverySettings recoverySettings)	Constructs a shared file system repository.

Method Summary

Modifier and Type	Method	Description
BlobPath	basePath()	Returns base path of the repository
protected ByteSizeValue	chunkSize()	Returns data file chunk size.
protected BlobStore	createBlobStore()	Creates new BlobStore to read and write data.
boolean	hasAtomicOverwrites()

Methods inherited from class org.elasticsearch.repositories.blobstore.BlobStoreRepository

assertSnapshotOrGenericThread, awaitIdle, blobContainer, blobStore, canUpdateInPlace, cleanup, cloneShardSnapshot, deleteSnapshots, doClose, doStart, doStop, endVerification, executeConsistentStateUpdate, finalizeSnapshot, getBlobStore, getBlobStoreIndexShardSnapshots, getMetadata, getReadBufferSizeInBytes, getRepositoryData, getRestoreThrottleTimeInNanos, getShardSnapshotStatus, getSnapshotGlobalMetadata, getSnapshotIndexMetaData, getSnapshotInfo, getSnapshotThrottleTimeInNanos, initializeSnapshot, isCompress, isReadOnly, loadShardSnapshot, maybeRateLimitRestores, maybeRateLimitRestores, maybeRateLimitSnapshots, maybeRateLimitSnapshots, restoreShard, shardContainer, snapshotShard, startVerification, stats, supportURLRepo, threadPool, toString, updateState, verify, writeIndexGen

Methods inherited from class org.elasticsearch.common.component.AbstractLifecycleComponent

addLifecycleListener, close, lifecycleState, removeLifecycleListener, start, stop

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.elasticsearch.common.component.LifecycleComponent

addLifecycleListener, lifecycleState, removeLifecycleListener, start, stop

Methods inherited from interface org.elasticsearch.core.Releasable

close

Methods inherited from interface org.elasticsearch.repositories.Repository

adaptUserMetadata, getSnapshotInfo

Field Details

TYPE

public static final String TYPE

See Also:

• Constant Field Values

LOCATION_SETTING

public static final Setting<String> LOCATION_SETTING

REPOSITORIES_LOCATION_SETTING

public static final Setting<String> REPOSITORIES_LOCATION_SETTING

CHUNK_SIZE_SETTING

public static final Setting<ByteSizeValue> CHUNK_SIZE_SETTING

REPOSITORIES_CHUNK_SIZE_SETTING

public static final Setting<ByteSizeValue> REPOSITORIES_CHUNK_SIZE_SETTING

COMPRESS_SETTING

public static final Setting<Boolean> COMPRESS_SETTING

REPOSITORIES_COMPRESS_SETTING

public static final Setting<Boolean> REPOSITORIES_COMPRESS_SETTING

Constructor Details

FsRepository

public FsRepository(RepositoryMetadata metadata,
 Environment environment,
 NamedXContentRegistry namedXContentRegistry,
 ClusterService clusterService,
 BigArrays bigArrays,
 RecoverySettings recoverySettings)

Constructs a shared file system repository.

Method Details

createBlobStore

protected BlobStore createBlobStore()
                             throws Exception

Description copied from class: BlobStoreRepository

Creates new BlobStore to read and write data.

Specified by:

createBlobStore in class BlobStoreRepository

Throws:

Exception

chunkSize

protected ByteSizeValue chunkSize()

Description copied from class: BlobStoreRepository

Returns data file chunk size.

This method should return null if no chunking is needed.

Overrides:

chunkSize in class BlobStoreRepository

Returns:

chunk size

basePath

public BlobPath basePath()

Description copied from class: BlobStoreRepository

Returns base path of the repository

Specified by:

basePath in class BlobStoreRepository

hasAtomicOverwrites

public boolean hasAtomicOverwrites()

Overrides:

hasAtomicOverwrites in class BlobStoreRepository

Returns:

whether this repository performs overwrites atomically. In practice we only overwrite the `index.latest` blob so this is not very important, but the repository analyzer does test that overwrites happen atomically. It will skip those tests if the repository overrides this method to indicate that it does not support atomic overwrites.