Skip to content

emc-mongoose/mongoose-storage-driver-swift

Repository files navigation

Gitter chat Issue Tracker CI status Tag Maven metadata URL Sonatype Nexus (Releases) Docker Pulls

Swift Storage Driver

1. Features

  • API version: 1.0
  • Authentification:
    • Uid/secret key pair for auth token operations
    • Auth token
  • SSL/TLS
  • Item types:
    • data (--> "object")
    • path (--> "container")
    • token (--> "auth token")
  • Automatic auth token creation on demand
  • Automatic destination path creation on demand
  • Path listing input (with JSON response payload)
  • Data item operation types:
    • create
    • read
      • full
      • random byte ranges
      • fixed byte ranges
      • content verification
    • update
      • full (overwrite)
      • random byte ranges
      • fixed byte ranges (with append mode)
    • delete
    • noop
  • Token item operation types:
    • create
    • noop
  • Path item operation types:
    • create
    • read
    • delete
    • noop

2. Usage

java -jar mongoose-<VERSION>.jar \
    --storage-driver-type=swift \
    --storage-namespace=ns1 \
    ...

2.1. Configuration Reference

Name Type Default Value Description
storage-net-http-versioning Flag false Specifies whether the versioning storage feature is used or not

2.2. Notes

  • A container may be specified with item-input-path either item-output-path configuration option
  • The default storage namespace value (null) won't work, specify the correct value explicitly
  • DLO creation should be enabled using the item-data-ranges-threshold configuration option
  • Defect GOOSE-1316: unable to verify the response content in the case of multiple byte ranges read
  • The storage port is set to 9020 by default for the docker image