Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel3

...

Info

Quick Setup

For the remaining setup sections, few changes are usually needed:

  • Cloud Security — Each export can have different security, to fit the usage.

  • Client Access — Keep the defaults unless access control needs to be customized.

  • Permissions — Change nobody to x-owner-meta.

  • Logging — Keep the defaults unless directed by Support.

  • Advanced Settings — Keep the defaults unless unless unless directed by Support.

Cloud Security

...

Transport protocol

TCP

Supported transport protocol (TCP/UDP | TCP | UDP)

Storage port

80

Required. Network port for traffic to Swarm Storage nodes

Search port

9200

Required. Network port for traffic to Swarm Search nodes

Security

sys 

Remote Procedure Call (RPC) security type (sys | krb5 | krb5i | krb5p)

Maximum storage connections

100

Maximum number of open connections to Swarm Storage. (v2.0)

Retries

5

(positive integer) How many times SwarmFS retries unsuccessful requests to Swarm and Swarm Search before giving up.

Retries timeout

90

(seconds) How long SwarmFS waits before timing out Swarm retries.

Request timeout

90

(seconds) How long SwarmFS waits before timing out Swarm requests.

For best results, set this timeout to at least twice the value of the Storage setting scsp.keepAliveInterval.

Pool timeout

300

(seconds) How long discovered Swarm storage nodes are remembered.

Write timeout

90

(seconds) How long SwarmFS waits for a write to Swarm to complete before retrying.

Read buffer size

128000000

(bytes) Defaults to 128 MB, for general workloads. The amount of data to be read each time from Swarm. If the read size buffer is greater than the client request size, then the difference is cached by SwarmFS, and the next client read request is served directly from cache, if possible. Set to 0 to disable read-ahead buffering.

Improving performance — Set each export's Read Buffer Size to match the workload expected on that share

  • Lower the read-ahead buffer size if most reads are small and non-sequential.

  • Increase the read-ahead buffer size if most reads are large and sequential.

Parallel read buffer requests

4

(positive integer) Adjust to tune the performance of large object reads; the default of 4 reflects the optimal number of threads, per performance testing. (v2.3)

Maximum part size

64000000

(bytes) How large each part of erasure-coded (EC) objects may be. Increase (such as to 200 MB, or 200000000) to create smaller EC sets for large objects and so increase throughput for high volumes of large files. (v2.3)

Collector sleep time

1000

(milliseconds) Increase to minimize object consolidation time by directing SwarmFS to collect more data before pushing it to Swarm, at the expense of both RAM and read performance, as SwarmFS slows clients when running out of cache. Increase this value if the implementation is sensitive to how quickly the Swarm health processor consolidates objects, which cannot be guaranteed. (v2.3)

Maximum buffer memory

2000000000

(bytes) Defaults to 2 GB. Maximum limit that can be allocated for the export's export buffer pool. Once exceeded, client requests are temporary blocked until total buffers falls back below this number. (v2.0)

Buffer high watermark

1500000000

(bytes) Once the allocated export buffers reach this watermark, SwarmFS starts to free buffers in an attempt to stay below “Maximum Memory Buffers”. During this time, client requests may be delayed. (v2.0)

File access time policy

"relatime"

Policy for when to update a file's access time stamp (atime). (v2.0)

  • “noatime”: Disables atime updates.

  • “relatime”: Updates atime if it is earlier than last modified time, so it updates once after each write.

  • “strictatime”: Updates atime on every read and close.

Elasticsearch buffer refresh time

60

(seconds) How rapidly non-SwarmFS object updates are reflected in SwarmFS listings. Lower to reduce the wait for consistency, at the cost of increased load on Elasticsearch. (v2.3)

Child pages (Children Display)

...