| Excerpt |
|---|
| Info |
|---|
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. | Info |
|---|
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: | 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. | Info |
|---|
Should not be used in case of Amazon AWS. Use the Region parameter instead. |
|
| ClientOptions | String | Possible values:
Values can be combined with a semicolon.
Example: | Code Block |
|---|
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. | Info |
|---|
In case of Hitachi Vantara HCP storage system we recommend to set this parameter to FALSE! |
| TRUE | HCPMode | Boolean | Changes the behavior, how the content type is being commited. | Note |
|---|
Please note: HCPMode is not related to HCPRetentionMode! |
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. | Note |
|---|
Please note: In order to use HCP retention, the following has to be done ( depends on the version of your HCP and whether it’s on-premise or within the cloud! ): |
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. | Info |
|---|
HCP is only supporting false (HCP Version 9.20) |
| 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