Configuration (Store) - S3 (12)



Please note: In order to use StorageType 12 (S3), you may have to provide additional libraries to KGS Store.

Please download S3 libraries from our website, decompress the archive to a folder which can be reached by KGS Store and set in "OSGi → Configuration → Generic Store Service" the path of "Additional JAR folder" to the one that includes S3 libraries.

You’ll find these libraries in download area.

[COMMON SETTINGS]

In order to use S3, please set in [COMMON SETTINGS] section the parameter StorageType = 12.

[STORAGE_S3]

Parameter

DataType

Description

Default

ConnectionUser

String

Depends on the used S3 endpoint.



Examples:

Amazon AWS → Access key ID



ConnectionPass

String

Depends on the used S3 endpoint.

This parameter value will be encoded during the first startup.



Examples:

Amazon AWS → Secret access key



Region

String

Used for Amazon AWS.

Specify your AWS region here.



Protocol

String

http or https

https

AllowCreateBuckets

Boolean

Should be set to false, if you want to use precreated buckets.

TRUE

RequestSigner



Possible values:

  • NoOpSignerType

  • QueryStringSignerType

  • AWS3SignerType

  • AWS4SignerType

  • AWS4UnsignedPayloadSignerType

AWS4UnsignedPayloadSignerType

HashCheck

Boolean

Enables or disables the hash-key check during document checkout (get).

Can be specified per contentrepository by adding a trailing "_<ContentRepository>".



Example: HashCheck_FI = FALSE

FALSE

RetentionPeriod

Integer

Defines the amount of time (in months) from creation date until the documents should be protected from modification.

Can be specified per contentrepository by adding a trailing "_<ContentRepository>".



Example: RetentionPeriod_FI = 12



LockFiles

Boolean

If enabled locks all objects in compliance mode during the create process.



BucketName

String

Defines the name of the bucket in which files will be archived.

Note for Amazon AWS

Every bucket name has to be unique throughout all Amazon regions!



EndPoint

String

URL for your S3 endpoint.



ClientOptions

String

Possible values:

  • PathStyleAccess



Values can be combined with a semicolon.



Example:

ClientOptions = PathStyleAccess:true;Parameter2:false



MaxConnections

Integer

Defines the maximal number of opened connections.

 

ConnectionTimeout

Integer

Timeout for connections and read requests in seconds.

 

ContrepInPath

Boolean

TRUE: For every Contentrepository a directory will be created and documents and / or corresponding sub-directory-trees will be attached into this directory.

FALSE: Leading Contentrepository-directory will not be created.

FALSE

DocumentMetaDataRepresentation

Boolean

FALSE: The metadata of an filed document will be stored as content of the file.

TRUE: The metadata of an filed document will be stored as metadata of a 0-byte file.

TRUE

UseFlatStylePath

Boolean

TRUE: If this options is enabled KGS Store won't build a substructure tree, but save all files inside a single directory.

FALSE: If this option is being disable KGS Store will build a structure of sub-directory which represent the DocumentID.

TRUE

HCPMode

Boolean

Changes the behavior, how the content type is being commited.

TRUE: Content type is being committed as a user-meta-data-field.

FALSE: Content type is committed as a normal content type.

FALSE

HCPRetentionMode

Boolean

Enables or disables hardware-based retention on HCP.

TRUE: Enables hardware-based retention on HCP.

FALSE: Disables hardware-based retention on HCP.

FALSE

ServerSideEncryption

Boolean

Enables or disables the server-side encryption with the 256-bit Advanced Encryption Standard (AES-256).

FALSE: Disable Serverside Encryption (SSE)

TRUE: Enables the Serverside Encryption with Default AES_256

FALSE

CleanVersions

Boolean

true: Deletes all previous versions on update and delete operations in buckets with versioning.

false: All versions remain.

TRUE

 

Achtung: In einigen Kundenprojekten kam es in den vergangenen Monaten zu Problemen mit der neuen NetApp Version 11.5. StorageGrid (S3). Seitens kgs werden S3-Methoden des SDK´s verwendet, welche in der NetApp Version 11.5. bisher nicht unterstützt werden.

Nachfolgend findet Ihr alle genutzten Methoden, welche bei der Fehleranalyse seitens NetApp hilfreich sein können:

S3Client
doesBucketExistV2
createBucket
deleteBucket
doesObjectExist
getObject
deleteObject
putObject
listObjectsV2
getObjectMetadata
copyObject (withObjectLockMode(ObjectLockMode.COMPLIANCE)
withObjectLockRetainUntilDate()
withMetadataDirective(MetadataDirective.REPLACE))
listVersions
deleteVersion

TransferManagerBuilder:
upload()


→ Configuration (Store) - StorageTypes - ArchiveLink